From a229206d4c927fe5b105f326cb2c801ed71a9d46 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Wed, 29 Jul 2026 09:50:56 +0200 Subject: [PATCH 001/155] fix: colon-form underline styles now match other terminals (#9498) #### Brief overview of PR changes/additions Corrects the SGR colon-form underline sub-parameter decode (`ESC[4:Nm`) in `TBuffer::decodeSGR()` to match the widely-adopted kitty/VTE convention that other terminals use: | Sequence | Meaning (kitty/VTE) | Before | After | | --- | --- | --- | --- | | `4:0` | no underline | none | none | | `4:1` | single/straight | single | single | | `4:2` | double | dashed | single* | | `4:3` | curly/wavy | dotted | curly/wavy | | `4:4` | dotted | wavy | dotted | | `4:5` | dashed | **cleared the underline** | dashed | \* Mudlet has no distinct double-underline style, so `4:2` is shown as a plain single underline. Adds `SgrUnderlineStyleTest` (functional test) covering `4:0`-`4:5` from a clean pen, style-to-style transitions (verifying sibling flags are cleared), the out-of-range/`default` fallback, and that plain `ESC[4m` still yields a single underline. #### Motivation for adding to Mudlet The colon sub-parameter mapping introduced in #8262 was shifted relative to the kitty/VTE convention, so text a game sent with these styles rendered as the wrong underline style. Most visibly, `4:5` (dashed) wrongly cleared the underline entirely instead of drawing a dashed line. This makes Mudlet match what other terminals do for these codes. #### Other info (issues closed, discussion etc) Relates to #8262 (which introduced the colon-form underline support). Note: the plain numeric `ESC[4m` handler is intentionally left unchanged here; there is a pre-existing, separate quirk that a plain `ESC[4m` following a colon style does not clear the sibling style flags. That is out of scope for this fix and could be addressed independently. Assisted-by: Claude:claude-opus-4-8 --- src/TBuffer.cpp | 24 +- test/functional_tests/CMakeLists.txt | 1 + .../SgrUnderlineStyleTest.cpp | 271 ++++++++++++++++++ 3 files changed, 289 insertions(+), 7 deletions(-) create mode 100644 test/functional_tests/SgrUnderlineStyleTest.cpp diff --git a/src/TBuffer.cpp b/src/TBuffer.cpp index ae23df604..8d1bc3eaa 100644 --- a/src/TBuffer.cpp +++ b/src/TBuffer.cpp @@ -2401,6 +2401,10 @@ void TBuffer::decodeSGR(const QString& sequence) qDebug().noquote().nospace() << "TBuffer::decodeSGR(\"" << sequence << "\") ERROR - failed to detect underline parameter element (the second part) in a SGR...;4:?;..m sequence assuming it is a zero!"; } + // Sub-parameter values follow the widely-adopted kitty/VTE + // convention: 0 none, 1 single, 2 double, 3 curly, 4 dotted, + // 5 dashed. Mudlet has no distinct double-underline style so + // 2 is shown as a plain single underline. switch (value) { case 0: // Underline off mUnderline = false; @@ -2408,29 +2412,35 @@ void TBuffer::decodeSGR(const QString& sequence) mUnderlineDotted = false; mUnderlineDashed = false; break; - case 1: // Underline on (solid) + case 1: // Single (straight) underline mUnderline = true; mUnderlineWavy = false; mUnderlineDotted = false; mUnderlineDashed = false; break; - case 2: // Dashed underline + case 2: // Double underline - unsupported, show as single mUnderline = true; mUnderlineWavy = false; mUnderlineDotted = false; - mUnderlineDashed = true; + mUnderlineDashed = false; break; - case 3: // Dotted underline + case 3: // Curly (wavy) underline + mUnderline = true; + mUnderlineWavy = true; + mUnderlineDotted = false; + mUnderlineDashed = false; + break; + case 4: // Dotted underline mUnderline = true; mUnderlineWavy = false; mUnderlineDotted = true; mUnderlineDashed = false; break; - case 4: // Wavy underline + case 5: // Dashed underline mUnderline = true; - mUnderlineWavy = true; + mUnderlineWavy = false; mUnderlineDotted = false; - mUnderlineDashed = false; + mUnderlineDashed = true; break; default: // Something unexpected qDebug().noquote().nospace() << "TBuffer::decodeSGR(\"" << sequence diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index a20003e69..eb9f5a08d 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -21,6 +21,7 @@ set(FUNCTIONAL_TEST_SOURCES EnableDisableByNameTest.cpp ColorTriggerFilterChildTest.cpp GMCPCharLoginTest.cpp + SgrUnderlineStyleTest.cpp LogRestartDuplicateLineTest.cpp ProfileRoundTripTest.cpp MapRoundTripTest.cpp diff --git a/test/functional_tests/SgrUnderlineStyleTest.cpp b/test/functional_tests/SgrUnderlineStyleTest.cpp new file mode 100644 index 000000000..7238f30a8 --- /dev/null +++ b/test/functional_tests/SgrUnderlineStyleTest.cpp @@ -0,0 +1,271 @@ +/*************************************************************************** + * Copyright (C) 2026 by Mudlet Developers * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +/* + * Tests for the SGR colon-form underline sub-parameter decoding (ESC[4:Nm). + * + * The sub-parameter values follow the widely-adopted kitty/VTE convention: + * 4:0 none, 4:1 single, 4:2 double, 4:3 curly, 4:4 dotted, 4:5 dashed. + * These are decoded in TBuffer::decodeSGR(). This test injects each sequence + * and asserts the resulting cell carries the expected internal underline + * attributes - in particular that 4:5 yields a dashed underline rather than + * clearing the underline entirely. + * + * Uses loopbackTest() to inject data directly into the telnet processing + * pipeline, avoiding per-test TCP connections and profile creation. + * + * Run with: ctest -R SgrUnderlineStyleTest -V + */ + +#include + +#include "MudletInstanceCoordinator.h" +#include "TMainConsole.h" +#include "TelnetServerStub.h" +#include "ctelnet.h" +#include "dlgConnectionProfiles.h" +#include "mudlet.h" + +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); +void initializeQRCResourcesForUnderlineTest(); + +class SgrUnderlineStyleTest : public QObject +{ + Q_OBJECT + +private: + TelnetServerStub* mpServer = nullptr; + Host* mpHost = nullptr; + const QString mHostname = "SGR-Underline-Test-Host"; + QString mPort; // assigned the stub's actual ephemeral port in initTestCase() + const QString mLocalhost = "localhost"; + + // Injects raw telnet data into the processing pipeline via loopback and + // waits for the buffer to process it. + void injectData(const QString& message) + { + QByteArray data = (message + qsl("\r\n")).toUtf8(); + mpHost->mTelnet.loopbackTest(data); + QTest::qWait(50); + } + + // Scans the buffer for the first cell whose grapheme matches marker and + // returns its TChar, or std::nullopt if none is found. + std::optional findCell(QChar marker) + { + TMainConsole* console = mpHost->mpConsole; + for (int line = 0; line <= console->buffer.getLastLineNumber(); ++line) { + const QString& text = console->buffer.lineBuffer.at(line); + for (int col = 0; col < text.length(); ++col) { + if (text.at(col) == marker) { + return console->buffer.buffer.at(line).at(col); + } + } + } + return std::nullopt; + } + +private slots: + // Start mudlet and create a profile once for all tests. + void initTestCase() + { + initializeQRCResourcesForUnderlineTest(); + + mpServer = new TelnetServerStub(qApp); + mpServer->start(mLocalhost, 0); // ephemeral OS-assigned port avoids collisions across concurrent test runs + mPort = QString::number(mpServer->serverPort()); + mudlet::start(); + mudlet::self()->setupConfig(); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique("MudletInstanceCoordinator")); + mudlet::self()->init(); + mudlet::self()->setStorePasswordsSecurely(false); + + const QString path = mudlet::getMudletPath(enums::profileHomePath, mHostname); + QDir(path).removeRecursively(); + + QTimer::singleShot(0, qApp, [this]() { + mudlet::self()->startAutoLogin({}); + QTest::qWait(100); + QTest::mouseClick(mudlet::self()->mpConnectionDialog->new_profile_button, Qt::LeftButton); + QTest::qWait(100); + QTest::keyClicks(QApplication::focusWidget(), mHostname); + QTest::qWait(100); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100); + QTest::keyClicks(QApplication::focusWidget(), mLocalhost); + QTest::qWait(100); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100); + QTest::keyClicks(QApplication::focusWidget(), mPort); + QTest::qWait(100); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Return); + }); + + QSignalSpy spy(mudlet::self(), &mudlet::signal_profileLoaded); + if (!spy.wait(1000)) { + QFAIL("Profile took too long to load."); + } + mpHost = mudlet::self()->getActiveHost(); + if (!mpHost) { + QFAIL("No active host available for the test."); + } + + QSignalSpy spy2(&(mpHost->mTelnet), &cTelnet::signal_connected); + if (!spy2.wait(500)) { + QFAIL("Could not connect with the host."); + } + } + + // Clear buffer before each test for isolation. + void init() + { + QVERIFY(mpHost); + QVERIFY(mpHost->mpConsole); + mpHost->mpConsole->buffer.clear(); + } + + // Data-driven test: each ESC[4:Nm sequence must map to the expected internal + // underline attributes following the kitty/VTE convention. + void test_ColonUnderlineStyle_data() + { + QTest::addColumn("sequence"); + QTest::addColumn("underlined"); + QTest::addColumn("wavy"); + QTest::addColumn("dotted"); + QTest::addColumn("dashed"); + + // under wavy dotted dashed + QTest::newRow("4:0 none") << qsl("\x1b[4:0m") << false << false << false << false; + QTest::newRow("4:1 single") << qsl("\x1b[4:1m") << true << false << false << false; + // Mudlet has no distinct double-underline style, so 4:2 shows as single. + QTest::newRow("4:2 double") << qsl("\x1b[4:2m") << true << false << false << false; + QTest::newRow("4:3 curly") << qsl("\x1b[4:3m") << true << true << false << false; + QTest::newRow("4:4 dotted") << qsl("\x1b[4:4m") << true << false << true << false; + QTest::newRow("4:5 dashed") << qsl("\x1b[4:5m") << true << false << false << true; + } + + void test_ColonUnderlineStyle() + { + QFETCH(QString, sequence); + QFETCH(bool, underlined); + QFETCH(bool, wavy); + QFETCH(bool, dotted); + QFETCH(bool, dashed); + + // Reset the pen with ESC[0m so no prior test's underline state leaks in, + // then apply the sequence and inspect the marker 'U' cell. + injectData(qsl("\x1b[0m") + sequence + qsl("U")); + + auto cell = findCell(QLatin1Char('U')); + QVERIFY2(cell.has_value(), "Marker character 'U' not found in buffer"); + + QCOMPARE(cell->isUnderlined(), underlined); + QCOMPARE(cell->isUnderlineWavy(), wavy); + QCOMPARE(cell->isUnderlineDotted(), dotted); + QCOMPARE(cell->isUnderlineDashed(), dashed); + } + + // Data-driven test: applying a colon style over an existing curly underline + // must clear the sibling style flags, actually turn the underline off for + // 4:0, and fall back to no underline for out-of-range values. This guards + // against the stale-state carry-over class of bug the fix addresses. + void test_ColonUnderlineStyleTransition_data() + { + QTest::addColumn("sequence"); + QTest::addColumn("underlined"); + QTest::addColumn("wavy"); + QTest::addColumn("dotted"); + QTest::addColumn("dashed"); + + // under wavy dotted dashed + QTest::newRow("curly then 4:0 clears") << qsl("\x1b[4:0m") << false << false << false << false; + QTest::newRow("curly then 4:4 dotted") << qsl("\x1b[4:4m") << true << false << true << false; + QTest::newRow("curly then 4:5 dashed") << qsl("\x1b[4:5m") << true << false << false << true; + // Out-of-range values hit the default arm and clear the underline. + QTest::newRow("curly then 4:6 out-of-range") << qsl("\x1b[4:6m") << false << false << false << false; + } + + void test_ColonUnderlineStyleTransition() + { + QFETCH(QString, sequence); + QFETCH(bool, underlined); + QFETCH(bool, wavy); + QFETCH(bool, dotted); + QFETCH(bool, dashed); + + // Establish a curly underline first, then apply the sequence under test + // to the same pen so sibling-flag clearing is exercised. + injectData(qsl("\x1b[0m\x1b[4:3m") + sequence + qsl("U")); + + auto cell = findCell(QLatin1Char('U')); + QVERIFY2(cell.has_value(), "Marker character 'U' not found in buffer"); + + QCOMPARE(cell->isUnderlined(), underlined); + QCOMPARE(cell->isUnderlineWavy(), wavy); + QCOMPARE(cell->isUnderlineDotted(), dotted); + QCOMPARE(cell->isUnderlineDashed(), dashed); + } + + // The plain numeric ESC[4m (no colon) must remain a single underline - the + // fix only touches the colon sub-parameter path. + void test_PlainUnderlineUnchanged() + { + injectData(qsl("\x1b[0m\x1b[4mU")); + + auto cell = findCell(QLatin1Char('U')); + QVERIFY2(cell.has_value(), "Marker character 'U' not found in buffer"); + + QVERIFY(cell->isUnderlined()); + QVERIFY(!cell->isUnderlineWavy()); + QVERIFY(!cell->isUnderlineDotted()); + QVERIFY(!cell->isUnderlineDashed()); + } + + void cleanupTestCase() + { + delete mpServer; + mpServer = nullptr; + mpHost = nullptr; + const QString path = mudlet::getMudletPath(enums::profileHomePath, mHostname); + QDir(path).removeRecursively(); + delete mudlet::self(); + } +}; + +void initializeQRCResourcesForUnderlineTest() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +#include "SgrUnderlineStyleTest.moc" +QTEST_MAIN(SgrUnderlineStyleTest) From 9eaa62e148c43bad2b841becd11d205c7fb1a5a2 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Wed, 29 Jul 2026 10:30:59 +0200 Subject: [PATCH 002/155] Infrastructure: clear 5 CodeQL warning-level alerts in src/ (#9525) #### Brief overview of PR changes/additions Clears five open CodeQL "warning"-level alerts in `src/`, each with a minimal, behavior-preserving fix: - **`src/TMap.cpp`** (`cpp/catch-by-value`): the A* search catches the `found_goal` sentinel by value. `found_goal` (in `src/TAstar.h`) is an empty struct thrown by the goal visitor purely as a control-flow signal, and the handler never touches the caught object, so it is now caught as `const found_goal&`. - **`src/exitstreewidget.h`** (`cpp/integer-used-for-enum`, two alerts): the special-exit column indices were `static const int` constants, so the two `switch` statements in `dlgRoomExits::slot_editSpecialExit()` dispatched an `int` over const-int case labels. They are now an unscoped `enum ExitsTreeColumn : int` with identical values (0-8). Unscoped keeps the implicit `int` conversions, so every `ExitsTreeWidget::colIndex_*` call site (all passed to Qt column-index `int` parameters) is unchanged. - **`src/TMatchState.h`** (`cpp/rule-of-two`): the class had a user-defined copy constructor but only an implicit copy assignment. Added an explicit `= default` copy assignment. The defaulted assignment reproduces the previous implicit one exactly (full member-wise copy); the existing, deliberately partial copy constructor is untouched. - **`src/TConsole.h`** (`cpp/rule-of-two`): `TFontAttributes` had a `= default` copy assignment but only an implicit copy constructor. Added an explicit `= default` copy constructor. Move operations were already suppressed by the existing user-declared copy assignment, so nothing about copy/move behavior changes. #### Motivation for adding to Mudlet Reduces the open CodeQL alert backlog with small, low-risk hygiene fixes that also make the affected types' intent clearer (explicit special members, a named column enum) without altering any runtime behavior. #### Other info (issues closed, discussion etc) CodeQL alerts cleared: - `cpp/catch-by-value` - `src/TMap.cpp` (alert #140) - `cpp/integer-used-for-enum` - `src/dlgRoomExits.cpp` switch at ~318 (alert #1070) - `cpp/integer-used-for-enum` - `src/dlgRoomExits.cpp` switch at ~399 (alert #1071) - `cpp/rule-of-two` - `src/TMatchState.h` (alert #185) - `cpp/rule-of-two` - `src/TConsole.h` / `TFontAttributes` (alert #2148) Each fix is behavior-preserving. Verified with a full Ninja build (Qt 6.12.0, ASan) and the adjacent functional tests: `MapRoundTripTest`, `TAreaZLevelIndexTest`, `TAreaGridIndexTest`, `TriggerSameLineMatchTest`, `TFeedTriggersRecursionTest`, `ColorTriggerFilterChildTest`, `EnableDisableByNameTest`, `MainConsoleSelectionTest` - all pass. --- src/TConsole.h | 1 + src/TMap.cpp | 2 +- src/TMatchState.h | 10 +++++++++- src/exitstreewidget.h | 22 ++++++++++++---------- 4 files changed, 23 insertions(+), 12 deletions(-) diff --git a/src/TConsole.h b/src/TConsole.h index fe642f2f4..8a86b7b31 100644 --- a/src/TConsole.h +++ b/src/TConsole.h @@ -77,6 +77,7 @@ struct TFontAttributes bool operator==(const TFontAttributes& other) const = default; bool operator!=(const TFontAttributes& other) const = default; + TFontAttributes(const TFontAttributes& other) = default; TFontAttributes& operator=(const TFontAttributes& other) = default; QFont makeFont() const diff --git a/src/TMap.cpp b/src/TMap.cpp index 5ea740084..3912181da 100644 --- a/src/TMap.cpp +++ b/src/TMap.cpp @@ -1010,7 +1010,7 @@ bool TMap::findPath(int from, int to) std::vector d(vertexCount); try { astar_search(g, start, distance_heuristic>(locations, goal), predecessor_map(&p[0]).distance_map(&d[0]).visitor(astar_goal_visitor(goal))); - } catch (found_goal) { + } catch (const found_goal&) { qDebug() << "TMap::findPath(" << from << "," << to << ") INFO: time elapsed in A*:" << t.nsecsElapsed() * 1.0e-6 << "ms."; t.restart(); if (!roomidToIndex.contains(to)) { diff --git a/src/TMatchState.h b/src/TMatchState.h index 75d163365..f177ea4b4 100644 --- a/src/TMatchState.h +++ b/src/TMatchState.h @@ -41,7 +41,8 @@ public: { } - // Copy constructor: + // Copy constructor - deliberately does not carry over the capture + // containers, so a copied state starts with empty captures: TMatchState(const TMatchState& ms) : mNumberOfConditions(ms.mNumberOfConditions) , mNextCondition(ms.mNextCondition) @@ -51,6 +52,13 @@ public: { } + // Pair the user-defined copy constructor with an explicit copy assignment + // (Rule of Two). Note the two are deliberately asymmetric: unlike the + // constructor above, this defaulted assignment copies every member, + // capture containers included. That reproduces the previously implicit + // assignment exactly, so behaviour is unchanged: + TMatchState& operator=(const TMatchState& ms) = default; + int nextCondition() { return mNextCondition; } void conditionMatched() { mNextCondition++; } bool isComplete() { return (mNextCondition >= mNumberOfConditions); } diff --git a/src/exitstreewidget.h b/src/exitstreewidget.h index a7d761164..2a25d3682 100644 --- a/src/exitstreewidget.h +++ b/src/exitstreewidget.h @@ -34,21 +34,23 @@ class ExitsTreeWidget : public QTreeWidget friend class dlgRoomExits; // The indexes that are used to identify the columns in the special exits - // treewidget have been converted to constants so that we can + // treewidget have been collected into an enumeration so that we can // tweak them and change all of them correctly - and by making the // dlgRoomExits class a friend that can use the same set as defined here. // Note that if any of these numbers are modified/extended the // corresponding headings in the ./src/ui/room_exits.ui file will need // to be adjusted as well - and visa versa: - static const int colIndex_exitRoomId = 0; - static const int colIndex_exitStatus = 1; - static const int colIndex_lockExit = 2; - static const int colIndex_exitWeight = 3; - static const int colIndex_doorNone = 4; - static const int colIndex_doorOpen = 5; - static const int colIndex_doorClosed = 6; - static const int colIndex_doorLocked = 7; - static const int colIndex_command = 8; + enum ExitsTreeColumn : int { + colIndex_exitRoomId = 0, + colIndex_exitStatus = 1, + colIndex_lockExit = 2, + colIndex_exitWeight = 3, + colIndex_doorNone = 4, + colIndex_doorOpen = 5, + colIndex_doorClosed = 6, + colIndex_doorLocked = 7, + colIndex_command = 8, + }; public: Q_DISABLE_COPY(ExitsTreeWidget) From 3f97594e3137979aa0cc3780c4ff9024ff32a3a6 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Wed, 29 Jul 2026 13:42:04 +0200 Subject: [PATCH 003/155] infrastructure: guard functional-test lookups with QVERIFY (#9524) #### Brief overview of PR changes/additions The 12 functional-test sites that dereferenced the result of `getActiveHost()`, `getArea()`, `getRoom()` or `getHost()` without first checking it for null now guard the pointer with `QVERIFY(ptr)` before use. The other lookup sites this PR touched already had a `QVERIFY` and are left as they were. #### Motivation for adding to Mudlet CodeQL's `cpp/inconsistent-null-check` rule flagged these lookups because some call sites checked the returned pointer for null while others in the same files dereferenced it directly. Adding `QVERIFY(ptr)` at the previously-unchecked sites makes the handling consistent: every lookup result is verified before it is dereferenced, so a null result fails the test loudly instead of crashing. `QVERIFY` is the project's accepted idiom for guarding a pointer in a test, so it is used here rather than an `if (!ptr) { QFAIL(...); }` block. CodeQL does not recognise `QVERIFY(ptr)` as a null check (the branch it generates tests `qVerify()`'s return value, not the pointer itself), so it will keep reporting `cpp/inconsistent-null-check` on these sites and on the pre-existing `QVERIFY` sites. Those alerts will be dismissed as false positives rather than changing the test style to satisfy the checker. #### Other info (issues closed, discussion etc) Test files only - no production code is touched. The 12 newly-guarded sites are: - `MapRoundTripTest.cpp` - 2 (`pAreaA`, `pAreaB`) - `TriggerSameLineMatchTest.cpp` - 6 (`host`) - `TFeedTriggersRecursionTest.cpp` - 4 (`host`) **Test case:** Build and run the five affected binaries under the functional-test flock - all pass: - `TFeedTriggersRecursionTest` - passed - `TriggerSameLineMatchTest` - passed - `MapRoundTripTest` - 6 passed, 0 failed - `UndoServerWrapTest` - passed - `UndoServerWrapReplay` - 2 passed, 1 skipped (manual replay tool; skips without `REPLAY_CAPTURE`/`REPLAY_OUT`) --- test/functional_tests/MapRoundTripTest.cpp | 2 ++ test/functional_tests/TFeedTriggersRecursionTest.cpp | 4 ++++ test/functional_tests/TriggerSameLineMatchTest.cpp | 6 ++++++ 3 files changed, 12 insertions(+) diff --git a/test/functional_tests/MapRoundTripTest.cpp b/test/functional_tests/MapRoundTripTest.cpp index 7176c9ef3..cc4f9fc2c 100644 --- a/test/functional_tests/MapRoundTripTest.cpp +++ b/test/functional_tests/MapRoundTripTest.cpp @@ -290,6 +290,7 @@ private: QCOMPARE(pDB->getAreaNamesMap().value(mAreaB), scmAreaBName); TArea* pAreaA = pDB->getArea(mAreaA); + QVERIFY(pAreaA); verifyArea(pAreaA, mBoundsA, qsl("area A")); if (QTest::currentTestFailed()) { return; @@ -298,6 +299,7 @@ private: QCOMPARE(pAreaA->mUserData, expectedAreaAUserData()); TArea* pAreaB = pDB->getArea(mAreaB); + QVERIFY(pAreaB); verifyArea(pAreaB, mBoundsB, qsl("area B")); if (QTest::currentTestFailed()) { return; diff --git a/test/functional_tests/TFeedTriggersRecursionTest.cpp b/test/functional_tests/TFeedTriggersRecursionTest.cpp index fd8d84c30..b0e32bc31 100644 --- a/test/functional_tests/TFeedTriggersRecursionTest.cpp +++ b/test/functional_tests/TFeedTriggersRecursionTest.cpp @@ -76,6 +76,7 @@ private slots: { startProfile(mpHostname, mpLocalhost, mpPort); auto* host = mudlet::self()->getActiveHost(); + QVERIFY(host); host->mEchoLuaErrors = true; host->getLuaInterpreter()->compileAndExecuteScript(qsl("loopCount = 0\n" @@ -107,6 +108,7 @@ private slots: { startProfile(mpHostname, mpLocalhost, mpPort); auto* host = mudlet::self()->getActiveHost(); + QVERIFY(host); host->mEchoLuaErrors = true; host->getLuaInterpreter()->compileAndExecuteScript(qsl("normalCount = 0\n" @@ -126,6 +128,7 @@ private slots: { startProfile(mpHostname, mpLocalhost, mpPort); auto* host = mudlet::self()->getActiveHost(); + QVERIFY(host); host->mEchoLuaErrors = true; // feedTelnet() refuses to work unless the profile is offline @@ -164,6 +167,7 @@ private slots: { startProfile(mpHostname, mpLocalhost, mpPort); auto* host = mudlet::self()->getActiveHost(); + QVERIFY(host); host->mEchoLuaErrors = true; host->mTelnet.disconnectIt(); diff --git a/test/functional_tests/TriggerSameLineMatchTest.cpp b/test/functional_tests/TriggerSameLineMatchTest.cpp index aecfcfd8d..8343ecac7 100644 --- a/test/functional_tests/TriggerSameLineMatchTest.cpp +++ b/test/functional_tests/TriggerSameLineMatchTest.cpp @@ -76,6 +76,7 @@ private slots: { startProfile(mpHostname, mpLocalhost, mpPort); auto* host = mudlet::self()->getActiveHost(); + QVERIFY(host); host->mEchoLuaErrors = true; host->getLuaInterpreter()->compileAndExecuteScript(qsl("captured = {}\n" @@ -98,6 +99,7 @@ private slots: { startProfile(mpHostname, mpLocalhost, mpPort); auto* host = mudlet::self()->getActiveHost(); + QVERIFY(host); host->mEchoLuaErrors = true; host->getLuaInterpreter()->compileAndExecuteScript(qsl("order = {}\n" @@ -119,6 +121,7 @@ private slots: { startProfile(mpHostname, mpLocalhost, mpPort); auto* host = mudlet::self()->getActiveHost(); + QVERIFY(host); host->mEchoLuaErrors = true; host->getLuaInterpreter()->compileAndExecuteScript(qsl("chain = {}\n" @@ -142,6 +145,7 @@ private slots: { startProfile(mpHostname, mpLocalhost, mpPort); auto* host = mudlet::self()->getActiveHost(); + QVERIFY(host); host->mEchoLuaErrors = true; host->getLuaInterpreter()->compileAndExecuteScript(qsl("expiryLine = ''\n" @@ -162,6 +166,7 @@ private slots: { startProfile(mpHostname, mpLocalhost, mpPort); auto* host = mudlet::self()->getActiveHost(); + QVERIFY(host); host->mEchoLuaErrors = true; host->getLuaInterpreter()->compileAndExecuteScript(qsl("lineGrabs = {}\n" @@ -184,6 +189,7 @@ private slots: { startProfile(mpHostname, mpLocalhost, mpPort); auto* host = mudlet::self()->getActiveHost(); + QVERIFY(host); host->mEchoLuaErrors = true; host->getLuaInterpreter()->compileAndExecuteScript(qsl("nested = {}\n" From 045dfc69e6093958935c47dfe6beec8b8dca5651 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Wed, 29 Jul 2026 13:44:08 +0200 Subject: [PATCH 004/155] Infrastructure: resolve CodeQL warnings in the telnet code (#9523) #### Brief overview of PR changes/additions Resolves the three open CodeQL "warning"-level alerts in `src/ctelnet.cpp`: - **`cpp/dead-code-goto`** (alert #2179): removed an unreachable `break;` that sat directly after a `goto NEXT;` inside `cTelnet::gotPrompt()`'s IRE-driver GA/EOR prompt-fixup loop. The `goto` is live control flow and is kept; only the dead `break;` is deleted. - **`cpp/stack-address-escape`** (alerts #1068 and #1069): the two `mZstream.next_in`/`next_out` assignments in `cTelnet::decompressBuffer()`. No code change to the flagged lines; added a `why` comment documenting the safety invariant that already makes them safe. No user-visible behaviour change. #### Motivation for adding to Mudlet Keeps the CodeQL static-analysis results clean so genuine issues stand out, and documents a non-obvious lifetime invariant in the MCCP decompression path. #### Other info (issues closed, discussion etc) Per-alert analysis and how it was verified: **1. `cpp/dead-code-goto` (alert #2179) - REAL dead code, fixed in code.** Inside `cTelnet::gotPrompt()` the inner escape-skipping loop had: ```cpp if (mMudData[j] == 'm') { goto NEXT; break; // unreachable } ``` `goto` transfers control unconditionally, so the following `break;` could never execute. Removed it. The `goto NEXT;` (jump to the `NEXT:` label, which does `++j` then re-enters the outer `while` loop) is live and preserved, as are the two reachable `break;` statements later in the loop. Traced against the recent telnet subnegotiation (#9440) and MCCP work - this loop is the IRE GA/EOR prompt fixup and is untouched by those. Behaviour is byte-for-byte identical. **2 & 3. `cpp/stack-address-escape` (alerts #1068, #1069) - FALSE POSITIVES.** `decompressBuffer(char*& in_buffer, int& length, char* out_buffer)` stores the caller's stack buffers into the member `z_stream mZstream` (`next_in`/`next_out`), calls `inflate()` once, then resets both to `Z_NULL` before returning. CodeQL flags "a stack address which arrived via a parameter may be assigned to a non-local variable" because it is flow-insensitive about that reset. Verified no stack pointer actually outlives its scope: - Both call sites pass stack arrays (`char out_buffer[BUFFER_SIZE + 10]` and the socket `in_buffer`) that are alive for the whole `decompressBuffer` call. - The `next_in = Z_NULL; next_out = Z_NULL;` reset runs on straight-line code immediately after `inflate()`, before every return path (the error branch and the fall-through), so `mZstream` never retains the pointers past return. - No code outside `decompressBuffer` reads `mZstream.next_in`/`next_out` as buffers (grep-confirmed); zlib's persistent `state` owns its own window, not the caller's buffer. Because these are genuine false positives, the flagged assignment lines are left unchanged (no forced churn on the hot decompression path); a comment now documents why the pointers are nulled so the safety invariant is not accidentally removed later. Recommend dismissing alerts #1068 and #1069 as "False positive" in the Security tab - this PR intentionally does not alter the flagged lines, so CodeQL will keep reporting them until dismissed. **Verification:** - Configured + built with `cmake -G Ninja` against Qt 6.12.0 (ASan build), full build clean, plus an incremental rebuild after the final wording tweak - both exit 0. - Ran the telnet/OSC/MXP functional suites under `flock /tmp/mudlet-functional-tests.lock`: `TelnetTextDisplayedTest`, `TelnetSubnegotiationTest`, `TelnetSgrDefaultColorTest`, `TelnetTlsPromptTest`, `TelnetBenchmark`, `TOscTest`, and all `TMxp*` tests - 16/16 passed. (No dedicated MCCP/compression test exists; the decompression path is exercised via the telnet data pipeline and the `decompressBuffer` change is comment-only.) - Reviewed by the `code-reviewer` and `silent-failure-hunter` agents: no Critical or Important findings; one sub-threshold wording nit on the comment was addressed. Assisted-by: Claude:claude-opus-4-8 --- src/ctelnet.cpp | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/src/ctelnet.cpp b/src/ctelnet.cpp index 263f6b58a..ff9a0094e 100644 --- a/src/ctelnet.cpp +++ b/src/ctelnet.cpp @@ -4583,7 +4583,6 @@ void cTelnet::gotPrompt(std::string& mud_data) while (j < s) { if (mMudData[j] == 'm') { goto NEXT; - break; } ++j; } @@ -4756,6 +4755,10 @@ int cTelnet::decompressBuffer(char*& in_buffer, int& length, char* out_buffer) length = mZstream.avail_in; in_buffer = (char*)mZstream.next_in; + // Drop the borrowed caller-buffer pointers now that inflate() is done with + // them: mZstream is a member, so leaving them set would keep it referencing + // the caller's stack buffer after we return - a dangling pointer. mZstream + // should only reference them for the duration of the inflate() call above. mZstream.next_in = Z_NULL; mZstream.next_out = Z_NULL; From 1dfd5c46051ce0913db9d376c9820538be96bc10 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Wed, 29 Jul 2026 13:45:22 +0200 Subject: [PATCH 005/155] infrastructure: release resources in test fixture destructors (#9522) #### Brief overview of PR changes/additions - Convert the raw owning `LuaInterface*` member in the `TLuaInterfaceTest` and `TVariableEditorTest` Qt-Test fixtures to `std::unique_ptr` so the fixture's destructor frees it. - `TLuaInterfaceTest` also stops allocating the interface (and a `lua_State`) twice: members now init to `nullptr`/empty and are allocated only in `init()`; `cleanup()` resets the interface before closing the `lua_State`. #### Motivation for adding to Mudlet Keeps the test suite leak-clean and clears static-analysis warnings, per CLAUDE.md's "smart pointers for non-Qt classes". #### Other info (issues closed, discussion etc) - Clears 2 CodeQL `cpp/resource-not-released-in-destructor` warnings (`test/TVariableEditorTest.cpp`, `test/TLuaInterfaceTest.cpp`). - Also removes a real runtime leak in `TLuaInterfaceTest`: the old fixture never deleted the `interface` and double-allocated it (construction + `init()`), leaking a `LuaInterface` per test plus a construction-time `lua_State`/`LuaInterface`. Verified gone under LeakSanitizer (old binary leaked, new binary is leak-clean; `TVariableEditorTest` already deleted its interface so for it this is modernization). **Test case:** Build and run `ctest -R 'TLuaInterfaceTest|TVariableEditorTest'` - both pass (TLuaInterfaceTest 4/4, TVariableEditorTest 96 passed/13 skipped). Optionally run `./test/TLuaInterfaceTest` with `ASAN_OPTIONS=detect_leaks=1` to confirm no leaks are reported. --- test/TLuaInterfaceTest.cpp | 21 +++++++++++++-------- test/TVariableEditorTest.cpp | 11 +++++++---- 2 files changed, 20 insertions(+), 12 deletions(-) diff --git a/test/TLuaInterfaceTest.cpp b/test/TLuaInterfaceTest.cpp index b66cde91d..c95a75adf 100644 --- a/test/TLuaInterfaceTest.cpp +++ b/test/TLuaInterfaceTest.cpp @@ -22,6 +22,8 @@ #include #include +#include + extern "C" { #if defined(INCLUDE_VERSIONED_LUA_HEADERS) #include @@ -35,26 +37,30 @@ extern "C" { } -class TVarTest : public QObject { -Q_OBJECT +class TVarTest : public QObject +{ + Q_OBJECT private: - lua_State* L = luaL_newstate(); - LuaInterface* interface = new LuaInterface(L); + lua_State* L = nullptr; + std::unique_ptr interface; private slots: // NOLINT(readability-redundant-access-specifiers) void init() { L = luaL_newstate(); - interface = new LuaInterface(L); + interface = std::make_unique(L); } - void cleanup() { + void cleanup() + { + interface.reset(); lua_close(L); } - void execLua(const QString& string) { + void execLua(const QString& string) + { luaL_loadstring(L, string.toUtf8().constData()); lua_pcall(L, 0, 0, 0); } @@ -84,7 +90,6 @@ private slots: // NOLINT(readability-redundant-access-specifiers) QCOMPARE(testVar->getValue(), "1"); QCOMPARE(testVar->getValueType(), LUA_TNUMBER); } - }; #include "TLuaInterfaceTest.moc" diff --git a/test/TVariableEditorTest.cpp b/test/TVariableEditorTest.cpp index 100fa9588..7d728fe73 100644 --- a/test/TVariableEditorTest.cpp +++ b/test/TVariableEditorTest.cpp @@ -22,6 +22,8 @@ #include #include +#include + extern "C" { #if defined(INCLUDE_VERSIONED_LUA_HEADERS) #include @@ -35,12 +37,13 @@ extern "C" { } -class TVariableEditorTest : public QObject { +class TVariableEditorTest : public QObject +{ Q_OBJECT private: lua_State* L = nullptr; - LuaInterface* interface = nullptr; + std::unique_ptr interface; void execLua(const QString& code) { @@ -107,12 +110,12 @@ private slots: { L = luaL_newstate(); luaL_openlibs(L); - interface = new LuaInterface(L); + interface = std::make_unique(L); } void cleanup() { - delete interface; + interface.reset(); lua_close(L); } From 9612f981a918eda52973eff72373157c6a04f0ec Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Wed, 29 Jul 2026 14:17:50 +0200 Subject: [PATCH 006/155] add: help links for packages, wired to the Module Help button (#9453) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit #### Brief overview of PR changes/additions - Package Exporter gains a Help URL field, stored as helpURL in the package's config.lua and round-tripping when updating an installed package - Module Manager's Module Help button reads it from module metadata, falling back to legacy XML-imported help data - Scheme-less URLs get https:// prepended so they open in a browser #### Motivation for adding to Mudlet Package authors had no way to set a help link, leaving the Module Help button dead for most modules. #### Other info (issues closed, discussion etc) Closes #659 Closes #7379 **Test case:** Package Exporter → fill Help URL (e.g. example.com/help) → export → config.lua contains helpURL with https:// added. Install it as a module → Module Manager → select it → Module Help opens the URL. Modules without help data keep the button disabled. https://github.com/user-attachments/assets/719569e3-da2e-4226-9c25-0873b641fee0 --------- Signed-off-by: Vadim Peretokin --- src/dlgModuleManager.cpp | 51 ++++++++++++++++++++++-------------- src/dlgModuleManager.h | 1 + src/dlgPackageExporter.cpp | 14 ++++++++++ src/dlgPackageExporter.h | 1 + src/dlgPackageManager.cpp | 16 +++++++++++ src/dlgPackageManager.h | 1 + src/ui/dlgPackageExporter.ui | 25 +++++++++++++++++- 7 files changed, 88 insertions(+), 21 deletions(-) diff --git a/src/dlgModuleManager.cpp b/src/dlgModuleManager.cpp index 82be0177a..9cc11d11d 100644 --- a/src/dlgModuleManager.cpp +++ b/src/dlgModuleManager.cpp @@ -39,6 +39,9 @@ dlgModuleManager::dlgModuleManager(QWidget* parent, Host* pHost) { setupUi(this); + // nothing is selected yet, so there is no help to show + helpButton->setDisabled(true); + layoutModules(); connect(uninstallButton, &QAbstractButton::clicked, this, &dlgModuleManager::slot_uninstallModule); connect(installButton, &QAbstractButton::clicked, this, &dlgModuleManager::slot_installModule); @@ -205,11 +208,17 @@ void dlgModuleManager::slot_moduleClicked(QTableWidgetItem* pItem) return; } - if (mpHost->moduleHelp.contains(entry->text())) { - helpButton->setDisabled((!mpHost->moduleHelp.value(entry->text()).contains(qsl("helpURL")) || mpHost->moduleHelp.value(entry->text()).value(qsl("helpURL")).isEmpty())); - } else { - helpButton->setDisabled(true); + helpButton->setDisabled(moduleHelpUrl(entry->text()).isEmpty()); +} + +QString dlgModuleManager::moduleHelpUrl(const QString& moduleName) const +{ + const QString url = mpHost->mModuleInfo.value(moduleName).value(qsl("helpURL")); + if (!url.isEmpty()) { + return url; } + // fall back to the legacy source populated by XML-imported data + return mpHost->moduleHelp.value(moduleName).value(qsl("helpURL")); } void dlgModuleManager::slot_moduleChanged(QTableWidgetItem* pItem) @@ -247,22 +256,24 @@ void dlgModuleManager::slot_helpModule() if (!pI) { return; } - if (mpHost->moduleHelp.value(pI->text()).contains(QLatin1String("helpURL")) && !mpHost->moduleHelp.value(pI->text()).value(QLatin1String("helpURL")).isEmpty()) { - if (!mudlet::self()->openWebPage(mpHost->moduleHelp.value(pI->text()).value(QLatin1String("helpURL")))) { - //failed first open, try for a module related path - QTableWidgetItem* item = moduleTable->item(cRow, 3); - if (!item) { - return; - } - const QString itemPath = item->text(); - QStringList path = itemPath.split(QDir::separator()); - path.pop_back(); - path.append(QDir::separator()); - path.append(mpHost->moduleHelp.value(pI->text()).value(QLatin1String("helpURL"))); - const QString path2 = path.join(QString()); - if (!mudlet::self()->openWebPage(path2)) { - helpButton->setDisabled(true); - } + const QString helpUrl = moduleHelpUrl(pI->text()); + if (helpUrl.isEmpty()) { + return; + } + if (!mudlet::self()->openWebPage(helpUrl)) { + //failed first open, try for a module related path + QTableWidgetItem* item = moduleTable->item(cRow, 3); + if (!item) { + return; + } + const QString itemPath = item->text(); + QStringList path = itemPath.split(QDir::separator()); + path.pop_back(); + path.append(QDir::separator()); + path.append(helpUrl); + const QString path2 = path.join(QString()); + if (!mudlet::self()->openWebPage(path2)) { + helpButton->setDisabled(true); } } } diff --git a/src/dlgModuleManager.h b/src/dlgModuleManager.h index 43bfc24e1..b4ed84ee1 100644 --- a/src/dlgModuleManager.h +++ b/src/dlgModuleManager.h @@ -55,6 +55,7 @@ protected: private: void showImportStatus(const QString& message); + QString moduleHelpUrl(const QString& moduleName) const; Host* mpHost = nullptr; }; diff --git a/src/dlgPackageExporter.cpp b/src/dlgPackageExporter.cpp index 4d78dc2e8..d0c9688f8 100644 --- a/src/dlgPackageExporter.cpp +++ b/src/dlgPackageExporter.cpp @@ -558,6 +558,7 @@ void dlgPackageExporter::slot_packageChanged(int index) ui->textEdit_description->setMarkdown(description); const QString version = packageInfo.value(qsl("version")); ui->lineEdit_version->setText(version); + ui->lineEdit_helpUrl->setText(packageInfo.value(qsl("helpURL"))); populateDependencies(); // available dependencies, as opposed to required ones which is next const QStringList dependencies = packageInfo.value(qsl("dependencies")).split(QLatin1Char(',')); ui->comboBox_dependencies->clear(); @@ -1269,6 +1270,18 @@ void dlgPackageExporter::exportXml(bool& isOk, } } +QString dlgPackageExporter::normalizedHelpUrl() const +{ + QString url = ui->lineEdit_helpUrl->text().trimmed(); + // anchored so a "://" buried in a query string does not count as a scheme + static const QRegularExpression schemePattern(qsl("^[a-zA-Z][a-zA-Z0-9+.-]*://")); + if (!url.isEmpty() && !url.contains(schemePattern)) { + // scheme-less URLs silently fail to open in a browser later + url.prepend(qsl("https://")); + } + return url; +} + void dlgPackageExporter::writeConfigFile(const QString& stagingDirName, const QFileInfo& iconFile, const QString& packageDescription) { QStringList dependencies; @@ -1284,6 +1297,7 @@ void dlgPackageExporter::writeConfigFile(const QString& stagingDirName, const QF appendToDetails(qsl("title"), ui->lineEdit_title->text()); appendToDetails(qsl("description"), packageDescription); appendToDetails(qsl("version"), ui->lineEdit_version->text()); + appendToDetails(qsl("helpURL"), normalizedHelpUrl()); appendToDetails(qsl("dependencies"), dependencies.join(",")); const auto iso8601timestamp = utils::dateStamp(); mPackageConfig.append(qsl("created = \"%1\"\n").arg(iso8601timestamp)); diff --git a/src/dlgPackageExporter.h b/src/dlgPackageExporter.h index 474af523b..e663be00d 100644 --- a/src/dlgPackageExporter.h +++ b/src/dlgPackageExporter.h @@ -141,6 +141,7 @@ private: static std::pair zipPackage(const QString& stagingDirName, const QString& packagePathFileName, const QString& xmlPathFileName, const QString& packageName, const QString& packageComment); static std::pair copyAssetsToTmp(const QStringList& assetPaths, const QString& tempPath); QFileInfo copyIconToTmp(const QString& tempPath) const; + QString normalizedHelpUrl() const; void writeConfigFile(const QString& stagingDirName, const QFileInfo& iconFile, const QString& packageDescription); void exportXml(bool& isOk, QList& trigList, diff --git a/src/dlgPackageManager.cpp b/src/dlgPackageManager.cpp index df26deea3..f4a0c43db 100644 --- a/src/dlgPackageManager.cpp +++ b/src/dlgPackageManager.cpp @@ -605,6 +605,16 @@ void dlgPackageManager::slot_openBugWebsite() mudlet::self()->openWebPage(qsl("https://github.com/Mudlet/mudlet-package-repository/issues/new?template=package-bug-or-issue.md&title=[Package%20Bug]%20") + currentItem->text()); } +QString dlgPackageManager::packageHelpUrl(const QString& packageName) const +{ + // a help URL set by the package's author takes precedence over the generic repository website + const QString url = mpHost->mPackageInfo.value(packageName).value(qsl("helpURL")); + if (!url.isEmpty()) { + return url; + } + return packageLookup.value(packageName).value(qsl("helpURL")).toString(); +} + void dlgPackageManager::slot_openPackageWebsite() { const QListWidgetItem* currentItem = packageList->currentItem(); @@ -612,6 +622,12 @@ void dlgPackageManager::slot_openPackageWebsite() return; } + const QString helpUrl = packageHelpUrl(currentItem->text()); + if (!helpUrl.isEmpty()) { + mudlet::self()->openWebPage(helpUrl); + return; + } + mudlet::self()->openWebPage(qsl("https://packages.mudlet.org/packages#pkg-") + currentItem->text()); } diff --git a/src/dlgPackageManager.h b/src/dlgPackageManager.h index f2697461b..4253c4640 100644 --- a/src/dlgPackageManager.h +++ b/src/dlgPackageManager.h @@ -73,6 +73,7 @@ private: void downloadRepositoryIndex(); void fillPackageDetails(const QString& name, const QString& title, const QString& author, const QString& version); bool hasNewerVersion(const QString& installed, const QString& repo) const; + QString packageHelpUrl(const QString& packageName) const; void populatePackagesWithUpdates(); void setupNavigationButtons(); void showImportStatus(const QString& message); diff --git a/src/ui/dlgPackageExporter.ui b/src/ui/dlgPackageExporter.ui index eac7c264d..0c757b3a4 100644 --- a/src/ui/dlgPackageExporter.ui +++ b/src/ui/dlgPackageExporter.ui @@ -360,6 +360,29 @@ Further reading material. e.g. a link to the Mudlet wiki, forums, Github package + + + Webpage where users can find help for this package. It is shown by the "Module Help" button in the Module Manager. + + + Help URL + + + lineEdit_helpUrl + + + + + + + Webpage where users can find help for this package. It is shown by the "Module Help" button in the Module Manager. + + + https://... + + + + Does this package make use of other packages? List them here as requirements. @@ -372,7 +395,7 @@ Further reading material. e.g. a link to the Mudlet wiki, forums, Github package - + From b60578648b505b5158eaf73c47415ad8ab604cab Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Wed, 29 Jul 2026 14:51:53 +0200 Subject: [PATCH 007/155] Fix: scaleMovie collateral disconnect, isAnsi*Color returns, scrolling messages (#9474) #### Brief overview of PR changes/additions Three small Lua UI API fixes: - `scaleMovie(label, false)` used a blanket string-form `disconnect()` that severed *every* consumer of the label's resized signal - including TMedia's connection keeping MSP/MCMP video sized to the label, permanently breaking video resize-tracking. The disconnect is now receiver-targeted via the `QMovie` context, so only the movie-scaling connection is removed. - `isAnsiFgColor`/`isAnsiBgColor` returned zero values on bad input; they now return `nil` + message per house convention (out-of-range code / invalid selection). The success path is unchanged. - `enableScrolling`/`disableScrolling` error strings carried a stray printf argument (no visible change - the format had no specifier - but latently wrong); moved to the standard `warnArgumentValue` helper. #### Motivation for adding to Mudlet The `scaleMovie` bug silently and permanently breaks video resize-tracking for any label also driving MSP/MCMP media; the other two align these functions with Mudlet's error-return conventions and remove a latent formatting bug. #### Other info (issues closed, discussion etc) Six spec cases added to `UI_spec` (with a deliberate fail-check). Tested by hand. Squash-merge with: ``` Assisted-by: Claude:claude-fable-5 Signed-off-by: Vadim Peretokin ``` **Console fixes demo** https://github.com/user-attachments/assets/ab17b1d3-7cd3-46ee-a89c-593d414808aa **scaleMovie video-tracking demo** https://github.com/user-attachments/assets/12629dce-9762-4c70-a632-4bdf45e01ed9 --- src/TLuaInterpreterUI.cpp | 32 +++++++------------ src/mudlet-lua/tests/UI_spec.lua | 55 ++++++++++++++++++++++++++++++++ 2 files changed, 67 insertions(+), 20 deletions(-) diff --git a/src/TLuaInterpreterUI.cpp b/src/TLuaInterpreterUI.cpp index 5aefdafb0..47d683fd9 100644 --- a/src/TLuaInterpreterUI.cpp +++ b/src/TLuaInterpreterUI.cpp @@ -1854,13 +1854,10 @@ int TLuaInterpreter::isAnsiBgColor(lua_State* L) result = host.mpConsole->getBgColor(windowName); auto it = result.begin(); if (result.size() < 3) { - return 0; + return warnArgumentValue(L, __func__, qsl("current selection invalid in window '%1'").arg(windowName)); } - if (ansiBg < 0) { - return 0; - } - if (ansiBg > 16) { - return 0; + if (ansiBg < 0 || ansiBg > 16) { + return warnArgumentValue(L, __func__, qsl("ANSI color %1 out of range (0 to 16)").arg(ansiBg)); } @@ -1948,13 +1945,10 @@ int TLuaInterpreter::isAnsiFgColor(lua_State* L) result = host.mpConsole->getFgColor(windowName); auto it = result.begin(); if (result.size() < 3) { - return 0; + return warnArgumentValue(L, __func__, qsl("current selection invalid in window '%1'").arg(windowName)); } - if (ansiFg < 0) { - return 0; - } - if (ansiFg > 16) { - return 0; + if (ansiFg < 0 || ansiFg > 16) { + return warnArgumentValue(L, __func__, qsl("ANSI color %1 out of range (0 to 16)").arg(ansiFg)); } @@ -3751,9 +3745,7 @@ int TLuaInterpreter::enableScrolling(lua_State* L) { const QString windowName{WINDOW_NAME(L, 1)}; if (windowName.compare(qsl("main"), Qt::CaseSensitive) == 0) { - lua_pushnil(L); - lua_pushfstring(L, "scrolling cannot be enabled/disabled for the 'main' window", windowName.toUtf8().constData()); - return 2; + return warnArgumentValue(L, __func__, "scrolling cannot be enabled/disabled for the 'main' window"); } auto console = CONSOLE(L, windowName); @@ -3767,9 +3759,7 @@ int TLuaInterpreter::disableScrolling(lua_State* L) { const QString windowName{WINDOW_NAME(L, 1)}; if (windowName.compare(qsl("main"), Qt::CaseSensitive) == 0) { - lua_pushnil(L); - lua_pushfstring(L, "scrolling cannot be enabled/disabled for the 'main' window", windowName.toUtf8().constData()); - return 2; + return warnArgumentValue(L, __func__, "scrolling cannot be enabled/disabled for the 'main' window"); } auto console = CONSOLE(L, windowName); @@ -3825,11 +3815,13 @@ int TLuaInterpreter::movieFunc(lua_State* L, const QString& funcName) } movie->setScaledSize(pN->size()); if (autoScale) { - connect(pN, &TLabel::resized, pN, [=] { + connect(pN, &TLabel::resized, movie, [=] { movie->setScaledSize(pN->size()); }); } else { - pN->disconnect(SIGNAL(resized())); + // only drop the movie-scaling connection(s); other consumers of + // the label's resized signal must stay connected + QObject::disconnect(pN, &TLabel::resized, movie, nullptr); } } else { return warnArgumentValue(L, __func__, qsl("'%1' is not a known function name - bug in Mudlet, please report it").arg(funcName)); diff --git a/src/mudlet-lua/tests/UI_spec.lua b/src/mudlet-lua/tests/UI_spec.lua index 26518b920..051aae8b7 100644 --- a/src/mudlet-lua/tests/UI_spec.lua +++ b/src/mudlet-lua/tests/UI_spec.lua @@ -1457,6 +1457,61 @@ describe("Tests UI functions", function() end) end) + describe("Tests isAnsiFgColor/isAnsiBgColor error handling", function() + setup(function() + feedTriggers("isAnsiColor test text\n") + moveCursorUp() + selectCurrentLine() + end) + + teardown(function() + deselect() + moveCursorEnd() + end) + + it("isAnsiFgColor returns nil and a message for an out of range color code", function() + local ok, err = isAnsiFgColor(17) + assert.is_nil(ok) + assert.are.equal("ANSI color 17 out of range (0 to 16)", err) + + ok, err = isAnsiFgColor(-1) + assert.is_nil(ok) + assert.are.equal("ANSI color -1 out of range (0 to 16)", err) + end) + + it("isAnsiBgColor returns nil and a message for an out of range color code", function() + local ok, err = isAnsiBgColor(17) + assert.is_nil(ok) + assert.are.equal("ANSI color 17 out of range (0 to 16)", err) + + ok, err = isAnsiBgColor(-1) + assert.is_nil(ok) + assert.are.equal("ANSI color -1 out of range (0 to 16)", err) + end) + + it("isAnsiFgColor returns a boolean for a valid color code", function() + assert.is_boolean(isAnsiFgColor(0)) + end) + + it("isAnsiBgColor returns a boolean for a valid color code", function() + assert.is_boolean(isAnsiBgColor(0)) + end) + end) + + describe("Tests enableScrolling/disableScrolling error handling", function() + it("enableScrolling returns nil and a message for the main window", function() + local ok, err = enableScrolling("main") + assert.is_nil(ok) + assert.are.equal("scrolling cannot be enabled/disabled for the 'main' window", err) + end) + + it("disableScrolling returns nil and a message for the main window", function() + local ok, err = disableScrolling("main") + assert.is_nil(ok) + assert.are.equal("scrolling cannot be enabled/disabled for the 'main' window", err) + end) + end) + -- BaseUI.parseVitalsLine is the pure parser behind the starter UI's -- prompt/score vitals fallback (the base-ui package installs into fresh -- profiles, including the self-test one) From 8f1375f117c19a4ec62683de9a4c864d8268d38c Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Wed, 29 Jul 2026 15:04:16 +0200 Subject: [PATCH 008/155] fix: replacing the game GUI download dialog no longer cancels the new download (#9519) #### Brief overview of PR changes/additions - When a game re-sends `Client.GUI` while a GUI package download is still running (typically a reconnect mid-download), the new download is no longer aborted the instant its progress dialog replaces the old one - `TMainConsole::showPackageDownloadProgress()` now disconnects the superseded `QProgressDialog` before closing it, so its `close()` -> `canceled()` no longer reaches `slot_cancelPackageDownload()` - `cTelnet::downloadAndInstallGUIPackage()` now aborts an in-flight predecessor reply *before* assigning the new one, so the old transfer tears down through its own `finished()` path instead of leaking and driving the replacement dialog #### Motivation for adding to Mudlet Follow-up hardening for #9507. `QProgressDialog::closeEvent()` emits `canceled()`. Because the new `QNetworkReply` was assigned before `signal_packageDownloadStarted` was emitted, closing the previous dialog fired `slot_cancelPackageDownload()` against the just-created reply, cancelling the fresh download at birth and leaving a frozen, uncancellable dialog that never received progress or finished events. The stale reply also kept driving the new dialog with interleaved progress and wasted bandwidth. #### Other info (issues closed, discussion etc) Follow-up to #9507 (findings F1/F4/F9 from an adversarial review of that PR). Behaviour is otherwise unchanged: a single download still shows, updates, and cancels exactly as before. Functional suite 17/17 green locally. Assisted-by: Claude:claude-opus-4-8 **Test case:** Extends `TelnetTlsPromptTest` with `test_replacingDownloadDialogKeepsNewDownloadAlive`: it starts a real GUI download against a TCP server that accepts but never answers (so the reply stays in flight), triggers a second download that supersedes it, and asserts the new reply is still alive (not aborted) with exactly one dialog surviving. Verified fail-without-fix: reverting the two production changes makes the new assertion fail ("The superseding GUI download left no active network reply."). Manual check: connect to a game that serves a `Client.GUI` package, and while its download progress dialog is up, force the server to re-send `Client.GUI` (e.g. reconnect) - the download completes and installs instead of freezing. --- src/TMainConsole.cpp | 8 ++- src/ctelnet.cpp | 8 +++ src/ctelnet.h | 4 ++ test/functional_tests/TelnetTlsPromptTest.cpp | 49 +++++++++++++++++++ 4 files changed, 67 insertions(+), 2 deletions(-) diff --git a/src/TMainConsole.cpp b/src/TMainConsole.cpp index 327723f60..b0e561c96 100644 --- a/src/TMainConsole.cpp +++ b/src/TMainConsole.cpp @@ -1696,9 +1696,13 @@ void TMainConsole::showPackageDownloadProgress(const QString& title, const QStri qWarning() << "TMainConsole::showPackageDownloadProgress() WARNING - called with no host; ignoring the download-progress request."; return; } - // a second server-triggered download can arrive mid-download; without the - // close, the first dialog leaks frozen and its Cancel aborts the wrong download + // A second server-triggered download can arrive mid-download (e.g. a + // reconnect re-sends Client.GUI). QProgressDialog::close() emits canceled(), + // so closing the superseded dialog while it is still wired to + // slot_cancelPackageDownload() would abort the download this new dialog is + // about to track; detach it before closing. if (mpPackageDownloadProgressDialog) { + mpPackageDownloadProgressDialog->disconnect(); mpPackageDownloadProgressDialog->close(); } // placeholder range; reset by the first download-progress update diff --git a/src/ctelnet.cpp b/src/ctelnet.cpp index ff9a0094e..39961caa4 100644 --- a/src/ctelnet.cpp +++ b/src/ctelnet.cpp @@ -3974,6 +3974,14 @@ void cTelnet::downloadAndInstallGUIPackage(const QString& packageName, const QSt mServerPackage = mudlet::getMudletPath(enums::profileDataItemPath, mProfileName, fileName); mpHost->updateProxySettings(mpDownloader); + // Abort any in-flight predecessor while mpPackageDownloadReply still points + // at it, so it tears down via its own finished() path. Aborting after the + // reassignment below would instead cancel the new reply, and the stale + // reply's progress would otherwise keep driving the replacement dialog. + if (mpPackageDownloadReply) { + mpPackageDownloadReply->abort(); + } + auto request = QNetworkRequest(QUrl(url)); mudlet::self()->setNetworkRequestDefaults(url, request); mpPackageDownloadReply = mpDownloader->get(request); diff --git a/src/ctelnet.h b/src/ctelnet.h index f5c9a47db..b554147e5 100644 --- a/src/ctelnet.h +++ b/src/ctelnet.h @@ -321,6 +321,10 @@ signals: private: cTelnet() = default; + // Lets the functional test drive the real download entry point and inspect + // the in-flight reply, reproducing the dialog-swap cancellation cascade. + friend class TelnetTlsPromptTest; + #if defined(QT_NO_SSL) void abortLosingSocket(QTcpSocket* losingSocket); #else diff --git a/test/functional_tests/TelnetTlsPromptTest.cpp b/test/functional_tests/TelnetTlsPromptTest.cpp index 663947287..315c61ea9 100644 --- a/test/functional_tests/TelnetTlsPromptTest.cpp +++ b/test/functional_tests/TelnetTlsPromptTest.cpp @@ -29,7 +29,11 @@ #include "mudlet.h" #include "utils.h" +#include +#include +#include #include +#include #include extern void qInitResources_mudlet(); @@ -343,6 +347,51 @@ private slots: QCOMPARE(console->findChildren().count(), 1); } + // When a second server-initiated GUI download supersedes one still in + // flight (a reconnect re-sends Client.GUI), swapping the progress dialog + // must not cancel the freshly started download. The superseded dialog's + // close() emits canceled(), which used to abort the just-assigned new reply. + // The test above missed this because it swapped dialogs with no reply live. + void test_replacingDownloadDialogKeepsNewDownloadAlive() + { + startProfile(mHostname, mLocalhost, mPort); + auto host = mudlet::self()->getActiveHost(); + QVERIFY2(host, "No active host available for the test."); + QVERIFY2(host->mpConsole, "The active host has no main console."); + auto console = host->mpConsole; + + // A TCP server that accepts connections but never answers keeps the + // package-download reply in flight (Running, NoError) for the whole + // test, so an unwanted abort() is the only thing that can finish it. + QTcpServer hangingServer; + QVERIFY2(hangingServer.listen(QHostAddress::LocalHost, 0), "Could not start the stand-in download server."); + const QString url = qsl("http://localhost:%1/game-ui.mpackage").arg(hangingServer.serverPort()); + + // First server-initiated download: starts reply #1 and progress dialog #1. + host->mTelnet.downloadAndInstallGUIPackage(qsl("game-ui"), qsl("game-ui.mpackage"), url); + QVERIFY2(host->mTelnet.mpPackageDownloadReply, "The first GUI download did not start a network reply."); + QCOMPARE(console->findChildren().count(), 1); + + // Second download supersedes the first; reply #2 must take over and stay + // live rather than being cancelled the instant its dialog replaces #1. + host->mTelnet.downloadAndInstallGUIPackage(qsl("game-ui"), qsl("game-ui.mpackage"), url); + + QPointer newReply = host->mTelnet.mpPackageDownloadReply; + QVERIFY2(newReply, "The superseding GUI download left no active network reply."); + QVERIFY2(!newReply->isFinished(), "The superseding GUI download was cancelled at birth by the dialog swap."); + QCOMPARE(newReply->error(), QNetworkReply::NoError); + + // Let dialog #1's WA_DeleteOnClose deleteLater() run: exactly one dialog + // survives the swap, and the new download is still alive. + QTest::qWait(50ms); + QCOMPARE(console->findChildren().count(), 1); + QVERIFY2(newReply && newReply->error() == QNetworkReply::NoError, "The superseding GUI download did not survive the dialog swap."); + + // The user's Cancel must still abort the live download. + host->mTelnet.slot_cancelPackageDownload(); + QTest::qWait(50ms); + } + // Builds an MSSP subnegotiation advertising a secure TLS port: // IAC SB MSSP MSSP_VAR "TLS" MSSP_VAL IAC SE QByteArray msspTlsPayload(const QByteArray& port) From f98d3adeda0c7addab48481147968e944ec9406f Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Wed, 29 Jul 2026 16:47:28 +0200 Subject: [PATCH 009/155] fix: getNamedTriggers no longer drops names when trigger types are mixed (#9549) #### Brief overview of PR changes/additions - IDMgr:getTriggers() merges the substring and regex stores with table.n_union (value union) instead of table.update on two arrays (index collision) - Mixed-type specs added; the same-type workaround tests upgraded #### Motivation for adding to Mudlet Registering one named substring trigger and one named regex trigger returned only one name from getNamedTriggers(). #### Other info (issues closed, discussion etc) Fixes #9542 Stacked on the specs-named-objects test branch; fail-without-fix proven (2 specs red on unfixed code). Only occurrence of the pattern - timers/events have single stores. **Test case:** registerNamedTrigger + registerNamedRegexTrigger for one user, getNamedTriggers() returns both names. Awaiting build/test by a maintainer; squash-merge with: Assisted-by: Claude:claude-opus-4-8 (Signed-off-by to be added at squash after testing) --- src/mudlet-lua/lua/IDManager.lua | 4 +++- src/mudlet-lua/tests/IDManager_spec.lua | 21 ++++++++++++++++----- 2 files changed, 19 insertions(+), 6 deletions(-) diff --git a/src/mudlet-lua/lua/IDManager.lua b/src/mudlet-lua/lua/IDManager.lua index 9d8c3f72e..74be6af37 100644 --- a/src/mudlet-lua/lua/IDManager.lua +++ b/src/mudlet-lua/lua/IDManager.lua @@ -192,7 +192,9 @@ function IDMgr:getTimers() end function IDMgr:getTriggers() - local triggerNames = table.update(table.keys(self.triggers), table.keys(self.regexTriggers)) + -- substring and regex names live in separate 1..n arrays, so merge them by + -- value (table.n_union), not by index, or entries at the same index collide + local triggerNames = table.n_union(table.keys(self.triggers), table.keys(self.regexTriggers)) table.sort(triggerNames) return triggerNames end diff --git a/src/mudlet-lua/tests/IDManager_spec.lua b/src/mudlet-lua/tests/IDManager_spec.lua index d6fef51ec..ad13989bd 100644 --- a/src/mudlet-lua/tests/IDManager_spec.lua +++ b/src/mudlet-lua/tests/IDManager_spec.lua @@ -456,14 +456,25 @@ describe("Tests the functionality of IDMgr", function() assert.are.same({"regex_trig"}, getNamedTriggers(user)) end) - it("Should list registered named triggers", function() + it("Should list registered named triggers, mixing substring and regex types", function() + -- https://github.com/Mudlet/Mudlet/issues/9542: substring and regex names + -- live in separate 1..n arrays, so merging them by index collides entries + -- and drops one. Registering one of each type guards that regression. registerNamedTrigger(user, "sub_one", "whatever_sub_one", function() end) - registerNamedTrigger(user, "sub_two", "whatever_sub_two", function() end) + registerNamedRegexTrigger(user, "regex_one", "^whatever_re$", function() end) local names = getNamedTriggers(user) assert.is_equal(2, #names) local present = {} for _, n in ipairs(names) do present[n] = true end - assert.is_true(present["sub_one"] and present["sub_two"], "both named triggers should be listed") + assert.is_true(present["sub_one"] and present["regex_one"], "both substring and regex named triggers should be listed") + end) + + it("Should list a name held by both a substring and a regex trigger only once", function() + -- the two stores can hold the same name at once; the listing is a set of + -- names, so the #9542 union must dedupe rather than report the name twice + registerNamedTrigger(user, "shared", "whatever_shared_sub", function() end) + registerNamedRegexTrigger(user, "shared", "^whatever_shared_re$", function() end) + assert.are.same({"shared"}, getNamedTriggers(user)) end) it("Should delete a named trigger", function() @@ -472,9 +483,9 @@ describe("Tests the functionality of IDMgr", function() assert.are.same({}, getNamedTriggers(user)) end) - it("Should delete all named triggers", function() + it("Should delete all named triggers across both substring and regex stores", function() registerNamedTrigger(user, "t1", "named_trig_all_a", function() end) - registerNamedTrigger(user, "t2", "named_trig_all_b", function() end) + registerNamedRegexTrigger(user, "t2", "^named_trig_all_re$", function() end) assert.is_equal(2, #getNamedTriggers(user)) assert.is_true(deleteAllNamedTriggers(user)) assert.are.same({}, getNamedTriggers(user)) From 2fd0598df9d3925e2bbd65284b1c989e6c3bd591 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Wed, 29 Jul 2026 16:52:39 +0200 Subject: [PATCH 010/155] Infrastructure: ignore speech-dispatcher's one-time startup leak in leak detection (#9521) #### Brief overview Add a single LeakSanitizer suppression for the one-time speech-dispatcher client-library (`libspeechd`) allocation reached through QtTextToSpeech. #### Motivation Qt's speech-dispatcher TTS engine leaks ~428 bytes once at init inside `libspeechd` (`spd_execute_command_with_list_reply`, via `QTextToSpeechEngineSpeechd::connectToSpeechDispatcher()`), with zero Mudlet frames. It only surfaces when a build has QtTextToSpeech **and** a speech-dispatcher daemon is reachable **and** something touches the `tts*` API. That combination makes the "ubuntu gcc lua tests + leak detection" CI job exit 1 for PRs whose tests exercise `tts*`. #### Other info - This unblocks the leak-detection job on #9471, whose new busted tests are the first to exercise the `tts*` API (and therefore the first to trip this leak). - The leak is third-party, one-time init noise, not Mudlet code: the reported stack contains no Mudlet frames, only `libspeechd.so.2` and Qt's speechd plugin. - The entry matches the module that actually allocates (`libspeechd`), consistent with the file's other module-level entries; `leak:libspeechd.so` matches the versioned `libspeechd.so.2` via LSan's substring matching. **Test case:** Verified locally with an ASan build (`-DUSE_SANITIZER=Address`) and a running speech-dispatcher daemon, running a busted spec that calls `ttsGetQueue()` under the CI recipe (`AUTORUN_BUSTED_TESTS`, `MUDLET_TEST_MODE`, `ASAN_OPTIONS=detect_leaks=1`, `LSAN_OPTIONS=suppressions=asan-suppressions.txt:exitcode=1`, under Xvfb): - **Without** the suppression: exit 1, LeakSanitizer reports 428 bytes in 3 allocations (408 direct + 20 indirect) in `spd_execute_command_with_list_reply` ← `QTextToSpeechEngineSpeechd::connectToSpeechDispatcher()`. - **With** the suppression: exit 0, and LSan's "Suppressions used" summary shows `3 428 libspeechd.so`. --- asan-suppressions.txt | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/asan-suppressions.txt b/asan-suppressions.txt index 21256367f..334990e28 100644 --- a/asan-suppressions.txt +++ b/asan-suppressions.txt @@ -68,6 +68,15 @@ leak:libgobject-2.0.so # ============================================================================== leak:libexpat.so +# ============================================================================== +# speech-dispatcher client library leak +# One-time allocation in the speech-dispatcher client (libspeechd) when its +# connection is first opened, reached via QtTextToSpeech's speechd engine. +# Only surfaces when a speech-dispatcher daemon is reachable and something +# touches the tts* API; no Mudlet frames are involved. +# ============================================================================== +leak:libspeechd.so + # ============================================================================== # Qt internal leaks (Qt's integration with system libraries) # These are typically initialization leaks in Qt's platform integration From 1ab457cc19c37466d9b0a13670390d6a2ce23aff Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Wed, 29 Jul 2026 16:59:24 +0200 Subject: [PATCH 011/155] infrastructure: extensive mapper Lua API tests (#9530) #### Brief overview of PR changes/additions - 179 new specs in Mapper_spec.lua on a shared in-memory map fixture (3 areas, 10 rooms, special/locked exits, labels) - Covers 109 of the 117 previously untested mapper functions: rooms/areas/exits CRUD, locks, doors, env colors, custom lines, userdata, search and pathfinding #### Motivation for adding to Mudlet The mapper was the largest untested API domain; these specs lock in its contracts before further refactoring. #### Other info (issues closed, discussion etc) Part of the Lua API test-coverage program (Wave 1). Sabotage-verified: 31% of specs fail when the fixture is corrupted. saveMap/loadMap excluded (covered by C++ MapRoundTripTest; also frozen by open #9469). **Test case:** run the busted suite - Mapper_spec passes green, twice. Assisted-by: Claude:claude-opus-4-8 --- src/mudlet-lua/tests/Mapper_spec.lua | 1352 ++++++++++++++++++++++++++ 1 file changed, 1352 insertions(+) diff --git a/src/mudlet-lua/tests/Mapper_spec.lua b/src/mudlet-lua/tests/Mapper_spec.lua index 4000f79c8..28a8d59bd 100644 --- a/src/mudlet-lua/tests/Mapper_spec.lua +++ b/src/mudlet-lua/tests/Mapper_spec.lua @@ -391,3 +391,1355 @@ describe("Tests searchRoom", function() end) end) + +-- A shared in-memory fixture: three areas and ten rooms wired into a +-- pathfinding diamond, a cross-area link, a special exit and a pair of sandbox +-- rooms used for the mutation-heavy tests. Everything is torn down at the end. +describe("Tests mapper functions against a shared fixture", function() + + local missingRoomId = 990000001 + local missingAreaId = 990000002 + + local areaAlpha, areaBeta, areaGamma + local rA1, rA2, rA3, rA4, rA5 + local rB1, rB2, rG1 + local rSandA, rSandB + + setup(function() + -- The mapper widget is required for zoom, views, player room, export and + -- map info repaint paths; it persists once opened. Asserted so a headless + -- failure surfaces here rather than as dozens of downstream failures. + assert.is_true(openMapWidget()) + + areaAlpha = addAreaName("MapperSpecAlpha") + areaBeta = addAreaName("MapperSpecBeta") + areaGamma = addAreaName("MapperSpecGamma") + + local function makeRoom(area, x, y, z) + local id = createRoomID() + addRoom(id) + setRoomArea(id, area) + setRoomCoordinates(id, x, y, z) + return id + end + + rA1 = makeRoom(areaAlpha, 0, 0, 0) + rA2 = makeRoom(areaAlpha, 1, 0, 0) + rA3 = makeRoom(areaAlpha, 2, 0, 0) + rA4 = makeRoom(areaAlpha, 1, -1, 0) + rA5 = makeRoom(areaAlpha, 2, -1, 0) + rSandA = makeRoom(areaAlpha, 0, -3, 0) + rSandB = makeRoom(areaAlpha, 1, -3, 0) + rB1 = makeRoom(areaBeta, 0, 0, 1) + rB2 = makeRoom(areaBeta, 1, 0, 1) + rG1 = makeRoom(areaGamma, 0, 0, 2) + + -- Pathfinding diamond: a 2-hop east route and a 3-hop south route between + -- rA1 and rA3, both bidirectional. + setExit(rA1, rA2, "east"); setExit(rA2, rA1, "west") + setExit(rA2, rA3, "east"); setExit(rA3, rA2, "west") + setExit(rA1, rA4, "south"); setExit(rA4, rA1, "north") + setExit(rA4, rA5, "east"); setExit(rA5, rA4, "west") + setExit(rA5, rA3, "north"); setExit(rA3, rA5, "south") + -- Cross-area link into Beta. + setExit(rA3, rB1, "up"); setExit(rB1, rA3, "down") + setExit(rB1, rB2, "east"); setExit(rB2, rB1, "west") + -- Gamma is only reachable through a special exit from rB2. + addSpecialExit(rB2, rG1, "enter gate") + + -- Sandbox rooms carry the mutation-heavy exits so the diamond stays clean. + setExit(rSandA, rSandB, "east"); setExit(rSandB, rSandA, "west") + addSpecialExit(rSandA, rSandB, "wibble") + setExitStub(rSandB, "north", true) + end) + + teardown(function() + closeAllMapViews() + os.remove(getMudletHomeDir() .. "/mapper_spec_export.png") + for _, id in ipairs({rA1, rA2, rA3, rA4, rA5, rSandA, rSandB, rB1, rB2, rG1}) do + deleteRoom(id) + end + deleteArea("MapperSpecAlpha") + deleteArea("MapperSpecBeta") + deleteArea("MapperSpecGamma") + end) + + -- saveJsonMap/loadJsonMap are intentionally not covered here: the JSON export + -- runs through a progress dialog and bulk import, and loadJsonMap replaces and + -- re-initialises the entire map, which is incompatible with this shared + -- fixture. JSON persistence is exercised by the C++ MapRoundTripTest instead. + + describe("Tests area listing and naming", function() + it("getAreaTable maps every area name to its ID", function() + local areas = getAreaTable() + assert.is_table(areas) + assert.are.equal(areaAlpha, areas["MapperSpecAlpha"]) + assert.are.equal(areaBeta, areas["MapperSpecBeta"]) + assert.are.equal(areaGamma, areas["MapperSpecGamma"]) + end) + + it("getAreaTableSwap maps every area ID to its name", function() + local areas = getAreaTableSwap() + assert.is_table(areas) + assert.are.equal("MapperSpecAlpha", areas[areaAlpha]) + assert.are.equal("MapperSpecGamma", areas[areaGamma]) + end) + + it("getRoomAreaName resolves an area ID to its name", function() + assert.are.equal("MapperSpecAlpha", getRoomAreaName(areaAlpha)) + end) + + it("getRoomAreaName resolves an area name to its ID", function() + assert.are.equal(areaBeta, getRoomAreaName("MapperSpecBeta")) + end) + + it("getRoomAreaName returns -1 and a message for an unknown area ID", function() + local id, err = getRoomAreaName(missingAreaId) + assert.are.equal(-1, id) + assert.is_string(err) + end) + + it("getRoomAreaName hard-errors on a non-number, non-string argument", function() + assert.has_error(function() getRoomAreaName(true) end) + end) + + it("setAreaName renames an area and getAreaTable reflects it", function() + assert.is_true(setAreaName(areaGamma, "MapperSpecGammaRenamed")) + assert.are.equal("MapperSpecGammaRenamed", getRoomAreaName(areaGamma)) + -- restore so later assertions and teardown keep working + assert.is_true(setAreaName(areaGamma, "MapperSpecGamma")) + end) + + it("setAreaName rejects an empty new name with nil and a message", function() + local ok, err = setAreaName(areaAlpha, "") + assert.is_nil(ok) + assert.is_string(err) + end) + + it("setAreaName rejects duplicating an existing area name", function() + local ok, err = setAreaName(areaAlpha, "MapperSpecBeta") + assert.is_nil(ok) + assert.is_string(err) + end) + + it("addAreaName rejects an empty (whitespace-only) name with nil and a message", function() + local ok, err = addAreaName(" ") + assert.is_nil(ok) + assert.is_string(err) + end) + + it("addAreaName rejects a duplicate name with nil and a message", function() + local ok, err = addAreaName("MapperSpecAlpha") + assert.is_nil(ok) + assert.is_string(err) + end) + end) + + describe("Tests deleteArea", function() + it("removes a throwaway area from getAreaTable", function() + addAreaName("MapperSpecDeleteMe") + assert.is_not_nil(getAreaTable()["MapperSpecDeleteMe"]) + assert.is_true(deleteArea("MapperSpecDeleteMe")) + assert.is_nil(getAreaTable()["MapperSpecDeleteMe"]) + end) + + it("returns nil and a message for an unknown areaID", function() + local ok, err = deleteArea(missingAreaId) + assert.is_nil(ok) + assert.is_string(err) + end) + + it("returns nil and a message for an empty area name", function() + local ok, err = deleteArea("") + assert.is_nil(ok) + assert.is_string(err) + end) + + it("refuses to delete the default area", function() + local ok, err = deleteArea(getRoomAreaName(-1)) + assert.is_nil(ok) + assert.is_string(err) + end) + end) + + describe("Tests area room membership", function() + it("getAreaRooms1 lists the rooms of an area 1-based", function() + local rooms = getAreaRooms1(areaBeta) + assert.is_table(rooms) + assert.is_not_nil(rooms[1]) + assert.is_not_nil(rooms[2]) + assert.is_nil(rooms[3]) + local set = {} + for _, id in pairs(rooms) do set[id] = true end + assert.is_true(set[rB1]) + assert.is_true(set[rB2]) + end) + + it("getAreaRooms lists the rooms of an area 0-based for compatibility", function() + local rooms = getAreaRooms(areaBeta) + assert.is_table(rooms) + assert.is_not_nil(rooms[0]) + assert.is_nil(rooms[2]) + end) + + it("getAreaRooms returns nil for an unknown area", function() + assert.is_nil(getAreaRooms(missingAreaId)) + end) + + it("getRoomsByPosition1 finds the room at a coordinate 1-based", function() + local rooms = getRoomsByPosition1(areaAlpha, 0, 0, 0) + assert.is_table(rooms) + assert.are.equal(rA1, rooms[1]) + end) + + it("getRoomsByPosition finds the room at a coordinate 0-based", function() + local rooms = getRoomsByPosition(areaAlpha, 1, 0, 0) + assert.is_table(rooms) + assert.are.equal(rA2, rooms[0]) + end) + + it("getRoomsByPosition returns nil for an unknown area", function() + assert.is_nil(getRoomsByPosition(missingAreaId, 0, 0, 0)) + end) + + it("getAreaExits lists the rooms with exits leaving the area", function() + local exits = getAreaExits(areaBeta) + assert.is_table(exits) + local set = {} + for _, id in pairs(exits) do set[id] = true end + -- rB1 exits Beta via "down" to rA3, rB2 exits via the special exit to rG1 + assert.is_true(set[rB1]) + assert.is_true(set[rB2]) + end) + + it("getAreaExits with full data keys by source room and command", function() + local exits = getAreaExits(areaBeta, true) + assert.is_table(exits) + assert.is_table(exits[rB1]) + -- rB1 leaves Beta down to rA3; the inner table maps a command to that room + local leavesToRA3 = false + for _, toRoom in pairs(exits[rB1]) do + if toRoom == rA3 then leavesToRA3 = true end + end + assert.is_true(leavesToRA3) + end) + + it("getAreaExits returns nil and a message for an unknown area", function() + local exits, err = getAreaExits(missingAreaId) + assert.is_nil(exits) + assert.is_string(err) + end) + end) + + describe("Tests grid mode", function() + it("getGridMode reports false for a normal area", function() + assert.is_false(getGridMode(areaGamma)) + end) + + it("setGridMode toggles the flag which getGridMode reads back", function() + assert.is_true(setGridMode(areaGamma, true)) + assert.is_true(getGridMode(areaGamma)) + assert.is_true(setGridMode(areaGamma, false)) + assert.is_false(getGridMode(areaGamma)) + end) + + it("setGridMode returns false for an unknown area", function() + assert.is_false(setGridMode(missingAreaId, true)) + end) + + it("getGridMode returns nil and a message for an unknown area", function() + local ok, err = getGridMode(missingAreaId) + assert.is_nil(ok) + assert.is_string(err) + end) + end) + + describe("Tests room area assignment", function() + it("getRoomArea returns the area a room belongs to", function() + assert.are.equal(areaBeta, getRoomArea(rB1)) + end) + + it("getRoomArea returns nil for an unknown room", function() + assert.is_nil(getRoomArea(missingRoomId)) + end) + + it("resetRoomArea parks a room in the default area (-1)", function() + local id = createRoomID() + addRoom(id) + setRoomArea(id, areaAlpha) + assert.are.equal(areaAlpha, getRoomArea(id)) + assert.is_true(resetRoomArea(id)) + assert.are.equal(-1, getRoomArea(id)) + deleteRoom(id) + end) + + it("resetRoomArea returns nil and a message for an unknown room", function() + local ok, err = resetRoomArea(missingRoomId) + assert.is_nil(ok) + assert.is_string(err) + end) + end) + + describe("Tests setRoomArea forms", function() + it("moves a table of rooms into an area in one call", function() + local a = createRoomID(); addRoom(a); setRoomArea(a, areaAlpha) + local b = createRoomID(); addRoom(b); setRoomArea(b, areaAlpha) + assert.is_true(setRoomArea({a, b}, areaBeta)) + assert.are.equal(areaBeta, getRoomArea(a)) + assert.are.equal(areaBeta, getRoomArea(b)) + deleteRoom(a); deleteRoom(b) + end) + + it("accepts an area name as well as an ID", function() + local a = createRoomID(); addRoom(a); setRoomArea(a, areaAlpha) + assert.is_true(setRoomArea(a, "MapperSpecBeta")) + assert.are.equal(areaBeta, getRoomArea(a)) + deleteRoom(a) + end) + + it("returns nil and a message for an unknown areaID", function() + local ok, err = setRoomArea(rSandA, missingAreaId) + assert.is_nil(ok) + assert.is_string(err) + end) + + it("rejects an empty area name with nil and a message", function() + local ok, err = setRoomArea(rSandA, "") + assert.is_nil(ok) + assert.is_string(err) + end) + end) + + describe("Tests room existence and names", function() + it("roomExists is true for a fixture room and false for a missing one", function() + assert.is_true(roomExists(rA1)) + assert.is_false(roomExists(missingRoomId)) + end) + + it("getRooms maps every room ID to its name", function() + local rooms = getRooms() + assert.is_table(rooms) + assert.is_not_nil(rooms[rA1]) + assert.is_not_nil(rooms[rG1]) + end) + + it("setRoomName is read back by getRoomName", function() + assert.is_true(setRoomName(rSandA, "SandboxRoomName")) + assert.are.equal("SandboxRoomName", getRoomName(rSandA)) + end) + + it("getRoomName returns nil and a message for an unknown room", function() + local name, err = getRoomName(missingRoomId) + assert.is_nil(name) + assert.is_string(err) + end) + end) + + describe("Tests room coordinates", function() + it("getRoomCoordinates returns the stored x, y and z", function() + local x, y, z = getRoomCoordinates(rA3) + assert.are.equal(2, x) + assert.are.equal(0, y) + assert.are.equal(0, z) + end) + + it("getRoomCoordinates returns three nils for an unknown room", function() + local x, y, z = getRoomCoordinates(missingRoomId) + assert.is_nil(x) + assert.is_nil(y) + assert.is_nil(z) + end) + end) + + describe("Tests room environment", function() + it("setRoomEnv is read back by getRoomEnv", function() + assert.is_true(setRoomEnv(rSandA, 42)) + assert.are.equal(42, getRoomEnv(rSandA)) + end) + + it("setRoomEnv returns nil and a message for an unknown room", function() + local ok, err = setRoomEnv(missingRoomId, 1) + assert.is_nil(ok) + assert.is_string(err) + end) + end) + + describe("Tests room weight", function() + it("rooms default to a weight of 1", function() + assert.are.equal(1, getRoomWeight(rB2)) + end) + + it("setRoomWeight is read back by getRoomWeight", function() + assert.is_true(setRoomWeight(rSandB, 5)) + assert.are.equal(5, getRoomWeight(rSandB)) + setRoomWeight(rSandB, 1) + end) + + it("setRoomWeight returns nil and a message for an unknown room", function() + local ok, err = setRoomWeight(missingRoomId, 3) + assert.is_nil(ok) + assert.is_string(err) + end) + end) + + describe("Tests room symbol character", function() + it("setRoomChar is read back by getRoomChar", function() + assert.is_true(setRoomChar(rSandA, "@")) + assert.are.equal("@", getRoomChar(rSandA)) + end) + + it("an empty string clears the room symbol", function() + setRoomChar(rSandA, "#") + assert.is_true(setRoomChar(rSandA, "")) + assert.are.equal("", getRoomChar(rSandA)) + end) + + it("getRoomChar returns nil and a message for an unknown room", function() + local ch, err = getRoomChar(missingRoomId) + assert.is_nil(ch) + assert.is_string(err) + end) + end) + + describe("Tests room symbol colour", function() + it("setRoomCharColor is read back by getRoomCharColor", function() + assert.is_true(setRoomCharColor(rSandA, 10, 20, 30)) + local r, g, b = getRoomCharColor(rSandA) + assert.are.equal(10, r) + assert.are.equal(20, g) + assert.are.equal(30, b) + end) + + it("setRoomCharColor hard-errors on an out-of-range component", function() + assert.has_error(function() setRoomCharColor(rSandA, 256, 0, 0) end) + end) + + it("unsetRoomCharColor returns true and clears the stored colour", function() + setRoomCharColor(rSandA, 100, 100, 100) + -- The symbol colour is reset to an invalid QColor whose RGB read-back is + -- undefined, so only the success contract is pinned here. + assert.is_true(unsetRoomCharColor(rSandA)) + end) + + it("unsetRoomCharColor returns nil and a message for an unknown room", function() + local ok, err = unsetRoomCharColor(missingRoomId) + assert.is_nil(ok) + assert.is_string(err) + end) + end) + + describe("Tests room hidden state", function() + it("setRoomHidden is read back by getRoomHidden", function() + assert.is_true(setRoomHidden(rSandB, true)) + assert.is_true(getRoomHidden(rSandB)) + assert.is_true(setRoomHidden(rSandB, false)) + assert.is_false(getRoomHidden(rSandB)) + end) + + it("getHiddenRooms lists only the hidden rooms", function() + setRoomHidden(rSandB, true) + local hidden = getHiddenRooms() + assert.is_table(hidden) + local set = {} + for _, id in pairs(hidden) do set[id] = true end + assert.is_true(set[rSandB]) + assert.is_nil(set[rA1]) + setRoomHidden(rSandB, false) + end) + + it("setRoomHidden returns nil and a message for an unknown room", function() + local ok, err = setRoomHidden(missingRoomId, true) + assert.is_nil(ok) + assert.is_string(err) + end) + end) + + describe("Tests room locking", function() + it("lockRoom toggles a flag that roomLocked reads back", function() + assert.is_true(lockRoom(rSandB, true)) + assert.is_true(roomLocked(rSandB)) + assert.is_true(lockRoom(rSandB, false)) + assert.is_false(roomLocked(rSandB)) + end) + + it("lockRoom returns false for an unknown room", function() + assert.is_false(lockRoom(missingRoomId, true)) + end) + + it("roomLocked returns false for an unknown room", function() + assert.is_false(roomLocked(missingRoomId)) + end) + end) + + describe("Tests room hashes", function() + it("setRoomIDbyHash is read back by both hash getters", function() + setRoomIDbyHash(rSandA, "sandbox-hash") + assert.are.equal(rSandA, getRoomIDbyHash("sandbox-hash")) + assert.are.equal("sandbox-hash", getRoomHashByID(rSandA)) + end) + + it("getRoomIDbyHash returns -1 for an unknown hash", function() + assert.are.equal(-1, getRoomIDbyHash("no-such-hash-anywhere")) + end) + + it("getRoomHashByID returns nil and a message for a room without a hash", function() + local hash, err = getRoomHashByID(rB1) + assert.is_nil(hash) + assert.is_string(err) + end) + end) + + describe("Tests room highlighting", function() + it("highlightRoom returns true for a valid room", function() + assert.is_true(highlightRoom(rSandA, 255, 0, 0, 0, 255, 0, 10, 100, 100)) + end) + + it("highlightRoom returns false for an unknown room", function() + assert.is_false(highlightRoom(missingRoomId, 255, 0, 0, 0, 255, 0, 10, 100, 100)) + end) + + it("unHighlightRoom returns true for a valid room and false for a missing one", function() + highlightRoom(rSandA, 255, 0, 0, 0, 255, 0, 10, 100, 100) + assert.is_true(unHighlightRoom(rSandA)) + assert.is_false(unHighlightRoom(missingRoomId)) + end) + end) + + describe("Tests normal exits", function() + it("getRoomExits reports every stored exit direction", function() + local exits = getRoomExits(rA1) + assert.is_table(exits) + assert.are.equal(rA2, exits["east"]) + assert.are.equal(rA4, exits["south"]) + end) + + it("getRoomExits returns nothing for an unknown room", function() + assert.is_nil(getRoomExits(missingRoomId)) + end) + + it("setExit adds a new exit that getRoomExits reflects", function() + local a = createRoomID(); addRoom(a); setRoomArea(a, areaAlpha) + local b = createRoomID(); addRoom(b); setRoomArea(b, areaAlpha) + assert.is_true(setExit(a, b, "north")) + assert.are.equal(b, getRoomExits(a)["north"]) + deleteRoom(a); deleteRoom(b) + end) + + it("setExit hard-errors on an unparseable direction", function() + assert.has_error(function() setExit(rA1, rA2, "sideways") end) + end) + + it("getAllRoomEntrances lists the rooms that exit into a room", function() + local entrances = getAllRoomEntrances(rA2) + assert.is_table(entrances) + local set = {} + for _, id in pairs(entrances) do set[id] = true end + -- rA1 (east) and rA3 (west) both lead into rA2 + assert.is_true(set[rA1]) + assert.is_true(set[rA3]) + end) + + it("getAllRoomEntrances returns nil and a message for an unknown room", function() + local entrances, err = getAllRoomEntrances(missingRoomId) + assert.is_nil(entrances) + assert.is_string(err) + end) + end) + + describe("Tests exit stubs", function() + it("getExitStubs1 lists stub direction codes 1-based", function() + local stubs = getExitStubs1(rSandB) + assert.is_table(stubs) + assert.are.equal(1, stubs[1]) -- DIR_NORTH + end) + + it("getExitStubs lists stub direction codes 0-based for compatibility", function() + local stubs = getExitStubs(rSandB) + assert.is_table(stubs) + assert.are.equal(1, stubs[0]) + end) + + it("getExitStubsNames maps stub codes to direction names", function() + local names = getExitStubsNames(rSandB) + assert.is_table(names) + assert.are.equal("north", names[1]) + end) + + it("getExitStubs1 returns nil and a message for an unknown room", function() + local stubs, err = getExitStubs1(missingRoomId) + assert.is_nil(stubs) + assert.is_string(err) + end) + + it("setExitStub hard-errors when the room does not exist", function() + assert.has_error(function() setExitStub(missingRoomId, "north", true) end) + end) + + it("setExitStub hard-errors on an unparseable direction", function() + assert.has_error(function() setExitStub(rSandA, "sideways", true) end) + end) + + it("connectExitStub turns a stub into a real exit", function() + local a = createRoomID(); addRoom(a); setRoomArea(a, areaAlpha) + local b = createRoomID(); addRoom(b); setRoomArea(b, areaAlpha) + -- Both rooms need a matching stub: the source going up, the target the + -- reverse (down). + setExitStub(a, "up", true) + setExitStub(b, "down", true) + assert.is_true(connectExitStub(a, b, "up")) + assert.are.equal(b, getRoomExits(a)["up"]) + deleteRoom(a); deleteRoom(b) + end) + + it("connectExitStub hard-errors when the second argument is missing", function() + assert.has_error(function() connectExitStub(rSandA) end) + end) + + it("connectExitStub with only a target ID reports when there is no matching stub", function() + local a = createRoomID(); addRoom(a); setRoomArea(a, areaAlpha) + local b = createRoomID(); addRoom(b); setRoomArea(b, areaAlpha) + local ok, err = connectExitStub(a, b) + assert.is_nil(ok) + assert.is_string(err) + deleteRoom(a); deleteRoom(b) + end) + + it("connectExitStub returns nil and a message for an unparseable direction", function() + local a = createRoomID(); addRoom(a); setRoomArea(a, areaAlpha) + local b = createRoomID(); addRoom(b); setRoomArea(b, areaAlpha) + local ok, err = connectExitStub(a, b, "sideways") + assert.is_nil(ok) + assert.is_string(err) + deleteRoom(a); deleteRoom(b) + end) + end) + + describe("Tests special exits", function() + it("getSpecialExits reports the special exit and its lock state", function() + local exits = getSpecialExits(rB2) + assert.is_table(exits) + assert.is_table(exits[rG1]) + assert.are.equal("0", exits[rG1]["enter gate"]) + end) + + it("getSpecialExitsSwap keys special exits by command", function() + local exits = getSpecialExitsSwap(rB2) + assert.is_table(exits) + assert.are.equal(rG1, exits["enter gate"]) + end) + + it("getSpecialExits returns nil and a message for an unknown room", function() + local exits, err = getSpecialExits(missingRoomId) + assert.is_nil(exits) + assert.is_string(err) + end) + + it("addSpecialExit is read back and removeSpecialExit clears it", function() + assert.is_true(addSpecialExit(rSandB, rSandA, "crawl")) + assert.are.equal(rSandA, getSpecialExitsSwap(rSandB)["crawl"]) + assert.is_true(removeSpecialExit(rSandB, "crawl")) + assert.is_nil(getSpecialExitsSwap(rSandB)["crawl"]) + end) + + it("addSpecialExit rejects an empty command with nil and a message", function() + local ok, err = addSpecialExit(rSandA, rSandB, "") + assert.is_nil(ok) + assert.is_string(err) + end) + + it("addSpecialExit returns nil and a message for an unknown source room", function() + local ok, err = addSpecialExit(missingRoomId, rSandB, "go") + assert.is_nil(ok) + assert.is_string(err) + end) + + it("addSpecialExit returns nil and a message for an unknown entrance room", function() + local ok, err = addSpecialExit(rSandA, missingRoomId, "go") + assert.is_nil(ok) + assert.is_string(err) + end) + + it("getSpecialExits picks the best unlocked exit, or lists all with showAllExits", function() + local x = createRoomID(); addRoom(x); setRoomArea(x, areaAlpha) + local y = createRoomID(); addRoom(y); setRoomArea(y, areaAlpha) + addSpecialExit(x, y, "path1") + addSpecialExit(x, y, "path2") + lockSpecialExit(x, 0, "path1", true) + + -- Default: only the best (unlocked) command to y is returned. + local best = getSpecialExits(x)[y] + assert.is_table(best) + assert.is_nil(best["path1"]) + assert.are.equal("0", best["path2"]) + + -- showAllExits=true: every command is returned with its lock state. + local all = getSpecialExits(x, true)[y] + assert.are.equal("1", all["path1"]) + assert.are.equal("0", all["path2"]) + + deleteRoom(x); deleteRoom(y) + end) + + it("removeSpecialExit returns nil and a message for a non-existent command", function() + local ok, err = removeSpecialExit(rB2, "no such command") + assert.is_nil(ok) + assert.is_string(err) + end) + + it("clearSpecialExits removes every special exit of a room", function() + local a = createRoomID(); addRoom(a); setRoomArea(a, areaAlpha) + addSpecialExit(a, rSandB, "one") + addSpecialExit(a, rSandA, "two") + clearSpecialExits(a) + assert.is_nil(next(getSpecialExitsSwap(a))) + deleteRoom(a) + end) + end) + + describe("Tests exit weights", function() + it("setExitWeight is read back by getExitWeights", function() + assert.is_true(setExitWeight(rSandA, "east", 7)) + assert.are.equal(7, getExitWeights(rSandA)["e"]) + setExitWeight(rSandA, "east", 0) + end) + + it("setExitWeight rejects a negative weight with nil and a message", function() + local ok, err = setExitWeight(rSandA, "east", -1) + assert.is_nil(ok) + assert.is_string(err) + end) + + it("setExitWeight returns nil and a message for a direction with no exit", function() + local ok, err = setExitWeight(rSandA, "down", 3) + assert.is_nil(ok) + assert.is_string(err) + end) + + it("getExitWeights returns an empty table for a room with no weights", function() + assert.is_nil(next(getExitWeights(rB1))) + end) + end) + + describe("Tests exit locks", function() + it("lockExit is read back by hasExitLock", function() + lockExit(rSandA, "east", true) + assert.is_true(hasExitLock(rSandA, "east")) + lockExit(rSandA, "east", false) + assert.is_false(hasExitLock(rSandA, "east")) + end) + + it("hasExitLock returns nothing for an unknown room", function() + assert.is_nil(hasExitLock(missingRoomId, "east")) + end) + + it("lockSpecialExit is read back by hasSpecialExitLock", function() + assert.is_true(lockSpecialExit(rB2, 0, "enter gate", true)) + assert.is_true(hasSpecialExitLock(rB2, 0, "enter gate")) + assert.is_true(lockSpecialExit(rB2, 0, "enter gate", false)) + assert.is_false(hasSpecialExitLock(rB2, 0, "enter gate")) + end) + + it("lockSpecialExit returns nil and a message for a non-existent command", function() + local ok, err = lockSpecialExit(rB2, 0, "no such command", true) + assert.is_nil(ok) + assert.is_string(err) + end) + + it("hasSpecialExitLock returns nil and a message for a non-existent command", function() + local ok, err = hasSpecialExitLock(rB2, 0, "no such command") + assert.is_nil(ok) + assert.is_string(err) + end) + end) + + describe("Tests doors", function() + it("setDoor is read back by getDoors", function() + assert.is_true(setDoor(rSandA, "e", 2)) + assert.are.equal(2, getDoors(rSandA)["e"]) + setDoor(rSandA, "e", 0) + end) + + it("setDoor rejects an out-of-range door type with nil and a message", function() + local ok, err = setDoor(rSandA, "e", 9) + assert.is_nil(ok) + assert.is_string(err) + end) + + it("setDoor returns nil and a message for a direction with no exit", function() + local ok, err = setDoor(rSandA, "w", 1) + assert.is_nil(ok) + assert.is_string(err) + end) + + it("getDoors returns nil and a message for an unknown room", function() + local doors, err = getDoors(missingRoomId) + assert.is_nil(doors) + assert.is_string(err) + end) + end) + + describe("Tests custom exit lines", function() + it("addCustomLine is read back by getCustomLines1 and removed by removeCustomLine", function() + assert.is_true(addCustomLine(rSandA, {{2, 2, 0}}, "e", "dash line", {10, 20, 30}, true)) + local lines = getCustomLines1(rSandA) + assert.is_table(lines["e"]) + assert.are.equal("dash line", lines["e"]["attributes"]["style"]) + assert.is_true(lines["e"]["attributes"]["arrow"]) + assert.is_true(removeCustomLine(rSandA, "e")) + assert.is_nil(getCustomLines1(rSandA)["e"]) + end) + + it("getCustomLines uses 0-based point indexing for compatibility", function() + addCustomLine(rSandA, {{2, 2, 0}}, "e", "solid line", {1, 2, 3}, false) + local lines = getCustomLines(rSandA) + assert.is_table(lines["e"]) + assert.is_not_nil(lines["e"]["points"][0]) + removeCustomLine(rSandA, "e") + end) + + it("addCustomLine rejects a direction the room has no exit for", function() + local ok, err = addCustomLine(rSandA, {{1, 1, 0}}, "w", "solid line", {0, 0, 0}, false) + assert.is_nil(ok) + assert.is_string(err) + end) + + it("addCustomLine draws a line to a target given as a room number", function() + assert.is_true(addCustomLine(rSandA, rSandB, "e", "solid line", {0, 0, 0}, false)) + assert.is_table(getCustomLines1(rSandA)["e"]) + removeCustomLine(rSandA, "e") + end) + + it("addCustomLine rejects an empty coordinate table (Issue #5272 crash guard)", function() + local ok, err = addCustomLine(rSandA, {{}}, "e", "solid line", {0, 0, 0}, false) + assert.is_nil(ok) + assert.is_string(err) + end) + + it("addCustomLine rejects a target room in a different area", function() + local ok, err = addCustomLine(rSandA, rB1, "e", "solid line", {0, 0, 0}, false) + assert.is_nil(ok) + assert.is_string(err) + end) + + it("addCustomLine rejects an invalid line style", function() + local ok, err = addCustomLine(rSandA, {{2, 2, 0}}, "e", "wiggly line", {0, 0, 0}, false) + assert.is_nil(ok) + assert.is_string(err) + end) + + it("addCustomLine rejects an out-of-range colour component", function() + local ok, err = addCustomLine(rSandA, {{2, 2, 0}}, "e", "solid line", {256, 0, 0}, false) + assert.is_nil(ok) + assert.is_string(err) + end) + + it("addCustomLine hard-errors when the second argument is neither number nor table", function() + assert.has_error(function() addCustomLine(rSandA, "notvalid", "e", "solid line", {0, 0, 0}, false) end) + end) + + it("getCustomLines1 returns nil and a message for an unknown room", function() + local lines, err = getCustomLines1(missingRoomId) + assert.is_nil(lines) + assert.is_string(err) + end) + end) + + describe("Tests custom environment colours", function() + it("setCustomEnvColor is read back by getCustomEnvColorTable", function() + assert.is_true(setCustomEnvColor(500, 11, 22, 33, 44)) + local colors = getCustomEnvColorTable() + assert.is_table(colors[500]) + assert.are.equal(11, colors[500][1]) + assert.are.equal(22, colors[500][2]) + assert.are.equal(33, colors[500][3]) + assert.are.equal(44, colors[500][4]) + end) + + it("setCustomEnvColor for IDs 257-272 also updates the profile ANSI colour (documented sync)", function() + -- Since Mudlet 4.20 setting 257-272 deliberately mutates the profile's + -- mapper colours; getCustomEnvColorTable reflects the stored value. This + -- is profile state that outlives even deleteMap, so restore it from a + -- finally() hook: a failed assertion below must not leave the persistent + -- self-test profile stuck on the test colour for later runs. + local before = getCustomEnvColorTable()[257] + finally(function() + setCustomEnvColor(257, before[1], before[2], before[3], before[4]) + end) + assert.is_true(setCustomEnvColor(257, 1, 2, 3, 255)) + local colors = getCustomEnvColorTable() + assert.are.equal(1, colors[257][1]) + assert.are.equal(2, colors[257][2]) + assert.are.equal(3, colors[257][3]) + end) + + it("setCustomEnvColor returns nil and a message for an out-of-range component", function() + local ok, err = setCustomEnvColor(501, 256, 0, 0) + assert.is_nil(ok) + assert.is_string(err) + end) + end) + + describe("Tests map labels", function() + local labelId + + it("createMapLabel returns a numeric label ID", function() + labelId = createMapLabel(areaAlpha, "MapperSpecLabel", 0, 0, 0, 255, 255, 255, 0, 0, 0) + assert.is_number(labelId) + assert.is_true(labelId >= 0) + end) + + it("getMapLabels lists the label by ID and text", function() + local labels = getMapLabels(areaAlpha) + assert.is_table(labels) + assert.are.equal("MapperSpecLabel", labels[labelId]) + end) + + it("getMapLabel returns the properties of a label looked up by ID", function() + local label = getMapLabel(areaAlpha, labelId) + assert.is_table(label) + assert.are.equal("MapperSpecLabel", label.Text) + end) + + it("getMapLabel returns nil and a message for an unknown area", function() + local label, err = getMapLabel(missingAreaId, 0) + assert.is_nil(label) + assert.is_string(err) + end) + + it("createMapImageLabel creates a label (ID >= 0) even when the image is missing", function() + -- A missing image still creates a real (image-less) label; only an invalid + -- area returns -1, so pin ID >= 0 and its presence in the area. + local id = createMapImageLabel(areaAlpha, getMudletHomeDir() .. "/nonexistent.png", 0, 0, 0, 10, 10, 30.0, true) + assert.is_number(id) + assert.is_true(id >= 0) + assert.is_not_nil(getMapLabels(areaAlpha)[id]) + deleteMapLabel(areaAlpha, id) + end) + + it("deleteMapLabel removes the label from getMapLabels", function() + deleteMapLabel(areaAlpha, labelId) + assert.is_nil(getMapLabels(areaAlpha)[labelId]) + end) + end) + + describe("Tests room user data", function() + it("setRoomUserData is read back by getRoomUserData", function() + assert.is_true(setRoomUserData(rSandA, "colour", "blue")) + assert.are.equal("blue", getRoomUserData(rSandA, "colour")) + end) + + it("getRoomUserData returns an empty string for a missing key in back-compat mode", function() + assert.are.equal("", getRoomUserData(rSandA, "no-such-key")) + end) + + it("getRoomUserData returns nil and a message for a missing key with full error reporting", function() + local value, err = getRoomUserData(rSandA, "no-such-key", true) + assert.is_nil(value) + assert.is_string(err) + end) + + it("getRoomUserDataKeys lists the keys of a room", function() + setRoomUserData(rSandB, "alpha", "1") + setRoomUserData(rSandB, "beta", "2") + local keys = getRoomUserDataKeys(rSandB) + assert.is_table(keys) + local set = {} + for _, k in pairs(keys) do set[k] = true end + assert.is_true(set["alpha"]) + assert.is_true(set["beta"]) + end) + + it("getAllRoomUserData returns the whole key/value map", function() + local data = getAllRoomUserData(rSandB) + assert.is_table(data) + assert.are.equal("1", data["alpha"]) + end) + + it("clearRoomUserDataItem removes a single key", function() + setRoomUserData(rSandB, "toremove", "x") + assert.is_true(clearRoomUserDataItem(rSandB, "toremove")) + assert.is_false(clearRoomUserDataItem(rSandB, "toremove")) + end) + + it("clearRoomUserData empties the room and returns false when already empty", function() + local id = createRoomID(); addRoom(id); setRoomArea(id, areaAlpha) + setRoomUserData(id, "k", "v") + assert.is_true(clearRoomUserData(id)) + assert.is_nil(next(getAllRoomUserData(id))) + assert.is_false(clearRoomUserData(id)) + deleteRoom(id) + end) + + it("setRoomUserData returns nil and a message for an unknown room", function() + local ok, err = setRoomUserData(missingRoomId, "k", "v") + assert.is_nil(ok) + assert.is_string(err) + end) + + it("searchRoomUserData with no arguments lists all room-data keys", function() + setRoomUserData(rSandA, "searchable", "yes") + local keys = searchRoomUserData() + assert.is_table(keys) + local set = {} + for _, k in pairs(keys) do set[k] = true end + assert.is_true(set["searchable"]) + end) + + it("searchRoomUserData with a key and value returns the matching room IDs", function() + setRoomUserData(rSandA, "team", "red") + local rooms = searchRoomUserData("team", "red") + assert.is_table(rooms) + local set = {} + for _, id in pairs(rooms) do set[id] = true end + assert.is_true(set[rSandA]) + end) + end) + + describe("Tests area user data", function() + it("setAreaUserData is read back by getAreaUserData", function() + assert.is_true(setAreaUserData(areaAlpha, "climate", "temperate")) + assert.are.equal("temperate", getAreaUserData(areaAlpha, "climate")) + end) + + it("getAllAreaUserData returns the whole key/value map", function() + setAreaUserData(areaAlpha, "climate", "temperate") + local data = getAllAreaUserData(areaAlpha) + assert.is_table(data) + assert.are.equal("temperate", data["climate"]) + end) + + it("getAreaUserData returns nil and a message for a missing key", function() + local value, err = getAreaUserData(areaAlpha, "no-such-key") + assert.is_nil(value) + assert.is_string(err) + end) + + it("setAreaUserData rejects an empty key with nil and a message", function() + local ok, err = setAreaUserData(areaAlpha, "", "value") + assert.is_nil(ok) + assert.is_string(err) + end) + + it("clearAreaUserDataItem removes a single key", function() + setAreaUserData(areaBeta, "toremove", "x") + assert.is_true(clearAreaUserDataItem(areaBeta, "toremove")) + assert.is_false(clearAreaUserDataItem(areaBeta, "toremove")) + end) + + it("clearAreaUserData empties the area and returns false when already empty", function() + setAreaUserData(areaGamma, "k", "v") + assert.is_true(clearAreaUserData(areaGamma)) + assert.is_nil(next(getAllAreaUserData(areaGamma))) + assert.is_false(clearAreaUserData(areaGamma)) + end) + + it("searchAreaUserData with a key and value returns the matching area IDs", function() + setAreaUserData(areaBeta, "region", "north") + local areas = searchAreaUserData("region", "north") + assert.is_table(areas) + local set = {} + for _, id in pairs(areas) do set[id] = true end + assert.is_true(set[areaBeta]) + end) + + it("getAllAreaUserData returns nil and a message for an unknown area", function() + local data, err = getAllAreaUserData(missingAreaId) + assert.is_nil(data) + assert.is_string(err) + end) + end) + + describe("Tests map user data", function() + it("setMapUserData is read back by getMapUserData", function() + assert.is_true(setMapUserData("mapper.spec.key", "value")) + assert.are.equal("value", getMapUserData("mapper.spec.key")) + end) + + it("getMapUserData returns nil and a message for a missing key", function() + local value, err = getMapUserData("mapper.spec.missing") + assert.is_nil(value) + assert.is_string(err) + end) + + it("setMapUserData rejects an empty key with nil and a message", function() + local ok, err = setMapUserData("", "value") + assert.is_nil(ok) + assert.is_string(err) + end) + + it("getAllMapUserData includes a set key", function() + setMapUserData("mapper.spec.all", "here") + local data = getAllMapUserData() + assert.is_table(data) + assert.are.equal("here", data["mapper.spec.all"]) + end) + + it("clearMapUserDataItem removes a single key", function() + setMapUserData("mapper.spec.item", "x") + assert.is_true(clearMapUserDataItem("mapper.spec.item")) + assert.is_false(clearMapUserDataItem("mapper.spec.item")) + end) + + it("clearMapUserData wipes all map user data and reports it had data", function() + setMapUserData("mapper.spec.clearall", "x") + assert.is_true(clearMapUserData()) + assert.is_nil(getAllMapUserData()["mapper.spec.clearall"]) + end) + end) + + describe("Tests collision detection", function() + it("getCollisionLocationsInArea reports coordinates shared by rooms", function() + local a = createRoomID(); addRoom(a); setRoomArea(a, areaGamma); setRoomCoordinates(a, 7, 7, 7) + local b = createRoomID(); addRoom(b); setRoomArea(b, areaGamma); setRoomCoordinates(b, 7, 7, 7) + local collisions = getCollisionLocationsInArea(areaGamma) + assert.is_table(collisions) + local found = false + for _, coordinate in pairs(collisions) do + if coordinate[1] == 7 and coordinate[2] == 7 and coordinate[3] == 7 then + found = true + end + end + assert.is_true(found) + deleteRoom(a); deleteRoom(b) + end) + + it("getCollisionLocationsInArea returns nil and a message for an unknown area", function() + local collisions, err = getCollisionLocationsInArea(missingAreaId) + assert.is_nil(collisions) + assert.is_string(err) + end) + end) + + describe("Tests pathfinding with getPath", function() + after_each(function() + -- Guarantee a clean routing graph even if an assertion above failed. + setExitWeightFilter(nil) + setExitWeight(rA1, "east", 0) + lockRoom(rA2, false) + lockExit(rA1, "east", false) + end) + + it("finds the shortest route and fills the speedwalk globals", function() + local ok, weight = getPath(rA1, rA3) + assert.is_true(ok) + assert.are.equal(2, weight) + assert.are.same({"e", "e"}, speedWalkDir) + assert.are.same({tostring(rA2), tostring(rA3)}, speedWalkPath) + end) + + it("routes across an area boundary", function() + local ok = getPath(rA1, rB2) + assert.is_true(ok) + assert.are.same({"e", "e", "up", "e"}, speedWalkDir) + assert.are.same({tostring(rA2), tostring(rA3), tostring(rB1), tostring(rB2)}, speedWalkPath) + end) + + it("routes through a special exit using its command as the direction", function() + local ok = getPath(rB2, rG1) + assert.is_true(ok) + assert.are.same({"enter gate"}, speedWalkDir) + assert.are.same({tostring(rG1)}, speedWalkPath) + end) + + it("returns false, -1 and a message when no path exists", function() + local ok, weight, err = getPath(rA1, rSandA) + assert.is_false(ok) + assert.are.equal(-1, weight) + assert.is_string(err) + end) + + it("returns nil and a message for an invalid source roomID", function() + local ok, err = getPath(missingRoomId, rA3) + assert.is_nil(ok) + assert.is_string(err) + end) + + it("reroutes when an exit weight makes the short route expensive", function() + setExitWeight(rA1, "east", 100) + local ok = getPath(rA1, rA3) + assert.is_true(ok) + assert.are.same({"s", "e", "n"}, speedWalkDir) + assert.are.same({tostring(rA4), tostring(rA5), tostring(rA3)}, speedWalkPath) + end) + + it("reroutes around a locked room", function() + lockRoom(rA2, true) + local ok = getPath(rA1, rA3) + assert.is_true(ok) + assert.are.same({tostring(rA4), tostring(rA5), tostring(rA3)}, speedWalkPath) + end) + + it("reroutes around a locked exit", function() + lockExit(rA1, "east", true) + local ok = getPath(rA1, rA3) + assert.is_true(ok) + assert.are.same({tostring(rA4), tostring(rA5), tostring(rA3)}, speedWalkPath) + end) + + it("honours an exit weight filter that blocks every exit", function() + setExitWeightFilter(function() return "block" end) + local ok = getPath(rA1, rA3) + assert.is_false(ok) + end) + + it("honours an exit weight filter that overrides a weight to reroute", function() + setExitWeightFilter(function(roomId) if roomId == rA2 then return 100000 end end) + local ok = getPath(rA1, rA3) + assert.is_true(ok) + assert.are.same({tostring(rA4), tostring(rA5), tostring(rA3)}, speedWalkPath) + end) + end) + + describe("Tests gotoRoom argument contract", function() + it("returns nil and a message for an invalid target room", function() + local ok, err = gotoRoom(missingRoomId) + assert.is_nil(ok) + assert.is_string(err) + end) + + it("returns nil and a message when no path leads to the target", function() + -- Set the player room to an isolated sandbox room so the target is + -- unreachable and no speedwalk command is ever sent. + centerview(rSandA) + -- gotoRoom reports the no-path failure with false + message (it uses + -- warnArgumentValue's useFalseInsteadofNil form), unlike the invalid-room + -- case above which returns nil + message. + local ok, err = gotoRoom(rA1) + assert.is_false(ok) + assert.is_string(err) + end) + end) + + describe("Tests player room and centering", function() + it("centerview sets the player room that getPlayerRoom reads back", function() + assert.is_true(centerview(rA1)) + assert.are.equal(rA1, getPlayerRoom()) + end) + + it("centerview returns nil and a message for an unknown room", function() + local ok, err = centerview(missingRoomId) + assert.is_nil(ok) + assert.is_string(err) + end) + end) + + describe("Tests map zoom", function() + it("setMapZoom is read back by getMapZoom for a given area", function() + assert.is_true(setMapZoom(15, areaAlpha)) + assert.are.equal(15, getMapZoom(areaAlpha)) + end) + + it("getMapZoom returns nil and a message for an unknown area", function() + local zoom, err = getMapZoom(missingAreaId) + assert.is_nil(zoom) + assert.is_string(err) + end) + end) + + describe("Tests createMapper argument contract", function() + it("hard-errors when the required coordinate arguments are missing", function() + assert.has_error(function() createMapper() end) + end) + end) + + describe("Tests secondary map views", function() + it("createMapView, getMapViewIds, getMapViewInfo and closeMapView round-trip", function() + local viewId = createMapView(areaBeta) + assert.is_number(viewId) + assert.is_true(viewId > 0) + + local ids = getMapViewIds() + local set = {} + for _, id in pairs(ids) do set[id] = true end + assert.is_true(set[viewId]) + + local info = getMapViewInfo(viewId) + assert.is_table(info) + assert.are.equal(areaBeta, info.areaId) + assert.is_number(info.zoom) + assert.is_number(info.zLevel) + assert.is_number(info.centeredRoomId) + + assert.is_true(closeMapView(viewId)) + end) + + it("closeAllMapViews reports how many views it closed", function() + createMapView(areaAlpha) + createMapView(areaBeta) + local count = closeAllMapViews() + assert.is_number(count) + assert.is_true(count >= 2) + end) + + it("getMapViewInfo returns nil and a message for an unknown view", function() + local info, err = getMapViewInfo(987654) + assert.is_nil(info) + assert.is_string(err) + end) + end) + + describe("Tests registered map info", function() + it("registerMapInfo makes the label appear in getMapInfo and killMapInfo removes it", function() + assert.is_true(registerMapInfo("MapperSpecInfo", function() return "info", false, false end)) + assert.is_not_nil(getMapInfo()["MapperSpecInfo"]) + assert.is_true(killMapInfo("MapperSpecInfo")) + assert.is_nil(getMapInfo()["MapperSpecInfo"]) + end) + + it("killMapInfo returns nil and a message for an unknown label", function() + local ok, err = killMapInfo("NoSuchMapInfoLabel") + assert.is_nil(ok) + assert.is_string(err) + end) + end) + + describe("Tests area image export", function() + it("exportAreaImage returns true for a valid area (the file is written asynchronously)", function() + assert.is_true(exportAreaImage(areaAlpha, getMudletHomeDir() .. "/mapper_spec_export.png")) + end) + + it("exportAreaImage returns nil and a message for an unknown area", function() + local ok, err = exportAreaImage(missingAreaId, getMudletHomeDir() .. "/unused.png") + assert.is_nil(ok) + assert.is_string(err) + end) + end) + + -- Selection functions require a mouse-driven selection that Lua cannot make, + -- and audit/updateMap have no directly observable return; only their argument + -- contracts and safe no-op paths are pinned here. + describe("Tests selection, audit and repaint contracts", function() + it("getMapSelection returns an empty table when nothing is selected", function() + local selection = getMapSelection() + assert.is_table(selection) + assert.is_nil(selection.center) + end) + + it("clearMapSelection returns false when there is no selection to clear", function() + assert.is_false(clearMapSelection()) + end) + + it("auditAreas runs without error", function() + assert.has_no.errors(function() auditAreas() end) + end) + + it("updateMap runs without error", function() + assert.has_no.errors(function() updateMap() end) + end) + end) + +end) + +-- deleteMap wipes the whole map, so it lives in its own block that runs after +-- the shared-fixture tests and builds its own throwaway rooms. +describe("Tests deleteMap", function() + it("removes every room from the map", function() + local a = createRoomID(); addRoom(a) + local b = createRoomID(); addRoom(b) + assert.is_true(roomExists(a)) + assert.is_true(deleteMap()) + assert.is_false(roomExists(a)) + assert.is_false(roomExists(b)) + assert.is_nil(next(getRooms())) + end) +end) From 1a41a2235a363aa2fe2f7839e4ad152a34ba1ced Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Wed, 29 Jul 2026 17:14:14 +0200 Subject: [PATCH 012/155] improve: split the games list into My games and All games tabs (#9452) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit #### Brief overview of PR changes/additions - Tab bar above the connection dialog's games list: "My games" (profiles on disk) and "All games" (full catalog), replacing the right-click "Show my profiles only" stop-gap - Opens on My games when profiles exist, All games on a fresh install; last-used tab and the retired filter's setting are honoured; selection preserved across tab switches - Dedicated single-game builds hide the tab bar and keep their current look #### Motivation for adding to Mudlet One flat grid of ~35 games overwhelmed newcomers and buried the profiles a player actually uses. #### Other info (issues closed, discussion etc) Closes #9140 **Test case:** Fresh install → dialog opens on All games with the tab bar visible. Create a profile, restart → opens on My games showing only that profile, selected with details filled. Switch tabs → selection follows where possible; right-click menu no longer offers "Show my profiles only". https://github.com/user-attachments/assets/50b07d6e-7908-4d25-8b4c-4c6e1396aaea --------- Signed-off-by: Vadim Peretokin --- src/dlgConnectionProfiles.cpp | 95 +++++++++++++++++++++++++++-------- src/dlgConnectionProfiles.h | 8 +++ src/ui/connection_profiles.ui | 33 +++++++----- 3 files changed, 102 insertions(+), 34 deletions(-) diff --git a/src/dlgConnectionProfiles.cpp b/src/dlgConnectionProfiles.cpp index aba5fb9db..498be5df9 100644 --- a/src/dlgConnectionProfiles.cpp +++ b/src/dlgConnectionProfiles.cpp @@ -43,6 +43,7 @@ #include #include #include +#include #include #include #include @@ -89,6 +90,44 @@ dlgConnectionProfiles::dlgConnectionProfiles(QWidget* parent) listWidget_profiles->setContextMenuPolicy(Qt::CustomContextMenu); connect(listWidget_profiles, &QWidget::customContextMenuRequested, this, &dlgConnectionProfiles::slot_profileContextMenu); + mpTabBar = new QTabBar(this); + //: Tab showing only the games the user already has profiles for + mpTabBar->insertTab(scmMyGamesTab, tr("My games")); + //: Tab showing every game Mudlet has a built-in profile for + mpTabBar->insertTab(scmAllGamesTab, tr("All games")); + mpTabBar->setExpanding(false); + mpTabBar->setAccessibleName(tr("games shown")); + mpTabBar->setAccessibleDescription(tr("Switch between showing only your own games and all of the games Mudlet knows about.")); + verticalLayout_gamesList->insertWidget(0, mpTabBar); + setTabOrder(mpTabBar, listWidget_profiles); + + if (!mudlet::self()->mOnlyShownPredefinedProfiles.isEmpty()) { + // dedicated single-game builds only ever show their own game(s), so + // there is nothing to switch between + mpTabBar->hide(); + } else { + auto& settings = *mudlet::self()->mpSettings; + int initialTab = scmMyGamesTab; + if (settings.contains(qsl("connectionDialogActiveTab"))) { + initialTab = settings.value(qsl("connectionDialogActiveTab")).toInt() == scmAllGamesTab ? scmAllGamesTab : scmMyGamesTab; + } else if (settings.value(qsl("showOnlyMyProfiles"), false).toBool()) { + // migrate the retired "Show my profiles only" context menu filter, + // which the "My games" tab replaces + initialTab = scmMyGamesTab; + settings.setValue(qsl("connectionDialogActiveTab"), initialTab); + } else if (QDir(mudlet::getMudletPath(enums::profilesPath)).entryList(QDir::Dirs | QDir::NoDotAndDotDot).isEmpty()) { + // a newcomer has no profiles yet, so show them the catalog + initialTab = scmAllGamesTab; + } + // the retired filter's setting is dropped even when it was false, so it + // cannot resurface should connectionDialogActiveTab ever go missing + settings.remove(qsl("showOnlyMyProfiles")); + mpTabBar->setCurrentIndex(initialTab); + } + // connected only after the initial tab is set, so that setting it is not + // mistaken for the user switching tabs + connect(mpTabBar, &QTabBar::currentChanged, this, &dlgConnectionProfiles::slot_activeTabChanged); + QAbstractButton* abort = dialog_buttonbox->button(QDialogButtonBox::Cancel); connect_button = dialog_buttonbox->addButton(tr("Connect"), QDialogButtonBox::AcceptRole); connect_button->setAccessibleDescription(btn_connOrLoad_disabled_accessDesc); @@ -823,6 +862,33 @@ void dlgConnectionProfiles::continueProfileSave(QListWidgetItem* pItem, const QS } } +bool dlgConnectionProfiles::showingOnlyMyProfiles() const +{ + // the tab bar is hidden for dedicated single-game builds, which list their + // own game(s) unfiltered + return !mpTabBar->isHidden() && mpTabBar->currentIndex() == scmMyGamesTab; +} + +void dlgConnectionProfiles::slot_activeTabChanged(const int index) +{ + mudlet::self()->mpSettings->setValue(qsl("connectionDialogActiveTab"), index); + + const auto* pCurrentItem = listWidget_profiles->currentItem(); + const QString previousSelection = pCurrentItem ? pCurrentItem->data(csmNameRole).toString() : QString(); + + fillout_form(); + + if (previousSelection.isEmpty()) { + return; + } + // keep the same game selected if the newly shown tab also lists it, + // otherwise the automatic selection made by fillout_form() stands + const auto pPreviousItems = findData(*listWidget_profiles, previousSelection, csmNameRole); + if (!pPreviousItems.isEmpty()) { + listWidget_profiles->setCurrentItem(pPreviousItems.first()); + } +} + // On a fresh install with no saved profiles the dialog shows the welcome // message in place of the connection details; swap them back in and undo the // shrink that was applied to fit the welcome message. @@ -1316,7 +1382,7 @@ void dlgConnectionProfiles::fillout_form() auto& settings = *mudlet::self()->mpSettings; auto deletedDefaultMuds = settings.value(qsl("deletedDefaultMuds"), QStringList()).toStringList(); const QStringList& onlyShownPredefinedProfiles{mudlet::self()->mOnlyShownPredefinedProfiles}; - const bool showOnlyMyProfiles = settings.value(qsl("showOnlyMyProfiles"), false).toBool(); + const bool showOnlyMyProfiles = showingOnlyMyProfiles(); if (onlyShownPredefinedProfiles.isEmpty()) { const auto defaultGames = TGameDetails::keys(); for (auto& game : defaultGames) { @@ -1394,6 +1460,12 @@ void dlgConnectionProfiles::fillout_form() break; } } + if (listWidget_profiles->count() == 1 && test_profile_row != 0) { + // The "My games" tab can show a single profile that has not been + // saved to its XML yet, so select it to fill in its details + // instead of leaving the form blank with a game highlighted + toselectRow = 0; + } } else if (predefined_profile_row >= 0) { // If the user is starting one of a MUD's "dedicated" Mudlet versions then // select the first of THAT/THOSE predefined one(s) on first launch: @@ -1560,20 +1632,6 @@ void dlgConnectionProfiles::slot_profileContextMenu(QPoint pos) &dlgConnectionProfiles::slot_setCustomColor); } - menu.addSeparator(); - - auto& settings = *mudlet::self()->mpSettings; - const bool showOnlyMyProfiles = settings.value(qsl("showOnlyMyProfiles"), false).toBool(); - //: Context menu action to toggle hiding default game profiles that have not been used yet - auto* pAction_showMyProfilesOnly = menu.addAction(tr("Show my profiles only")); - pAction_showMyProfilesOnly->setCheckable(true); - pAction_showMyProfilesOnly->setChecked(showOnlyMyProfiles); - connect(pAction_showMyProfilesOnly, &QAction::toggled, this, [this](const bool checked) { - auto& settings = *mudlet::self()->mpSettings; - settings.setValue(qsl("showOnlyMyProfiles"), checked); - fillout_form(); - }); - menu.exec(globalPos); } @@ -1695,12 +1753,7 @@ void dlgConnectionProfiles::slot_copyProfile() dlgConnectionProfiles::CopiedProfileData dlgConnectionProfiles::captureProfileData() const { - return {host_name_entry->text(), - port_entry->text(), - port_ssl_tsl->isChecked() ? Qt::Checked : Qt::Unchecked, - login_entry->text(), - website_entry->text(), - mud_description_textedit->toPlainText()}; + return {host_name_entry->text(), port_entry->text(), port_ssl_tsl->isChecked() ? Qt::Checked : Qt::Unchecked, login_entry->text(), website_entry->text(), mud_description_textedit->toPlainText()}; } // Copying a default profile (one of the predefined games) has nothing to copy diff --git a/src/dlgConnectionProfiles.h b/src/dlgConnectionProfiles.h index 5896d7e6d..3df953509 100644 --- a/src/dlgConnectionProfiles.h +++ b/src/dlgConnectionProfiles.h @@ -29,6 +29,7 @@ #include class QDir; +class QTabBar; namespace pugi { class xml_document; @@ -134,6 +135,10 @@ private: void clearNotificationArea(); void loadPasswordAsync(const QString& profileName); void revealConnectionDetails(); + bool showingOnlyMyProfiles() const; + + static constexpr int scmMyGamesTab = 0; + static constexpr int scmAllGamesTab = 1; // split into 3 properties so each one can be checked individually // important for creation of a folder on disk, for example: name has @@ -148,6 +153,8 @@ private: QPalette mErrorPalette; QPalette mReadOnlyPalette; QAction* mpCopyProfile = nullptr; + // switches the profiles list between the user's own games and the full catalog + QTabBar* mpTabBar = nullptr; QPushButton* offline_button = nullptr; QPushButton* connect_button = nullptr; QLineEdit* delete_profile_lineedit = nullptr; @@ -178,6 +185,7 @@ private: private slots: + void slot_activeTabChanged(const int index); void slot_skipToGamesList(); void slot_profileContextMenu(QPoint pos); void slot_setCustomIcon(); diff --git a/src/ui/connection_profiles.ui b/src/ui/connection_profiles.ui index 38edb2246..15b8ee660 100644 --- a/src/ui/connection_profiles.ui +++ b/src/ui/connection_profiles.ui @@ -101,20 +101,27 @@ 0 - - - - 365 - 0 - + + + 0 - - profiles list - - - QListView::Adjust - - + + + + + 365 + 0 + + + + profiles list + + + QListView::Adjust + + + + From b0fd645af04fc7aa6e5f3d9e576caa4d5fe2b748 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Wed, 29 Jul 2026 17:42:35 +0200 Subject: [PATCH 013/155] fix: highlight triggers no longer stop later color triggers from matching (#9425) #### Brief overview of PR changes/additions - Color triggers now match against a line's colors as they arrived from the game, so a highlight/colorizer trigger earlier in the list no longer breaks color triggers below it - The line's original colors are kept for the duration of the trigger pass (zero-copy: the already-built line is moved instead of discarded); the display and scripts still see the highlighted colors - Nested feedTriggers() passes each get their own snapshot; adds busted tests covering both trigger orders and nesting #### Motivation for adding to Mudlet Trigger behavior should not depend on whether an unrelated highlight trigger happens to sit above a color trigger. #### Other info (issues closed, discussion etc) Fixes #9357 **Test case:** Create a highlight trigger matching some text, and below it a color trigger matching that text's colors (e.g. white on black). `lua feedTriggers("\27[37;40mtext\27[0m\n")` - both fire: the line shows the highlight and the color trigger matches. Previously the color trigger stayed silent. https://github.com/user-attachments/assets/a919f8ac-c843-4772-a6aa-eb77a73cadac Signed-off-by: Vadim Peretokin --- src/TBuffer.cpp | 34 ++++++++ src/TBuffer.h | 6 ++ src/TTrigger.cpp | 9 +- src/mudlet-lua/tests/Trigger_spec.lua | 118 ++++++++++++++++++++++++++ 4 files changed, 165 insertions(+), 2 deletions(-) diff --git a/src/TBuffer.cpp b/src/TBuffer.cpp index 8d1bc3eaa..7c5be1e4e 100644 --- a/src/TBuffer.cpp +++ b/src/TBuffer.cpp @@ -1599,7 +1599,18 @@ void TBuffer::commitLineData(QString line, std::deque chars, const char c const int lineIndex = lineBuffer.size() - 1; mCommitLineIndices.append(lineIndex); if (!mSkipTriggerProcessing) { + // Keep the just-committed formats around so that color triggers + // can match against the colors as received from the game even + // after earlier triggers in this pass have recolored the line; + // save/restore gives nested feedTriggers() passes (which re-enter + // this function) their own snapshot: + std::deque savedPassLine = std::move(mPreTriggerPassLine); + const int savedPassLineNumber = mPreTriggerPassLineNumber; + mPreTriggerPassLine = std::move(chars); + mPreTriggerPassLineNumber = lineIndex; mpHost->mpConsole->runTriggers(lineIndex); + mPreTriggerPassLine = std::move(savedPassLine); + mPreTriggerPassLineNumber = savedPassLineNumber; } // Only use of TBuffer::wrap(), breaks up new text @@ -1813,6 +1824,23 @@ void TBuffer::recordLineLengthForWrapDetection(const qsizetype length) }); } +const std::deque* TBuffer::preTriggerPassLine(int lineNumber) const +{ + if (lineNumber >= 0 && lineNumber == mPreTriggerPassLineNumber) { + return &mPreTriggerPassLine; + } + return nullptr; +} + +// A structural edit to the trigger-pass line makes the edited text the new +// baseline for color matching, as it was before the snapshot existed: +void TBuffer::syncPreTriggerPassLine(int y) +{ + if (y >= 0 && y == mPreTriggerPassLineNumber && y < static_cast(buffer.size())) { + mPreTriggerPassLine = buffer[y]; + } +} + void TBuffer::processMxpWatchdogCallback() { if (!mpHost) { @@ -4749,6 +4777,7 @@ bool TBuffer::insertInLine(QPoint& P, const QString& text, const TChar& format) auto it = buffer[y].begin(); buffer[y].insert(it + x + i, c); } + syncPreTriggerPassLine(y); } else { appendLine(text, 0, text.size(), format.mFgColor, format.mBgColor, format.mFlags); } @@ -5304,6 +5333,7 @@ bool TBuffer::replaceInLine(QPoint& P_begin, QPoint& P_end, const QString& with, auto it1 = buffer[y].begin() + x; auto it2 = buffer[y].begin() + x_end; buffer[y].erase(it1, it2); + syncPreTriggerPassLine(y); } // insert replacement @@ -5436,6 +5466,7 @@ void TBuffer::shrinkBuffer() // We need to adjust the search result line as some lines have now gone // away: mpConsole->mCurrentSearchResult = qMax(0, mpConsole->mCurrentSearchResult - mBatchDeleteSize); + mPreTriggerPassLineNumber = -1; // The removed leading lines shift every remaining index down; keep the // deferred logging state pointing at the same lines @@ -5480,6 +5511,9 @@ bool TBuffer::deleteLines(int from, int to) } buffer.erase(buffer.begin() + from, buffer.begin() + to + 1); + if (mPreTriggerPassLineNumber >= from) { + mPreTriggerPassLineNumber = -1; + } // Keep the deferred logging state in step with the removed lines so // pending text is only dropped when the lines it holds were deleted diff --git a/src/TBuffer.h b/src/TBuffer.h index f0c73ad14..ae22cc7b4 100644 --- a/src/TBuffer.h +++ b/src/TBuffer.h @@ -312,6 +312,9 @@ public: int size() { return static_cast(buffer.size()); } bool isEmpty() const { return buffer.size() == 0; } QString& line(int lineNumber); + // Colors of the current trigger-pass line as committed, before any + // trigger ran; nullptr when lineNumber is not the line being processed: + const std::deque* preTriggerPassLine(int lineNumber) const; int find(int line, const QString& what, int pos); QStringList split(int line, const QString& splitter); QStringList split(int line, const QRegularExpression& splitter); @@ -391,6 +394,7 @@ public: private: inline QList getWrapInfo(const QString& lineText, bool isNewline, const int maxWidth, const int indent, const int hangingIndent); void shrinkBuffer(); + void syncPreTriggerPassLine(int y); int calculateWrapPosition(int lineNumber, int begin, int end); void handleNewLine(); void translateToPlainTextInner(std::string& incoming, bool isFromServer); @@ -503,6 +507,8 @@ private: QString mMudLine; std::deque mMudBuffer; + std::deque mPreTriggerPassLine; + int mPreTriggerPassLineNumber = -1; // A line that ended at the game's own wrap column (Host::mUndoServerWrap) // is held here instead of being committed, so its continuation can be // joined back on and triggers run once over the whole logical line: diff --git a/src/TTrigger.cpp b/src/TTrigger.cpp index 0c5bea767..b199ef258 100644 --- a/src/TTrigger.cpp +++ b/src/TTrigger.cpp @@ -650,6 +650,10 @@ bool TTrigger::match_color_pattern(int line, int patternNumber, int posOffset, i } std::deque& bufferLine = mpHost->mpConsole->buffer.buffer[line]; const QString& lineBuffer = mpHost->mpConsole->buffer.lineBuffer[line]; + // Match against the colors as they arrived from the game, not as already + // recolored by other triggers or scripts earlier in this trigger pass; + // text inserted mid-pass has no game original so it is read live: + const std::deque* pPassLine = mpHost->mpConsole->buffer.preTriggerPassLine(line); // Filter ("only pass matches") parents hand children just the matched // capture, so restrict the scan to that window; for top-level triggers // the window covers the whole line: @@ -671,13 +675,14 @@ bool TTrigger::match_color_pattern(int line, int patternNumber, int posOffset, i } for (auto it = bufferLine.begin() + start; pos < end; ++it, ++pos) { + const TChar& character = (pPassLine && pos < static_cast(pPassLine->size())) ? (*pPassLine)[pos] : *it; // This now allows matching against the current default colours (-1) and // allows ONE of the foreground or background to NOT be considered (-2) // Ideally we should base the matching on only the ANSI code but not // all parts of the text come from the Server and can be determined to // have come from a decoded ANSI code number: - if (((pCT->ansiFg == scmIgnored) || ((pCT->ansiFg == scmDefault) && mpHost->mpConsole->mFgColor == (*it).foreground()) || (pCT->mFgColor == (*it).foreground())) - && ((pCT->ansiBg == scmIgnored) || ((pCT->ansiBg == scmDefault) && mpHost->mpConsole->mBgColor == (*it).background()) || (pCT->mBgColor == (*it).background()))) { + if (((pCT->ansiFg == scmIgnored) || ((pCT->ansiFg == scmDefault) && mpHost->mpConsole->mFgColor == character.foreground()) || (pCT->mFgColor == character.foreground())) + && ((pCT->ansiBg == scmIgnored) || ((pCT->ansiBg == scmDefault) && mpHost->mpConsole->mBgColor == character.background()) || (pCT->mBgColor == character.background()))) { if (matchBegin == -1) { matchBegin = pos; } diff --git a/src/mudlet-lua/tests/Trigger_spec.lua b/src/mudlet-lua/tests/Trigger_spec.lua index df1b7e912..d3b3a6bf5 100644 --- a/src/mudlet-lua/tests/Trigger_spec.lua +++ b/src/mudlet-lua/tests/Trigger_spec.lua @@ -127,6 +127,124 @@ describe("Trigger processing", function() end) + -- Color triggers must match the colors a line arrived with, even when an + -- earlier trigger in the same pass has already recolored it. The display + -- must still show the recolored version. Recoloring uses the same + -- TConsole::setFgColor path as the colorizer trigger checkbox, so this + -- covers both channels. + -- + -- The color trigger callbacks are string code because tempAnsiColorTrigger + -- does not run function callbacks when the expiry argument is omitted, and + -- assertions check containment because default-palette text also matches + -- ANSI white-on-black, so the triggers can fire on unrelated lines too. + describe("color trigger original-color matching", function() + + local function contains(list, value) + for _, v in ipairs(list) do + if v == value then + return true + end + end + return false + end + + it("should match original colors after an earlier trigger recolors the line", function() + _G.colorSnapshotMatches = {} + local highlighted = false + local lineNumber = nil + + local highlightTrigger = tempRegexTrigger("^ColorSnapshotTest$", function() + lineNumber = getLineNumber() + if selectString("ColorSnapshotTest", 1) > -1 then + setFgColor(255, 0, 0) + setBgColor(255, 255, 0) + highlighted = true + end + resetFormat() + end) + -- ANSI 7 = white foreground, ANSI 0 = black background + local colorTrigger = tempAnsiColorTrigger(7, 0, + [[table.insert(_G.colorSnapshotMatches, matches[1])]]) + + feedTriggers("\n\27[37;40mColorSnapshotTest\27[0m\n") + + local matched = contains(_G.colorSnapshotMatches, "ColorSnapshotTest") + killTrigger(highlightTrigger) + killTrigger(colorTrigger) + _G.colorSnapshotMatches = nil + + assert.is_true(highlighted, "Highlighting trigger should have run") + assert.is_true(matched, "Color trigger should match the original colors despite the recoloring") + + -- The display must keep the recolored version + moveCursor(0, lineNumber) + selectString("ColorSnapshotTest", 1) + local r, g, b = getFgColor() + deselect() + resetFormat() + assert.are.equal(255, r, "Display should show the recolored foreground") + assert.are.equal(0, g) + assert.are.equal(0, b) + end) + + it("should match original colors when the color trigger runs before the recoloring one", function() + _G.colorControlMatches = {} + local highlighted = false + + local colorTrigger = tempAnsiColorTrigger(7, 0, + [[table.insert(_G.colorControlMatches, matches[1])]]) + local highlightTrigger = tempRegexTrigger("^ColorSnapshotControl$", function() + if selectString("ColorSnapshotControl", 1) > -1 then + setFgColor(255, 0, 0) + highlighted = true + end + resetFormat() + end) + + feedTriggers("\n\27[37;40mColorSnapshotControl\27[0m\n") + + local matched = contains(_G.colorControlMatches, "ColorSnapshotControl") + killTrigger(colorTrigger) + killTrigger(highlightTrigger) + _G.colorControlMatches = nil + + assert.is_true(matched, "Color trigger should match when it runs first") + assert.is_true(highlighted, "Highlighting trigger should have run") + end) + + it("should keep the outer line's original colors across a nested feedTriggers", function() + _G.innerSnapshotMatches = {} + _G.outerSnapshotMatches = {} + + local outerTrigger = tempRegexTrigger("^OuterSnapshotLine$", function() + if selectString("OuterSnapshotLine", 1) > -1 then + setFgColor(0, 0, 255) + end + resetFormat() + -- ANSI 32/41 = green foreground on red background + feedTriggers("\n\27[32;41mInnerSnapshotLine\27[0m\n") + end) + local innerColorTrigger = tempAnsiColorTrigger(2, 1, + [[table.insert(_G.innerSnapshotMatches, matches[1])]]) + local outerColorTrigger = tempAnsiColorTrigger(7, 0, + [[table.insert(_G.outerSnapshotMatches, matches[1])]]) + + feedTriggers("\n\27[37;40mOuterSnapshotLine\27[0m\n") + + local innerMatched = contains(_G.innerSnapshotMatches, "InnerSnapshotLine") + local outerMatched = contains(_G.outerSnapshotMatches, "OuterSnapshotLine") + killTrigger(outerTrigger) + killTrigger(innerColorTrigger) + killTrigger(outerColorTrigger) + _G.innerSnapshotMatches = nil + _G.outerSnapshotMatches = nil + + assert.is_true(innerMatched, "Inner pass should match the inner line's original colors") + assert.is_true(outerMatched, "Outer pass should still match its original colors after the nested pass") + end) + + end) + describe("tempAnsiColorTrigger callbacks", function() it("should fire a function callback when the expiry argument is omitted", function() From 20009c5ecb879ddad36f418152bf550b6cba7398 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Wed, 29 Jul 2026 17:52:00 +0200 Subject: [PATCH 014/155] fix: variables added while playing are no longer lost when saving (#9492) ### Brief overview of PR changes/additions Fixes silent data loss where saved variables created at runtime could vanish from a profile on save. When exporting a profile, `XMLexport::writeVariablePackage` reused the `VarUnit` variable tree that was built once at profile load. That tree is only ever (re)built at profile load and when the Variables editor populates it, so any variable a script created afterwards was absent from the tree and silently dropped from the saved profile - even when it was marked to be saved. Members a script added to an already-saved table at runtime were dropped for a second reason: only members individually recorded as saved were exported. A table marked saved now exports its members as they exist at save time, recursively - except hidden ones (Mudlet's internals stay out of the XML) and unsaveable ones (functions, references, oversized tables). The export now refreshes the variable tree so it reflects the current Lua state before writing it out. To avoid the refresh disrupting the Variables editor when it is open (rebuilding the tree there would clear the widget the user is interacting with, silently breaking selections and save checkboxes), the refresh is skipped only while that editor view is actually on screen - in that case the editor already owns and keeps the tree current. Changes: - `src/XMLexport.cpp` - refresh the `VarUnit` tree before export, guarded so an on-screen Variables editor is not rebuilt out from under the user; export members of saved tables as they exist at save time. - `src/dlgTriggerEditor.{h,cpp}` - small `variablesViewActive()` accessor used by the guard. - `test/functional_tests/XMLexportVariablesTest.cpp` - fail-first functional tests: a saved variable created after the tree was built is exported (name and value), an unsaved one is not, and hidden-variable preferences are still written. Members a script adds to an already-saved table at runtime (issue #9517) are now saved with the table - including string-, numeric- and nested-table members - while members of unsaved tables, hidden members, function members, reference-keyed members and tables over the 10,000-item limit stay out of the XML. All verified to fail on the unfixed code. ### Motivation for adding to Mudlet Users whose scripts create variables at runtime and mark them to be saved could lose that data on the next save without any warning, which is a serious silent-data-loss bug for profiles. ### Have you tested this? If so, how? Added functional tests (`XMLexportVariablesTest`, 15 cases) that reproduce the losses against the current code and pass with the fix. Also ran `ResetProfileTest` (full profile save/restore round-trip) and `EnableDisableByNameTest` as regression checks - all pass. Fixes #9517 Assisted-by: Claude:claude-opus-4-8 Assisted-by: Claude:claude-fable-5 --- src/XMLexport.cpp | 24 +- src/XMLexport.h | 4 +- src/dlgTriggerEditor.cpp | 5 + src/dlgTriggerEditor.h | 3 + test/functional_tests/CMakeLists.txt | 1 + .../XMLexportVariablesTest.cpp | 471 ++++++++++++++++++ 6 files changed, 502 insertions(+), 6 deletions(-) create mode 100644 test/functional_tests/XMLexportVariablesTest.cpp diff --git a/src/XMLexport.cpp b/src/XMLexport.cpp index 5e3f84e7f..5cab83d4c 100644 --- a/src/XMLexport.cpp +++ b/src/XMLexport.cpp @@ -775,8 +775,16 @@ void XMLexport::writeVariablePackage(Host* pHost, pugi::xml_node& mudletPackage) } } + // Refresh the variable tree so it reflects the current Lua state. The tree + // is otherwise only rebuilt at profile load and when the Variables editor + // populates it, so a variable (or saved table member) a script created + // afterwards would be missing here and silently dropped from the saved + // profile. Skip the refresh only while that editor view is on screen: it + // owns the tree and rebuilding it here would invalidate the widget the user + // is interacting with (its variables would stop responding until refreshed). + const bool variablesEditorOnScreen = pHost->mpEditorDialog && pHost->mpEditorDialog->variablesViewActive(); TVar* base = vu->getBase(); - if (!base) { + if (!variablesEditorOnScreen || !base) { lI->getVars(false); base = vu->getBase(); } @@ -861,9 +869,17 @@ void XMLexport::writeTriggerPackage(const Host* pHost, pugi::xml_node& mudletPac } } -void XMLexport::writeVariable(TVar* pVar, LuaInterface* pLuaInterface, VarUnit* pVariableUnit, pugi::xml_node xmlParent) +void XMLexport::writeVariable(TVar* pVar, LuaInterface* pLuaInterface, VarUnit* pVariableUnit, pugi::xml_node xmlParent, bool insideSavedTable) { - if (pVariableUnit->isSaved(pVar)) { + // a member of a saved table is saved with it even without its own + // savedVars entry: a missing entry cannot be told apart from a member a + // script added after the table was marked saved, and those must not be + // silently dropped (#9517). The ride-along skips hidden variables + // (Mudlet's internals and ones the user hid) and unsaveable ones + // (functions, references, oversized tables); an explicitly saved + // variable exports as it always has. + const bool exportable = pVariableUnit->isSaved(pVar) || (insideSavedTable && pVariableUnit->shouldSave(pVar) && !pVariableUnit->isHidden(pVar)); + if (exportable) { if (pVar->getValueType() == LUA_TTABLE) { auto variableGroup = xmlParent.append_child("VariableGroup"); @@ -874,7 +890,7 @@ void XMLexport::writeVariable(TVar* pVar, LuaInterface* pLuaInterface, VarUnit* QListIterator itNestedVariable(pVar->getChildren(false)); while (itNestedVariable.hasNext()) { - writeVariable(itNestedVariable.next(), pLuaInterface, pVariableUnit, variableGroup); + writeVariable(itNestedVariable.next(), pLuaInterface, pVariableUnit, variableGroup, true); } } else { auto variable = xmlParent.append_child("Variable"); diff --git a/src/XMLexport.h b/src/XMLexport.h index ef7f39be9..d63641b10 100644 --- a/src/XMLexport.h +++ b/src/XMLexport.h @@ -65,13 +65,13 @@ public: void writeAction(TAction*, pugi::xml_node xmlParent); void writeScript(TScript*, pugi::xml_node xmlParent); void writeKey(TKey*, pugi::xml_node xmlParent); - void writeVariable(TVar*, LuaInterface*, VarUnit*, pugi::xml_node xmlParent); + void writeVariable(TVar*, LuaInterface*, VarUnit*, pugi::xml_node xmlParent, bool insideSavedTable = false); void writeModuleXML(const QString& moduleName, const QString& fileName, bool async = false); bool exportHost(const QString& filename_pugi_xml); bool writeGenericPackage(Host* pHost, pugi::xml_node& mMudletPackage, bool ignoreModuleMember = true, bool ignoreVariables = false); bool exportProfile(const QString& exportFileName); - bool exportPackage(const QString &exportFileName, bool ignoreModuleMember = true, bool ignoreVariables = false); + bool exportPackage(const QString& exportFileName, bool ignoreModuleMember = true, bool ignoreVariables = false); bool exportTrigger(const QString& fileName); bool exportTimer(const QString& fileName); bool exportAlias(const QString& fileName); diff --git a/src/dlgTriggerEditor.cpp b/src/dlgTriggerEditor.cpp index 9318f378e..d42701828 100644 --- a/src/dlgTriggerEditor.cpp +++ b/src/dlgTriggerEditor.cpp @@ -9613,6 +9613,11 @@ EditorViewType dlgTriggerEditor::determineViewFromVisibleTree() return EditorViewType::cmUnknownView; } +bool dlgTriggerEditor::variablesViewActive() const +{ + return isVisible() && mCurrentView == EditorViewType::cmVarsView; +} + EditorViewType dlgTriggerEditor::resolveCurrentView() { if (mCurrentView != EditorViewType::cmUnknownView) { diff --git a/src/dlgTriggerEditor.h b/src/dlgTriggerEditor.h index 3cf3261ba..4291b0df4 100644 --- a/src/dlgTriggerEditor.h +++ b/src/dlgTriggerEditor.h @@ -202,6 +202,9 @@ public: int canRecast(QTreeWidgetItem*, int newNameType, int newValueType); void saveVar(); void repopulateVars(); + // true while the Variables view is the one shown on screen, so a profile + // save can avoid rebuilding the tree out from under the live widget + bool variablesViewActive() const; void changeView(EditorViewType); void recurseVariablesUp(QTreeWidgetItem* const, QList&); void recurseVariablesDown(QTreeWidgetItem* const, QList&); diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index eb9f5a08d..0317a7c88 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -21,6 +21,7 @@ set(FUNCTIONAL_TEST_SOURCES EnableDisableByNameTest.cpp ColorTriggerFilterChildTest.cpp GMCPCharLoginTest.cpp + XMLexportVariablesTest.cpp SgrUnderlineStyleTest.cpp LogRestartDuplicateLineTest.cpp ProfileRoundTripTest.cpp diff --git a/test/functional_tests/XMLexportVariablesTest.cpp b/test/functional_tests/XMLexportVariablesTest.cpp new file mode 100644 index 000000000..34e636151 --- /dev/null +++ b/test/functional_tests/XMLexportVariablesTest.cpp @@ -0,0 +1,471 @@ +/*************************************************************************** + * Copyright (C) 2026 by Mudlet Developers * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +/* + * Tests for XMLexport::writeVariablePackage(): variables created after the + * VarUnit tree was last built (e.g. by scripts at runtime) must still be + * written to the profile XML when they are marked as saved. The tree is + * only (re)built at profile load and when the Variables view is populated, + * so without a refresh at export time such variables silently vanish from + * profile saves. Also covers members a script adds to a saved table at + * runtime: they have no savedVars entry of their own but must be saved with + * the table (issue #9517), while hidden and unsaveable members must not be. + * + * Run with: ctest -R XMLexportVariablesTest -V + */ + +#include + +#include "Host.h" +#include "LuaInterface.h" +#include "MudletInstanceCoordinator.h" +#include "TelnetServerStub.h" +#include "VarUnit.h" +#include "XMLexport.h" +#include "ctelnet.h" +#include "dlgConnectionProfiles.h" +#include "mudlet.h" + +extern "C" { +#if defined(INCLUDE_VERSIONED_LUA_HEADERS) +#include +#include +#include +#else +#include +#include +#include +#endif +} + +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); +void initializeQRCResourcesForXMLexportVariablesTest(); + +class XMLexportVariablesTest : public QObject +{ + Q_OBJECT + +private: + TelnetServerStub* mpServer = nullptr; + Host* mpHost = nullptr; + const QString mHostname = "XMLexportVars-Test"; + const QString mLocalhost = "localhost"; + +private slots: + void initTestCase() + { + initializeQRCResourcesForXMLexportVariablesTest(); + + mpServer = new TelnetServerStub(qApp); + // port 0 asks the OS for an ephemeral port, so parallel test runs + // (and other worktrees) cannot collide on a fixed one + mpServer->start(mLocalhost, 0); + QVERIFY2(mpServer->serverPort() != 0, "TelnetServerStub failed to bind a loopback port"); + mudlet::start(); + mudlet::self()->setupConfig(); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique("MudletInstanceCoordinator")); + mudlet::self()->init(); + mudlet::self()->setStorePasswordsSecurely(false); + deleteProfileDirectory(mHostname); + + startProfile(mHostname, mLocalhost, QString::number(mpServer->serverPort())); + mpHost = mudlet::self()->getActiveHost(); + QVERIFY2(mpHost, "No active host after profile creation"); + } + + void cleanupTestCase() + { + mpHost = nullptr; + delete mpServer; + mpServer = nullptr; + deleteProfileDirectory(mHostname); + delete mudlet::self(); + } + + // A saved variable whose Lua value only comes into existence after the + // variable tree was last built (profile load, Variables view opening) + // must still be written out - the save path has to refresh the tree. + void test_lateCreatedSavedVariableIsExported() + { + LuaInterface* lI = mpHost->getLuaInterface(); + VarUnit* vu = lI->getVarUnit(); + // build the tree directly, standing in for the initial build that + // profile load performs (via Host::hideMudletsVariables()) + lI->getVars(false); + QVERIFY(vu->getBase()); + + // a script creates the variable after that; we mark its name as saved + // to emulate a variable persisted in a previous session (savedVars is + // name-keyed and persistent, so it survives a tree rebuild) + lua_State* L = mpHost->mLuaInterpreter.getLuaGlobalState(); + QCOMPARE(luaL_dostring(L, "lateSavedTestVar = 'created after tree build'"), 0); + vu->savedVars.insert(qsl("lateSavedTestVar")); + + const QString xml = exportProfileXml(); + QVERIFY(!xml.isEmpty()); + QVERIFY2(xml.contains(qsl("lateSavedTestVar")), + "saved variable created after the last variable-tree build should " + "still be exported to the profile XML"); + // the value is the payload of the save - make sure it is written, not + // just an empty node with the right name + QVERIFY2(xml.contains(qsl("created after tree build")), "the saved variable's value must be exported, not just its name"); + + // mpHost is shared across the tests, so undo the state this one added + vu->savedVars.remove(qsl("lateSavedTestVar")); + QCOMPARE(luaL_dostring(L, "lateSavedTestVar = nil"), 0); + } + + // The export-time refresh must not start saving variables that are not + // marked as saved. + void test_lateUnsavedVariableIsNotExported() + { + LuaInterface* lI = mpHost->getLuaInterface(); + lI->getVars(false); + + lua_State* L = mpHost->mLuaInterpreter.getLuaGlobalState(); + QCOMPARE(luaL_dostring(L, "lateUnsavedTestVar = 'not marked saved'"), 0); + + const QString xml = exportProfileXml(); + QVERIFY(!xml.isEmpty()); + QVERIFY2(!xml.contains(qsl("lateUnsavedTestVar")), "a variable not marked as saved must not be exported"); + } + + // A member a script adds to a saved table at runtime has no savedVars + // entry of its own, but must still be saved with the table (issue #9517). + void test_runtimeAddedMemberOfSavedTableIsExported() + { + LuaInterface* lI = mpHost->getLuaInterface(); + VarUnit* vu = lI->getVarUnit(); + lua_State* L = mpHost->mLuaInterpreter.getLuaGlobalState(); + QCOMPARE(luaL_dostring(L, "memberTestTable = {existing = 'existing member value'}"), 0); + // ticking a table in the Variables view registers the table and the + // members that exist at that moment + vu->savedVars.insert(qsl("memberTestTable")); + vu->savedVars.insert(qsl("memberTestTable.existing")); + lI->getVars(false); + + // a script adds another member after that + QCOMPARE(luaL_dostring(L, "memberTestTable.newcomer = 'runtime member value'"), 0); + + const QString xml = exportProfileXml(); + QVERIFY(!xml.isEmpty()); + QVERIFY2(xml.contains(qsl("existing member value")), "member registered when the table was ticked must still be exported"); + QVERIFY2(xml.contains(qsl("runtime member value")), "member added to a saved table at runtime must be saved with the table"); + + vu->savedVars.remove(qsl("memberTestTable")); + vu->savedVars.remove(qsl("memberTestTable.existing")); + QCOMPARE(luaL_dostring(L, "memberTestTable = nil"), 0); + } + + // A nested table assigned into a saved table at runtime must be exported + // recursively, right down to its innermost members. + void test_nestedTableAddedToSavedTableIsExported() + { + LuaInterface* lI = mpHost->getLuaInterface(); + VarUnit* vu = lI->getVarUnit(); + lua_State* L = mpHost->mLuaInterpreter.getLuaGlobalState(); + QCOMPARE(luaL_dostring(L, "nestedTestTable = {}"), 0); + vu->savedVars.insert(qsl("nestedTestTable")); + lI->getVars(false); + + QCOMPARE(luaL_dostring(L, "nestedTestTable.inner = {deepest = 'nested member value'}"), 0); + + const QString xml = exportProfileXml(); + QVERIFY(!xml.isEmpty()); + QVERIFY2(xml.contains(qsl("nested member value")), "members of a nested table added to a saved table at runtime must be exported"); + + vu->savedVars.remove(qsl("nestedTestTable")); + QCOMPARE(luaL_dostring(L, "nestedTestTable = nil"), 0); + } + + // The most common shape of issue #9517: a list-style table grown with + // table.insert at runtime. The numeric key must keep its key type so + // import restores t[1] and not t["1"]. + void test_numericKeyMemberAddedAtRuntimeIsExported() + { + LuaInterface* lI = mpHost->getLuaInterface(); + VarUnit* vu = lI->getVarUnit(); + lua_State* L = mpHost->mLuaInterpreter.getLuaGlobalState(); + QCOMPARE(luaL_dostring(L, "numericListTable = {}"), 0); + vu->savedVars.insert(qsl("numericListTable")); + lI->getVars(false); + + QCOMPARE(luaL_dostring(L, "table.insert(numericListTable, 'numeric member value')"), 0); + + const QString xml = exportProfileXml(); + QVERIFY(!xml.isEmpty()); + QVERIFY2(xml.contains(qsl("numeric member value")), "a numeric-keyed member added at runtime must be saved with its table"); + // LUA_TNUMBER == 3: the key type decides whether import restores t[1] or t["1"] + QVERIFY2(xml.contains(qsl("3")), "the numeric member's key type must be numeric so import restores t[1], not t['1']"); + + vu->savedVars.remove(qsl("numericListTable")); + QCOMPARE(luaL_dostring(L, "numericListTable = nil"), 0); + } + + // Design pin: un-ticking a single member in the Variables view only + // removes its name from savedVars, which cannot be told apart from a + // member added after the table was ticked. A saved table therefore + // exports its members as they exist at save time; to keep a member out + // of the profile, hide it, remove it, or stop saving the table. + void test_untickedMemberOfSavedTableStillExports() + { + LuaInterface* lI = mpHost->getLuaInterface(); + VarUnit* vu = lI->getVarUnit(); + lua_State* L = mpHost->mLuaInterpreter.getLuaGlobalState(); + QCOMPARE(luaL_dostring(L, "untickedMemberTable = {kept = 'kept member value', unticked = 'unticked member value'}"), 0); + // ticking the table registers it and both members... + vu->savedVars.insert(qsl("untickedMemberTable")); + vu->savedVars.insert(qsl("untickedMemberTable.kept")); + vu->savedVars.insert(qsl("untickedMemberTable.unticked")); + // ...and un-ticking one member only removes its name again + vu->savedVars.remove(qsl("untickedMemberTable.unticked")); + lI->getVars(false); + + const QString xml = exportProfileXml(); + QVERIFY(!xml.isEmpty()); + QVERIFY2(xml.contains(qsl("kept member value")), "a ticked member of a saved table must be exported"); + QVERIFY2(xml.contains(qsl("unticked member value")), "a saved table exports members as they exist at save time, so an un-ticked member rides along"); + + vu->savedVars.remove(qsl("untickedMemberTable")); + vu->savedVars.remove(qsl("untickedMemberTable.kept")); + QCOMPARE(luaL_dostring(L, "untickedMemberTable = nil"), 0); + } + + // A member table beyond the 10,000-item save limit must not ride along - + // it would bloat every profile save. + void test_oversizedMemberTableIsNotExported() + { + LuaInterface* lI = mpHost->getLuaInterface(); + VarUnit* vu = lI->getVarUnit(); + lua_State* L = mpHost->mLuaInterpreter.getLuaGlobalState(); + QCOMPARE(luaL_dostring(L, + "oversizedHolderTable = {smallMember = 'small member value', bigMember = {}} " + "for i = 1, 10001 do oversizedHolderTable.bigMember[i] = 'oversized member value' end"), + 0); + vu->savedVars.insert(qsl("oversizedHolderTable")); + lI->getVars(false); + + const QString xml = exportProfileXml(); + QVERIFY(!xml.isEmpty()); + QVERIFY2(xml.contains(qsl("small member value")), "a plain member of a saved table must be exported"); + QVERIFY2(!xml.contains(qsl("oversized member value")), "a member table over the 10,000-item limit must not ride along with its saved table"); + + vu->savedVars.remove(qsl("oversizedHolderTable")); + QCOMPARE(luaL_dostring(L, "oversizedHolderTable = nil"), 0); + } + + // A member whose key is a reference (e.g. a table used as a key) cannot + // be restored from XML and must not ride along. + void test_referenceKeyMemberIsNotExported() + { + LuaInterface* lI = mpHost->getLuaInterface(); + VarUnit* vu = lI->getVarUnit(); + lua_State* L = mpHost->mLuaInterpreter.getLuaGlobalState(); + QCOMPARE(luaL_dostring(L, "referenceKeyTable = {plainMember = 'plain member value'} referenceKeyTable[{}] = 'reference member value'"), 0); + vu->savedVars.insert(qsl("referenceKeyTable")); + lI->getVars(false); + + const QString xml = exportProfileXml(); + QVERIFY(!xml.isEmpty()); + QVERIFY2(xml.contains(qsl("plain member value")), "a plain member of a saved table must be exported"); + QVERIFY2(!xml.contains(qsl("reference member value")), "a reference-keyed member must not ride along with its saved table"); + + vu->savedVars.remove(qsl("referenceKeyTable")); + QCOMPARE(luaL_dostring(L, "referenceKeyTable = nil"), 0); + } + + // Members only ride along with tables that are marked saved. + void test_memberOfUnsavedTableIsNotExported() + { + lua_State* L = mpHost->mLuaInterpreter.getLuaGlobalState(); + QCOMPARE(luaL_dostring(L, "unsavedTestTable = {member = 'unsaved member value'}"), 0); + + const QString xml = exportProfileXml(); + QVERIFY(!xml.isEmpty()); + QVERIFY2(!xml.contains(qsl("unsavedTestTable")), "a table not marked as saved must not be exported"); + QVERIFY2(!xml.contains(qsl("unsaved member value")), "members of a table not marked as saved must not be exported"); + + QCOMPARE(luaL_dostring(L, "unsavedTestTable = nil"), 0); + } + + // Hidden variables (Mudlet's internals, or ones the user hid) inside a + // saved table keep needing their own explicit save mark, so internals + // cannot leak into the profile XML through a saved parent. + void test_hiddenMemberOfSavedTableIsNotExported() + { + LuaInterface* lI = mpHost->getLuaInterface(); + VarUnit* vu = lI->getVarUnit(); + lua_State* L = mpHost->mLuaInterpreter.getLuaGlobalState(); + QCOMPARE(luaL_dostring(L, "hiddenMemberTable = {visibleMember = 'visible member value', secretMember = 'secret member value'}"), 0); + vu->savedVars.insert(qsl("hiddenMemberTable")); + vu->addHidden(qsl("hiddenMemberTable.secretMember")); + lI->getVars(false); + + const QString xml = exportProfileXml(); + QVERIFY(!xml.isEmpty()); + QVERIFY2(xml.contains(qsl("visible member value")), "a plain member of a saved table must be exported"); + QVERIFY2(!xml.contains(qsl("secret member value")), "a hidden member must not ride along with its saved table"); + + vu->savedVars.remove(qsl("hiddenMemberTable")); + vu->removeHidden(qsl("hiddenMemberTable.secretMember")); + QCOMPARE(luaL_dostring(L, "hiddenMemberTable = nil"), 0); + } + + // A hidden member the user explicitly ticked stays exported - hiding only + // blocks the ride-along, not an explicit save mark. + void test_explicitlySavedHiddenMemberIsExported() + { + LuaInterface* lI = mpHost->getLuaInterface(); + VarUnit* vu = lI->getVarUnit(); + lua_State* L = mpHost->mLuaInterpreter.getLuaGlobalState(); + QCOMPARE(luaL_dostring(L, "explicitHiddenTable = {pinnedMember = 'pinned member value'}"), 0); + vu->savedVars.insert(qsl("explicitHiddenTable")); + vu->savedVars.insert(qsl("explicitHiddenTable.pinnedMember")); + vu->addHidden(qsl("explicitHiddenTable.pinnedMember")); + lI->getVars(false); + + const QString xml = exportProfileXml(); + QVERIFY(!xml.isEmpty()); + QVERIFY2(xml.contains(qsl("pinned member value")), "a hidden member explicitly marked as saved must still be exported"); + + vu->savedVars.remove(qsl("explicitHiddenTable")); + vu->savedVars.remove(qsl("explicitHiddenTable.pinnedMember")); + vu->removeHidden(qsl("explicitHiddenTable.pinnedMember")); + QCOMPARE(luaL_dostring(L, "explicitHiddenTable = nil"), 0); + } + + // Function members cannot be saved, so they must not ride along either. + void test_functionMemberOfSavedTableIsNotExported() + { + LuaInterface* lI = mpHost->getLuaInterface(); + VarUnit* vu = lI->getVarUnit(); + lua_State* L = mpHost->mLuaInterpreter.getLuaGlobalState(); + QCOMPARE(luaL_dostring(L, "callableHolderTable = {dataMember = 'data member value', callableMember = function() end}"), 0); + vu->savedVars.insert(qsl("callableHolderTable")); + lI->getVars(false); + + const QString xml = exportProfileXml(); + QVERIFY(!xml.isEmpty()); + QVERIFY2(xml.contains(qsl("data member value")), "a plain member of a saved table must be exported"); + QVERIFY2(!xml.contains(qsl("callableMember")), "a function member must not ride along with its saved table"); + + vu->savedVars.remove(qsl("callableHolderTable")); + QCOMPARE(luaL_dostring(L, "callableHolderTable = nil"), 0); + } + + // The export-time refresh must keep writing the user's hidden-variable + // preferences to the HiddenVariables node. + void test_hiddenPreferenceStillExported() + { + VarUnit* vu = mpHost->getLuaInterface()->getVarUnit(); + vu->addHidden(qsl("userHiddenPrefVar")); + + const QString xml = exportProfileXml(); + QVERIFY(!xml.isEmpty()); + QVERIFY2(xml.contains(qsl("userHiddenPrefVar")), "hiddenByUser names must still be written to HiddenVariables"); + + vu->removeHidden(qsl("userHiddenPrefVar")); + } + +private: + QString exportProfileXml() + { + const QString xmlPath = mudlet::getMudletPath(enums::profileHomePath, mHostname) + qsl("/xmlexport-test.xml"); + auto writer = std::make_shared(mpHost); + if (!writer->exportPackage(xmlPath, true, false)) { + return {}; + } + QFile file(xmlPath); + if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) { + return {}; + } + const QString xml = QString::fromUtf8(file.readAll()); + file.close(); + QFile::remove(xmlPath); + return xml; + } + + void startProfile(const QString& hostname, const QString& address, const QString& port) + { + QTimer::singleShot(0, qApp, [hostname, address, port]() { + mudlet::self()->startAutoLogin({}); + QTest::qWait(100); + QTest::mouseClick(mudlet::self()->mpConnectionDialog->new_profile_button, Qt::LeftButton); + QTest::qWait(100); + QTest::keyClicks(QApplication::focusWidget(), hostname); + QTest::qWait(100); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100); + QTest::keyClicks(QApplication::focusWidget(), address); + QTest::qWait(100); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100); + QTest::keyClicks(QApplication::focusWidget(), port); + QTest::qWait(100); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Return); + }); + + QSignalSpy spy(mudlet::self(), &mudlet::signal_profileLoaded); + if (!spy.wait(2000)) { + QFAIL("Profile took too long to load."); + } + auto host = mudlet::self()->getActiveHost(); + if (!host) { + QFAIL("No active host available for the test."); + } + + QSignalSpy spy2(&(host->mTelnet), &cTelnet::signal_connected); + if (!spy2.wait(1000)) { + QFAIL("Could not connect with the host."); + } + } + + void deleteProfileDirectory(const QString& profileName) + { + const QString path = mudlet::getMudletPath(enums::profileHomePath, profileName); + QDir dir(path); + + if (!dir.exists()) { + return; + } + dir.removeRecursively(); + } +}; + +void initializeQRCResourcesForXMLexportVariablesTest() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +#include "XMLexportVariablesTest.moc" +QTEST_MAIN(XMLexportVariablesTest) From d901e5c935fe6779857f866e06fdf0e5df71039b Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Wed, 29 Jul 2026 19:35:56 +0200 Subject: [PATCH 015/155] infrastructure: mock TTS engine and local HTTP server for tests (#9529) #### Brief overview of PR changes/additions - Test mode selects Qt's mock text-to-speech engine, making TTS functions testable headlessly - CI busted runs get a local fixture HTTP server for download/HTTP specs - Smoke specs in Miscallaneous_spec.lua that skip cleanly when mock/server are absent #### Motivation for adding to Mudlet Unlocks TTS and HTTP Lua API coverage in CI with no real speech engine or network egress. #### Other info (issues closed, discussion etc) Part of the Lua API test-coverage program (Wave 0). No behavior change outside MUDLET_TEST_MODE. **Test case:** run the busted suite with the env vars from the workflow - TTS and HTTP smoke specs pass (or skip with a message when infra is absent). Awaiting build/test by a maintainer; squash-merge with: Assisted-by: Claude:claude-opus-4-8 (Signed-off-by to be added at squash after testing) --- .github/workflows/build-mudlet-pr.yml | 27 ++++++ .github/workflows/build-mudlet.yml | 27 ++++++ CI/http-fixture-server.py | 46 ++++++++++ CI/http-fixtures/fixture.txt | 1 + src/TLuaInterpreterTextToSpeech.cpp | 13 ++- src/mudlet-lua/tests/Miscallaneous_spec.lua | 98 +++++++++++++++++++++ 6 files changed, 211 insertions(+), 1 deletion(-) create mode 100644 CI/http-fixture-server.py create mode 100644 CI/http-fixtures/fixture.txt diff --git a/.github/workflows/build-mudlet-pr.yml b/.github/workflows/build-mudlet-pr.yml index 8c555b3b1..482bdadb6 100644 --- a/.github/workflows/build-mudlet-pr.yml +++ b/.github/workflows/build-mudlet-pr.yml @@ -448,6 +448,31 @@ jobs: cd ~/Desktop sudo codesign --remove-signature ~/Desktop/Mudlet.app + - name: (Linux/macOS) Start fixture HTTP server for Lua tests + if: matrix.run_tests == 'true' + shell: bash + run: | + port_file="${{runner.temp}}/mudlet-http-fixture-port" + rm -f "${port_file}" + MUDLET_TEST_HTTP_PORT_FILE="${port_file}" nohup python3 "${{github.workspace}}/CI/http-fixture-server.py" > "${{runner.temp}}/http-fixture-server.log" 2>&1 & + for _ in $(seq 1 50); do + [ -s "${port_file}" ] && break + sleep 0.1 + done + if [ ! -s "${port_file}" ]; then + echo "fixture HTTP server failed to start" >&2 + cat "${{runner.temp}}/http-fixture-server.log" 2>/dev/null || true + exit 1 + fi + port="$(cat "${port_file}")" + if ! curl -fsS "http://127.0.0.1:${port}/fixture.txt" > /dev/null; then + echo "fixture HTTP server is not serving fixtures" >&2 + cat "${{runner.temp}}/http-fixture-server.log" 2>/dev/null || true + exit 1 + fi + echo "MUDLET_TEST_HTTP_PORT=${port}" >> "${GITHUB_ENV}" + echo "fixture HTTP server ready on 127.0.0.1:${port}" + - name: (Linux) Run Lua tests if: matrix.run_tests == 'true' && runner.os == 'Linux' timeout-minutes: 1 @@ -455,6 +480,7 @@ jobs: env: AUTORUN_BUSTED_TESTS: 'true' MUDLET_TEST_MODE: 1 + MUDLET_TEST_REQUIRE_TTS_MOCK: 1 TESTS_DIRECTORY: ${{github.workspace}}/src/mudlet-lua/tests QUIT_MUDLET_AFTER_TESTS: 'true' ASAN_OPTIONS: ${{ matrix.enable_asan == 'true' && 'detect_leaks=1' || '' }} @@ -467,6 +493,7 @@ jobs: env: AUTORUN_BUSTED_TESTS: 'true' MUDLET_TEST_MODE: 1 + MUDLET_TEST_REQUIRE_TTS_MOCK: 1 TESTS_DIRECTORY: ${{github.workspace}}/src/mudlet-lua/tests QUIT_MUDLET_AFTER_TESTS: 'true' ASAN_OPTIONS: detect_leaks=0 diff --git a/.github/workflows/build-mudlet.yml b/.github/workflows/build-mudlet.yml index c81fa7018..2717d0c88 100644 --- a/.github/workflows/build-mudlet.yml +++ b/.github/workflows/build-mudlet.yml @@ -484,6 +484,31 @@ jobs: cd ~/Desktop sudo codesign --remove-signature ~/Desktop/Mudlet.app + - name: (Linux/macOS) Start fixture HTTP server for Lua tests + if: matrix.run_tests == 'true' + shell: bash + run: | + port_file="${{runner.temp}}/mudlet-http-fixture-port" + rm -f "${port_file}" + MUDLET_TEST_HTTP_PORT_FILE="${port_file}" nohup python3 "${{github.workspace}}/CI/http-fixture-server.py" > "${{runner.temp}}/http-fixture-server.log" 2>&1 & + for _ in $(seq 1 50); do + [ -s "${port_file}" ] && break + sleep 0.1 + done + if [ ! -s "${port_file}" ]; then + echo "fixture HTTP server failed to start" >&2 + cat "${{runner.temp}}/http-fixture-server.log" 2>/dev/null || true + exit 1 + fi + port="$(cat "${port_file}")" + if ! curl -fsS "http://127.0.0.1:${port}/fixture.txt" > /dev/null; then + echo "fixture HTTP server is not serving fixtures" >&2 + cat "${{runner.temp}}/http-fixture-server.log" 2>/dev/null || true + exit 1 + fi + echo "MUDLET_TEST_HTTP_PORT=${port}" >> "${GITHUB_ENV}" + echo "fixture HTTP server ready on 127.0.0.1:${port}" + - name: (Linux) Run Lua tests if: matrix.run_tests == 'true' && runner.os == 'Linux' timeout-minutes: 1 @@ -491,6 +516,7 @@ jobs: env: AUTORUN_BUSTED_TESTS: 'true' MUDLET_TEST_MODE: 1 + MUDLET_TEST_REQUIRE_TTS_MOCK: 1 TESTS_DIRECTORY: ${{github.workspace}}/src/mudlet-lua/tests QUIT_MUDLET_AFTER_TESTS: 'true' ASAN_OPTIONS: ${{ matrix.enable_asan == 'true' && 'detect_leaks=1' || '' }} @@ -503,6 +529,7 @@ jobs: env: AUTORUN_BUSTED_TESTS: 'true' MUDLET_TEST_MODE: 1 + MUDLET_TEST_REQUIRE_TTS_MOCK: 1 TESTS_DIRECTORY: ${{github.workspace}}/src/mudlet-lua/tests QUIT_MUDLET_AFTER_TESTS: 'true' ASAN_OPTIONS: detect_leaks=0 diff --git a/CI/http-fixture-server.py b/CI/http-fixture-server.py new file mode 100644 index 000000000..1ba2a2408 --- /dev/null +++ b/CI/http-fixture-server.py @@ -0,0 +1,46 @@ +#!/usr/bin/env python3 +"""Minimal fixture HTTP server for Mudlet's busted networking specs. + +Serves the sibling ``http-fixtures/`` directory over localhost so the Lua test +suite can exercise getHTTP/downloadFile against a real, local endpoint instead +of the public internet. + +An OS-assigned (ephemeral) port is used rather than a fixed one: Mudlet CI may +run several jobs on the same machine, and a hard-coded port would risk +collisions there. The chosen port is written to the file named by the +``MUDLET_TEST_HTTP_PORT_FILE`` environment variable so the launching CI step can +forward it to Mudlet as ``MUDLET_TEST_HTTP_PORT``. +""" + +import http.server +import os +import socketserver + +FIXTURES_DIR = os.path.join(os.path.dirname(os.path.abspath(__file__)), "http-fixtures") + + +class QuietHandler(http.server.SimpleHTTPRequestHandler): + def __init__(self, *args, **kwargs): + super().__init__(*args, directory=FIXTURES_DIR, **kwargs) + + def log_message(self, *args): + # Keep CI logs quiet; the tests assert on effects, not on server chatter. + pass + + +def main(): + with socketserver.TCPServer(("127.0.0.1", 0), QuietHandler) as httpd: + port = httpd.server_address[1] + port_file = os.environ.get("MUDLET_TEST_HTTP_PORT_FILE") + if port_file: + # Write then rename so the launcher never reads a torn/empty port. + tmp_file = port_file + ".tmp" + with open(tmp_file, "w", encoding="utf-8") as handle: + handle.write(str(port)) + os.replace(tmp_file, port_file) + print(f"Serving Mudlet test fixtures on http://127.0.0.1:{port}", flush=True) + httpd.serve_forever() + + +if __name__ == "__main__": + main() diff --git a/CI/http-fixtures/fixture.txt b/CI/http-fixtures/fixture.txt new file mode 100644 index 000000000..d7bd1f2f6 --- /dev/null +++ b/CI/http-fixtures/fixture.txt @@ -0,0 +1 @@ +Mudlet self-test HTTP fixture. diff --git a/src/TLuaInterpreterTextToSpeech.cpp b/src/TLuaInterpreterTextToSpeech.cpp index ae30eb35f..ada892cb4 100644 --- a/src/TLuaInterpreterTextToSpeech.cpp +++ b/src/TLuaInterpreterTextToSpeech.cpp @@ -89,7 +89,18 @@ void TLuaInterpreter::ttsBuild() return; } - speechUnit = new QTextToSpeech(); + // Under automated tests always request Qt's deterministic "mock" engine and + // never fall back to a real backend, which would speak aloud and make specs + // host-dependent. When the mock plugin is absent Qt leaves the engine in the + // Error state with no voices, so the TTS specs skip (or fail where the mock + // is mandatory) instead of exercising a developer's real speech engine. This + // also makes a non-empty voice list a reliable proof that the mock was + // selected. Outside test mode the default engine is built exactly as before. + if (qEnvironmentVariableIsSet("MUDLET_TEST_MODE")) { + speechUnit = new QTextToSpeech(qsl("mock")); + } else { + speechUnit = new QTextToSpeech(); + } bSpeechBuilt = true; bSpeechQueueing = false; diff --git a/src/mudlet-lua/tests/Miscallaneous_spec.lua b/src/mudlet-lua/tests/Miscallaneous_spec.lua index 3f6d414ee..d9632c57b 100644 --- a/src/mudlet-lua/tests/Miscallaneous_spec.lua +++ b/src/mudlet-lua/tests/Miscallaneous_spec.lua @@ -93,4 +93,102 @@ describe("Tests C++ functions in the Miscallaneous category", function() assert.is_true(err:find("module doesn't exist", 1, true) ~= nil) end) end) + + describe("Tests the text-to-speech mock engine", function() + -- ttsBuild() selects Qt's deterministic mock engine under MUDLET_TEST_MODE, + -- so these specs only run in test mode and never drive a developer's real + -- speech engine. Where the mock plugin is absent they skip so local runs + -- still pass; CI sets MUDLET_TEST_REQUIRE_TTS_MOCK to turn that skip into a + -- failure, so a broken mock selection cannot hide behind a green skip. Async + -- speech events (ttsSpeechStarted...) need the waitForEvent helper and are + -- left to the post-enabler TTS specs. + local testMode = os.getenv("MUDLET_TEST_MODE") + local requireMock = os.getenv("MUDLET_TEST_REQUIRE_TTS_MOCK") + + local function ttsEngineAvailable() + return testMode and type(ttsGetVoices) == "function" and type(ttsGetVoices()) == "table" and #ttsGetVoices() > 0 + end + + -- Returns true when the caller should stop because no engine is available + -- and skipping is permitted; fails hard where the mock is mandatory. + local function ttsEngineUnavailable() + if ttsEngineAvailable() then + return false + end + if requireMock then + assert.is_true(false, "MUDLET_TEST_REQUIRE_TTS_MOCK is set but the mock TTS engine has no voices - it was not selected") + end + pending("mock TTS engine unavailable (run with MUDLET_TEST_MODE and Qt's mock plugin)") + return true + end + + it("ttsGetVoices returns a non-empty list of voice-name strings", function() + if ttsEngineUnavailable() then + return + end + local voices = ttsGetVoices() + assert.is_table(voices) + assert.is_true(#voices > 0) + for _, name in ipairs(voices) do + assert.is_string(name) + end + -- ttsGetState maps the freshly built engine's ready state to its string + assert.equals("ttsSpeechReady", ttsGetState()) + end) + + it("ttsSpeak accepts valid text and rejects whitespace-only text", function() + if ttsEngineUnavailable() then + return + end + -- valid text is accepted without leaving the engine in the error state + ttsSpeak("Mudlet self test speaking") + assert.is_true(ttsGetState() ~= "ttsSpeechError") + ttsSkip() + -- contract: whitespace-only text is rejected with nil + message + local ok, err = ttsSpeak(" ") + assert.is_nil(ok) + assert.is_string(err) + end) + end) + + describe("Tests HTTP requests against the local fixture server", function() + -- Exercises getHTTP/downloadFile against the fixture server started by the + -- "Start fixture HTTP server" workflow step, whose port is handed over in + -- MUDLET_TEST_HTTP_PORT. Skips cleanly when that is unset (a local run with + -- no fixture server) so the suite still passes. The wire response is + -- asynchronous (sysDownloadDone); asserting on it needs the waitForEvent + -- helper and is left to the post-enabler HTTP specs. + local port = os.getenv("MUDLET_TEST_HTTP_PORT") + + -- Runs everywhere (no server needed): an invalid url is rejected up front. + it("getHTTP rejects an invalid url with nil and a message", function() + local ok, err = getHTTP("") + assert.is_nil(ok) + assert.is_string(err) + end) + + it("getHTTP accepts a request to the local fixture server", function() + if not port then + pending("MUDLET_TEST_HTTP_PORT not set (fixture HTTP server not running)") + return + end + local ok, actualUrl = getHTTP("http://127.0.0.1:" .. port .. "/fixture.txt") + assert.is_true(ok) + assert.is_string(actualUrl) + assert.is_true(actualUrl:find("127.0.0.1:" .. port, 1, true) ~= nil) + end) + + it("downloadFile accepts a request to the local fixture server", function() + if not port then + pending("MUDLET_TEST_HTTP_PORT not set (fixture HTTP server not running)") + return + end + local target = getMudletHomeDir() .. "/busted-http-fixture.txt" + os.remove(target) + local ok, actualUrl = downloadFile(target, "http://127.0.0.1:" .. port .. "/fixture.txt") + assert.is_true(ok) + assert.is_string(actualUrl) + assert.is_true(actualUrl:find("127.0.0.1:" .. port, 1, true) ~= nil) + end) + end) end) From 900760309637c190d288ff212c952ebe734a0948 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Wed, 29 Jul 2026 19:36:28 +0200 Subject: [PATCH 016/155] infrastructure: add waitForEvent test helper for async Lua API tests (#9527) #### Brief overview of PR changes/additions - New test-mode-only `waitForEvent(eventName, timeoutMs)`: pumps a nested event loop so busted specs can observe timers, network and Mudlet events (inert outside MUDLET_TEST_MODE) - Event args are snapshotted into the Lua registry so tables survive the event's own cleanup - 13 specs in MudletBusted_spec.lua covering firing, arg round-trips, timeouts, filtering and nested waits #### Motivation for adding to Mudlet Busted blocks the event loop, so nothing asynchronous was testable; this is the keystone for timer/HTTP/media/MMCP test coverage. #### Other info (issues closed, discussion etc) Part of the Lua API test-coverage program (Wave 0). Sabotage-verified: 7/13 specs fail when the capture hook is disabled. **Test case:** build, then run the busted suite (all green); waitForEvent specs exercise a real tempTimer firing through the helper. Awaiting build/test by a maintainer; squash-merge with: Assisted-by: Claude:claude-opus-4-8 (Signed-off-by to be added at squash after testing) --- src/Host.cpp | 13 +++ src/Host.h | 1 + src/TLuaInterpreter.cpp | 67 +++++++++++++ src/TLuaInterpreter.h | 24 +++++ src/TLuaInterpreterMudletObjects.cpp | 89 ++++++++++++++++- src/mudlet-lua/tests/MudletBusted_spec.lua | 107 +++++++++++++++++++++ 6 files changed, 299 insertions(+), 2 deletions(-) diff --git a/src/Host.cpp b/src/Host.cpp index 3929e71c2..995153dac 100644 --- a/src/Host.cpp +++ b/src/Host.cpp @@ -850,6 +850,15 @@ bool Host::resetProfile_phase1() return false; } + // A test-mode waitForEvent() is blocked in a nested event loop on this + // profile's lua_State; phase2 would lua_close() that state underneath it (a + // use-after-free). Refuse until the wait finishes. Always empty (so a no-op) + // outside MUDLET_TEST_MODE, where waitForEvent() is inert. + if (mLuaInterpreter.hasPendingEventWaits()) { + qWarning() << "Host::resetProfile_phase1() called while a waitForEvent() is blocked, ignoring"; + return false; + } + mAliasUnit.stopAllTriggers(); mTriggerUnit.stopAllTriggers(); mTimerUnit.stopAllTriggers(); @@ -1872,6 +1881,10 @@ void Host::raiseEvent(const TEvent& pE) } } + // Let any test-mode waitForEvent() call blocked on this event capture its + // arguments and unblock. Cheap (an empty-list check) when nothing is waiting. + mLuaInterpreter.captureEventForWaits(pE); + // After the event has been raised but before 'event' goes out of scope, // we need to safely dereference the members of 'event' that point to // values in the Lua registry diff --git a/src/Host.h b/src/Host.h index d4fad976a..06e2bf0a9 100644 --- a/src/Host.h +++ b/src/Host.h @@ -243,6 +243,7 @@ public: QStringList getValidExperiments() const; void forceClose(); + bool profileResetInProgress() const { return mResetProfile; } bool isClosingDown() const { return mIsClosingDown; } bool isClosingForced() const { return mForcedClose; } bool requestClose(); diff --git a/src/TLuaInterpreter.cpp b/src/TLuaInterpreter.cpp index feab5e0c4..88010f84a 100644 --- a/src/TLuaInterpreter.cpp +++ b/src/TLuaInterpreter.cpp @@ -4711,6 +4711,72 @@ bool TLuaInterpreter::callEventHandler(const QString& function, const TEvent& pE return !error; } +// No documentation available in wiki - internal, test-only helper for waitForEvent() +// Snapshots a TEvent's arguments into a fresh Lua table {[1]=name, [2]=arg, ...} +// with a numeric length in the "n" field, and returns a registry reference to +// it. Table/function arguments are anchored by this new table (it holds a +// reference to the same object the handlers saw), so they survive +// Host::raiseEvent() freeing the event's own registry entries, letting +// waitForEvent() hand the values back after the loop unwinds. +int TLuaInterpreter::createEventArgsTableRef(const TEvent& pE) +{ + lua_State* L = pGlobalLua; + const int initialStackSize = lua_gettop(L); + const auto argCount = std::min(pE.mArgumentList.size(), pE.mArgumentTypeList.size()); + lua_newtable(L); + for (qsizetype i = 0; i < argCount; ++i) { + switch (pE.mArgumentTypeList.at(i)) { + case ARGUMENT_TYPE_NUMBER: + lua_pushnumber(L, pE.mArgumentList.at(i).toDouble()); + break; + case ARGUMENT_TYPE_STRING: + lua_pushstring(L, pE.mArgumentList.at(i).toUtf8().constData()); + break; + case ARGUMENT_TYPE_BOOLEAN: + lua_pushboolean(L, pE.mArgumentList.at(i).toInt()); + break; + case ARGUMENT_TYPE_NIL: + lua_pushnil(L); + break; + case ARGUMENT_TYPE_TABLE: + case ARGUMENT_TYPE_FUNCTION: + lua_rawgeti(L, LUA_REGISTRYINDEX, pE.mArgumentList.at(i).toInt()); + break; + default: + lua_pushnil(L); + } + lua_rawseti(L, -2, static_cast(i) + 1); + } + lua_pushinteger(L, argCount); + lua_setfield(L, -2, "n"); + const int ref = luaL_ref(L, LUA_REGISTRYINDEX); + // luaL_ref popped the table; restore the stack exactly in case this runs + // nested inside another operation's stack. + lua_settop(L, initialStackSize); + return ref; +} + +// No documentation available in wiki - internal, test-only helper for waitForEvent() +// If a waitForEvent() call is blocked waiting for this event, capture its +// arguments and quit that call's nested event loop. Called from Host::raiseEvent(). +void TLuaInterpreter::captureEventForWaits(const TEvent& pE) +{ + if (mPendingEventWaits.isEmpty() || pE.mArgumentList.isEmpty()) { + return; + } + const QString& eventName = pE.mArgumentList.at(0); + for (auto* pWait : mPendingEventWaits) { + if (pWait->mCaptured || pWait->mName != eventName) { + continue; + } + pWait->mArgsRef = createEventArgsTableRef(pE); + pWait->mCaptured = true; + if (pWait->mpLoop) { + pWait->mpLoop->quit(); + } + } +} + // No documentation available in wiki - internal function double TLuaInterpreter::condenseMapLoad() { @@ -5137,6 +5203,7 @@ void TLuaInterpreter::initLuaGlobals() lua_register(pGlobalLua, "selectCaptureGroup", TLuaInterpreter::selectCaptureGroup); lua_register(pGlobalLua, "tempLineTrigger", TLuaInterpreter::tempLineTrigger); lua_register(pGlobalLua, "raiseEvent", TLuaInterpreter::raiseEvent); + lua_register(pGlobalLua, "waitForEvent", TLuaInterpreter::waitForEvent); lua_register(pGlobalLua, "deleteLine", TLuaInterpreter::deleteLine); lua_register(pGlobalLua, "copy", TLuaInterpreter::copy); lua_register(pGlobalLua, "cut", TLuaInterpreter::cut); diff --git a/src/TLuaInterpreter.h b/src/TLuaInterpreter.h index e5376925a..e740eaddc 100644 --- a/src/TLuaInterpreter.h +++ b/src/TLuaInterpreter.h @@ -62,6 +62,7 @@ extern "C" { #include class Host; +class QEventLoop; class TAction; class TEvent; class TLuaThread; @@ -395,6 +396,7 @@ public: static int selectCaptureGroup(lua_State*); static int tempLineTrigger(lua_State*); static int raiseEvent(lua_State*); + static int waitForEvent(lua_State*); static int deleteLine(lua_State*); static int copy(lua_State*); static int cut(lua_State*); @@ -780,6 +782,15 @@ public: void freeLuaRegistryIndex(int index); void freeAllInLuaRegistry(TEvent); + // Test-only support for the waitForEvent() Lua helper (MUDLET_TEST_MODE): + // called from Host::raiseEvent() so an event that fires while a busted spec + // is blocked inside a nested event loop can be captured and unblock it. + void captureEventForWaits(const TEvent&); + // True while a waitForEvent() call is blocked in its nested event loop. Lets + // Host refuse a profile reset that would lua_close() the state out from + // under it. Always false (a no-op) outside MUDLET_TEST_MODE. + bool hasPendingEventWaits() const { return !mPendingEventWaits.isEmpty(); } + inline static const QMap csmMouseButtons = { {Qt::NoButton, qsl("NoButton")}, {Qt::LeftButton, qsl("LeftButton")}, {Qt::RightButton, qsl("RightButton")}, {Qt::MiddleButton, qsl("MidButton")}, {Qt::BackButton, qsl("BackButton")}, {Qt::ForwardButton, qsl("ForwardButton")}, {Qt::TaskButton, qsl("TaskButton")}, {Qt::ExtraButton4, qsl("ExtraButton4")}, @@ -893,6 +904,19 @@ private: QMap> mCapturedNameGroupsPosList; QVector>> mMultiCaptureNameGroups; QMap downloadMap; + + // A waitForEvent() call in progress: the nested event loop to quit when the + // named event arrives, plus a Lua registry reference to the captured args. + struct TEventWait + { + QString mName; + QEventLoop* mpLoop = nullptr; + int mArgsRef = LUA_NOREF; + bool mCaptured = false; + }; + QList mPendingEventWaits; + int createEventArgsTableRef(const TEvent&); + lua_State* pGlobalLua = nullptr; std::unique_ptr pIndenterState; QPointer mpHost; diff --git a/src/TLuaInterpreterMudletObjects.cpp b/src/TLuaInterpreterMudletObjects.cpp index c00f3427e..77a6ca766 100644 --- a/src/TLuaInterpreterMudletObjects.cpp +++ b/src/TLuaInterpreterMudletObjects.cpp @@ -60,6 +60,7 @@ #include "glwidget_integration.h" #endif +#include #include #include @@ -83,7 +84,9 @@ #include #include #include +#include #include +#include #include #include #include @@ -570,8 +573,7 @@ int TLuaInterpreter::getKeyCode(lua_State* L) } if (!pT) { - const QString errorMsg = isId ? qsl("keybind ID %1 does not exist").arg(nameOrId) - : qsl("keybind '%1' does not exist").arg(nameOrId); + const QString errorMsg = isId ? qsl("keybind ID %1 does not exist").arg(nameOrId) : qsl("keybind '%1' does not exist").arg(nameOrId); return warnArgumentValue(L, __func__, errorMsg); } @@ -1431,6 +1433,89 @@ int TLuaInterpreter::raiseEvent(lua_State* L) return 1; } +// No documentation available in wiki - internal, test-only function +// Blocks the calling Lua code inside a nested Qt event loop until the named +// event is raised (returning the event name followed by its arguments, exactly +// as an event handler would receive them) or the timeout elapses (returning +// nil and an error message). Timers, networking and other events keep being +// processed while blocked, which is what lets busted specs observe asynchronous +// behaviour without sleeps. Gated behind MUDLET_TEST_MODE so it is inert for +// normal users. +int TLuaInterpreter::waitForEvent(lua_State* L) +{ + if (!qEnvironmentVariableIsSet("MUDLET_TEST_MODE")) { + lua_pushnil(L); + lua_pushstring(L, "waitForEvent: only available in test mode (set the MUDLET_TEST_MODE environment variable)"); + return 2; + } + + const QString eventName = getVerifiedString(L, __func__, 1, "event name"); + if (eventName.isEmpty()) { + return warnArgumentValue(L, __func__, "event name cannot be empty"); + } + + // Keep well below busted's per-spec CI timeout of one minute so a runaway + // wait fails as a normal timeout rather than killing the whole suite. + constexpr int defaultTimeoutMs = 3000; + constexpr int maximumTimeoutMs = 30000; + int timeoutMs = defaultTimeoutMs; + if (!lua_isnoneornil(L, 2)) { + timeoutMs = getVerifiedInt(L, __func__, 2, "timeout in milliseconds", true); + } + timeoutMs = std::clamp(timeoutMs, 0, maximumTimeoutMs); + + Host& host = getHostFromLua(L); + TLuaInterpreter* pLuaInterpreter = host.getLuaInterpreter(); + + // A profile reset recreates this profile's lua_State (initLuaGlobals() calls + // lua_close()), and shutdown destroys the interpreter outright. Either would + // free the state L is executing on while we block, so refuse rather than risk + // a use-after-free when the nested loop unwinds. resetProfile_phase1() guards + // the mirror case where a reset is requested while we are already blocked. + if (host.profileResetInProgress() || host.isClosingDown()) { + lua_pushnil(L); + lua_pushstring(L, "waitForEvent: cannot wait while the profile is being reset or Mudlet is closing"); + return 2; + } + + QEventLoop loop; + TEventWait wait; + wait.mName = eventName; + wait.mpLoop = &loop; + pLuaInterpreter->mPendingEventWaits.append(&wait); + + QTimer timeoutTimer; + timeoutTimer.setSingleShot(true); + QObject::connect(&timeoutTimer, &QTimer::timeout, &loop, &QEventLoop::quit); + timeoutTimer.start(timeoutMs); + + loop.exec(); + + timeoutTimer.stop(); + pLuaInterpreter->mPendingEventWaits.removeAll(&wait); + + if (!wait.mCaptured) { + lua_pushnil(L); + lua_pushstring(L, qsl("waitForEvent: timed out after %1ms waiting for event '%2'").arg(QString::number(timeoutMs), eventName).toUtf8().constData()); + return 2; + } + + lua_rawgeti(L, LUA_REGISTRYINDEX, wait.mArgsRef); + lua_getfield(L, -1, "n"); + const int argCount = static_cast(lua_tointeger(L, -1)); + lua_pop(L, 1); + const int argsTableIndex = lua_gettop(L); + // A lua_CFunction is only guaranteed LUA_MINSTACK slots; an event can carry + // up to LUA_FUNCTION_MAX_ARGS arguments, so grow the stack before pushing. + luaL_checkstack(L, argCount + 1, "waitForEvent: too many event arguments to return"); + for (int i = 1; i <= argCount; ++i) { + lua_rawgeti(L, argsTableIndex, i); + } + lua_remove(L, argsTableIndex); + luaL_unref(L, LUA_REGISTRYINDEX, wait.mArgsRef); + return argCount; +} + // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#raiseGlobalEvent int TLuaInterpreter::raiseGlobalEvent(lua_State* L) { diff --git a/src/mudlet-lua/tests/MudletBusted_spec.lua b/src/mudlet-lua/tests/MudletBusted_spec.lua index 3dbb9d09b..9b3f6af4a 100644 --- a/src/mudlet-lua/tests/MudletBusted_spec.lua +++ b/src/mudlet-lua/tests/MudletBusted_spec.lua @@ -7,3 +7,110 @@ describe("Mudlet Busted sanity check", function() end) end) +describe("waitForEvent test helper", function() + -- select('#', ...) counts embedded and trailing nils that a plain table + -- constructor would lose, so it lets a spec verify the argument count too. + local function grab(...) + return select('#', ...), ... + end + + it("observes a tempTimer firing through a raised event", function() + tempTimer(0.05, function() raiseEvent("mudletTestTimerFired", 42) end) + local name, value = waitForEvent("mudletTestTimerFired", 2000) + assert.equals("mudletTestTimerFired", name) + assert.equals(42, value) + end) + + it("round-trips raiseEvent arguments of several types", function() + tempTimer(0, function() raiseEvent("mudletTestRoundTrip", "hello", 7, true) end) + local name, str, num, boolean = waitForEvent("mudletTestRoundTrip", 2000) + assert.equals("mudletTestRoundTrip", name) + assert.equals("hello", str) + assert.equals(7, num) + assert.is_true(boolean) + end) + + it("preserves nil and false arguments in their positions", function() + tempTimer(0, function() raiseEvent("mudletTestNilArg", nil, false, "after") end) + local count, name, first, second, third = grab(waitForEvent("mudletTestNilArg", 2000)) + assert.equals(4, count) + assert.equals("mudletTestNilArg", name) + assert.is_nil(first) + assert.is_false(second) + assert.equals("after", third) + end) + + it("round-trips a table argument that outlives the event", function() + tempTimer(0, function() raiseEvent("mudletTestTableArg", {a = 1, b = "two"}) end) + local name, payload = waitForEvent("mudletTestTableArg", 2000) + assert.equals("mudletTestTableArg", name) + assert.is_table(payload) + assert.equals(1, payload.a) + assert.equals("two", payload.b) + end) + + it("returns just the event name when there is no payload", function() + tempTimer(0, function() raiseEvent("mudletTestNameOnly") end) + local count, name = grab(waitForEvent("mudletTestNameOnly", 2000)) + assert.equals(1, count) + assert.equals("mudletTestNameOnly", name) + end) + + it("uses a default timeout when none is supplied", function() + tempTimer(0, function() raiseEvent("mudletTestDefaultTimeout", "ok") end) + local name, value = waitForEvent("mudletTestDefaultTimeout") + assert.equals("mudletTestDefaultTimeout", name) + assert.equals("ok", value) + end) + + it("returns nil and a message naming the event when it never arrives", function() + local result, message = waitForEvent("mudletTestNeverRaised", 100) + assert.is_nil(result) + assert.is_string(message) + assert.truthy(message:find("timed out")) + assert.truthy(message:find("mudletTestNeverRaised")) + end) + + it("does not wake for a different event", function() + tempTimer(0, function() raiseEvent("mudletTestOtherEvent") end) + local result = waitForEvent("mudletTestWantedEvent", 200) + assert.is_nil(result) + end) + + it("does not observe an event raised before the wait began", function() + raiseEvent("mudletTestPreRaised") + local result = waitForEvent("mudletTestPreRaised", 100) + assert.is_nil(result) + end) + + it("clamps a negative timeout to zero", function() + local result, message = waitForEvent("mudletTestNeverRaised", -50) + assert.is_nil(result) + assert.truthy(message:find("0ms")) + end) + + it("returns nil and a message for an empty event name", function() + local result, message = waitForEvent("") + assert.is_nil(result) + assert.is_string(message) + assert.truthy(message:find("empty")) + end) + + it("errors when called without an event name", function() + assert.has_error(function() waitForEvent() end) + end) + + it("supports a nested waitForEvent while one is already blocked", function() + local innerName + tempTimer(0, function() + -- Raise the shared event only once both waits are blocked, so both + -- the outer wait and this inner one should observe it. + tempTimer(0.05, function() raiseEvent("mudletTestNested", "payload") end) + innerName = waitForEvent("mudletTestNested", 2000) + end) + local outerName, outerValue = waitForEvent("mudletTestNested", 2000) + assert.equals("mudletTestNested", outerName) + assert.equals("payload", outerValue) + assert.equals("mudletTestNested", innerName) + end) + end) From 02692b0ed2a04e9d598648b7f4848ca4e7d1365f Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Wed, 29 Jul 2026 19:38:22 +0200 Subject: [PATCH 017/155] infrastructure: database and datetime Lua API tests (#9531) #### Brief overview of PR changes/additions - 61 new specs: every db query-expression builder asserted through real sqlite fetches, db:delete/merge_unique/transactions, datetime:parse format matrix - Found 6 real bugs during writing (filed separately; buggy behavior deliberately NOT pinned) #### Motivation for adding to Mudlet The db expression builders and datetime parsing had zero coverage despite running real sqlite in-process. #### Other info (issues closed, discussion etc) Part of the Lua API test-coverage program (Wave 1). Related bug reports: datetime noon/midnight/pm-case/day-as-string, db:exp in set-position, db._drop dead code. **Test case:** run the busted suite - DB_spec and DateTime_spec pass green, twice. Assisted-by: Claude:claude-opus-4-8 --- src/mudlet-lua/lua/DB.lua | 54 ++- src/mudlet-lua/lua/DateTime.lua | 11 +- src/mudlet-lua/tests/DB_spec.lua | 576 +++++++++++++++++++++++++ src/mudlet-lua/tests/DateTime_spec.lua | 143 ++++++ 4 files changed, 762 insertions(+), 22 deletions(-) diff --git a/src/mudlet-lua/lua/DB.lua b/src/mudlet-lua/lua/DB.lua index 6cb910a81..afd038a2e 100644 --- a/src/mudlet-lua/lua/DB.lua +++ b/src/mudlet-lua/lua/DB.lua @@ -1146,10 +1146,10 @@ function db:fetch(sheet, query, order_by, descending) local sql = "SELECT * FROM " .. s_name if query then - if type(query) == "table" then + if type(query) == "table" and not query._isExp then sql = sql .. " WHERE " .. db:AND(unpack(query)) else - sql = sql .. " WHERE " .. query + sql = sql .. " WHERE " .. tostring(query) end end @@ -1202,10 +1202,10 @@ function db:aggregate(field, fn, query, distinct) if query then sql_chunks[#sql_chunks + 1] = "WHERE" - if type(query) == "table" then + if type(query) == "table" and not query._isExp then sql_chunks[#sql_chunks + 1] = db:AND(unpack(query)) else - sql_chunks[#sql_chunks + 1] = query + sql_chunks[#sql_chunks + 1] = tostring(query) end end @@ -1275,7 +1275,7 @@ function db:delete(sheet, query) assert(query, "must pass a query argument to db:delete()") if type(query) == "number" then query = "_row_id = " .. tostring(query) - elseif type(query) == "table" then + elseif type(query) == "table" and not query._isExp then assert(query._row_id, "Passed a non-result table to db:delete, need a _row_id field to continue.") query = "_row_id = " .. tostring(query._row_id) end @@ -1283,7 +1283,7 @@ function db:delete(sheet, query) local sql = "DELETE FROM " .. s_name if query ~= true then - sql = sql .. " WHERE " .. query + sql = sql .. " WHERE " .. tostring(query) end db:echo_sql(sql) @@ -1499,7 +1499,7 @@ function db:set(field, value, query) s_name, field.name, db:_coerce(field, value), - query + tostring(query) ) db:echo_sql(sql) @@ -1563,7 +1563,9 @@ end -- type of the specified field. Strings will be single-quoted (and single-quotes -- within will be properly escaped), numbers will be rendered properly, and such. function db:_coerce(field, value) - if type(value) == "table" and value._isNull then + if type(value) == "table" and value._isExp then + return value._expression + elseif type(value) == "table" and value._isNull then return "NULL" elseif field.type == "number" then return tonumber(value) or ("'" .. value .. "'") @@ -1775,6 +1777,20 @@ end +-- NOT LUADOC +-- The metatable for db:exp values. It renders as the raw expression text whenever +-- concatenated or stringified, so WHERE-position use (db:fetch, db:AND, db:OR, ...) +-- is unchanged, while db:_coerce recognises the _isExp marker and passes the raw +-- expression through (letting db:exp be used as a db:set value, not just in WHERE). +db.__Expression = { + __tostring = function(self) + return self._expression + end, + __concat = function(a, b) + return tostring(a) .. tostring(b) + end, +} + --- Returns the string as-is to the database.

--- --- Use this function with caution, but it is very useful in some circumstances. One of the most @@ -1797,7 +1813,7 @@ end --- --- @see db:fetch function db:exp(text) - return text + return setmetatable({ _expression = text, _isExp = true }, db.__Expression) end @@ -1827,6 +1843,10 @@ end --- --- @see db:fetch function db:OR(left, right) + -- coerce to strings so db:exp sentinels work here as well as plain expressions + left = tostring(left) + right = tostring(right) + if not string.starts(left, "(") then left = "(" .. left .. ")" end @@ -2067,16 +2087,16 @@ end function db.Database:_drop(s_name) local conn = db.__conn[self._db_name] - local schema = db.__schema[self._db_name] + local schema = db.__schema[self._db_name][s_name] - if schema.options._index then - for _, value in schema.options._index do - conn:execute("DROP INDEX IF EXISTS " .. db:_index_name(s_name, value)) + -- _index and _unique can each be a single column name (a string) or a list of + -- them, so normalise to a list before iterating to drop the matching indexes. + local index_groups = { schema.options._index, schema.options._unique } + for _, group in pairs(index_groups) do + if type(group) == "string" then + group = { group } end - end - - if schema.options._unique then - for _, value in schema.options._unique do + for _, value in pairs(group) do conn:execute("DROP INDEX IF EXISTS " .. db:_index_name(s_name, value)) end end diff --git a/src/mudlet-lua/lua/DateTime.lua b/src/mudlet-lua/lua/DateTime.lua index 49933f3f8..a16c8710e 100644 --- a/src/mudlet-lua/lua/DateTime.lua +++ b/src/mudlet-lua/lua/DateTime.lua @@ -125,14 +125,15 @@ function datetime:parse(source, format, as_epoch) dt.month = datetime._abbrev_month_names[m.abbrev_month_name:lower()] end - dt.day = m.day_of_month + dt.day = tonumber(m.day_of_month) if m.hour_12 then assert(m.ampm, "You must use %p (AM|PM) with %I (12-hour time)") - if m.ampm == "PM" then - dt.hour = 12 + tonumber(m.hour_12) - else - dt.hour = tonumber(m.hour_12) + -- 12-hour to 24-hour: 12 AM is 0, 12 PM is 12, so the 12 wraps to 0 before + -- the PM offset is added. The regex is caseless, so compare caselessly too. + dt.hour = tonumber(m.hour_12) % 12 + if m.ampm:upper() == "PM" then + dt.hour = dt.hour + 12 end else dt.hour = tonumber(m.hour_24) diff --git a/src/mudlet-lua/tests/DB_spec.lua b/src/mudlet-lua/tests/DB_spec.lua index f5e7047e0..7238ff602 100644 --- a/src/mudlet-lua/tests/DB_spec.lua +++ b/src/mudlet-lua/tests/DB_spec.lua @@ -640,6 +640,18 @@ describe("Tests DB.lua functions", function() assert.is.same(exp_total, total) end) + it("should apply a db:exp query when aggregating.", + function() + local total = db:aggregate(mydb.sheet.count, "total", db:exp("count > 5")) + local exp_total = 0 + for _, v in ipairs(test_data) do + if v.count > 5 then + exp_total = exp_total + v.count + end + end + assert.is.same(exp_total, total) + end) + it("should successfully calculate the average of all numbers.", function() local avg = db:aggregate(mydb.sheet.count, "avg") @@ -1565,4 +1577,568 @@ describe("Tests DB.lua functions", function() end) end) + describe("Tests db query-expression builders against real fetches", function() + local function names(results) + local t = {} + for _, row in ipairs(results) do + t[#t + 1] = row.name + end + table.sort(t) + return t + end + + before_each(function() + mydb = db:create("exprtestingonly", { + people = { + name = "", + city = "", + level = 0, + _index = { "city" }, + } + }) + db:add(mydb.people, + {name = "Ada", city = "Boston", level = 10}, + {name = "Bram", city = "Chicago", level = 20}, + {name = "Cyra", city = "Boston", level = 30}, + {name = "Drake", city = "Denver", level = 40}, + {name = "Eve", city = "Chicago", level = 50}) + end) + + after_each(function() + db:close() + os.remove(getMudletHomeDir() .. "/Database_exprtestingonly.db") + mydb = nil + end) + + it("db:lt returns rows with a field below the value", function() + assert.are.same({"Ada", "Bram"}, names(db:fetch(mydb.people, db:lt(mydb.people.level, 30)))) + end) + + it("db:lte is inclusive of the boundary", function() + assert.are.same({"Ada", "Bram", "Cyra"}, names(db:fetch(mydb.people, db:lte(mydb.people.level, 30)))) + end) + + it("db:gt returns rows with a field above the value", function() + assert.are.same({"Drake", "Eve"}, names(db:fetch(mydb.people, db:gt(mydb.people.level, 30)))) + end) + + it("db:gte is inclusive of the boundary", function() + assert.are.same({"Cyra", "Drake", "Eve"}, names(db:fetch(mydb.people, db:gte(mydb.people.level, 30)))) + end) + + it("db:eq matches an exact value", function() + assert.are.same({"Ada", "Cyra"}, names(db:fetch(mydb.people, db:eq(mydb.people.city, "Boston")))) + end) + + it("db:eq with case_insensitive matches regardless of case", function() + assert.are.same({"Ada", "Cyra"}, names(db:fetch(mydb.people, db:eq(mydb.people.city, "BOSTON", true)))) + end) + + it("db:not_eq excludes an exact value", function() + assert.are.same({"Bram", "Drake", "Eve"}, names(db:fetch(mydb.people, db:not_eq(mydb.people.city, "Boston")))) + end) + + it("db:not_eq with case_insensitive excludes regardless of case", function() + assert.are.same({"Bram", "Drake", "Eve"}, names(db:fetch(mydb.people, db:not_eq(mydb.people.city, "BOSTON", true)))) + end) + + it("db:like matches SQL LIKE wildcards", function() + assert.are.same({"Ada", "Cyra"}, names(db:fetch(mydb.people, db:like(mydb.people.city, "Bo%")))) + end) + + it("db:not_like excludes SQL LIKE matches", function() + assert.are.same({"Bram", "Drake", "Eve"}, names(db:fetch(mydb.people, db:not_like(mydb.people.city, "Bo%")))) + end) + + it("db:between is inclusive of both bounds", function() + assert.are.same({"Bram", "Cyra", "Drake"}, names(db:fetch(mydb.people, db:between(mydb.people.level, 20, 40)))) + end) + + it("db:not_between excludes the inclusive range", function() + assert.are.same({"Ada", "Eve"}, names(db:fetch(mydb.people, db:not_between(mydb.people.level, 20, 40)))) + end) + + it("db:in_ matches any value in the list", function() + assert.are.same({"Ada", "Cyra", "Drake"}, names(db:fetch(mydb.people, db:in_(mydb.people.city, {"Boston", "Denver"})))) + end) + + it("db:not_in excludes every value in the list", function() + assert.are.same({"Bram", "Eve"}, names(db:fetch(mydb.people, db:not_in(mydb.people.city, {"Boston", "Denver"})))) + end) + + it("db:exp injects a raw SQL WHERE expression", function() + assert.are.same({"Cyra", "Drake", "Eve"}, names(db:fetch(mydb.people, db:exp("level > 25")))) + end) + + it("db:exp still works inside an implicitly-ANDed table query", function() + local results = db:fetch(mydb.people, { + db:exp("level > 25"), + db:eq(mydb.people.city, "Chicago"), + }) + assert.are.same({"Eve"}, names(results)) + end) + + it("db:exp still combines with db:AND and db:OR", function() + local anded = db:fetch(mydb.people, db:AND(db:exp("level > 25"), db:eq(mydb.people.city, "Chicago"))) + assert.are.same({"Eve"}, names(anded)) + local ored = db:fetch(mydb.people, db:OR(db:exp("level < 15"), db:exp("level > 45"))) + assert.are.same({"Ada", "Eve"}, names(ored)) + end) + + it("db:AND requires all sub-expressions to match", function() + local query = db:AND(db:eq(mydb.people.city, "Boston"), db:gt(mydb.people.level, 15)) + assert.are.same({"Cyra"}, names(db:fetch(mydb.people, query))) + end) + + it("db:OR matches either sub-expression", function() + local query = db:OR(db:eq(mydb.people.city, "Denver"), db:eq(mydb.people.city, "Chicago")) + assert.are.same({"Bram", "Drake", "Eve"}, names(db:fetch(mydb.people, query))) + end) + + it("a table-array query is implicitly ANDed", function() + local results = db:fetch(mydb.people, { + db:eq(mydb.people.city, "Chicago"), + db:gt(mydb.people.level, 30), + }) + assert.are.same({"Eve"}, names(results)) + end) + + it("db:is_nil and db:is_not_nil partition rows by NULL", function() + db:set(mydb.people.city, db:Null(), db:eq(mydb.people.name, "Ada")) + assert.are.same({"Ada"}, names(db:fetch(mydb.people, db:is_nil(mydb.people.city)))) + assert.are.same({"Bram", "Cyra", "Drake", "Eve"}, names(db:fetch(mydb.people, db:is_not_nil(mydb.people.city)))) + end) + end) + + describe("Tests db:delete", function() + before_each(function() + mydb = db:create("deletetestingonly", { + sheet = { + name = "", + city = "", + _index = { "name" }, + } + }) + db:add(mydb.sheet, + {name = "Ada", city = "Boston"}, + {name = "Bram", city = "Chicago"}, + {name = "Cyra", city = "Boston"}, + {name = "Drake", city = "Denver"}) + end) + + after_each(function() + db:close() + os.remove(getMudletHomeDir() .. "/Database_deletetestingonly.db") + mydb = nil + end) + + it("deletes a single row by _row_id number", function() + local ada = db:fetch(mydb.sheet, db:eq(mydb.sheet.name, "Ada"))[1] + db:delete(mydb.sheet, ada._row_id) + assert.are.equal(0, #db:fetch(mydb.sheet, db:eq(mydb.sheet.name, "Ada"))) + assert.are.equal(3, #db:fetch(mydb.sheet)) + end) + + it("deletes a single row given a fetched result table", function() + local bram = db:fetch(mydb.sheet, db:eq(mydb.sheet.name, "Bram"))[1] + db:delete(mydb.sheet, bram) + assert.are.equal(0, #db:fetch(mydb.sheet, db:eq(mydb.sheet.name, "Bram"))) + assert.are.equal(3, #db:fetch(mydb.sheet)) + end) + + it("deletes every row matching an expression", function() + db:delete(mydb.sheet, db:eq(mydb.sheet.city, "Boston")) + local remaining = db:fetch(mydb.sheet) + assert.are.equal(2, #remaining) + local cities = {} + for _, row in ipairs(remaining) do + cities[row.city] = true + end + assert.is_nil(cities["Boston"]) + end) + + it("deletes every row matching a db:exp expression", function() + db:delete(mydb.sheet, db:exp("city = 'Boston'")) + local remaining = db:fetch(mydb.sheet) + assert.are.equal(2, #remaining) + local cities = {} + for _, row in ipairs(remaining) do + cities[row.city] = true + end + assert.is_nil(cities["Boston"]) + end) + + it("truncates the whole sheet when the query is true", function() + db:delete(mydb.sheet, true) + assert.are.equal(0, #db:fetch(mydb.sheet)) + end) + + it("errors when no query argument is passed", function() + local ok, err = pcall(function() db:delete(mydb.sheet) end) + assert.is_false(ok) + assert.is_true(string.find(err, "must pass a query argument", 1, true) ~= nil) + end) + + it("errors when passed a table without a _row_id", function() + local ok, err = pcall(function() db:delete(mydb.sheet, {name = "Ada"}) end) + assert.is_false(ok) + assert.is_true(string.find(err, "non-result table", 1, true) ~= nil) + end) + end) + + describe("Tests db:merge_unique", function() + before_each(function() + mydb = db:create("mergetestingonly", { + friends = { + name = "", + city = "", + level = 0, + _unique = { "name" }, + _violations = "REPLACE", + } + }) + db:add(mydb.friends, + {name = "Ada", city = "Boston", level = 10}, + {name = "Bram", city = "Chicago", level = 20}) + end) + + after_each(function() + db:close() + os.remove(getMudletHomeDir() .. "/Database_mergetestingonly.db") + mydb = nil + end) + + it("updates existing rows and inserts new ones in one call", function() + local rows = db:fetch(mydb.friends) + assert.are.equal(2, #rows) + for _, row in ipairs(rows) do + row.city = "Mutantville" + end + rows[#rows + 1] = {name = "Cyra", city = "Denver", level = 5} + db:merge_unique(mydb.friends, rows) + + local after = db:fetch(mydb.friends) + assert.are.equal(3, #after) + local byName = {} + for _, row in ipairs(after) do + byName[row.name] = row + end + assert.are.equal("Mutantville", byName.Ada.city) + assert.are.equal("Mutantville", byName.Bram.city) + assert.are.equal(10, byName.Ada.level) + assert.are.equal("Denver", byName.Cyra.city) + assert.are.equal(5, byName.Cyra.level) + end) + + it("does not duplicate a row when merging an existing unique key", function() + db:merge_unique(mydb.friends, { {name = "Ada", city = "Rome"} }) + local rows = db:fetch(mydb.friends, db:eq(mydb.friends.name, "Ada")) + assert.are.equal(1, #rows) + assert.are.equal("Rome", rows[1].city) + assert.are.equal(10, rows[1].level) + end) + + it("errors when the data argument is not a table", function() + local ok, err = pcall(function() db:merge_unique(mydb.friends, nil) end) + assert.is_false(ok) + assert.is_true(string.find(err, "required table of data", 1, true) ~= nil) + end) + + it("errors when a merged row is missing the unique key", function() + local ok, err = pcall(function() + db:merge_unique(mydb.friends, { {city = "Nowhere"} }) + end) + assert.is_false(ok) + assert.is_true(string.find(err, "does not have the unique key", 1, true) ~= nil) + end) + + it("errors on a sheet whose unique index spans multiple columns", function() + db:close() + os.remove(getMudletHomeDir() .. "/Database_mergetestingonly.db") + mydb = db:create("mergetestingonly", { + friends = { + name = "", + city = "", + _unique = { {"name", "city"} }, + } + }) + db:add(mydb.friends, {name = "Ada", city = "Boston"}) + local ok, err = pcall(function() + db:merge_unique(mydb.friends, { {name = "Ada", city = "Boston"} }) + end) + assert.is_false(ok) + assert.is_true(string.find(err, "single unique index with a single column", 1, true) ~= nil) + end) + end) + + describe("Tests db transaction rollback", function() + before_each(function() + mydb = db:create("rollbacktestingonly", { + sheet = { + name = "", + _index = { "name" }, + } + }) + db:add(mydb.sheet, {name = "committed"}) + end) + + after_each(function() + db:close() + os.remove(getMudletHomeDir() .. "/Database_rollbacktestingonly.db") + mydb = nil + end) + + it("discards uncommitted rows when rolled back", function() + assert.are.equal(1, #db:fetch(mydb.sheet)) + mydb:_begin() + db:add(mydb.sheet, {name = "pending1"}) + db:add(mydb.sheet, {name = "pending2"}) + assert.are.equal(3, #db:fetch(mydb.sheet)) + mydb:_rollback() + mydb:_end() + local after = db:fetch(mydb.sheet) + assert.are.equal(1, #after) + assert.are.equal("committed", after[1].name) + end) + + it("persists committed rows across a close and reopen", function() + mydb:_begin() + db:add(mydb.sheet, {name = "pending"}) + mydb:_commit() + mydb:_end() + -- reopen so the assertion sees the on-disk state, not this connection's + -- own uncommitted view - this is what discriminates commit from a no-op + db:close() + mydb = db:create("rollbacktestingonly", { + sheet = { + name = "", + _index = { "name" }, + } + }) + assert.are.equal(2, #db:fetch(mydb.sheet)) + end) + end) + + describe("Tests db:update and db:set edge cases", function() + before_each(function() + mydb = db:create("updatetestingonly", { + sheet = { + name = "", + city = "", + kills = 0, + _unique = { "name" }, + _violations = "REPLACE", + } + }) + db:add(mydb.sheet, + {name = "Ada", city = "Boston", kills = 3}, + {name = "Bram", city = "Chicago", kills = 7}) + end) + + after_each(function() + db:close() + os.remove(getMudletHomeDir() .. "/Database_updatetestingonly.db") + mydb = nil + end) + + it("updates the changed field and preserves the rest", function() + local ada = db:fetch(mydb.sheet, db:eq(mydb.sheet.name, "Ada"))[1] + ada.city = "Rome" + db:update(mydb.sheet, ada) + local reread = db:fetch(mydb.sheet, db:eq(mydb.sheet.name, "Ada"))[1] + assert.are.equal("Rome", reread.city) + assert.are.equal("Ada", reread.name) + assert.are.equal(3, reread.kills) + end) + + it("errors when updating a table without a _row_id", function() + local ok, err = pcall(function() + db:update(mydb.sheet, {name = "Ada", city = "Rome"}) + end) + assert.is_false(ok) + assert.is_true(string.find(err, "_row_id", 1, true) ~= nil) + end) + + it("db:set changes a field for rows matching the query", function() + db:set(mydb.sheet.city, "Rome", db:eq(mydb.sheet.name, "Ada")) + assert.are.equal("Rome", db:fetch(mydb.sheet, db:eq(mydb.sheet.name, "Ada"))[1].city) + assert.are.equal("Chicago", db:fetch(mydb.sheet, db:eq(mydb.sheet.name, "Bram"))[1].city) + end) + + it("db:set without a query updates every row", function() + db:set(mydb.sheet.kills, 0) + local rows = db:fetch(mydb.sheet) + assert.are.equal(2, #rows) + for _, row in ipairs(rows) do + assert.are.equal(0, row.kills) + end + end) + + it("db:set evaluates a db:exp value instead of storing it literally", function() + db:set(mydb.sheet.kills, db:exp("kills + 1"), db:eq(mydb.sheet.name, "Ada")) + assert.are.equal(4, db:fetch(mydb.sheet, db:eq(mydb.sheet.name, "Ada"))[1].kills) + assert.are.equal(7, db:fetch(mydb.sheet, db:eq(mydb.sheet.name, "Bram"))[1].kills) + end) + + it("db:set accepts a db:exp as the WHERE query", function() + db:set(mydb.sheet.city, "Rome", db:exp("kills > 5")) + assert.are.equal("Boston", db:fetch(mydb.sheet, db:eq(mydb.sheet.name, "Ada"))[1].city) + assert.are.equal("Rome", db:fetch(mydb.sheet, db:eq(mydb.sheet.name, "Bram"))[1].city) + end) + end) + + describe("Tests db.Database:_drop", function() + before_each(function() + mydb = db:create("droptestingonly", { + people = { + name = "", + city = "", + _index = { "city" }, + _unique = { "name" }, + } + }) + db:add(mydb.people, + {name = "Ada", city = "Boston"}, + {name = "Bram", city = "Chicago"}) + end) + + after_each(function() + pcall(function() db:close() end) + os.remove(getMudletHomeDir() .. "/Database_droptestingonly.db") + mydb = nil + end) + + it("drops the sheet's table and indexes without erroring", function() + local ok, err = pcall(function() mydb:_drop("people") end) + assert.is_true(ok, err) + + -- the table (and hence its rows and indexes) is really gone from the database + local conn = db.__conn[mydb._db_name] + local cur = conn:execute("SELECT name FROM sqlite_master WHERE type = 'table' AND name = 'people'") + local exists = cur and cur ~= 0 and cur:fetch({}, "a") ~= nil + if cur and cur ~= 0 then + cur:close() + end + assert.is_false(exists) + end) + + it("drops a sheet whose _unique index is declared as a string", function() + local sdb = db:create("dropstrtestingonly", { + pets = { + name = "", + _unique = "name", + } + }) + local ok, err = pcall(function() sdb:_drop("pets") end) + db:close("dropstrtestingonly") + os.remove(getMudletHomeDir() .. "/Database_dropstrtestingonly.db") + assert.is_true(ok, err) + end) + end) + + describe("Tests db:close contracts and reopen", function() + after_each(function() + pcall(function() db:close("closetestingonly") end) + os.remove(getMudletHomeDir() .. "/Database_closetestingonly.db") + mydb = nil + end) + + it("closes a named database and reports success", function() + db:create("closetestingonly", { sheet = { name = "" } }) + local ok, msg = db:close("closetestingonly") + assert.is_true(ok) + assert.are.equal("", msg) + end) + + it("returns false when closing a database that does not exist", function() + db:create("closetestingonly", { sheet = { name = "" } }) + local ok, msg = db:close("nonexistentdbxyz") + assert.is_false(ok) + assert.is_true(string.find(msg, "does not exist", 1, true) ~= nil) + db:close("closetestingonly") + end) + + it("returns false when called before any database environment exists", function() + local saved_env = db.__env + db.__env = nil + local ok, msg = db:close("whatever") + db.__env = saved_env + assert.is_false(ok) + assert.is_true(string.find(msg, "environment is nil", 1, true) ~= nil) + end) + + it("errors when db_name is neither a string nor nil", function() + db:create("closetestingonly", { sheet = { name = "" } }) + local ok, err = pcall(function() db:close(12345) end) + assert.is_false(ok) + assert.is_true(string.find(err, "expected db_name to be string or nil", 1, true) ~= nil) + db:close("closetestingonly") + end) + + it("persists data across close and reopen", function() + local d = db:create("closetestingonly", { + sheet = { name = "", city = "", _index = {"name"} } + }) + db:add(d.sheet, {name = "Ada", city = "Boston"}) + db:close("closetestingonly") + + local d2 = db:create("closetestingonly", { + sheet = { name = "", city = "", _index = {"name"} } + }) + local rows = db:fetch(d2.sheet) + assert.are.equal(1, #rows) + assert.are.equal("Ada", rows[1].name) + assert.are.equal("Boston", rows[1].city) + db:close("closetestingonly") + end) + end) + + describe("Tests db:create schema validation", function() + after_each(function() + pcall(function() db:close("badschematestingonly") end) + os.remove(getMudletHomeDir() .. "/Database_badschematestingonly.db") + mydb = nil + end) + + it("errors on an unrecognised _violations option", function() + local ok, err = pcall(function() + db:create("badschematestingonly", { + sheet = { name = "", _unique = { "name" }, _violations = "NONSENSE" } + }) + end) + assert.is_false(ok) + assert.is_true(string.find(err, "_validations must be one of", 1, true) ~= nil) + end) + + it("errors on a non-string _violations option", function() + local ok, err = pcall(function() + db:create("badschematestingonly", { + sheet = { name = "", _unique = { "name" }, _violations = 42 } + }) + end) + assert.is_false(ok) + assert.is_true(string.find(err, "_validations must be a string", 1, true) ~= nil) + end) + + it("errors on a malformed _unique constraint", function() + local ok, err = pcall(function() + db:create("badschematestingonly", { + sheet = { name = "", _unique = { 123 } } + }) + end) + assert.is_false(ok) + assert.is_true(string.find(err, "must be a string or table", 1, true) ~= nil) + end) + + it("errors when _unique is neither a string nor a table", function() + local ok, err = pcall(function() + db:create("badschematestingonly", { + sheet = { name = "", _unique = 42 } + }) + end) + assert.is_false(ok) + assert.is_true(string.find(err, "_unique must be a string or a table", 1, true) ~= nil) + end) + end) + end) diff --git a/src/mudlet-lua/tests/DateTime_spec.lua b/src/mudlet-lua/tests/DateTime_spec.lua index ac4d574a4..092f84c7a 100644 --- a/src/mudlet-lua/tests/DateTime_spec.lua +++ b/src/mudlet-lua/tests/DateTime_spec.lua @@ -25,4 +25,147 @@ describe("Tests DateTime.lua functions", function() end) end) + describe("Tests datetime:parse", function() + it("parses the default ISO format into a date table", function() + local dt = datetime:parse("2025-06-15 19:34:42") + assert.are.equal(2025, dt.year) + assert.are.equal(6, dt.month) + assert.are.equal(15, dt.day) + assert.are.equal("number", type(dt.day)) + assert.are.equal(19, dt.hour) + assert.are.equal(34, dt.min) + assert.are.equal(42, dt.sec) + end) + + it("parses a full month name with %B", function() + local dt = datetime:parse("June 15, 2025", "^%B %d, %Y$") + assert.are.equal(2025, dt.year) + assert.are.equal(6, dt.month) + assert.are.equal(15, dt.day) + end) + + it("parses an abbreviated month name with %b", function() + local dt = datetime:parse("Jun 15 2025", "^%b %d %Y$") + assert.are.equal(6, dt.month) + assert.are.equal(15, dt.day) + end) + + it("parses month names case-insensitively", function() + local dt = datetime:parse("JUNE 15, 2025", "^%B %d, %Y$") + assert.are.equal(6, dt.month) + end) + + it("expands a 2-digit year with %y into the 2000s", function() + local dt = datetime:parse("25-06-15", "^%y-%m-%d$") + assert.are.equal(2025, dt.year) + assert.are.equal(6, dt.month) + end) + + it("converts 12-hour PM times to 24-hour", function() + local dt = datetime:parse("2025-06-15 01:30:00 PM", "^%Y-%m-%d %I:%M:%S %p$") + assert.are.equal(13, dt.hour) + assert.are.equal(30, dt.min) + end) + + it("keeps 12-hour AM times in the morning", function() + local dt = datetime:parse("2025-06-15 07:30:00 AM", "^%Y-%m-%d %I:%M:%S %p$") + assert.are.equal(7, dt.hour) + end) + + it("treats 12 PM as noon, hour 12, not hour 24", function() + local dt = datetime:parse("2020-01-01 12:30 PM", "^%Y-%m-%d %I:%M %p$") + assert.are.equal(12, dt.hour) + assert.are.equal(30, dt.min) + end) + + it("treats 12 AM as midnight, hour 0", function() + local dt = datetime:parse("2020-01-01 12:30 AM", "^%Y-%m-%d %I:%M %p$") + assert.are.equal(0, dt.hour) + assert.are.equal(30, dt.min) + end) + + it("treats a lowercase pm the same as an uppercase PM", function() + local dt = datetime:parse("2020-01-01 01:00 pm", "^%Y-%m-%d %I:%M %p$") + assert.are.equal(13, dt.hour) + end) + + it("treats a lowercase am the same as an uppercase AM", function() + local dt = datetime:parse("2020-01-01 12:00 am", "^%Y-%m-%d %I:%M %p$") + assert.are.equal(0, dt.hour) + end) + + it("errors when %I is used without %p", function() + local ok, err = pcall(function() + datetime:parse("2025-06-15 07:30:00", "^%Y-%m-%d %I:%M:%S$") + end) + assert.is_false(ok) + assert.is_true(string.find(err, "12-hour", 1, true) ~= nil) + end) + + it("returns nil when the source does not match the format", function() + assert.is_nil(datetime:parse("not a date")) + assert.is_nil(datetime:parse("2025-06-15", "^%Y-%m-%d %H:%M:%S$")) + end) + + it("returns a Unix epoch when as_epoch is true", function() + local epoch = datetime:parse("2025-06-15 12:30:45", nil, true) + assert.are.equal("number", type(epoch)) + local back = os.date("*t", epoch) + assert.are.equal(2025, back.year) + assert.are.equal(6, back.month) + assert.are.equal(15, back.day) + assert.are.equal(12, back.hour) + assert.are.equal(30, back.min) + assert.are.equal(45, back.sec) + end) + end) + + describe("Tests datetime:parse round-trips with string formatting", function() + it("round-trips an ISO timestamp through os.date", function() + local s = "2025-06-15 12:30:45" + local epoch = datetime:parse(s, nil, true) + assert.are.equal(s, os.date("%Y-%m-%d %H:%M:%S", epoch)) + end) + + it("round-trips a custom slash/colon format through os.date", function() + local s = "06/15/2025 08:05" + local epoch = datetime:parse(s, "^%m/%d/%Y %H:%M$", true) + assert.are.equal(s, os.date("%m/%d/%Y %H:%M", epoch)) + end) + end) + + describe("Tests datetime:calculate_UTCdiff", function() + it("returns a numeric offset within the valid timezone range", function() + local diff = datetime:calculate_UTCdiff(1718452245) + assert.are.equal("number", type(diff)) + assert.is_true(diff >= -14 * 3600 and diff <= 14 * 3600) + -- every real timezone offset is a whole number of 15-minute steps + assert.are.equal(0, diff % 900) + end) + + it("is deterministic for the same instant", function() + local t = 1718452245 + assert.are.equal(datetime:calculate_UTCdiff(t), datetime:calculate_UTCdiff(t)) + end) + end) + + describe("Tests datetime:_get_pattern", function() + it("caches and returns the same compiled pattern for a format", function() + local fmt = "^%Y-%m-%d$" + datetime._pattern_cache[fmt] = nil + local p1 = datetime:_get_pattern(fmt) + local p2 = datetime:_get_pattern(fmt) + assert.is_not_nil(datetime._pattern_cache[fmt]) + assert.are.equal(p1, p2) + end) + + it("compiles directives into a pattern that matches only valid input", function() + local fmt = "^%Y-%m-%d$" + datetime._pattern_cache[fmt] = nil + local p = datetime:_get_pattern(fmt) + assert.is_not_nil(p:tfind("2025-06-15")) + assert.is_nil(p:tfind("not-a-date")) + end) + end) + end) From ad5bfb7a3abc14173fe71ea15ef07797b9dcbe89 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Thu, 30 Jul 2026 08:34:29 +0200 Subject: [PATCH 018/155] fix: clearing the screen no longer loses the last line from the log (#9486) #### Brief overview of PR changes/additions - `clearWindow()` no longer drops the last received line(s) from the log file. - Flushes text still pending for logging before `TBuffer::clear()` deletes the display, so a line received before the clear is preserved. - Also logs a line whose *own* trigger calls `clearWindow()` mid-processing - previously its deferred `log()` call was suppressed when the clear reset its commit index to -1. - Adds a `ClearWindowLogTest` functional test covering all three cases (previous-line rescue, own-trigger rescue, and the `deleteLine()` gag still keeping gagged lines out). #### Motivation for adding to Mudlet Clearing the screen should never silently lose text from a player's log file - clearing the display is not the same as gagging a line. #### Other info Follow-up to #9429. Does not touch `logRemainingOutput()`'s duplicate-line handling. **Test case:** 1. Enable logging on a profile. 2. Feed a line, call `clearWindow()`, then feed another line - both appear in the log. 3. Add a trigger that calls `clearWindow()` on match, then feed a matching line - that line still appears in the log. 4. Or just run `flock /tmp/mudlet-functional-tests.lock ctest --output-on-failure -R ClearWindowLog` (all 3 scenarios pass). Assisted-by: Claude:claude-fable-5 Assisted-by: Claude:claude-opus-4-8 --- src/TBuffer.cpp | 23 ++ test/functional_tests/CMakeLists.txt | 1 + test/functional_tests/ClearWindowLogTest.cpp | 249 +++++++++++++++++++ 3 files changed, 273 insertions(+) create mode 100644 test/functional_tests/ClearWindowLogTest.cpp diff --git a/src/TBuffer.cpp b/src/TBuffer.cpp index 7c5be1e4e..4b85fb4ad 100644 --- a/src/TBuffer.cpp +++ b/src/TBuffer.cpp @@ -5343,6 +5343,29 @@ bool TBuffer::replaceInLine(QPoint& P_begin, QPoint& P_end, const QString& with, void TBuffer::clear() { + // Clearing the display is not gagging: flush any deferred log text before + // the deleteLines() calls below would discard it, so a received line that + // was still pending for logging is not lost from the log file + if (!mpHost.isNull() && mpHost->mpConsole && this == &mpHost->mpConsole->buffer && mpHost->mpConsole->mLogToLogFile) { + logRemainingOutput(); + + // A line whose own trigger calls clearWindow() has been committed and + // displayed, but commitLine() defers its log() call until runTriggers() + // returns - and the deleteLines() below will reset its commit index to + // -1, suppressing that call. Log those still-pending lines now so they + // are not lost. mCommitLineIndices holds them in display order. + for (const int commitLineIndex : mCommitLineIndices) { + if (commitLineIndex >= 0 && commitLineIndex < static_cast(lineBuffer.size())) { + mpHost->mpConsole->mLogStream << assembleLog(commitLineIndex, commitLineIndex); + } + } + mpHost->mpConsole->mLogStream.flush(); + + lastTextToLog.clear(); + lastLoggedFromLine = -1; + lastloggedToLine = -1; + } + mCurrentHyperlinkCommand.clear(); mCurrentHyperlinkHint.clear(); mCurrentHyperlinkLinkId = 0; diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index 0317a7c88..f468089a4 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -21,6 +21,7 @@ set(FUNCTIONAL_TEST_SOURCES EnableDisableByNameTest.cpp ColorTriggerFilterChildTest.cpp GMCPCharLoginTest.cpp + ClearWindowLogTest.cpp XMLexportVariablesTest.cpp SgrUnderlineStyleTest.cpp LogRestartDuplicateLineTest.cpp diff --git a/test/functional_tests/ClearWindowLogTest.cpp b/test/functional_tests/ClearWindowLogTest.cpp new file mode 100644 index 000000000..33fda8dc5 --- /dev/null +++ b/test/functional_tests/ClearWindowLogTest.cpp @@ -0,0 +1,249 @@ +/*************************************************************************** + * Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +#include + +#include "Host.h" +#include "MudletInstanceCoordinator.h" +#include "TLuaInterpreter.h" +#include "TMainConsole.h" +#include "TelnetServerStub.h" +#include "ctelnet.h" +#include "dlgConnectionProfiles.h" +#include "mudlet.h" + +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); +void initializeQRCResources(); + +// Logging defers each received line (TBuffer::lastTextToLog) so that a trigger +// gagging it with deleteLine() can stop it reaching the log file. clearWindow() +// however only clears the display - a line that was received and shown must +// still make it into the log even if the window is cleared before the next +// line arrives. These tests pin down both sides of that contract. +class ClearWindowLogTest : public QObject +{ + Q_OBJECT + +private: + TelnetServerStub* mpServer = nullptr; + const QString mHostname = "Test-ClearWindowLog"; + QString mPort; // assigned the stub's actual loopback port in init() + const QString mLocalhost = "localhost"; + +private slots: + void initTestCase() { initializeQRCResources(); } + + void init() + { + mpServer = new TelnetServerStub(qApp); + // Port 0 asks the OS for an ephemeral port so parallel test runs do + // not collide on a hardcoded one + mpServer->start(mLocalhost, 0); + QVERIFY2(mpServer->isListening(), "TelnetServerStub failed to bind a loopback port"); + mPort = QString::number(mpServer->serverPort()); + mudlet::start(); + mudlet::self()->setupConfig(); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique("MudletInstanceCoordinator")); + mudlet::self()->init(); + mudlet::self()->setStorePasswordsSecurely(false); + deleteProfileDirectory(mHostname); + } + + // A received line still pending in the deferred logging state must survive + // a clearWindow() call - clearing the display is not gagging. + void test_clearWindowKeepsPendingLogLine() + { + auto* host = startLoggingProfile(); + + host->getLuaInterpreter()->compileAndExecuteScript(qsl("feedTelnet('You are dead.\\n')")); + QVERIFY2(bufferContains(qsl("You are dead.")), "Fed line did not reach the console buffer"); + + host->getLuaInterpreter()->compileAndExecuteScript(qsl("clearWindow()")); + host->getLuaInterpreter()->compileAndExecuteScript(qsl("feedTelnet('You emerge unscathed.\\n')")); + + QString log; + stopLoggingAndReadLog(host, log); + QVERIFY2(log.contains(qsl("You are dead.")), "clearWindow() dropped the line that was pending for logging"); + QVERIFY2(log.contains(qsl("You emerge unscathed.")), "Line received after clearWindow() is missing from the log"); + } + + // A line whose OWN trigger calls clearWindow() mid-processing must still + // reach the log - it was received and displayed before the screen was + // cleared, so clearing is not the same as gagging it with deleteLine(). + void test_clearWindowFromOwnTriggerKeepsLine() + { + auto* host = startLoggingProfile(); + + host->getLuaInterpreter()->compileAndExecuteScript(qsl("tempRegexTrigger('^You perish$', [[clearWindow()]])")); + host->getLuaInterpreter()->compileAndExecuteScript(qsl("feedTelnet('You perish\\n')")); + host->getLuaInterpreter()->compileAndExecuteScript(qsl("feedTelnet('A new dawn\\n')")); + + QString log; + stopLoggingAndReadLog(host, log); + QVERIFY2(log.contains(qsl("You perish")), "A line whose own trigger cleared the window was dropped from the log"); + QVERIFY2(log.contains(qsl("A new dawn")), "Line received after clearWindow() is missing from the log"); + } + + // The behaviour #9429 fixed must be preserved: a line gagged by a trigger's + // deleteLine() stays out of the log while its neighbours are still logged. + void test_gaggedLineStaysOutOfLog() + { + auto* host = startLoggingProfile(); + + host->getLuaInterpreter()->compileAndExecuteScript(qsl("tempRegexTrigger('^Top secret plans$', [[deleteLine()]])")); + host->getLuaInterpreter()->compileAndExecuteScript(qsl("feedTelnet('Before the gag.\\n')")); + host->getLuaInterpreter()->compileAndExecuteScript(qsl("feedTelnet('Top secret plans\\n')")); + host->getLuaInterpreter()->compileAndExecuteScript(qsl("feedTelnet('After the gag.\\n')")); + + QString log; + stopLoggingAndReadLog(host, log); + QVERIFY2(log.contains(qsl("Before the gag.")), "Line before the gagged one is missing from the log"); + QVERIFY2(!log.contains(qsl("Top secret plans")), "Gagged line leaked into the log"); + QVERIFY2(log.contains(qsl("After the gag.")), "Line after the gagged one is missing from the log"); + } + + void cleanup() + { + delete mpServer; + mpServer = nullptr; + deleteProfileDirectory(mHostname); + delete mudlet::self(); + } + +private: + // Starts a profile, takes it offline (feedTelnet() requires that) and turns + // on plain-text logging to a known file name. + Host* startLoggingProfile() + { + startProfile(mHostname, mLocalhost, mPort); + auto* host = mudlet::self()->getActiveHost(); + host->mEchoLuaErrors = true; + + host->mTelnet.disconnectIt(); + if (!QTest::qWaitFor( + [host]() { + return host->mTelnet.getConnectionState() == QAbstractSocket::UnconnectedState; + }, + 5000)) { + qWarning() << "Profile did not go offline in time; feedTelnet() calls will fail"; + } + + host->mLogDir.clear(); + host->mLogFileNameFormat.clear(); + host->mLogFileName = qsl("clearwindow-log-test"); + host->mIsNextLogFileInHtmlFormat = false; + host->mpConsole->toggleLogging(false); + return host; + } + + // Returns the log contents through logContents. A genuine open failure is + // surfaced as its own assertion (with the OS error) rather than silently + // returning an empty string, which would otherwise masquerade as a + // dropped/missing log line in the callers' QVERIFY2 checks. + void stopLoggingAndReadLog(Host* host, QString& logContents) + { + const QString logFileName = host->mpConsole->mLogFileName; + host->mpConsole->toggleLogging(false); + + QFile logFile(logFileName); + QVERIFY2(logFile.open(QIODevice::ReadOnly | QIODevice::Text), qPrintable(qsl("Could not open log file '%1' for reading: %2").arg(logFileName, logFile.errorString()))); + logContents = QString::fromUtf8(logFile.readAll()); + } + + // Starts a profile the way a user would via the GUI (mirrors the helper in + // TelnetTextDisplayedTest). + void startProfile(const QString& hostname, const QString& address, const QString& port) + { + QTimer::singleShot(0, qApp, [hostname, address, port]() { + mudlet::self()->startAutoLogin({}); + QTest::qWait(100); + QTest::mouseClick(mudlet::self()->mpConnectionDialog->new_profile_button, Qt::LeftButton); + QTest::qWait(100); + QTest::keyClicks(QApplication::focusWidget(), hostname); + QTest::qWait(100); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100); + QTest::keyClicks(QApplication::focusWidget(), address); + QTest::qWait(100); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100); + QTest::keyClicks(QApplication::focusWidget(), port); + QTest::qWait(100); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Return); + }); + + QSignalSpy spy(mudlet::self(), &mudlet::signal_profileLoaded); + if (!spy.wait(5000)) { + QFAIL("Profile took too long to load."); + } + auto host = mudlet::self()->getActiveHost(); + if (!host) { + QFAIL("No active host available for the test."); + } + + QSignalSpy spy2(&(host->mTelnet), &cTelnet::signal_connected); + if (!spy2.wait(2000)) { + QFAIL("Could not connect with the host."); + } + } + + QString joinedBuffer() + { + auto console = mudlet::self()->getActiveHost()->mpConsole; + QString allText; + for (int i = 0; i <= console->buffer.getLastLineNumber(); ++i) { + allText.append(console->buffer.line(i)).append(QChar::Space); + } + return allText.simplified(); + } + + bool bufferContains(const QString& needle) { return joinedBuffer().contains(needle); } + + void deleteProfileDirectory(const QString& profileName) + { + const QString path = mudlet::getMudletPath(enums::profileHomePath, profileName); + QDir dir(path); + if (!dir.exists()) { + return; + } + dir.removeRecursively(); + } +}; + +void initializeQRCResources() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +#include "ClearWindowLogTest.moc" +QTEST_MAIN(ClearWindowLogTest) From 87fe7fa080529fb15eadf10dcfc3572cb5818b08 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Thu, 30 Jul 2026 08:35:03 +0200 Subject: [PATCH 019/155] fix: replacing a temp item's script no longer keeps running the old function callback (#9496) #### Brief overview of PR changes/additions - `setScript()` on a temp trigger/timer/alias/key that was created with a function callback (`tempTrigger`/`tempTimer`/`tempAlias`/`tempKey` with a function argument) now releases that callback: it clears the registered-function flag and removes the function from the Lua registry before switching to the new script string. - Without this, such an item would keep executing the stale callback so the new script never runs (triggers/aliases/keys), and the old function would never be freed from the Lua registry (all four types). - Adds a functional test (`SetScriptCallbackTest`) covering all four types, plus the empty-script and non-callback (no-op) cases. #### Motivation for adding to Mudlet Keeps a temp item's execution state and cleanup consistent when its script is replaced. No current scripting API or editor path replaces a temp item's script, so this closes the gap before anything can reach it. #### Other info (issues closed, discussion etc) A temp item's function callback is stored in the Lua registry keyed by the item pointer; `setScript()` previously left both that entry and the `mRegisteredAnonymousLuaFunction` flag untouched. Because each destructor picks its cleanup branch from `mScript.isEmpty()`, once a non-empty script was set the pointer-keyed entry was orphaned. `TAction` (buttons) has no function-callback path and is unaffected. Behaviour of every existing caller is unchanged, covered by the no-op guard case. **Test case:** ``` run: flock /tmp/mudlet-functional-tests.lock ctest --output-on-failure -R SetScriptCallbackTest ``` All 6 sub-tests pass with the fix; 5 of 6 fail against the pre-fix baseline (the non-callback no-op case passes by design, guarding that existing behaviour is unchanged). Related suites `EnableDisableByNameTest` and `TFeedTriggersRecursionTest` still pass. Assisted-by: Claude:claude-opus-4-8 --- src/TAlias.cpp | 11 + src/TKey.cpp | 11 + src/TTimer.cpp | 12 + src/TTrigger.cpp | 11 + test/functional_tests/CMakeLists.txt | 1 + .../SetScriptCallbackTest.cpp | 356 ++++++++++++++++++ 6 files changed, 402 insertions(+) create mode 100644 test/functional_tests/SetScriptCallbackTest.cpp diff --git a/src/TAlias.cpp b/src/TAlias.cpp index d5198f000..9fc4a3590 100644 --- a/src/TAlias.cpp +++ b/src/TAlias.cpp @@ -332,6 +332,17 @@ void TAlias::compile() bool TAlias::setScript(const QString& script) { + // Switching from a registered anonymous Lua function (set up by tempAlias with a + // function argument) to a script string: release the old function from the Lua + // registry and leave callback mode. Otherwise execute() keeps calling the stale + // function so the new script never runs, and the registry entry leaks - the + // destructor would take its mScript-based branch and delete the compiled function. + if (mRegisteredAnonymousLuaFunction) { + if (mpHost) { + mpHost->mLuaInterpreter.delete_luafunction(this); + } + mRegisteredAnonymousLuaFunction = false; + } mScript = script; mNeedsToBeCompiled = true; mOK_code = compileScript(); diff --git a/src/TKey.cpp b/src/TKey.cpp index 6dba5169f..c0c22b167 100644 --- a/src/TKey.cpp +++ b/src/TKey.cpp @@ -164,6 +164,17 @@ void TKey::compile() bool TKey::setScript(const QString& script) { + // Switching from a registered anonymous Lua function (set up by tempKey with a + // function argument) to a script string: release the old function from the Lua + // registry and leave callback mode. Otherwise execute() keeps calling the stale + // function so the new script never runs, and the registry entry leaks - the + // destructor would take its mScript-based branch and delete the compiled function. + if (mRegisteredAnonymousLuaFunction) { + if (mpHost) { + mpHost->mLuaInterpreter.delete_luafunction(this); + } + mRegisteredAnonymousLuaFunction = false; + } mScript = script; mNeedsToBeCompiled = true; mOK_code = compileScript(); diff --git a/src/TTimer.cpp b/src/TTimer.cpp index 2e5fe3385..4ed6b1b62 100644 --- a/src/TTimer.cpp +++ b/src/TTimer.cpp @@ -163,6 +163,18 @@ void TTimer::compileAll() bool TTimer::setScript(const QString& script) { + // Switching from a registered anonymous Lua function (set up by tempTimer with a + // function argument) to a script string: release the old function from the Lua + // registry and leave callback mode. Unlike triggers/aliases/keys, TTimer::execute() + // keys off mScript rather than the flag, so the new script does run - but without + // this the registry entry still leaks, as the destructor would then take its + // mScript-based branch and delete the compiled function instead. + if (mRegisteredAnonymousLuaFunction) { + if (mpHost) { + mpHost->mLuaInterpreter.delete_luafunction(this); + } + mRegisteredAnonymousLuaFunction = false; + } mScript = script; if (script == "") { mNeedsToBeCompiled = false; diff --git a/src/TTrigger.cpp b/src/TTrigger.cpp index b199ef258..8ffe630fd 100644 --- a/src/TTrigger.cpp +++ b/src/TTrigger.cpp @@ -1253,6 +1253,17 @@ void TTrigger::compile() bool TTrigger::setScript(const QString& script) { + // Switching from a registered anonymous Lua function (set up by tempTrigger with a + // function argument) to a script string: release the old function from the Lua + // registry and leave callback mode. Otherwise execute() keeps calling the stale + // function so the new script never runs, and the registry entry leaks - the + // destructor would take its mScript-based branch and delete the compiled function. + if (mRegisteredAnonymousLuaFunction) { + if (mpHost) { + mpHost->mLuaInterpreter.delete_luafunction(this); + } + mRegisteredAnonymousLuaFunction = false; + } mScript = script; if (script.isEmpty()) { mNeedsToBeCompiled = false; diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index f468089a4..727bf3a42 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -21,6 +21,7 @@ set(FUNCTIONAL_TEST_SOURCES EnableDisableByNameTest.cpp ColorTriggerFilterChildTest.cpp GMCPCharLoginTest.cpp + SetScriptCallbackTest.cpp ClearWindowLogTest.cpp XMLexportVariablesTest.cpp SgrUnderlineStyleTest.cpp diff --git a/test/functional_tests/SetScriptCallbackTest.cpp b/test/functional_tests/SetScriptCallbackTest.cpp new file mode 100644 index 000000000..f8f70d76e --- /dev/null +++ b/test/functional_tests/SetScriptCallbackTest.cpp @@ -0,0 +1,356 @@ +/*************************************************************************** + * Copyright (C) 2026 by Mudlet Developers * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +/* + * A temp trigger/timer/alias/key created with a function argument stores that + * function as an anonymous callback in the Lua registry (keyed by the item + * pointer) and flags mRegisteredAnonymousLuaFunction. Replacing its script via + * setScript() must leave that callback mode: it has to release the old function + * from the registry (otherwise the entry leaks, as the destructor's mScript-based + * branch then deletes the compiled function rather than the callback) and clear + * the flag (otherwise execute() keeps calling the stale function and the new + * script never runs, for triggers/aliases/keys which gate execution on the flag). + * + * Run with: ctest -R SetScriptCallbackTest -V + */ + +#include + +#include "AliasUnit.h" +#include "Host.h" +#include "KeyUnit.h" +#include "MudletInstanceCoordinator.h" +#include "TAlias.h" +#include "TKey.h" +#include "TLuaInterpreter.h" +#include "TTimer.h" +#include "TTrigger.h" +#include "TimerUnit.h" +#include "TriggerUnit.h" +#include "TelnetServerStub.h" +#include "ctelnet.h" +#include "dlgConnectionProfiles.h" +#include "mudlet.h" + +extern "C" { +#if defined(INCLUDE_VERSIONED_LUA_HEADERS) +#include +#include +#include +#else +#include +#include +#include +#endif +} + +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); +void initializeQRCResourcesForSetScriptCallbackTest(); + +class SetScriptCallbackTest : public QObject +{ + Q_OBJECT + +private: + TelnetServerStub* mpServer = nullptr; + Host* mpHost = nullptr; + const QString mHostname = "SetScriptCallback-Test"; + QString mPort; // assigned the stub's actual ephemeral port in initTestCase() + const QString mLocalhost = "localhost"; + + void runLua(const QString& code) + { + lua_State* L = mpHost->mLuaInterpreter.getLuaGlobalState(); + if (luaL_dostring(L, code.toUtf8().constData()) != 0) { + const QString error = QString::fromUtf8(lua_tostring(L, -1)); + lua_pop(L, 1); + QFAIL(qPrintable(qsl("Lua error running test script: %1").arg(error))); + } + } + + int luaInt(const QString& global) + { + lua_State* L = mpHost->mLuaInterpreter.getLuaGlobalState(); + lua_getglobal(L, global.toUtf8().constData()); + const int value = static_cast(lua_tointeger(L, -1)); + lua_pop(L, 1); + return value; + } + + // The anonymous callback is stored in the Lua registry keyed by the item + // pointer; a released callback leaves a nil entry there. + bool registryEntryIsNil(void* item) + { + lua_State* L = mpHost->mLuaInterpreter.getLuaGlobalState(); + lua_pushlightuserdata(L, item); + lua_rawget(L, LUA_REGISTRYINDEX); + const bool result = lua_isnil(L, -1); + lua_pop(L, 1); + return result; + } + +private slots: + void initTestCase() + { + initializeQRCResourcesForSetScriptCallbackTest(); + + mpServer = new TelnetServerStub(qApp); + mpServer->start(mLocalhost, 0); // ephemeral OS-assigned port avoids collisions across concurrent test runs + mPort = QString::number(mpServer->serverPort()); + mudlet::start(); + mudlet::self()->setupConfig(); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique("MudletInstanceCoordinator")); + mudlet::self()->init(); + mudlet::self()->setStorePasswordsSecurely(false); + deleteProfileDirectory(mHostname); + + startProfile(mHostname, mLocalhost, mPort); + mpHost = mudlet::self()->getActiveHost(); + QVERIFY2(mpHost, "No active host after profile creation"); + } + + void cleanupTestCase() + { + mpHost = nullptr; + delete mpServer; + mpServer = nullptr; + deleteProfileDirectory(mHostname); + delete mudlet::self(); + } + + // Trigger: execute() gates on the flag, so before the fix the stale function + // keeps firing (new script never runs) AND its registry entry leaks. + void test_triggerSetScriptReleasesCallback() + { + runLua(qsl("trigOld = 0\n" + "trigNew = 0\n" + "cbTrigId = tempRegexTrigger('^setscript_trig$', function() trigOld = trigOld + 1 end)\n")); + const int id = luaInt(qsl("cbTrigId")); + QVERIFY2(id > 0, "temp trigger with a function callback should be created"); + auto* pTrigger = mpHost->getTriggerUnit()->getTrigger(id); + QVERIFY(pTrigger); + QVERIFY2(pTrigger->mRegisteredAnonymousLuaFunction, "callback trigger should start in registered-function mode"); + + // Sanity: the registered function is what fires before we replace it. + runLua(qsl("feedTriggers('setscript_trig\\n')")); + QCOMPARE(luaInt(qsl("trigOld")), 1); + + QVERIFY(pTrigger->setScript(qsl("trigNew = trigNew + 1"))); + + QVERIFY2(!pTrigger->mRegisteredAnonymousLuaFunction, "setScript() must leave registered-function mode"); + QVERIFY2(registryEntryIsNil(pTrigger), "setScript() must release the old function from the Lua registry (no leak)"); + + // Firing now runs the new script; the stale function must not fire again. + runLua(qsl("feedTriggers('setscript_trig\\n')")); + QCOMPARE(luaInt(qsl("trigNew")), 1); + QCOMPARE(luaInt(qsl("trigOld")), 1); + } + + // Alias: execute() also gates on the flag, so the same stale-function symptom + // applies. Fire it directly through execute() since aliases match user input. + void test_aliasSetScriptReleasesCallback() + { + runLua(qsl("aliasOld = 0\n" + "aliasNew = 0\n" + "cbAliasId = tempAlias('^setscript_alias$', function() aliasOld = aliasOld + 1 end)\n")); + const int id = luaInt(qsl("cbAliasId")); + QVERIFY2(id > 0, "temp alias with a function callback should be created"); + auto* pAlias = mpHost->getAliasUnit()->getAlias(id); + QVERIFY(pAlias); + QVERIFY2(pAlias->mRegisteredAnonymousLuaFunction, "callback alias should start in registered-function mode"); + + pAlias->execute(); + QCOMPARE(luaInt(qsl("aliasOld")), 1); + + QVERIFY(pAlias->setScript(qsl("aliasNew = aliasNew + 1"))); + + QVERIFY2(!pAlias->mRegisteredAnonymousLuaFunction, "setScript() must leave registered-function mode"); + QVERIFY2(registryEntryIsNil(pAlias), "setScript() must release the old function from the Lua registry (no leak)"); + + pAlias->execute(); + QCOMPARE(luaInt(qsl("aliasNew")), 1); + QCOMPARE(luaInt(qsl("aliasOld")), 1); + } + + // Key: execute() gates on the flag as well. + void test_keySetScriptReleasesCallback() + { + runLua(qsl("keyOld = 0\n" + "keyNew = 0\n" + "cbKeyId = tempKey(65, function() keyOld = keyOld + 1 end)\n")); + const int id = luaInt(qsl("cbKeyId")); + QVERIFY2(id > 0, "temp key with a function callback should be created"); + auto* pKey = mpHost->getKeyUnit()->getKey(id); + QVERIFY(pKey); + QVERIFY2(pKey->mRegisteredAnonymousLuaFunction, "callback key should start in registered-function mode"); + + pKey->execute(); + QCOMPARE(luaInt(qsl("keyOld")), 1); + + QVERIFY(pKey->setScript(qsl("keyNew = keyNew + 1"))); + + QVERIFY2(!pKey->mRegisteredAnonymousLuaFunction, "setScript() must leave registered-function mode"); + QVERIFY2(registryEntryIsNil(pKey), "setScript() must release the old function from the Lua registry (no leak)"); + + pKey->execute(); + QCOMPARE(luaInt(qsl("keyNew")), 1); + QCOMPARE(luaInt(qsl("keyOld")), 1); + } + + // Timer: execute() discriminates on mScript rather than the flag, so the + // stale-function symptom does not surface - but the registry entry still leaks + // without the fix, which is what this asserts. A long timeout keeps the timer + // from firing on its own during the test. + void test_timerSetScriptReleasesCallback() + { + runLua(qsl("cbTimerId = tempTimer(100, function() end)\n")); + const int id = luaInt(qsl("cbTimerId")); + QVERIFY2(id > 0, "temp timer with a function callback should be created"); + auto* pTimer = mpHost->getTimerUnit()->getTimer(id); + QVERIFY(pTimer); + QVERIFY2(pTimer->mRegisteredAnonymousLuaFunction, "callback timer should start in registered-function mode"); + + QVERIFY(pTimer->setScript(qsl("noop = 1"))); + + QVERIFY2(!pTimer->mRegisteredAnonymousLuaFunction, "setScript() must leave registered-function mode"); + QVERIFY2(registryEntryIsNil(pTimer), "setScript() must release the old function from the Lua registry (no leak)"); + } + + // Clearing a callback item's script with setScript("") must also release the + // callback and stop it firing: for triggers/aliases/keys execute() then takes the + // empty-mScript early-out. + void test_triggerSetScriptEmptyReleasesCallback() + { + runLua(qsl("clearOld = 0\n" + "clearTrigId = tempRegexTrigger('^setscript_clear$', function() clearOld = clearOld + 1 end)\n")); + const int id = luaInt(qsl("clearTrigId")); + QVERIFY2(id > 0, "temp trigger with a function callback should be created"); + auto* pTrigger = mpHost->getTriggerUnit()->getTrigger(id); + QVERIFY(pTrigger); + QVERIFY(pTrigger->mRegisteredAnonymousLuaFunction); + + runLua(qsl("feedTriggers('setscript_clear\\n')")); + QCOMPARE(luaInt(qsl("clearOld")), 1); + + QVERIFY(pTrigger->setScript(QString())); + + QVERIFY2(!pTrigger->mRegisteredAnonymousLuaFunction, "setScript(\"\") must leave registered-function mode"); + QVERIFY2(registryEntryIsNil(pTrigger), "setScript(\"\") must release the old function from the Lua registry (no leak)"); + + // With no script and no callback, firing must do nothing - the stale function + // must not run. + runLua(qsl("feedTriggers('setscript_clear\\n')")); + QCOMPARE(luaInt(qsl("clearOld")), 1); + } + + // Guard the common real-world path (the script editor replacing a normal, + // string-created item's code): a non-callback item must never be pushed into + // callback mode, and setScript() must still update its behavior normally. + void test_stringCreatedTriggerSetScriptIsUnaffected() + { + runLua(qsl("plainA = 0\n" + "plainB = 0\n" + "plainTrigId = tempRegexTrigger('^setscript_plain$', 'plainA = plainA + 1')\n")); + const int id = luaInt(qsl("plainTrigId")); + QVERIFY2(id > 0, "string-created temp trigger should be created"); + auto* pTrigger = mpHost->getTriggerUnit()->getTrigger(id); + QVERIFY(pTrigger); + QVERIFY2(!pTrigger->mRegisteredAnonymousLuaFunction, "a string-created trigger is never in registered-function mode"); + + runLua(qsl("feedTriggers('setscript_plain\\n')")); + QCOMPARE(luaInt(qsl("plainA")), 1); + + QVERIFY(pTrigger->setScript(qsl("plainB = plainB + 1"))); + QVERIFY2(!pTrigger->mRegisteredAnonymousLuaFunction, "setScript() must not push a string item into registered-function mode"); + + runLua(qsl("feedTriggers('setscript_plain\\n')")); + QCOMPARE(luaInt(qsl("plainB")), 1); + QCOMPARE(luaInt(qsl("plainA")), 1); + } + + // Helpers (reused from the EnableDisableByNameTest/TFeedTriggersRecursionTest pattern) + + void startProfile(const QString& hostname, const QString& address, const QString& port) + { + QTimer::singleShot(0, qApp, [hostname, address, port]() { + mudlet::self()->startAutoLogin({}); + QTest::qWait(100); + QTest::mouseClick(mudlet::self()->mpConnectionDialog->new_profile_button, Qt::LeftButton); + QTest::qWait(100); + QTest::keyClicks(QApplication::focusWidget(), hostname); + QTest::qWait(100); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100); + QTest::keyClicks(QApplication::focusWidget(), address); + QTest::qWait(100); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100); + QTest::keyClicks(QApplication::focusWidget(), port); + QTest::qWait(100); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Return); + }); + + QSignalSpy spy(mudlet::self(), &mudlet::signal_profileLoaded); + if (!spy.wait(5000)) { + QFAIL("Profile took too long to load."); + } + auto host = mudlet::self()->getActiveHost(); + if (!host) { + QFAIL("No active host available for the test."); + } + + QSignalSpy spy2(&(host->mTelnet), &cTelnet::signal_connected); + if (!spy2.wait(2000)) { + QFAIL("Could not connect with the host."); + } + } + + void deleteProfileDirectory(const QString& profileName) + { + const QString path = mudlet::getMudletPath(enums::profileHomePath, profileName); + QDir dir(path); + + if (!dir.exists()) { + return; + } + dir.removeRecursively(); + } +}; + +void initializeQRCResourcesForSetScriptCallbackTest() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +#include "SetScriptCallbackTest.moc" +QTEST_MAIN(SetScriptCallbackTest) From d4376326bb1960de87786e1969b821d8a8563395 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Thu, 30 Jul 2026 10:49:10 +0200 Subject: [PATCH 020/155] fix: stop crashes while saving and profiles losing their triggers (#9557) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit #### Brief overview of PR changes/additions - Profile loading now only considers real `*.xml` saves: an empty QSaveFile temporary left behind by a crash during a save can no longer be loaded as "the profile", which made a profile open with its connection settings intact but every trigger/script seemingly gone. Affected profiles heal themselves on next load by falling back to the newest real save. - Packages that uninstall themselves from their own timer script or event-handler script (a common auto-updater pattern) no longer free the very objects still executing: `TimerUnit`/`ScriptUnit` uninstall now defers deletion while `TTimer::execute()` / `Host::raiseEvent()` are on the call stack, completing the #9337/#9383 fix that already covered triggers/aliases/keys. Deferred timer deletes are flushed before the queued post-uninstall save runs, so removed items cannot be serialized back into the profile. - `Host::saveProfile()`'s background module task no longer reads `writers`/`saveFutures` concurrently with the main thread (data race in the profile save path). #### Motivation for adding to Mudlet Fixes a real-world heap-corruption crash cluster (Sentry MUDLET-32 / MUDLET-2S / MUDLET-48: `STATUS_HEAP_CORRUPTION` on 4.21.0/4.21.1, frames touching lua51/Qt6Core/libpugixml, breadcrumbs showing package uninstall activity around saves) and the profile data loss it caused. #### Other info (issues closed, discussion etc) Root cause of the crashes: #9111 (in the 4.20.1 → 4.21.0 window) changed the `*Unit::uninstall()` methods from unregister-only to immediate `delete`. A package script calling `uninstallPackage()` on its own package then freed objects still on the call stack - use-after-free that poisons the heap, typically detected slightly later during the background save serialization (hence the pugixml/lua frames, aborts mid-save, and zero-byte `....xml.XXXXXX` QSaveFile leftovers in `current/`). #9383 fixed the trigger/alias/key cases; this completes timers and scripts, which reproduce under ASan on current development (heap-use-after-free in `Tree::isActive()` / `TTimer::execute()`). Data-loss mechanism (generic): a crash mid-save leaves a 0-byte QSaveFile temporary as the newest file in `current/`; `mudlet::loadProfile()` picked the newest file of any name, tried to load the empty temp, and the profile opened "gutted" (connection details live in separate files and survived). Verified end-to-end with affected profile data and covered by a synthetic regression test. Both new functional tests fail on pre-fix code (`PackageSelfUninstallTest` trips ASan heap-use-after-free; `ProfileLoadTempFileTest` reproduces the data loss) and pass with the fix; full functional suite green (24/24). Known remaining (pre-existing) issue documented in-code at `Host::pendingXmlSaveFutures()`: module writing still touches `writers` from the background task for profiles that use modules; fixing that properly means moving module serialization back to the main thread and deserves its own PR. **Test case:** 1. Create a package containing a timer or event-handler script that calls `uninstallPackage()` on its own package, and let it fire - no crash, package cleanly removed, next save does not resurrect it. 2. Simulate an interrupted save: place an empty file named like `2026-01-01#12-00-00.xml.AbCdEf` in a profile's `current/` folder with the newest timestamp - the profile still loads the newest real save with all triggers intact, and the temporary no longer appears in Connect → Options → Profile history. 3. `ctest -R "ProfileLoadTempFileTest|PackageSelfUninstallTest"` in an ASan (default Debug) build. Assisted-by: Claude:claude-fable-5 Assisted-by: Claude:claude-opus-4-8 Signed-off-by: Vadim Peretokin --- src/Host.cpp | 62 +++- src/Host.h | 1 + src/ScriptUnit.cpp | 53 +++- src/ScriptUnit.h | 24 +- src/TScript.cpp | 23 ++ src/TTimer.cpp | 18 ++ src/TimerUnit.cpp | 33 +++ src/TimerUnit.h | 22 +- src/TriggerUnit.cpp | 10 +- src/dlgConnectionProfiles.cpp | 8 +- src/dlgTriggerEditor.cpp | 7 + src/mudlet.cpp | 24 +- test/functional_tests/CMakeLists.txt | 2 + .../PackageSelfUninstallTest.cpp | 278 ++++++++++++++++++ .../ProfileLoadTempFileTest.cpp | 193 ++++++++++++ 15 files changed, 727 insertions(+), 31 deletions(-) create mode 100644 test/functional_tests/PackageSelfUninstallTest.cpp create mode 100644 test/functional_tests/ProfileLoadTempFileTest.cpp diff --git a/src/Host.cpp b/src/Host.cpp index 995153dac..43b9fb65b 100644 --- a/src/Host.cpp +++ b/src/Host.cpp @@ -71,6 +71,7 @@ #include #include #include +#include #include #include #include @@ -644,15 +645,26 @@ void Host::writeModule(const QString& moduleName, const QString& filename) updateModuleZips(filename, moduleName); } +// Main thread only: `writers` and each writer's `saveFutures` are mutated on the +// main thread as profile saves start and finish, so the background module-sync +// task must not read them - it gets a snapshot taken up front instead (see +// saveProfile()). NB: saveModules()/writeModule() still touch `writers` from +// that background task for profiles that use modules - a known remaining race +// that needs module writing to move back to the main thread to fix properly. +QVector> Host::pendingXmlSaveFutures() const +{ + QVector> futures; + for (const auto& writer : writers) { + futures += writer->saveFutures; + } + return futures; +} + void Host::waitForAsyncXmlSave() { - // writers and futures are copied to prevent deletion during for loop (which would mean crash) - auto myWriters = writers; - for (auto& writer : myWriters) { - auto myFutures = writer->saveFutures; - for (auto& future : myFutures) { - future.waitForFinished(); - } + const auto futures = pendingXmlSaveFutures(); + for (auto future : futures) { + future.waitForFinished(); } } @@ -1013,10 +1025,18 @@ std::tuple Host::saveProfile(const QString& saveFolder, } auto watcher = new QFutureWatcher; - mModuleFuture = QtConcurrent::run([=, this]() { + // Snapshot the pending XML save futures on the main thread: the background task + // below must not read `writers`/`saveFutures` itself as the main thread mutates + // them whenever a save starts or finishes - concurrently copying those containers + // from the pool thread is a data race that can corrupt the heap + const QVector> xmlSaveFutures = pendingXmlSaveFutures(); + const bool backupModules = saveName != qsl("autosave"); + mModuleFuture = QtConcurrent::run([this, xmlSaveFutures, backupModules]() { // wait for the host xml to be ready before starting to sync modules - waitForAsyncXmlSave(); - saveModules(saveName != qsl("autosave")); + for (auto future : xmlSaveFutures) { + future.waitForFinished(); + } + saveModules(backupModules); }); connect(watcher, &QFutureWatcher::finished, this, [=, this]() { // reload, or queue module reload for when xml is ready @@ -1797,6 +1817,9 @@ void Host::incomingStreamProcessor(const QString& data, int line) mTimerUnit.doCleanup(); mTriggerUnit.doCleanup(); mKeyUnit.doCleanup(); + // ScriptUnit defers deletes too (a package script uninstalling its own package + // mid-compile or mid-event-dispatch), so flush it here alongside the others: + mScriptUnit.doCleanup(); } // When Mudlet is running in online mode, deleted temp* objects are cleaned up in bulk @@ -1808,6 +1831,7 @@ void Host::slot_purgeTemps() mTimerUnit.doCleanup(); mTriggerUnit.doCleanup(); mKeyUnit.doCleanup(); + mScriptUnit.doCleanup(); } void Host::registerEventHandler(const QString& name, TScript* pScript) @@ -1855,6 +1879,18 @@ void Host::raiseEvent(const TEvent& pE) static const QString star = qsl("*"); + // A handler can uninstall its own package mid-dispatch (a common package + // auto-updater pattern): whilst this frame is on the stack + // ScriptUnit::uninstall() defers its deletes so neither the executing + // handler nor the other TScript pointers in the lists copied below get + // freed under us; the deferred deletes are flushed once the outermost + // dispatch finishes: + mScriptUnit.beginProcessing(); + const auto processingGuard = qScopeGuard([this] { + mScriptUnit.endProcessing(); + mScriptUnit.doCleanup(); + }); + if (mEventHandlerMap.contains(pE.mArgumentList.at(0))) { QList scriptList = mEventHandlerMap.value(pE.mArgumentList.at(0)); for (auto& script : scriptList) { @@ -2427,6 +2463,12 @@ bool Host::uninstallPackage(const QString& packageName, enums::PackageModuleType // not to try to write to disk a package/module that just got uninstalled and removed from memory QTimer::singleShot(0ms, this, [this]() { mSaveTimer = false; + // If a package's own script uninstalled it mid-compile (from a script + // reached outside the compileAll()/editor/raiseEvent flush points, e.g. a + // permScript() run from an alias or key), the script deletes were deferred + // and are still registered. Flush them now, at depth 0, before saving so + // the save below does not serialize the just-uninstalled scripts back in: + mScriptUnit.doCleanup(); if (auto [ok, filename, error] = saveProfile(); !ok) { qDebug() << qsl("Host::uninstallPackage: Couldn't save '%1' to '%2' because: %3").arg(getName(), filename, error); } diff --git a/src/Host.h b/src/Host.h index 06e2bf0a9..c8c98b90e 100644 --- a/src/Host.h +++ b/src/Host.h @@ -898,6 +898,7 @@ private: void removePackageInfo(const QString& packageName, const bool); static void createModuleBackup(const QString& filename, const QString& saveName); void writeModule(const QString& moduleName, const QString& filename); + QVector> pendingXmlSaveFutures() const; void waitForAsyncXmlSave(); void saveModules(bool backup = true); void updateModuleZips(const QString& zipName, const QString& moduleName); diff --git a/src/ScriptUnit.cpp b/src/ScriptUnit.cpp index eca2bbaa1..3810b2981 100644 --- a/src/ScriptUnit.cpp +++ b/src/ScriptUnit.cpp @@ -79,8 +79,44 @@ void ScriptUnit::uninstall(const QString& packageName) uninstallList.append(rootScript); } } - for (auto& script : uninstallList) { - delete script; + // Re-entrant uninstall (#9337): a package's own script (e.g. a package + // auto-updater calling uninstallPackage()) is removing its package while one + // of that package's scripts is still on the call stack - either an event + // handler Host::raiseEvent() is dispatching to, or a top-level body + // TScript::compileScript() is compiling. Deleting now would be a use-after-free + // (of the script still executing, and of the other TScript pointers raiseEvent() + // or ScriptUnit::compileAll() is still iterating), so defer to doCleanup() at + // depth 0. Deactivating is enough to stop the handlers firing for the rest of + // the dispatch: TScript::callEventHandler() checks isActive(). + if (mProcessingDepth > 0) { + for (auto script : uninstallList) { + script->setIsActive(false); + } + return; + } + // At depth 0 delete straight away, but go through doCleanup() rather than a bare + // loop: uninstallList is a member that a prior deferred uninstall may have left + // populated, so a second uninstall of the same still-registered package can queue + // the same pointers twice - doCleanup()'s seen set stops that double-freeing. + doCleanup(); +} + +// Flush the deletes uninstall() deferred (#9337). uninstallList is ordered +// children-before-parents and each ~Tree unlinks from its parent, so deleting +// children first empties the parent's child list (no double free); the seen +// set guards a node queued twice by re-entrant uninstalls. +void ScriptUnit::doCleanup() +{ + if (mProcessingDepth > 0) { + return; + } + + QSet deletedScripts; + for (auto script : uninstallList) { + if (!deletedScripts.contains(script)) { + deletedScripts.insert(script); + delete script; + } } uninstallList.clear(); } @@ -237,11 +273,22 @@ int ScriptUnit::getNewID() void ScriptUnit::compileAll(bool saveLoadingError) { - for (auto script : mScriptRootNodeList) { + // Iterate a snapshot of the root list: a script's top-level body, run by + // compile() below, can uninstall its own package (a package auto-updater + // pattern). uninstall() defers the actual delete whilst compileScript() is on + // the stack, so no node is unlinked mid-loop, but taking a copy keeps the + // iteration safe even against a body that adds or removes root scripts: + const std::vector rootNodes(mScriptRootNodeList.begin(), mScriptRootNodeList.end()); + for (auto script : rootNodes) { if (script->isActive()) { script->compileAll(saveLoadingError); } } + // The loop is now done with the (possibly self-uninstalled) scripts, so flush + // the deletes uninstall() deferred - before the editor tree is rebuilt below and + // before returning to the event loop, where the 0ms save Host::uninstallPackage() + // queues would otherwise serialize the still-live "uninstalled" scripts back in: + doCleanup(); if (mpHost->mpEditorDialog) { mpHost->mpEditorDialog->doCleanReset(); } diff --git a/src/ScriptUnit.h b/src/ScriptUnit.h index e04462793..3f438307d 100644 --- a/src/ScriptUnit.h +++ b/src/ScriptUnit.h @@ -44,15 +44,9 @@ public: explicit ScriptUnit(Host*); ~ScriptUnit(); - std::list getScriptRootNodeList() - { - return mScriptRootNodeList; - } + std::list getScriptRootNodeList() { return mScriptRootNodeList; } - QMap getScriptList() - { - return mScriptMap; - } + QMap getScriptList() { return mScriptMap; } TScript* getScript(int id); void compileAll(bool saveLoadingError = false); @@ -63,6 +57,17 @@ public: void stopAllTriggers(); void uninstall(const QString&); void _uninstall(TScript* pChild, const QString& packageName); + // Tracks Host::raiseEvent() dispatch nesting so that uninstall() can defer + // deleting a package's scripts while one of their event handlers is still on + // the call stack (e.g. a handler calling uninstallPackage() on its own + // package) - deferred items are flushed by doCleanup() at depth 0: + void beginProcessing() { ++mProcessingDepth; } + void endProcessing() + { + --mProcessingDepth; + Q_ASSERT(mProcessingDepth >= 0); + } + void doCleanup(); int getNewID(); std::vector findItems(const QString& name, const bool exactMatch = true, const bool caseSensitive = true); void resetStats(); @@ -84,6 +89,9 @@ private: QPointer mpHost; QMap mScriptMap; std::list mScriptRootNodeList; + // > 0 whilst Host::raiseEvent() is dispatching to event handlers; uninstall() + // and doCleanup() must not delete scripts then: + int mProcessingDepth = 0; int mMaxID = 0; int statsItemsTotal = 0; int statsTempItems = 0; diff --git a/src/TScript.cpp b/src/TScript.cpp index 441ce9b1b..0c6f01625 100644 --- a/src/TScript.cpp +++ b/src/TScript.cpp @@ -25,9 +25,12 @@ #include "Host.h" +#include "ScriptUnit.h" #include "TDebug.h" #include "mudlet.h" +#include + TScript::TScript(TScript* parent, Host* pHost) : Tree(parent) , mpHost(pHost) @@ -120,6 +123,26 @@ bool TScript::setScript(const QString& script) bool TScript::compileScript(bool saveLoadingError) { + // Whilst this frame is on the stack ScriptUnit::uninstall() must defer deleting + // this profile's scripts: the top-level Lua body run below (the lua_pcall inside + // TLuaInterpreter::compile()) can uninstall its own package - a common package + // auto-updater pattern - and freeing this script mid-compile, or writing to it + // after compile() returns (see mNeedsToBeCompiled/mOK_code below and in + // setScript()), is a use-after-free. See ScriptUnit::mProcessingDepth. + ScriptUnit* pUnit = mpHost->getScriptUnit(); + pUnit->beginProcessing(); + // NB: deliberately decrement-only - do NOT add a doCleanup() call here. setScript() + // writes mOK_code AFTER this returns and ScriptUnit::compileAll()'s loop is still + // iterating the root list, so deleting `this` now would be a use-after-free. The + // deferred deletes are flushed at a safe point once the pointer is no longer in + // use: after ScriptUnit::compileAll()'s loop, at the end of the editor's + // saveScript(), in Host::raiseEvent()'s scope guard, and by the catch-all + // doCleanup() in Host::incomingStreamProcessor()/slot_purgeTemps() and the queued + // save in Host::uninstallPackage(). + const auto processingGuard = qScopeGuard([pUnit] { + pUnit->endProcessing(); + }); + QString error; if (mpHost->mLuaInterpreter.compile(mScript, error, QString("Script: ") + getName())) { mNeedsToBeCompiled = false; diff --git a/src/TTimer.cpp b/src/TTimer.cpp index 4ed6b1b62..cf8d9b4ad 100644 --- a/src/TTimer.cpp +++ b/src/TTimer.cpp @@ -28,6 +28,8 @@ #include "TDebug.h" #include "mudlet.h" +#include + const char* TTimer::scmProperty_HostName = "HostName"; const char* TTimer::scmProperty_TTimerId = "TTimerId"; @@ -215,6 +217,22 @@ void TTimer::execute() return; } + // Whilst this frame is on the stack TimerUnit::uninstall() must defer deleting + // this profile's timers: the scripts run below can uninstall their own package + // (a common package auto-updater pattern) and freeing this timer mid-execute() + // is a use-after-free - see TimerUnit::mProcessingDepth: + TimerUnit* pUnit = mpHost->getTimerUnit(); + pUnit->beginProcessing(); + // NB: deliberately only decrements the depth - do NOT add a doCleanup() call + // here: it would delete `this` (and other deferred timers) while + // mudlet::slot_timerFires() still holds the pointer. Deferred deletes are + // flushed by slot_timerFires() itself once it is finished with the timer + // (and by the doCleanup() calls in Host::incomingStreamProcessor() and + // Host::slot_purgeTemps()): + const auto processingGuard = qScopeGuard([pUnit] { + pUnit->endProcessing(); + }); + if (!isActive() || isFolder()) { mpQTimer->stop(); return; diff --git a/src/TimerUnit.cpp b/src/TimerUnit.cpp index cdd1a0034..7fdb0f46d 100644 --- a/src/TimerUnit.cpp +++ b/src/TimerUnit.cpp @@ -84,7 +84,21 @@ void TimerUnit::uninstall(const QString& packageName) uninstallList.append(rootTimer); } } + // Re-entrant uninstall (#9337): a timer's own script (e.g. a package + // auto-updater calling uninstallPackage()) is removing its package while + // TTimer::execute() is still on the call stack for that timer. Deleting now + // would be a use-after-free, so defer to doCleanup() at depth 0. + if (mProcessingDepth > 0) { + for (auto timer : uninstallList) { + timer->setIsActive(false); + mCleanupSet.remove(timer); // keep the two deferred-delete paths disjoint + } + return; + } for (auto& timer : uninstallList) { + // in case the timer was also queued for the markCleanup()/doCleanup() + // path - deleting it here would otherwise leave a dangling pointer there: + mCleanupSet.remove(timer); delete timer; } uninstallList.clear(); @@ -423,14 +437,33 @@ int TimerUnit::getNewID() void TimerUnit::doCleanup() { + if (mProcessingDepth > 0) { + return; + } + + QSet deletedTimers; QMutableSetIterator itTimer(mCleanupSet); while (itTimer.hasNext()) { auto pTimer = itTimer.next(); // It is important to take the item OUT of the set before you delete // (and thus invalidate this pointer to) it...! itTimer.remove(); + deletedTimers.insert(pTimer); delete pTimer; } + // Flush the deletes uninstall() deferred (#9337). uninstallList is ordered + // children-before-parents and each ~Tree unlinks from its parent, so deleting + // children first empties the parent's child list (no double free); the seen + // set guards a node queued twice by re-entrant uninstalls and is shared with + // the mCleanupSet loop above so an object that somehow ended up in both + // containers cannot be freed twice. + for (auto timer : uninstallList) { + if (!deletedTimers.contains(timer)) { + deletedTimers.insert(timer); + delete timer; + } + } + uninstallList.clear(); } void TimerUnit::markCleanup(TTimer* pT) diff --git a/src/TimerUnit.h b/src/TimerUnit.h index 835b62145..332a9eb5b 100644 --- a/src/TimerUnit.h +++ b/src/TimerUnit.h @@ -37,10 +37,15 @@ class Host; class TTimer; class QTimer; -// Note: Unlike AliasUnit/TriggerUnit/KeyUnit, TimerUnit does not use mProcessingDepth -// because timers execute via Qt's event loop (QTimer signals), not synchronous loops. -// Protection against re-entrancy is provided by the guard in TTimer::execute() and -// by re-verifying timer existence after execute() in mudlet::slot_timerFires(). +// Note: mProcessingDepth tracks TTimer::execute() nesting (via begin/endProcessing()) +// so that uninstall() can defer deletion of a package's timers while one of them is +// still on the call stack - a timer script calling uninstallPackage() on its own +// package would otherwise free the very TTimer execute() is running on. Deferred +// items are flushed by doCleanup() once no timer script is executing - primarily +// by mudlet::slot_timerFires() right after it finishes with the fired timer, so +// the "uninstalled" objects do not outlive the event loop iteration. This +// complements the guard in TTimer::execute() and the re-verification of timer +// existence after execute() in mudlet::slot_timerFires(). class TimerUnit { friend class XMLexport; @@ -70,6 +75,12 @@ public: void reenableAllTriggers(); void markCleanup(TTimer*); void doCleanup(); + void beginProcessing() { ++mProcessingDepth; } + void endProcessing() + { + --mProcessingDepth; + Q_ASSERT(mProcessingDepth >= 0); + } std::tuple assembleReport(); int getNewID(); void uninstall(const QString&); @@ -104,6 +115,9 @@ private: int mMaxID = 0; bool mModuleMember = false; QSet mCleanupSet; + // > 0 whilst a TTimer::execute() is on the call stack; uninstall() and + // doCleanup() must not delete timers then - see the note above the class: + int mProcessingDepth = 0; int statsActiveItems = 0; int statsItemsTotal = 0; int statsTempItems = 0; diff --git a/src/TriggerUnit.cpp b/src/TriggerUnit.cpp index 44f2ec775..599dd2f68 100644 --- a/src/TriggerUnit.cpp +++ b/src/TriggerUnit.cpp @@ -104,6 +104,9 @@ void TriggerUnit::uninstall(const QString& packageName) return; } for (auto& trigger : uninstallList) { + // in case the trigger was also queued for the markCleanup()/doCleanup() + // path - deleting it here would otherwise leave a dangling pointer there: + mCleanupSet.remove(trigger); delete trigger; } uninstallList.clear(); @@ -514,17 +517,20 @@ void TriggerUnit::doCleanup() return; } + QSet deletedTriggers; QMutableSetIterator itTrigger(mCleanupSet); while (itTrigger.hasNext()) { auto pTrigger = itTrigger.next(); itTrigger.remove(); + deletedTriggers.insert(pTrigger); delete pTrigger; } // Flush the deletes uninstall() deferred (#9337). uninstallList is ordered // children-before-parents and each ~Tree unlinks from its parent, so deleting // children first empties the parent's child list (no double free); the seen - // set guards a node queued twice by re-entrant uninstalls. - QSet deletedTriggers; + // set guards a node queued twice by re-entrant uninstalls and is shared with + // the mCleanupSet loop above so an object that somehow ended up in both + // containers cannot be freed twice. for (auto trigger : uninstallList) { if (!deletedTriggers.contains(trigger)) { deletedTriggers.insert(trigger); diff --git a/src/dlgConnectionProfiles.cpp b/src/dlgConnectionProfiles.cpp index 498be5df9..0611b1ce5 100644 --- a/src/dlgConnectionProfiles.cpp +++ b/src/dlgConnectionProfiles.cpp @@ -1257,7 +1257,9 @@ void dlgConnectionProfiles::slot_itemClicked(QListWidgetItem* pItem) QDir dir(mudlet::getMudletPath(enums::profileXmlFilesPath, profile_name)); dir.setSorting(QDir::Time); - const QStringList entries = dir.entryList(QDir::Files | QDir::NoDotAndDotDot, QDir::Time); + // Only offer real profile saves (*.xml) as history entries; leftover QSaveFile + // temporaries from an interrupted save (e.g. "....xml.AbCdEf") must not be loadable + const QStringList entries = dir.entryList(QStringList{qsl("*.xml")}, QDir::Files | QDir::NoDotAndDotDot, QDir::Time); for (const auto& entry : entries) { const QRegularExpression rx(qsl("(\\d+)\\-(\\d+)\\-(\\d+)#(\\d+)\\-(\\d+)\\-(\\d+).xml")); @@ -1914,7 +1916,9 @@ void dlgConnectionProfiles::copyProfileSettingsOnly(const QString& oldname, cons const QDir oldProfiledir(mudlet::getMudletPath(enums::profileXmlFilesPath, oldname)); const QDir newProfiledir(mudlet::getMudletPath(enums::profileXmlFilesPath, newname)); newProfiledir.mkpath(newProfiledir.absolutePath()); - QStringList entries = oldProfiledir.entryList(QDir::Files | QDir::NoDotAndDotDot, QDir::Time); + // Only copy from a real profile save (*.xml): the newest file of any name could + // be a leftover QSaveFile temporary from an interrupted save (e.g. "....xml.AbCdEf") + QStringList entries = oldProfiledir.entryList(QStringList{qsl("*.xml")}, QDir::Files | QDir::NoDotAndDotDot, QDir::Time); if (entries.empty()) { return; } diff --git a/src/dlgTriggerEditor.cpp b/src/dlgTriggerEditor.cpp index d42701828..ef9eb02f2 100644 --- a/src/dlgTriggerEditor.cpp +++ b/src/dlgTriggerEditor.cpp @@ -6722,6 +6722,13 @@ void dlgTriggerEditor::saveScript() mpTextUndoStack->clear(); } } + + // If pT's own body uninstalled its package during the compile above, the delete + // was deferred (see TScript::compileScript / ScriptUnit::uninstall). We are now + // done with pT, so flush it before returning to the event loop - otherwise the + // 0ms save uninstallPackage() queued would serialize the "uninstalled" script + // back into the profile: + mpHost->getScriptUnit()->doCleanup(); } void dlgTriggerEditor::clearEditorNotification() diff --git a/src/mudlet.cpp b/src/mudlet.cpp index e90fd23c8..c14b87e62 100644 --- a/src/mudlet.cpp +++ b/src/mudlet.cpp @@ -2400,6 +2400,14 @@ void mudlet::slot_timerFires() pTT->start(); } + // Flush any deletes TimerUnit::uninstall() deferred whilst execute() was + // on the stack (a timer script uninstalling its own package). Doing it + // here - after the last use of pTT - keeps the window in which the + // "uninstalled" timers linger down to this event loop iteration, before + // the profile save that Host::uninstallPackage() queues with a 0ms + // single-shot can serialize them back into the profile: + pHost->getTimerUnit()->doCleanup(); + // Okay now we've found it we are done: return; } @@ -6078,11 +6086,23 @@ Host* mudlet::loadProfile(const QString& profile_name, const bool playOnline, co const QString folder = getMudletPath(enums::profileXmlFilesPath, profile_name); QDir dir(folder); dir.setSorting(QDir::Time); - QStringList entries = dir.entryList(QDir::Files, QDir::Time); + // Only consider profile saves (*.xml): a crash during a save can leave behind + // an empty QSaveFile temporary (e.g. "2026-01-01#12-00-00.xml.AbCdEf") as the + // newest file, and loading that instead of the newest real save presents the + // profile with all of its triggers/scripts seemingly wiped out + QStringList entries = dir.entryList(QStringList{qsl("*.xml")}, QDir::Files, QDir::Time); // pre-install packages when loading this profile for the first time bool preInstallPackages = false; pHost->hideMudletsVariables(); - if (entries.isEmpty()) { + // NB: an explicitly requested saveFileName is honored even when no *.xml + // is present - failing to open it then reports a proper load error rather + // than silently starting a fresh profile: + if (entries.isEmpty() && saveFileName.isEmpty()) { + if (!dir.entryList(QDir::Files | QDir::NoDotAndDotDot).isEmpty()) { + qWarning().nospace().noquote() << "mudlet::loadProfile(" << profile_name << ", ...) WARNING - profile directory \"" << folder + << "\" contains files but no completed (*.xml) save; treating the profile as new. An interrupted save may have left " + "a recoverable QSaveFile temporary behind."; + } preInstallPackages = true; pHost->mLoadedOk = true; pHost->mMapInfoContributors.insert(qsl("Short")); diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index 727bf3a42..ff340043d 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -27,6 +27,8 @@ set(FUNCTIONAL_TEST_SOURCES SgrUnderlineStyleTest.cpp LogRestartDuplicateLineTest.cpp ProfileRoundTripTest.cpp + ProfileLoadTempFileTest.cpp + PackageSelfUninstallTest.cpp MapRoundTripTest.cpp UndoServerWrapTest.cpp ) diff --git a/test/functional_tests/PackageSelfUninstallTest.cpp b/test/functional_tests/PackageSelfUninstallTest.cpp new file mode 100644 index 000000000..59a212c55 --- /dev/null +++ b/test/functional_tests/PackageSelfUninstallTest.cpp @@ -0,0 +1,278 @@ +/*************************************************************************** + * Copyright (C) 2026 by Mudlet Developers * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +/* + * Regression test for use-after-free when a package uninstalls itself from its + * own timer script or event-handler script (#9337 class, the remaining timer + * and script cases). + * + * Package auto-updaters commonly call uninstallPackage()+installPackage() on + * their own package from one of the package's own items. Since the + * *Unit::uninstall() methods started deleting items immediately (instead of + * just unregistering them), doing that from a timer deleted the very TTimer + * whose execute() was still on the call stack; doing it from an event handler + * deleted TScript objects that Host::raiseEvent() was still iterating over; and + * doing it from a script's top-level body deleted the very TScript that + * compileScript() was in the middle of compiling - heap corruption every way. + * TriggerUnit/AliasUnit/KeyUnit gained a processing-depth deferral in #9383; + * this covers TimerUnit and ScriptUnit (both the event-dispatch and the + * compile-time body paths). + * + * Under AddressSanitizer the pre-fix code aborts with heap-use-after-free + * inside TTimer::execute() / Host::raiseEvent() / TScript::compileScript(); with + * the deferral in place all scenarios complete cleanly. + * + * Run with: ctest -R PackageSelfUninstallTest -V + */ + +#include + +#include + +#include "Host.h" +#include "HostManager.h" +#include "MudletInstanceCoordinator.h" +#include "ScriptUnit.h" +#include "TEvent.h" +#include "TScript.h" +#include "TTimer.h" +#include "TimerUnit.h" +#include "mudlet.h" + +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); +void initializeQRCResourcesForPackageSelfUninstallTest(); + +class PackageSelfUninstallTest : public QObject +{ + Q_OBJECT + +private: + const QString mProfileName = qsl("PackageSelfUninstall-Test"); + QTemporaryDir mConfigDir; + QByteArray mSavedXdg; + Host* mpHost = nullptr; + +private slots: + void initTestCase() + { + initializeQRCResourcesForPackageSelfUninstallTest(); + + // Keep the test hermetic: point the config dir resolution at a + // temporary directory instead of the user's real profiles. + QVERIFY(mConfigDir.isValid()); + mSavedXdg = qgetenv("XDG_CONFIG_HOME"); + QVERIFY(QDir().mkpath(qsl("%1/mudlet/profiles").arg(mConfigDir.path()))); + qputenv("XDG_CONFIG_HOME", mConfigDir.path().toUtf8()); + + mudlet::start(); + mudlet::self()->setupConfig(); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique("MudletInstanceCoordinator")); + mudlet::self()->init(); + mudlet::self()->setStorePasswordsSecurely(false); + + QVERIFY2(mudlet::self()->getHostManager().addHost(mProfileName, QString(), QString(), QString()), "failed to create the Host"); + mpHost = mudlet::self()->getHostManager().getHost(mProfileName); + QVERIFY(mpHost); + // A bare Host blocks script compilation until the full profile boot + // would normally clear this; the test's scripts need to compile: + mpHost->mBlockScriptCompile = false; + // NB: mLoadedOk is left false on purpose - the deferred saveProfile() + // that uninstallPackage() schedules then declines to run, which this + // console-less test Host could not service anyway. + } + + void cleanupTestCase() + { + mpHost = nullptr; + delete mudlet::self(); + mSavedXdg.isNull() ? qunsetenv("XDG_CONFIG_HOME") : qputenv("XDG_CONFIG_HOME", mSavedXdg); + } + + // A package's event-handler script uninstalls its own package while + // Host::raiseEvent() is mid-dispatch. The second handler in the same + // package is what the pre-fix code would have called through a freed + // TScript pointer. + void test_scriptEventHandlerSelfUninstall() + { + const QString packageName = qsl("selfuninstall-script"); + mpHost->mInstalledPackages << packageName; + + auto pUninstaller = new TScript(nullptr, mpHost); + mpHost->getScriptUnit()->registerScript(pUninstaller); + pUninstaller->mPackageName = packageName; + pUninstaller->setName(qsl("selfUninstallHandler")); + QVERIFY2(pUninstaller->setScript(qsl("function selfUninstallHandler(event)\n uninstallPackage(\"%1\")\nend\n").arg(packageName)), "uninstaller handler script failed to compile"); + pUninstaller->setEventHandlerList(QStringList{qsl("testSelfUninstallEvent")}); + pUninstaller->setIsActive(true); + + auto pBystander = new TScript(nullptr, mpHost); + mpHost->getScriptUnit()->registerScript(pBystander); + pBystander->mPackageName = packageName; + pBystander->setName(qsl("selfUninstallBystander")); + QVERIFY2(pBystander->setScript(qsl("function selfUninstallBystander(event)\nend\n")), "bystander handler script failed to compile"); + pBystander->setEventHandlerList(QStringList{qsl("testSelfUninstallEvent")}); + pBystander->setIsActive(true); + + TEvent event{}; + event.mArgumentList.append(qsl("testSelfUninstallEvent")); + event.mArgumentTypeList.append(ARGUMENT_TYPE_STRING); + // Pre-fix this dispatch freed both TScripts under raiseEvent()'s feet: + mpHost->raiseEvent(event); + + QVERIFY2(!mpHost->mInstalledPackages.contains(packageName), "package was not uninstalled"); + // The deferred deletes must have been flushed once the dispatch ended: + QVERIFY2(mpHost->getScriptUnit()->findItems(qsl("selfUninstallHandler")).empty(), "uninstalled script is still registered"); + QVERIFY2(mpHost->getScriptUnit()->findItems(qsl("selfUninstallBystander")).empty(), "uninstalled script is still registered"); + } + + // A package script's TOP-LEVEL body (not an event handler) uninstalls its own + // package while it is being compiled - the path profile boot and reset take + // when they run "all the Lua code outside of functions" via ScriptUnit::compileAll(). + // Pre-fix, ScriptUnit::uninstall() deleted the script immediately: compileScript() + // then wrote to the freed TScript (heap-use-after-free WRITE at TScript::compileScript), + // and compileAll()'s range-for walked onto the freed std::list node it had unlinked. + void test_scriptBodySelfUninstallOnCompile() + { + const QString packageName = qsl("selfuninstall-script-compile"); + mpHost->mInstalledPackages << packageName; + + // Defer compilation so the bodies run through compileAll() below rather than + // from setScript() here, mirroring how a freshly loaded package's scripts are + // compiled at profile boot (mudlet::loadProfile) and reset (Host::resetProfile_phase2): + mpHost->mBlockScriptCompile = true; + + auto pUninstaller = new TScript(nullptr, mpHost); + mpHost->getScriptUnit()->registerScript(pUninstaller); + pUninstaller->mPackageName = packageName; + pUninstaller->setName(qsl("selfUninstallOnCompile")); + // A bare uninstallPackage() at the top level runs the moment the script is compiled: + pUninstaller->setScript(qsl("uninstallPackage(\"%1\")").arg(packageName)); + pUninstaller->setIsActive(true); + + // A second script in the same package, registered AFTER the uninstaller, is + // the node the pre-fix immediate delete unlinks from under compileAll()'s loop: + auto pBystander = new TScript(nullptr, mpHost); + mpHost->getScriptUnit()->registerScript(pBystander); + pBystander->mPackageName = packageName; + pBystander->setName(qsl("selfUninstallCompileBystander")); + pBystander->setScript(qsl("local noop = true\n")); + pBystander->setIsActive(true); + + mpHost->mBlockScriptCompile = false; + // Pre-fix this trips heap-use-after-free; post-fix the delete is deferred until + // after the loop and then flushed by compileAll(): + mpHost->getScriptUnit()->compileAll(); + + QVERIFY2(!mpHost->mInstalledPackages.contains(packageName), "package was not uninstalled"); + // The deferred deletes must have been flushed at the end of compileAll(): + QVERIFY2(mpHost->getScriptUnit()->findItems(qsl("selfUninstallOnCompile")).empty(), "uninstalled script is still registered"); + QVERIFY2(mpHost->getScriptUnit()->findItems(qsl("selfUninstallCompileBystander")).empty(), "uninstalled bystander script is still registered"); + } + + // A package script's top-level body uninstalls its own package from a plain + // setScript() compile - the path permScript()/setScript() take when invoked from + // an alias, key or the command line, none of which sit inside compileAll(), the + // editor's saveScript(), or raiseEvent(). Pre-fix this hit the same + // heap-use-after-free in compileScript() as the compileAll() case. The compile + // guard defers the delete here too; because this entry point has no synchronous + // flush of its own, the deferred script lingers (deactivated) until a catch-all + // flush - ScriptUnit::doCleanup() via Host::incomingStreamProcessor()/ + // slot_purgeTemps(), or the doCleanup() Host::uninstallPackage()'s queued save runs + // - collects it, which must happen without leaking or double-freeing. + void test_scriptBodySelfUninstallFromSetScript() + { + const QString packageName = qsl("selfuninstall-script-setscript"); + mpHost->mInstalledPackages << packageName; + + auto pUninstaller = new TScript(nullptr, mpHost); + mpHost->getScriptUnit()->registerScript(pUninstaller); + pUninstaller->mPackageName = packageName; + pUninstaller->setName(qsl("selfUninstallFromSetScript")); + // mBlockScriptCompile is false, so setScript() compiles and runs the top-level + // body immediately - uninstallPackage() fires from inside compileScript(): + pUninstaller->setScript(qsl("uninstallPackage(\"%1\")").arg(packageName)); + + QVERIFY2(!mpHost->mInstalledPackages.contains(packageName), "package was not uninstalled"); + + // No synchronous flush point covers this entry, so the script is still + // registered (deferred, deactivated) right after setScript() returns: + QVERIFY2(!mpHost->getScriptUnit()->findItems(qsl("selfUninstallFromSetScript")).empty(), "self-uninstalling script should still be deferred, not yet deleted"); + + // The catch-all flush (as wired into incomingStreamProcessor()/slot_purgeTemps()) + // must then collect it cleanly - no leak, no double-free: + mpHost->getScriptUnit()->doCleanup(); + QVERIFY2(mpHost->getScriptUnit()->findItems(qsl("selfUninstallFromSetScript")).empty(), "deferred uninstalled script was not flushed"); + } + + // A package's timer script uninstalls its own package while + // TTimer::execute() is still on the call stack for that timer. Pre-fix, + // execute() would resume on a freed `this`. + void test_timerScriptSelfUninstall() + { + const QString packageName = qsl("selfuninstall-timer"); + mpHost->mInstalledPackages << packageName; + + auto pTimer = new TTimer(qsl("selfUninstallTimer"), QTime(0, 0, 0, 250), mpHost); + mpHost->getTimerUnit()->registerTimer(pTimer); + pTimer->mPackageName = packageName; + // The trailing error() is what makes this a genuine regression test: after + // uninstallPackage() has (pre-fix) freed this timer, the error aborts the + // Lua call so it returns false, and TTimer::execute() then resumes past the + // call and reads the freed `this` at `mpQTimer->stop()` - the heap-use-after-free + // the deferral prevents. Without the error the call returns cleanly and + // execute() never touches `this` again, so the bug would go undetected. + QVERIFY2(pTimer->setScript(qsl("uninstallPackage(\"%1\")\nerror(\"boom\")").arg(packageName)), "timer script failed to compile"); + pTimer->setIsActive(true); + pTimer->enableTimer(); + + // Let the timer fire and take its package (and itself) down: + QTRY_VERIFY_WITH_TIMEOUT(!mpHost->mInstalledPackages.contains(packageName), 5000); + + // Allow any queued activity (the declined deferred save, further timer + // ticks) to surface problems: + QTest::qWait(500); + // mudlet::slot_timerFires() flushes the deferred delete as soon as the + // uninstalling timer's execute() has finished, so by now the timer must + // be properly gone - not lingering deactivated where the next profile + // save would serialize it back in: + QVERIFY2(!mpHost->getTimerUnit()->findFirstTimer(qsl("selfUninstallTimer")), "uninstalled package timer is still registered"); + } +}; + +void initializeQRCResourcesForPackageSelfUninstallTest() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +#include "PackageSelfUninstallTest.moc" +QTEST_MAIN(PackageSelfUninstallTest) diff --git a/test/functional_tests/ProfileLoadTempFileTest.cpp b/test/functional_tests/ProfileLoadTempFileTest.cpp new file mode 100644 index 000000000..87e1ef0b4 --- /dev/null +++ b/test/functional_tests/ProfileLoadTempFileTest.cpp @@ -0,0 +1,193 @@ +/*************************************************************************** + * Copyright (C) 2026 by Mudlet Developers * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +/* + * Regression test for profile data-loss after a crash during save. + * + * Profile saves go through QSaveFile: the data is written to a randomly named + * temporary next to the target (".xml.AbCdEf") which is renamed over the + * real file on commit. If Mudlet dies mid-save, that temporary is left behind, + * empty, as the NEWEST file in the profile's current/ directory. + * + * mudlet::loadProfile() used to load the newest file of ANY name from + * current/, so after such a crash it would "load" the empty leftover instead + * of the newest real save: the profile opened with its connection settings + * (stored in separate files) intact but every trigger/alias/script seemingly + * wiped out. This test crashes a save in effigy - by planting an empty + * QSaveFile-style leftover newer than a real save - and verifies the loader + * skips it and restores the real data. + * + * Run with: ctest -R ProfileLoadTempFileTest -V + */ + +#include + +#include + +#include "Host.h" +#include "HostManager.h" +#include "MudletInstanceCoordinator.h" +#include "TTrigger.h" +#include "TriggerUnit.h" +#include "mudlet.h" + +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); +void initializeQRCResourcesForProfileLoadTempFileTest(); + +namespace { +// A minimal but complete profile save holding one trigger - the "guts" whose +// survival the test asserts: +const QString scmTriggerName = qsl("synthetic data-loss canary"); +const QString scmProfileXml = qsl(R"( + + + + +synthetic data-loss canary + +0 +0 +0 + + +#ff0000 +#ffff00 + +#000000 +#000000 + +^synthetic pattern$ + + +1 + + + + +)"); +} // namespace + +class ProfileLoadTempFileTest : public QObject +{ + Q_OBJECT + +private: + const QString mProfileName = qsl("ProfileLoadTempFile-Test"); + QTemporaryDir mConfigDir; + QByteArray mSavedXdg; + + static bool setModificationTime(const QString& path, const QDateTime& when) + { + QFile file(path); + if (!file.open(QIODevice::ReadWrite)) { + return false; + } + return file.setFileTime(when, QFileDevice::FileModificationTime); + } + + // setupConfig() prefers a portable.txt marker over the XDG override; skip + // rather than report a baffling failure if one is present: + bool portableMarkerPresent() const + { + return QFileInfo::exists(qsl("%1/portable.txt").arg(QCoreApplication::applicationDirPath())) || QFileInfo::exists(qsl("%1/.config/mudlet/portable.txt").arg(QDir::homePath())); + } + +private slots: + void initTestCase() + { + initializeQRCResourcesForProfileLoadTempFileTest(); + + // Keep the test hermetic: point the config dir resolution at a + // temporary directory instead of the user's real profiles. + QVERIFY(mConfigDir.isValid()); + mSavedXdg = qgetenv("XDG_CONFIG_HOME"); + QVERIFY(QDir().mkpath(qsl("%1/mudlet/profiles").arg(mConfigDir.path()))); + qputenv("XDG_CONFIG_HOME", mConfigDir.path().toUtf8()); + + mudlet::start(); + mudlet::self()->setupConfig(); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique("MudletInstanceCoordinator")); + mudlet::self()->init(); + mudlet::self()->setStorePasswordsSecurely(false); + + if (portableMarkerPresent()) { + QSKIP("portable.txt marker present - config dir cannot be redirected for this test"); + } + QVERIFY2(mudlet::getMudletPath(enums::profilesPath).startsWith(mConfigDir.path()), "test config dir redirection did not take effect"); + } + + void cleanupTestCase() + { + delete mudlet::self(); + mSavedXdg.isNull() ? qunsetenv("XDG_CONFIG_HOME") : qputenv("XDG_CONFIG_HOME", mSavedXdg); + } + + void test_loaderSkipsLeftoverSaveTemporary() + { + // 1. A real save, holding one trigger: + const QString folder = mudlet::getMudletPath(enums::profileXmlFilesPath, mProfileName); + QVERIFY(QDir().mkpath(folder)); + const QString xmlPath = qsl("%1/2020-01-01#00-00-00.xml").arg(folder); + { + QFile xmlFile(xmlPath); + QVERIFY(xmlFile.open(QIODevice::WriteOnly | QIODevice::Text)); + QVERIFY(xmlFile.write(scmProfileXml.toUtf8()) > 0); + } + + // 2. What a crash mid-save leaves behind: an empty QSaveFile temporary + // that is the newest file in current/: + const QString leftoverPath = qsl("%1/2020-01-02#00-00-00.xml.AbCdEf").arg(folder); + { + QFile leftover(leftoverPath); + QVERIFY(leftover.open(QIODevice::WriteOnly)); + } + const QDateTime now = QDateTime::currentDateTime(); + QVERIFY(setModificationTime(xmlPath, now.addSecs(-3600))); + QVERIFY(setModificationTime(leftoverPath, now)); + + // 3. Load the profile through the production loader; it must pick the + // real save, not the newer empty leftover: + Host* pHost = mudlet::self()->loadProfile(mProfileName, false); + QVERIFY(pHost); + QVERIFY2(pHost->mLoadedOk, "loader tried to load a leftover QSaveFile temporary instead of the newest real save"); + QVERIFY2(pHost->getTriggerUnit()->findTrigger(scmTriggerName), "trigger from the real save is missing - the profile lost its data"); + } +}; + +void initializeQRCResourcesForProfileLoadTempFileTest() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +#include "ProfileLoadTempFileTest.moc" +QTEST_MAIN(ProfileLoadTempFileTest) From 41f61e969882b2537c81e3e0b8121f1e9fcbc5b7 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Thu, 30 Jul 2026 12:02:32 +0200 Subject: [PATCH 021/155] Fix: crash when a button uninstalls its own package (#9558) #### Brief overview of PR changes/additions A toolbar or menu button whose Lua script calls `uninstallPackage()` on its own package used to crash Mudlet. `ActionUnit::uninstall()` deleted the package's buttons immediately, but the clicked button is still inside `TAction::execute()`, which reads `this->mpHost` (to restore command-line focus) *after* the script returns - a heap-use-after-free. This applies the same processing-depth deferral already used for triggers/aliases/keys and timers/scripts: while a button's script is running, `uninstall()` deactivates and queues that package's actions instead of deleting them, and the delete happens later in `doCleanup()` once `execute()` has unwound. `ActionUnit` was the last object unit still deleting immediately. The queued deletes are flushed by the button dispatchers once the click returns and by the existing per-line / periodic `doCleanup()` calls in `Host`, and a seen-set guards against a double free from a re-entrant uninstall. #### Motivation for adding to Mudlet It is a hard crash reachable with a completely normal setup - a "reload/update this package" button that reinstalls itself is a common pattern. #### Other info (issues closed, discussion etc) Completes the self-uninstall use-after-free hardening across all object units - a follow-up to #9557 (timers/scripts) and #9383 (triggers/aliases/keys); actions were the one remaining unguarded unit. The crash is reported in Sentry as MUDLET-32 / MUDLET-2S / MUDLET-48. **Test case:** `test/functional_tests/ActionSelfUninstallTest.cpp` (Qt Test, built with AddressSanitizer) builds a synthetic package whose toolbar button uninstalls its own package, gives it a real toolbar widget, invokes the button, and asserts no crash, the package removed, and the deferred action freed cleanly with no double free. It trips a heap-use-after-free in `TAction::execute()` on the pre-fix code and is ASan-clean with the fix. To reproduce by hand: 1. Create a package containing one button whose script is `uninstallPackage("")`. 2. Click the button. 3. Before this PR: Mudlet crashes. After: the package uninstalls cleanly and focus returns to the command line. Assisted-by: Claude:claude-opus-4-8 Signed-off-by: Vadim Peretokin --- src/ActionUnit.cpp | 42 ++- src/ActionUnit.h | 12 + src/EAction.cpp | 5 + src/Host.cpp | 3 + src/TAction.cpp | 14 + src/TEasyButtonBar.cpp | 14 + src/TToolBar.cpp | 15 + .../ActionSelfUninstallTest.cpp | 263 ++++++++++++++++++ test/functional_tests/CMakeLists.txt | 1 + 9 files changed, 367 insertions(+), 2 deletions(-) create mode 100644 test/functional_tests/ActionSelfUninstallTest.cpp diff --git a/src/ActionUnit.cpp b/src/ActionUnit.cpp index c623cbcdf..1eb4f2702 100644 --- a/src/ActionUnit.cpp +++ b/src/ActionUnit.cpp @@ -30,6 +30,8 @@ #include "TToolBar.h" #include "mudlet.h" +#include + #include /* We need an explicit constructor in this file as the Host class is forward @@ -75,12 +77,48 @@ void ActionUnit::uninstall(const QString& packageName) uninstallList.append(rootAction); } } - for (auto& action : uninstallList) { - delete action; + // Re-entrant uninstall (#9337): a button's own script (e.g. a package + // auto-updater calling uninstallPackage()) is removing its package while + // TAction::execute() is still on the call stack for that button. Deleting + // now would be a use-after-free, so defer to doCleanup() at depth 0. + // Deactivating stops the buttons from firing again in the meantime. + if (mProcessingDepth > 0) { + for (auto action : uninstallList) { + action->setIsActive(false); + } + return; + } + // Not inside a button script - delete now. Route through doCleanup() rather + // than an inline loop so the same seen-set guards against a double free if a + // re-entrant uninstall of the same package queued any action twice. + doCleanup(); +} + +void ActionUnit::doCleanup() +{ + if (mProcessingDepth > 0) { + return; + } + // Flush the deletes uninstall() deferred (#9337). uninstallList is ordered + // children-before-parents and each ~Tree unlinks from its parent, so deleting + // children first empties the parent's child list (no double free); the seen + // set guards a node queued twice by re-entrant uninstalls. + QSet deletedActions; + for (auto action : uninstallList) { + if (!deletedActions.contains(action)) { + deletedActions.insert(action); + delete action; + } } uninstallList.clear(); } +void ActionUnit::endProcessing() +{ + --mProcessingDepth; + Q_ASSERT(mProcessingDepth >= 0); +} + void ActionUnit::compileAll() { for (auto action : mActionRootNodeList) { diff --git a/src/ActionUnit.h b/src/ActionUnit.h index 8328e1b4c..435894fb6 100644 --- a/src/ActionUnit.h +++ b/src/ActionUnit.h @@ -67,6 +67,15 @@ public: int getNewID(); void uninstall(const QString&); void _uninstall(TAction* pChild, const QString& packageName); + void doCleanup(); + void beginProcessing() { ++mProcessingDepth; } + // Only decrements the depth - deliberately no doCleanup() here: that would + // delete `this` (and other deferred actions) while a caller of + // TAction::execute() may still hold the pointer. Deferred deletes are + // flushed once no button script is executing - by the dispatchers right + // after execute() returns and by Host's catch-all doCleanup() calls. + void endProcessing(); + int processingDepth() const { return mProcessingDepth; } void updateAllToolbars(); std::list> getToolBarList() { return mToolBarList; } TAction* getHeadAction(TToolBar*); @@ -92,6 +101,9 @@ private: QMap mActionMap; std::list mActionRootNodeList; int mMaxID = 0; + // > 0 whilst a TAction::execute() is on the call stack; uninstall() and + // doCleanup() must not delete actions then - see ActionUnit::uninstall(): + int mProcessingDepth = 0; bool mModuleMember = false; std::list> mToolBarList; std::list> mEasyButtonBarList; diff --git a/src/EAction.cpp b/src/EAction.cpp index 265303974..fa0a64ec4 100644 --- a/src/EAction.cpp +++ b/src/EAction.cpp @@ -42,4 +42,9 @@ void EAction::slot_execute(bool checked) { mpHost->getActionUnit()->getAction(mID)->mButtonState = checked; mpHost->getActionUnit()->getAction(mID)->execute(); + // Deliberately no doCleanup() here: a menu item runs nested inside a bar's + // slot_pressed() (TEasyButtonBar::showMenu() spins a modal event loop), which + // dereferences its own button after this returns - flushing here could free + // an action that ancestor frame still holds. The deferred deletes are cleared + // by that ancestor bar dispatcher and by Host's catch-all doCleanup() calls. } diff --git a/src/Host.cpp b/src/Host.cpp index 43b9fb65b..21927b413 100644 --- a/src/Host.cpp +++ b/src/Host.cpp @@ -896,6 +896,7 @@ void Host::resetProfile_phase2() mTimerUnit.doCleanup(); mTriggerUnit.doCleanup(); mKeyUnit.doCleanup(); + mActionUnit.doCleanup(); mpConsole->resetMainConsole(); // Drain queued DeferredDelete events so old TLabel destructors run their // luaL_unref against the still-live Lua state. Without this, those unrefs @@ -1817,6 +1818,7 @@ void Host::incomingStreamProcessor(const QString& data, int line) mTimerUnit.doCleanup(); mTriggerUnit.doCleanup(); mKeyUnit.doCleanup(); + mActionUnit.doCleanup(); // ScriptUnit defers deletes too (a package script uninstalling its own package // mid-compile or mid-event-dispatch), so flush it here alongside the others: mScriptUnit.doCleanup(); @@ -1831,6 +1833,7 @@ void Host::slot_purgeTemps() mTimerUnit.doCleanup(); mTriggerUnit.doCleanup(); mKeyUnit.doCleanup(); + mActionUnit.doCleanup(); mScriptUnit.doCleanup(); } diff --git a/src/TAction.cpp b/src/TAction.cpp index 2dcd88459..89ea22b98 100644 --- a/src/TAction.cpp +++ b/src/TAction.cpp @@ -33,6 +33,8 @@ #include "TToolBar.h" #include "mudlet.h" +#include + TAction::TAction(TAction* parent, Host* pHost) : Tree(parent) , mpHost(pHost) @@ -161,6 +163,18 @@ void TAction::execute() } } + // Whilst this frame is on the stack ActionUnit::uninstall() must defer + // deleting this profile's actions: the script run below can uninstall its + // own package (e.g. a "reload package" button calling uninstallPackage()) + // and freeing this TAction mid-execute() is a use-after-free - the members + // read after the call would be dangling. The guard defers that delete past + // the last member access here; see ActionUnit::mProcessingDepth. + ActionUnit* pUnit = mpHost->getActionUnit(); + pUnit->beginProcessing(); + const auto processingGuard = qScopeGuard([pUnit] { + pUnit->endProcessing(); + }); + mpHost->mLuaInterpreter.call(mFuncName, mName); // move focus back to the active console / command line: mpHost->setFocusOnHostActiveCommandLine(); diff --git a/src/TEasyButtonBar.cpp b/src/TEasyButtonBar.cpp index c3d90a506..d2e7d0e97 100644 --- a/src/TEasyButtonBar.cpp +++ b/src/TEasyButtonBar.cpp @@ -28,6 +28,7 @@ #include "TFlipButton.h" #include +#include TEasyButtonBar::TEasyButtonBar(TAction* pA, QString name, QWidget* pW) @@ -156,6 +157,19 @@ void TEasyButtonBar::slot_pressed(const bool isChecked) TAction* pA = pB->mpTAction; + // Hold off ActionUnit deletes for this whole slot: showMenu() below blocks in + // a modal event loop in which a menu item's script (or inbound game data) can + // uninstall pA's own package. beginProcessing() keeps that delete deferred - + // even against a Host catch-all doCleanup() firing at depth 0 mid-loop - so pA + // survives every dereference here; the scope guard then flushes once, after pA + // is no longer touched (see ActionUnit::uninstall()): + ActionUnit* pActionUnit = pA->mpHost->getActionUnit(); + pActionUnit->beginProcessing(); + const auto processingGuard = qScopeGuard([pActionUnit] { + pActionUnit->endProcessing(); + pActionUnit->doCleanup(); + }); + // NOTE: This function blocks until an item is selected from the menu, and, // as the action to "pop-up" the menu is the same as "buttons" use to // perform their command/scripts is why "commands" are (no longer) permitted diff --git a/src/TToolBar.cpp b/src/TToolBar.cpp index b532a746b..a481bfaae 100644 --- a/src/TToolBar.cpp +++ b/src/TToolBar.cpp @@ -29,6 +29,8 @@ #include "TFlipButton.h" #include "mudlet.h" +#include + TToolBar::TToolBar(Host* pHost, TAction* pA, const QString& name, QWidget* pW) : QDockWidget(pW) @@ -190,6 +192,19 @@ void TToolBar::slot_pressed(const bool isChecked) } TAction* pA = pB->mpTAction; + + // Hold off ActionUnit deletes for this whole slot so a self-uninstall (the + // button's own script removing its package) cannot free pA out from under the + // dereferences below, even if a Host catch-all doCleanup() fires at depth 0 + // mid-slot. The scope guard flushes once at the end, after pA's last use (see + // ActionUnit::uninstall()): + ActionUnit* pActionUnit = mpHost->getActionUnit(); + pActionUnit->beginProcessing(); + const auto processingGuard = qScopeGuard([pActionUnit] { + pActionUnit->endProcessing(); + pActionUnit->doCleanup(); + }); + // NOTE: This function blocks until an item is selected from the menu, and, // as the action to "pop-up" the menu is the same as "buttons" use to // perform their command/scripts is why "commands" are (no longer) permitted diff --git a/test/functional_tests/ActionSelfUninstallTest.cpp b/test/functional_tests/ActionSelfUninstallTest.cpp new file mode 100644 index 000000000..f520ad078 --- /dev/null +++ b/test/functional_tests/ActionSelfUninstallTest.cpp @@ -0,0 +1,263 @@ +/*************************************************************************** + * Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +#include + +#include + +#include "ActionUnit.h" +#include "Host.h" +#include "MudletInstanceCoordinator.h" +#include "TAction.h" +#include "TFlipButton.h" +#include "TLuaInterpreter.h" +#include "TMainConsole.h" +#include "TelnetServerStub.h" +#include "ctelnet.h" +#include "dlgConnectionProfiles.h" +#include "mudlet.h" + +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); +void initializeQRCResources(); + +// Regression tests for the self-uninstall use-after-free: a package toolbar +// button whose Lua script calls uninstallPackage() on its own package used to +// free the very TAction that TAction::execute() was running on, which then read +// this->mpHost after the Lua call returned (heap-use-after-free). ActionUnit now +// defers that delete until execute() has unwound. +class ActionSelfUninstallTest : public QObject +{ + Q_OBJECT + +private: + TelnetServerStub* mpServer = nullptr; + const QString mpHostname = "Test-ActionSelfUninstall"; + const QString mpPort = "4009"; + const QString mpLocalhost = "localhost"; + + // Builds a package the way an installed package with a toolbar button is laid + // out: a master-folder root carrying the package name, a toolbar under it (the + // TEasyButtonBar, on the top bar via mLocation 0), and the actual button under + // that. updateAllToolbars() then gives the button a real TFlipButton, letting a + // test drive the genuine click dispatch path. registerAction() assigns the ids, + // so it must run before setScript() (which bakes the id into the Lua funcname). + // Returns the leaf button whose script uninstalls the package. + TAction* buildSelfUninstallingPackage(Host* host, const QString& packageName) + { + auto* actionUnit = host->getActionUnit(); + + auto* master = new TAction(packageName, host); + master->mPackageName = packageName; + master->mModuleMasterFolder = true; + master->setIsFolder(true); + master->setIsActive(true); + actionUnit->registerAction(master); + + auto* toolbar = new TAction(master, host); + toolbar->setName(qsl("selfUninstallToolbar")); + toolbar->mLocation = 0; + toolbar->setIsActive(true); + actionUnit->registerAction(toolbar); + + auto* button = new TAction(toolbar, host); + button->setName(qsl("selfUninstallButton")); + button->setIsActive(true); + actionUnit->registerAction(button); + button->setScript(qsl("uninstallPackage([[%1]])").arg(packageName)); + + host->mInstalledPackages << packageName; + return button; + } + + TFlipButton* findButtonWidget(Host* host, const TAction* action) + { + // TFlipButton has no Q_OBJECT, so findChildren<> it as its QPushButton base + // and downcast. + for (auto* pushButton : host->mpConsole->findChildren()) { + auto* pB = dynamic_cast(pushButton); + if (pB && pB->mpTAction == action) { + return pB; + } + } + return nullptr; + } + +private slots: + void initTestCase() { initializeQRCResources(); } + + void init() + { + mpServer = new TelnetServerStub(qApp); + mpServer->start(mpLocalhost, mpPort.toUShort()); + mudlet::start(); + mudlet::self()->setupConfig(); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique("MudletInstanceCoordinator")); + mudlet::self()->init(); + mudlet::self()->setStorePasswordsSecurely(false); + deleteProfileDirectory(mpHostname); + } + + // A button whose script uninstalls its own package must not crash, must finish + // removing the package, and its deferred TActions must be freed cleanly by + // doCleanup() afterwards. Invokes the TAction::execute() path directly (the + // entry the review brief asks for) and, because the package is given a live + // toolbar first, also drives uninstallPackage()'s internal updateAllToolbars() + // over the half-uninstalled (deactivated but still-linked) package. + void test_selfUninstallingButtonDoesNotCrash() + { + startProfile(mpHostname, mpLocalhost, mpPort); + auto* host = mudlet::self()->getActiveHost(); + QVERIFY2(host, "No active host available for the test."); + host->mEchoLuaErrors = true; + auto* actionUnit = host->getActionUnit(); + + const QString packageName = qsl("TestActionUninstallPkg"); + auto* button = buildSelfUninstallingPackage(host, packageName); + const int buttonId = button->getID(); + + // Give the package a real TFlipButton/TEasyButtonBar so the uninstall runs + // over a live toolbar, not an empty one. + actionUnit->updateAllToolbars(); + QVERIFY2(findButtonWidget(host, button), "The button should have a real toolbar widget before the test"); + + // The crash: pre-fix this frees `button` mid-call, then execute() reads + // this->mpHost. If the guard works we return here with everything intact. + button->execute(); + + QCOMPARE(actionUnit->processingDepth(), 0); + QVERIFY2(!host->mInstalledPackages.contains(packageName), "The package should have been uninstalled by the button's script"); + QVERIFY2(!bufferContains(qsl("Lua error")), "The button's uninstallPackage() script must not have errored"); + // Still alive but deferred - deletion was postponed until execute() unwound. + QVERIFY2(actionUnit->getAction(buttonId), "The self-uninstalling button must not be freed while execute() is on the stack"); + + // Flushing the deferred deletes (as the dispatchers and Host's per-line + // cleanup do) must actually remove them, with no double free. + actionUnit->doCleanup(); + QVERIFY2(!actionUnit->getAction(buttonId), "The button should be gone after doCleanup()"); + QVERIFY2(actionUnit->findItems(qsl("selfUninstallButton")).empty(), "No trace of the button should remain after cleanup"); + + // uninstallPackage() defers its profile save to the next event-loop cycle + // (QTimer::singleShot, see Host::uninstallPackage()) and that save runs its + // XML serialization on a background thread. Fire the deferred timer, then + // block until the save has fully finished, so no background save thread is + // still running when cleanup() destroys the host: tearing the host down + // underneath an in-flight save corrupted the heap and crashed on Windows. + QTest::qWait(50); + host->waitForProfileSave(); + } + + void cleanup() + { + // Defence for the failure path: if an assertion above aborted the test + // before its own drain ran, a profile save uninstallPackage() deferred + // could still be in flight. Let it finish before deleting the host, so + // destruction never races a background save thread (a Windows crash). + if (auto* self = mudlet::self()) { + if (auto* host = self->getActiveHost()) { + QTest::qWait(50); + host->waitForProfileSave(); + } + } + delete mpServer; + mpServer = nullptr; + deleteProfileDirectory(mpHostname); + delete mudlet::self(); + } + + // Starts a profile the way a user would via the GUI (mirrors the helper in + // TFeedTriggersRecursionTest). + void startProfile(const QString& hostname, const QString& address, const QString& port) + { + QTimer::singleShot(0, qApp, [hostname, address, port]() { + mudlet::self()->startAutoLogin({}); + QTest::qWait(100); + QTest::mouseClick(mudlet::self()->mpConnectionDialog->new_profile_button, Qt::LeftButton); + QTest::qWait(100); + QTest::keyClicks(QApplication::focusWidget(), hostname); + QTest::qWait(100); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100); + QTest::keyClicks(QApplication::focusWidget(), address); + QTest::qWait(100); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100); + QTest::keyClicks(QApplication::focusWidget(), port); + QTest::qWait(100); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Return); + }); + + QSignalSpy spy(mudlet::self(), &mudlet::signal_profileLoaded); + if (!spy.wait(5000)) { + QFAIL("Profile took too long to load."); + } + auto host = mudlet::self()->getActiveHost(); + if (!host) { + QFAIL("No active host available for the test."); + } + + QSignalSpy spy2(&(host->mTelnet), &cTelnet::signal_connected); + if (!spy2.wait(2000)) { + QFAIL("Could not connect with the host."); + } + } + + QString joinedBuffer() + { + auto console = mudlet::self()->getActiveHost()->mpConsole; + QString allText; + for (int i = 0; i <= console->buffer.getLastLineNumber(); ++i) { + allText.append(console->buffer.line(i)).append(QChar::Space); + } + return allText.simplified(); + } + + bool bufferContains(const QString& needle) { return joinedBuffer().contains(needle); } + + void deleteProfileDirectory(const QString& profileName) + { + const QString path = mudlet::getMudletPath(enums::profileHomePath, profileName); + QDir dir(path); + if (!dir.exists()) { + return; + } + dir.removeRecursively(); + } +}; + +void initializeQRCResources() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +#include "ActionSelfUninstallTest.moc" +QTEST_MAIN(ActionSelfUninstallTest) diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index ff340043d..662ff32c7 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -31,6 +31,7 @@ set(FUNCTIONAL_TEST_SOURCES PackageSelfUninstallTest.cpp MapRoundTripTest.cpp UndoServerWrapTest.cpp + ActionSelfUninstallTest.cpp ) set(FUNCTIONAL_TEST_UTILS From 1cf8a59ba229ccb0517015778777ecebb2f1dc0e Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Thu, 30 Jul 2026 12:02:53 +0200 Subject: [PATCH 022/155] fix: prevent a rare crash while saving a profile that uses modules (#9559) #### Brief overview of PR changes/additions - Move all of `Host::saveProfile()`'s module-save bookkeeping to the main thread: the module XML documents are now built and their writers registered up front (`prepareModuleSaves()`), and the background task only does file I/O (`writeModuleFiles()`: back up, serialize the prepared documents, update zips). - The shared `writers`/`modulesToWrite`/`mModulesToSync` containers, and `Host::xmlSaved()`, are now only ever touched on the main thread; the background task no longer reads the live trigger/timer/script lists while building a module document either. - Each module writer is owned solely by `writers` and dropped on the main thread, so its `XMLexport` (a main-thread `QObject`) is always destroyed on its own thread; `profileSaveFinished` is now always emitted on the main thread. #### Motivation for adding to Mudlet Concurrently mutating these implicitly-shared Qt containers from both the main thread and the QtConcurrent pool thread is undefined behaviour and matches a real heap-corruption crash cluster. #### Other info (issues closed, discussion etc) - This is the pre-existing module-save data race documented in-code by #9557 (which fixed the profile-save half and explicitly deferred module writing to its own PR). Same crash signature: `STATUS_HEAP_CORRUPTION`, Sentry cluster MUDLET-32 / MUDLET-2S / MUDLET-48, frames in lua51 / libpugixml / Qt6Core. - The approach mirrors the existing profile-save path (build the pugixml document on the main thread, serialize it on a background thread) and reuses the `pendingXmlSaveFutures()` snapshot pattern. Module serialization, backups, zip updates and the wait-for-save semantics (`waitForProfileSave`, `currentlySavingProfile`, single-in-flight-save gating) are preserved. - Known-benign ordering: the completion handler clears `mWritingHostAndModules` and emits `profileSaveFinished` before running `reloadModules()`. There is no current `profileSaveFinished` handler that re-enters `saveProfile()`; a future one must not, as it would repopulate `mModulesToSync` that `reloadModules()` then consumes. - Data races are non-deterministic and the existing save tests synchronise via `waitForProfileSave()`, so this cannot be exhibited by a functional test. Correctness rests on every access to the four shared members now being single-threaded; a ThreadSanitizer build runs the save path with no data race reported in this code. **Test case:** 1. In a profile with a module that has "sync" enabled, edit the module and save the profile (or close the profile) repeatedly - the module still serialises to disk correctly and syncs to other open profiles. 2. `ctest -R "ResetProfileTest|ProfileRoundTripTest|MapRoundTripTest"` in an ASan (default Debug) build - all pass. Assisted-by: Claude:claude-opus-4-8 Signed-off-by: Vadim Peretokin --- src/Host.cpp | 119 +++++++++++++++++++++++++++++----------------- src/Host.h | 28 +++++++++-- src/XMLexport.cpp | 20 +++++--- src/XMLexport.h | 3 +- 4 files changed, 115 insertions(+), 55 deletions(-) diff --git a/src/Host.cpp b/src/Host.cpp index 21927b413..49bba4bb9 100644 --- a/src/Host.cpp +++ b/src/Host.cpp @@ -633,27 +633,9 @@ void Host::createModuleBackup(const QString& filename, const QString& saveName) QFile::copy(filename, saveName + time); } -void Host::writeModule(const QString& moduleName, const QString& filename) +QList> Host::pendingXmlSaveFutures() const { - QString xml_filename = filename; - if (filename.endsWith(qsl("mpackage"), Qt::CaseInsensitive) || filename.endsWith(qsl("zip"), Qt::CaseInsensitive)) { - xml_filename = mudlet::getMudletPath(enums::profilePackagePathFileName, mHostName, moduleName); - } - auto writer = std::make_shared(this); - writers.insert(xml_filename, writer); - writer->writeModuleXML(moduleName, xml_filename); - updateModuleZips(filename, moduleName); -} - -// Main thread only: `writers` and each writer's `saveFutures` are mutated on the -// main thread as profile saves start and finish, so the background module-sync -// task must not read them - it gets a snapshot taken up front instead (see -// saveProfile()). NB: saveModules()/writeModule() still touch `writers` from -// that background task for profiles that use modules - a known remaining race -// that needs module writing to move back to the main thread to fix properly. -QVector> Host::pendingXmlSaveFutures() const -{ - QVector> futures; + QList> futures; for (const auto& writer : writers) { futures += writer->saveFutures; } @@ -662,40 +644,72 @@ QVector> Host::pendingXmlSaveFutures() const void Host::waitForAsyncXmlSave() { + // Snapshot on the main thread - see pendingXmlSaveFutures() const auto futures = pendingXmlSaveFutures(); for (auto future : futures) { future.waitForFinished(); } } -void Host::saveModules(bool backup) +QList Host::prepareModuleSaves(bool backup) { - QMapIterator it(modulesToWrite); + // Runs on the main thread so it can safely read the live trigger/timer/... lists + // (via writeModuleXML) and mutate the `writers`/`mModulesToSync`/`modulesToWrite` + // bookkeeping. The returned jobs carry everything writeModuleFiles() needs, so the + // background task never touches any of that shared state. + QList jobs; mModulesToSync.clear(); - const QString savePath = mudlet::getMudletPath(enums::moduleBackupsPath); - auto savePathDir = QDir(savePath); - if (!savePathDir.exists()) { - savePathDir.mkpath(savePath); - } + QMapIterator it(modulesToWrite); while (it.hasNext()) { it.next(); - QStringList entry = it.value(); + const QStringList entry = it.value(); const QString moduleName = it.key(); - const QString filename = entry[0]; + const QString filename = entry.at(0); if (!mModulesLoadedOk.contains(moduleName)) { continue; } - if (backup) { - createModuleBackup(filename, savePath + moduleName); + QString xmlFilename = filename; + if (filename.endsWith(qsl("mpackage"), Qt::CaseInsensitive) || filename.endsWith(qsl("zip"), Qt::CaseInsensitive)) { + xmlFilename = mudlet::getMudletPath(enums::profilePackagePathFileName, mHostName, moduleName); } - writeModule(moduleName, filename); - if (entry[1].toInt()) { + + auto writer = std::make_shared(this); + writer->writeModuleXML(moduleName); + // `writers` is the sole owner; the job carries a non-owning pointer so the + // XMLexport is only ever destroyed on the main thread (via xmlSaved()). + writers.insert(xmlFilename, writer); + jobs.append({writer.get(), moduleName, filename, xmlFilename, backup}); + + if (entry.at(1).toInt()) { mModulesToSync << moduleName; } } modulesToWrite.clear(); + return jobs; +} + +void Host::writeModuleFiles(const QList& jobs) +{ + // Runs on a background thread: pure file I/O, no access to shared save-bookkeeping. + if (jobs.isEmpty()) { + return; + } + const QString savePath = mudlet::getMudletPath(enums::moduleBackupsPath); + auto savePathDir = QDir(savePath); + if (!savePathDir.exists()) { + savePathDir.mkpath(savePath); + } + for (const auto& job : jobs) { + if (job.backup) { + createModuleBackup(job.filename, savePath + job.moduleName); + } + if (!job.writer->saveModuleXml(job.xmlFilename)) { + qWarning().noquote().nospace() << "Host::writeModuleFiles() WARNING - failed to write module \"" << job.moduleName << "\" to \"" << job.xmlFilename << "\"."; + } + updateModuleZips(job.filename, job.moduleName); + } } void Host::reloadModules() @@ -1012,6 +1026,15 @@ std::tuple Host::saveProfile(const QString& saveFolder, writers.remove(qsl("profile")); return {false, filename_xml, tr("the profile is no longer available")}; } + + // Build the module XML documents and register their writers here, on the main + // thread, while the live profile data is quiescent: the background task below then + // only serializes the prepared documents and never touches `writers`, + // `modulesToWrite` or `mModulesToSync` (doing so from a pool thread was a + // heap-corrupting data race). + const bool backupModules = saveName != qsl("autosave"); + const QList moduleJobs = prepareModuleSaves(backupModules); + mWritingHostAndModules = true; // emit signal to notify the UI that the save button should get disabled momentarily @@ -1025,26 +1048,34 @@ std::tuple Host::saveProfile(const QString& saveFolder, qApp->processEvents(); } + // Snapshot the pending profile-save futures on the main thread - see + // pendingXmlSaveFutures(): the background task must not read `writers`/`saveFutures` + // itself, as the main thread mutates them whenever a save starts or finishes. + const QList> xmlSaveFutures = pendingXmlSaveFutures(); auto watcher = new QFutureWatcher; - // Snapshot the pending XML save futures on the main thread: the background task - // below must not read `writers`/`saveFutures` itself as the main thread mutates - // them whenever a save starts or finishes - concurrently copying those containers - // from the pool thread is a data race that can corrupt the heap - const QVector> xmlSaveFutures = pendingXmlSaveFutures(); - const bool backupModules = saveName != qsl("autosave"); - mModuleFuture = QtConcurrent::run([this, xmlSaveFutures, backupModules]() { - // wait for the host xml to be ready before starting to sync modules + mModuleFuture = QtConcurrent::run([this, xmlSaveFutures, moduleJobs]() { + // wait for the host xml to be ready before writing the modules out for (auto future : xmlSaveFutures) { future.waitForFinished(); } - saveModules(backupModules); + writeModuleFiles(moduleJobs); }); - connect(watcher, &QFutureWatcher::finished, this, [=, this]() { - // reload, or queue module reload for when xml is ready + connect(watcher, &QFutureWatcher::finished, this, [this, watcher, moduleJobs, syncModules]() { + // Finish on the main thread: the module documents are now on disk. Consume + // mModulesToSync via reloadModules() *before* the xmlSaved() loop below empties + // `writers` and emits profileSaveFinished(): that signal fires synchronously, + // and a deferred handler (e.g. a queued package install) could start another + // save that clears/replaces mModulesToSync, making this save skip the module + // sync it owes to other profiles. if (syncModules) { reloadModules(); } mWritingHostAndModules = false; + // Drop each module writer from `writers`; the last removal emits + // profileSaveFinished() once the profile writer is gone too. + for (const auto& job : moduleJobs) { + xmlSaved(job.xmlFilename); + } watcher->deleteLater(); }); watcher->setFuture(mModuleFuture); diff --git a/src/Host.h b/src/Host.h index c8c98b90e..947449f0c 100644 --- a/src/Host.h +++ b/src/Host.h @@ -897,10 +897,32 @@ private: void createMapper(const bool); void removePackageInfo(const QString& packageName, const bool); static void createModuleBackup(const QString& filename, const QString& saveName); - void writeModule(const QString& moduleName, const QString& filename); - QVector> pendingXmlSaveFutures() const; + // A single module queued to be written out during a profile save. Its XML + // document is built on the main thread (writer->writeModuleXML()); serializing + // it to disk is deferred to a background task so that no shared save-bookkeeping + // is touched off the main thread. `writer` is a non-owning pointer: the owning + // std::shared_ptr lives only in `writers` (removed on the main thread), so the + // XMLexport - a QObject with main-thread affinity - is always destroyed there. + struct ModuleWriteJob + { + XMLexport* writer = nullptr; + QString moduleName; + QString filename; + QString xmlFilename; + bool backup = false; + }; + // Main thread only: builds every to-be-synced module's XML document and registers + // its writer in `writers`, returning the jobs a background task should serialize. + QList prepareModuleSaves(bool backup); + // Background thread: writes the prepared module documents (and updates their zips) + // to disk. Touches no shared save-bookkeeping (not `writers`, `modulesToWrite` nor + // `mModulesToSync`). + void writeModuleFiles(const QList& jobs); + // Main thread only: snapshot of the still-pending profile-save futures, so a + // background task never reads `writers`/`saveFutures` while the main thread mutates + // them (that concurrent access is a heap-corrupting data race). + QList> pendingXmlSaveFutures() const; void waitForAsyncXmlSave(); - void saveModules(bool backup = true); void updateModuleZips(const QString& zipName, const QString& moduleName); void reloadModules(); void startMapAutosave(const int interval); diff --git a/src/XMLexport.cpp b/src/XMLexport.cpp index 5cab83d4c..29d231f8d 100644 --- a/src/XMLexport.cpp +++ b/src/XMLexport.cpp @@ -83,7 +83,10 @@ XMLexport::XMLexport(TKey* pT) { } -void XMLexport::writeModuleXML(const QString& moduleName, const QString& fileName, bool async) +// Builds the module's XML document into mExportDoc. This reads the live +// trigger/timer/alias/action/script/key lists, so it must run on the main thread; +// serialization to disk (saveModuleXml()) can then happen on a background thread. +void XMLexport::writeModuleXML(const QString& moduleName) { auto pHost = mpHost; auto mudletPackage = writeXmlHeader(); @@ -155,12 +158,15 @@ void XMLexport::writeModuleXML(const QString& moduleName, const QString& fileNam } else { helpPackage.append_child("helpURL").text().set(""); } - if (async) { - runAsyncSave(fileName, fileName); - } else { - saveXml(fileName); - mpHost->xmlSaved(fileName); - } +} + +// Serializes the document previously built by writeModuleXML() to disk. Kept +// separate from writeModuleXML() so the document build (main thread only) and the +// file write (safe on a background thread as the document is not modified once +// built) can run on different threads. +bool XMLexport::saveModuleXml(const QString& fileName) +{ + return saveXml(fileName); } bool XMLexport::exportHost(const QString& filename_pugi_xml) diff --git a/src/XMLexport.h b/src/XMLexport.h index d63641b10..fcedd0564 100644 --- a/src/XMLexport.h +++ b/src/XMLexport.h @@ -66,7 +66,8 @@ public: void writeScript(TScript*, pugi::xml_node xmlParent); void writeKey(TKey*, pugi::xml_node xmlParent); void writeVariable(TVar*, LuaInterface*, VarUnit*, pugi::xml_node xmlParent, bool insideSavedTable = false); - void writeModuleXML(const QString& moduleName, const QString& fileName, bool async = false); + void writeModuleXML(const QString& moduleName); + bool saveModuleXml(const QString& fileName); bool exportHost(const QString& filename_pugi_xml); bool writeGenericPackage(Host* pHost, pugi::xml_node& mMudletPackage, bool ignoreModuleMember = true, bool ignoreVariables = false); From 1227bc37785725815c8f80c11b7818110389ce1f Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Thu, 30 Jul 2026 12:04:54 +0200 Subject: [PATCH 023/155] add: getWindowGeometry(), windowVisible() and getLabelText() functions (#9528) #### Brief overview of PR changes/additions - `getWindowGeometry(name)` returns x, y, width, height for any window element - the exact inverse of moveWindow()/resizeWindow() - `windowVisible(name)` returns effective visibility (a child in a hidden user window reports false) - `getLabelText(name)` returns the text shown on a label - 25 specs appended to UI_spec.lua #### Motivation for adding to Mudlet Long-requested readback symmetry: scripts (and now tests) can finally query window state they could previously only set. #### Other info (issues closed, discussion etc) Part of the Lua API test-coverage program (Wave 0); unlocks ~100 previously untestable functions. Wiki text drafted, to be added to Area 51 once merged. **Test case:** `createLabel` + `moveWindow`/`resizeWindow`, then `getWindowGeometry` returns the same values; `hideWindow` flips `windowVisible` to false; `echo` to a label, `getLabelText` returns it. Awaiting build/test by a maintainer; squash-merge with: Assisted-by: Claude:claude-opus-4-8 (Signed-off-by to be added at squash after testing) --- src/Host.cpp | 66 +++++++++ src/Host.h | 3 + src/TLuaInterpreter.cpp | 3 + src/TLuaInterpreter.h | 3 + src/TLuaInterpreterUI.cpp | 44 ++++++ src/mudlet-lua/tests/UI_spec.lua | 234 +++++++++++++++++++++++++++++++ 6 files changed, 353 insertions(+) diff --git a/src/Host.cpp b/src/Host.cpp index 49bba4bb9..f0578d7e3 100644 --- a/src/Host.cpp +++ b/src/Host.cpp @@ -4949,6 +4949,72 @@ std::optional Host::windowType(const QString& name) const return {}; } +// Returns the position and size of a named window element, matching what +// moveWindow()/resizeWindow() set. pos()/size() (rather than geometry()) are +// used deliberately: they are the exact inverse of the move()/resize() calls +// those setters make, including for a floating user-window dock where move() +// targets the frame origin while geometry() would report the client area. +// Mirrors the widget dispatch of moveWindow()/resizeWindow(); user windows are +// moved/resized through their dock widget, so read the dock, not the console. +std::optional Host::windowGeometry(const QString& name) const +{ + if (!mpConsole) { + return {}; + } + + if (auto pL = mpConsole->mLabelMap.value(name)) { + return {QRect(pL->pos(), pL->size())}; + } + if (auto pC = mpConsole->mSubConsoleMap.value(name)) { + if (auto pD = mpConsole->mDockWidgetMap.value(name)) { + return {QRect(pD->pos(), pD->size())}; + } + return {QRect(pC->pos(), pC->size())}; + } + if (auto pS = mpConsole->mScrollBoxMap.value(name)) { + return {QRect(pS->pos(), pS->size())}; + } + if (auto pN = mpConsole->mSubCommandLineMap.value(name)) { + return {QRect(pN->pos(), pN->size())}; + } + if (auto pT = mpConsole->mTextBoxMap.value(name)) { + return {QRect(pT->pos(), pT->size())}; + } + + return {}; +} + +// Returns whether a named window element is currently visible. Mirrors the +// widget dispatch of hideWindow()/showWindow(); user windows report the +// visibility of their dock widget, which is what those functions toggle. +std::optional Host::windowVisible(const QString& name) const +{ + if (!mpConsole) { + return {}; + } + + if (auto pL = mpConsole->mLabelMap.value(name)) { + return {pL->isVisible()}; + } + if (auto pC = mpConsole->mSubConsoleMap.value(name)) { + if (auto pD = mpConsole->mDockWidgetMap.value(name)) { + return {pD->isVisible()}; + } + return {pC->isVisible()}; + } + if (auto pS = mpConsole->mScrollBoxMap.value(name)) { + return {pS->isVisible()}; + } + if (auto pN = mpConsole->mSubCommandLineMap.value(name)) { + return {pN->isVisible()}; + } + if (auto pT = mpConsole->mTextBoxMap.value(name)) { + return {pT->isVisible()}; + } + + return {}; +} + void Host::setLargeAreaExitArrows(const bool state) { if (mLargeAreaExitArrows != state) { diff --git a/src/Host.h b/src/Host.h index 947449f0c..7b6153add 100644 --- a/src/Host.h +++ b/src/Host.h @@ -47,6 +47,7 @@ #include #include #include +#include #include #include @@ -466,6 +467,8 @@ public: mScreenHeight = height; } std::optional windowType(const QString& name) const; + std::optional windowGeometry(const QString& name) const; + std::optional windowVisible(const QString& name) const; bool getEditorShowBidi() const { return mEditorShowBidi; } void setEditorShowBidi(const bool); bool caretEnabled() const; diff --git a/src/TLuaInterpreter.cpp b/src/TLuaInterpreter.cpp index 88010f84a..313d52ab9 100644 --- a/src/TLuaInterpreter.cpp +++ b/src/TLuaInterpreter.cpp @@ -5289,6 +5289,9 @@ void TLuaInterpreter::initLuaGlobals() lua_register(pGlobalLua, "setTextFormat", TLuaInterpreter::setTextFormat); lua_register(pGlobalLua, "getMainWindowSize", TLuaInterpreter::getMainWindowSize); lua_register(pGlobalLua, "getUserWindowSize", TLuaInterpreter::getUserWindowSize); + lua_register(pGlobalLua, "getWindowGeometry", TLuaInterpreter::getWindowGeometry); + lua_register(pGlobalLua, "windowVisible", TLuaInterpreter::windowVisible); + lua_register(pGlobalLua, "getLabelText", TLuaInterpreter::getLabelText); lua_register(pGlobalLua, "getMousePosition", TLuaInterpreter::getMousePosition); lua_register(pGlobalLua, "setProfileIcon", TLuaInterpreter::setProfileIcon); lua_register(pGlobalLua, "resetProfileIcon", TLuaInterpreter::resetProfileIcon); diff --git a/src/TLuaInterpreter.h b/src/TLuaInterpreter.h index e740eaddc..f3e758840 100644 --- a/src/TLuaInterpreter.h +++ b/src/TLuaInterpreter.h @@ -495,6 +495,9 @@ public: static int setLabelOnLeave(lua_State*); static int getMainWindowSize(lua_State*); static int getUserWindowSize(lua_State*); + static int getWindowGeometry(lua_State*); + static int windowVisible(lua_State*); + static int getLabelText(lua_State*); static int getMousePosition(lua_State*); static int setProfileIcon(lua_State*); static int resetProfileIcon(lua_State*); diff --git a/src/TLuaInterpreterUI.cpp b/src/TLuaInterpreterUI.cpp index 47d683fd9..c0fcb4e23 100644 --- a/src/TLuaInterpreterUI.cpp +++ b/src/TLuaInterpreterUI.cpp @@ -1675,6 +1675,50 @@ int TLuaInterpreter::getUserWindowSize(lua_State* L) return 2; } +// Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#getWindowGeometry +int TLuaInterpreter::getWindowGeometry(lua_State* L) +{ + const Host& host = getHostFromLua(L); + const QString windowName = getVerifiedString(L, __func__, 1, "window name"); + + if (auto geometry = host.windowGeometry(windowName)) { + lua_pushnumber(L, geometry->x()); + lua_pushnumber(L, geometry->y()); + lua_pushnumber(L, geometry->width()); + lua_pushnumber(L, geometry->height()); + return 4; + } + + lua_pushnil(L); + lua_pushfstring(L, bad_window_value, windowName.toUtf8().constData()); + return 2; +} + +// Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#windowVisible +int TLuaInterpreter::windowVisible(lua_State* L) +{ + const Host& host = getHostFromLua(L); + const QString windowName = getVerifiedString(L, __func__, 1, "window name"); + + if (auto visible = host.windowVisible(windowName)) { + lua_pushboolean(L, *visible); + return 1; + } + + lua_pushnil(L); + lua_pushfstring(L, bad_window_value, windowName.toUtf8().constData()); + return 2; +} + +// Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#getLabelText +int TLuaInterpreter::getLabelText(lua_State* L) +{ + const QString labelName = getVerifiedString(L, __func__, 1, "label name"); + auto label = LABEL(L, labelName); + lua_pushstring(L, label->text().toUtf8().constData()); + return 1; +} + // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#getWindowWrap int TLuaInterpreter::getWindowWrap(lua_State* L) { diff --git a/src/mudlet-lua/tests/UI_spec.lua b/src/mudlet-lua/tests/UI_spec.lua index 051aae8b7..1fdef7dfb 100644 --- a/src/mudlet-lua/tests/UI_spec.lua +++ b/src/mudlet-lua/tests/UI_spec.lua @@ -2524,3 +2524,237 @@ describe("Tests UI functions", function() end) end) end) + +-- Window state getters: getWindowGeometry, windowVisible, getLabelText. +-- Self-contained top-level block kept at the tail of the file; do not +-- interleave it with the "Tests UI functions" block above. +describe("Window state getters", function() + -- Unique-ish names so repeat runs against the same profile do not collide: + -- user windows cannot be deleted from Lua, only hidden. + local suffix = ("-%d-%d"):format(os.time(), math.random(100000)) + local labelName = "wsgLabel" .. suffix + local consoleName = "wsgConsole" .. suffix + local scrollBoxName = "wsgScrollBox" .. suffix + local cmdLineName = "wsgCmdLine" .. suffix + local textEditName = "wsgTextEdit" .. suffix + local userWindowName = "wsgUserWindow" .. suffix + -- a label parented inside the user window, to probe ancestor-aware visibility + local childLabelName = "wsgChildLabel" .. suffix + + setup(function() + createLabel(labelName, 10, 20, 100, 50, 1) + createMiniConsole(consoleName, 30, 40, 300, 150) + createScrollBox(scrollBoxName, 60, 70, 120, 90) + createCommandLine(cmdLineName, 15, 25, 140, 35) + createTextEdit(textEditName, 45, 55, 160, 110) + openUserWindow(userWindowName) + createLabel(userWindowName, childLabelName, 5, 5, 40, 20, 1) + end) + + before_each(function() + -- restore baseline geometry and visibility so one failing spec cannot + -- cascade into later specs (busted runs specs in definition order) + moveWindow(labelName, 10, 20) + resizeWindow(labelName, 100, 50) + moveWindow(consoleName, 30, 40) + resizeWindow(consoleName, 300, 150) + for _, name in ipairs({labelName, consoleName, scrollBoxName, cmdLineName, textEditName, userWindowName}) do + showWindow(name) + end + end) + + teardown(function() + deleteLabel(childLabelName) + deleteLabel(labelName) + deleteMiniConsole(consoleName) + deleteScrollBox(scrollBoxName) + deleteCommandLine(cmdLineName) + deleteTextEdit(textEditName) + -- user windows cannot be deleted from Lua, so just hide it again + hideWindow(userWindowName) + end) + + describe("getWindowGeometry", function() + it("returns a label's position and size as x, y, width, height", function() + local x, y, w, h = getWindowGeometry(labelName) + assert.are.equal(10, x) + assert.are.equal(20, y) + assert.are.equal(100, w) + assert.are.equal(50, h) + end) + + it("returns a miniconsole's position and size", function() + local x, y, w, h = getWindowGeometry(consoleName) + assert.are.equal(30, x) + assert.are.equal(40, y) + assert.are.equal(300, w) + assert.are.equal(150, h) + end) + + it("returns a scroll box's position and size", function() + local x, y, w, h = getWindowGeometry(scrollBoxName) + assert.are.equal(60, x) + assert.are.equal(70, y) + assert.are.equal(120, w) + assert.are.equal(90, h) + end) + + it("returns a command line's position and size", function() + local x, y, w, h = getWindowGeometry(cmdLineName) + assert.are.equal(15, x) + assert.are.equal(25, y) + assert.are.equal(140, w) + assert.are.equal(35, h) + end) + + it("returns a text edit's position and size", function() + local x, y, w, h = getWindowGeometry(textEditName) + assert.are.equal(45, x) + assert.are.equal(55, y) + assert.are.equal(160, w) + assert.are.equal(110, h) + end) + + it("reflects moveWindow on a label", function() + moveWindow(labelName, 55, 66) + local x, y = getWindowGeometry(labelName) + assert.are.equal(55, x) + assert.are.equal(66, y) + end) + + it("reflects resizeWindow on a miniconsole", function() + resizeWindow(consoleName, 321, 123) + local _, _, w, h = getWindowGeometry(consoleName) + assert.are.equal(321, w) + assert.are.equal(123, h) + end) + + it("reflects resizeWindow on a user window", function() + -- read back through the dock widget; size() is the exact inverse of + -- resize() and does not depend on the window manager honouring a move + resizeWindow(userWindowName, 400, 200) + local _, _, w, h = getWindowGeometry(userWindowName) + assert.are.equal(400, w) + assert.are.equal(200, h) + end) + + it("returns nil and a message naming an unknown window", function() + local result, err = getWindowGeometry("wsgNoSuchWindow") + assert.is_nil(result) + assert.are.equal("string", type(err)) + assert.is_truthy(err:find("wsgNoSuchWindow", 1, true)) + end) + + it("returns nil and a message for the main window", function() + -- mirrors moveWindow/resizeWindow, which likewise do not act on "main" + local result, err = getWindowGeometry("main") + assert.is_nil(result) + assert.are.equal("string", type(err)) + end) + + it("errors when called without a window name", function() + assert.has_error(function() getWindowGeometry() end) + end) + end) + + describe("windowVisible", function() + it("reflects hideWindow then showWindow on a label", function() + assert.is_true(windowVisible(labelName)) + hideWindow(labelName) + assert.is_false(windowVisible(labelName)) + showWindow(labelName) + assert.is_true(windowVisible(labelName)) + end) + + it("reflects hideWindow then showWindow on a miniconsole", function() + assert.is_true(windowVisible(consoleName)) + hideWindow(consoleName) + assert.is_false(windowVisible(consoleName)) + showWindow(consoleName) + assert.is_true(windowVisible(consoleName)) + end) + + it("reflects hideWindow then showWindow on a scroll box", function() + assert.is_true(windowVisible(scrollBoxName)) + hideWindow(scrollBoxName) + assert.is_false(windowVisible(scrollBoxName)) + showWindow(scrollBoxName) + assert.is_true(windowVisible(scrollBoxName)) + end) + + it("reflects hideWindow then showWindow on a command line", function() + assert.is_true(windowVisible(cmdLineName)) + hideWindow(cmdLineName) + assert.is_false(windowVisible(cmdLineName)) + showWindow(cmdLineName) + assert.is_true(windowVisible(cmdLineName)) + end) + + it("reflects hideWindow then showWindow on a user window", function() + assert.is_true(windowVisible(userWindowName)) + hideWindow(userWindowName) + assert.is_false(windowVisible(userWindowName)) + showWindow(userWindowName) + assert.is_true(windowVisible(userWindowName)) + end) + + it("reports a child hidden by its user window as not visible", function() + -- windowVisible reflects effective (ancestor-aware) visibility: hiding + -- the parent user window hides the child even though the child itself + -- was never hidden + assert.is_true(windowVisible(childLabelName)) + hideWindow(userWindowName) + assert.is_false(windowVisible(childLabelName)) + showWindow(userWindowName) + assert.is_true(windowVisible(childLabelName)) + end) + + it("returns nil and a message naming an unknown window", function() + local result, err = windowVisible("wsgNoSuchWindow") + assert.is_nil(result) + assert.are.equal("string", type(err)) + assert.is_truthy(err:find("wsgNoSuchWindow", 1, true)) + end) + + it("returns nil and a message for the main window", function() + local result, err = windowVisible("main") + assert.is_nil(result) + assert.are.equal("string", type(err)) + end) + + it("errors when called without a window name", function() + assert.has_error(function() windowVisible() end) + end) + end) + + describe("getLabelText", function() + it("returns text set on a label via echo", function() + echo(labelName, "hello label") + assert.are.equal("hello label", getLabelText(labelName)) + end) + + it("round-trips updated label text", function() + echo(labelName, "first") + assert.are.equal("first", getLabelText(labelName)) + echo(labelName, "second") + assert.are.equal("second", getLabelText(labelName)) + end) + + it("returns nil and a message naming an unknown label", function() + local result, err = getLabelText("wsgNoSuchLabel") + assert.is_nil(result) + assert.are.equal("string", type(err)) + assert.is_truthy(err:find("wsgNoSuchLabel", 1, true)) + end) + + it("returns nil and a message for a non-label window", function() + local result, err = getLabelText(consoleName) + assert.is_nil(result) + assert.are.equal("string", type(err)) + end) + + it("errors when called without a label name", function() + assert.has_error(function() getLabelText() end) + end) + end) +end) From c6432f56ca5fd39559b3c7633cdf93a9e1df6d70 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Thu, 30 Jul 2026 13:52:56 +0200 Subject: [PATCH 024/155] infrastructure: replace test mocks with real API assertions; config, stopwatch and utils tests (#9534) #### Brief overview of PR changes/additions - Removes Other_spec's global mocks of real API functions (send/echo/tempTimer/perm*) - tests now assert genuine behavior via spies - New specs: speedwalk state machine, full stopwatch family, getConfig/setConfig round-trips, string/table utils - Every test leaves zero persistent state in the profile #### Motivation for adding to Mudlet The mocks made coverage look real while testing nothing; they also masked a dead failure branch in permGroup. #### Other info (issues closed, discussion etc) Part of the Lua API test-coverage program (Wave 1). Found permGroup dead -1 branch and listRemove consecutive-duplicate skip (filed separately, not pinned). **Test case:** run the busted suite - Other_spec, StringUtils_spec and TableUtils_spec pass green, twice; getStopWatches starts empty on a repeat run. Awaiting build/test by a maintainer; squash-merge with: Assisted-by: Claude:claude-opus-4-8 (Signed-off-by to be added at squash after testing) --- src/mudlet-lua/tests/Other_spec.lua | 797 ++++++++++++++++------ src/mudlet-lua/tests/StringUtils_spec.lua | 48 ++ src/mudlet-lua/tests/TableUtils_spec.lua | 102 ++- 3 files changed, 754 insertions(+), 193 deletions(-) diff --git a/src/mudlet-lua/tests/Other_spec.lua b/src/mudlet-lua/tests/Other_spec.lua index 18d33c496..9bec9fe65 100644 --- a/src/mudlet-lua/tests/Other_spec.lua +++ b/src/mudlet-lua/tests/Other_spec.lua @@ -1,25 +1,17 @@ describe("Tests Other.lua functions", function() describe("Tests the functionality of sendAll", function() - setup(function() - _G.echo = function() end - _G.send = function() end - _G.tempTimer = function(time, code) - if type(code) == "string" then - loadstring(code)() - elseif type(code) == "function" then - code() - else - error("tempTimer: Code must be a string or a function.") - end - end - end) + -- sendAll and the speedwalk family below drive the real send() function. + -- Offline (the self-test profile is not connected) send() is a no-op on the + -- wire, so we spy on the real function (pass-through) rather than replacing + -- it with a mock, and assert the actual dispatch it performs. it("should send one command if it is only given one parameter", function() local send = spy.on(_G, "send") sendAll("look") assert.spy(send).was.called(1) assert.spy(send).was.called_with("look", true) + send:revert() end) it("should send multiple commands when given multiple string parameters", function() @@ -34,194 +26,145 @@ describe("Tests Other.lua functions", function() for _,command in ipairs(commands) do assert.spy(send).was.called_with(command, true) end + send:revert() end) - it("should pass along the final boolean argument to all sends if provided", function() + it("should pass along a final boolean argument of false to all sends", function() local send = spy.on(_G, "send") sendAll("get gold from pouch", "buy potion", "put gold in pouch", false) assert.spy(send).was.called(3) assert.spy(send).was.called_with("get gold from pouch", false) assert.spy(send).was.called_with("buy potion", false) assert.spy(send).was.called_with("put gold in pouch", false) + send:revert() end) - it("should pass along the final boolean argument to all sends if provided", function() + it("should pass along a final boolean argument of true to all sends", function() local send = spy.on(_G, "send") sendAll("get gold from pouch", "buy potion", "put gold in pouch", true) assert.spy(send).was.called(3) assert.spy(send).was.called_with("get gold from pouch", true) assert.spy(send).was.called_with("buy potion", true) assert.spy(send).was.called_with("put gold in pouch", true) + send:revert() + end) + + it("schedules a tempTimer per command instead of sending when the first argument is a delay", function() + local send = spy.on(_G, "send") + -- Wrap the real tempTimer (pass-through) purely to capture the ids it + -- returns so we can cancel the scheduled timers; sendAll discards them. + local scheduledIds = {} + local realTempTimer = _G.tempTimer + _G.tempTimer = function(...) + local id = realTempTimer(...) + scheduledIds[#scheduledIds + 1] = id + return id + end + finally(function() + _G.tempTimer = realTempTimer + for _, id in ipairs(scheduledIds) do + pcall(killTimer, id) + end + send:revert() + end) + + sendAll(5, "north", "south") + assert.spy(send).was_not_called() + assert.equals(2, #scheduledIds) + end) + end) + + describe("Tests the functionality of sendCmdLine", function() + -- sendCmdLine sets the active command line's text (no wire traffic to + -- observe offline), which is readable back with getCmdLine. We clear the + -- command line afterwards so no text is left behind. + after_each(function() + pcall(clearCmdLine) + end) + + it("sets the command line text and returns true", function() + assert.is_true(sendCmdLine("look")) + assert.equals("look", getCmdLine()) + end) + + it("errors when given no argument", function() + assert.has_error(function() sendCmdLine() end) + end) + + it("errors when the argument is not a string", function() + assert.has_error(function() sendCmdLine({}) end) end) end) describe("Tests the functionality of permGroup", function() + -- permGroup creates *permanent* items, which have no public removal API and + -- are written to disk when the profile saves. To verify the real dispatch + -- and the documented default arguments without polluting the profile we use + -- a parent that does not exist: each underlying perm* function marshals its + -- arguments and then fails at the parent lookup before creating anything. + local nonexistentParent = "permGroupSpecNonexistentParent" - describe("success", function() - setup(function() - _G.oldPermTimer = _G.permTimer - _G.oldPermSubstringTrigger = _G.permSubstringTrigger - _G.oldPermAlias = _G.permAlias - _G.oldPermKey = _G.permKey - _G.oldPermScript = _G.permScript - _G.permTimer = function() return 1 end - _G.permSubstringTrigger = function() return 1 end - _G.permAlias = function() return 1 end - _G.permKey = function() return 1 end - _G.permScript = function() return 1 end - end) - - teardown(function() - _G.permTimer = _G.oldPermTimer - _G.permSubstringTrigger = _G.oldPermSubstringTrigger - _G.permAlias = _G.oldPermAlias - _G.permKey = _G.oldPermKey - _G.permScript = _G.oldPermScript - _G.oldPermTimer = nil - _G.oldPermSubstringTrigger = nil - _G.oldPermAlias = nil - _G.oldPermKey = nil - _G.oldPermScript = nil - end) - - it("should return true if the timer group was created", function() + -- The default-parent-of-"" branch (permGroup(name, type) with no parent) is + -- deliberately not covered: an empty parent makes the underlying perm* + -- succeed and create a real, unremovable top-level item, so it cannot be + -- exercised without either polluting the profile or mocking a real function. + describe("dispatches to the correct underlying function with the documented defaults", function() + -- Each test also asserts pcall failed, which self-checks the assumption + -- that the nonexistent parent prevents any item from actually being created. + it("uses permTimer(name, parent, 0, '') for timers", function() local permTimer = spy.on(_G, "permTimer") - local name = "TestTimer" - local parent = "Parent" - local successful = permGroup(name, "timer", parent) - assert.spy(permTimer).was.called_with(name, parent, 0, "") - assert.is_true(successful) + local ok = pcall(permGroup, "permGroupSpecTimer", "timer", nonexistentParent) + assert.is_false(ok) + assert.spy(permTimer).was.called_with("permGroupSpecTimer", nonexistentParent, 0, "") + permTimer:revert() end) - it("should return true if the alias group was created", function() + it("uses permSubstringTrigger(name, parent, {}, '') for triggers", function() + local permSubstringTrigger = spy.on(_G, "permSubstringTrigger") + local ok = pcall(permGroup, "permGroupSpecTrigger", "trigger", nonexistentParent) + assert.is_false(ok) + assert.spy(permSubstringTrigger).was.called_with("permGroupSpecTrigger", nonexistentParent, {}, "") + permSubstringTrigger:revert() + end) + + it("uses permAlias(name, parent, '', '') for aliases", function() local permAlias = spy.on(_G, "permAlias") - local name = "TestAlias" - local parent = "Parent" - local successful = permGroup(name, "alias", parent) - assert.spy(permAlias).was.called_with(name, parent, "", "") - assert.is_true(successful) + local ok = pcall(permGroup, "permGroupSpecAlias", "alias", nonexistentParent) + assert.is_false(ok) + assert.spy(permAlias).was.called_with("permGroupSpecAlias", nonexistentParent, "", "") + permAlias:revert() end) - it("should return true if the trigger group was created", function() - local permTrigger = spy.on(_G, "permSubstringTrigger") - local name = "TestTrigger" - local parent = "Parent" - local successful = permGroup(name, "trigger", parent) - assert.spy(permTrigger).was.called_with(name, parent, {}, "") - assert.is_true(successful) - end) - - it("should return true if the key group was created", function() + it("uses permKey(name, parent, -1, '') for keys", function() local permKey = spy.on(_G, "permKey") - local name = "TestKey" - local parent = "Parent" - local successful = permGroup(name, "key", parent) - assert.spy(permKey).was.called_with(name, parent, -1, "") - assert.is_true(successful) + local ok = pcall(permGroup, "permGroupSpecKey", "key", nonexistentParent) + assert.is_false(ok) + assert.spy(permKey).was.called_with("permGroupSpecKey", nonexistentParent, -1, "") + permKey:revert() end) - it("should return true if the script group was created", function() + it("uses permScript(name, parent, '', '') for scripts", function() local permScript = spy.on(_G, "permScript") - local name = "TestScript" - local parent = "Parent" - local successful = permGroup(name, "script", parent) - assert.spy(permScript).was.called_with(name, parent, "", "") - assert.is_true(successful) - end) - - it("should use empty string as default parent when parent is not provided", function() - local permTimer = spy.on(_G, "permTimer") - local name = "TestTimer" - local successful = permGroup(name, "timer") - assert.spy(permTimer).was.called_with(name, "", 0, "") - assert.is_true(successful) + local ok = pcall(permGroup, "permGroupSpecScript", "script", nonexistentParent) + assert.is_false(ok) + assert.spy(permScript).was.called_with("permGroupSpecScript", nonexistentParent, "", "") + permScript:revert() end) end) - describe("failure", function() - setup(function() - _G.oldPermTimer = _G.permTimer - _G.oldPermSubstringTrigger = _G.permSubstringTrigger - _G.oldPermAlias = _G.permAlias - _G.oldPermKey = _G.permKey - _G.oldPermScript = _G.permScript - _G.permTimer = function() return -1 end - _G.permSubstringTrigger = function() return -1 end - _G.permAlias = function() return -1 end - _G.permKey = function() return -1 end - _G.permScript = function() return -1 end - end) - - teardown(function() - _G.permTimer = _G.oldPermTimer - _G.permSubstringTrigger = _G.oldPermSubstringTrigger - _G.permAlias = _G.oldPermAlias - _G.permKey = _G.oldPermKey - _G.permScript = _G.oldPermScript - _G.oldPermTimer = nil - _G.oldPermSubstringTrigger = nil - _G.oldPermAlias = nil - _G.oldPermKey = nil - _G.oldPermScript = nil - end) - - it("should return false if the timer group was not created", function() - local permTimer = spy.on(_G, "permTimer") - local name = "TestTimer" - local parent = "Parent" - local successful = permGroup(name, "timer", parent) - assert.spy(permTimer).was.called_with(name, parent, 0, "") - assert.is_false(successful) - end) - - it("should return false if the alias group was not created", function() - local permAlias = spy.on(_G, "permAlias") - local name = "TestAlias" - local parent = "Parent" - local successful = permGroup(name, "alias", parent) - assert.spy(permAlias).was.called_with(name, parent, "", "") - assert.is_false(successful) - end) - - it("should return false if the trigger group was not created", function() - local permTrigger = spy.on(_G, "permSubstringTrigger") - local name = "TestTrigger" - local parent = "Parent" - local successful = permGroup(name, "trigger", parent) - assert.spy(permTrigger).was.called_with(name, parent, {}, "") - assert.is_false(successful) - end) - - it("should return false if the key group was not created", function() - local permKey = spy.on(_G, "permKey") - local name = "TestKey" - local parent = "Parent" - local successful = permGroup(name, "key", parent) - assert.spy(permKey).was.called_with(name, parent, -1, "") - assert.is_false(successful) - end) - - it("should return false if the script group was not created", function() - local permScript = spy.on(_G, "permScript") - local name = "TestScript" - local parent = "Parent" - local successful = permGroup(name, "script", parent) - assert.spy(permScript).was.called_with(name, parent, "", "") - assert.is_false(successful) + describe("propagates the underlying creation error instead of returning false", function() + -- group_creation_functions in Other.lua checks `perm*(...) == -1`, but the + -- real perm* bindings raise a Lua error on failure rather than returning + -- -1, so that check is dead code and a failed permGroup errors instead of + -- returning false. + it("raises an error when the parent group does not exist", function() + assert.has_error(function() + permGroup("permGroupSpecOrphan", "timer", nonexistentParent) + end) end) end) describe("error handling", function() - setup(function() - _G.oldPermTimer = _G.permTimer - _G.permTimer = function() return 1 end - end) - - teardown(function() - _G.permTimer = _G.oldPermTimer - _G.oldPermTimer = nil - end) - it("should raise an error if name is not a string", function() assert.has_error(function() permGroup(123, "timer") @@ -268,7 +211,7 @@ describe("Tests Other.lua functions", function() it("should return true if a is true and b is false", function() assert.is_true(xor(false,true)) end) - + it("should return false if a is true and b is true", function() assert.is_false(xor(true, true)) end) @@ -279,20 +222,15 @@ describe("Tests Other.lua functions", function() end) describe("Tests the functionality of speedwalking", function() - -- Note that busted insulates changes in each test file, so - -- these changes won't escape outside this file. - setup(function() - _G.echo = function() end - _G.send = function() end - _G.tempTimer = function(time, code) - if type(code) == "string" then - loadstring(code)() - elseif type(code) == "function" then - code() - else - error("tempTimer: Code must be a string or a function.") - end - end + -- speedwalk with no delay dispatches synchronously through the real send(); + -- the delayed form is covered by an immediate-contract test below and the + -- speedwalk state machine (stop/pause/resume) has its own describe block. + -- Real timer firing is intentionally out of scope here (no sleeps). + + after_each(function() + -- if the delayed-walk test's assertion fails before it cleans up, cancel + -- the scheduled timer chain so it cannot fire during later tests + pcall(stopSpeedwalk) end) it("Tests basic speedwalk() with chained directions", function() @@ -305,43 +243,133 @@ describe("Tests Other.lua functions", function() assert.spy(send).was.called_with("se", true) assert.spy(send).was.called_with("u", true) assert.spy(send).was_not_called_with("e", true) + send:revert() end) it("Tests basic speedwalk() with commas as separators", function() local send = spy.on(_G, "send") - -- Will walk twice northeast, thrice east, twice north, once east. All in immediate succession.") + -- Will walk twice northeast, thrice east, twice north, once east. All in immediate succession. speedwalk('2ne,3e,2n,e') assert.spy(send).was.called(8) assert.spy(send).was.called_with("ne", true) assert.spy(send).was.called_with("e", true) assert.spy(send).was.called_with("n", true) + send:revert() end) it("tests reverse speedwalk", function() local send = spy.on(_G, "send") speedwalk("5sw - 3s - 2n - w", true) - -- Will walk backwards: east, twice south, thrice, north, five times northeast. All in immediate succession. + -- Will walk backwards: east, twice south, thrice north, five times northeast. All in immediate succession. assert.spy(send).was.called(11) assert.spy(send).was.called_with("ne", true) assert.spy(send).was.called_with("n", true) assert.spy(send).was.called_with("s", true) assert.spy(send).was.called_with("e", true) - assert.spy(send).was.was_not_called_with("w", true) + assert.spy(send).was_not_called_with("w", true) + send:revert() end) - it("tests reverse speedwalk with a delay", function() - local send = spy.on(_G, "send") - local speedwalktimer = spy.on(_G, "speedwalktimer") - local tempTimer = spy.on(_G, "tempTimer") + it("dispatches only the first step synchronously when a delay is given", function() + local send = spy.on(_G, "send") + -- With a delay the remaining steps are scheduled on real tempTimers + -- (Wave 2 territory); only the first step happens synchronously. speedwalk("3w, 2ne, w, u", true, 1.25) - -- Will walk backwards: down, east, twice southwest, thrice east, with 1.25 seconds delay between every move. + assert.spy(send).was.called(1) - assert.spy(speedwalktimer).was.called() - assert.spy(send).was.called(7) - assert.spy(tempTimer).was.called(6) + -- Cancel the scheduled continuation so it does not fire during later tests. + local stopped = stopSpeedwalk() + assert.is_true(stopped) + send:revert() + end) + end) + + describe("Tests the speedwalk state machine", function() + -- stopSpeedwalk/pauseSpeedwalk/resumeSpeedwalk drive a shared upvalue state + -- machine and raise sys* events (raiseEvent dispatches synchronously in + -- process). We start a delayed speedwalk to enter the running state, then + -- assert the control functions' return contracts and events without sleeps. + + after_each(function() + -- Fully clear any active OR paused speedwalk so no timer chain or leftover + -- walklist survives into the next test. resumeSpeedwalk re-arms a paused + -- walk so the subsequent stopSpeedwalk can clear its list. + pcall(resumeSpeedwalk) + pcall(stopSpeedwalk) + end) + + it("stopSpeedwalk returns nil and a message when nothing is walking", function() + local ok, err = stopSpeedwalk() + assert.is_nil(ok) + assert.equals("stopSpeedwalk(): no active speedwalk found", err) + end) + + it("pauseSpeedwalk returns nil and a message when nothing is walking", function() + local ok, err = pauseSpeedwalk() + assert.is_nil(ok) + assert.equals("pauseSpeedwalk(): no active speedwalk found", err) + end) + + it("resumeSpeedwalk refuses to resume when there is no walklist", function() + local ok, err = resumeSpeedwalk() + assert.is_nil(ok) + assert.equals("resumeSpeedwalk(): attempted to resume a speedwalk but no active speedwalk found", err) + end) + + it("raises sysSpeedwalkStarted when a walk begins", function() + local started = false + local handler = registerAnonymousEventHandler("sysSpeedwalkStarted", function() started = true end) + finally(function() killAnonymousEventHandler(handler) end) + speedwalk("2n", false, 1) + assert.is_true(started) + end) + + it("raises sysSpeedwalkStopped when a running walk is stopped", function() + local stopped = false + local handler = registerAnonymousEventHandler("sysSpeedwalkStopped", function() stopped = true end) + finally(function() killAnonymousEventHandler(handler) end) + speedwalk("2n1e", false, 1) + assert.is_true(stopSpeedwalk()) + assert.is_true(stopped) + end) + + it("pause then resume raises the paused and resumed events, resuming dispatches the next step", function() + local paused, resumed = false, false + local hPause = registerAnonymousEventHandler("sysSpeedwalkPaused", function() paused = true end) + local hResume = registerAnonymousEventHandler("sysSpeedwalkResumed", function() resumed = true end) + finally(function() + killAnonymousEventHandler(hPause) + killAnonymousEventHandler(hResume) + end) + + speedwalk("2n1e", false, 1) + assert.is_true(pauseSpeedwalk()) + assert.is_true(paused) + + -- resuming sends the next queued step synchronously before re-scheduling + local send = spy.on(_G, "send") + finally(function() send:revert() end) + assert.is_true(resumeSpeedwalk()) + assert.is_true(resumed) + assert.spy(send).was.called(1) + end) + + it("pauseSpeedwalk a second time returns nil and a message", function() + speedwalk("2n1e", false, 1) + assert.is_true(pauseSpeedwalk()) + local ok, err = pauseSpeedwalk() + assert.is_nil(ok) + assert.equals("pauseSpeedwalk(): no active speedwalk found", err) + end) + + it("resumeSpeedwalk refuses to resume an already running speedwalk", function() + speedwalk("2n1e", false, 1) + local ok, err = resumeSpeedwalk() + assert.is_nil(ok) + assert.equals("resumeSpeedwalk(): attempted to resume an already running speedwalk", err) end) end) @@ -465,12 +493,16 @@ describe("Tests Other.lua functions", function() local lastLine = getCurrentLine() assert.equal("This line should not be deleted", lastLine) _G.multimatches = {} + s:revert() end) end) describe("Tests timeframe", function() teardown(function() + -- timeframe schedules a real cleanup tempTimer; cancel any pending ones + -- and clear the test variable. + killtimeframe("TIMEFRAME_TEST_VARIABLE") TIMEFRAME_TEST_VARIABLE = nil end) @@ -493,7 +525,391 @@ describe("Tests Other.lua functions", function() end) end) - --[[ + describe("Tests the stopwatch family", function() + -- Stopwatches are non-persistent by default, so they are not written to the + -- profile, but every stopwatch created here is deleted in teardown anyway. + -- A stopped stopwatch does not advance, so adjustStopWatch on one gives an + -- exact, deterministic elapsed time with no sleeping. Only the running case + -- (stopStopWatch below) needs a tolerance for wall-clock drift. + local createdIds = {} + + local function track(id) + table.insert(createdIds, id) + return id + end + + local function assertClose(expected, actual, tolerance) + tolerance = tolerance or 0.5 + assert.is_true(math.abs(expected - actual) <= tolerance, + string.format("expected roughly %s but got %s", tostring(expected), tostring(actual))) + end + + teardown(function() + for _, id in ipairs(createdIds) do + pcall(deleteStopWatch, id) + end + createdIds = {} + end) + + describe("createStopWatch", function() + it("returns a numeric id and autostarts by default", function() + local id = track(createStopWatch()) + assert.is_number(id) + local watches = getStopWatches() + assert.is_table(watches[id]) + assert.is_true(watches[id].isRunning) + end) + + it("does not autostart when given a name (string form)", function() + local id = track(createStopWatch("stopwatchSpecNamed")) + assert.is_number(id) + assert.is_false(getStopWatches()[id].isRunning) + assert.equals("stopwatchSpecNamed", getStopWatches()[id].name) + end) + + it("honours an explicit autostart boolean", function() + local id = track(createStopWatch(false)) + assert.is_false(getStopWatches()[id].isRunning) + end) + + it("errors on an unsupported first argument type", function() + assert.has_error(function() createStopWatch({}) end) + end) + + it("refuses to create a second stopwatch with an existing name", function() + track(createStopWatch("stopwatchSpecDuplicate")) + local ok, err = createStopWatch("stopwatchSpecDuplicate") + assert.is_nil(ok) + assert.is_string(err) + end) + end) + + describe("getStopWatchTime and adjustStopWatch", function() + it("adjustStopWatch shifts the elapsed time of a stopped stopwatch deterministically", function() + local id = track(createStopWatch(false)) + -- adjusting an as-yet-unstarted stopwatch initialises it at that value + assert.is_true(adjustStopWatch(id, 12.5)) + assert.equals(12.5, getStopWatchTime(id)) + assert.is_true(adjustStopWatch(id, -2.5)) + assert.equals(10.0, getStopWatchTime(id)) + end) + + it("getStopWatchTime resolves a stopwatch by its name", function() + local id = track(createStopWatch("stopwatchSpecByName")) + adjustStopWatch(id, 5) + assert.equals(5, getStopWatchTime("stopwatchSpecByName")) + end) + + it("returns nil and a message for an unknown numeric id", function() + local ok, err = getStopWatchTime(999999) + assert.is_nil(ok) + assert.is_string(err) + end) + + it("returns nil and a message for an unknown name", function() + local ok, err = getStopWatchTime("stopwatchSpecNoSuchName") + assert.is_nil(ok) + assert.is_string(err) + end) + + it("errors when the first argument is neither number nor string", function() + assert.has_error(function() getStopWatchTime({}) end) + end) + end) + + describe("start, stop and reset", function() + it("stopStopWatch returns the elapsed time and freezes it", function() + local id = track(createStopWatch(false)) + startStopWatch(id) + adjustStopWatch(id, 7) + local elapsed = stopStopWatch(id) + assertClose(7, elapsed) + assert.is_false(getStopWatches()[id].isRunning) + end) + + it("resetStopWatch zeroes a stopped, initialised stopwatch", function() + local id = track(createStopWatch(false)) + adjustStopWatch(id, 30) + assert.is_true(resetStopWatch(id)) + assert.equals(0, getStopWatchTime(id)) + end) + + it("startStopWatch on an unknown id returns nil and a message", function() + local ok, err = startStopWatch(888888) + assert.is_nil(ok) + assert.is_string(err) + end) + end) + + describe("setStopWatchName", function() + it("renames a stopwatch identified by id", function() + local id = track(createStopWatch(false)) + assert.is_true(setStopWatchName(id, "stopwatchSpecRenamed")) + assert.equals("stopwatchSpecRenamed", getStopWatches()[id].name) + -- and it is now resolvable by the new name + assert.is_number(getStopWatchTime("stopwatchSpecRenamed")) + end) + + it("returns nil and a message when renaming an unknown id", function() + local ok, err = setStopWatchName(777777, "stopwatchSpecNope") + assert.is_nil(ok) + assert.is_string(err) + end) + end) + + describe("setStopWatchPersistence", function() + it("marks a stopwatch persistent and this is reflected in getStopWatches", function() + local id = track(createStopWatch(false)) + assert.is_false(getStopWatches()[id].isPersistent) + assert.is_true(setStopWatchPersistence(id, true)) + assert.is_true(getStopWatches()[id].isPersistent) + -- reset persistence so the stopwatch is never written to the profile + assert.is_true(setStopWatchPersistence(id, false)) + end) + + it("returns nil and a message for an unknown id", function() + local ok, err = setStopWatchPersistence(666666, true) + assert.is_nil(ok) + assert.is_string(err) + end) + end) + + describe("getStopWatchBrokenDownTime", function() + it("returns a table broken down into days/hours/minutes/seconds", function() + local id = track(createStopWatch(false)) + -- 1 day, 2 hours, 3 minutes, 4 seconds + adjustStopWatch(id, 4 + 3*60 + 2*3600 + 1*86400) + local t = getStopWatchBrokenDownTime(id) + assert.is_table(t) + assert.equals(1, t.days) + assert.equals(2, t.hours) + assert.equals(3, t.minutes) + assert.equals(4, t.seconds) + assert.is_boolean(t.negative) + end) + + it("flags negative elapsed time with the negative field", function() + local id = track(createStopWatch(false)) + adjustStopWatch(id, -90) -- one minute thirty seconds in the past + local t = getStopWatchBrokenDownTime(id) + assert.is_true(t.negative) + assert.equals(1, t.minutes) + assert.equals(30, t.seconds) + end) + end) + + describe("deleteStopWatch", function() + it("removes a stopwatch so it can no longer be read back", function() + local id = createStopWatch(false) + adjustStopWatch(id, 1) + assert.is_table(getStopWatches()[id]) + assert.is_true(deleteStopWatch(id)) + assert.is_nil(getStopWatches()[id]) + local ok = getStopWatchTime(id) + assert.is_nil(ok) + end) + + it("returns nil and a message for an unknown id", function() + local ok, err = deleteStopWatch(555555) + assert.is_nil(ok) + assert.is_string(err) + end) + end) + + describe("getStopWatches", function() + it("reports name, running, persistent and elapsed time for each stopwatch", function() + local id = track(createStopWatch("stopwatchSpecReport")) + adjustStopWatch(id, 3) + local entry = getStopWatches()[id] + assert.equals("stopwatchSpecReport", entry.name) + assert.is_boolean(entry.isRunning) + assert.is_boolean(entry.isPersistent) + assert.is_table(entry.elapsedTime) + assert.equals(3, entry.elapsedTime.decimalSeconds) + end) + end) + end) + + describe("Tests getConfig and setConfig round-trips", function() + -- The supported option list is discovered from getConfig() at runtime rather + -- than hard-coded, so this adapts to whichever build runs it. Every value + -- changed here is restored (config is written to the profile on close). Keys + -- with lossy or multi-valued representations (showSentText, the string enums + -- and the numeric/table keys) are handled in dedicated tests below; map keys + -- (which need an open mapper to set) are exercised only when settable. + local originalValues = {} + -- show3dMapView is skipped because flipping it to true opens the 3D OpenGL + -- map view. Initialising the software GL stack under headless CI leaks + -- one-time allocations in a GL driver module that is unloaded before exit, + -- so leak detection flags it and it cannot be name-suppressed. The 3D view + -- is not what this config round-trip is meant to exercise. + local skipInGenericLoop = { showSentText = true, show3dMapView = true } + + local function snapshot(key) + if originalValues[key] == nil then + originalValues[key] = getConfig(key) + end + end + + local function restore(key) + if originalValues[key] ~= nil then + setConfig(key, originalValues[key]) + originalValues[key] = nil + end + end + + teardown(function() + -- safety net for anything a failing assertion left changed + for key, value in pairs(originalValues) do + pcall(setConfig, key, value) + end + originalValues = {} + end) + + it("returns a table of the current configuration when called with no arguments", function() + local cfg = getConfig() + assert.is_table(cfg) + assert.is_boolean(cfg.enableGMCP) + assert.is_boolean(cfg.editorAutoComplete) + end) + + it("round-trips every boolean configuration option", function() + local settable = 0 + for key, value in pairs(getConfig()) do + if type(value) == "boolean" and not skipInGenericLoop[key] then + snapshot(key) + local ok = setConfig(key, not value) + if ok then + assert.equals(not value, getConfig(key), "round-trip failed for boolean config key: " .. key) + settable = settable + 1 + else + -- not settable in this environment (e.g. a map option with the + -- mapper closed); the getter still returns a boolean + assert.is_boolean(getConfig(key), "expected boolean for config key: " .. key) + end + restore(key) + end + end + assert.is_true(settable > 0, "expected at least one settable boolean config option") + end) + + it("round-trips the showSentText enum without losing the mode", function() + -- getConfig(key, true) returns the string form; the boolean form collapses + -- 'always' and 'script' both onto true, so restore using the string form. + -- Register the string original in originalValues so the teardown safety net + -- can restore it if an assertion below fails partway through. + local original = getConfig("showSentText", true) + assert.is_string(original) + originalValues.showSentText = original + for _, mode in ipairs({"never", "always", "script"}) do + assert.is_true(setConfig("showSentText", mode)) + assert.equals(mode, getConfig("showSentText", true)) + end + -- the legacy boolean form reads false only for 'never' + assert.is_true(setConfig("showSentText", "never")) + assert.is_false(getConfig("showSentText")) + assert.is_true(setConfig("showSentText", "always")) + assert.is_true(getConfig("showSentText")) + setConfig("showSentText", original) + assert.equals(original, getConfig("showSentText", true)) + originalValues.showSentText = nil + end) + + it("round-trips the string enum options", function() + local enums = { + caretShortcut = {"none", "tab", "ctrltab", "f6"}, + blankLinesBehaviour = {"show", "hide", "replacewithspace"}, + controlCharacterHandling = {"asis", "oem", "picture"}, + ambiguousEAsianWidthCharacters = {"narrow", "wide", "auto"}, + } + local exercised = 0 + for key, values in pairs(enums) do + if getConfig(key) ~= nil then + snapshot(key) + for _, value in ipairs(values) do + assert.is_true(setConfig(key, value), "could not set " .. key .. " to " .. value) + assert.equals(value, getConfig(key)) + end + restore(key) + exercised = exercised + 1 + end + end + assert.is_true(exercised > 0, "expected at least one string enum config option") + end) + + it("errors on a wrongly typed value for a boolean option", function() + -- setConfig defers to getVerifiedBool, which raises rather than silently + -- coercing; the flag is never assigned so there is nothing to restore. + assert.has_error(function() setConfig("enableGMCP", "not a boolean") end) + end) + + it("rejects an invalid string for an enum option", function() + snapshot("caretShortcut") + local ok, err = setConfig("caretShortcut", "definitelyNotAValidShortcut") + assert.is_nil(ok) + assert.is_string(err) + restore("caretShortcut") + end) + + it("round-trips commandLineHistorySaveSize (numeric option)", function() + snapshot("commandLineHistorySaveSize") + assert.is_true(setConfig("commandLineHistorySaveSize", 42)) + assert.equals(42, getConfig("commandLineHistorySaveSize")) + restore("commandLineHistorySaveSize") + end) + + it("validates the undoServerWrapWidth range when the option exists", function() + if getConfig("undoServerWrapWidth") == nil then + -- option not present in this build; setting it is rejected as unknown + assert.is_nil((setConfig("undoServerWrapWidth", 42))) + return + end + snapshot("undoServerWrapWidth") + assert.is_true(setConfig("undoServerWrapWidth", 42)) + assert.equals(42, getConfig("undoServerWrapWidth")) + assert.is_nil((setConfig("undoServerWrapWidth", 10))) -- below the minimum of 20 + assert.is_nil((setConfig("undoServerWrapWidth", 600))) -- above the maximum of 500 + restore("undoServerWrapWidth") + end) + + it("returns nil and a message for an unknown key", function() + local value, message = getConfig("totallyBogusConfigKey") + assert.is_nil(value) + assert.is_string(message) + end) + + it("setConfig returns nil and a message for an unknown key", function() + local ok, message = setConfig("totallyBogusConfigKey", true) + assert.is_nil(ok) + assert.is_string(message) + end) + + it("getConfig and setConfig reject an empty key", function() + assert.is_nil((getConfig(""))) + assert.is_nil((setConfig("", true))) + end) + + it("setConfig applies a table of options in one call", function() + snapshot("enableGMCP") + snapshot("editorAutoComplete") + local target = not getConfig("enableGMCP") + local target2 = not getConfig("editorAutoComplete") + setConfig({ enableGMCP = target, editorAutoComplete = target2 }) + assert.equals(target, getConfig("enableGMCP")) + assert.equals(target2, getConfig("editorAutoComplete")) + restore("enableGMCP") + restore("editorAutoComplete") + end) + + it("getConfig returns a keyed table when given a list of keys", function() + local result = getConfig({ "enableGMCP", "editorAutoComplete" }) + assert.is_table(result) + assert.equals(getConfig("enableGMCP"), result.enableGMCP) + assert.equals(getConfig("editorAutoComplete"), result.editorAutoComplete) + end) + end) + + --[[ TODO: remember() loadVars() @@ -509,7 +925,6 @@ describe("Tests Other.lua functions", function() registerAnonymousEventHandler() killAnonymousEventHandler() dispatchEventToFunctions() - timeframe() killtimeframe() translateTable() ]] diff --git a/src/mudlet-lua/tests/StringUtils_spec.lua b/src/mudlet-lua/tests/StringUtils_spec.lua index 35661cb52..b375ffb50 100644 --- a/src/mudlet-lua/tests/StringUtils_spec.lua +++ b/src/mudlet-lua/tests/StringUtils_spec.lua @@ -65,6 +65,14 @@ describe("Tests StringUtils.lua functions", function() local suffix = "system" assert.is_false(string.ends(s, suffix)) end) + + it("should return true for an empty suffix", function() + assert.is_true(("This is a test"):ends("")) + end) + + it("should return false when the suffix is longer than the string", function() + assert.is_false(("hi"):ends("this is far too long")) + end) end) describe("Tests the functionality of string.genNocasePattern", function() @@ -138,6 +146,25 @@ describe("Tests StringUtils.lua functions", function() local actual = str:split("") assert.same(expected, actual) end) + + it("should split on a multi-character delimiter", function() + local str = "alpha::beta::gamma" + local expected = { "alpha", "beta", "gamma" } + assert.same(expected, str:split("::")) + end) + + it("should treat the delimiter as a Lua pattern, not a plain string", function() + -- '.' is the 'any character' pattern, so it does not split on literal dots; + -- the dot must be escaped to split on real dots. + assert.same({ "1", "2", "3" }, ("1.2.3"):split("%.")) + assert.are_not.same({ "1", "2", "3" }, ("1.2.3"):split(".")) + end) + + it("should produce empty leading and trailing segments when the delimiter is at the edges", function() + local str = ",a,b," + local expected = { "", "a", "b", "" } + assert.same(expected, str:split(",")) + end) end) describe("Tests the functionality of string.starts", function() @@ -150,6 +177,15 @@ describe("Tests StringUtils.lua functions", function() local str = "This is a test" assert.is_false(str:starts("Elephant")) end) + + it("should return true for an empty prefix", function() + assert.is_true(("This is a test"):starts("")) + end) + + it("should return true when the prefix is the whole string", function() + local str = "This is a test" + assert.is_true(str:starts(str)) + end) end) describe("Tests the functionality of string.title", function() @@ -171,6 +207,14 @@ describe("Tests StringUtils.lua functions", function() local errfn = function() string.title(str) end assert.has_error(errfn, "string.title: bad argument #1 type (string to title as string expected, got table!)") end) + + it("should return an empty string unchanged", function() + assert.equals("", string.title("")) + end) + + it("should leave a string that does not start with a lowercase letter unchanged", function() + assert.equals("123abc", string.title("123abc")) + end) end) describe("Tests the functionality of string.trim", function() @@ -195,6 +239,10 @@ describe("Tests StringUtils.lua functions", function() assert.equals(str, string.trim(str)) assert.equals(str, str:trim()) end) + + it("should strip leading and trailing tabs and newlines, not just spaces", function() + assert.equals("this is a test", ("\t\n this is a test \n\t"):trim()) + end) end) describe("Tests the functionality of string.patternEscape", function() diff --git a/src/mudlet-lua/tests/TableUtils_spec.lua b/src/mudlet-lua/tests/TableUtils_spec.lua index 9a01d15a9..98d3673cb 100644 --- a/src/mudlet-lua/tests/TableUtils_spec.lua +++ b/src/mudlet-lua/tests/TableUtils_spec.lua @@ -105,8 +105,9 @@ describe("Tests TableUtils.lua functions", function() end) end) - -- methods skipped here: printTable, _printTable, listPrint, listAdd, listRemove - -- they are undocumented and unused in our own code. + -- __printTable is an internal helper of printTable and is not tested directly; + -- printTable, listPrint, listAdd and listRemove are covered near the end of + -- this file. describe("Tests the functionality of table.size", function() @@ -796,4 +797,101 @@ describe("Tests TableUtils.lua functions", function() assert.same(expected, actual) end) end) + + describe("Tests the functionality of table.deepcopy nested independence", function() + it("should copy nested tables so mutating the copy does not affect the original", function() + local original = { a = 1, nested = { b = 2, deep = { c = 3 } } } + local copy = table.deepcopy(original) + copy.nested.b = 20 + copy.nested.deep.c = 30 + assert.equals(2, original.nested.b) + assert.equals(3, original.nested.deep.c) + -- the nested tables are distinct references + assert.are_not.equal(original.nested, copy.nested) + assert.are_not.equal(original.nested.deep, copy.nested.deep) + end) + + it("should preserve the metatable of the copied table", function() + local mt = { __index = function() return "default" end } + local original = setmetatable({}, mt) + local copy = table.deepcopy(original) + assert.equals(mt, getmetatable(copy)) + assert.equals("default", copy.anything) + end) + + it("should return non-table values unchanged", function() + assert.equals(5, table.deepcopy(5)) + assert.equals("text", table.deepcopy("text")) + end) + end) + + describe("Tests the functionality of spairs on an empty table", function() + it("should iterate zero times over an empty table", function() + local count = 0 + for _ in spairs({}) do + count = count + 1 + end + assert.equals(0, count) + end) + end) + + describe("Tests the functionality of listAdd", function() + it("should append an item to the end of the list", function() + local list = { "one", "two" } + listAdd(list, "three") + assert.same({ "one", "two", "three" }, list) + end) + + it("should append to an empty list", function() + local list = {} + listAdd(list, "only") + assert.same({ "only" }, list) + end) + end) + + describe("Tests the functionality of listRemove", function() + -- listRemove removes during an ipairs loop, so consecutive duplicates are a + -- known skip bug (removing index i shifts i+1 into i, which the loop then + -- skips). That buggy behaviour is deliberately NOT pinned here; only the + -- single-match and no-match paths, which the quirk cannot affect, are tested. + it("should remove a matching item from the list", function() + local list = { "one", "two", "three" } + listRemove(list, "two") + assert.same({ "one", "three" }, list) + end) + + it("should leave the list unchanged when the item is not present", function() + local list = { "one", "two" } + listRemove(list, "missing") + assert.same({ "one", "two" }, list) + end) + end) + + describe("Tests the contract of printTable", function() + -- printTable/listPrint write to the screen via echo; we spy on the real + -- echo (pass-through) to assert the framing lines without mocking it. + it("should echo a header, a line per key/value pair and a footer", function() + local echo = spy.on(_G, "echo") + finally(function() echo:revert() end) + printTable({ alpha = "one", beta = "two" }) + -- header + 2 pairs + footer; header and footer are the same dashed string, + -- so the count is what pins that both framing lines are present + assert.spy(echo).was.called(4) + assert.spy(echo).was.called_with("-------------------------------------------------------\n") + assert.spy(echo).was.called_with("key=alpha value=one\n") + assert.spy(echo).was.called_with("key=beta value=two\n") + end) + end) + + describe("Tests the contract of listPrint", function() + it("should echo a numbered line for each list entry framed by dashed lines", function() + local echo = spy.on(_G, "echo") + finally(function() echo:revert() end) + listPrint({ "first", "second" }) + -- header + 2 entries + footer + assert.spy(echo).was.called(4) + assert.spy(echo).was.called_with("1. ) first\n") + assert.spy(echo).was.called_with("2. ) second\n") + end) + end) end) From b1f4a06e085cf1a3022a0abf0934f9ab285b8c5f Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Thu, 30 Jul 2026 14:07:03 +0200 Subject: [PATCH 025/155] Fix: ttsGetQueue out-of-bounds read and ttsClearQueue message (#9471) #### Brief overview of PR changes/additions `ttsGetQueue`'s boundary check used `>` instead of `>=`, so an index equal to the queue size read one element past the end of the `QStringList`. It now returns `false` cleanly for that case. `ttsClearQueue`'s out-of-bounds warning misused `QString::arg(int, int)`: the queue size was consumed as the field-width argument, leaving a literal `%2` in the message. Both placeholders are now filled correctly with chained `.arg()` calls. #### Motivation for adding to Mudlet The `ttsGetQueue` off-by-one is a heap-use-after-free proven under ASan - a hard `QList` assert in debug builds, and silent garbage-as-data in release builds. The `ttsClearQueue` message bug produced a broken, unhelpful error string. #### Other info (issues closed, discussion etc) Engine-free boundary specs added to `Miscallaneous_spec`, verified in-binary under ASan. Tested by hand. Squash-merge with: ``` Assisted-by: Claude:claude-fable-5 Signed-off-by: Vadim Peretokin ``` https://github.com/user-attachments/assets/7412dcdf-5c7b-479b-9fd6-82bb935a676a --- src/TLuaInterpreterTextToSpeech.cpp | 4 +-- src/mudlet-lua/tests/Miscallaneous_spec.lua | 34 +++++++++++++++++++++ 2 files changed, 36 insertions(+), 2 deletions(-) diff --git a/src/TLuaInterpreterTextToSpeech.cpp b/src/TLuaInterpreterTextToSpeech.cpp index ada892cb4..134c9a12e 100644 --- a/src/TLuaInterpreterTextToSpeech.cpp +++ b/src/TLuaInterpreterTextToSpeech.cpp @@ -179,7 +179,7 @@ int TLuaInterpreter::ttsClearQueue(lua_State* L) int index = getVerifiedInt(L, __func__, 1, "index"); index--; if (index < 0 || index >= speechQueue.size()) { - return warnArgumentValue(L, __func__, qsl("index %1 out of bounds for queue size %2").arg(index + 1, speechQueue.size())); + return warnArgumentValue(L, __func__, qsl("index %1 out of bounds for queue size %2").arg(index + 1).arg(speechQueue.size())); } speechQueue.remove(index); @@ -231,7 +231,7 @@ int TLuaInterpreter::ttsGetQueue(lua_State* L) if (lua_gettop(L) > 0) { int index = getVerifiedInt(L, __func__, 1, "index"); index--; - if (index < 0 || index > speechQueue.size()) { + if (index < 0 || index >= speechQueue.size()) { lua_pushboolean(L, false); return 1; } diff --git a/src/mudlet-lua/tests/Miscallaneous_spec.lua b/src/mudlet-lua/tests/Miscallaneous_spec.lua index d9632c57b..f46d7287f 100644 --- a/src/mudlet-lua/tests/Miscallaneous_spec.lua +++ b/src/mudlet-lua/tests/Miscallaneous_spec.lua @@ -53,6 +53,40 @@ describe("Tests C++ functions in the Miscallaneous category", function() end) end) + describe("Tests the functionality of ttsGetQueue", function() + -- Mudlet compiled without TTS support installs dummy tts functions + -- which return nil, whereas the real ttsGetQueue() returns a table + local function ttsAvailable() + return type(ttsGetQueue()) == "table" + end + + it("should return a table when called without an index", function() + if not ttsAvailable() then + pending("TTS is not available in this build") + return + end + assert.is_table(ttsGetQueue()) + end) + + it("should return false for an index just past the end of the queue", function() + if not ttsAvailable() then + pending("TTS is not available in this build") + return + end + ttsClearQueue() + -- on an empty queue, index 1 is exactly one past the end (index == size) + assert.is_false(ttsGetQueue(1)) + end) + + it("should return false for an index below the start of the queue", function() + if not ttsAvailable() then + pending("TTS is not available in this build") + return + end + assert.is_false(ttsGetQueue(0)) + end) + end) + describe("Tests the functionality of getTimestamp", function() it("should return a string for a valid line number", function() echo("getTimestamp test line\n") From 106bb9d09328b5d379966d3e283bae6478f88791 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Thu, 30 Jul 2026 14:08:54 +0200 Subject: [PATCH 026/155] infrastructure: networking, MMCP, media and Discord API contract tests (#9535) #### Brief overview of PR changes/additions - New Networking_spec.lua (domain home for net/MMCP/media/Discord - blessed by Vadi) with 92 offline contract specs + 3 sendGMCP contracts in GMCP_spec.lua - Pins argument validation and disconnected/no-session error shapes for 56 functions; zero network egress, zero mocks #### Motivation for adding to Mudlet These stub-blocked domains had almost no coverage; contracts lock in error shapes now, effect tests follow with the stubs (Waves 2-3). #### Other info (issues closed, discussion etc) Part of the Lua API test-coverage program (Wave 1). Found sendGMCP/sendATCP "%1" printf bugs and performHttpRequest wrong-typename index (filed separately, asserted loosely so fixes won't break these specs). MMCP startServer family confirmed unregistered (uncoverable). **Test case:** run the busted suite offline - Networking_spec and GMCP_spec pass green, twice, with no sockets opened. Awaiting build/test by a maintainer; squash-merge with: Assisted-by: Claude:claude-opus-4-8 (Signed-off-by to be added at squash after testing) --- src/TLuaInterpreter.cpp | 48 +-- src/TLuaInterpreter.h | 2 + src/TLuaInterpreterNetworking.cpp | 96 +++-- src/mudlet-lua/tests/GMCP_spec.lua | 31 +- src/mudlet-lua/tests/Networking_spec.lua | 496 +++++++++++++++++++++++ src/mudlet-lua/tests/Trigger_spec.lua | 19 +- 6 files changed, 606 insertions(+), 86 deletions(-) create mode 100644 src/mudlet-lua/tests/Networking_spec.lua diff --git a/src/TLuaInterpreter.cpp b/src/TLuaInterpreter.cpp index 313d52ab9..dcc0c14be 100644 --- a/src/TLuaInterpreter.cpp +++ b/src/TLuaInterpreter.cpp @@ -4838,49 +4838,31 @@ int TLuaInterpreter::performHttpRequest(lua_State* L, const char* functionName, } const QString urlString = getVerifiedString(L, functionName, pos + 2, "remote url"); - const QUrl url = QUrl::fromUserInput(urlString); - if (!url.isValid()) { - return warnArgumentValue(L, __func__, qsl("url is invalid, reason: %1.").arg(url.errorString())); - } + // Validate the optional headers and file arguments before creating the QUrl + // / QNetworkRequest below: lua_error() longjmps past C++ destructors, so + // nothing heap-owning may be alive when a validation failure fires. + validateHttpHeaders(L, pos + 3, functionName); - QNetworkRequest request = QNetworkRequest(url); - mudlet::self()->setNetworkRequestDefaults(url, request); - - if (!lua_istable(L, pos + 3) && !lua_isnoneornil(L, pos + 3)) { - lua_pushfstring(L, "%s: bad argument #%d type (headers as a table expected, got %s!)", functionName, pos + 3, luaL_typename(L, 3)); - return lua_error(L); - } - if (lua_istable(L, pos + 3)) { - lua_pushnil(L); - while (lua_next(L, pos + 3) != 0) { - // key at index -2 and value at index -1 - if (lua_type(L, -1) == LUA_TSTRING && lua_type(L, -2) == LUA_TSTRING) { - request.setRawHeader(QByteArray(lua_tostring(L, -2)), QByteArray(lua_tostring(L, -1))); - } else { - lua_pushfstring(L, - "%s: bad argument #%d type (custom headers must be strings, got header: %s (should be string) and value: %s (should be string))", - functionName, - pos + 3, - luaL_typename(L, -2), - luaL_typename(L, -1)); - return lua_error(L); - } - // removes value, but keeps key for next iteration - lua_pop(L, 1); - } - } - - QByteArray fileToUpload; QString fileLocation; if (!lua_isstring(L, pos + 4) && !lua_isnoneornil(L, pos + 4)) { - lua_pushfstring(L, "%s: bad argument #%d type (file to send as string location expected, got %s!)", functionName, pos + 4, luaL_typename(L, 4)); + lua_pushfstring(L, "%s: bad argument #%d type (file to send as string location expected, got %s!)", functionName, pos + 4, luaL_typename(L, pos + 4)); return lua_error(L); } if (lua_isstring(L, pos + 4)) { fileLocation = lua_tostring(L, pos + 4); } + const QUrl url = QUrl::fromUserInput(urlString); + if (!url.isValid()) { + return warnArgumentValue(L, __func__, qsl("url is invalid, reason: %1.").arg(url.errorString())); + } + + QNetworkRequest request = QNetworkRequest(url); + mudlet::self()->setNetworkRequestDefaults(url, request); + applyHttpHeaders(L, pos + 3, request); + + QByteArray fileToUpload; if (!fileLocation.isEmpty()) { QFile file(fileLocation); if (!file.open(QFile::ReadOnly)) { diff --git a/src/TLuaInterpreter.h b/src/TLuaInterpreter.h index f3e758840..42ca5650c 100644 --- a/src/TLuaInterpreter.h +++ b/src/TLuaInterpreter.h @@ -835,6 +835,8 @@ private: static std::pair discordApiEnabled(lua_State*, bool writeAccess = false); static void setRequestDefaults(const QUrl& url, QNetworkRequest& request); static int performHttpRequest(lua_State*, const char* functionName, const int pos, QNetworkAccessManager::Operation operation, const QString& verb); + static void validateHttpHeaders(lua_State*, const int index, const char* functionName); + static void applyHttpHeaders(lua_State*, const int index, QNetworkRequest& request); // The last argument is only needed if the third one is true: static void generateElapsedTimeTable(lua_State*, const QStringList&, const bool, const qint64 elapsedTimeMilliSeconds = 0); static std::tuple getWatchId(lua_State*, Host&); diff --git a/src/TLuaInterpreterNetworking.cpp b/src/TLuaInterpreterNetworking.cpp index 580ed8a98..6995d6fd8 100644 --- a/src/TLuaInterpreterNetworking.cpp +++ b/src/TLuaInterpreterNetworking.cpp @@ -629,11 +629,59 @@ int TLuaInterpreter::setIrcServer(lua_State* L) return 2; } +// Validates the optional headers table at Lua stack index `index`: it must be +// absent/nil, or a table whose keys and values are all strings, otherwise a Lua +// error is raised. This has to run before any QUrl or QNetworkRequest is +// constructed, because lua_error() longjmps past C++ destructors and would +// otherwise leak those heap-owning Qt objects. +/*static*/ void TLuaInterpreter::validateHttpHeaders(lua_State* L, const int index, const char* functionName) +{ + if (!lua_istable(L, index)) { + if (!lua_isnoneornil(L, index)) { + lua_pushfstring(L, "%s: bad argument #%d type (headers as a table expected, got %s!)", functionName, index, luaL_typename(L, index)); + lua_error(L); + } + return; + } + lua_pushnil(L); + while (lua_next(L, index) != 0) { + // key at index -2 and value at index -1 + if (lua_type(L, -1) != LUA_TSTRING || lua_type(L, -2) != LUA_TSTRING) { + lua_pushfstring(L, + "%s: bad argument #%d type (custom headers must be strings, got header: %s (should be string) and value: %s (should be string))", + functionName, + index, + luaL_typename(L, -2), + luaL_typename(L, -1)); + lua_error(L); + } + // removes value, but keeps key for next iteration + lua_pop(L, 1); + } +} + +// Applies the already-validated headers table at `index` to `request`. Call +// validateHttpHeaders() first: this assumes every key/value is a string and +// never raises a Lua error, so it is safe to run with a live QNetworkRequest. +/*static*/ void TLuaInterpreter::applyHttpHeaders(lua_State* L, const int index, QNetworkRequest& request) +{ + if (!lua_istable(L, index)) { + return; + } + lua_pushnil(L); + while (lua_next(L, index) != 0) { + request.setRawHeader(QByteArray(lua_tostring(L, -2)), QByteArray(lua_tostring(L, -1))); + lua_pop(L, 1); + } +} + // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#getHTTP int TLuaInterpreter::getHTTP(lua_State* L) { auto& host = getHostFromLua(L); const QString urlString = getVerifiedString(L, __func__, 1, "remote url"); + validateHttpHeaders(L, 2, __func__); + const QUrl url = QUrl::fromUserInput(urlString); if (!url.isValid()) { return warnArgumentValue(L, __func__, qsl("url is invalid, reason: %1").arg(url.errorString())); @@ -641,28 +689,7 @@ int TLuaInterpreter::getHTTP(lua_State* L) QNetworkRequest request = QNetworkRequest(url); mudlet::self()->setNetworkRequestDefaults(url, request); - - if (!lua_istable(L, 2) && !lua_isnoneornil(L, 2)) { - lua_pushfstring(L, "getHTTP: bad argument #2 type (headers as a table expected, got %s!)", luaL_typename(L, 2)); - return lua_error(L); - } - if (lua_istable(L, 2)) { - lua_pushnil(L); - while (lua_next(L, 2) != 0) { - // key at index -2 and value at index -1 - if (lua_type(L, -1) == LUA_TSTRING && lua_type(L, -2) == LUA_TSTRING) { - request.setRawHeader(QByteArray(lua_tostring(L, -2)), QByteArray(lua_tostring(L, -1))); - } else { - lua_pushfstring(L, - "getHTTP: bad argument #2 type (custom headers must be strings, got header: %s (should be string) and value: %s (should be string))", - luaL_typename(L, -2), - luaL_typename(L, -1)); - return lua_error(L); - } - // removes value, but keeps key for next iteration - lua_pop(L, 1); - } - } + applyHttpHeaders(L, 2, request); host.updateProxySettings(host.mLuaInterpreter.mpFileDownloader); QNetworkReply* reply = host.mLuaInterpreter.mpFileDownloader->get(request); @@ -693,6 +720,8 @@ int TLuaInterpreter::deleteHTTP(lua_State* L) { auto& host = getHostFromLua(L); const QString urlString = getVerifiedString(L, __func__, 1, "remote url"); + validateHttpHeaders(L, 2, __func__); + const QUrl url = QUrl::fromUserInput(urlString); if (!url.isValid()) { return warnArgumentValue(L, __func__, qsl("url is invalid, reason: %1").arg(url.errorString())); @@ -700,28 +729,7 @@ int TLuaInterpreter::deleteHTTP(lua_State* L) QNetworkRequest request = QNetworkRequest(url); mudlet::self()->setNetworkRequestDefaults(url, request); - - if (!lua_istable(L, 2) && !lua_isnoneornil(L, 2)) { - lua_pushfstring(L, "deleteHTTP: bad argument #2 type (headers as a table expected, got %s!)", luaL_typename(L, 2)); - return lua_error(L); - } - if (lua_istable(L, 2)) { - lua_pushnil(L); - while (lua_next(L, 2) != 0) { - // key at index -2 and value at index -1 - if (lua_type(L, -1) == LUA_TSTRING && lua_type(L, -2) == LUA_TSTRING) { - request.setRawHeader(QByteArray(lua_tostring(L, -2)), QByteArray(lua_tostring(L, -1))); - } else { - lua_pushfstring(L, - "deleteHTTP: bad argument #2 type (custom headers must be strings, got header: %s (should be string) and value: %s (should be string))", - luaL_typename(L, -2), - luaL_typename(L, -1)); - return lua_error(L); - } - // removes value, but keeps key for next iteration - lua_pop(L, 1); - } - } + applyHttpHeaders(L, 2, request); host.updateProxySettings(host.mLuaInterpreter.mpFileDownloader); QNetworkReply* reply = host.mLuaInterpreter.mpFileDownloader->deleteResource(request); diff --git a/src/mudlet-lua/tests/GMCP_spec.lua b/src/mudlet-lua/tests/GMCP_spec.lua index 3d094b9a0..8a0e2e9a9 100644 --- a/src/mudlet-lua/tests/GMCP_spec.lua +++ b/src/mudlet-lua/tests/GMCP_spec.lua @@ -150,4 +150,33 @@ describe("tests the functionality of the gmod module", function() gmod.disableModule(user2, module2) end) end) -end) \ No newline at end of file +end) + +describe("Tests the argument and disconnected contract of sendGMCP", function() + -- Contract-only checks: sendGMCP is never mocked here and never reaches a + -- live game server. The self-test profile is forced into a disconnected + -- state so the connection guard is exercised deterministically; verifying + -- the actual bytes on the wire is a separate, stub-based effort. + local function contains(haystack, needle) + return type(haystack) == "string" and haystack:find(needle, 1, true) ~= nil + end + + before_each(function() + disconnect() + end) + + it("raises a Lua error when the message is not a string", function() + assert.has_error(function() sendGMCP({}) end) + assert.has_error(function() sendGMCP(true) end) + end) + + it("raises a Lua error when the optional second argument is not a string", function() + assert.has_error(function() sendGMCP("Core.Ping", {}) end) + end) + + it("returns nil and an explanatory message while disconnected", function() + local ok, err = sendGMCP("External.Discord.Hello") + assert.is_nil(ok) + assert.is_true(contains(err, "not connected to game server")) + end) +end) diff --git a/src/mudlet-lua/tests/Networking_spec.lua b/src/mudlet-lua/tests/Networking_spec.lua new file mode 100644 index 000000000..8ba07eccf --- /dev/null +++ b/src/mudlet-lua/tests/Networking_spec.lua @@ -0,0 +1,496 @@ +-- Contract-only specs for the networking, MMCP, media and Discord APIs. +-- +-- These functions all depend on live infrastructure for their real effect +-- (a connected game server, connected MMCP peers, an audio device, a running +-- Discord client). Those effects are covered by separate, stub-backed work. +-- What is verified here is the part that is fully deterministic offline: +-- argument validation, and the nil+message / hard-error shapes each function +-- returns when its precondition (a connection, a peer, an enabled protocol, +-- an available API) is not met. Nothing here mocks a real API function, opens +-- a socket, issues an HTTP request or asserts playback. +-- +-- This is a new per-domain spec file. The standing convention is to extend an +-- existing domain spec file, but there is no existing home for the networking, +-- MMCP, media or Discord Lua API; this file provides one for their contract +-- layer. Whether to keep it as a single combined file is a convention call for +-- review. + +local function contains(haystack, needle) + return type(haystack) == "string" and haystack:find(needle, 1, true) ~= nil +end + +-- Asserts that calling fn raises a Lua error whose message contains needle. +-- Matching a message substring (rather than merely "did it error?") ensures the +-- function is actually registered and reached its own argument validation: an +-- unregistered/nil function would raise a different "attempt to call" error. +local function assertArgError(fn, needle) + local ok, err = pcall(fn) + assert.is_false(ok) + assert.is_true(contains(err, needle)) +end + +describe("Networking send functions honour their disconnected/offline contracts", function() + -- Force a non-connected telnet state so the connection guards fire + -- deterministically regardless of what the self-test profile's socket is + -- doing. disconnect() only closes the socket; it issues no traffic. + before_each(function() + disconnect() + end) + + describe("sendMSDP", function() + it("raises a Lua error when called with no arguments", function() + assert.has_error(function() sendMSDP() end) + end) + + it("raises a Lua error when a value argument is not a string", function() + assert.has_error(function() sendMSDP("HEALTH", {}) end) + end) + + it("returns nil and a message while disconnected", function() + local ok, err = sendMSDP("HEALTH") + assert.is_nil(ok) + assert.is_true(contains(err, "not connected to game server")) + end) + end) + + describe("sendATCP", function() + it("raises a Lua error when the message is not a string", function() + assert.has_error(function() sendATCP({}) end) + end) + + it("returns nil and a message while disconnected", function() + local ok, err = sendATCP("Char.Login") + assert.is_nil(ok) + assert.is_true(contains(err, "not connected to game server")) + end) + end) + + describe("sendTelnetChannel102", function() + it("raises a Lua error when the payload is not a string", function() + assert.has_error(function() sendTelnetChannel102({}) end) + end) + + it("returns nil when the payload is not exactly two bytes", function() + local ok, err = sendTelnetChannel102("x") + assert.is_nil(ok) + assert.is_true(contains(err, "invalid message of length 1")) + end) + + it("returns nil when subchannel 102 has not been enabled by the server", function() + local ok, err = sendTelnetChannel102("ab") + assert.is_nil(ok) + assert.is_true(contains(err, "102 subchannel support has not been enabled")) + end) + end) + + describe("sendSocket", function() + it("raises a Lua error when the data is not a string", function() + assert.has_error(function() sendSocket({}) end) + end) + + it("returns nil and a message when the socket cannot accept the data", function() + local ok, err = sendSocket("noop") + assert.is_nil(ok) + assert.is_true(contains(err, "unable to send")) + end) + end) +end) + +describe("connectToServer validates its arguments without connecting", function() + it("raises a Lua error when the url is missing", function() + assert.has_error(function() connectToServer() end) + end) + + it("rejects an out-of-range port and returns nil plus a message", function() + local ok, err = connectToServer("example.invalid", 70000) + assert.is_nil(ok) + assert.is_true(contains(err, "invalid port number")) + end) + + it("rejects a port below 1", function() + local ok, err = connectToServer("example.invalid", 0) + assert.is_nil(ok) + assert.is_true(contains(err, "invalid port number")) + end) +end) + +describe("getConnectionInfo returns a host/port/connected triple", function() + it("returns a string, a number and a boolean", function() + local host, port, connected = getConnectionInfo() + assert.is_string(host) + assert.is_number(port) + assert.is_boolean(connected) + end) +end) + +describe("HTTP and download functions validate arguments before issuing a request", function() + -- Every case below returns (hard error, or nil+message) strictly before the + -- network call: either the url is invalid (so the request is refused locally) + -- or a valid-looking url is never contacted because a header/argument error is + -- raised first. + describe("downloadFile", function() + it("raises a Lua error when the local filename is missing", function() + assertArgError(function() downloadFile() end, "downloadFile: bad argument") + end) + + it("raises a Lua error when the url is missing", function() + assertArgError(function() downloadFile("/tmp/mudlet-contract-test") end, "downloadFile: bad argument") + end) + + it("returns nil for an invalid url without downloading", function() + local ok, err = downloadFile("/tmp/mudlet-contract-test", "") + assert.is_nil(ok) + assert.is_true(contains(err, "url is invalid")) + end) + end) + + describe("getHTTP", function() + it("raises a Lua error when the url is missing", function() + assertArgError(function() getHTTP() end, "getHTTP: bad argument") + end) + + it("returns nil for an invalid url without issuing a request", function() + local ok, err = getHTTP("") + assert.is_nil(ok) + assert.is_true(contains(err, "url is invalid")) + end) + + it("raises a Lua error when headers is not a table", function() + assertArgError(function() getHTTP("http://localhost/", 5) end, "getHTTP: bad argument") + end) + + it("raises a Lua error when a header value is not a string", function() + assertArgError(function() getHTTP("http://localhost/", {["X-Test"] = 5}) end, "getHTTP: bad argument") + end) + end) + + describe("deleteHTTP", function() + it("raises a Lua error when the url is missing", function() + assertArgError(function() deleteHTTP() end, "deleteHTTP: bad argument") + end) + + it("returns nil for an invalid url without issuing a request", function() + local ok, err = deleteHTTP("") + assert.is_nil(ok) + assert.is_true(contains(err, "url is invalid")) + end) + + it("raises a Lua error when headers is not a table", function() + assertArgError(function() deleteHTTP("http://localhost/", 5) end, "deleteHTTP: bad argument") + end) + + it("raises a Lua error when a header value is not a string", function() + assertArgError(function() deleteHTTP("http://localhost/", {["X-Test"] = 5}) end, "deleteHTTP: bad argument") + end) + end) + + describe("postHTTP", function() + it("raises a Lua error when the data argument is missing", function() + assertArgError(function() postHTTP() end, "postHTTP: bad argument") + end) + + it("raises a Lua error when the url is missing", function() + assertArgError(function() postHTTP("payload") end, "postHTTP: bad argument") + end) + + it("returns nil for an invalid url without issuing a request", function() + local ok, err = postHTTP("payload", "") + assert.is_nil(ok) + assert.is_true(contains(err, "url is invalid")) + end) + + it("raises a Lua error when headers is not a table", function() + assertArgError(function() postHTTP("payload", "http://localhost/", 5) end, "postHTTP: bad argument") + end) + end) + + describe("putHTTP", function() + it("raises a Lua error when the data argument is missing", function() + assertArgError(function() putHTTP() end, "putHTTP: bad argument") + end) + + it("raises a Lua error when the url is missing", function() + assertArgError(function() putHTTP("payload") end, "putHTTP: bad argument") + end) + end) + + describe("customHTTP", function() + it("raises a Lua error when the method is missing", function() + assertArgError(function() customHTTP() end, "customHTTP: bad argument") + end) + + it("raises a Lua error when the data argument is missing", function() + assertArgError(function() customHTTP("REPORT") end, "customHTTP: bad argument") + end) + + it("raises a Lua error when the url is missing", function() + assertArgError(function() customHTTP("REPORT", "payload") end, "customHTTP: bad argument") + end) + + it("raises a Lua error when headers is not a table", function() + assertArgError(function() customHTTP("REPORT", "payload", "http://localhost/", 5) end, "customHTTP: bad argument") + end) + end) +end) + +describe("openUrl validates its argument without launching anything", function() + it("raises a Lua error when the url is missing", function() + assertArgError(function() openUrl() end, "openUrl: bad argument") + end) + + it("raises a Lua error when the url is not a string", function() + assertArgError(function() openUrl({}) end, "openUrl: bad argument") + end) +end) + +describe("MMCP chat commands report the absence of a session", function() + -- With no connected chat peers, every registered command reports its + -- no-session state. initMMCPServer() runs lazily inside these calls; it + -- constructs the server object but never calls listen(), so no socket is + -- opened (only mmcpStartServer would, and it is not registered into the Lua + -- mmcp table). + local NO_CLIENTS = "no connected clients" + local NO_SUCH = "no client by that name or id" + + it("chatAll returns nil with no peers", function() + local ok, err = mmcp.chatAll("hi") + assert.is_nil(ok) + assert.is_true(contains(err, NO_CLIENTS)) + end) + + it("emoteAll returns nil with no peers", function() + local ok, err = mmcp.emoteAll("waves") + assert.is_nil(ok) + assert.is_true(contains(err, NO_CLIENTS)) + end) + + it("chatGroup returns nil with no peers", function() + local ok, err = mmcp.chatGroup("friends", "hi") + assert.is_nil(ok) + assert.is_true(contains(err, NO_CLIENTS)) + end) + + it("getClientFlags returns nil with no peers", function() + local ok, err = mmcp.getClientFlags("someone") + assert.is_nil(ok) + assert.is_true(contains(err, NO_CLIENTS)) + end) + + it("sendSideChannel returns nil with no peers", function() + local ok, err = mmcp.sendSideChannel("Chan", "msg") + assert.is_nil(ok) + assert.is_true(contains(err, NO_CLIENTS)) + end) + + it("chatTo returns nil for an unknown target", function() + local ok, err = mmcp.chatTo("nobody", "hi") + assert.is_nil(ok) + assert.is_true(contains(err, NO_SUCH)) + end) + + it("ping returns nil for an unknown target", function() + local ok, err = mmcp.ping("nobody") + assert.is_nil(ok) + assert.is_true(contains(err, NO_SUCH)) + end) + + it("setPrivate returns nil for an unknown target", function() + local ok, err = mmcp.setPrivate("nobody") + assert.is_nil(ok) + assert.is_true(contains(err, NO_SUCH)) + end) + + it("serve returns nil for an unknown target", function() + local ok, err = mmcp.serve("nobody") + assert.is_nil(ok) + assert.is_true(contains(err, NO_SUCH)) + end) + + it("snoop returns nil for an unknown target", function() + local ok, err = mmcp.snoop("nobody") + assert.is_nil(ok) + assert.is_true(contains(err, NO_SUCH)) + end) + + it("allowSnoop returns nil for an unknown target", function() + local ok, err = mmcp.allowSnoop("nobody") + assert.is_nil(ok) + assert.is_true(contains(err, NO_SUCH)) + end) + + it("setGroup returns nil for an unknown target", function() + local ok, err = mmcp.setGroup("nobody", "team") + assert.is_nil(ok) + assert.is_true(contains(err, NO_SUCH)) + end) + + it("disconnect returns nil for an unknown target", function() + local ok, err = mmcp.disconnect("nobody") + assert.is_nil(ok) + assert.is_true(contains(err, NO_SUCH)) + end) + + it("ignore returns nil for an unknown target", function() + local ok, err = mmcp.ignore("nobody") + assert.is_nil(ok) + assert.is_true(contains(err, NO_SUCH)) + end) + + it("getClientList returns nil when there are no peers", function() + assert.is_nil(mmcp.getClientList()) + end) + + it("chatTo requires a target argument", function() + assert.has_error(function() mmcp.chatTo() end) + end) + + it("chatAll requires a message argument", function() + assert.has_error(function() mmcp.chatAll() end) + end) + + describe("mmcp.call", function() + it("raises a Lua error when the host is missing", function() + assert.has_error(function() mmcp.call() end) + end) + + it("rejects an out-of-range port without connecting", function() + local ok, err = mmcp.call("127.0.0.1", 70000) + assert.is_nil(ok) + assert.is_true(contains(err, "invalid port number")) + end) + end) + + describe("mmcp.chatName", function() + it("returns the current chat name as a string", function() + assert.is_string(mmcp.chatName()) + end) + + it("rejects names containing a tilde or comma", function() + local ok, err = mmcp.chatName("bad~name") + assert.is_nil(ok) + assert.is_true(contains(err, "tilde")) + end) + end) +end) + +describe("Media playback functions validate their parameters", function() + -- None of these reach playMedia()/stopMedia() on a real file, so no playback + -- is started: each returns before the media engine is touched. + describe("playSoundFile", function() + it("raises a Lua error when called with no arguments", function() + assertArgError(function() playSoundFile() end, "playSoundFile: need at least one argument") + end) + + it("raises a Lua error when the table form has no name", function() + assert.has_error(function() playSoundFile({}) end) + end) + + it("raises a Lua error for a negative fadein in the table form", function() + assert.has_error(function() playSoundFile({name = "x.wav", fadein = -1}) end) + end) + + it("returns nil when the ordered form supplies no filename", function() + local ok, err = playSoundFile(nil) + assert.is_nil(ok) + assert.is_true(contains(err, "missing argument 1")) + end) + end) + + describe("playMusicFile", function() + it("raises a Lua error when called with no arguments", function() + assertArgError(function() playMusicFile() end, "playMusicFile: need at least one argument") + end) + + it("raises a Lua error when the table form has no name", function() + assert.has_error(function() playMusicFile({}) end) + end) + + it("raises a Lua error for a negative fadeout in the table form", function() + assert.has_error(function() playMusicFile({name = "x.mp3", fadeout = -5}) end) + end) + end) + + describe("stopSounds", function() + it("returns true when stopping everything with no arguments", function() + assert.is_true(stopSounds()) + end) + + it("raises a Lua error for a negative fadeout in the table form", function() + assert.has_error(function() stopSounds({fadeout = -1}) end) + end) + + it("raises a Lua error when fadeaway is not a boolean", function() + assert.has_error(function() stopSounds({fadeaway = "yes"}) end) + end) + end) +end) + +describe("receiveMSP reports MSP is not enabled while offline", function() + it("returns nil and a message when MSP has not been negotiated", function() + local ok, err = receiveMSP("!!SOUND(x.wav)") + assert.is_nil(ok) + assert.is_true(contains(err, "MSP is not currently enabled")) + end) +end) + +describe("Discord Lua API availability contract", function() + -- Every rich-presence function is gated on the Discord API being available + -- (the discord-rpc library loaded and Discord enabled for this profile). In + -- CI the library is not on the load path, so each gated function is denied + -- with the same stable reason. On a machine where Discord is live these + -- pend instead of mutating real presence data. + local gatedFunctions = { + "usingMudletsDiscordID", "getDiscordDetail", "getDiscordLargeIcon", + "getDiscordLargeIconText", "getDiscordParty", "getDiscordSmallIcon", + "getDiscordSmallIconText", "getDiscordState", "getDiscordTimeStamps", + "resetDiscordData", "setDiscordApplicationID", "setDiscordDetail", + "setDiscordElapsedStartTime", "setDiscordGame", "setDiscordLargeIcon", + "setDiscordLargeIconText", "setDiscordParty", "setDiscordRemainingEndTime", + "setDiscordSmallIcon", "setDiscordSmallIconText", "setDiscordState", + } + + -- Probe with a read-access getter. When it returns nil+message the API is + -- denied and that message is the shared denial reason; otherwise the API is + -- usable in this environment and the contract tests pend. + local function discordDenial() + local ok, msg = getDiscordState() + if ok == nil and type(msg) == "string" then + return msg + end + return nil + end + + it("the denial reason refers to Discord", function() + local denial = discordDenial() + if not denial then + pending("Discord API is enabled in this environment") + return + end + assert.is_true(contains(denial, "Discord")) + end) + + for _, fnName in ipairs(gatedFunctions) do + it(fnName .. " returns the shared denial while the API is unavailable", function() + local denial = discordDenial() + if not denial then + pending("Discord API is enabled in this environment") + return + end + -- Called with no arguments: the availability gate is checked before any + -- argument, so nothing is read or mutated on the denied path. + local ok, msg = _G[fnName]() + assert.is_nil(ok) + assert.equals(denial, msg) + end) + end + + describe("setDiscordGameUrl (intentionally ungated)", function() + -- setDiscordGameUrl changes the profile's invite button, not rich + -- presence, so it has no availability gate. Only its argument type is a + -- deterministic offline contract; the success path is left to effect tests + -- as it mutates profile state. + it("raises a Lua error when the url argument is not a string", function() + assertArgError(function() setDiscordGameUrl({}) end, "setDiscordGameUrl: bad argument") + end) + end) +end) diff --git a/src/mudlet-lua/tests/Trigger_spec.lua b/src/mudlet-lua/tests/Trigger_spec.lua index d3b3a6bf5..d5e11a6a8 100644 --- a/src/mudlet-lua/tests/Trigger_spec.lua +++ b/src/mudlet-lua/tests/Trigger_spec.lua @@ -309,12 +309,10 @@ describe("Trigger processing", function() end) - -- feedTelnet only performs injection while the telnet socket is unconnected. - -- The self-test profile's socket is NOT in the unconnected state (the same - -- limitation MXP_spec documents), so feedTelnet refuses here with nil + a - -- message; its successful-injection and prompt paths cannot be exercised in - -- busted. The type-check happens before the connection check, so the - -- argument-type contract is still verifiable. + -- feedTelnet only performs injection while the telnet socket is unconnected; + -- otherwise it refuses with nil + a message. Its successful-injection and + -- prompt paths cannot be exercised in busted. The type-check happens before + -- the connection check, so the argument-type contract is still verifiable. describe("feedTelnet contract", function() it("raises an error when the data argument is not a string", function() @@ -324,9 +322,14 @@ describe("Trigger processing", function() it("refuses to inject while the socket is not unconnected", function() -- safety property: feedTelnet never injects into a live connection. - -- In the self-test profile the socket is not unconnected, so it must - -- return nil plus a refusal message rather than feeding. + -- Establish the precondition here rather than relying on the + -- profile's ambient socket state, which other specs may have cleared + -- with disconnect(): reconnect() starts a fresh lookup and leaves the + -- unconnected state synchronously, without the connection needing to + -- succeed. Restore a clean state afterwards with disconnect(). + reconnect() local ok, msg = feedTelnet("some server data") + disconnect() assert.is_nil(ok, "feedTelnet must not succeed against a non-unconnected socket") assert.is_string(msg) assert.is_truthy(msg:find("refused", 1, true), "expected a refusal message, got: " .. tostring(msg)) From 95cf8fc6add6404d3ec680e5979107e6542dc16a Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Thu, 30 Jul 2026 14:49:42 +0200 Subject: [PATCH 027/155] infrastructure: document un-suppressible CI leak flakes (#9561) #### Brief overview of PR changes/additions Comment-only change to `asan-suppressions.txt` (the LeakSanitizer list used by the `ubuntu / gcc / lua tests + leak detection` CI job). It adds two documentation notes and changes **no** functional `leak:` line: 1. A general note in the header: a `leak:` line can only match a frame that still resolves to a module path or a symbol name, so a leak reported as `` (the allocating library was `dlclose()`d, or the code was JITed, before LeakSanitizer runs at exit) cannot be matched by any `leak:` line. 2. A specific note under the GPU-driver section: the recurring `~240 byte` realloc+calloc leak that flakes the leak job across unrelated PRs is a Mesa DRI driver **teardown** leak of exactly this `` kind, and must be handled test-side (as PR #9534 did for the `show3dMapView` test), not with an ineffective `leak:` line. #### Motivation for adding to Mudlet I looked into whether the recurring `lua tests + leak detection` flakes could be durably fixed by extending the suppression list. After pulling the actual leak stacks from the recent failing runs and reproducing the busted leak recipe locally under ASan, the honest finding is that **none of the observed recurring third-party leaks can be safely added as a `leak:` line**: - **Mesa DRI driver teardown leak (the recurring cross-PR flake).** 128-byte `realloc` + 2x 56-byte `calloc` = 240 bytes, all `` with zero symbols. Byte-for-byte identical across #9534 (pre-fix) and #9550, with matching sub-offsets under ASLR - i.e. the same `dlclose()`d `.so`. Because the module is gone before LeakSanitizer runs at exit, no `leak:` line can match it; the existing `leak:_dri.so` only fires while the driver is still mapped. PR #9534 correctly handled this test-side. - **`QNetworkRequest` / `QUrl` / `QHttp2Configuration` leaks (#9535, #9551).** These symbolize to `libQt6Network`, but they originate from Mudlet's own binary frames (the PIE main executable) - they are genuine Mudlet-owned ownership leaks being fixed in those PRs. Suppressing `libQt6Network` would permanently hide real Mudlet network leaks, so they are deliberately left alone. So rather than add speculative lines that match nothing (or dangerous ones that hide real bugs), this PR records the reasoning in the file itself, so the next person who hits an `` leak does not waste time adding a `leak:swrast_dri.so`-style line and instead handles it at the source. Durable alternatives for the Mesa flake, not done here because they cannot be verified without the CI (jammy) toolchain / a local repro and carry behaviour-change risk: keep handling it test-side per #9534, or add a leak-job workflow env that keeps the driver resident / avoids the incidental GL context so the leak becomes nameable. #### Other info (issues closed, discussion etc) - The suppression file is embedded at compile time (`LsanSuppressions.h.in` -> `__lsan_default_suppressions()` in `src/main.cpp`) **and** passed at runtime via `LSAN_OPTIONS` in the leak job; LeakSanitizer merges both (verified locally: with an empty runtime file the embedded defaults still fired). - Verified locally: built with `-DUSE_SANITIZER=address` and ran the busted leak recipe (`AUTORUN_BUSTED_TESTS`, `detect_leaks=1`, `exitcode=1`, clean HOME, under Xvfb). Suite passes 1104/0/0 with no leak; the comment change embeds and compiles cleanly. The Mesa `` leak does not reproduce on newer Mesa (25.2), consistent with it being a jammy-toolchain flake - so the Mesa claims are reasoned from the CI logs, not locally reproduced. - No functional suppression line was added or changed; this is documentation to prevent ineffective/dangerous suppressions. --- asan-suppressions.txt | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/asan-suppressions.txt b/asan-suppressions.txt index 334990e28..c390f636a 100644 --- a/asan-suppressions.txt +++ b/asan-suppressions.txt @@ -15,6 +15,13 @@ # Qt modules) - a suppression matches if ANY frame does, so those can hide # genuine Mudlet leaks too. # +# A leak: line can only match a frame that still resolves to a module path or a +# symbol name. Leaks reported as "" with no symbols cannot be +# matched by any leak: line: the allocating library was dlclose()d (or the code +# was JITed) before LeakSanitizer runs at exit, so there is no name left to +# compare against. Those have to be handled at their source, not here - see the +# GPU driver note below for the recurring example. +# # See: https://github.com/google/sanitizers/wiki/AddressSanitizerLeakSanitizer # ============================================================================== @@ -26,6 +33,18 @@ leak:libcuda.so leak:nvidia leak:_dri.so +# leak:_dri.so above can only match when the driver is still mapped at process +# exit, where LeakSanitizer runs its check. Mesa dlopen()s a DRI driver on first +# GL use and dlclose()s it when the last GL context - e.g. the 3D map view's +# QOpenGLWidget - is torn down. A driver-init allocation that leaks and is then +# unloaded before exit is reported as "" (the .so is gone by the +# time LeakSanitizer runs), so NO leak: line can match it. On the CI leak job +# (Ubuntu 22.04) this recurs as a small (~240 byte) realloc+calloc leak during +# mudlet teardown and flakes across unrelated PRs; it does not reproduce on newer +# Mesa. Do not try to silence it with a leak: line here (there is no name to +# match) - keep the GL context from being created/destroyed under the sanitizer +# test-side instead, as PR #9534 did for the show3dMapView test. + # ============================================================================== # Fontconfig library leaks # These are typically one-time initialization leaks in the font system From b5b082c375f1e43e903ab04138d3de77be5149ec Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Thu, 30 Jul 2026 15:52:22 +0200 Subject: [PATCH 028/155] fix: cap the length of inserted text like echoed text (#9497) #### Brief overview of PR changes/additions `TBuffer::insertInLine()` - the code path behind the Lua `insertText`/`cinsertText` API - now enforces the same `MAX_CHARACTERS_PER_ECHO` (1,000,000) per-echo character cap that the normal echo/print path (`appendLine()`) already applies. It also now splices the inserted run into the line in a single operation instead of one character at a time. #### Motivation for adding to Mudlet Two problems with the old code: 1. **Uncapped insert.** The echo/append path truncates a single echo to `MAX_CHARACTERS_PER_ECHO`, but `insertInLine()` did not. A single `insertText()` with a very large string was therefore unbounded, growing a line without limit (unnecessary memory pressure / potential DoS). The fix caps the inserted text to the same limit with the same truncate-in-place semantics, so oversized inserts are now bounded consistently across both paths. 2. **Quadratic insert.** The old code inserted characters one at a time into the middle of a `QString` and a `std::deque`; each mid-container insert is O(n), making a large insert O(n^2). The run is now inserted in one operation (`QString::insert` + `std::deque::insert` with a count), producing byte-for-byte identical buffer contents. #### Other info (issues closed, discussion etc) Adds a functional test `InsertTextCapTest` (ephemeral stub port) that inserts an oversized string mid-line via `insertText()` and asserts the inserted run is capped to the limit, plus a control that a normal-sized insert is spliced in unchanged at the cursor (verifying placement and that the character/styling containers stay in sync). Verified fail-first against baseline. The broader TBuffer/display functional suite (`TelnetTextDisplayedTest`, `MainConsoleSelectionTest`, `TOscTest`, `TriggerEditorTest`, `TFeedTriggersRecursionTest`) passes. Assisted-by: Claude:claude-opus-4-8 --- src/TBuffer.cpp | 17 +- src/TBuffer.h | 2 +- test/functional_tests/CMakeLists.txt | 4 + test/functional_tests/InsertTextCapTest.cpp | 225 ++++++++++++++++++++ 4 files changed, 240 insertions(+), 8 deletions(-) create mode 100644 test/functional_tests/InsertTextCapTest.cpp diff --git a/src/TBuffer.cpp b/src/TBuffer.cpp index 4b85fb4ad..c25dbd8c2 100644 --- a/src/TBuffer.cpp +++ b/src/TBuffer.cpp @@ -4761,6 +4761,10 @@ bool TBuffer::insertInLine(QPoint& P, const QString& text, const TChar& format) if (text.isEmpty()) { return false; } + // Bound a single insert to the same limit the echo/append path uses + // (see appendLine()), so an oversized insertText() cannot consume unbounded + // memory or processing time. + const QString insertedText = (text.size() > MAX_CHARACTERS_PER_ECHO) ? text.left(MAX_CHARACTERS_PER_ECHO) : text; const int x = P.x(); const int y = P.y(); if ((y >= 0) && (y < static_cast(buffer.size()))) { @@ -4771,15 +4775,14 @@ bool TBuffer::insertInLine(QPoint& P, const QString& text, const TChar& format) TChar c(mpConsole); expandLine(y, x - buffer.at(y).size(), c); } - for (int i = 0, total = text.size(); i < total; ++i) { - lineBuffer[y].insert(x + i, text.at(i)); - const TChar c = format; - auto it = buffer[y].begin(); - buffer[y].insert(it + x + i, c); - } + // Insert the whole run in one operation. Inserting one character at a + // time into the middle of the QString/std::deque is O(n) per character, + // which is quadratic for large inserts. + lineBuffer[y].insert(x, insertedText); + buffer[y].insert(buffer[y].begin() + x, static_cast(insertedText.size()), format); syncPreTriggerPassLine(y); } else { - appendLine(text, 0, text.size(), format.mFgColor, format.mBgColor, format.mFlags); + appendLine(insertedText, 0, insertedText.size(), format.mFgColor, format.mBgColor, format.mFlags); } return true; } diff --git a/src/TBuffer.h b/src/TBuffer.h index ae22cc7b4..a9dba150d 100644 --- a/src/TBuffer.h +++ b/src/TBuffer.h @@ -292,10 +292,10 @@ class TBuffer static inline const int TCHAR_IN_BYTES = sizeof(TChar); +public: // limit on how many characters a single echo can accept for performance reasons static inline const int MAX_CHARACTERS_PER_ECHO = 1000000; -public: explicit TBuffer(Host* pH, TConsole* pConsole = nullptr); ~TBuffer(); TBuffer(const TBuffer& other); diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index 662ff32c7..afb190c0f 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -21,6 +21,7 @@ set(FUNCTIONAL_TEST_SOURCES EnableDisableByNameTest.cpp ColorTriggerFilterChildTest.cpp GMCPCharLoginTest.cpp + InsertTextCapTest.cpp SetScriptCallbackTest.cpp ClearWindowLogTest.cpp XMLexportVariablesTest.cpp @@ -90,6 +91,9 @@ set_tests_properties(dlgTriggerEditorUndoRedoTest PROPERTIES TIMEOUT 300) # GMCPCharLoginTest creates a fresh profile per test method, so it needs a longer timeout set_tests_properties(GMCPCharLoginTest PROPERTIES TIMEOUT 300) +# InsertTextCapTest creates a fresh profile per test method, so it needs a longer timeout +set_tests_properties(InsertTextCapTest PROPERTIES TIMEOUT 300) + # LogRestartDuplicateLineTest creates a fresh profile per test method, so it needs a longer timeout set_tests_properties(LogRestartDuplicateLineTest PROPERTIES TIMEOUT 300) diff --git a/test/functional_tests/InsertTextCapTest.cpp b/test/functional_tests/InsertTextCapTest.cpp new file mode 100644 index 000000000..404a10ed1 --- /dev/null +++ b/test/functional_tests/InsertTextCapTest.cpp @@ -0,0 +1,225 @@ +/*************************************************************************** + * Copyright (C) 2026 by Mudlet Makers * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +#include + +#include "Host.h" +#include "MudletInstanceCoordinator.h" +#include "TMainConsole.h" +#include "TelnetServerStub.h" +#include "ctelnet.h" +#include "dlgConnectionProfiles.h" +#include "mudlet.h" + +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); +void initializeQRCResources(); + +// Regression test: a single insertText() into the middle of an existing line +// (the TBuffer::insertInLine() path) must apply the same per-echo character +// cap that the echo/append path enforces, so an oversized insert cannot grow a +// line without bound. +class InsertTextCapTest : public QObject +{ + Q_OBJECT + + // Reference the production constant directly to avoid drift. + static constexpr int kMaxCharactersPerEcho = TBuffer::MAX_CHARACTERS_PER_ECHO; + +private: + TelnetServerStub* mpServer = nullptr; + const QString mpHostname = "Test-InsertCap"; + QString mpPort; // assigned the stub's actual ephemeral port in init() + const QString mpLocalhost = "localhost"; + +private slots: + void initTestCase() { initializeQRCResources(); } + + void init() + { + mpServer = new TelnetServerStub(qApp); + mpServer->start(mpLocalhost, 0); // ephemeral OS-assigned port avoids collisions across concurrent test runs + mpPort = QString::number(mpServer->serverPort()); + mudlet::start(); + mudlet::self()->setupConfig(); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique("MudletInstanceCoordinator")); + mudlet::self()->init(); + mudlet::self()->setStorePasswordsSecurely(false); + deleteProfileDirectory(mpHostname); + } + + // Inserting an over-long string into the middle of a line must cap the + // inserted run at kMaxCharactersPerEcho, matching the echo/append path. + void test_oversizedInsertIsCapped() + { + mpServer->setWelcomeMessage(QStringLiteral("HELLO\r\n")); + startProfile(mpHostname, mpLocalhost, mpPort); + QVERIFY2(waitForTextInBuffer(QStringLiteral("HELLO")), "Welcome text never reached the buffer"); + + auto console = mudlet::self()->getActiveHost()->mpConsole; + + // Position the user cursor in the middle of the "HELLO" line so that + // insertText() routes through insertInLine() rather than the (already + // capped) append path used when the cursor sits at the buffer end. + QVERIFY2(console->moveCursor(2, 0), "Could not position the user cursor mid-line"); + + const int originalLength = console->buffer.line(0).size(); + QVERIFY2(originalLength > 2, "Unexpected welcome line contents"); + + const int overshoot = 500; + const QString oversized(kMaxCharactersPerEcho + overshoot, QLatin1Char('Z')); + console->insertText(oversized); + + const int newLength = console->buffer.line(0).size(); + const int insertedLength = newLength - originalLength; + + // Without the cap the full oversized string is inserted, so the inserted + // run would be kMaxCharactersPerEcho + overshoot. With the cap it is + // exactly kMaxCharactersPerEcho. + QCOMPARE(insertedLength, kMaxCharactersPerEcho); + + // The character (lineBuffer) and styling (TChar deque) containers are + // filled by two separate inserts that must stay the same length, or the + // renderer reads past the end of one of them. + QCOMPARE(static_cast(console->buffer.buffer.at(0).size()), newLength); + } + + // A normally-sized insert must be inserted in full (guards against the cap + // being applied too aggressively). + void test_normalInsertIsUntouched() + { + mpServer->setWelcomeMessage(QStringLiteral("HELLO\r\n")); + startProfile(mpHostname, mpLocalhost, mpPort); + QVERIFY2(waitForTextInBuffer(QStringLiteral("HELLO")), "Welcome text never reached the buffer"); + + auto console = mudlet::self()->getActiveHost()->mpConsole; + QVERIFY2(console->moveCursor(2, 0), "Could not position the user cursor mid-line"); + + const QString original = console->buffer.line(0); + const QString payload = QStringLiteral("insertedText"); + console->insertText(payload); + + // The run must be spliced in at the cursor (x = 2) without disturbing the + // surrounding characters - the batched insert must match the old + // per-character insertion exactly, not just in length. + const QString expected = original.left(2) + payload + original.mid(2); + QCOMPARE(console->buffer.line(0), expected); + QCOMPARE(static_cast(console->buffer.buffer.at(0).size()), expected.size()); + } + + void cleanup() + { + const QString profilePath = mudlet::getMudletPath(enums::profileHomePath, mpHostname); + + // Tear down Mudlet (and with it the live cTelnet connection) before the + // stub server it is talking to, so the socket is closed from the client + // side rather than being yanked out from under an active connection. + delete mudlet::self(); + delete mpServer; + mpServer = nullptr; + deleteDirectory(profilePath); + } + +private: + void startProfile(const QString& hostname, const QString& address, const QString& port) + { + QTimer::singleShot(0, qApp, [hostname, address, port]() { + mudlet::self()->startAutoLogin({}); + QTest::qWait(100); + QTest::mouseClick(mudlet::self()->mpConnectionDialog->new_profile_button, Qt::LeftButton); + QTest::qWait(100); + QTest::keyClicks(QApplication::focusWidget(), hostname); + QTest::qWait(100); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100); + QTest::keyClicks(QApplication::focusWidget(), address); + QTest::qWait(100); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100); + QTest::keyClicks(QApplication::focusWidget(), port); + QTest::qWait(100); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Return); + }); + + QSignalSpy spy(mudlet::self(), &mudlet::signal_profileLoaded); + if (!spy.wait(5000)) { + QFAIL("Profile took too long to load."); + } + auto host = mudlet::self()->getActiveHost(); + if (!host) { + QFAIL("No active host available for the test."); + } + + QSignalSpy spy2(&(host->mTelnet), &cTelnet::signal_connected); + if (!spy2.wait(2000)) { + QFAIL("Could not connect with the host."); + } + } + + bool waitForTextInBuffer(const QString& text, int timeoutMs = 5000) + { + auto console = mudlet::self()->getActiveHost()->mpConsole; + return QTest::qWaitFor( + [&]() { + for (int i = 0; i <= console->buffer.getLastLineNumber(); ++i) { + if (console->buffer.line(i) == text) { + return true; + } + } + return false; + }, + timeoutMs); + } + + void deleteProfileDirectory(const QString& profileName) + { + const QString path = mudlet::getMudletPath(enums::profileHomePath, profileName); + deleteDirectory(path); + } + + void deleteDirectory(const QString& path) + { + QDir dir(path); + if (!dir.exists()) { + return; + } + dir.removeRecursively(); + } +}; + +void initializeQRCResources() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +#include "InsertTextCapTest.moc" +QTEST_MAIN(InsertTextCapTest) From 12f259177be126201e81811bd32e12e561d5b94a Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Thu, 30 Jul 2026 16:30:13 +0200 Subject: [PATCH 029/155] fix: permGroup reports failure properly and listRemove removes consecutive duplicates (#9550) #### Brief overview of PR changes/additions - permGroup now returns false + message on failure via pcall (the perm* bindings raise errors; the old == -1 check was dead code), success return unchanged - listRemove iterates backwards so consecutive duplicate values are all removed #### Motivation for adding to Mudlet permGroup's documented false-on-failure contract never worked, and listRemove({"a","x","x","b"}, "x") left an "x" behind. #### Other info (issues closed, discussion etc) Fixes #9545, Fixes #9546 Stacked on the specs-utils-demock test branch; fail-without-fix proven (10 pinning tests red on unfixed code). Zero profile pollution from failure-path tests. **Test case:** permGroup("g", "timer", "no-such-parent") returns false + message instead of raising; listRemove({"a","x","x","b"}, "x") returns {"a","b"}. Awaiting build/test by a maintainer; squash-merge with: Assisted-by: Claude:claude-opus-4-8 (Signed-off-by to be added at squash after testing) --- src/mudlet-lua/lua/Other.lua | 24 ++++-- src/mudlet-lua/lua/TableUtils.lua | 6 +- src/mudlet-lua/tests/Other_spec.lua | 99 +++++++++++++++++------- src/mudlet-lua/tests/TableUtils_spec.lua | 37 ++++++++- 4 files changed, 123 insertions(+), 43 deletions(-) diff --git a/src/mudlet-lua/lua/Other.lua b/src/mudlet-lua/lua/Other.lua index 67b5bfc2f..cf7beba1e 100644 --- a/src/mudlet-lua/lua/Other.lua +++ b/src/mudlet-lua/lua/Other.lua @@ -152,31 +152,37 @@ end --- Table of functions used by permGroup to create the appropriate group, based on itemtype. +--- Each perm* binding raises a Lua error on failure (for example a missing parent) +--- rather than returning -1, so permGroup pcalls these and turns a raised error +--- into a false return. local group_creation_functions = { timer = function(name, parent) - return not (permTimer(name, parent, 0, "") == -1) + return permTimer(name, parent, 0, "") end, trigger = function(name, parent) - return not (permSubstringTrigger(name, parent, {}, "") == -1) + return permSubstringTrigger(name, parent, {}, "") end, alias = function(name, parent) - return not (permAlias(name, parent, "", "") == -1) + return permAlias(name, parent, "", "") end, key = function(name, parent) - return not (permKey(name, parent, -1, "") == -1) + return permKey(name, parent, -1, "") end, script = function(name, parent) - return not (permScript(name, parent, "", "") == -1) + return permScript(name, parent, "", "") end } --- Creates a group of a given type that will persist through sessions. --- --- @param name name of the item ---- @param itemtype type of the item - can be trigger, alias, or timer +--- @param itemtype type of the item - can be trigger, alias, timer, key, or script --- @param parent optional name of existing item which the new item --- will be created as a child of --- +--- @return true on success, or false plus an error message if the item could +--- not be created (for example when the named parent does not exist) +--- --- @usage --- 
 ---   --create a new trigger group
@@ -193,7 +199,11 @@ function permGroup(name, itemtype, parent)
   assert(type(name) == "string", "permGroup: need a name for the new thing")
   parent = parent or ""
   assert(group_creation_functions[itemtype], "permGroup: " .. tostring(itemtype) .. " isn't a valid type")
-  return group_creation_functions[itemtype](name, parent)
+  local ok, err = pcall(group_creation_functions[itemtype], name, parent)
+  if not ok then
+    return false, err
+  end
+  return true
 end
 
 --- Appends code to an existing script
diff --git a/src/mudlet-lua/lua/TableUtils.lua b/src/mudlet-lua/lua/TableUtils.lua
index c1ae31f3b..761274159 100644
--- a/src/mudlet-lua/lua/TableUtils.lua
+++ b/src/mudlet-lua/lua/TableUtils.lua
@@ -153,8 +153,10 @@ end
 
 --- TODO listRemove( list, what )
 function listRemove( list, what )
-  for k, v in ipairs( list ) do
-    if v == what then
+  -- iterate backwards so removing an element does not shift a following match
+  -- down into an index the loop has already passed
+  for k = #list, 1, -1 do
+    if list[k] == what then
       table.remove( list, k )
     end
   end
diff --git a/src/mudlet-lua/tests/Other_spec.lua b/src/mudlet-lua/tests/Other_spec.lua
index 9bec9fe65..039610abd 100644
--- a/src/mudlet-lua/tests/Other_spec.lua
+++ b/src/mudlet-lua/tests/Other_spec.lua
@@ -104,63 +104,102 @@ describe("Tests Other.lua functions", function()
     -- arguments and then fails at the parent lookup before creating anything.
     local nonexistentParent = "permGroupSpecNonexistentParent"
 
-    -- The default-parent-of-"" branch (permGroup(name, type) with no parent) is
-    -- deliberately not covered: an empty parent makes the underlying perm*
-    -- succeed and create a real, unremovable top-level item, so it cannot be
-    -- exercised without either polluting the profile or mocking a real function.
     describe("dispatches to the correct underlying function with the documented defaults", function()
-      -- Each test also asserts pcall failed, which self-checks the assumption
-      -- that the nonexistent parent prevents any item from actually being created.
+      -- A nonexistent parent lets us drive the real dispatch without polluting the
+      -- profile: each perm* marshals its arguments and then raises at the parent
+      -- lookup before creating anything. The spy is reverted immediately after the
+      -- call (its recorded history survives revert) so cleanup happens even against
+      -- the old raising code. Each test also confirms the failure surfaces as a
+      -- false return rather than a raise.
       it("uses permTimer(name, parent, 0, '') for timers", function()
         local permTimer = spy.on(_G, "permTimer")
-        local ok = pcall(permGroup, "permGroupSpecTimer", "timer", nonexistentParent)
-        assert.is_false(ok)
-        assert.spy(permTimer).was.called_with("permGroupSpecTimer", nonexistentParent, 0, "")
+        local ok, created = pcall(permGroup, "permGroupSpecTimer", "timer", nonexistentParent)
         permTimer:revert()
+        assert.spy(permTimer).was.called_with("permGroupSpecTimer", nonexistentParent, 0, "")
+        assert.is_true(ok)
+        assert.is_false(created)
       end)
 
       it("uses permSubstringTrigger(name, parent, {}, '') for triggers", function()
         local permSubstringTrigger = spy.on(_G, "permSubstringTrigger")
-        local ok = pcall(permGroup, "permGroupSpecTrigger", "trigger", nonexistentParent)
-        assert.is_false(ok)
-        assert.spy(permSubstringTrigger).was.called_with("permGroupSpecTrigger", nonexistentParent, {}, "")
+        local ok, created = pcall(permGroup, "permGroupSpecTrigger", "trigger", nonexistentParent)
         permSubstringTrigger:revert()
+        assert.spy(permSubstringTrigger).was.called_with("permGroupSpecTrigger", nonexistentParent, {}, "")
+        assert.is_true(ok)
+        assert.is_false(created)
       end)
 
       it("uses permAlias(name, parent, '', '') for aliases", function()
         local permAlias = spy.on(_G, "permAlias")
-        local ok = pcall(permGroup, "permGroupSpecAlias", "alias", nonexistentParent)
-        assert.is_false(ok)
-        assert.spy(permAlias).was.called_with("permGroupSpecAlias", nonexistentParent, "", "")
+        local ok, created = pcall(permGroup, "permGroupSpecAlias", "alias", nonexistentParent)
         permAlias:revert()
+        assert.spy(permAlias).was.called_with("permGroupSpecAlias", nonexistentParent, "", "")
+        assert.is_true(ok)
+        assert.is_false(created)
       end)
 
       it("uses permKey(name, parent, -1, '') for keys", function()
         local permKey = spy.on(_G, "permKey")
-        local ok = pcall(permGroup, "permGroupSpecKey", "key", nonexistentParent)
-        assert.is_false(ok)
-        assert.spy(permKey).was.called_with("permGroupSpecKey", nonexistentParent, -1, "")
+        local ok, created = pcall(permGroup, "permGroupSpecKey", "key", nonexistentParent)
         permKey:revert()
+        assert.spy(permKey).was.called_with("permGroupSpecKey", nonexistentParent, -1, "")
+        assert.is_true(ok)
+        assert.is_false(created)
       end)
 
       it("uses permScript(name, parent, '', '') for scripts", function()
         local permScript = spy.on(_G, "permScript")
-        local ok = pcall(permGroup, "permGroupSpecScript", "script", nonexistentParent)
-        assert.is_false(ok)
-        assert.spy(permScript).was.called_with("permGroupSpecScript", nonexistentParent, "", "")
+        local ok, created = pcall(permGroup, "permGroupSpecScript", "script", nonexistentParent)
         permScript:revert()
+        assert.spy(permScript).was.called_with("permGroupSpecScript", nonexistentParent, "", "")
+        assert.is_true(ok)
+        assert.is_false(created)
+      end)
+
+      it("defaults a missing parent to the top level", function()
+        -- The documented two-argument form permGroup(name, type) turns a missing
+        -- parent into "", which makes the underlying perm* succeed and create a
+        -- real top-level item; stub it so nothing is written to the profile.
+        local permTimer = stub(_G, "permTimer", 42)
+        local created = permGroup("permGroupSpecDefaultParent", "timer")
+        permTimer:revert()
+        assert.stub(permTimer).was.called_with("permGroupSpecDefaultParent", "", 0, "")
+        assert.is_true(created)
       end)
     end)
 
-    describe("propagates the underlying creation error instead of returning false", function()
-      -- group_creation_functions in Other.lua checks `perm*(...) == -1`, but the
-      -- real perm* bindings raise a Lua error on failure rather than returning
-      -- -1, so that check is dead code and a failed permGroup errors instead of
-      -- returning false.
-      it("raises an error when the parent group does not exist", function()
-        assert.has_error(function()
-          permGroup("permGroupSpecOrphan", "timer", nonexistentParent)
-        end)
+    describe("reports failure instead of raising when creation fails", function()
+      -- #9545: group_creation_functions checked `perm*(...) == -1`, but the perm*
+      -- bindings raise a Lua error on failure (for example a missing parent)
+      -- rather than returning -1, so permGroup could never honour its documented
+      -- false-on-failure contract. It now pcalls the creation and returns false
+      -- plus the underlying error message.
+      it("returns false when the parent group does not exist", function()
+        local created = permGroup("permGroupSpecOrphan", "timer", nonexistentParent)
+        assert.is_false(created)
+      end)
+
+      it("returns the underlying error message alongside false", function()
+        local created, err = permGroup("permGroupSpecOrphan", "timer", nonexistentParent)
+        assert.is_false(created)
+        assert.is_string(err)
+        -- pin that the real underlying error (which names the missing parent)
+        -- propagated, rather than coupling to any particular phrasing
+        assert.is_truthy(err:find(nonexistentParent, 1, true))
+      end)
+    end)
+
+    describe("reports success", function()
+      -- Stub the underlying binding so no real permanent item is created (which
+      -- would pollute the profile). A successful perm* returns an item id, and
+      -- permGroup must surface that as a boolean true. Revert before asserting so
+      -- the stub can never leak into later tests.
+      it("returns true when the underlying creation succeeds", function()
+        local permTimer = stub(_G, "permTimer", 42)
+        local created = permGroup("permGroupSpecSuccess", "timer", "irrelevantParent")
+        permTimer:revert()
+        assert.stub(permTimer).was.called_with("permGroupSpecSuccess", "irrelevantParent", 0, "")
+        assert.is_true(created)
       end)
     end)
 
diff --git a/src/mudlet-lua/tests/TableUtils_spec.lua b/src/mudlet-lua/tests/TableUtils_spec.lua
index 98d3673cb..163f6df0f 100644
--- a/src/mudlet-lua/tests/TableUtils_spec.lua
+++ b/src/mudlet-lua/tests/TableUtils_spec.lua
@@ -850,10 +850,6 @@ describe("Tests TableUtils.lua functions", function()
   end)
 
   describe("Tests the functionality of listRemove", function()
-    -- listRemove removes during an ipairs loop, so consecutive duplicates are a
-    -- known skip bug (removing index i shifts i+1 into i, which the loop then
-    -- skips). That buggy behaviour is deliberately NOT pinned here; only the
-    -- single-match and no-match paths, which the quirk cannot affect, are tested.
     it("should remove a matching item from the list", function()
       local list = { "one", "two", "three" }
       listRemove(list, "two")
@@ -865,6 +861,39 @@ describe("Tests TableUtils.lua functions", function()
       listRemove(list, "missing")
       assert.same({ "one", "two" }, list)
     end)
+
+    it("should leave an empty list empty", function()
+      local list = {}
+      listRemove(list, "x")
+      assert.same({}, list)
+    end)
+
+    it("should remove the sole element when it matches", function()
+      local list = { "x" }
+      listRemove(list, "x")
+      assert.same({}, list)
+    end)
+
+    -- #9546: removal used to happen during an ipairs loop, so deleting index i
+    -- shifted i+1 down into i, which the loop then skipped, leaving one of each
+    -- run of consecutive duplicates behind.
+    it("should remove a pair of consecutive duplicate matches", function()
+      local list = { "a", "x", "x", "b" }
+      listRemove(list, "x")
+      assert.same({ "a", "b" }, list)
+    end)
+
+    it("should remove a run of three or more consecutive duplicates", function()
+      local list = { "x", "x", "x" }
+      listRemove(list, "x")
+      assert.same({}, list)
+    end)
+
+    it("should remove every match whether the duplicates are adjacent or apart", function()
+      local list = { "x", "a", "x", "x", "b", "x" }
+      listRemove(list, "x")
+      assert.same({ "a", "b" }, list)
+    end)
   end)
 
   describe("Tests the contract of printTable", function()

From dae8e9f440eb1b76f2c5295d7a1d483b5577e861 Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Thu, 30 Jul 2026 18:03:49 +0200
Subject: [PATCH 030/155] fix: garbled error messages in networking and media
 functions (#9551)

#### Brief overview of PR changes/additions
- sendGMCP/sendATCP/receiveMSP error messages no longer print a literal
"%1" (lua_pushfstring now uses %s)
- customHTTP type errors name the actual bad argument (stack index off
by pos)
- stopSounds/stopMusic/stopVideos/play* doubled messages ("must be
boolean as boolean expected") de-duplicated across 6 sibling sites

#### Motivation for adding to Mudlet
Users debugging their scripts saw "got %1!" and wrong-argument
diagnostics instead of the real problem.

#### Other info (issues closed, discussion etc)
Fixes #9543, Fixes #9544, Fixes #9547
Stacked on the specs-contracts-net test branch; fail-without-fix proven
(15 pinned messages red on unfixed build). Codebase grepped - no other
%1 lua_pushfstring sites exist.

**Test case:** sendGMCP({}) error says "got table!", customHTTP with a
numeric headers arg says "got number!", stopSounds({fadeaway="yes"})
produces a single clean message.

Awaiting build/test by a maintainer; squash-merge with:
Assisted-by: Claude:claude-opus-4-8
(Signed-off-by to be added at squash after testing)
---
 src/TLuaInterpreterMedia.cpp             |  20 ++--
 src/TLuaInterpreterNetworking.cpp        |   8 +-
 src/mudlet-lua/tests/GMCP_spec.lua       |  21 +++-
 src/mudlet-lua/tests/Networking_spec.lua | 120 +++++++++++++++++++++--
 4 files changed, 144 insertions(+), 25 deletions(-)

diff --git a/src/TLuaInterpreterMedia.cpp b/src/TLuaInterpreterMedia.cpp
index 2b7f97007..9ddbe585b 100644
--- a/src/TLuaInterpreterMedia.cpp
+++ b/src/TLuaInterpreterMedia.cpp
@@ -45,7 +45,7 @@ int TLuaInterpreter::receiveMSP(lua_State* L)
     }
 
     if (!lua_isstring(L, 1)) {
-        lua_pushfstring(L, "receiveMSP: bad argument #1 type (message as string expected, got %1!)", luaL_typename(L, 1));
+        lua_pushfstring(L, "receiveMSP: bad argument #1 type (message as string expected, got %s!)", luaL_typename(L, 1));
         return lua_error(L);
     }
 
@@ -411,7 +411,7 @@ int TLuaInterpreter::playMusicFileAsTableArgument(lua_State* L, const char* func
                 mediaData.setMediaLoops(value);
             }
         } else if (key == QLatin1String("continue")) {
-            const bool value = getVerifiedBool(L, func, -1, "value for continue must be boolean");
+            const bool value = getVerifiedBool(L, func, -1, "value for continue");
             mediaData.setMediaContinue(value);
         }
 
@@ -788,13 +788,13 @@ int TLuaInterpreter::playVideoFileAsTableArgument(lua_State* L, const char* func
                 mediaData.setMediaLoops(value);
             }
         } else if (!key.compare(QLatin1String("continue"), Qt::CaseInsensitive)) {
-            bool value = getVerifiedBool(L, func, -1, "value for continue must be boolean");
+            bool value = getVerifiedBool(L, func, -1, "value for continue");
             mediaData.setMediaContinue(value);
         } else if (!key.compare(QLatin1String("stream"), Qt::CaseInsensitive)) {
-            bool value = getVerifiedBool(L, func, -1, "value for stream must be boolean");
+            bool value = getVerifiedBool(L, func, -1, "value for stream");
             mediaData.setMediaInput(value ? TMediaData::MediaInputStream : TMediaData::MediaInputNotSet);
         } else if (!key.compare(QLatin1String("close"), Qt::CaseInsensitive)) {
-            bool value = getVerifiedBool(L, func, -1, "value for close must be boolean");
+            bool value = getVerifiedBool(L, func, -1, "value for close");
             mediaData.setMediaClose(value ? TMediaData::MediaCloseEnabled : TMediaData::MediaCloseDefault);
         }
 
@@ -1067,7 +1067,7 @@ int TLuaInterpreter::getPlayingSoundsAsTableArgument(lua_State* L, const char* f
                 mediaData.setMediaTag(value);
             }
         } else if (key == QLatin1String("priority")) {
-            int value = getVerifiedInt(L, func, -1, "value for priority must be integer");
+            int value = getVerifiedInt(L, func, -1, "value for priority");
 
             if (value > TMediaData::MediaPriorityMax) {
                 value = TMediaData::MediaPriorityMax;
@@ -1498,7 +1498,7 @@ int TLuaInterpreter::stopMusicAsTableArgument(lua_State* L, const char* func)
                 mediaData.setMediaTag(value);
             }
         } else if (key == QLatin1String("fadeaway")) {
-            const bool value = getVerifiedBool(L, func, -1, "value for fadeaway must be boolean");
+            const bool value = getVerifiedBool(L, func, -1, "value for fadeaway");
             mediaData.setMediaFadeAway(value);
         } else if (key == QLatin1String("fadeout")) {
             int value = getVerifiedInt(L, func, -1, "value for fadeout");
@@ -1647,7 +1647,7 @@ int TLuaInterpreter::stopSoundsAsTableArgument(lua_State* L, const char* func)
                 mediaData.setMediaTag(value);
             }
         } else if (key == QLatin1String("priority")) {
-            int value = getVerifiedInt(L, func, -1, "value for priority must be integer");
+            int value = getVerifiedInt(L, func, -1, "value for priority");
 
             if (key == QLatin1String("priority")) {
                 if (value > TMediaData::MediaPriorityMax) {
@@ -1659,7 +1659,7 @@ int TLuaInterpreter::stopSoundsAsTableArgument(lua_State* L, const char* func)
                 mediaData.setMediaPriority(value);
             }
         } else if (key == QLatin1String("fadeaway")) {
-            const bool value = getVerifiedBool(L, func, -1, "value for fadeaway must be boolean");
+            const bool value = getVerifiedBool(L, func, -1, "value for fadeaway");
             mediaData.setMediaFadeAway(value);
         } else if (key == QLatin1String("fadeout")) {
             int value = getVerifiedInt(L, func, -1, "value for fadeout");
@@ -1736,7 +1736,7 @@ int TLuaInterpreter::stopVideosAsTableArgument(lua_State* L, const char* func)
                 mediaData.setMediaTag(value);
             }
         } else if (key == QLatin1String("fadeaway")) {
-            const bool value = getVerifiedBool(L, func, -1, "value for fadeaway must be boolean");
+            const bool value = getVerifiedBool(L, func, -1, "value for fadeaway");
             mediaData.setMediaFadeAway(value);
         } else if (key == QLatin1String("fadeout")) {
             int value = getVerifiedInt(L, func, -1, "value for fadeout");
diff --git a/src/TLuaInterpreterNetworking.cpp b/src/TLuaInterpreterNetworking.cpp
index 6995d6fd8..650d329e7 100644
--- a/src/TLuaInterpreterNetworking.cpp
+++ b/src/TLuaInterpreterNetworking.cpp
@@ -297,7 +297,7 @@ int TLuaInterpreter::sendATCP(lua_State* L)
 {
     Host& host = getHostFromLua(L);
     if (!lua_isstring(L, 1)) {
-        lua_pushfstring(L, "sendATCP: bad argument #1 type (message as string expected, got %1!)", luaL_typename(L, 1));
+        lua_pushfstring(L, "sendATCP: bad argument #1 type (message as string expected, got %s!)", luaL_typename(L, 1));
         return lua_error(L);
     }
     const std::string msg = host.mTelnet.encodeAndCookBytes(lua_tostring(L, 1));
@@ -305,7 +305,7 @@ int TLuaInterpreter::sendATCP(lua_State* L)
     std::string what;
     if (lua_gettop(L) > 1) {
         if (!lua_isstring(L, 2)) {
-            lua_pushfstring(L, "sendATCP: bad argument #2 type (what as string is optional, got %1!)", luaL_typename(L, 2));
+            lua_pushfstring(L, "sendATCP: bad argument #2 type (what as string is optional, got %s!)", luaL_typename(L, 2));
             return lua_error(L);
         }
         what = host.mTelnet.encodeAndCookBytes(lua_tostring(L, 2));
@@ -346,7 +346,7 @@ int TLuaInterpreter::sendGMCP(lua_State* L)
 {
     Host& host = getHostFromLua(L);
     if (!lua_isstring(L, 1)) {
-        lua_pushfstring(L, "sendGMCP: bad argument #1 type (message as string expected, got %1!)", luaL_typename(L, 1));
+        lua_pushfstring(L, "sendGMCP: bad argument #1 type (message as string expected, got %s!)", luaL_typename(L, 1));
         return lua_error(L);
     }
     const std::string msg = host.mTelnet.encodeAndCookBytes(lua_tostring(L, 1));
@@ -354,7 +354,7 @@ int TLuaInterpreter::sendGMCP(lua_State* L)
     std::string what;
     if (lua_gettop(L) > 1) {
         if (!lua_isstring(L, 2)) {
-            lua_pushfstring(L, "sendGMCP: bad argument #2 type (what as string is optional, got %1!)", luaL_typename(L, 2));
+            lua_pushfstring(L, "sendGMCP: bad argument #2 type (what as string is optional, got %s!)", luaL_typename(L, 2));
             return lua_error(L);
         }
         what = host.mTelnet.encodeAndCookBytes(lua_tostring(L, 2));
diff --git a/src/mudlet-lua/tests/GMCP_spec.lua b/src/mudlet-lua/tests/GMCP_spec.lua
index 8a0e2e9a9..451f3ff26 100644
--- a/src/mudlet-lua/tests/GMCP_spec.lua
+++ b/src/mudlet-lua/tests/GMCP_spec.lua
@@ -165,13 +165,24 @@ describe("Tests the argument and disconnected contract of sendGMCP", function()
     disconnect()
   end)
 
-  it("raises a Lua error when the message is not a string", function()
-    assert.has_error(function() sendGMCP({}) end)
-    assert.has_error(function() sendGMCP(true) end)
+  it("names the offending value's real type when the message is not a string", function()
+    -- Regression #9543: the type-name placeholder must be expanded, not printed
+    -- as a literal "%1". lua_pushfstring only understands C-style "%s".
+    local ok, err = pcall(function() sendGMCP({}) end)
+    assert.is_false(ok)
+    assert.is_true(contains(err, "sendGMCP: bad argument #1 type (message as string expected, got table!)"), tostring(err))
+    assert.is_false(contains(err, "%1"), tostring(err))
+
+    local okBool, errBool = pcall(function() sendGMCP(true) end)
+    assert.is_false(okBool)
+    assert.is_true(contains(errBool, "sendGMCP: bad argument #1 type (message as string expected, got boolean!)"), tostring(errBool))
   end)
 
-  it("raises a Lua error when the optional second argument is not a string", function()
-    assert.has_error(function() sendGMCP("Core.Ping", {}) end)
+  it("names the real type when the optional second argument is not a string", function()
+    local ok, err = pcall(function() sendGMCP("Core.Ping", {}) end)
+    assert.is_false(ok)
+    assert.is_true(contains(err, "sendGMCP: bad argument #2 type (what as string is optional, got table!)"), tostring(err))
+    assert.is_false(contains(err, "%1"), tostring(err))
   end)
 
   it("returns nil and an explanatory message while disconnected", function()
diff --git a/src/mudlet-lua/tests/Networking_spec.lua b/src/mudlet-lua/tests/Networking_spec.lua
index 8ba07eccf..af075d0e2 100644
--- a/src/mudlet-lua/tests/Networking_spec.lua
+++ b/src/mudlet-lua/tests/Networking_spec.lua
@@ -54,8 +54,20 @@ describe("Networking send functions honour their disconnected/offline contracts"
   end)
 
   describe("sendATCP", function()
-    it("raises a Lua error when the message is not a string", function()
-      assert.has_error(function() sendATCP({}) end)
+    it("names the offending value's real type when the message is not a string", function()
+      -- Regression #9543: the type-name placeholder must be expanded, not printed
+      -- as a literal "%1". lua_pushfstring only understands C-style "%s".
+      local ok, err = pcall(function() sendATCP({}) end)
+      assert.is_false(ok)
+      assert.is_true(contains(err, "sendATCP: bad argument #1 type (message as string expected, got table!)"), tostring(err))
+      assert.is_false(contains(err, "%1"), tostring(err))
+    end)
+
+    it("names the real type when the optional second argument is not a string", function()
+      local ok, err = pcall(function() sendATCP("Char.Login", {}) end)
+      assert.is_false(ok)
+      assert.is_true(contains(err, "sendATCP: bad argument #2 type (what as string is optional, got table!)"), tostring(err))
+      assert.is_false(contains(err, "%1"), tostring(err))
     end)
 
     it("returns nil and a message while disconnected", function()
@@ -227,8 +239,23 @@ describe("HTTP and download functions validate arguments before issuing a reques
       assertArgError(function() customHTTP("REPORT", "payload") end, "customHTTP: bad argument")
     end)
 
-    it("raises a Lua error when headers is not a table", function()
-      assertArgError(function() customHTTP("REPORT", "payload", "http://localhost/", 5) end, "customHTTP: bad argument")
+    it("reports the real type of a non-table headers argument", function()
+      -- Regression #9544: performHttpRequest must read the type of the offending
+      -- slot (pos + 3), not a hardcoded slot 3, so the headers error names the
+      -- number that was actually passed rather than the url's type.
+      local ok, err = pcall(function() customHTTP("REPORT", "payload", "http://localhost/", 5) end)
+      assert.is_false(ok)
+      assert.is_true(contains(err, "customHTTP: bad argument #4 type (headers as a table expected, got number!)"), tostring(err))
+    end)
+
+    it("reports the real type of a non-string file argument", function()
+      -- Regression #9544: the file error must read pos + 4, not a hardcoded slot 4,
+      -- so it names the boolean that was passed and not the headers table's type.
+      -- A boolean is used rather than a number because lua_isstring also accepts
+      -- numbers, so only a genuinely non-string value reaches the type error.
+      local ok, err = pcall(function() customHTTP("REPORT", "payload", "http://localhost/", {}, true) end)
+      assert.is_false(ok)
+      assert.is_true(contains(err, "customHTTP: bad argument #5 type (file to send as string location expected, got boolean!)"), tostring(err))
     end)
   end)
 end)
@@ -408,6 +435,51 @@ describe("Media playback functions validate their parameters", function()
     it("raises a Lua error for a negative fadeout in the table form", function()
       assert.has_error(function() playMusicFile({name = "x.mp3", fadeout = -5}) end)
     end)
+
+    it("raises a clean, non-doubled error when continue is not a boolean", function()
+      -- Regression #9547 (same defect class): the field publicName must not carry
+      -- "must be boolean", which errorArgumentType would then double.
+      local ok, err = pcall(function() playMusicFile({name = "x.mp3", continue = "yes"}) end)
+      assert.is_false(ok)
+      assert.is_true(contains(err, "value for continue as boolean expected, got string!"), tostring(err))
+      assert.is_false(contains(err, "must be boolean"), tostring(err))
+    end)
+  end)
+
+  describe("playVideoFile", function()
+    -- playVideoFileAsTableArgument shared the identical doubled-message defect on
+    -- its continue/stream/close boolean fields (#9547 defect class).
+    it("raises a clean, non-doubled error when continue is not a boolean", function()
+      local ok, err = pcall(function() playVideoFile({name = "x.mp4", continue = "yes"}) end)
+      assert.is_false(ok)
+      assert.is_true(contains(err, "value for continue as boolean expected, got string!"), tostring(err))
+      assert.is_false(contains(err, "must be boolean"), tostring(err))
+    end)
+
+    it("raises a clean, non-doubled error when stream is not a boolean", function()
+      local ok, err = pcall(function() playVideoFile({name = "x.mp4", stream = "yes"}) end)
+      assert.is_false(ok)
+      assert.is_true(contains(err, "value for stream as boolean expected, got string!"), tostring(err))
+      assert.is_false(contains(err, "must be boolean"), tostring(err))
+    end)
+
+    it("raises a clean, non-doubled error when close is not a boolean", function()
+      local ok, err = pcall(function() playVideoFile({name = "x.mp4", close = "yes"}) end)
+      assert.is_false(ok)
+      assert.is_true(contains(err, "value for close as boolean expected, got string!"), tostring(err))
+      assert.is_false(contains(err, "must be boolean"), tostring(err))
+    end)
+  end)
+
+  describe("getPlayingSounds", function()
+    it("raises a clean, non-doubled error when priority is not an integer", function()
+      -- Regression #9547 (same defect class): "value for priority must be integer"
+      -- doubled into "must be integer as number expected".
+      local ok, err = pcall(function() getPlayingSounds({priority = "high"}) end)
+      assert.is_false(ok)
+      assert.is_true(contains(err, "value for priority as number expected, got string!"), tostring(err))
+      assert.is_false(contains(err, "must be integer"), tostring(err))
+    end)
   end)
 
   describe("stopSounds", function()
@@ -419,8 +491,44 @@ describe("Media playback functions validate their parameters", function()
       assert.has_error(function() stopSounds({fadeout = -1}) end)
     end)
 
-    it("raises a Lua error when fadeaway is not a boolean", function()
-      assert.has_error(function() stopSounds({fadeaway = "yes"}) end)
+    it("raises a clean, non-doubled error when priority is not an integer", function()
+      -- Regression #9547 (same defect class, adjacent field in this very parser):
+      -- "value for priority must be integer" doubled the type constraint.
+      local ok, err = pcall(function() stopSounds({priority = "high"}) end)
+      assert.is_false(ok)
+      assert.is_true(contains(err, "value for priority as number expected, got string!"), tostring(err))
+      assert.is_false(contains(err, "must be integer"), tostring(err))
+    end)
+
+    it("raises a clean, non-doubled error when fadeaway is not a boolean", function()
+      -- Regression #9547: the message must not double "boolean" (the field's
+      -- publicName previously carried "must be boolean" while the type validator
+      -- also appended "as boolean expected"). It is reported like the sibling
+      -- table-field validations in this parser (fadeout, name, key).
+      local ok, err = pcall(function() stopSounds({fadeaway = "yes"}) end)
+      assert.is_false(ok)
+      assert.is_true(contains(err, "value for fadeaway as boolean expected, got string!"), tostring(err))
+      assert.is_false(contains(err, "must be boolean"), tostring(err))
+    end)
+  end)
+
+  -- stopMusic and stopVideos parse the same table shape and shared the identical
+  -- doubled-"boolean" fadeaway defect fixed for stopSounds (#9547).
+  describe("stopMusic", function()
+    it("raises a clean, non-doubled error when fadeaway is not a boolean", function()
+      local ok, err = pcall(function() stopMusic({fadeaway = "yes"}) end)
+      assert.is_false(ok)
+      assert.is_true(contains(err, "value for fadeaway as boolean expected, got string!"), tostring(err))
+      assert.is_false(contains(err, "must be boolean"), tostring(err))
+    end)
+  end)
+
+  describe("stopVideos", function()
+    it("raises a clean, non-doubled error when fadeaway is not a boolean", function()
+      local ok, err = pcall(function() stopVideos({fadeaway = "yes"}) end)
+      assert.is_false(ok)
+      assert.is_true(contains(err, "value for fadeaway as boolean expected, got string!"), tostring(err))
+      assert.is_false(contains(err, "must be boolean"), tostring(err))
     end)
   end)
 end)

From 4ee3695509894f313195e74f1ac69bc6f2e9d006 Mon Sep 17 00:00:00 2001
From: mudlet-machine-account
 <39947211+mudlet-machine-account@users.noreply.github.com>
Date: Fri, 31 Jul 2026 09:39:29 +0200
Subject: [PATCH 031/155] Infrastructure: Update text for translation in
 Crowdin (#9563)

#### Brief overview of PR changes/additions
:crown: An automated PR to make new text available for translation in
Crowdin from refs/heads/development
(dae8e9f440eb1b76f2c5295d7a1d483b5577e861).
#### Motivation for adding to Mudlet
So translators can translate the new text before the upcoming release.

Co-authored-by: mudlet-machine-account 
---
 translations/mudlet.ts | 4113 ++++++++++++++++++++--------------------
 1 file changed, 2067 insertions(+), 2046 deletions(-)

diff --git a/translations/mudlet.ts b/translations/mudlet.ts
index 4d8549906..76f6df61f 100644
--- a/translations/mudlet.ts
+++ b/translations/mudlet.ts
@@ -32,7 +32,7 @@
 
     Discord
     
-        
+        
         via Mudlet
         
     
@@ -65,78 +65,78 @@
 
     GMCPAuthenticator
     
-        
+        
         [ WARN ]  - Could not save your sign-in for next time; you may need to sign in again.
         Shown when the user opted to stay signed in but saving the sign-in token failed, so they will have to sign in again next time.
         
     
     
-        
+        
         [ INFO ]  - Resuming your %1 sign-in with the game.
         Shown when Mudlet asks the game to restart the browser sign-in with the remembered provider; %1 is the provider name (e.g. Discord).
         
     
     
-        
+        
         [ WARN ]  - The game sent an invalid sign-in link; cannot continue.
         Shown when the game sends a sign-in link with an unsupported or invalid address (not an http/https web link).
         
     
     
-        
+        
         [ INFO ]  - To sign in, open this link in your browser: %1
         %1 is the sign-in web address the user should open in their browser to sign in.
         
     
     
-        
-        
+        
+        
         [ WARN ]  - Could not open your browser. Open this link manually to sign in: %1
         %1 is the sign-in web address the user should open manually in their browser.
         
     
     
-        
+        
         [ INFO ]  - Opening your browser to sign in. Complete the login there, then return here.
         Shown after the user's browser is launched to complete an OAuth/web sign-in. %1 is the provider name (e.g. Discord).
         
     
     
-        
+        
         [ INFO ]  - Opening your browser to sign in with %1. Complete the login there, then return here.
         
     
     
-        
+        
         [ WARN ]  - The browser sign-in could not be completed; reconnect to try again.
         Shown when a browser-based sign-in with the game's own account could not be completed.
         
     
     
-        
+        
         [ WARN ]  - Cannot complete the sign-in because the connection is not encrypted.
         Shown when a browser sign-in finished but the game connection is not encrypted, so completing it would be unsafe.
         
     
     
-        
+        
         [ WARN ]  - Could not log in to the game, is the login information correct?
         
     
     
-        
+        
         [ WARN ]  - Could not log in to the game: %1
         %1 shows the reason for failure, could be authentication, etc.
         
     
     
-        
+        
         [ INFO ]  - Your saved sign-in has expired; reconnecting so you can sign in again.
         Shown when a saved password-less sign-in is no longer accepted; Mudlet reconnects so the user can sign in again.
         
     
     
-        
+        
         [ INFO ]  - You'll be signed in automatically next time. Manage this under Preferences, Connection.
         Shown once after a browser/OAuth sign-in whose reconnect token was saved, so future connects need no sign-in.
         
@@ -145,104 +145,104 @@
 
     Host
     
-        
+        
         Text to send to the game
         
     
     
-        
+        
         [ ALERT ] - This profile will now save and close.
         
     
     
-        
+        
         Failed to open xml file "%1" inside module %2 to update it. Error message was: "%3".
         This error message will appear when the xml file inside the module zip cannot be updated for some reason.
         
     
     
-        
+        
         Failed to save "%1" to module "%2". Error message was: "%3".
         This error message will appear when a module is saved as package but cannot be done for some reason.
         
     
     
-        
+        
         the profile is no longer available
         
     
     
-        
+        
         [  OK  ]  - %1 Thanks a lot for using the Public Test Build!
         %1 will be a random happy emoji
         
     
     
-        
+        
         [  OK  ]  - %1 Help us make Mudlet better by reporting any problems.
         %1 will be a random happy emoji
         
     
     
-        
+        
         [ ERROR ] - Package install failed for "%1": %2
         
     
     
-        
+        
         Module "%1" is already installed. Please uninstall it first or choose a different name.
         
     
     
-        
+        
         Unpacking module:
 "%1"
 please wait...
         
     
     
-        
+        
         Unpacking package:
 "%1"
 please wait...
         
     
     
-        
+        
         Unpacking
         
     
     
-        
-        
+        
+        
         [ WARN ]  - Failed to load module "%1": %2
         
     
     
-        
+        
         Playing %1
         
     
     
-        
-        
+        
+        
         %1 at %2:%3
         %1 is the game name and %2:%3 is game server address like: mudlet.org:23
         
     
     
-        
-        
+        
+        
         Map - %1
         
     
     
-        
+        
         Pre-Map loading(3) report
         
     
     
-        
+        
         Loading map(3) at %1 report
         
     
@@ -292,165 +292,165 @@ please wait...
 
     MMCPClient
     
-        
+        
         [ CHAT ]  - Waiting for response from %1:%2...
         
     
     
-        
+        
         [ CHAT ]  - You are now disconnected from <unknown> - %1:%2.
         This message is used when a MMCP peer without a name disconnects, * %1 is the peer's IP address (numbers or URL), %2 is the port they are * listening on. Should be similiar to the one when we do have a name.
         
     
     
-        
+        
         [ CHAT ]  - You are now disconnected from %1 - %2:%3.
         This message is used when a MMCP peer with a name disconnects, * %1 is the peer's name, %2 is the peer's IP address (numbers or URL), * %3 is the port they are listening on. Should be similiar to the one when * we do not have a name.
         
     
     
-        
+        
         [ CHAT ]  - Connection from %1 at %2:%3 timed out (not accepted or denied by you).
         
     
     
-        
+        
         [ CHAT ]  - Connection from %1 at %2:%3 denied (Peer name too long (64 chars max)).
         
     
     
-        
+        
         [ CHAT ]  - Connection from %1 at %2:%3 denied (DoNotDisturb).
         
     
     
-        
+        
         [ CHAT ]  - Connection from %1 at %2:%3 is pending, use mmcp.accept(%4) or mmcp.deny(%4) to accept or deny.
         
     
     
-        
+        
         [ CHAT ]  - Connection to %1:%2 refused.
         
     
     
-        
+        
         [ CHAT ]  - Connection to %1 at %2:%3 rejected.
         
     
     
-        
+        
         [ CHAT ]  - Connection to %1 at %2:%3 accepted.
         
     
     
-        
+        
         [ CHAT ]  - Connection from %1 at %2:%3 accepted.
         
     
     
-        
+        
         [ CHAT ]  - Connection from %1 at %2:%3 denied.
         
     
     
-        
+        
         [ CHAT ]  - The peer closed or refused the connection.
         
     
     
-        
+        
         [ CHAT ]  - The peer was not found. Please check the host name and port settings.
         
     
     
-        
+        
         [ CHAT ]  - The connection was refused by the peer.
         
     
     
-        
+        
         [ CHAT ]  - The following error occurred: %1.
         
     
     
-        
+        
         [ CHAT ]  - Pinging %1...
         
     
     
-        
+        
         [ CHAT ]  - Attempting to peek at %1's public connections...
         
     
     
-        
+        
         [ CHAT ]  - Requested connections from %1
         
     
     
-        
+        
         [ CHAT ]  - Badly formatted connection list from %1
         
     
     
-        
+        
         [ CHAT ]  - Error parsing host value from connection: %1
         
     
     
-        
+        
         [ CHAT ]  - Attempting to connect to %1:%2 provided by %3
         
     
     
-        
+        
         [ CHAT ]  - %1 is trying to request your connections!
         
     
     
-        
+        
         [ CHAT ]  - %1 has requested your public connections...
         
     
     
-        
+        
         [ CHAT ]  - %1 has requested your public connections, but you're ignoring connection requests...
         
     
     
-        
+        
         %1%2%3%4(%5)%1%2%6%1
         Incoming group message, %1, %2 and %4 are ANSI Escape codes
         
     
     
-        
+        
         [ CHAT ]  - %1 is now known as %2.
         
     
     
-        
+        
         [ CHAT ]  - %1 is trying to peek your connections!
         
     
     
-        
+        
         [ CHAT ]  - %1 is peeking at your connections...
         
     
     
-        
+        
         [ CHAT ]  - %1 is trying to peek your connections, but you're ignoring peek requests...
         
     
     
-        
+        
         [ CHAT ]  - Badly formatted peek list from %1.
         
     
     
-        
+        
         Id   Name                 Address         Port
 ==== ==================== =============== =====
 %1
@@ -459,27 +459,27 @@ please wait...
         
     
     
-        
+        
         [ CHAT ]  - Ping returned from %1: %2 ms
         
     
     
-        
+        
         [ CHAT ]  - Bad Ping response from %1: %2
         
     
     
-        
+        
         [ CHAT ]  - %1 tried to snoop you but doesn't have permission.
         
     
     
-        
+        
         [ CHAT ]  - %1 has stopped snooping you.
         
     
     
-        
+        
         [ CHAT ]  - %1 has begun snooping you.
         
     
@@ -772,19 +772,19 @@ This text is shown when room(s) are (not) selected in mapper. %1 is the room ID
 
     ModernGLWidget
     
-        
+        
         No rooms in the map - load another one, or start mapping from scratch to begin.
         
     
     
-        
+        
         You have a map loaded (%n room(s)), but Mudlet does not know where you are at the moment.
         
             
         
     
     
-        
+        
         You do not have a map yet - load one, or start mapping from scratch to begin.
         
     
@@ -1179,7 +1179,7 @@ This text is shown when room(s) are (not) selected in mapper. %1 is the room ID
         
     
     
-        
+        
         [ INFO ]  - This game seems to wrap its own lines at %1 characters, which
 makes triggers awkward to write. Mudlet can undo that, so that triggers
 always see whole lines and wrapping follows your window size instead:
@@ -1187,46 +1187,46 @@ always see whole lines and wrapping follows your window size instead:
         
     
     
-        
+        
         Done - Mudlet now undoes the game's wrapping, and triggers see whole lines.
         Confirmation shown after the player clicks the link that enables undoing the game's own line wrapping
         
     
     
-        
+        
         Turn on "Undo the game's own wrapping" - also found in the settings under Main display
         Tooltip on the link that enables the option to undo the game's own line wrapping
         
     
     
-        
+        
           ➜ Click here to turn that on now
         Clickable link shown in the main window when a game that wraps its own lines is detected
         
     
     
-        
+        
         Send
         
     
     
-        
+        
         Prompt
         
     
     
-        
+        
         Open browser to
         
     
     
-        
+        
         Right-click for menu
         
     
     
-        
-        
+        
+        
         Click to reveal
         
     
@@ -1620,25 +1620,25 @@ always see whole lines and wrapping follows your window size instead:
         
     
     
-        
+        
         No key binding set. Click "Grab New Key" to assign one.
         Error shown in the editor when a key item has no key binding assigned
         
     
     
-        
+        
         Telnet Protocol Handler
         Title for the dialog asking if Mudlet should handle telnet:// and telnets:// links
         
     
     
-        
+        
         Another application is set to handle telnet:// and telnets:// links.
         Text shown when another application is already handling telnet:// and telnets:// links
         
     
     
-        
+        
         Would you like Mudlet to handle telnet:// and telnets:// links instead?
 
 This will allow you to click on telnet:// and telnets:// links in your browser to automatically open them in Mudlet.
@@ -1648,7 +1648,7 @@ You can change this later in Settings > General.
         
     
     
-        
+        
         Don't ask again
         Checkbox on the telnet handler prompt that suppresses future prompts
         
@@ -1852,7 +1852,7 @@ You can change this later in Settings > General.
     
     
         
-        
+        
         Delete
         2D Mapper context menu (room) item
 ----------
@@ -2033,31 +2033,31 @@ You can change this later in Settings > General.
     
     
         
-        
+        
         Solid line
         
     
     
         
-        
+        
         Dot line
         
     
     
         
-        
+        
         Dash line
         
     
     
         
-        
+        
         Dash-dot line
         
     
     
         
-        
+        
         Dash-dot-dot line
         
     
@@ -2068,120 +2068,120 @@ You can change this later in Settings > General.
         
     
     
-        
+        
         Move the selection, centered on the highlighted room (%1) to:
         %1 is a room number
         
     
     
-        
+        
         x coordinate (was %1):
         
     
     
-        
+        
         y coordinate (was %1):
         
     
     
-        
+        
         z coordinate (was %1):
         
     
     
-        
+        
         OK
         dialog (room(s) move) button
         
     
     
-        
+        
         Cancel
         dialog (room(s) move) button
         
     
     
-        
+        
         Click to finish moving the selected room(s).
         
     
     
-        
+        
         [ ERROR ] - Unable to add "%1" as an area to the map.
 See the "[MAP ERROR:]" message for the reason.
         The '[MAP ERROR:]' text here should be the same as that used for the translation of "[MAP ERROR:] %1" in the 'TMap::logError(...)' function.
         
     
     
-        
+        
         Configure Areas
         
     
     
-        
+        
         Create
         "Configure Areas" buttons: create new area
         
     
     
-        
+        
         Rename
         "Configure Areas" buttons: rename existing area
         
     
     
-        
+        
         Close
         "Configure Areas" buttons: close the dialog
         
     
     
-        
+        
         Rename area
         Dialog title for renaming an area
         
     
     
-        
+        
         New name:
         
     
     
-        
+        
         Rename failed
         Warning message shown when renaming an area fails.
         
     
     
-        
+        
         Unable to rename area. Name may be invalid or already in use.
         
     
     
-        
+        
         Create area
         Dialog title for creating a new area
         
     
     
-        
+        
         Name:
         
     
     
-        
+        
         Create failed
         Warning message shown when creating a new area fails.
         
     
     
-        
+        
         Unable to create area. Name may be invalid or already in use.
         
     
     
-        
-        
+        
+        
         Delete failed
         Warning message shown when trying to delete the default area.
 ----------
@@ -2189,50 +2189,50 @@ Warning message shown when trying to delete an area fails.
         
     
     
-        
+        
         The default area cannot be deleted.
         
     
     
-        
+        
         Unable to delete area.
         
     
     
-        
-        
+        
+        
         Left-click to add point, right-click to undo/change/finish...
         2D Mapper big, bottom of screen help message
         
     
     
-        
+        
         Left-click and drag a square for the size and position of your label
         2D Mapper big, bottom of screen help message
         
     
     
-        
+        
         [MAP]: %1
         
     
     
-        
+        
         Unknown Area
         
     
     
-        
+        
         Export Area %1 to Image
         
     
     
-        
+        
         Image Files (*.png *.jpg *.jpeg *.bmp *.tiff);;All Files (*)
         
     
     
-        
+        
         [MAP]: Export failed - %1
         
     
@@ -2275,12 +2275,12 @@ Warning message shown when trying to delete an area fails.
         
     
     
-        
+        
         Spread out rooms
         
     
     
-        
+        
         Increase the spacing of
 the selected rooms,
 centered on the
@@ -2289,12 +2289,12 @@ factor of:
         
     
     
-        
+        
         Shrink in rooms
         
     
     
-        
+        
         Decrease the spacing of
 the selected rooms,
 centered on the
@@ -2303,23 +2303,23 @@ factor of:
         
     
     
-        
+        
         Load Mudlet map
         
     
     
-        
+        
         Mudlet map (*.dat);;Xml map data (*.xml);;Any file (*)
         Do not change extensions (in braces) or the ;;s as they are used programmatically
         
     
     
-        
+        
         This will create new area: %1
         
     
     
-        
+        
         [  OK  ]  - Added "%1" (%2) area to map.
         
     
@@ -2335,12 +2335,12 @@ factor of:
 
     TArea
     
-        
+        
         roomID=%1 does not exist, can not set properties of a non-existent room!
         
     
     
-        
+        
         no text
         Default text if a label is created in mapper with no text
         
@@ -2349,61 +2349,61 @@ factor of:
 
     TCommandLine
     
-        
-        
+        
+        
         Show password
         
     
     
-        
+        
         Add to user dictionary
         
     
     
-        
+        
         Remove from user dictionary
         
     
     
-        
+        
         ▼Mudlet▼ │ dictionary suggestions │ ▲User▲
         This line is shown in the list of spelling suggestions on the profile's command line context menu to clearly divide up where the suggestions for correct spellings are coming from. The precise format might be modified as long as it is clear that the entries below this line in the menu come from the spelling dictionary that the user has chosen in the profile setting which we have bundled with Mudlet; the entries about this line are the ones that the user has personally added.
         
     
     
-        
+        
         ▼System▼ │ dictionary suggestions │ ▲User▲
         This line is shown in the list of spelling suggestions on the profile's command line context menu to clearly divide up where the suggestions for correct spellings are coming from. The precise format might be modified as long as it is clear that the entries below this line in the menu come from the spelling dictionary that the user has chosen in the profile setting which is provided as part of the OS; the entries about this line are the ones that the user has personally added.
         
     
     
-        
+        
         no suggestions (system)
         Used when the command spelling checker using the selected system dictionary has no words to suggest.
         
     
     
-        
+        
         no suggestions (shared)
         Used when the command spelling checker using the dictionary shared between profile has no words to suggest.
         
     
     
-        
+        
         no suggestions (profile)
         Used when the command spelling checker using the profile's own dictionary has no words to suggest.
         
     
     
-        
+        
         Input line for "%1" profile.
         Accessibility-friendly name to describe the main command line for a Mudlet profile when more than one profile is loaded, %1 is the profile name. Because this is likely to be used often it should be kept as short as possible.
         
     
     
-        
-        
-        
+        
+        
+        
         Type in text to send to the game server for the "%1" profile, or enter an alias to run commands locally.
         Accessibility-friendly description for the main command line for a Mudlet profile when more than one profile is loaded, %1 is the profile name. Because this is likely to be used often it should be kept as short as possible.
 ----------
@@ -2413,15 +2413,15 @@ Accessibility-friendly description for the built-in command line of a console/wi
         
     
     
-        
+        
         Input line.
         Accessibility-friendly name to describe the main command line for a Mudlet profile when only one profile is loaded. Because this is likely to be used often it should be kept as short as possible.
         
     
     
-        
-        
-        
+        
+        
+        
         Type in text to send to the game server, or enter an alias to run commands locally.
         Accessibility-friendly description for the main command line for a Mudlet profile when only one profile is loaded. Because this is likely to be used often it should be kept as short as possible.
 ----------
@@ -2431,31 +2431,31 @@ Accessibility-friendly description for the built-in command line of a console/wi
         
     
     
-        
+        
         Additional input line "%1" on "%2" window of "%3"profile.
         Accessibility-friendly name to describe an extra command line on top of console/window when more than one profile is loaded, %1 is the command line name, %2 is the name of the window/console that it is on and %3 is the name of the profile.
         
     
     
-        
+        
         Additional input line "%1" on "%2" window.
         Accessibility-friendly name to describe an extra command line on top of console/window when only one profile is loaded, %1 is the command line name and %2 is the name of the window/console that it is on.
         
     
     
-        
+        
         Input line of "%1" window of "%2" profile.
         Accessibility-friendly name to describe the built-in command line of a console/window other than the main one, when more than one profile is loaded, %1 is the name of the window/console and %2 is the name of the profile.
         
     
     
-        
+        
         Input line of "%1" window.
         Accessibility-friendly name to describe the built-in command line of a console/window other than the main one, when only one profile is loaded, %1 is the name of the window/console.
         
     
     
-        
+        
         Hide password
         
     
@@ -2463,372 +2463,372 @@ Accessibility-friendly description for the built-in command line of a console/wi
 
     TConsole
     
-        
+        
         Debug Console
         
     
     
-        
+        
         N:%1 S:%2
         The first argument 'N' represents the 'N'etwork latency; the second 'S' the 'S'ystem (processing) time
         
     
     
-        
+        
         <no GA> S:%1
         The argument 'S' represents the 'S'ystem (processing) time, in this situation the Game Server is not sending "GoAhead" signals so we cannot deduce the network latency...
         
     
     
-        
+        
         System Message: %1
         
     
     
-        
+        
         [ INFO ]  - Split-screen scrollback activated. Press <⌘>+<ENTER> to cancel.
         
     
     
-        
+        
         [ INFO ]  - Split-screen scrollback activated. Press <CTRL>+<ENTER> to cancel.
         
     
     
-        
+        
         Debug messages from all profiles are shown here.
         
     
     
-        
+        
         Central debug console past content.
         accessibility-friendly name to describe the upper half of the Mudlet central debug window when you've scrolled up
         
     
     
-        
+        
         Central debug console live content.
         accessibility-friendly name to describe the lower half of the Mudlet central debug when you've scrolled up
         
     
     
-        
+        
         Central debug console.
         accessibility-friendly name to describe the upper half of the Mudlet central debug window when it is not scrolled up
         
     
     
-        
+        
         Editor's error window for profile "%1", past content.
         accessibility-friendly name to describe the upper half of the Mudlet profile's editor error window when you've scrolled up, %1 is the name of the profile when more than one is loaded.
         
     
     
-        
+        
         Editor's error window for profile "%1", live content.
         accessibility-friendly name to describe the lower half of the Mudlet profile's editor error window when you've scrolled up, %1 is the name of the profile when more than one is loaded.
         
     
     
-        
+        
         Editor's error window past content.
         accessibility-friendly name to describe the upper half of the Mudlet profile's editor error window when you've scrolled up and only one profile is loaded.
         
     
     
-        
+        
         Editor's error window live content.
         accessibility-friendly name to describe the lower half of the Mudlet profile's editor error window when you've scrolled up and only one profile is loaded.
         
     
     
-        
+        
         Editor's error window for profile "%1".
         accessibility-friendly name to describe the upper half of the Mudlet profile's editor error window when it is not scrolled up, %1 is the name of the profile when more than one is loaded.
         
     
     
-        
+        
         Editor's error window
         accessibility-friendly name to describe the upper half of the Mudlet profile's editor error window when it is not scrolled up and only one profile is loaded.
         
     
     
-        
+        
         Game content is shown here. It may contain subconsoles and a mapper window.
         
     
     
-        
+        
         main window
         
     
     
-        
-        
+        
+        
         Start recording of replay
         Button tooltip for the replay recording toggle button
         
     
     
-        
+        
         Start logging game output to log file.
         Button tooltip for the logging button
         
     
     
-        
+        
         <i>N:</i> network latency in seconds (ping),<br><i>S:</i> system processing time (triggers).
         Tooltip for N and S network latency indicators
         
     
     
-        
+        
         Search
         search bar placeholder text
         
     
     
-        
+        
         Search buffer.
         
     
     
-        
-        
+        
+        
         Search Options
         
     
     
-        
+        
         Case sensitive
         
     
     
-        
+        
         Match case precisely
         
     
     
-        
+        
         Earlier search result.
         
     
     
-        
+        
         Later search result.
         
     
     
-        
+        
         Failed to open replay recording file for writing.
         Informational message displayed when replay recording file could not be opened
         
     
     
-        
+        
         Replay recording has started. File: %1
         
     
     
-        
+        
         Stop recording of replay
         Button tooltip for the replay recording toggle button
         
     
     
-        
+        
         Replay recording has been stopped, but couldn't be saved.
         Informational message displayed when replay recording is stopped but could not be saved
         
     
     
-        
+        
         Replay recording has been stopped. File: %1
         Informational message displayed when replay recording is stopped
         
     
     
-        
-        
+        
+        
         No search results, sorry!
         
     
     
-        
+        
         Debug Console.
         
     
     
-        
+        
         Profile "%1" main window past content.
         accessibility-friendly name to describe the upper half of a Mudlet profile's main window when you've scrolled up, %1 is the name of the profile when more than one is loaded.
         
     
     
-        
+        
         Profile "%1" main window live content.
         accessibility-friendly name to describe the lower half of a Mudlet profile's main window when you've scrolled up, %1 is the name of the profile when more than one is loaded.
         
     
     
-        
+        
         Profile main window past content.
         accessibility-friendly name to describe the upper half of a Mudlet profile's main window when you've scrolled up and only one profile is loaded.
         
     
     
-        
+        
         Profile main window live content.
         accessibility-friendly name to describe the lower half of a Mudlet profile's main window when you've scrolled up and only one profile is loaded.
         
     
     
-        
+        
         Profile "%1" main window.
         accessibility-friendly name to describe the upper half of a Mudlet profile's main window when it is not scrolled up, %1 is the name of the profile when more than one is loaded.
         
     
     
-        
+        
         Profile main window.
         accessibility-friendly name to describe the upper half of a Mudlet profile's main window when it is not scrolled up and only one profile is loaded.
         
     
     
-        
+        
         Profile "%1" embedded window "%2" past content.
         accessibility-friendly name to describe the upper half of a Mudlet profile's sub-console window when you've scrolled up, %1 is the name of the profile when more than one is loaded and %2 is the name of the window.
         
     
     
-        
+        
         Profile "%1" embedded window "%2" live content.
         accessibility-friendly name to describe the lower half of a Mudlet profile's sub-console window when you've scrolled up, %1 is the name of the profile when more than one is loaded and %2 is the name of the window.
         
     
     
-        
+        
         Profile embedded window "%1" past content.
         accessibility-friendly name to describe the upper half of a Mudlet profile's sub-console window when you've scrolled up, %1 is the name of the window.
         
     
     
-        
+        
         Profile embedded window "%1" live content.
         accessibility-friendly name to describe the lower half of a Mudlet profile's sub-console window when you've scrolled up, %1 is the name of the window.
         
     
     
-        
+        
         Profile "%1" embedded window "%2".
         accessibility-friendly name to describe the upper half of a Mudlet profile's sub-console window when it is not scrolled up, %1 is the name of the profile when more than one is loaded and %2 is the name of the window.
         
     
     
-        
+        
         Profile embedded window "%1".
         accessibility-friendly name to describe the upper half of a Mudlet profile's sub-console window when it is not scrolled up, %1 is the name of the window.
         
     
     
-        
+        
         Profile "%1" user window "%2" past content.
         accessibility-friendly name to describe the upper half of a Mudlet profile's floating/dockable user window when you've scrolled up, %1 is the name of the profile when more than one is loaded and %2 is the name of the window.
         
     
     
-        
+        
         Profile "%1" user window "%2" live content.
         accessibility-friendly name to describe the lower half of a Mudlet profile's floating/dockable user window window when you've scrolled up, %1 is the name of the profile when more than one is loaded and %2 is the name of the window.
         
     
     
-        
+        
         Profile user window "%1" past content.
         accessibility-friendly name to describe the upper half of a Mudlet profile's sub-console window when you've scrolled up, %1 is the name of the window.
         
     
     
-        
+        
         Profile user window "%1" live content.
         accessibility-friendly name to describe the lower half of a Mudlet profile's sub-console window when you've scrolled up, %1 is the name of the window.
         
     
     
-        
+        
         Profile "%1" user window "%2".
         accessibility-friendly name to describe the upper half of a Mudlet profile's floating/dockable user window window when it is not scrolled up, %1 is the name of the profile when more than one is loaded and %2 is the name of the window.
         
     
     
-        
+        
         Profile user window "%1".
         accessibility-friendly name to describe the upper half of a Mudlet profile's floating/dockable user window window when it is not scrolled up, %1 is the name of the window.
         
     
     
-        
+        
         Error Console in editor.
         
     
     
-        
+        
         Toggle time stamps
         
     
     
-        
+        
         Emergency stop! Stop all scripts
         
     
     
-        
+        
         Error messages for the "%1" profile are shown here in the editor.
         
     
     
-        
+        
         Error messages are shown here in the editor.
         
     
     
-        
+        
         Main Window for "%1" profile.
         
     
     
-        
+        
         Main Window.
         
     
     
-        
+        
         Embedded window "%1" for "%2" profile.
         
     
     
-        
+        
         Embedded window "%1".
         
     
     
-        
+        
         Game content or locally generated text may be sent here.
         
     
     
-        
+        
         User window "%1" for "%2" profile.
         
     
     
-        
+        
         User window "%1".
         
     
     
-        
+        
         Game content or locally generated text may be sent to this window that may be floated away from the Mudlet application or docked within the main application window.
         
     
@@ -2836,39 +2836,39 @@ Accessibility-friendly description for the built-in command line of a console/wi
 
     TDetachedWindow
     
-        
-        
+        
+        
         Mudlet - %1 (Detached)
         This is the title of a Mudlet window which was detached from the main Mudlet window, and %1 is the name of the profile.
         
     
     
-        
+        
         &Close Profile
         This is an item in the "Games" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Close the current profile
         This explains the "Close Profile" item in the "Games" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         &Window
         This is the name of a menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         &Reattach to Main Window
         This is an item in the "Window" menu in the menubar of a detached Mudlet window.
         
     
     
-        
-        
+        
+        
         Reattach this profile window to the main Mudlet window
         This explains the "Reattach to Main Window" item in the "Window" menu in the menubar of a detached Mudlet window.
 ----------
@@ -2876,45 +2876,45 @@ This explains the "Reattach" item in the toolbar of a detached Mudlet
         
     
     
-        
+        
         Always on &Top
         This is an item in the "Window" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Keep this window always on top of other windows
         This explains the "Always on Top" item in the "Window" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         &Minimize
         This is an item in the "Window" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Reattach '%1' to Main Window
         This is an item in the context menu when clicked on a detached tab, and %1 is the name of the profile.
         
     
     
-        
+        
         Close Profile '%1'
         This is an item in the context menu when clicked on a detached tab, and %1 is the name of the profile.
         
     
     
-        
+        
         Close Window (All Profiles)
         This is an item in the context menu when clicked on a detached tab.
         
     
     
-        
-        
-        
+        
+        
+        
         Connect
         This is an item in the toolbar of a detached Mudlet window.
 ----------
@@ -2922,522 +2922,522 @@ This is a sub-item of the "Connect" item in the toolbar of a detached
         
     
     
-        
+        
         Disconnect
         This is a sub-item of the "Connect" item in the toolbar of a detached Mudlet window.
         
     
     
-        
+        
         Reconnect
         
     
     
-        
-        
+        
+        
         Close profile
         This is a sub-item of the "Connect" item in the toolbar of a detached Mudlet window.
         
     
     
-        
+        
         Show &Toolbar
         This is an item for the toolbar visibility toggle in a detached Mudlet window.
         
     
     
-        
+        
         Show or hide the toolbar
         This explains the "Show Toolbar" action for toolbar visibility in a detached Mudlet window.
         
     
     
-        
+        
         Show Connection Indicators on Tabs
         This is an item in the context menu when clicked on a detached tab.
         
     
     
-        
+        
         Reattach
         This is an item in the toolbar of a detached Mudlet window. It will reattach the profile to the main Mudlet window.
         
     
     
-        
-        
+        
+        
         Close Mudlet
         This is a sub-item of the "Connect" item in the toolbar of a detached Mudlet window.
         
     
     
-        
+        
         Triggers
         
     
     
-        
+        
         Show and edit triggers
         
     
     
-        
+        
         Aliases
         
     
     
-        
+        
         Show and edit aliases
         
     
     
-        
+        
         Timers
         
     
     
-        
+        
         Show and edit timers
         
     
     
-        
+        
         Buttons
         
     
     
-        
+        
         Show and edit easy buttons
         
     
     
-        
+        
         Scripts
         
     
     
-        
+        
         Show and edit scripts
         
     
     
-        
+        
         Keys
         
     
     
-        
+        
         Show and edit keys
         
     
     
-        
+        
         Variables
         
     
     
-        
+        
         Show and edit Lua variables
         
     
     
-        
+        
         Mute
         
     
     
-        
-        
-        
+        
+        
+        
         Mute all media
         This is an item in the "Options" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         &Games
         This is the name of a menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         &Play
         This is an item in the "Games" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Configure connection details of, and make a connection to, game servers.
         This explains the "Play" item in the "Games" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         &Disconnect
         This is an item in the "Games" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Disconnect from the current game server.
         This explains the "Disconnect" item in the "Games" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         &Reconnect
         This is an item in the "Games" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Disconnect and then reconnect to the current game server.
         This explains the "Reconnect" item in the "Games" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Close &Mudlet
         This is an item in the "Games" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Close the entire Mudlet application
         This explains the "Close Mudlet" item in the "Games" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         &Toolbox
         This is the name of a menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         &Script editor
         This is an item in the "Toolbox" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Opens the Editor for the different types of things that can be scripted by the user.
         This explains the "Script editor" item in the "Toolbox" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Show &errors
         This is an item in the "Toolbox" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Show errors from scripts that you have running
         This explains the "Show errors" item in the "Toolbox" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Show &map
         This is an item in the "Toolbox" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Show or hide the game map.
         This explains the "Show map" item in the "Toolbox" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Compact &input line
         This is an item in the "Toolbox" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Hide / show the search area and buttons at the bottom of the screen.
         This explains the "Compact input line" item in the "Toolbox" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         &Notepad
         This is an item in the "Toolbox" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Opens a free form text editor window for this profile that is saved between sessions.
         This explains the "Notepad" item in the "Toolbox" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         &Package manager
         This is an item in the "Toolbox" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Install and remove collections of Mudlet lua items (packages).
         This explains the "Package manager" item in the "Toolbox" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Load &replay
         This is an item in the "Toolbox" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Load a previous saved game session that can be used to test Mudlet lua systems (off-line!).
         This explains the "Load replay" item in the "Toolbox" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         &Module manager
         This is an item in the "Toolbox" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Install and remove (share- & sync-able) collections of Mudlet lua items (modules).
         This explains the "Module manager" item in the "Toolbox" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Package &exporter
         This is an item in the "Toolbox" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Gather and bundle up collections of Mudlet Lua items and other reasources into a module.
         This explains the "Package exporter" item in the "Toolbox" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Record replay
         This is an item in the "Toolbox" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Toggle recording of replays.
         This explains the "Record replay" item in the "Toolbox" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Record log
         This is an item in the "Toolbox" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Toggle logging facilities.
         This explains the "Record log" item in the "Toolbox" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Emergency stop
         This is an item in the "Toolbox" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Toggle all triggers, aliases, timers, etc. on or off
         This explains the "Emergency stop" item in the "Toolbox" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         &Options
         This is the name of a menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         &Preferences
         This is an item in the "Options" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Configure setting for the Mudlet application globally and for the current profile.
         This explains the "Preferences" item in the "Options" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         &Timestamps
         This is an item in the "Options" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Toggle time stamps on the main console.
         This explains the "Timestamps" item in the "Options" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Mutes all media played.
         This explains the "Mute all media" item in the "Options" menu in the menubar of a detached Mudlet window.
         
     
     
-        
-        
-        
+        
+        
+        
         Mute sounds from Mudlet (triggers, scripts, etc.)
         This is an item in the "Options" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Mutes media played by the Lua API and scripts.
         This explains the "Mute sounds from Mudlet (triggers, scripts, etc.)" item in the "Options" menu in the menubar of a detached Mudlet window.
         
     
     
-        
-        
-        
+        
+        
+        
         Mute sounds from the game (MCMP, MSP)
         This is an item in the "Options" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Mutes media played by the game (MCMP, MSP).
         This explains the "Mute sounds from the game (MCMP, MSP)" item in the "Options" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         &Fullscreen
         This is an item in the "Window" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         &Multiview
         This is an item in the "Window" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Splits the Mudlet screen to show multiple profiles at once; disabled when less than two are loaded.
         This explains the "Multiview" item in the "Window" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Minimize this window
         This explains the "Minimize" item in the "Window" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         &Help
         This is the name of a menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         &API Reference
         This is an item in the "Help" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Opens the Mudlet manual in your web browser.
         This explains the "API Reference" item in the "Help" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         &Video tutorials
         This is an item in the "Help" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Opens an (on-line) collection of "Educational Mudlet screencasts" in your system web-browser.
         This explains the "Video tutorials" item in the "Help" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         &Discord
         This is an item in the "Help" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Open a link to Discord.
         This explains the "Discord" item in the "Help" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Discord &help channel
         This is an item in the "Help" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Open a link to the Mudlet server on Discord.
         This explains the "Discord help channel" item in the "Help" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         &Live help chat
         This is an item in the "Help" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Opens a connect to an IRC server (LiberaChat) in your system web-browser.
         This explains the "Live help chat" item in the "Help" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Online &forum
         This is an item in the "Help" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Opens the (on-line) Mudlet Forum in your system web-browser.
         This explains the "Online forum" item in the "Help" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         &About
         This is the name of a menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         About &Mudlet
         This is an item in the "About" menu in the menubar of a detached Mudlet window.
         
     
     
-        
-        
+        
+        
         About Mudlet version, creators, and license.
         Tooltip for About Mudlet sub-menu item (Used in multiple places - please ensure all have the same translation).
 ----------
@@ -3445,45 +3445,45 @@ Tooltip for About Mudlet toolbar button (Used in multiple places - please ensure
         
     
     
-        
+        
         &Check for updates...
         This is an item in the "About" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Check for newer versions of Mudlet
         This explains the "Check for updates..." item in the "About" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Show &changelog
         This is an item in the "About" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Show the changelog for this version
         This explains the "Show changelog" item in the "About" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         &Report an issue
         This is an item in the "About" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         The public test build gets newer features to you quicker, and you help us find issues in them quicker. Spotted something odd? Let us know asap!
         This explains the "Report an issue" item in the "About" menu in the menubar of a detached Mudlet window.
         
     
     
-        
-        
-        
+        
+        
+        
         Main Toolbar
         This is a checkable toggle item in the context menu shown when right-clicking a tab in a detached window, to show or hide the toolbar. It appears with a checkmark when the toolbar is visible.
 ----------
@@ -3493,158 +3493,158 @@ This is a checkable toggle item in the context menu shown when right-clicking th
         
     
     
-        
+        
         Open Discord
         
     
     
-        
+        
         Mudlet chat
         
     
     
-        
+        
         Open a link to the Mudlet server on Discord
         
     
     
-        
+        
         Map
         
     
     
-        
+        
         Show/hide the map
         
     
     
-        
+        
         Manual
         
     
     
-        
+        
         Browse reference material and documentation
         
     
     
-        
+        
         Settings
         
     
     
-        
+        
         See and edit profile preferences
         
     
     
-        
+        
         Notepad
         
     
     
-        
+        
         Open a notepad that you can store your notes in
         
     
     
-        
-        
+        
+        
         Packages
         
     
     
-        
+        
         Package Manager
         
     
     
-        
+        
         Module Manager
         
     
     
-        
+        
         Package Exporter
         
     
     
-        
+        
         Replay
         
     
     
-        
+        
         Disconnects you from the game and connects once again
         
     
     
-        
+        
         About
         
     
     
-        
+        
         Full Screen
         
     
     
-        
-        
+        
+        
         Toggle Full Screen View
         This explains the "Fullscreen" item in the "Window" menu in the menubar of a detached Mudlet window.
         
     
     
-        
+        
         Connected to %1
         This text will be added to the title of a detached Mudlet window, if it is currently connected. The whole title will be like "Mudlet PROFILENAME (Detached) - Connected to GAMENAME"
         
     
     
-        
+        
         Connected
         This text will be part of to the title of a detached Mudlet window, if it is currently connected but we don't know to where. The whole title will be like "Mudlet PROFILENAME (Detached) - Connected"
         
     
     
-        
+        
         Connecting...
         This text will be part of the title of a detached Mudlet window, if it is about to be connected. The whole title will be like "Mudlet PROFILENAME (Detached) - Connecting..."
         
     
     
-        
+        
         Disconnected
         This text will be part of the title of a detached Mudlet window, if it is not connected. The whole title will be like "Mudlet PROFILENAME (Detached) - Disconnected"
         
     
     
-        
+        
         %1 (Main Window)
         This is an item in list of profiles in the "Window" menu of a detached Mudlet window. %1 is the name of the profile, and it is located not in the detached window, but in Mudlet's main window.
         
     
     
-        
+        
         %1 (Detached)
         This is an item in list of profiles in the "Window" menu of a detached Mudlet window. %1 is the name of the profile, and it is located not in Mudlet's main window, but in the detached window.
         
     
     
-        
+        
         Map - %1
         This is to create a new docked mapper widget for a profile in a detached Mudlet window. %1 is the name of the profile.
         
     
     
-        
+        
         Mudlet (Detached)
         This is the title of a Mudlet window which was detached from the main Mudlet window, but has no profile loaded.
         
     
     
-        
+        
         Mudlet (%1 profiles) - %2 (Detached)
         This is the title of a Mudlet window which was detached from the main Mudlet window, and has multiple profiles opened in this window. %1 is the number of profiles, %2 is the name of the profile currently shown.
         
@@ -3653,7 +3653,7 @@ This is a checkable toggle item in the context menu shown when right-clicking th
 
     TEasyButtonBar
     
-        
+        
         Easybutton Bar - %1 - %2
         
     
@@ -3670,13 +3670,13 @@ This is a checkable toggle item in the context menu shown when right-clicking th
 
     THyperlinkVisibilityManager
     
-        
+        
         Link hidden
         Screen-reader announcement when an OSC 8 hyperlink is hidden by the visibility manager
         
     
     
-        
+        
         %n link(s) hidden
         Screen-reader announcement when multiple OSC 8 hyperlinks are hidden at once; %n is the count
         
@@ -3684,7 +3684,7 @@ This is a checkable toggle item in the context menu shown when right-clicking th
         
     
     
-        
+        
         Link revealed: %1
         Screen-reader announcement when a previously hidden OSC 8 link is revealed; %1 is the original link text
         
@@ -3702,115 +3702,115 @@ This is a checkable toggle item in the context menu shown when right-clicking th
 
     TLuaInterpreter
     
-        
+        
         Playing %1
         
     
     
-        
-        
+        
+        
         ERROR
         
     
     
-        
+        
         No error message available from Lua
         
     
     
-        
-        
+        
+        
         object
         object is the Mudlet alias/trigger/script, used in this sample message: object:<Alias1> function:<cure_me>
         
     
     
-        
-        
+        
+        
         function
         function is the Lua function, used in this sample message: object:<Alias1> function:<cure_me>
         
     
     
-        
+        
         Lua error: %1
         
     
     
-        
+        
         [ ERROR ] - Cannot find Lua module %1.%2%3%4
         %1 is the name of the module; %2 will be a line-feed inserted to put the next argument on a new line; %3 is the error message from the lua sub-system; %4 can be an additional message about the expected effect (but may be blank).
         
     
     
-        
+        
         Probably will not be able to access Mudlet Lua code.
         
     
     
-        
+        
         Some regular expression functions may not be available.
         
     
     
-        
+        
         Database support will not be available.
         
     
     
-        
+        
         utf8.* Lua functions won't be available.
         
     
     
-        
+        
         yajl.* Lua functions won't be available.
         
     
     
-        
+        
         lpeg.* Lua functions won't be available.
         
     
     
-        
+        
         No error message available from Lua.
         
     
     
-        
+        
         Lua error: %1.
         
     
     
-        
+        
         [ ERROR ] - Cannot load code formatter, indenting functionality won't be available.
         
     
     
-        
+        
         %1 (doesn't exist)
         This file doesn't exist
         
     
     
-        
+        
         %1 (isn't a file or symlink to a file)
         
     
     
-        
+        
         %1 (isn't a readable file or symlink to a readable file)
         
     
     
-        
+        
         %1 (couldn't read file)
         This file could not be read for some reason (for example, no permission)
         
     
     
-        
+        
         [ ERROR ] - Couldn't find, load and successfully run LuaGlobal.lua - your Mudlet is broken!
 Tried these locations:
 %1
@@ -3820,151 +3820,151 @@ Tried these locations:
 
     TMainConsole
     
-        
+        
         Mudlet MUD Client version: %1%2
         
     
     
-        
+        
         Mudlet, log from %1 profile
         
     
     
-        
+        
         Stop logging game output to log file.
         
     
     
-        
+        
         Logging has started. Log file is %1
         
     
     
-        
+        
         logfile
         Must be a valid default filename for a log-file and is used if the user does not enter any other value (Ensure all instances have the same translation {one of two copies}).
         
     
     
-        
+        
         Logging has been stopped. Log file is %1
         
     
     
-        
-        
+        
+        
         'Log session starting at 'hh:mm:ss' on 'dddd', 'd' 'MMMM' 'yyyy'.
         This is the format argument to QDateTime::toString(...) and needs to follow the rules for that function {literal text must be single quoted} as well as being suitable for the translation locale
         
     
     
-        
+        
         'Log session ending at 'hh:mm:ss' on 'dddd', 'd' 'MMMM' 'yyyy'.
         This is the format argument to QDateTime::toString(...) and needs to follow the rules for that function {literal text must be single quoted} as well as being suitable for the translation locale
         
     
     
-        
+        
         Start logging game output to log file.
         
     
     
-        
+        
         Pre-Map loading(2) report
         
     
     
-        
+        
         Loading map(2) at %1 report
         
     
     
-        
+        
         User window - %1 - %2
         
     
     
-        
+        
         N:%1 S:%2
         The first argument 'N' represents the 'N'etwork latency; the second 'S' the 'S'ystem (processing) time
         
     
     
-        
+        
         <no GA> S:%1
         The argument 'S' represents the 'S'ystem (processing) time, in this situation the Game Server is not sending "GoAhead" signals so we cannot deduce the network latency...
         
     
     
-        
+        
         Pre-Map loading(1) report
         
     
     
-        
+        
         Loading map(1) at %1 report
         
     
     
-        
+        
         Loading map(1) "%1" at %2 report
         
     
     
-        
+        
         Pre-Map importing(1) report
         
     
     
-        
+        
         [ ERROR ]  - Map file not found, path and name used was:
 %1.
         
     
     
-        
+        
         loadMap: bad argument #1 value (filename used: 
 "%1" was not found).
         
     
     
-        
+        
         [ INFO ]  - Map file located and opened, now parsing it...
         
     
     
-        
+        
         Importing map(1) "%1" at %2 report
         
     
     
-        
+        
         [ INFO ]  - Map file located but it could not opened, please check permissions on:"%1".
         
     
     
-        
+        
         loadMap: bad argument #1 value (filename used: 
 "%1" could not be opened for reading).
         
     
     
-        
+        
         [ INFO ]  - Map reload request received from system...
         
     
     
-        
+        
         [  OK  ]  - ... System Map reload request completed.
         
     
     
-        
+        
         [ WARN ]  - ... System Map reload request failed.
         
     
     
-        
+        
         +--------------------------------------------------------------+
 |                      system statistics                       |
 +--------------------------------------------------------------+
@@ -3972,110 +3972,110 @@ Tried these locations:
         
     
     
-        
+        
         GMCP events:
         Heading for the system's statistics information displayed in the console
         
     
     
-        
+        
         ATCP events:
         Heading for the system's statistics information displayed in the console
         
     
     
-        
+        
         Channel102 events:
         Heading for the system's statistics information displayed in the console
         
     
     
-        
+        
         MXP events:
         Heading for the system's statistics information displayed in the console
         
     
     
-        
+        
         MSSP events:
         Heading for the system's statistics information displayed in the console
         
     
     
-        
+        
         MSDP events:
         Heading for the system's statistics information displayed in the console
         
     
     
-        
+        
         Telnet Options:
         Heading for the system's statistics information displayed in the console
         
     
     
-        
+        
         Trigger Report:
         Heading for the system's statistics information displayed in the console
         
     
     
-        
+        
         Timer Report:
         Heading for the system's statistics information displayed in the console
         
     
     
-        
+        
         Alias Report:
         Heading for the system's statistics information displayed in the console
         
     
     
-        
+        
         Keybinding Report:
         Heading for the system's statistics information displayed in the console
         
     
     
-        
+        
         Script Report:
         Heading for the system's statistics information displayed in the console
         
     
     
-        
+        
         Gif Report:
         Heading for the system's statistics information displayed in the console
         
     
     
-        
+        
         Save profile?
         
     
     
-        
+        
         Do you want to save the profile %1?
         
     
     
-        
+        
         Could not save profile
         
     
     
-        
+        
         Sorry, could not save your profile as "%1" - got the following error: "%2".
         
     
     
-        
+        
         Could not save map
         
     
     
-        
+        
         Sorry, could not save the map. Would you like to retry or close without saving the map?
         
     
@@ -4083,118 +4083,118 @@ Tried these locations:
 
     TMap
     
-        
+        
         [ INFO ] - CONVERTING: old style label, areaID:%1 labelID:%2.
         
     
     
-        
+        
         [ INFO ] - Converting old style label id: %1.
         
     
     
-        
+        
         [ WARN ] - CONVERTING: cannot convert old style label in area with id: %1,  label id is: %2.
         
     
     
-        
+        
         [ WARN ] - CONVERTING: cannot convert old style label with id: %1.
         
     
     
-        
+        
         [  OK  ]  - Auditing of map completed (%1s). Enjoy your game...
         
     
     
-        
+        
         Default Area
         
     
     
-        
+        
         Unnamed Area
         
     
     
-        
+        
         [ INFO ]  - Map audit starting...
         
     
     
-        
+        
         [ INFO ]  - You might wish to donate THIS map file to the Mudlet Museum!
 There is so much data that it DOES NOT have that you could be
 better off starting again...
         
     
     
-        
+        
         [ ALERT ] - Failed to load a Mudlet JSON Map file, reason:
 %1; the file is:
 "%2".
         
     
     
-        
+        
         [ INFO ]  - Ignoring this map file.
         
     
     
-        
+        
         [ INFO ]  - Default (reset) area (for rooms that have not been assigned to an
 area) not found, adding reserved -1 id.
         
     
     
-        
+        
         [ INFO ]  - Successfully read the map file (%1s), checking some
 consistency details...
         
     
     
-        
+        
         Map issues
         
     
     
-        
+        
         Area issues
         
     
     
-        
+        
         Area id: %1 "%2"
         
     
     
-        
+        
         Area id: %1
         
     
     
-        
+        
         Room issues
         
     
     
-        
+        
         Room id: %1 "%2"
         
     
     
-        
+        
         Room id: %1
         
     
     
-        
+        
         End of report
         
     
     
-        
+        
         [ ALERT ] - At least one thing was detected during that last map operation
 that it is recommended that you review the most recent report in
 the file:
@@ -4204,7 +4204,7 @@ the file:
         
     
     
-        
+        
         [ INFO ]  - The equivalent to the above information about that last map
 operation has been saved for review as the most recent report in
 the file:
@@ -4214,21 +4214,21 @@ the file:
         
     
     
-        
+        
         [ WARN ]  - Attempt made to download an XML map when one has already been
 requested or is being imported from a local file - wait for that
 operation to complete (if it cannot be canceled) before retrying!
         
     
     
-        
+        
         [ WARN ]  - Attempt made to download an XML from an invalid URL.  The URL was:
 %1
 and the error message (may contain technical details) was:"%2".
         
     
     
-        
+        
         [ ERROR ] - Unable to use or create directory to store map.
 Please check that you have permissions/access to:
 "%1"
@@ -4236,257 +4236,257 @@ and there is enough space. The download operation has failed.
         
     
     
-        
+        
         [ INFO ]  - Map download initiated, please wait...
         
     
     
-        
+        
         [ ERROR ] - Map download encountered an error:
 %1
         
     
     
-        
+        
         [ ALERT ] - Map download failed, unable to save destination file:
 %1
 reason: %2
         
     
     
-        
+        
         Map JSON export
         This is a title of a progress window.
         
     
     
-        
+        
         Map JSON import
         This is a title of a progress window.
         
     
     
-        
-        
+        
+        
         Exporting JSON map data from %1
 Areas: %2 of: %3   Rooms: %4 of: %5   Labels: %6 of: %7...
         
     
     
-        
+        
         Exporting JSON map file from %1 - writing data to file:
 %2 ...
         
     
     
-        
+        
         import or export already in progress
         
     
     
-        
+        
         could not open file
         
     
     
-        
+        
         could not parse file, reason: "%1" at offset %2
         
     
     
-        
+        
         empty Json file, no map data detected
         
     
     
-        
+        
         invalid format version "%1" detected
         
     
     
-        
+        
         no format version detected
         
     
     
-        
+        
         no areas detected
         
     
     
-        
+        
         aborted by user
         
     
     
-        
-        
+        
+        
         Importing JSON map data to %1
 Areas: %2 of: %3   Rooms: %4 of: %5   Labels: %6 of: %7...
         
     
     
-        
+        
         [MAP ERROR:] %1
         Used to print a map error in the Errors console in the Editor, %1 is the message text and a line-feed is also appended.
         
     
     
-        
+        
         Can not set room with RoomID %1 to AreaID %2. Room does not exist!
         
     
     
-        
+        
         Can not set room with RoomID %1 to AreaID %2. Area does not exist!
         
     
     
-        
+        
         [ ERROR ] - The format version "%1" you are trying to save the map with is too new
 for this version of Mudlet. Supported are only formats up to version %2.
         
     
     
-        
+        
         [ ALERT ] - Saving map in format version "%1" that is different than "%2" which
 it was loaded as. This may be an issue if you want to share the resulting
 map with others relying on the original format.
         
     
     
-        
+        
         [ WARN ]  - Saving map in format version "%1" different from the
 recommended map version %2 for this version of Mudlet.
         
     
     
-        
-        
+        
+        
         [ ERROR ] - Unable to open map file for reading: "%1"!
         
     
     
-        
+        
         [ ALERT ] - File does not seem to be a Mudlet Map file. The part that indicates
 its format version seems to be "%1" and that doesn't make sense. The file is:
 "%2".
         
     
     
-        
+        
         [ ALERT ] - Map file is too new. Its format version "%1" is higher than this version of
 Mudlet can handle (%2)! The file is:
 "%3".
         
     
     
-        
+        
         [ INFO ]  - You will need to update your Mudlet to read the map file.
         
     
     
-        
+        
         [ ALERT ] - Map file is really old. Its format version "%1" is so ancient that
 this version of Mudlet may not gain enough information from
 it but it will try! The file is: "%2".
         
     
     
-        
+        
         [ INFO ]  - Reading map. Format version: %1. File:
 "%2",
 please wait...
         
     
     
-        
+        
         [ INFO ]  - Reading map. Format version: %1. File: "%2".
         
     
     
-        
+        
         [ INFO ]  - Checking map file "%1", format version "%2".
         
     
     
-        
+        
         Downloading map file for use in %1...
         %1 is the name of the current Mudlet profile
         
     
     
-        
-        
-        
+        
+        
+        
         Abort
         
     
     
-        
+        
         [ INFO ]  - Ignoring this unlikely map file.
         
     
     
-        
+        
         Map download
         This is a title of a progress window.
         
     
     
-        
+        
         loadMap: unable to perform request, a map is already being downloaded or
 imported at user request.
         
     
     
-        
+        
         Importing XML map file for use in %1...
         
     
     
-        
+        
         Map import
         This is a title of a progress window.
         
     
     
-        
-        
+        
+        
         loadMap: failure to import XML map file, further information may be available
 in main console!
         
     
     
-        
+        
         [ ALERT ] - Map download was canceled, on user's request.
         
     
     
-        
+        
         [ ALERT ] - Map download failed, unable to open destination file:
 %1.
         
     
     
-        
+        
         [ ALERT ] - Map download failed, unable to write destination file:
 %1.
         
     
     
-        
+        
         [ INFO ]  - ... map downloaded and stored, now parsing it...
         
     
     
-        
+        
         [ ERROR ] - Map download problem, failure in parsing destination file:
 %1.
         
     
     
-        
+        
         [ ERROR ] - Map download problem, unable to read destination file:
 %1.
         
@@ -4525,58 +4525,58 @@ in main console!
 
     TMedia
     
-        
+        
         fades
         This word is part of a sentence like "Music fades" when the music is about to stop.
         
     
     
-        
+        
         Too many stopped media players. Purging stopped players.
         
     
     
-        
+        
         Too many stopped media players. Removed oldest active player.
         
     
     
-        
+        
         Maximum allowed active media players reached for media type. Cannot play additional media.
         
     
     
-        
+        
         stops
         This word is part of a sentence like "Music stops" when the music is about to stop.
         
     
     
-        
+        
         plays
         This word is part of a sentence like "Music plays" when the music is starting to play.
         
     
     
-        
+        
         pauses
         This word is part of a sentence like "Music pauses" when the music stops playing for a while.
         
     
     
-        
+        
         music
         This word is part of a sentence like "Music stops" when Mudlet handles a piece of music.
         
     
     
-        
+        
         video
         This word is part of a sentence like "Video stops" when Mudlet handles a video.
         
     
     
-        
+        
         sound
         
     
@@ -5090,499 +5090,499 @@ area) not found, adding "%1" against the reserved -1 id.
 
     TTextEdit
     
-        
+        
         Copy
         
     
     
-        
+        
         Copy HTML
         
     
     
-        
+        
         Copy as image
         
     
     
-        
+        
         Select all
         
     
     
-        
+        
         Unknown
         
     
     
-        
+        
         Search on %1
         
     
     
-        
+        
         Analyse characters
         
     
     
-        
+        
         Hover on this item to display the Unicode codepoints in the selection <i>(only the first line!)</i>
         
     
     
-        
+        
         restore Main menu
         
     
     
-        
+        
         Use this to restore the Main menu to get access to controls.
         
     
     
-        
+        
         restore Main Toolbar
         
     
     
-        
+        
         Use this to restore the Main Toolbar to get access to controls.
         
     
     
-        
+        
         Clear console
         
     
     
-        
+        
         *** starting new session ***
         
     
     
-        
+        
         {tab}
         Unicode U+0009 codepoint.
         
     
     
-        
+        
         {line-feed}
         Unicode U+000A codepoint. Not likely to be seen as it gets filtered out.
         
     
     
-        
+        
         {carriage-return}
         Unicode U+000D codepoint. Not likely to be seen as it gets filtered out.
         
     
     
-        
+        
         {space}
         Unicode U+0020 codepoint.
         
     
     
-        
+        
         {non-breaking space}
         Unicode U+00A0 codepoint.
         
     
     
-        
+        
         {soft hyphen}
         Unicode U+00AD codepoint.
         
     
     
-        
+        
         {combining grapheme joiner}
         Unicode U+034F codepoint (badly named apparently - see Wikipedia!)
         
     
     
-        
+        
         {ogham space mark}
         Unicode U+1680 codepoint.
         
     
     
-        
+        
         {'n' quad}
         Unicode U+2000 codepoint.
         
     
     
-        
+        
         {'m' quad}
         Unicode U+2001 codepoint.
         
     
     
-        
+        
         {'n' space}
         Unicode U+2002 codepoint - En ('n') wide space.
         
     
     
-        
+        
         {'m' space}
         Unicode U+2003 codepoint - Em ('m') wide space.
         
     
     
-        
+        
         {3-per-em space}
         Unicode U+2004 codepoint - three-per-em ('m') wide (thick) space.
         
     
     
-        
+        
         {4-per-em space}
         Unicode U+2005 codepoint - four-per-em ('m') wide (Middle) space.
         
     
     
-        
+        
         {6-per-em space}
         Unicode U+2006 codepoint - six-per-em ('m') wide (Sometimes the same as a Thin) space.
         
     
     
-        
+        
         {digit space}
         Unicode U+2007 codepoint - figure (digit) wide space.
         
     
     
-        
+        
         {punctuation wide space}
         Unicode U+2008 codepoint.
         
     
     
-        
+        
         {5-per-em space}
         Unicode U+2009 codepoint - five-per-em ('m') wide space.
         
     
     
-        
+        
         {hair width space}
         Unicode U+200A codepoint - thinnest space.
         
     
     
-        
+        
         {zero width space}
         Unicode U+200B codepoint.
         
     
     
-        
+        
         {Zero width non-joiner}
         Unicode U+200C codepoint.
         
     
     
-        
+        
         {zero width joiner}
         Unicode U+200D codepoint.
         
     
     
-        
+        
         {left-to-right mark}
         Unicode U+200E codepoint.
         
     
     
-        
+        
         {right-to-left mark}
         Unicode U+200F codepoint.
         
     
     
-        
+        
         {line separator}
         Unicode 0x2028 codepoint.
         
     
     
-        
+        
         {paragraph separator}
         Unicode U+2029 codepoint.
         
     
     
-        
+        
         {Left-to-right embedding}
         Unicode U+202A codepoint.
         
     
     
-        
+        
         {right-to-left embedding}
         Unicode U+202B codepoint.
         
     
     
-        
+        
         {pop directional formatting}
         Unicode U+202C codepoint - pop (undo last) directional formatting.
         
     
     
-        
+        
         {Left-to-right override}
         Unicode U+202D codepoint.
         
     
     
-        
+        
         {right-to-left override}
         Unicode U+202E codepoint.
         
     
     
-        
+        
         {narrow width no-break space}
         Unicode U+202F codepoint.
         
     
     
-        
+        
         {medium width mathematical space}
         Unicode U+205F codepoint.
         
     
     
-        
+        
         {zero width non-breaking space}
         Unicode U+2060 codepoint.
         
     
     
-        
+        
         {function application}
         Unicode U+2061 codepoint - function application (whatever that means!)
         
     
     
-        
+        
         {invisible times}
         Unicode U+2062 codepoint.
         
     
     
-        
+        
         {invisible separator}
         Unicode U+2063 codepoint - invisible separator or comma.
         
     
     
-        
+        
         {invisible plus}
         Unicode U+2064 codepoint.
         
     
     
-        
+        
         {left-to-right isolate}
         Unicode U+2066 codepoint.
         
     
     
-        
+        
         {right-to-left isolate}
         Unicode U+2067 codepoint.
         
     
     
-        
+        
         {first strong isolate}
         Unicode U+2068 codepoint.
         
     
     
-        
+        
         {pop directional isolate}
         Unicode U+2069 codepoint - pop (undo last) directional isolate.
         
     
     
-        
+        
         {inhibit symmetrical swapping}
         Unicode U+206A codepoint.
         
     
     
-        
+        
         {activate symmetrical swapping}
         Unicode U+206B codepoint.
         
     
     
-        
+        
         {inhibit arabic form-shaping}
         Unicode U+206C codepoint.
         
     
     
-        
+        
         {activate arabic form-shaping}
         Unicode U+206D codepoint.
         
     
     
-        
+        
         {national digit shapes}
         Unicode U+206E codepoint.
         
     
     
-        
+        
         {nominal Digit shapes}
         Unicode U+206F codepoint.
         
     
     
-        
+        
         {ideographic space}
         Unicode U+3000 codepoint - ideographic (CJK Wide) space
         
     
     
-        
+        
         {variation selector 1}
         Unicode U+FE00 codepoint.
         
     
     
-        
+        
         {variation selector 2}
         Unicode U+FE01 codepoint.
         
     
     
-        
+        
         {variation selector 3}
         Unicode U+FE02 codepoint.
         
     
     
-        
+        
         {variation selector 4}
         Unicode U+FE03 codepoint.
         
     
     
-        
+        
         {variation selector 5}
         Unicode U+FE04 codepoint.
         
     
     
-        
+        
         {variation selector 6}
         Unicode U+FE05 codepoint.
         
     
     
-        
+        
         {variation selector 7}
         Unicode U+FE06 codepoint.
         
     
     
-        
+        
         {variation selector 8}
         Unicode U+FE07 codepoint.
         
     
     
-        
+        
         {variation selector 9}
         Unicode U+FE08 codepoint.
         
     
     
-        
+        
         {variation selector 10}
         Unicode U+FE09 codepoint.
         
     
     
-        
+        
         {variation selector 11}
         Unicode U+FE0A codepoint.
         
     
     
-        
+        
         {variation selector 12}
         Unicode U+FE0B codepoint.
         
     
     
-        
+        
         {variation selector 13}
         Unicode U+FE0C codepoint.
         
     
     
-        
+        
         {variation selector 14}
         Unicode U+FE0D codepoint.
         
     
     
-        
+        
         {variation selector 15}
         Unicode U+FE0E codepoint - after an Emoji codepoint forces the textual (black & white) rendition.
         
     
     
-        
+        
         {variation selector 16}
         Unicode U+FE0F codepoint - after an Emoji codepoint forces the proper coloured 'Emoji' rendition.
         
     
     
-        
+        
         {zero width no-break space}
         Unicode U+FEFF codepoint - also known as the Byte-order-mark at start of text!).
         
     
     
-        
+        
         {interlinear annotation anchor}
         Unicode U+FFF9 codepoint.
         
     
     
-        
+        
         {interlinear annotation separator}
         Unicode U+FFFA codepoint.
         
     
     
-        
+        
         {interlinear annotation terminator}
         Unicode U+FFFB codepoint
         
     
     
-        
+        
         {object replacement character}
         Unicode U+FFFC codepoint.
         
     
     
-        
-        
-        
+        
+        
+        
         {noncharacter}
         Unicode codepoint in range U+FFD0 to U+FDEF - not a character
 ----------
@@ -5592,148 +5592,148 @@ Unicode codepoint is U+00xxFFFE or U+00xxFFFF - not a character.
         
     
     
-        
+        
         {FitzPatrick modifier 1 or 2}
         Unicode codepoint U+0001F3FB - FitzPatrick modifier (Emoji Human skin-tone) 1-2.
         
     
     
-        
+        
         {FitzPatrick modifier 3}
         Unicode codepoint U+0001F3FC - FitzPatrick modifier (Emoji Human skin-tone) 3.
         
     
     
-        
+        
         {FitzPatrick modifier 4}
         Unicode codepoint U+0001F3FD - FitzPatrick modifier (Emoji Human skin-tone) 4.
         
     
     
-        
+        
         {FitzPatrick modifier 5}
         Unicode codepoint U+0001F3FE - FitzPatrick modifier (Emoji Human skin-tone) 5.
         
     
     
-        
+        
         {FitzPatrick modifier 6}
         Unicode codepoint U+0001F3FF - FitzPatrick modifier (Emoji Human skin-tone) 6.
         
     
     
-        
-        
+        
+        
         Index (UTF-16)
         1st Row heading for Text analyser output, table item is the count into the QChars/TChars that make up the text {this translation used 2 times}
         
     
     
-        
-        
+        
+        
         U+<i>####</i> Unicode Code-point <i>(High:Low Surrogates)</i>
         2nd Row heading for Text analyser output, table item is the unicode code point (will be between 000001 and 10FFFF in hexadecimal) {this translation used 2 times}
         
     
     
-        
-        
+        
+        
         Visual
         3rd Row heading for Text analyser output, table item is a visual representation of the character/part of the character or a '{'...'}' wrapped letter code if the character is whitespace or otherwise unshowable {this translation used 2 times}
         
     
     
-        
-        
+        
+        
         Index (UTF-8)
         4th Row heading for Text analyser output, table item is the count into the bytes that make up the UTF-8 form of the text that the Lua system uses {this translation used 2 times}
         
     
     
-        
-        
+        
+        
         Byte
         5th Row heading for Text analyser output, table item is the unsigned 8-bit integer for the particular byte in the UTF-8 form of the text that the Lua system uses {this translation used 2 times}
         
     
     
-        
-        
+        
+        
         Lua character or code
         6th Row heading for Text analyser output, table item is either the ASCII character or the numeric code for the byte in the row about this item in the table, as displayed the thing shown can be used in a Lua string entry to reproduce this byte {this translation used 2 times}"
         
     
     
-        
+        
         link
         Generic screen-reader announcement for a link with no tooltip or URL — used as fallback link description
         
     
     
-        
+        
         , visited
         Appended to link announcement when the link has been previously visited
         
     
     
-        
+        
         , disabled
         Appended to link announcement when the link is disabled
         
     
     
-        
+        
         , selected
         Appended to link announcement when the link is selected
         
     
     
-        
+        
         , has menu
         Appended to link announcement when the link opens a menu
         
     
     
-        
+        
         Wrapping to first link
         Screen-reader announcement when forward link navigation (Tab / Ctrl+]) wraps past the last link back to the first
         
     
     
-        
+        
         Wrapping to last link
         Screen-reader announcement when backward link navigation (Shift+Tab / Ctrl+[) wraps past the first link back to the last
         
     
     
-        
+        
         Jumped to start of buffer.
         Screen-reader announcement when the user presses Ctrl+Home in caret mode to jump to the start of the buffer
         
     
     
-        
+        
         Jumped to latest content.
         Screen-reader announcement when the user presses Ctrl+End in caret mode to jump to the latest (most recent) content in the buffer
         
     
     
-        
+        
         Mudlet, debug console extract
         
     
     
-        
+        
         Mudlet, %1 mini-console extract from %2 profile
         
     
     
-        
+        
         Mudlet, %1 user window extract from %2 profile
         
     
     
-        
+        
         Mudlet, main console extract from %1 profile
         
     
@@ -5741,7 +5741,7 @@ Unicode codepoint is U+00xxFFFE or U+00xxFFFF - not a character.
 
     TToolBar
     
-        
+        
         Toolbar - %1 - %2
         
     
@@ -5769,12 +5769,12 @@ Unicode codepoint is U+00xxFFFE or U+00xxFFFF - not a character.
         
     
     
-        
+        
         Trigger name=%1 expired.
         
     
     
-        
+        
         Trigger name=%1 will fire %n more time(s).
         
             
@@ -6026,8 +6026,8 @@ Label for the update button shown in the update dialog
         
     
     
-        
-        
+        
+        
         Update Error
         Error title for update-related warning dialogs
 ----------
@@ -6035,20 +6035,20 @@ Error title for dialog shown when Mudlet fails to restart after updating
     
     
-        
+        
         The update installer could not be found. Please try checking for updates again.
         Error shown when the downloaded installer file cannot be found on disk
         
     
     
-        
+        
         Could not prepare the update installer. Please try again or download the update manually from https://www.mudlet.org/download/
         Error shown when the installer file cannot be copied to a temporary location for launch
         
     
     
-        
-        
+        
+        
         Could not prepare the update. Please close Mudlet and run the installer manually:
 %1
         Error shown when the batch file for managing the update process cannot be written. %1 is the path to the installer.
@@ -6057,25 +6057,25 @@ Error shown when the batch file for managing the update process cannot be create
         
     
     
-        
+        
         Could not launch the update installer. Please restart Mudlet and try again.
         Error shown when the update installer process fails to start
         
     
     
-        
+        
         Could not restart Mudlet after the update. Please start it manually.
         Error message shown when Mudlet fails to restart after updating on Linux
         
     
     
-        
+        
         Restart to apply update
         Label for the button shown after the update has been downloaded and installed, prompting user to restart
         
     
     
-        
+        
         Update failed
         Label for the update button shown when the update installation failed
         
@@ -6341,26 +6341,26 @@ and this one cannot read it, you need a newer Mudlet!
 
     cTelnet
     
-        
+        
         hh:mm:ss.zzz
         
     
     
-        
-        
+        
+        
         User Disconnected
         A reason why a connection to a game server ended, could be one of several to be listed. This text used in two places, ensure the same text is used in both.
         
     
     
-        
-        
+        
+        
         Connection/login attempt rejected by server
         A reason why a connection to a game server ended, could be one of several to be listed. This text used in two places, ensure the same text is used in both.
         
     
     
-        
+        
         [ ERROR ] - Internal error, no codec found for current setting of {"%1"}
 so Mudlet cannot send data in that format to the Game Server. Please
 check to see if there is an alternative that the MUD and Mudlet can
@@ -6371,95 +6371,95 @@ changed.
         
     
     
-        
+        
         [ INFO ]  - Package download cancelled.
         
     
     
-        
+        
         [ WARN ]  - Package download failed from '%1', reason: %2
         %1 is the URL, %2 is the error message
         
     
     
-        
+        
         
 The package is hosted on a server with an SSL certificate problem. The URL may be using HTTPS when it should use HTTP, or the server's security certificate is not trusted by your system.
         
     
     
-        
+        
         [ WARN ]  - Package download failed: could not open file '%1' for writing, reason: %2
         %1 is the file path, %2 is the error message
         
     
     
-        
+        
         [ WARN ]  - Package download failed: could not save file, reason: %1
         %1 is the error message
         
     
     
-        
+        
         [ WARN ]  - Package installation failed for '%1', reason: %2
         %1 is the package file path, %2 is the error message
         
     
     
-        
+        
         [ INFO ]  - This game appears to use KaVir's protocol handler, which works best when Mudlet reports its version number during connection. Version reporting in terminal type has been automatically enabled for improved color support. Reconnecting...
         
     
     
-        
-        
+        
+        
         [%1]
         For an IPv6 address (which is composed of hex-digits and colons) if we want to show it with a port number appended (as a colon and then an integer between 1 and 65535) we need to wrap it with '['...']' to separate the latter from the former, however some Far-East locales may expect to use the wide versions of these character here.
         
     
     
-        
+        
         Looking up the details of server: %1:%2 ...
         %1 is the URL or an IP address (suitably wrapped if it is an IPv6 one) of the Game Server (or Proxy); %2 is the port number.
         
     
     
-        
+        
         [  OK  ]  - Secure connection made (IPv6).
         
     
     
-        
+        
         [  OK  ]  - Secure connection made (IPv4).
         
     
     
-        
+        
         [  OK  ]  - Open connection made (IPv6).
         
     
     
-        
+        
         [  OK  ]  - Open connection made (IPv4).
         
     
     
-        
+        
         [  OK  ]  - Connection made (IPv6).
         
     
     
-        
+        
         [  OK  ]  - Connection made (IPv4).
         
     
     
-        
+        
         [ INFO ]  - Connection time: %1.
         
     
     
-        
+        
         [ ALERT ] - Socket got disconnected, for %n reason(s):
 %1
         This message is used when we have been trying to connect or we were connected securely, but the connection has been lost. It is possible with a secure connection that there is MORE than one error message to show, but for English or other locales where the singular case (%n==1) is distinct it would be perfectly feasible to replace "for %n reason(s)" with "because" for that number (1) of errors - however the text should then be repeated in the corresponding situation for an "open" connection which is different in that it only ever has one "reason" to report.
@@ -6468,27 +6468,27 @@ The package is hosted on a server with an SSL certificate problem. The URL may b
         
     
     
-        
-        
+        
+        
         [ ALERT ] - Socket got disconnected.
         This message is used when we have been trying to connect or we were connected securely or in an open manner, but the connection has been lost and we do not have any explaination to give to the user as to why. Anyhow, in this case we do not have anything more to say about it. This text used in two places, ensure the same translation is used in both of them.
         
     
     
-        
+        
         Secure connections not supported by this game on this port; try turning the option off
         A reason why a connection to a game server ended.
         
     
     
-        
+        
         [ ALERT ] - Socket got disconnected, for reason:
 %1
         This message is used when we have been trying to connect or we were connected in an open, insecure manner, but the connection has been lost. Unlike the secure connection case there is only one error message to show; it would be desirable to use the same text for this message as the "one reason" (%n==1) situation for locales such as English (with a distinct form for the singular) use for the secure type of connection.
         
     
     
-        
+        
         Host name lookup Failure! A connection cannot be established.
 The server name is not correct, or your nameservers are not
 working properly.
@@ -6497,32 +6497,32 @@ working properly.
         
     
     
-        
+        
         [ ERROR ] - Unable to connect to "%1".
 Check your internet connection and the details entered for the game server.
         %1 is the URL of the Game Server
         
     
     
-        
+        
         %1 (IPv6)
         Used to add an IPv6 address line to the list displayed during connecting to a Host. Some, e.g. Far Eastern locales may require a different text here if they do not use spaces, or need "wide" '(' ')'s
         
     
     
-        
+        
         %1 (IPv4)
         Used to add an IPv4 address line to the list displayed during connecting to a Host. Some, e.g. Far Eastern locales may require a different text here if they do not use spaces, or "wide" '('...')'
         
     
     
-        
+        
         A host name could not be found for the given IP address.
         This text is used when the user has provided a raw IP address for the Game Server rather than a URL. In this case we try to perform a "reverse-lookup" to see if we can identify the URL that matches it - but nothing useful was found and we've got the original address back.
         
     
     
-        
+        
         A host name for the IP address has been found.
 It is: "%1"
 
@@ -6530,7 +6530,7 @@ It is: "%1"
         
     
     
-        
+        
         The %n IP address(es) of %1 has/have been found. It/They are:
         This text is used in the (expected) case when the user has provided a URL (%1) for the Game Server rather than (unusually) an IP address. After a DNS lookup we have found at least one but possibly more (%n) IP addresses, which will be listed (one per line) immediately afterwards.
         
@@ -6538,15 +6538,15 @@ It is: "%1"
         
     
     
-        
+        
         Trying secure (IPv4 and IPv6) connections to proxy %1:%2 ...
         Happy-Eyeballs (both IPv4 and IPv6 addresses available) case. %1 is the URL for the server and %2 is the port number (on BOTH addresses) for the connection.
         
     
     
-        
-        
-        
+        
+        
+        
         [ INFO ]  - Attempting a secure connection to %1:%2 via proxy...
         We don't need to worry about %1 being a raw IPv6 address here as we prohibit IP addresses for secure connections so it is a URL; %2 is the port number.
 ----------
@@ -6554,8 +6554,8 @@ It is: "%1"
         
     
     
-        
-        
+        
+        
         Trying secure (IPv4 and IPv6) connections to %1:%2 ...
         Happy-Eyeballs (both IPv4 and IPv6 addresses available) case. %1 is the URL for the Server and %2 is the port number (on BOTH addresses) for the connection.
 ----------
@@ -6563,9 +6563,9 @@ It is: "%1"
         
     
     
-        
-        
-        
+        
+        
+        
         [ INFO ]  - Attempting a secure connection to %1:%2 ...
         We don't need to worry about %1 being a raw IPv6 address here as we prohibit IP addresses for secure connections so it is a URL; %2 is the port number.
 ----------
@@ -6573,33 +6573,33 @@ It is: "%1"
         
     
     
-        
+        
         Trying secure (IPv6) connection to %1:%2 via proxy...
         %1 is the URL for the Server and %2 is the port number for the connection.
         
     
     
-        
+        
         Trying secure (IPv4) connection to %1:%2 via proxy...
         %1 is the URL for the Server and %2 is the port number for the connection.
         
     
     
-        
+        
         Trying secure (IPv4) connection to %1:%2 ...
         %1 is the URL for the Server and %2 is the port number for the connection.
         
     
     
-        
+        
         Trying open (IPv4 and IPv6) connections to %1:%2 via proxy...
         Happy-Eyeballs (both IPv4 and IPv6 addresses available) case. %1 is the URL for the proxy and %2 is the port number (on BOTH addresses) for the connection.
         
     
     
-        
-        
-        
+        
+        
+        
         [ INFO ]  - Attempting an open connection to %1:%2 via proxy...
         %1 is a URL for the Game Server; %2 is the port number.
 ----------
@@ -6609,15 +6609,15 @@ It is: "%1"
         
     
     
-        
+        
         Trying open (IPv4 and IPv6) connections to %1:%2 ...
         Happy-Eyeballs (both IPv4 and IPv6 addresses available) case. %1 is the URL for the Server and %2 is the port number (on BOTH addresses) for the connection.
         
     
     
-        
-        
-        
+        
+        
+        
         [ INFO ]  - Attempting an open connection to %1:%2 ...
         %1 is a URL for the Game Server; %2 is the port number.
 ----------
@@ -6627,203 +6627,203 @@ It is: "%1"
         
     
     
-        
+        
         Trying open (IPv6) connection to %1:%2 via proxy...
         %1 is the URL or IPv6 address (suitably wrapped) for the Game Server and %2 is the port number for the connection.
         
     
     
-        
+        
         Trying open (IPv6) connection to %1:%2 ...
         %1 is the URL or IPv6 address (suitably wrapped) for the Game Server and %2 is the port number for the connection.
         
     
     
-        
+        
         Trying open (IPv4) connection to %1:%2 via proxy...
         %1 is the URL or IPv4 address for the Game Server and %2 is the port number for the connection.
         
     
     
-        
+        
         Trying open (IPv4) connection to %1:%2 ...
         %1 is the URL or IPv4 address for the Game Server and %2 is the port number for the connection.
         
     
     
-        
+        
         [ INFO ]  - This game appears to support MXP (Mud eXtension Protocol), but has not turned it on properly. MXP processing has been automatically enabled for clickable links, room info, and richer interactions. You can disable this setting in Settings > Special Options.
         
     
     
-        
-        
+        
+        
         [ INFO ]  - Upgrading the GUI to new version '%1' from version '%2'
 (url='%3').
         
     
     
-        
+        
         [ INFO ]  - Downloading and installing package '%1'
 (url='%2').
         
     
     
-        
+        
         Cancel
         
     
     
-        
+        
         Downloading game GUI from server...
         
     
     
-        
+        
         [ INFO ]  - A more secure connection on port %1 is available.
         
     
     
-        
+        
         For data transfer protection and privacy, this connection advertises a secure port.
         
     
     
-        
+        
         Update to port %1 and connect with encryption?
         
     
     
-        
+        
         ERROR
         Keep the capitalisation, the translated text at 7 letters max so it aligns nicely
         
     
     
-        
+        
         LUA
         
     
     
-        
+        
         WARN
         
     
     
-        
+        
         ALERT
         
     
     
-        
+        
         INFO
         
     
     
-        
+        
         OK
         
     
     
-        
+        
         CHAT
         
     
     
-        
+        
         [ WARN  ]  - MCCP decompression error (%1), compression disabled.
 If the display looks garbled, please reconnect to the game.
         %1 is the decompression error description. Shown when the server sends a corrupt MCCP (compressed) data stream.
         
     
     
-        
+        
         [ INFO ]  - Loading replay file:
 "%1".
         
     
     
-        
+        
         Cannot replay file "%1", error message was: "replay file seems to be corrupt".
         
     
     
-        
+        
         [ WARN ]  - The replay has been aborted as the file seems to be corrupt.
         
     
     
-        
+        
         Cannot perform replay, another one may already be in progress. Try again when it has finished.
         
     
     
-        
+        
         [ WARN ]  - Cannot perform replay, another one may already be in progress.
 Try again when it has finished.
         
     
     
-        
+        
         Cannot read file "%1", error message was: "%2".
         
     
     
-        
+        
         [ ERROR ] - Cannot read file "%1",
 error message was: "%2".
         
     
     
-        
+        
         [  OK  ]  - The replay has ended.
         
     
     
-        
+        
         [ WARN  ]  - Too much data to process at once, some may have been lost.
         Shown when too much data expands out of one compressed read (e.g. a decompression bomb) to process safely.
         
     
     
-        
+        
         server %1
         Telnet options report: server side of an option, %1 is "enabled" or "disabled"
         
     
     
-        
-        
+        
+        
         enabled
         
     
     
-        
-        
+        
+        
         disabled
         
     
     
-        
+        
         client %1
         Telnet options report: client side of an option, %1 is "enabled" or "disabled"
         
     
     
-        
+        
           %1: %2
         Telnet option line: %1 is the option name (e.g. "NAWS (31)"), %2 is one or both sides
         
     
     
-        
+        
           (none negotiated yet)
 
         Shown in the Telnet options statistics report when no options have been negotiated yet
         
     
     
-        
+        
         [ WARN ]  - This game appears to use character-at-a-time mode, which Mudlet does not support. Input may not work as expected. Consider using keybindings for immediate key response instead.
         Warning shown when server uses character-at-a-time mode which Mudlet doesn't support
         
@@ -6942,199 +6942,199 @@ error message was: "%2".
         
     
     
-        
+        
         profiles list
         
     
     
-        
+        
         Remove
         
     
     
-        
+        
         Copy
         
     
     
-        
+        
         New
         
     
     
-        
+        
         welcome message
         
     
     
-        
+        
         Profile name:
         
     
     
-        
+        
         Profile name
         
     
     
-        
+        
         A unique name for the profile but which is limited to a subset of ascii characters only.
         Using lower case letters for 'ASCII' may make speech synthesisers say 'askey' which is quicker than 'Aay Ess Cee Eye Eye'!
         
     
     
-        
+        
         Server address:
         
     
     
-        
+        
         Game server URL
         
     
     
-        
+        
         The Internet host name or IP address
         
     
     
-        
+        
         Port:
         
     
     
-        
+        
         Game server port
         
     
     
-        
+        
         Connect to
         
     
     
-        
+        
         The port that is used together with the server name to make the connection to the game server. If not specified a default of 23 for "Telnet" connections is used. Secure connections may require a different port number.
         
     
     
-        
+        
         Connect via a secure protocol
         
     
     
-        
+        
         Make Mudlet use a secure SSL/TLS protocol instead of an unencrypted one
         
     
     
-        
+        
         Secure:
         
     
     
-        
+        
         Options
         
     
     
-        
+        
         Profile history:
         
     
     
-        
+        
         load newest profile
         
     
     
-        
+        
         load oldest profile
         
     
     
-        
+        
         Character name:
         
     
     
-        
+        
         The characters name
         
     
     
-        
+        
         Character name
         
     
     
-        
+        
         If provided will be sent, along with password to identify the user in the game.
         
     
     
-        
+        
         Auto-open profile
         
     
     
-        
+        
         Automatically start this profile when Mudlet is run
         
     
     
-        
+        
         Auto-reconnect
         
     
     
-        
+        
         Automatically reconnect this profile if it should become disconnected for any reason other than the user disconnecting from the game server.
         
     
     
-        
+        
         Password
         
     
     
-        
+        
         If provided will be sent, along with the character name to identify the user in the game.
         
     
     
-        
+        
         Information
         
     
     
-        
-        
+        
+        
         Game description or your notes
         
     
     
-        
+        
         Password:
         
     
     
-        
+        
         Characters password. Note that the password isn't encrypted in storage
         
     
     
-        
+        
         With this enabled, Mudlet will automatically start and connect on this profile when it is launched
         
     
     
-        
+        
         Open profile on Mudlet start
         
     
     
-        
+        
         Reconnect automatically
         
     
@@ -7452,32 +7452,32 @@ Error shown when the update server response cannot be understood
 
     dblsqd::UpdateDialog
     
-        
+        
         Could not open the downloaded update. You can try opening it manually:
 %1
         Error shown when the downloaded update file cannot be opened for installation. %1 is the file path.
         
     
     
-        
+        
         Could not check for updates
         Label shown in the update dialog when the update check fails due to a network or server error
         
     
     
-        
+        
         Download failed. Please try again.
         Error shown when the download finished but no file was saved
         
     
     
-        
+        
         Download Error
         Title for the download error warning dialog
         
     
     
-        
+        
         There was an error while downloading the update.
         Message shown in the download error warning dialog, followed by the specific error details
         
@@ -7547,145 +7547,145 @@ Count
 
     directions
     
-        
+        
         north
         Entering this direction will move the player in the game
         
     
     
-        
+        
         n
         Entering this direction will move the player in the game
         
     
     
-        
+        
         east
         Entering this direction will move the player in the game
         
     
     
-        
+        
         e
         Entering this direction will move the player in the game
         
     
     
-        
+        
         south
         Entering this direction will move the player in the game
         
     
     
-        
+        
         s
         Entering this direction will move the player in the game
         
     
     
-        
+        
         west
         Entering this direction will move the player in the game
         
     
     
-        
+        
         w
         Entering this direction will move the player in the game
         
     
     
-        
+        
         northeast
         Entering this direction will move the player in the game
         
     
     
-        
+        
         ne
         Entering this direction will move the player in the game
         
     
     
-        
+        
         southeast
         Entering this direction will move the player in the game
         
     
     
-        
+        
         se
         Entering this direction will move the player in the game
         
     
     
-        
+        
         southwest
         Entering this direction will move the player in the game
         
     
     
-        
+        
         sw
         Entering this direction will move the player in the game
         
     
     
-        
+        
         northwest
         Entering this direction will move the player in the game
         
     
     
-        
+        
         nw
         Entering this direction will move the player in the game
         
     
     
-        
+        
         in
         Entering this direction will move the player in the game
         
     
     
-        
+        
         i
         Entering this direction will move the player in the game
         
     
     
-        
+        
         out
         Entering this direction will move the player in the game
         
     
     
-        
+        
         o
         Entering this direction will move the player in the game
         
     
     
-        
+        
         up
         Entering this direction will move the player in the game
         
     
     
-        
+        
         u
         Entering this direction will move the player in the game
         
     
     
-        
+        
         down
         Entering this direction will move the player in the game
         
     
     
-        
+        
         d
         Entering this direction will move the player in the game
         
@@ -8252,197 +8252,213 @@ Count
 
     dlgConnectionProfiles
     
-        
+        
         Connect
         
     
     
-        
+        
         Characters password. Note that the password is not encrypted in storage
         
     
     
-        
+        
         Game name: %1
         
     
     
-        
+        
         Button to select a mud game to play, double-click it to connect and start playing it.
         Some text to speech engines will spell out initials like MUD so stick to lower case if that is a better option
         
     
     
-        
+        
         This profile is currently loaded - close it before changing the connection parameters.
         
     
     
-        
+        
         Reset icon
         Reset the custom picture for this profile in the connection dialog and show the default one instead
         
     
     
-        
+        
         Set custom icon
         Set a custom picture to show for the profile in the connection dialog
         
     
     
-        
+        
         Set custom color
         Set a custom color to show for the profile in the connection dialog
         
     
     
-        
-        Show my profiles only
-        Context menu action to toggle hiding default game profiles that have not been used yet
-        
-    
-    
-        
+        
         The %1 character is not permitted. Use one of the following:
         
     
     
-        
+        
         You have to enter a number. Other characters are not permitted.
         
     
     
-        
+        
         This profile name is already in use.
         
     
     
-        
+        
         Could not rename your profile data on the computer.
         
     
     
-        
+        
         Offline
         
     
     
-        
+        
         Skip - show me the games list
         Button shown on first launch to skip the tutorial and show the full games list
         
     
     
-        
+        
         <p><center><img src="tutorialIcon"/></center></p><p><center><big><b>Welcome to Mudlet!</b></big></center></p><p><center>Play a short guided adventure to learn<br>how to navigate in games, use triggers, aliases, and scripting.</center></p><p><center><a href="mudlet-tutorial">Start Tutorial</a></center></p><p align="right"><span style=" font-family:'Sans';">The Mudlet Team </span><img src=":/icons/mudlet_main_16px.png"/></p>
         Welcome message shown on first launch, focused on starting the tutorial.
         
     
     
-        
-        
+        
+        
         Copy
         
     
     
-        
+        
         Copy settings only
         
     
     
-        
+        
         copy profile
         
     
     
-        
+        
         copy the entire profile to new one that will require a different new name.
         
     
     
-        
+        
         copy profile settings
         
     
     
-        
+        
         copy the settings and some other parts of the profile to a new one that will require a different new name.
         
     
     
-        
+        
         Characters password, stored securely in the computer's credential manager
         
     
     
-        
+        
         Click to load but not connect the selected profile.
         
     
     
-        
+        
         Click to load and connect the selected profile.
         
     
     
-        
+        
         Need to have a valid profile name, game server address and port before this button can be enabled.
         
     
     
-        
-        
+        
+        
         Could not create the new profile folder on your computer.
         
     
     
-        
-        
+        
+        
         new profile name
         
     
     
-        
+        
+        My games
+        Tab showing only the games the user already has profiles for
+        
+    
+    
+        
+        All games
+        Tab showing every game Mudlet has a built-in profile for
+        
+    
+    
+        
+        games shown
+        
+    
+    
+        
+        Switch between showing only your own games and all of the games Mudlet knows about.
+        
+    
+    
+        
         Deleting '%1'
         
     
     
-        
+        
         A profile that is in use cannot be removed
         
     
     
-        
+        
         Select custom image for profile (should be 120x30)
         
     
     
-        
+        
         Images (%1)
         
     
     
-        
+        
         Copying...
         
     
     
-        
+        
         Port number must be above zero and below 65535.
         
     
     
-        
+        
         Mudlet can not load support for secure connections.
         
     
     
-        
+        
         Please enter the URL or IP address of the Game server.
         
     
     
-        
+        
         Please enter the URL of the Game server.
 
 <i>SSL/TLS connections require a URL, as an IP address is not a suitable identifier for the certification of the Game Server.</i>
@@ -8450,33 +8466,33 @@ Count
         
     
     
-        
+        
         Load profile without connecting.
         
     
     
-        
+        
         Please set a valid profile name, game server address and the game port before loading.
         
     
     
-        
+        
         Please set a valid profile name, game server address and the game port before connecting.
         
     
     
-        
+        
         Click to hide the password; it will also hide if another profile is selected.
         
     
     
-        
+        
         Click to reveal the password for this profile.
         
     
     
-        
-        
+        
+        
         Mudlet is not configured for secure connections.
         
     
@@ -8804,49 +8820,49 @@ reason: %2.
 
     dlgModuleManager
     
-        
+        
         Module Manager - %1
         
     
     
-        
+        
         Module Name
         
     
     
-        
+        
         Priority
         
     
     
-        
+        
         Sync
         
     
     
-        
+        
         Module Location
         
     
     
-        
+        
         Master module: saved and resynchronized across all sessions on Save Profile or session end.
         Tooltip for master module checkbox
         
     
     
-        
+        
         Load Mudlet Module
         Module manager - import modules from file dialog (multi-select enabled) Module manager - file filter for supported module types (mpackage, zip, xml)
         
     
     
-        
+        
         Mudlet Packages (*.mpackage *.zip *.xml)
         
     
     
-        
+        
         Failed to import: %1
         Module manager - status message shown when some modules failed to import. %1 is a comma-separated list of module names
         
@@ -8855,97 +8871,97 @@ reason: %2.
 
     dlgNotepad
     
-        
+        
         Prepend
         label for prepended text entry box in notepad
         
     
     
-        
+        
         Text to prepend to lines
         placeholder text for text entry box in notepad - text which gets added before sending a line
         
     
     
-        
+        
         Stop
         
     
     
-        
+        
         Add new note tab (Ctrl+T)
         
     
     
-        
+        
         Find
         Placeholder text for the search field in notepad
         
     
     
-        
+        
         Find previous
         
     
     
-        
+        
         Find next
         
     
     
-        
+        
         Close find bar
         
     
     
-        
+        
         New Note
         Default name for a new note tab
         
     
     
-        
+        
         Rename Note Tab
         Dialog title for renaming a note tab
         
     
     
-        
+        
         New name:
         Label for the input field when renaming a note tab
         
     
     
-        
+        
         New Tab
         Context menu action to create a new note tab
         
     
     
-        
+        
         Rename Tab
         Context menu action to rename a note tab
         
     
     
-        
+        
         Close Tab
         Context menu action to close a note tab
         
     
     
-        
+        
         Close Other Tabs
         Context menu action to close all note tabs except the clicked one
         
     
     
-        
-        
-        
-        
+        
+        
+        
         
-        
+        
+        
         Notes
         Name for the migrated notes tab when upgrading from single-note to tabbed notepad
 ----------
@@ -9073,28 +9089,39 @@ Further reading material. e.g. a link to the Mudlet wiki, forums, Github package
         Version
         
     
+    
+        
+        
+        Webpage where users can find help for this package. It is shown by the "Module Help" button in the Module Manager.
+        
+    
     
         
+        Help URL
+        
+    
+    
+        
         Required packages
         
     
     
-        
+        
         Does this package make use of other packages? List them here as requirements. Press 'Delete' to remove a package.
         
     
     
-        
+        
         Include assets (images, sounds, fonts)
         
     
     
-        
+        
         Drag and drop files and folders, or use the browse button below
         
     
     
-        
+        
         Select files to include in package
         
     
@@ -9104,134 +9131,134 @@ Further reading material. e.g. a link to the Mudlet wiki, forums, Github package
         
     
     
-        
+        
         Does this package make use of other packages? List them here as requirements.
         
     
     
-        
+        
         Select export location
         
     
     
-        
+        
         Triggers
         
     
     
-        
+        
         Aliases
         
     
     
-        
+        
         Timers
         
     
     
-        
+        
         Scripts
         
     
     
-        
+        
         Keys
         
     
     
-        
+        
         Buttons
         
     
     
-        
+        
         Export
         Text for button to perform the package export on the items the user has selected.
         
     
     
-        
+        
         Package Exporter - %1
         Title of the window. The %1 will be replaced by the current profile's name
         
     
     
-        
+        
         Create Module - %1
         
     
     
-        
+        
         Enter module name
         
     
     
-        
+        
         Create Module
         
     
     
-        
+        
         Select where to save module
         
     
     
-        
+        
         Select items to include in module
         
     
     
-        
+        
         Add module description, icon, and assets (optional)
         
     
     
-        
+        
         Module location
         
     
     
-        
+        
         Module description
         
     
     
-        
+        
         Brief description of your module
         
     
     
-        
+        
         Module author (recommended)
         
     
     
-        
+        
         Module version (recommended)
         
     
     
-        
+        
         Module dependencies
         
     
     
-        
+        
         Include module assets (images, sounds, fonts)
         
     
     
-        
+        
         Select files to include in module
         
     
     
-        
+        
         Select module dependencies
         
     
     
-        
+        
         (optional)
 
 This module description is shown in the Module Manager. The editor supports Commonmark markdown.
@@ -9257,109 +9284,73 @@ Further reading material, e.g., links to documentation or forum posts.
         
     
     
-        
+        
         Failed to open file "%1" to place into package. Error message was: "%2".
         This error message will appear when a file is to be placed into the package but the code cannot open it.
         
     
     
-        
+        
         Failed to add file "%1" to package. Error message was: "%3".
         This error message will appear when a file is to be placed into the package but cannot be done for some reason.
         
     
     
-        
+        
         package name
         package name will be added to other fields in the 'required fields missing: ...' tooltip when it's missing
         
     
     
-        
+        
         Required field missing: %1
         
     
     
-        
+        
         Export package
         
     
     
-        
+        
         Cannot create empty module. Please select at least one trigger, timer, alias, script, action, or key to include in the module.
         
     
     
-        
+        
         Cannot create empty package. Please select at least one item to include in the package.
         
     
     
-        
-        Module Already Exists
-        
-    
-    
-        
-        A module named "%1" is already installed.
-        
-    
-    
-        
-        Do you want to overwrite the existing module?
-        
-    
-    
-        
-        Module Overwritten
-        
-    
-    
-        
-        Module "%1" overwritten successfully!
-        
-    
-    
-        
-        The existing module has been replaced.
-        
-    
-    
-        
-        
+        
         Module "%1" exported but installation failed: %2
         
     
     
-        
+        
         Module "%1" exported but failed to uninstall existing version
         
     
     
-        
-        Module "%1" exported successfully but not installed (already exists)
-        
-    
-    
-        
+        
         Failed to open package file. Error is: "%1".
         This zipError message is shown when the libzip library code is unable to open the file that was to be the end result of the export process. As this may be an existing file anywhere in the computer's file-system(s) it is possible that permissions on the directory or an existing file that is to be overwritten may be a source of problems here.
         
     
     
-        
+        
         Failed to zip up the package. Error is: "%1".
         This error message is displayed at the final stage of exporting a package when all the sourced files are finally put into the archive. Unfortunately this may be the point at which something breaks because a problem was not spotted/detected in the process earlier...
         
     
     
-        
+        
         Why not <a href="https://packages.mudlet.org/upload">upload</a> your package for other Mudlet users?
         Only the text outside of the 'a' (HTML anchor) tags PLUS the verb 'upload' in between them in the source text, (associated with uploading the resulting package to the Mudlet forums) should be translated.
         
     
     
-        
+        
         Select what to export (%n item(s))
         This is the text shown at the top of a groupbox when there is %n (one or more) items to export in the Package exporter dialogue; the initial (and when there is no items selected) is a separate text.
         
@@ -9367,98 +9358,128 @@ Further reading material, e.g., links to documentation or forum posts.
         
     
     
-        
+        
         Select what to export
         This is the text shown at the top of a groupbox initially and when there is NO items to export in the Package exporter dialogue.
         
     
     
-        
+        
         update installed package
         First item in package selection dropdown - when selected, allows updating an existing installed package
         
     
     
-        
+        
         add dependencies
         
     
     
-        
-        
+        
+        
         Export to %1
         
     
     
-        
+        
         cannot copy %1 to the temporary location %2 - can you double-check it?
         
     
     
-        
+        
         Open Icon
         
     
     
-        
+        
         Image Files (*.png *.jpg *.jpeg *.bmp *.tif *.ico *.icns)
         
     
     
-        
+        
         Please enter the package name.
         
     
     
-        
-        
+        
+        Overwrite module?
+        Title of the dialog asking whether to replace a module that already exists when creating a module
+        
+    
+    
+        
+        A module named "%1" already exists.
+        %1 is the name of the module that already exists
+        
+    
+    
+        
+        Overwrite package?
+        Title of the dialog asking whether to replace a package file that already exists when exporting
+        
+    
+    
+        
+        A file named "%1" already exists.
+        %1 is the file name of the package file that would be overwritten
+        
+    
+    
+        
+        Do you want to overwrite it?
+        Shown under the 'a file/module already exists' text when exporting a package or creating a module
+        
+    
+    
+        
+        
         Exporting package...
         
     
     
-        
+        
         Failed to export. Could not open the folder "%1" for writing. Do you have the necessary permissions and free disk-space to write to that folder?
         
     
     
-        
+        
         Module "%1" created and installed successfully! Saved to: %2. You can now close this dialog.
         %1 is the module name, %2 is a clickable link to the folder the module file was saved in
         
     
     
-        
+        
         Failed to export. Could not write Mudlet items to the file "%1".
         This error message is shown when all the Mudlet items cannot be written to the 'packageName'.xml file in the base directory of the place where all the files are staged before being compressed into the package file. The full path and filename are shown in %1 to help the user diagnose what might have happened
         
     
     
-        
+        
         %1 doesn't seem to exist anymore - can you double-check it?
         
     
     
-        
+        
         Failed to add directory "%1" to package. Error is: "%2".
         
     
     
-        
+        
         Required file "%1" was not found in the staging area. This area contains the Mudlet items chosen for the package, which you selected to be included in the package file. This suggests there may be a problem with that directory: "%2" - Do you have the necessary permissions and free disk-space?
         
     
     
-        
+        
         Package "%1" exported to: %2
         
     
     
-        
+        
         Export cancelled.
         
     
     
-        
+        
         Where do you want to save the package?
         
     
@@ -9466,49 +9487,49 @@ Further reading material, e.g., links to documentation or forum posts.
 
     dlgPackageManager
     
-        
+        
         Package Manager - %1
         Package manager - window title
         
     
     
-        
+        
         Version 
         Package manager - label showing package version
         
     
     
-        
+        
         Import Mudlet Package
         Package manager - import packages from file dialog (multi-select enabled) Package manager - file filter for supported package types (mpackage, zip, xml)
         
     
     
-        
+        
         Mudlet Packages (*.mpackage *.zip *.xml)
         
     
     
-        
+        
         Failed to import: %1
         Package manager - status message shown when some packages failed to import. %1 is a comma-separated list of package names
         
     
     
-        
+        
         Downloading packages...
         Package manager - cancel button text for download progress dialog
         
     
     
-        
+        
         Cancel
         
     
     
-        
-        
-        
+        
+        
+        
         Installation Failed
         Package manager: package couldn't be downloaded
 ----------
@@ -9516,30 +9537,30 @@ Package manager: network error, package couldn't be downloaded
     
     
-        
-        
+        
+        
         Package '%1' not found in repository
         
     
     
-        
+        
         Package '%1' could not be downloaded due to a network error
         
     
     
-        
+        
         Version %1 → %2
         Package manager - version update indicator showing old and new versions
         
     
     
-        
+        
         All packages are up to date.
         Package manager - message shown in description area when no updates are available
         
     
     
-        
+        
         Update (%n)
         Message on button in package manager to update one or multiple (%n is the count) selected packages.
         
@@ -9547,19 +9568,19 @@ Package manager: network error, package couldn't be downloaded
     
     
-        
+        
         Update
         Message on button in package manager when there are no selected packages - button will also be disabled.
         
     
     
-        
+        
         Update selected packages
         Tooltip for button in package manager when in Updates view
         
     
     
-        
+        
         Install (%n)
         Message on button in package manager to install one or multiple (%n is the count) selected packages.
         
@@ -9567,8 +9588,8 @@ Package manager: network error, package couldn't be downloaded
     
     
-        
-        
+        
+        
         Install
         Message on button in package manager when there are no selected packages - button will also be disabled.
 ----------
@@ -9576,14 +9597,14 @@ Message on button in package manager initially and when the view is the "In
         
     
     
-        
-        
+        
+        
         Install package from repository
         Tooltip for button in package manager when in Explore view
         
     
     
-        
+        
         Remove (%n)
         Message on button in package manager to remove one or multiple (%n is the count) selected packages.
         
@@ -9591,8 +9612,8 @@ Message on button in package manager initially and when the view is the "In
         
     
     
-        
-        
+        
+        
         Remove
         Message on button in package manager when there are no selected packages - button will also be disabled.
 ----------
@@ -9600,13 +9621,13 @@ Message on button in package manager initially and when the view is NOT the &quo
         
     
     
-        
+        
         Updates (%1)
         Package manager - navigation button showing one or more available updates
         
     
     
-        
+        
         Updates
         Package manager - navigation button for when there are no updates
         
@@ -10793,362 +10814,362 @@ Format for showing a room weight with its usage count. %1 is the weight value (e
 
 
     dlgTriggerEditor
-    
-        
-        
-        
-        Triggers
-        
-    
-    
-        
-        
-        Show Triggers
-        
-    
-    
-        
-        
-        
-        Buttons
-        
-    
-    
-        
-        
-        Show Buttons
-        
-    
     
         
-        
-        Aliases
+        
+        
+        Triggers
         
     
     
         
         
-        Show Aliases
+        Show Triggers
         
     
     
-        
-        
-        
-        Timers
+        
+        
+        
+        Buttons
         
     
     
-        
-        
-        Show Timers
+        
+        
+        Show Buttons
         
     
     
         
-        
-        
-        Scripts
+        
+        Aliases
         
     
     
         
         
-        Show Scripts
+        Show Aliases
         
     
     
         
-        
-        Keys
+        
+        
+        Timers
         
     
     
         
         
-        Show Keybindings
+        Show Timers
+        
+    
+    
+        
+        
+        
+        Scripts
+        
+    
+    
+        
+        
+        Show Scripts
         
     
     
         
-        
-        
-        Variables
+        
+        Keys
         
     
     
         
         
+        Show Keybindings
+        
+    
+    
+        
+        
+        
+        Variables
+        
+    
+    
+        
+        
         Show Variables
         
     
     
-        
+        
         Activate
         
     
     
-        
+        
         Toggle Active or Non-Active Mode for Triggers, Scripts etc.
         
     
     
-        
+        
         Delete Item
         
     
     
-        
-        
-        
+        
+        
+        
         Copy
         
     
     
-        
-        
+        
+        
         Copy the trigger/script/alias/etc
         
     
     
-        
-        
-        
+        
+        
+        
         Paste
         
     
     
-        
-        
+        
+        
         Paste triggers/scripts/aliases/etc from the clipboard
         
     
     
-        
+        
         Import
         
     
     
-        
+        
         Export
         
     
     
-        
-        
-        
+        
+        
+        
         Save Profile
         
     
     
-        
+        
         Save Profile As
         
     
     
-        
-        
+        
+        
         Statistics
         
     
     
-        
+        
         new folder
         Accessible description for a newly created folder, shown after the folder name
         
     
     
-        
+        
         new item
         Accessible description for a newly created item, shown after the item name
         
     
     
-        
+        
         %1 - Editor
         
     
     
-        
+        
         *** starting new session ***
         
     
     
-        
-        
+        
+        
         Debug
         
     
     
-        
+        
         Something went wrong loading your Mudlet profile and it could not be loaded. Try loading an older version in 'Connect - Options - Profile history'
         
     
     
-        
+        
         Editor Toolbar - %1 - Actions
         This is the toolbar that is initially placed at the top of the editor.
         
     
     
-        
+        
         Editor Toolbar - %1 - Items
         This is the toolbar that is initially placed at the left side of the editor.
         
     
     
-        
+        
         Restore Actions toolbar
         This will restore that toolbar in the editor window, after a user has hidden it or moved it to another docking location or floated it elsewhere.
         
     
     
-        
+        
         Restore Items toolbar
         This will restore that toolbar in the editor window, after a user has hidden it or moved it to another docking location or floated it elsewhere.
         
     
     
-        
-        
+        
+        
         Search Options
         
     
     
-        
+        
         Case sensitive
         
     
     
-        
+        
         start of line
         
     
     
-        
+        
         New trigger group
         
     
     
-        
+        
         New trigger
         
     
     
-        
+        
         New timer group
         
     
     
-        
+        
         New timer
         
     
     
-        
+        
         New key group
         
     
     
-        
-        
-        
+        
+        
+        
         New key
         
     
     
-        
+        
         New alias group
         
     
     
-        
-        
+        
+        
         New alias
         
     
     
-        
+        
         New menu
         
     
     
-        
-        
+        
+        
         New button
         
     
     
-        
+        
         New toolbar
         
     
     
-        
+        
         New script group
         
     
     
-        
+        
         New script
         
     
     
-        
+        
         Alias <em>%1</em> has an infinite loop - substitution matches its own pattern. Please fix it - this alias isn't good as it'll call itself forever.
         
     
     
-        
-        
-        
+        
+        
+        
         While loading the profile, this script had an error that has since been fixed, possibly by another script. The error was:%2%3
         
     
     
-        
-        
+        
+        
         Checked variables will be saved and loaded with your profile.
         
     
     
-        
+        
         match on the prompt line
         
     
     
-        
+        
         match on the prompt line (disabled)
         
     
     
-        
+        
         A Go-Ahead (GA) signal from the game is required to make this feature work
         
     
     
-        
-        
+        
+        
         fault
         
     
     
-        
-        
-        
+        
+        
+        
         Foreground color ignored
         Color trigger ignored foreground color button, ensure all three instances have the same text
         
     
     
-        
+        
         How to add a new alias from the input line
         Name of a selectable option for the Alias intro
         
     
     
-        
-        
+        
+        
         There are a <a href='https://forums.mudlet.org/viewtopic.php?f=6&t=22609'>couple</a> of <a href='https://forums.mudlet.org/viewtopic.php?f=6&t=16462'>packages</a> that can help you.
         Help contents of a selectable option for the Alias intro
 ----------
@@ -11156,68 +11177,57 @@ Help contents of a selectable option for the Trigger intro
         
     
     
-        
+        
         Alias can also be defined from the input line in the main profile window like this:
         Part of the Alias intro - This introductory text will be followed by a Lua code example for a trigger.
         
     
     
-        
+        
         My greetings
         Part of the Alias intro, code example for an alias - This is the name of the alias which reacts on the player typing "hi" by saying "Greetings, traveller!" in game.
         
     
     
-        
+        
         hi
         Part of the Alias intro, code example for an alias - This is the text input from the player which will be reacted on by saying "Greetings, traveller!" in game.
         
     
     
-        
+        
         say Greetings, traveller!
         Part of the Alias intro, code example for an alias - This is the command that Mudlet will send to the game after the player typed "hi".
         
     
     
-        
+        
         We said hi!
         Part of the Alias intro, code example for an alias - This is the confirmation text shown to the player after they typed "hi" and we said "Greetings, traveller!" in game.
         
     
     
-        
-        
-        
-        
-        
-        
-        
+        
+        
+        
+        
+        
+        
+        
         Where to find more information
         
     
     
-        
-        
-        
-        
+        
+        
+        
+        
         Watch a <a href='%1'>video demonstration</a> of the basic functionality.
         
     
-    
-        
-        Read the <a href='http://wiki.mudlet.org/w/Manual:Introduction#Aliases'>Introduction to Aliases</a> for a detailed overview.
-        
-    
     
         
-        
-        
-        
-        
-        
-        
-        Do you maybe have any other suggestions, questions or doubts?
+        Read the <a href='http://wiki.mudlet.org/w/Manual:Introduction#Aliases'>Introduction to Aliases</a> for a detailed overview.
         
     
     
@@ -11228,247 +11238,258 @@ Help contents of a selectable option for the Trigger intro
         
         
         
+        Do you maybe have any other suggestions, questions or doubts?
+        
+    
+    
+        
+        
+        
+        
+        
+        
+        
         Join our community on <a href='https://www.mudlet.org/chat'>Discord</a> or in <a href='https://forums.mudlet.org/'>Mudlet forums</a> - See you there!
         
     
     
-        
+        
         How to add a new trigger from the input line
         Name of a selectable option for the Trigger intro
         
     
     
-        
+        
         Triggers can also be defined from the input line in the main profile window like this:
         Part of the Trigger intro - This introductory text will be followed by a Lua code example for a trigger.
         
     
     
-        
+        
         My drink trigger
         Part of the Trigger intro, code example for a trigger - This is the name of the trigger which reacts on "You are thirsty" with "drink water".
         
     
     
-        
+        
         You are thirsty.
         Part of the Trigger intro, code example for a trigger - This is the text from game which will be triggered on, and reacted to with "drink water".
         
     
     
-        
+        
         drink water
         Part of the Trigger intro, code example for a trigger - This is the command sent to game after we triggered on text "You are thirsty." from game.
         
     
     
-        
+        
         Read the <a href='http://wiki.mudlet.org/w/Manual:Introduction#Triggers'>Introduction to Triggers</a> for a detailed overview.
         
     
     
-        
+        
         Read the <a href='http://wiki.mudlet.org/w/Manual:Introduction#Scripts'>Introduction to Scripts</a> for a detailed overview.
         
     
     
-        
+        
         How to add a new timer from the input line
         Name of a selectable option for the Timer intro
         
     
     
-        
+        
         Read the <a href='http://wiki.mudlet.org/w/Manual:Introduction#Timers'>Introduction to Timers</a> for a detailed overview.
         
     
     
-        
+        
         <ol><li>Add a new group to create a <strong>button bar</strong>.</li><li>Add groups as <strong>menus</strong> or sub-menus.</li><li>Add items as <strong>buttons</strong> to a bar or menu.</li><li>Define a <strong>command</strong> or script to execute when pressed.</li><li><strong>Activate</strong> the item. </li></ol><p><strong>Note:</strong> Deactivated items are hidden, including all items they contain.</p><p><strong>Click-down buttons:</strong> Can define separate commands for press/release. Use getButtonState() to check state.</p>
         Help contents of a selectable option for the Button intro
         
     
     
-        
+        
         Read the <a href='http://wiki.mudlet.org/w/Manual:Introduction#Buttons'>Introduction to Buttons</a> for a detailed overview.
         
     
     
-        
+        
         How to add a new keybinding from the input line
         Name of a selectable option for the Keys intro
         
     
     
-        
+        
         Read the <a href='http://wiki.mudlet.org/w/Manual:Introduction#Keybindings'>Introduction to Keybindings</a> for a detailed overview.
         
     
     
-        
+        
         How to add a new variable from the input line
         Name of a selectable option for the Variable intro
         
     
     
-        
+        
         Read the <a href='http://wiki.mudlet.org/w/Manual:Introduction#Variables'>Introduction to Variables</a> for a detailed overview.
         
     
     
-        
+        
         package item
         Accessible description indicating an item belongs to a package, shown after the item name. Keep short, as it's appended to other descriptions like "activated, package item"
         
     
     
-        
-        
-        
+        
+        
+        
         Undo
         
     
     
-        
-        
-        
+        
+        
+        
         Redo
         
     
     
-        
-        
+        
+        
         Undo: %1 (%2)
         Tooltip for undo action. %1 is the action being undone (e.g., "Activate trigger "foo""), %2 is the keyboard shortcut
         
     
     
-        
-        
+        
+        
         Undo (%1)
         Tooltip for undo action when no specific action. %1 is the keyboard shortcut
         
     
     
-        
-        
+        
+        
         Redo: %1 (%2)
         Tooltip for redo action. %1 is the action being redone (e.g., "Activate trigger "foo""), %2 is the keyboard shortcut
         
     
     
-        
-        
+        
+        
         Redo (%1)
         Tooltip for redo action when no specific action. %1 is the keyboard shortcut
         
     
     
-        
+        
         Show/Hide Debug Console (%1) -> system will be <b><i>slower</i></b>.
         %1 is a keyboard shortcut, e.g. 'Ctrl+0' on Windows/Linux or '⌘0' on macOS
         
     
     
-        
+        
         Add Item
         
     
     
-        
+        
         Create Module
         
     
     
-        
+        
         <p>Create a module from selected items</p>
         
     
     
-        
+        
         <p>Saves your profile. (%1)</p><p>Saves your entire profile (triggers, aliases, scripts, timers, buttons and keys, but not the map or script-specific settings) to your computer disk, so in case of a computer or program crash, all changes you have done will be retained.</p><p>It also makes a backup of your profile, you can load an older version of it when connecting.</p><p>Should there be any modules that are marked to be "<i>synced</i>" this will also cause them to be saved and reloaded into other profiles if they too are active.</p>
         %1 is a keyboard shortcut, e.g. 'Ctrl+Shift+S' on Windows/Linux or '⌘⇧S' on macOS
         
     
     
-        
+        
         Whole word
         
     
     
-        
+        
         Only match whole words
         
     
     
-        
+        
         Text to find (anywhere in the game output)
         
     
     
-        
+        
         Text to find (as a regular expression pattern)
         
     
     
-        
+        
         Text to find (from beginning of the line)
         
     
     
-        
+        
         Exact line to match
         
     
     
-        
+        
         Lua code to run (return true to match)
         
     
     
-        
+        
         <p>Unable to activate "<tt>%1</tt>": %2</p>
                      <p><i>You will need to reactivate this after the problem has been corrected.</i></p>
         
     
     
-        
+        
         move items
         
     
     
-        
+        
         <p><b>Unable to activate "<tt>%1</tt>": %2.</b></p>
                      <p><i>You will need to reactivate this after the problem has been corrected.</i></p>
         
     
     
-        
-        
-        
-        
+        
+        
+        
+        
         <p><b>Unable to activate "<tt>%1</tt>"; %2.</b></p>
                      <p><i>You will need to reactivate this after the problem has been corrected.</i></p>
         
     
     
-        
+        
         table_variable
         
     
     
-        
+        
         variable_name
         
     
     
-        
-        
-        
-        
-        
-        
-        
+        
+        
+        
+        
+        
+        
+        
         This item is part of a package. To best preserve your changes, copy this item before editing as package upgrades may overwrite modifications.
         Package item warning shown in trigger editor when editing package items. Should only be announced to screen readers once per item, not repeatedly on every edit.
 ----------
@@ -11476,1131 +11497,1131 @@ Package item warning banner shown in trigger editor when selecting package items
         
     
     
-        
-        
-        
+        
+        
+        
         Default foreground color
         Color trigger default foreground color button, ensure all three instances have the same text
         
     
     
-        
-        
-        
+        
+        
+        
         Foreground color [ANSI %1]
         Color trigger ANSI foreground color button, ensure all three instances have the same text
         
     
     
-        
-        
-        
+        
+        
+        
         Background color ignored
         Color trigger ignored background color button, ensure all three instances have the same text
         
     
     
-        
-        
-        
+        
+        
+        
         Default background color
         Color trigger default background color button, ensure all three instances have the same text
         
     
     
-        
-        
-        
+        
+        
+        
         Background color [ANSI %1]
         Color trigger ANSI background color button, ensure all three instances have the same text
         
     
     
-        
-        
-        
-        
-        
-        
+        
+        
+        
+        
+        
+        
         keep
         Keep the existing colour on matches to highlight. Use shortest word possible so it fits on the button
         
     
     
-        
-        
-        
-        
-        
-        
+        
+        
+        
+        
+        
+        
         Package item. Copy before editing to preserve changes.
         First-time educational message for screen reader users about package items
         
     
     
-        
-        
+        
+        
         Command:
         
     
     
-        
+        
         Menu properties
         
     
     
-        
+        
         Button properties
         
     
     
-        
+        
         Command (down);
         
     
     
-        
+        
         Aliases - Input Triggers
         
     
     
-        
+        
         Key Bindings
         
     
     
-        
+        
         Add Trigger
         
     
     
-        
+        
         Add new trigger
         
     
     
-        
+        
         Add Trigger Group
         
     
     
-        
+        
         Add new group of triggers
         
     
     
-        
+        
         Delete Trigger
         
     
     
-        
+        
         Delete the selected trigger
         
     
     
-        
-        
+        
+        
         Save Trigger
         
     
     
-        
+        
         Add Timer
         
     
     
-        
+        
         Add new timer
         
     
     
-        
+        
         Add Timer Group
         
     
     
-        
+        
         Add new group of timers
         
     
     
-        
+        
         Delete Timer
         
     
     
-        
+        
         Delete the selected timer
         
     
     
-        
-        
+        
+        
         Save Timer
         
     
     
-        
+        
         Add Alias
         
     
     
-        
+        
         Add new alias
         
     
     
-        
+        
         Add Alias Group
         
     
     
-        
+        
         Add new group of aliases
         
     
     
-        
+        
         Delete Alias
         
     
     
-        
+        
         Delete the selected alias
         
     
     
-        
-        
+        
+        
         Save Alias
         
     
     
-        
+        
         Add Script
         
     
     
-        
+        
         Add new script
         
     
     
-        
+        
         Add Script Group
         
     
     
-        
+        
         Add new group of scripts
         
     
     
-        
+        
         Delete Script
         
     
     
-        
+        
         Delete the selected script
         
     
     
-        
-        
+        
+        
         Save Script
         
     
     
-        
+        
         Add Button
         
     
     
-        
+        
         Add new button
         
     
     
-        
+        
         Add Button Group
         
     
     
-        
+        
         Add new group of buttons
         
     
     
-        
+        
         Delete Button
         
     
     
-        
+        
         Delete the selected button
         
     
     
-        
-        
+        
+        
         Save Button
         
     
     
-        
+        
         Add Key
         
     
     
-        
+        
         Add new key
         
     
     
-        
+        
         Add Key Group
         
     
     
-        
+        
         Add new group of keys
         
     
     
-        
+        
         Delete Key
         
     
     
-        
+        
         Delete the selected key
         
     
     
-        
-        
+        
+        
         Save Key
         
     
     
-        
+        
         Add Variable
         
     
     
-        
+        
         Add new variable
         
     
     
-        
+        
         Add Lua table
         
     
     
-        
+        
         Add new Lua table
         
     
     
-        
+        
         Delete Variable
         
     
     
-        
+        
         Delete the selected variable
         
     
     
-        
-        
+        
+        
         Save Variable
         
     
     
-        
+        
         Central Debug Console
         
     
     
-        
-        
-        
-        
-        
-        
-        
-        
-        
-        
-        
-        
-        
-        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
         
-        
-        
-        
-        
-        
-        
-        
-        
-        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
         Export Package:
         
     
     
-        
-        
-        
-        
-        
-        
-        
-        
-        
-        
-        
-        
-        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
         
-        
-        
-        
-        
+        
+        
+        
+        
+        
+        
+        
         You have to choose an item for export first. Please select a tree item and then click on export again.
         
     
     
-        
-        
-        
-        
-        
-        
+        
+        
+        
+        
+        
+        
         Package %1 saved
         
     
     
-        
+        
         No valid triggers found to export.
         
     
     
-        
-        
-        
-        
-        
-        
+        
+        
+        
+        
+        
+        
         Copied %1 to clipboard
         
     
     
-        
+        
         Copied %1 triggers to clipboard
         
     
     
-        
+        
         No valid timers found to export.
         
     
     
-        
+        
         Copied %1 timers to clipboard
         
     
     
-        
+        
         No valid aliases found to export.
         
     
     
-        
+        
         Copied %1 aliases to clipboard
         
     
     
-        
+        
         No valid actions found to export.
         
     
     
-        
+        
         Copied %1 actions to clipboard
         
     
     
-        
+        
         No valid scripts found to export.
         
     
     
-        
+        
         Copied %1 scripts to clipboard
         
     
     
-        
+        
         No valid keys found to export.
         
     
     
-        
+        
         Copied %1 keys to clipboard
         
     
     
-        
+        
         Mudlet packages (*.xml)
         
     
     
-        
+        
         Export Item
         
     
     
-        
+        
         export package:
         
     
     
-        
+        
         Cannot write file %1:
 %2.
         
     
     
-        
+        
         Pasted %1 items successfully
         
     
     
-        
+        
         paste
         Undo/redo text for pasting items
         
     
     
-        
+        
         Import Mudlet Package
         Trigger editor - import packages from file dialog (multi-select enabled) Trigger editor - file filter for supported package types (mpackage, zip, xml)
         
     
     
-        
+        
         Mudlet Packages (*.mpackage *.zip *.xml)
         
     
     
-        
+        
         Failed to import: %1
         Trigger editor - status message shown when some packages failed to import. %1 is a comma-separated list of package names
         
     
     
-        
+        
         Couldn't save profile
         
     
     
-        
+        
         Sorry, couldn't save your profile - got the following error: %1
         
     
     
-        
+        
         Backup Profile
         
     
     
-        
+        
         trigger files (*.trigger *.xml)
         
     
     
-        
-        
+        
+        
         Keep color
         Button in the color picker that preserves the existing text color on trigger matches
         
     
     
-        
+        
         Audio files(*.aac *.mp3 *.mp4a *.oga *.ogg *.pcm *.wav *.wma);;Advanced Audio Coding-stream(*.aac);;MPEG-2 Audio Layer 3(*.mp3);;MPEG-4 Audio(*.mp4a);;Ogg Vorbis(*.oga *.ogg);;PCM Audio(*.pcm);;Wave(*.wav);;Windows Media Audio(*.wma);;All files(*.*)
         This the list of file extensions that are considered for sounds from triggers, the terms inside of the '('...')' and the ";;" are used programmatically and should not be changed.
         
     
     
-        
+        
         Banner hidden. <a href='undo' style='color: inherit; text-decoration: underline;'>Undo</a> | <a href='hide-permanently' style='color: inherit; text-decoration: underline;'>Hide permanently</a>
         Toast notification shown when user dismisses an editor tip banner. Allows them to undo or permanently hide the tips for this editor view type.
         
     
     
-        
+        
         Command (down):
         
     
     
-        
+        
         Apply trigger changes (does not save to disk).
         Status tip for saving trigger changes
         
     
     
-        
+        
         Apply timer changes (does not save to disk).
         Status tip for saving timer changes
         
     
     
-        
+        
         Apply alias changes (does not save to disk).
         Status tip for saving alias changes
         
     
     
-        
+        
         Apply script changes (does not save to disk).
         Status tip for saving script changes
         
     
     
-        
+        
         Apply button changes (does not save to disk).
         Status tip for saving button changes
         
     
     
-        
+        
         Apply key changes (does not save to disk).
         Status tip for saving key changes
         
     
     
-        
+        
         Apply variable changes (does not save to disk).
         Status tip for saving variable changes
         
     
     
-        
+        
         Select foreground color to apply to matches
         
     
     
-        
+        
         Select background color to apply to matches
         
     
     
-        
+        
         Choose sound file
         
     
     
-        
+        
         Select foreground trigger color for item %1
         
     
     
-        
+        
         Select background trigger color for item %1
         
     
     
-        
+        
         Saving…
         
     
     
-        
+        
         Format All
         
     
     
-        
-        
+        
+        
         Cut
         
     
     
-        
-        
+        
+        
         Select All
         
     
     
-        
+        
         Sound file to play when the trigger fires.
         
     
     
-        
+        
         substring
         
     
     
-        
+        
         Alias react on user input.
         Headline for the Alias intro
         
     
     
-        
+        
         How to add a new alias now
         Name of a selectable option for the Alias intro
         
     
     
-        
+        
         <ol><li>Click on the 'Add Item' icon above.</li><li>Define an input <strong>pattern</strong> either literally or with a Perl regular expression.</li><li>Define a 'substitution' <strong>command</strong> to send to the game in clear text <strong>instead of the alias pattern</strong>, or write a script for more complicated needs.</li><li><strong>Activate</strong> the alias.</li></ol>
         Help contents of a selectable option for the Alias intro
         
     
     
-        
+        
         Triggers react on game output.
         Headline for the Trigger intro
         
     
     
-        
+        
         How to add a new trigger now
         Name of a selectable option for the Trigger intro
         
     
     
-        
+        
         <ol><li>Click on the 'Add Item' icon above.</li><li>Define a <strong>pattern</strong> that you want to trigger on.</li><li>Select the appropriate pattern <strong>type</strong>.</li><li>Define a clear text <strong>command</strong> that you want to send to the game if the trigger finds the pattern in the text from the game, or write a script for more complicated needs..</li><li><strong>Activate</strong> the trigger.</li></ol>
         Help contents of a selectable option for the Trigger intro
         
     
     
-        
+        
         Scripts organize code and can react to events.
         Headline for the Script intro
         
     
     
-        
+        
         How to add a new script now
         Name of a selectable option for the Script intro
         
     
     
-        
+        
         <ol><li>Click on the 'Add Item' icon above.</li><li>Enter a script in the box below. You can for example define <strong>functions</strong> to be called by other triggers, aliases, etc.</li><li>If you write lua <strong>commands</strong> without defining a function, they will be run on Mudlet startup and each time you open the script for editing.</li><li><strong>Activate</strong> the script.</li></ol><p><strong>Note:</strong> Scripts are run automatically when viewed, even if they are deactivated.</p>
         Help contents of a selectable option for the Script intro
         
     
     
-        
+        
         How to have a script react to events
         Name of a selectable option for the Script intro
         
     
     
-        
+        
         <p>You can register a list of <strong>events</strong> with the + and - symbols. If one of these events take place, the function with the same name as the script item itself will be called.</p><p><strong>Note:</strong> Events can also be added to a script from the command line in the main profile window like this:</p><p><code>lua registerAnonymousEventHandler(&quot;nameOfTheMudletEvent&quot;, &quot;nameOfYourFunctionToBeCalled&quot;)</code></p>
         Help contents of a selectable option for the Script intro
         
     
     
-        
+        
         Timers react after a timespan once or regularly.
         Headline for the Timer intro
         
     
     
-        
+        
         How to add a new timer now
         Name of a selectable option for the Timer intro
         
     
     
-        
+        
         <ol><li>Click on the 'Add Item' icon above.</li><li>Define the <strong>timespan</strong> after which the timer should react in a this format: hours : minutes : seconds.</li><li>Define a clear text <strong>command</strong> that you want to send to the game when the time has passed, or write a script for more complicated needs.</li><li><strong>Activate</strong> the timer.</li></ol><p><strong>Note:</strong> If you want the trigger to react only once and not regularly, use the Lua tempTimer() function instead.</p>
         Help contents of a selectable option for the Timer intro
         
     
     
-        
+        
         <p>Timers can also be defined from the input line in the main profile window like this:</p><p><code>lua tempTimer(3, function() echo(&quot;hello!
 &quot;) end)</code></p><p>This will greet you exactly 3 seconds after it was made.</p>
         Help contents of a selectable option for the Timer intro
         
     
     
-        
+        
         Buttons react on mouse clicks.
         Headline for the Button intro
         
     
     
-        
+        
         How to add a new button now
         Name of a selectable option for the Button intro
         
     
     
-        
+        
         Keys react on keyboard presses.
         Headline for the Keys intro
         
     
     
-        
+        
         How to add a new keybinding now
         Name of a selectable option for the Keys intro
         
     
     
-        
+        
         <ol><li>Click on the 'Add Item' icon above.</li><li>Click on <strong>'grab key'</strong> and then press your key combination, e.g. including modifier keys like Control, Shift, etc.</li><li>Define a clear text <strong>command</strong> that you want to send to the game if the button is pressed, or write a script for more complicated needs.</li><li><strong>Activate</strong> the new key binding.</li></ol>
         Help contents of a selectable option for the Keys intro
         
     
     
-        
+        
         <p>Keys can be defined from the input line in the main profile window like this:</p><p><code>lua permKey(&quot;my jump key&quot;, &quot;&quot;, mudlet.key.F8, [[send(&quot;jump&quot;]]) end)</code></p><p>Pressing F8 will make you jump.</p>
         Help contents of a selectable option for the Keys intro
         
     
     
-        
+        
         Variables store information.
         Headline for the Variable intro
         
     
     
-        
+        
         How to add a new variable now
         Name of a selectable option for the Variable intro
         
     
     
-        
+        
         <ol><li>Click on the 'Add Item' icon above. To add a table instead click 'Add Group'.</li><li>Select type of variable value (can be a string, integer, boolean)</li><li>Enter the value you want to store in this variable.</li><li>If you want to keep the variable in your next Mudlet sessions, check the checkbox in the list of variables to the left.</li><li>To remove a variable manually, set it to 'nil' or click on the 'Delete' icon above.</li></ol><p><strong>Note:</strong> Variables created here won't be saved when Mudlet shuts down unless you check their checkbox in the list of variables to the left. You could also create scripts with the variables instead.</p>
         Help contents of a selectable option for the Variable intro
         
     
     
-        
+        
         <p>Variables and tables can also be defined from the input line in the main profile window like this:</p><p><code>lua foo = &quot;bar&quot;</code></p><p>This will create a string called 'foo' with 'bar' as its value.</p>
         Help contents of a selectable option for the Variable intro
         
     
     
-        
+        
         activated
         Item is currently on, short enough to be spoken
         
     
     
-        
+        
         deactivated
         Item is currently off, short enough to be spoken
         
     
     
-        
+        
         activated folder
         Folder is currently turned on
         
     
     
-        
+        
         deactivated folder
         Folder is currently turned off
         
     
     
-        
+        
         deactivated due to error
         Item is currently inactive because of errors, short enough to be spoken
         
     
     
-        
+        
         %1 in a deactivated group
         Item is currently turned on individually, but is member of an inactive group
         
     
     
-        
+        
         activated filter chain
         A trigger that unlocks other triggers is currently turned on, short enough to be spoken
         
     
     
-        
+        
         deactivated filter chain
         A trigger that unlocks other triggers is currently turned off, short enough to be spoken
         
     
     
-        
+        
         activated offset timer
         A timer that starts after another timer is currently turned on
         
     
     
-        
+        
         deactivated offset timer
         A timer that starts after another timer is currently turned off
         
     
     
-        
+        
         -- add your Lua code here
         
     
     
-        
-        
+        
+        
         Errors
         
     
     
-        
+        
         Show/Hide the errors console in the bottom right of this editor.
         
     
     
-        
+        
         Show/Hide errors console
         
     
     
-        
+        
         Generate a statistics summary display on the main profile console.
         
     
     
-        
+        
         Generate statistics
         
     
     
-        
+        
         Show/Hide the separate Central Debug Console - when being displayed the system will be slower.
         
     
     
-        
+        
         Save profile (triggers, aliases, scripts, timers, buttons, keys - not the map) and synchronize modules.
         Status tip for saving profile
         
     
     
-        
+        
         Match case precisely
         
     
     
-        
+        
         Include variables
         
     
     
-        
+        
         Search variables (slower)
         
     
     
-        
+        
         Type
         Heading for the first column of the search results
         
     
     
-        
+        
         Where
         
     
     
-        
+        
         What
         
     
     
-        
+        
         perl regex
         
     
     
-        
+        
         exact match
         
     
     
-        
+        
         lua function
         
     
     
-        
+        
         line spacer
         
     
     
-        
+        
         color trigger
         
     
     
-        
+        
         prompt
         
     
     
-        
-        
-        
-        
+        
+        
+        
+        
         Trigger
         
     
     
-        
-        
-        
-        
-        
-        
-        
-        
+        
+        
+        
+        
+        
+        
+        
+        
         Name
         
     
     
-        
-        
-        
-        
-        
-        
-        
-        
-        
-        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
         Command
         
     
     
-        
-        
+        
+        
         Pattern {%1}
         
     
     
-        
-        
+        
+        
         Lua code (%1:%2)
         
     
     
-        
-        
-        
-        
+        
+        
+        
+        
         Alias
         
     
     
-        
-        
+        
+        
         Pattern
         
     
     
-        
-        
-        
+        
+        
+        
         Script
         
     
     
-        
-        
+        
+        
         Event Handler
         
     
     
-        
-        
-        
-        
-        
+        
+        
+        
+        
+        
         Button
         
     
     
-        
+        
         Add Group (%1)
         %1 is a keyboard shortcut, e.g. 'Ctrl+Shift+N' on Windows/Linux or '⌘⇧N' on macOS
         
     
     
-        
+        
         <p>Saves the selected item. (%1)</p><p>Saving causes any changes to the item to take effect. It will not save to disk, so changes will be lost in case of a computer/program crash (but Save Profile to the right will be secure.)</p>
         %1 is a keyboard shortcut, e.g. 'Ctrl+S' on Windows/Linux or '⌘S' on macOS
         
     
     
-        
-        
+        
+        
         Command {Down}
         
     
     
-        
-        
+        
+        
         Command {Up}
         
     
     
-        
-        
+        
+        
         Stylesheet {L: %1 C: %2}
         
     
     
-        
-        
-        
+        
+        
+        
         Timer
         
     
     
-        
-        
-        
+        
+        
+        
         Key
         
     
     
-        
-        
+        
+        
         Variable
         
     
     
-        
-        
+        
+        
         Value
         
     
     
-        
+        
         Save Item
         
     
@@ -12759,77 +12780,77 @@ Package item warning banner shown in trigger editor when selecting package items
 
     main
     
-        
+        
         Warning: %1
 
         
     
     
-        
+        
                -h, --help                   displays this message.
         
     
     
-        
+        
                -v, --version                displays version information.
         
     
     
-        
+        
                -p, --profile=<profile>      additional profile to open, may be
                                     repeated.
         
     
     
-        
+        
                -o, --only=<predefined>      make Mudlet only show the specific
                                     predefined game, may be repeated.
         
     
     
-        
+        
                -f, --fullscreen             start Mudlet in fullscreen mode.
         
     
     
-        
+        
                --steammode                  adjusts Mudlet settings to match
                                     Steam's requirements.
         
     
     
-        
+        
         There are other inherited options that arise from the Qt Libraries which are
 less likely to be useful for normal use of this application:
         
     
     
-        
+        
                --dograb                     ignore any implicit or explicit -nograb.
                                     --dograb wins over --nograb even when --nograb is last on
                                     the command line.
         
     
     
-        
+        
                --nograb                     the application should never grab the mouse or the
                                     keyboard. This option is set by default when Mudlet is
                                     running in the gdb debugger under Linux.
         
     
     
-        
+        
                --nograb                     the application should never grab the mouse or the
                                     keyboard.
         
     
     
-        
+        
                --reverse                    sets the application's layout direction to right to left.
         
     
     
-        
+        
                --style=style                sets the application GUI style. Possible values depend on
                                     your system configuration. If Qt was compiled with
                                     additional styles or has additional styles as plugins
@@ -12840,12 +12861,12 @@ less likely to be useful for normal use of this application:
         
     
     
-        
+        
                --style style                is the same as listed above.
         
     
     
-        
+        
                --stylesheet=stylesheet      sets the application styleSheet.
                                     The value must be a path to a file that contains the
                                     Style Sheet. Note: Relative URLs in the Style Sheet file
@@ -12853,12 +12874,12 @@ less likely to be useful for normal use of this application:
         
     
     
-        
+        
                --stylesheet stylesheet      is the same as listed above.
         
     
     
-        
+        
                --sync                       forces the X server to perform each X client request
                                     immediately and not use buffer optimization. It makes the
                                     program easier to debug and often much slower. The --sync
@@ -12866,14 +12887,14 @@ less likely to be useful for normal use of this application:
         
     
     
-        
+        
                --widgetcount                prints debug message at the end about number of widgets
                                     left undestroyed and maximum number of widgets existing
                                     at the same time.
         
     
     
-        
+        
                --qmljsdebugger=1234[,block] activates the QML/JS debugger with a
                                     specified port. The number is the port value and block is
                                     optional and will make the application wait until a
@@ -12881,71 +12902,71 @@ less likely to be useful for normal use of this application:
         
     
     
-        
+        
         Arguments:
         
     
     
-        
+        
                 [FILE]                       File to install as a package
         
     
     
-        
+        
         Report bugs to: https://github.com/Mudlet/Mudlet/issues
         
     
     
-        
+        
         Usage: %1 [OPTION...] [FILE] 
         %1 is the name of the executable as it is on this OS.
         
     
     
-        
+        
         Options:
         
     
     
-        
+        
                -s, --splashscreen           show splashscreen on startup.
         
     
     
-        
+        
         Project home page: http://www.mudlet.org/
         
     
     
-        
+        
         %1 %2%3 (with debug symbols, without optimisations)
         %1 is the name of the application like mudlet or Mudlet.exe, %2 is the version number like 3.20 and %3 is a build suffix like -dev
         
     
     
-        
+        
         Qt libraries %1 (compilation) %2 (runtime)
         %1 and %2 are version numbers
         
     
     
-        
+        
         Copyright © 2008-2026  Mudlet developers
         
     
     
-        
+        
         Licence GPLv2+: GNU GPL version 2 or later - http://gnu.org/licenses/gpl.html
         
     
     
-        
+        
         This is free software: you are free to change and redistribute it.
 There is NO WARRANTY, to the extent permitted by law.
         
     
     
-        
+        
         Version: %1
         
     
@@ -13624,1018 +13645,1018 @@ There is NO WARRANTY, to the extent permitted by law.
 
     mudlet
     
-        
+        
         Afrikaans
         In the translation source texts the language is the leading term, with, generally, the (primary) country(ies) in the brackets, with a trailing language disabiguation after a '-' Chinese is an exception!
         
     
     
-        
+        
         Afrikaans (South Africa)
         
     
     
-        
+        
         Aragonese
         
     
     
-        
+        
         Aragonese (Spain)
         
     
     
-        
+        
         Arabic
         
     
     
-        
+        
         Arabic (United Arab Emirates)
         
     
     
-        
+        
         Arabic (Bahrain)
         
     
     
-        
+        
         Arabic (Algeria)
         
     
     
-        
+        
         Arabic (India)
         
     
     
-        
+        
         Arabic (Iraq)
         
     
     
-        
+        
         Arabic (Jordan)
         
     
     
-        
+        
         Arabic (Kuwait)
         
     
     
-        
+        
         Arabic (Lebanon)
         
     
     
-        
+        
         Arabic (Libya)
         
     
     
-        
+        
         Arabic (Morocco)
         
     
     
-        
+        
         Arabic (Oman)
         
     
     
-        
+        
         Arabic (Qatar)
         
     
     
-        
+        
         Arabic (Saudi Arabia)
         
     
     
-        
+        
         Arabic (Sudan)
         
     
     
-        
+        
         Arabic (Syria)
         
     
     
-        
+        
         Arabic (Tunisia)
         
     
     
-        
+        
         Arabic (Yemen)
         
     
     
-        
+        
         Belarusian
         
     
     
-        
+        
         Belarusian (Belarus)
         
     
     
-        
+        
         Belarusian (Russia)
         
     
     
-        
+        
         Bulgarian
         
     
     
-        
+        
         Bulgarian (Bulgaria)
         
     
     
-        
+        
         Bangla
         
     
     
-        
+        
         Bangla (Bangladesh)
         
     
     
-        
+        
         Bangla (India)
         
     
     
-        
+        
         Tibetan
         
     
     
-        
+        
         Tibetan (China)
         
     
     
-        
+        
         Tibetan (India)
         
     
     
-        
+        
         Breton
         
     
     
-        
+        
         Breton (France)
         
     
     
-        
+        
         Bosnian
         
     
     
-        
+        
         Bosnian (Bosnia/Herzegovina)
         
     
     
-        
+        
         Bosnian (Bosnia/Herzegovina - Cyrillic alphabet)
         
     
     
-        
+        
         Catalan
         
     
     
-        
+        
         Catalan (Spain)
         
     
     
-        
+        
         Catalan (Spain - Valencian)
         
     
     
-        
+        
         Central Kurdish
         
     
     
-        
+        
         Central Kurdish (Iraq)
         
     
     
-        
+        
         Czech
         
     
     
-        
+        
         Czech (Czechia)
         
     
     
-        
+        
         Danish
         
     
     
-        
+        
         Danish (Denmark)
         
     
     
-        
+        
         German
         
     
     
-        
+        
         German (Austria)
         
     
     
-        
+        
         German (Austria, revised by F M Baumann)
         
     
     
-        
+        
         German (Belgium)
         
     
     
-        
+        
         German (Switzerland)
         
     
     
-        
+        
         German (Switzerland, revised by F M Baumann)
         
     
     
-        
+        
         German (Germany/Belgium/Luxemburg)
         
     
     
-        
+        
         German (Germany/Belgium/Luxemburg, revised by F M Baumann)
         
     
     
-        
+        
         German (Liechtenstein)
         
     
     
-        
+        
         German (Luxembourg)
         
     
     
-        
+        
         Greek
         
     
     
-        
+        
         Greek (Greece)
         
     
     
-        
+        
         English
         
     
     
-        
+        
         English (Antigua/Barbuda)
         
     
     
-        
+        
         English (Australia)
         
     
     
-        
+        
         English (Bahamas)
         
     
     
-        
+        
         English (Botswana)
         
     
     
-        
+        
         English (Belize)
         
     
     
-        
+        
         Arabic (Egypt)
         
     
     
-        
-        
-        
+        
+        
+        
         Close profile
         
     
     
-        
-        
+        
+        
         Close Mudlet
         
     
     
-        
+        
         Mute
         
     
     
-        
-        
-        
-        
-        
+        
+        
+        
+        
+        
         Mute all media
         
     
     
-        
-        
-        
+        
+        
+        
         Mute sounds from Mudlet (triggers, scripts, etc.)
         
     
     
-        
+        
         Mudlet chat
         
     
     
-        
+        
         Open a link to the Mudlet server on Discord
         
     
     
-        
+        
         Show Main Toolbar
         
     
     
-        
+        
         Report issue
         
     
     
-        
+        
         Report bugs in the public test build to help us improve Mudlet.
         Tooltip for Report Issue button in public test builds
         
     
     
-        
-        
+        
+        
         About Mudlet version, creators, and license.
         Tooltip for About Mudlet sub-menu item and main toolbar button (or menu item if an update has changed that control to have a popup menu instead) (Used in multiple places - please ensure all have the same translation).
         
     
     
-        
+        
         Full Screen
         
     
     
-        
+        
         Script editor
         
     
     
-        
+        
         Show Map
         
     
     
-        
+        
         Compact input line
         
     
     
-        
+        
         Preferences
         
     
     
-        
+        
         Package manager
         
     
     
-        
+        
         Module manager
         
     
     
-        
+        
         Play
         
     
     
-        
+        
         Toggle Time Stamps
         
     
     
-        
+        
         Toggle Replay
         
     
     
-        
+        
         Toggle Logging
         
     
     
-        
+        
         Toggle Emergency Stop
         
     
     
-        
+        
         Next profile
         
     
     
-        
+        
         Previous profile
         
     
     
-        
+        
         Switch to profile %1
         Name of the keyboard shortcut that switches to the numbered profile tab, %1 is that number (1 to 9)
         
     
     
-        
+        
         Tibetan (Bhutan)
         
     
     
-        
+        
         Welsh
         
     
     
-        
+        
         Welsh (United Kingdom {Wales})
         
     
     
-        
+        
         Dzongkha
         
     
     
-        
+        
         Dzongkha (Bhutan)
         
     
     
-        
+        
         English (Australia, Large)
         This dictionary contains larger vocabulary.
         
     
     
-        
+        
         English (Canada)
         
     
     
-        
+        
         English (Canada, Large)
         This dictionary contains larger vocabulary.
         
     
     
-        
+        
         English (Denmark)
         
     
     
-        
+        
         English (United Kingdom)
         
     
     
-        
+        
         English (United Kingdom, Large)
         This dictionary contains larger vocabulary.
         
     
     
-        
+        
         English (United Kingdom - 'ise' not 'ize')
         This dictionary prefers the British 'ise' form over the American 'ize' one.
         
     
     
-        
+        
         English (Ghana)
         
     
     
-        
+        
         English (Hong Kong SAR China)
         
     
     
-        
+        
         English (Ireland)
         
     
     
-        
+        
         English (India)
         
     
     
-        
+        
         English (Jamaica)
         
     
     
-        
+        
         English (Namibia)
         
     
     
-        
+        
         English (Nigeria)
         
     
     
-        
+        
         English (New Zealand)
         
     
     
-        
+        
         English (Philippines)
         
     
     
-        
+        
         English (Singapore)
         
     
     
-        
+        
         English (Trinidad/Tobago)
         
     
     
-        
+        
         English (United States)
         
     
     
-        
+        
         English (United States, Large)
         This dictionary contains larger vocabulary.
         
     
     
-        
+        
         English (South Africa)
         
     
     
-        
+        
         English (Zimbabwe)
         
     
     
-        
+        
         Esperanto
         
     
     
-        
+        
         Spanish
         
     
     
-        
+        
         Spanish (Argentina)
         
     
     
-        
+        
         Spanish (Bolivia)
         
     
     
-        
+        
         Spanish (Chile)
         
     
     
-        
+        
         Spanish (Colombia)
         
     
     
-        
+        
         Spanish (Costa Rica)
         
     
     
-        
+        
         Spanish (Cuba)
         
     
     
-        
+        
         Spanish (Dominican Republic)
         
     
     
-        
+        
         Spanish (Ecuador)
         
     
     
-        
+        
         Spanish (Spain)
         
     
     
-        
+        
         Spanish (Guatemala)
         
     
     
-        
+        
         Spanish (Honduras)
         
     
     
-        
+        
         Spanish (Mexico)
         
     
     
-        
+        
         Spanish (Nicaragua)
         
     
     
-        
+        
         Spanish (Panama)
         
     
     
-        
+        
         Spanish (Peru)
         
     
     
-        
+        
         Spanish (Puerto Rico)
         
     
     
-        
+        
         Spanish (Paraguay)
         
     
     
-        
+        
         Spanish (El Savador)
         
     
     
-        
+        
         Spanish (United States)
         
     
     
-        
+        
         Spanish (Uruguay)
         
     
     
-        
+        
         Spanish (Venezuela)
         
     
     
-        
+        
         Estonian
         
     
     
-        
+        
         Estonian (Estonia)
         
     
     
-        
+        
         Basque
         
     
     
-        
+        
         Basque (Spain)
         
     
     
-        
+        
         Basque (France)
         
     
     
-        
-        
+        
+        
         Finnish
         
     
     
-        
+        
         Faroese
         
     
     
-        
+        
         Faroese (Faroe Islands)
         
     
     
-        
-        
+        
+        
         French
         
     
     
-        
+        
         French (Belgium)
         
     
     
-        
+        
         French (Catalan)
         
     
     
-        
+        
         French (Switzerland)
         
     
     
-        
+        
         French (France)
         
     
     
-        
+        
         French (Luxemburg)
         
     
     
-        
+        
         French (Monaco)
         
     
     
-        
+        
         Irish
         
     
     
-        
+        
         Gaelic
         
     
     
-        
+        
         Gaelic (United Kingdom {Scots})
         
     
     
-        
+        
         Galician
         
     
     
-        
+        
         Galician (Spain)
         
     
     
-        
-        
+        
+        
         Guarani
         
     
     
-        
-        
+        
+        
         Guarani (Paraguay)
         
     
     
-        
+        
         Gujarati
         
     
     
-        
+        
         Gujarati (India)
         
     
     
-        
+        
         Hebrew
         
     
     
-        
+        
         Hebrew (Israel)
         
     
     
-        
+        
         Hindi
         
     
     
-        
+        
         Hindi (India)
         
     
     
-        
+        
         Croatian
         
     
     
-        
+        
         Croatian (Croatia)
         
     
     
-        
+        
         Hungarian
         
     
     
-        
+        
         Hungarian (Hungary)
         
     
     
-        
+        
         Armenian
         
     
     
-        
+        
         Armenian (Armenia)
         
     
     
-        
+        
         Indonesian
         
     
     
-        
+        
         Indonesian (Indonesia)
         
     
     
-        
+        
         Mongolian
         
     
     
-        
+        
         Mongolian (Mongolia)
         
     
     
-        
+        
         Tagalog
         
     
     
-        
-        
+        
+        
         Medievia {Custom codec for that MUD}
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         hh:mm:ss.zzz 
         This represents the format of the timestamps shown alongside the texts in a console and might require translation for a few locales; the content is as per QDateTime::toString(...) and needs to follow the rules for that function as well as being suitable for the translation locale.
         
     
     
-        
+        
         ------------ 
         This represents the format of the timestamps shown for lines that do not have a timestamp in a console that is showing them. If localised this should be set to the same format and length as the smTimeStampFormat:
         
     
     
-        
+        
         %1 (Main Window)
         
     
     
-        
+        
         %1 (Detached)
         
     
     
-        
+        
         Switch games with the keyboard
         Title of a balloon pointing out the newly added profile tab switching shortcuts
         
     
     
-        
+        
         Press %1 to cycle through your open games, or %2 to %3 to jump straight to one. You can change these keys in the preferences.
         %1, %2 and %3 are keyboard shortcuts, e.g. Ctrl+Tab, Ctrl+1 and Ctrl+9 (Control-Tab, Command-1 and Command-9 on macOS)
         
     
     
-        
+        
         Map - %1
         
     
     
-        
+        
         [ CHAT ]  - Auto-starting MMCP Server on port %1.
         
     
     
-        
-        
+        
+        
         Unmute all media
         
     
     
-        
+        
         [ INFO ]  - Mudlet and game sounds are muted. Use "%1" to unmute.
         
     
     
-        
+        
         [ INFO ]  - Mudlet and game sounds are unmuted. Use "%1" to mute.
         
     
     
-        
+        
         [ INFO ]  - Compact input line set. Press "%1" to show bottom-right buttons again.
         Here %1 will be replaced with the keyboard shortcut, default is ALT+L.
         
     
     
-        
+        
         Detach Tab "%1"
         
     
     
-        
+        
         Show Connection Indicators on Tabs
         
     
     
-        
+        
         <p>About Mudlet</p><p><i>%n update(s) is/are now available!</i><p>
         This is the tooltip text for the 'About' Mudlet main toolbar button when it has been changed by adding a menu which now contains the original 'About Mudlet' action and a new one to access the manual update process
         
@@ -14643,7 +14664,7 @@ There is NO WARRANTY, to the extent permitted by law.
         
     
     
-        
+        
         Review %n update(s)...
         Review update(s) menu item, %n is the count of how many updates are available
         
@@ -14651,7 +14672,7 @@ There is NO WARRANTY, to the extent permitted by law.
         
     
     
-        
+        
         Review the update(s) available...
         Tool-tip for review update(s) menu item, given that the count of how many updates are available is already shown in the menu, the %n parameter that is that number need not be used here
         
@@ -14659,853 +14680,853 @@ There is NO WARRANTY, to the extent permitted by law.
         
     
     
-        
+        
         Icelandic
         
     
     
-        
-        
-        
+        
+        
+        
         Mute sounds from the game (MCMP, MSP)
         
     
     
-        
+        
         Icelandic (Iceland)
         
     
     
-        
+        
         Italian
         
     
     
-        
+        
         Italian (Switzerland)
         
     
     
-        
+        
         Italian (Italy)
         
     
     
-        
+        
         Kazakh
         
     
     
-        
+        
         Kazakh (Kazakhstan)
         
     
     
-        
+        
         Kurmanji
         
     
     
-        
+        
         Kurmanji {Latin-alphabet Kurdish}
         
     
     
-        
+        
         Korean
         
     
     
-        
+        
         Korean (South Korea)
         
     
     
-        
+        
         Kurdish
         
     
     
-        
+        
         Kurdish (Syria)
         
     
     
-        
+        
         Kurdish (Turkey)
         
     
     
-        
+        
         Latin
         
     
     
-        
+        
         Luxembourgish
         
     
     
-        
+        
         Luxembourgish (Luxembourg)
         
     
     
-        
+        
         Lao
         
     
     
-        
+        
         Lao (Laos)
         
     
     
-        
+        
         Lithuanian
         
     
     
-        
+        
         Lithuanian (Lithuania)
         
     
     
-        
+        
         Latvian
         
     
     
-        
+        
         Latvian (Latvia)
         
     
     
-        
+        
         Malayalam
         
     
     
-        
+        
         Malayalam (India)
         
     
     
-        
+        
         Norwegian Bokmål
         
     
     
-        
+        
         Norwegian Bokmål (Norway)
         
     
     
-        
+        
         Nepali
         
     
     
-        
+        
         Nepali (Nepal)
         
     
     
-        
+        
         Dutch
         
     
     
-        
+        
         Dutch (Netherlands Antilles)
         
     
     
-        
+        
         Dutch (Aruba)
         
     
     
-        
+        
         Dutch (Belgium)
         
     
     
-        
+        
         Dutch (Netherlands)
         
     
     
-        
+        
         Dutch (Suriname)
         
     
     
-        
+        
         Norwegian Nynorsk
         
     
     
-        
+        
         Norwegian Nynorsk (Norway)
         
     
     
-        
+        
         Occitan
         
     
     
-        
+        
         Occitan (France)
         
     
     
-        
+        
         Polish
         
     
     
-        
+        
         Polish (Poland)
         
     
     
-        
+        
         Portuguese
         
     
     
-        
+        
         Portuguese (Brazil)
         
     
     
-        
+        
         Portuguese (Portugal)
         
     
     
-        
+        
         Romanian
         
     
     
-        
+        
         Romanian (Romania)
         
     
     
-        
+        
         Russian
         
     
     
-        
+        
         Russian (Russia)
         
     
     
-        
+        
         Northern Sami
         
     
     
-        
+        
         Northern Sami (Finland)
         
     
     
-        
+        
         Northern Sami (Norway)
         
     
     
-        
+        
         Northern Sami (Sweden)
         
     
     
-        
+        
         Sinhala
         
     
     
-        
+        
         Sinhala (Sri Lanka)
         
     
     
-        
+        
         Slovak
         
     
     
-        
+        
         Slovak (Slovakia)
         
     
     
-        
+        
         Slovenian
         
     
     
-        
+        
         Slovenian (Slovenia)
         
     
     
-        
+        
         Somali
         
     
     
-        
+        
         Somali (Somalia)
         
     
     
-        
+        
         Albanian
         
     
     
-        
+        
         Albanian (Albania)
         
     
     
-        
+        
         Serbian
         
     
     
-        
+        
         Serbian (Montenegro)
         
     
     
-        
+        
         Serbian (Serbia)
         
     
     
-        
+        
         Serbian (Serbia - Latin-alphabet)
         
     
     
-        
+        
         Serbian (former state of Yugoslavia)
         
     
     
-        
+        
         Swati
         
     
     
-        
+        
         Swati (Swaziland)
         
     
     
-        
+        
         Swati (South Africa)
         
     
     
-        
+        
         Swedish
         
     
     
-        
+        
         Swedish (Sweden)
         
     
     
-        
+        
         Swedish (Finland)
         
     
     
-        
+        
         Swahili
         
     
     
-        
+        
         Swahili (Kenya)
         
     
     
-        
+        
         Swahili (Tanzania)
         
     
     
-        
+        
         Turkish
         
     
     
-        
+        
         Telugu
         
     
     
-        
+        
         Telugu (India)
         
     
     
-        
+        
         Thai
         
     
     
-        
+        
         Thai (Thailand)
         
     
     
-        
+        
         Tigrinya
         
     
     
-        
+        
         Tigrinya (Eritrea)
         
     
     
-        
+        
         Tigrinya (Ethiopia)
         
     
     
-        
+        
         Turkmen
         
     
     
-        
+        
         Turkmen (Turkmenistan)
         
     
     
-        
+        
         Tswana
         
     
     
-        
+        
         Tswana (Botswana)
         
     
     
-        
+        
         Tswana (South Africa)
         
     
     
-        
+        
         Tsonga
         
     
     
-        
+        
         Tsonga (South Africa)
         
     
     
-        
+        
         Ukrainian
         
     
     
-        
+        
         Ukrainian (Ukraine)
         
     
     
-        
+        
         Uzbek
         
     
     
-        
+        
         Uzbek (Uzbekistan)
         
     
     
-        
+        
         Venda
         
     
     
-        
+        
         Vietnamese
         
     
     
-        
+        
         Vietnamese (Vietnam)
         
     
     
-        
+        
         Walloon
         
     
     
-        
+        
         Xhosa
         
     
     
-        
+        
         Yiddish
         
     
     
-        
+        
         Chinese
         
     
     
-        
+        
         Chinese (China - simplified)
         
     
     
-        
+        
         Chinese (Taiwan - traditional)
         
     
     
-        
+        
         Zulu
         
     
     
-        
+        
         ASCII (Basic)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         UTF-8 (Recommended)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         EUC-KR (Korean)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         GBK (Chinese)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         GB18030 (Chinese)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         Big5-ETen (Taiwan)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         Big5-HKSCS (Hong Kong)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         ISO 8859-1 (Western European)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         ISO 8859-2 (Central European)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         ISO 8859-3 (South European)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         ISO 8859-4 (Baltic)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         ISO 8859-5 (Cyrillic)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         ISO 8859-6 (Arabic)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         ISO 8859-7 (Greek)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         ISO 8859-8 (Hebrew Visual)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         ISO 8859-9 (Turkish)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         ISO 8859-10 (Nordic)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         ISO 8859-11 (Latin/Thai)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         ISO 8859-13 (Baltic)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         ISO 8859-14 (Celtic)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         ISO 8859-15 (Western)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         ISO 8859-16 (Romanian)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
-        
+        
+        
         CP437 (OEM Font)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
-        
+        
+        
         CP667 (Mazovia)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
-        
+        
+        
         CP737 (DOS Greek)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         CP850 (Western Europe)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         CP866 (Cyrillic/Russian)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
-        
+        
+        
         CP869 (DOS Greek 2)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         CP1161 (Latin/Thai)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         KOI8-R (Cyrillic)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         KOI8-U (Cyrillic/Ukrainian)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         MACINTOSH
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         WINDOWS-1250 (Central European)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         WINDOWS-1251 (Cyrillic)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         WINDOWS-1252 (Western)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         WINDOWS-1253 (Greek)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         WINDOWS-1254 (Turkish)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         WINDOWS-1255 (Hebrew)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         WINDOWS-1256 (Arabic)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         WINDOWS-1257 (Baltic)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         WINDOWS-1258 (Vietnamese)
         Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)
         
     
     
-        
+        
         Update check failed. Error: %1
 
         
     
     
-        
+        
         Could not open profile file: %1
         
     
     
-        
+        
         [ ERROR ] - Something went wrong loading your Mudlet profile and it could not be loaded.
 Try loading an older version in 'Connect - Options - Profile history' or double-check that %1 looks correct.
         %1 is the path and file name (i.e. the location) of the problem fil
         
     
     
-        
+        
         [ INFO ]  - Mudlet and game sounds are muted.
         
     
     
-        
+        
         [ INFO ]  - Mudlet and game sounds are unmuted.
         
     
     
-        
+        
         Unmute sounds from Mudlet (Triggers, Scripts, etc.)
         
     
     
-        
+        
         Unmute sounds from the game (MCMP, MSP)
         
     
     
-        
+        
         Cannot load a replay as one is already in progress in this or another profile.
         
     
     
-        
+        
         Replay each step with a shorter time interval between steps.
         
     
     
-        
+        
         Replay each step with a longer time interval between steps.
         
     
     
-        
+        
         Hide tray icon
         
     
     
-        
+        
         Quit Mudlet
         
     
     
-        
-        
+        
+        
         Main Toolbar
         Name of the main toolbar shown in Qt's built-in toolbar toggle menus and right-click context menus
 ----------
@@ -15513,304 +15534,304 @@ Toggle action in the tab bar context menu to show/hide the main toolbar
     
     
-        
-        
-        
+        
+        
+        
         Connect
         
     
     
-        
-        
+        
+        
         Disconnect
         
     
     
-        
+        
         Open Discord
         
     
     
-        
+        
         Triggers
         
     
     
-        
+        
         hh:mm:ss
         Formatting string for elapsed time display in replay playback - see QDateTime::toString(const QString&) for the gory details...!
         
     
     
-        
+        
         Show and edit triggers
         
     
     
-        
+        
         Aliases
         
     
     
-        
+        
         Show and edit aliases
         
     
     
-        
+        
         Timers
         
     
     
-        
+        
         Show and edit timers
         
     
     
-        
+        
         Buttons
         
     
     
-        
+        
         Show and edit easy buttons
         
     
     
-        
+        
         Scripts
         
     
     
-        
+        
         Show and edit scripts
         
     
     
-        
+        
         Keys
         
     
     
-        
+        
         Show and edit keys
         
     
     
-        
+        
         Variables
         
     
     
-        
+        
         Show and edit Lua variables
         
     
     
-        
+        
         Map
         
     
     
-        
+        
         Show/hide the map
         
     
     
-        
+        
         Manual
         
     
     
-        
+        
         Browse reference material and documentation
         
     
     
-        
+        
         Settings
         
     
     
-        
+        
         See and edit profile preferences
         
     
     
-        
-        
+        
+        
         Notepad
         
     
     
-        
+        
         Open a notepad that you can store your notes in
         
     
     
-        
-        
+        
+        
         Packages
         
     
     
-        
+        
         Package Manager
         
     
     
-        
+        
         Module Manager
         
     
     
-        
+        
         Package Exporter
         
     
     
-        
+        
         Replay
         
     
     
-        
-        
+        
+        
         Reconnect
         
     
     
-        
+        
         Disconnects you from the game and connects once again
         
     
     
-        
-        
+        
+        
         MultiView
         
     
     
-        
+        
         Splits the Mudlet screen to show multiple profiles at once; disabled when less than two are loaded.
         Same text is used in 2 places.
         
     
     
-        
-        
+        
+        
         About
         
     
     
-        
+        
         Interlingue
         , formerly known as Occidental, and not to be mistaken for Interlingua
         
     
     
-        
+        
         Shtokavian
         This code seems to be the identifier for the prestige dialect for several languages used in the region of the former Yugoslavia state without a state indication
         
     
     
-        
+        
         Shtokavian (former state of Yugoslavia)
         This code seems to be the identifier for the prestige dialect for several languages used in the region of the former Yugoslavia state with a (withdrawn from ISO 3166) state indication
         
     
     
-        
+        
         Turkish (Turkey)
         
     
     
-        
-        
+        
+        
         Vietnamese (DauCu variant - old-style diacritics)
         
     
     
-        
-        
+        
+        
         Vietnamese (DauMoi variant - new-style diacritics)
         
     
     
-        
-        
-        
+        
+        
+        
         Load a Mudlet replay.
         
     
     
-        
+        
         Central Debug Console
         
     
     
-        
-        
+        
+        
         Toggle Full Screen View
         
     
     
-        
-        
+        
+        
         <p>Load a Mudlet replay.</p><p><i>Disabled until a profile is loaded.</i></p>
         
     
     
-        
+        
         %1 - notes
         
     
     
-        
+        
         Select Replay
         
     
     
-        
+        
         *.dat
         
     
     
-        
+        
         [  OK  ]  - Profile "%1" loaded in offline mode.
         
     
     
-        
+        
         Faster
         
     
     
-        
+        
         Slower
         
     
     
-        
-        
-        
+        
+        
+        
         Speed: X%1
         
     
     
-        
-        
+        
+        
         Time: %1
         
     
     
-        
+        
         Update installed - restart to apply
         
     
     
-        
+        
         [ WARN ]  - Cannot perform replay, another one may already be in progress,
 try again when it has finished.
         

From a989d2d49d6e6ee2a416f27e84b5c0f0c1571c9f Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 31 Jul 2026 20:21:40 +0200
Subject: [PATCH 032/155] Infrastructure: bump 3rdparty/sentry-native from
 `a182754` to `a99d64e` (#9564)

Bumps
[3rdparty/sentry-native](https://github.com/getsentry/sentry-native)
from `a182754` to `a99d64e`.


Commits

    

  • a99d64e
release: 0.16.0
    • 

  • 0485b9b
feat(scope): Scoped user feedback capture (#1916)
    • 

  • 7212f08
feat(feedback): Enrich user feedback with scope data (#1915)
    • 

  • 8c4d7b0
fix: include before_send attachments with local scopes (#1922)
    • 

  • c611de6
chore(native): drop experimental label (#1919)
    • 

  • 65e884a
test(wer): add AppX integration coverage (#1914)
    • 

  • 6f31476
test(native): add stack overflow integration coverage (#1913)
    • 

  • 60ae27d
perf(crashpad): Send event updates over IPC (#1841)
    • 

  • bbcbf07
fix: apply default thread stack guarantee in static builds and the
native bac...
    • 

  • b5cd30f
feat(native): implement
SENTRY_HANDLER_STRATEGY_CHAIN_AT_START (#1912)
    • 

  • Additional commits viewable in compare
view
    • 








Dependabot will resolve any conflicts with this PR as long as you don't
alter it yourself. You can also trigger a rebase manually by commenting
`@dependabot rebase`.

[//]: # (dependabot-automerge-start)
[//]: # (dependabot-automerge-end)

---



Dependabot commands and options



You can trigger Dependabot actions by commenting on this PR:
- `@dependabot rebase` will rebase this PR
- `@dependabot recreate` will recreate this PR, overwriting any edits
that have been made to it
- `@dependabot show  ignore conditions` will show all
of the ignore conditions of the specified dependency
- `@dependabot ignore this major version` will close this PR and stop
Dependabot creating any more for this major version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this minor version` will close this PR and stop
Dependabot creating any more for this minor version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this dependency` will close this PR and stop
Dependabot creating any more for this dependency (unless you reopen the
PR or upgrade to it yourself)





Signed-off-by: dependabot[bot] 
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 3rdparty/sentry-native | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/3rdparty/sentry-native b/3rdparty/sentry-native
index a1827544e..a99d64efb 160000
--- a/3rdparty/sentry-native
+++ b/3rdparty/sentry-native
@@ -1 +1 @@
-Subproject commit a1827544e2da7e50517615003288c25380f8d457
+Subproject commit a99d64efb8d5c614bbcfdab7c7dc737530e5ef7d

From dfdcb137f543f3e2af888211a6bc96a0f0f6c581 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 31 Jul 2026 20:22:33 +0200
Subject: [PATCH 033/155] Infrastructure: bump github/codeql-action from 4 to
 4.37.3 (#9565)

Bumps [github/codeql-action](https://github.com/github/codeql-action)
from 4 to 4.37.3.


Release notes

Sourced from github/codeql-action's
releases.




v4.37.3


No user facing changes.


v4.37.2


    

  • The new address format for the config-file input that
was introduced in CodeQL Action 4.37.0 is now enabled by default. In
addition to the format described there, the remote= prefix
can now be used to explicitly indicate that the input refers to a remote
file. All previous input formats continue to be accepted as well. #4023
    • 

  • The CodeQL Action can now make use of configured
private registries in Default Setup to retrieve CodeQL configuration
files from remote repositories that require authentication. This will
allow customers to store their CodeQL configuration in a single
repository that can then be referenced by Default Setup workflows in
other repositories. We expect to roll this and other, related changes
out to everyone in July. #4007
    • 



v4.37.1


    

  • Upcoming breaking change: Add a deprecation warning for
customers using CodeQL version 2.20.6 and earlier. These versions of
CodeQL were discontinued on 1 July 2026 alongside GitHub Enterprise
Server 3.16, and will be unsupported by the next minor release of the
CodeQL Action. #3956
    • 

  • Update default CodeQL bundle version to 2.26.1.
#4019
    • 



v4.37.0


    

  • Update default CodeQL bundle version to 2.26.0.
#3995
    • 

  • In addition to the existing input format, the
config-file input for the codeql-action/init
step will soon support a new [owner/]repo[@ref][:path]
format. All components except the repository name are optional. If
omitted, owner defaults to the same owner as the repository
the analysis is running for, ref to main, and
path to .github/codeql-action.yaml. Support
for this format ships in this version of the CodeQL Action, but will
only be enabled over the coming weeks. #3973
    • 



v4.36.3


No user facing changes.


v4.36.2


    

  • Cache CodeQL CLI version information across Actions steps. #3943
    • 

  • Reduce requests while waiting for analysis processing by using
exponential backoff when polling SARIF processing status. #3937
    • 

  • Update default CodeQL bundle version to 2.25.6.
#3948
    • 



v4.36.1


No user facing changes.


v4.36.0


    

  • Breaking change: Bump the minimum required CodeQL bundle
version to 2.19.4. #3894
    • 

  • Add support for SHA-256 Git object IDs. #3893
    • 

  • Update default CodeQL bundle version to 2.25.5.
#3926
    • 



v4.35.5


    

  • We have improved how the JavaScript bundles for the CodeQL Action
are generated to avoid duplication across bundles and reduce the size of
the repository by around 70%. This should have no effect on the runtime
behaviour of the CodeQL Action. #3899
    • 

  • For performance and accuracy reasons, improved
incremental analysis will now only be enabled on a pull request when
diff-informed analysis is also enabled for that run. If diff-informed
analysis is unavailable (for example, because the PR diff ranges could
not be computed), the action will fall back to a full analysis. #3791
    • 

  • If multiple inputs are provided for the GitHub-internal
analysis-kinds input, only code-scanning will
be enabled. The analysis-kinds input is experimental, for
GitHub-internal use only, and may change without notice at any time. #3892
    • 

  • Added an experimental change which, when running a Code Scanning
analysis for a PR with improved
incremental analysis enabled, prefers CodeQL CLI versions that have
a cached overlay-base database for the configured languages. This speeds
up analysis for a repository when there is not yet a cached overlay-base
database for the latest CLI version. We expect to roll this change out
to everyone in May. #3880
    • 



v4.35.4


    

  • Update default CodeQL bundle version to 2.25.4.
#3881
    • 



v4.35.3


    

  • Upcoming breaking change: Add a deprecation warning for
customers using CodeQL version 2.19.3 and earlier. These versions of
CodeQL were discontinued on 9 April 2026 alongside GitHub Enterprise
Server 3.15, and will be unsupported by the next minor release of the
CodeQL Action. #3837
    • 

  • Configurations for private registries that use Cloudsmith or GCP
OIDC are now accepted. #3850
    • 

  • Best-effort connection tests for private registries now use
GET requests instead of HEAD for better
compatibility with various registry implementations. For NuGet feeds,
the test is now always performed against the service index. #3853
    • 

  • Fixed a bug where two diagnostics produced within the same
millisecond could overwrite each other on disk, causing one of them to
be lost. #3852
    • 

  • Update default CodeQL bundle version to 2.25.3.
#3865
    • 



v4.35.2


    

  • The undocumented TRAP cache cleanup feature that could be enabled
using the CODEQL_ACTION_CLEANUP_TRAP_CACHES environment
variable is deprecated and will be removed in May 2026. If you are
affected by this, we recommend disabling TRAP caching by passing the
trap-caching: false input to the init Action.
#3795
    • 

  • The Git version 2.36.0 requirement for improved incremental analysis
now only applies to repositories that contain submodules. #3789
    • 






... (truncated)





Changelog

Sourced from github/codeql-action's
changelog.




4.37.3 - 22 Jul 2026


No user facing changes.


4.37.2 - 21 Jul 2026


    

  • The new address format for the config-file input that
was introduced in CodeQL Action 4.37.0 is now enabled by default. In
addition to the format described there, the remote= prefix
can now be used to explicitly indicate that the input refers to a remote
file. All previous input formats continue to be accepted as well. #4023
    • 

  • The CodeQL Action can now make use of configured
private registries in Default Setup to retrieve CodeQL configuration
files from remote repositories that require authentication. This will
allow customers to store their CodeQL configuration in a single
repository that can then be referenced by Default Setup workflows in
other repositories. We expect to roll this and other, related changes
out to everyone in July. #4007
    • 



4.37.1 - 16 Jul 2026


    

  • Upcoming breaking change: Add a deprecation warning for
customers using CodeQL version 2.20.6 and earlier. These versions of
CodeQL were discontinued on 1 July 2026 alongside GitHub Enterprise
Server 3.16, and will be unsupported by the next minor release of the
CodeQL Action. #3956
    • 

  • Update default CodeQL bundle version to 2.26.1.
#4019
    • 



4.37.0 - 08 Jul 2026


    

  • Update default CodeQL bundle version to 2.26.0.
#3995
    • 

  • In addition to the existing input format, the
config-file input for the codeql-action/init
step will soon support a new [owner/]repo[@ref][:path]
format. All components except the repository name are optional. If
omitted, owner defaults to the same owner as the repository
the analysis is running for, ref to main, and
path to .github/codeql-action.yaml. Support
for this format ships in this version of the CodeQL Action, but will
only be enabled over the coming weeks. #3973
    • 



4.36.3 - 01 Jul 2026


No user facing changes.







Commits

    

  • e4fba86
Merge pull request #4031
from github/update-v4.37.3-72f6a9da0
    • 

  • fb50ab5
Update changelog for v4.37.3
    • 

  • 72f6a9d
Merge pull request #4030
from github/mbg/fix/no-proxy
    • 

  • 3b5ee58
Use default request options instead of
undefined
    • 

  • bfb6be4
Merge pull request #4028
from github/mergeback/v4.37.2-to-main-e0647621
    • 

  • 526ab84
Rebuild
    • 

  • d6217b9
Update changelog and version after v4.37.2
    • 

  • e064762
Merge pull request #4027
from github/update-v4.37.2-385bcdc5a
    • 

  • e0faed8
Add a couple of change notes
    • 

  • 73aad0e
Update changelog for v4.37.2
    • 

  • Additional commits viewable in compare
view
    • 








[![Dependabot compatibility
score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=github/codeql-action&package-manager=github_actions&previous-version=4&new-version=4.37.3)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores)

Dependabot will resolve any conflicts with this PR as long as you don't
alter it yourself. You can also trigger a rebase manually by commenting
`@dependabot rebase`.

[//]: # (dependabot-automerge-start)
[//]: # (dependabot-automerge-end)

---



Dependabot commands and options



You can trigger Dependabot actions by commenting on this PR:
- `@dependabot rebase` will rebase this PR
- `@dependabot recreate` will recreate this PR, overwriting any edits
that have been made to it
- `@dependabot show  ignore conditions` will show all
of the ignore conditions of the specified dependency
- `@dependabot ignore this major version` will close this PR and stop
Dependabot creating any more for this major version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this minor version` will close this PR and stop
Dependabot creating any more for this minor version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this dependency` will close this PR and stop
Dependabot creating any more for this dependency (unless you reopen the
PR or upgrade to it yourself)





Signed-off-by: dependabot[bot] 
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/codeql-analysis.yml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/codeql-analysis.yml b/.github/workflows/codeql-analysis.yml
index 4604a98b9..986688f5e 100644
--- a/.github/workflows/codeql-analysis.yml
+++ b/.github/workflows/codeql-analysis.yml
@@ -88,7 +88,7 @@ jobs:
 
     # Initializes the CodeQL tools for scanning.
     - name: Initialize CodeQL
-      uses: github/codeql-action/init@v4
+      uses: github/codeql-action/init@v4.37.3
       with:
         config-file: ./.github/codeql/codeql-config.yml
         languages: ${{ matrix.language }}
@@ -156,7 +156,7 @@ jobs:
         NINJA_STATUS: '[%f/%t %o/sec] '
 
     - name: Perform CodeQL Analysis
-      uses: github/codeql-action/analyze@v4
+      uses: github/codeql-action/analyze@v4.37.3
       with:
         category: "/language:${{ matrix.language }}"
         upload: false
@@ -171,6 +171,6 @@ jobs:
         output: sarif-results/${{ matrix.language }}.sarif
 
     - name: Upload SARIF
-      uses: github/codeql-action/upload-sarif@v4
+      uses: github/codeql-action/upload-sarif@v4.37.3
       with:
         sarif_file: sarif-results/${{ matrix.language }}.sarif

From 1f00cd0ad79b258eed6105227e7ce09d7f6a72a4 Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Sun, 2 Aug 2026 13:04:21 +0200
Subject: [PATCH 034/155] infrastructure: decouple profile management (Host)
 from UI dialogs (#9514)

#### Brief overview of PR changes/additions
- Removes all raw Qt Widgets usage from `Host.{h,cpp}` so the
`mudlet_core` Qt Widgets audit (`cmake/audit-core-widgets.sh`, added in
#9508) drops both files to zero: the offending-file count goes from 158
to 156 and both move to the "Clean files" list. (The committed
report/baseline are intentionally not regenerated here, to avoid
conflicts with sibling wave-2 PRs.)
- Follows the seam pattern established by #9507: the core (`Host`) emits
Qt signals carrying already-translated `tr()` strings, and the frontend
(`TMainConsole`/`mudlet`) owns the actual widgets.
- The dockable map widget (`mpDockableMapWidget`, a `QDockWidget`) moved
from `Host` to the profile's own `TMainConsole`.
`TMainConsole::createMapperDock()` constructs it and the console's
destructor disposes of it. `Host` still drives it through
`mpConsole->mpDockableMapWidget` (an already out-of-scope pointer per
the split plan) but no longer names any Qt Widgets type. The external
accessors in `mudlet.cpp`/`TDetachedWindow.cpp` gained an `mpConsole &&`
null-guard.
- The mapping-script reminder and package-unpacking progress dialogs are
now shown by the frontend in response to
`signal_showMapperScriptReminder` / `signal_showUnpackingProgress` /
`signal_hideUnpackingProgress`, wired up in
`mudlet::addConsoleForNewHost`.
- `TDockWidget` now sets its own dock features (moved out of
`Host::openWindow`); `Host::setBorders` uses
`QCoreApplication::sendEvent`; and the user-window scrollbar is hidden
via `TConsole::setScrollBarVisible()` instead of reaching into the raw
`QScrollBar`.
- Adds `HostWidgetDecouplingTest` (ephemeral port-0 stub + a real
profile, modelled on `TelnetTlsPromptTest`): verifies the map dock is
created and owned by the console, that `setMapperTitle` routes through
it, that the reminder dialog is raised, and that the unpacking dialog is
replaced then disposed (asserting the replaced dialog is destroyed, not
leaked). Two further tests cover the seams end to end: a real package
install has to reach the dialog through the `addConsoleForNewHost`
wiring, and closing a profile has to take the console-owned map dock
with it.

#### Motivation for adding to Mudlet
Continues the re-scoped libmudlet plan (a Qt Widgets-free `mudlet_core`
for headless use, testability and WASM). `Host` is the second concrete
extraction after `cTelnet` (#9507) and copies its template so later
extractions can follow the same shape.

#### Other info (issues closed, discussion etc)
Part of #8681 / #9011. Behavior-preserving: dialogs keep the same
modality/defaults and all strings stay in `Host`'s translation context,
so existing translations are unaffected. One intentional behaviour
change: failing to load the cosmetic unpacking/reminder `.ui` now warns
and no-ops instead of aborting the package install (a fire-and-forget
signal cannot fail the install back to `Host`), which is strictly
better. The dock's `deleteLater()` cleanup moved from `Host`'s
destructor to `TMainConsole`'s.

Reviewed with the code-reviewer and silent-failure-hunter agents; both
flagged a leak in the unpacking-dialog replace path (parentless dialog
`close()`d instead of `deleteLater()`d) and the missing destructor
cleanup, both fixed and now covered by the test. Expect the `mudlet.cpp`
`addConsoleForNewHost` wiring to conflict with sibling wave-2 PRs; that
is fine.

Assisted-by: Claude:claude-opus-4-8

**Test case:** Open a profile and open the mapper via the Map toolbar
button - it appears docked as before, and its title can be changed with
`setMapperTitle(...)`. Install a `.zip`/`.mpackage` from the package
manager (a normal package, not a module-from-UI and not a script/quiet
install) and confirm the "Unpacking..." progress dialog shows and then
closes. On a profile with no mapper script, open the mapper and confirm
the "you have no mapper script" reminder dialog appears and its link
opens the mapping scripts page.



#### Demo (before & after)

Parity check that the moved dialog/dock flows behave identically before
(development) and after this PR: the package-install "Unpacking..."
dialog and the dockable map widget.


https://github.com/user-attachments/assets/41579b67-7de1-463b-b642-bd7660b52431
---
 src/Host.cpp                                  | 116 ++----
 src/Host.h                                    |  10 +-
 src/TDetachedWindow.cpp                       |  30 +-
 src/TDockWidget.cpp                           |   1 +
 src/TMainConsole.cpp                          |  96 ++++-
 src/TMainConsole.h                            |   8 +
 src/mudlet.cpp                                |  20 +-
 test/functional_tests/CMakeLists.txt          |   4 +
 .../HostWidgetDecouplingTest.cpp              | 372 ++++++++++++++++++
 9 files changed, 546 insertions(+), 111 deletions(-)
 create mode 100644 test/functional_tests/HostWidgetDecouplingTest.cpp

diff --git a/src/Host.cpp b/src/Host.cpp
index f0578d7e3..167e32419 100644
--- a/src/Host.cpp
+++ b/src/Host.cpp
@@ -62,17 +62,19 @@
 #include 
 #include 
 #include 
-#include 
+#include 
 #include 
 #include 
 #include 
 #include 
-#include 
+#include 
 #include 
+#include 
 #include 
 #include 
 #include 
 #include 
+#include 
 #include 
 #include 
 #include 
@@ -243,7 +245,6 @@ Host::Host(int port, const QString& hostname, const QString& login, const QStrin
 , mpMap(new TMap(this, hostname))
 , mpMedia(new TMedia(this, hostname))
 , mpAuth(new GMCPAuthenticator(this))
-, mpDockableMapWidget()
 , mTimerDebugOutputSuppressionInterval(QTime())
 , mSearchOptions(dlgTriggerEditor::SearchOption::SearchOptionNone)
 , mBufferSearchOptions(TConsole::SearchOption::SearchOptionNone)
@@ -454,11 +455,6 @@ Host::~Host()
 
     mStopWatchMap.clear();
 
-    if (mpDockableMapWidget) {
-        mpDockableMapWidget->deleteLater();
-    }
-
-
     mErrorLogStream.flush();
     mErrorLogFile.close();
     // Since this is a destructor, it's risky to rely on member variables within the destructor itself.
@@ -1377,26 +1373,7 @@ bool Host::checkForMappingScript()
 void Host::check_for_mappingscript()
 {
     if (!checkForMappingScript()) {
-        QUiLoader loader;
-
-        QFile file(":/ui/lacking_mapper_script.ui");
-        if (!file.open(QFile::ReadOnly)) {
-            qWarning() << "Host: failed to open lacking_mapper_script.ui for reading:" << file.errorString();
-            return;
-        }
-
-        auto dialog = dynamic_cast(loader.load(&file, mudlet::self()));
-        file.close();
-        if (!dialog) {
-            // could not load / not a QDialog
-            return;
-        }
-
-        connect(dialog, &QDialog::accepted, mudlet::self(), &mudlet::slot_openMappingScriptsPage);
-
-        dialog->show();
-        dialog->raise();
-        dialog->activateWindow();
+        emit signal_showMapperScriptReminder();
     }
 }
 
@@ -2032,10 +2009,7 @@ std::pair Host::installPackage(const QString& fileName, enums::Pa
         return {true, QString()};
     }
 
-    // As the pointer to dialog is only used now WITHIN this method and this
-    // method can be re-entered, it is best to use a local rather than a class
-    // pointer just in case we accidentally re-enter this method in the future.
-    QDialog* pUnzipDialog = nullptr;
+    bool showedUnpackingDialog = false;
 
     QString actualFileName = fileName;
     std::unique_ptr tempFile;
@@ -2128,41 +2102,16 @@ std::pair Host::installPackage(const QString& fileName, enums::Pa
         // window-manager focus from the user's other applications - see
         // issue #9170.
         if (thing != enums::PackageModuleType::ModuleFromUI && !quiet) {
-            QUiLoader loader(this);
-            QFile uiFile(qsl(":/ui/package_manager_unpack.ui"));
-            if (!uiFile.open(QFile::ReadOnly)) {
-                qWarning() << "Host: failed to open package_manager_unpack.ui for reading:" << uiFile.errorString();
-                return {false, qsl("could not open unpacking progress dialog UI file")};
-            }
-            pUnzipDialog = dynamic_cast(loader.load(&uiFile, nullptr));
-            uiFile.close();
-            if (!pUnzipDialog) {
-                return {false, qsl("could not load unpacking progress dialog")};
-            }
-
-            auto* pLabel = pUnzipDialog->findChild(qsl("label"));
-            if (pLabel) {
-                if (thing != enums::PackageModuleType::Package) {
-                    pLabel->setText(tr("Unpacking module:\n\"%1\"\nplease wait...").arg(packageName));
-                } else {
-                    pLabel->setText(tr("Unpacking package:\n\"%1\"\nplease wait...").arg(packageName));
-                }
-            }
-            pUnzipDialog->hide(); // Must hide to change WindowModality
-            pUnzipDialog->setWindowTitle(tr("Unpacking"));
-            pUnzipDialog->setWindowModality(Qt::ApplicationModal);
-            pUnzipDialog->show();
-            qApp->processEvents();
-            pUnzipDialog->raise();
-            pUnzipDialog->repaint(); // Force a redraw
-            qApp->processEvents();   // Try to ensure we are on top of any other dialogs and freshly drawn
+            const QString message =
+                    (thing != enums::PackageModuleType::Package) ? tr("Unpacking module:\n\"%1\"\nplease wait...").arg(packageName) : tr("Unpacking package:\n\"%1\"\nplease wait...").arg(packageName);
+            emit signal_showUnpackingProgress(message, tr("Unpacking"));
+            showedUnpackingDialog = true;
         }
 
         auto unzipSuccessful = mudlet::unzip(actualFileName, _dest, _tmpDir);
 
-        if (pUnzipDialog) {
-            pUnzipDialog->deleteLater();
-            pUnzipDialog = nullptr;
+        if (showedUnpackingDialog) {
+            emit signal_hideUnpackingProgress();
         }
         if (!unzipSuccessful) {
             return {false, qsl("could not unzip package")};
@@ -3521,14 +3470,14 @@ void Host::setBufferSearchOptions(const TConsole::SearchOptions optionsState)
 
 std::pair Host::setMapperTitle(const QString& title)
 {
-    if (!mpDockableMapWidget) {
+    if (!mpConsole || !mpConsole->mpDockableMapWidget) {
         return {false, "no floating/dockable type map window found"};
     }
 
     if (title.isEmpty()) {
-        mpDockableMapWidget->setWindowTitle(tr("Map - %1").arg(mHostName));
+        mpConsole->mpDockableMapWidget->setWindowTitle(tr("Map - %1").arg(mHostName));
     } else {
-        mpDockableMapWidget->setWindowTitle(title);
+        mpConsole->mpDockableMapWidget->setWindowTitle(title);
     }
 
     return {true, QString()};
@@ -3676,7 +3625,6 @@ std::pair Host::openWindow(const QString& name, bool loadLayout,
         dockwidget = new TDockWidget(this, name);
         dockwidget->setObjectName(qsl("dockWindow_%1_%2").arg(hostName, name));
         dockwidget->setContentsMargins(0, 0, 0, 0);
-        dockwidget->setFeatures(QDockWidget::DockWidgetClosable | QDockWidget::DockWidgetMovable | QDockWidget::DockWidgetFloatable);
         dockwidget->setWindowTitle(name);
         mpConsole->mDockWidgetMap.insert(name, dockwidget);
         // It wasn't obvious but the parent passed to the TConsole constructor
@@ -3686,7 +3634,7 @@ std::pair Host::openWindow(const QString& name, bool loadLayout,
         console->setContentsMargins(0, 0, 0, 0);
         dockwidget->setTConsole(console);
         console->layerCommandLine->hide();
-        console->mpScrollBar->hide();
+        console->setScrollBarVisible(false);
         mpConsole->mSubConsoleMap.insert(name, console);
         dockwidget->setStyleSheet(mProfileStyleSheet);
         mudlet::self()->addDockWidget(Qt::RightDockWidgetArea, dockwidget);
@@ -4143,7 +4091,7 @@ std::pair Host::setWindow(const QString& windowname, const QStrin
     if (pDCheck) {
         return {false, qsl("element '%1' is the base of a floating/dockable user window and may not be moved").arg(name)};
     }
-    if (mpDockableMapWidget) {
+    if (mpConsole->mpDockableMapWidget) {
         if (!name.compare(QLatin1String("mapper"), Qt::CaseInsensitive)) {
             return {false, qsl("element '%1' is the map in a floating/dockable window and may not be moved").arg(name)};
         }
@@ -4243,11 +4191,11 @@ std::pair Host::openMapWidget(const QString& area, int x, int y,
         return {false, QString()};
     }
 
-    auto pM = mpDockableMapWidget;
+    auto pM = mpConsole->mpDockableMapWidget;
     auto pMapper = mpMap.data()->mpMapper;
     if (!pM && !pMapper) {
         showHideOrCreateMapper(true);
-        pM = mpDockableMapWidget;
+        pM = mpConsole->mpDockableMapWidget;
     }
     if (!pM) {
         return {false, qsl("cannot create map widget. Do you already use an embedded mapper?")};
@@ -4305,7 +4253,7 @@ std::pair Host::closeMapWidget()
         return {false, QString()};
     }
 
-    auto pM = mpDockableMapWidget;
+    auto pM = mpConsole->mpDockableMapWidget;
     if (!pM) {
         return {false, qsl("no map widget found to close")};
     }
@@ -4564,8 +4512,8 @@ bool Host::setProfileStyleSheet(const QString& styleSheet)
         mpNotePad->setStyleSheet(styleSheet);
         mpNotePad->setTabsStyleSheet(styleSheet);
     }
-    if (mpDockableMapWidget) {
-        mpDockableMapWidget->setStyleSheet(styleSheet);
+    if (mpConsole->mpDockableMapWidget) {
+        mpConsole->mpDockableMapWidget->setStyleSheet(styleSheet);
     }
 
     for (auto& dockWidget : mpConsole->mDockWidgetMap) {
@@ -4749,7 +4697,7 @@ void Host::toggleMapperVisibility()
     if (pMap->mpMapper->isFloatAndDockable()) {
         // If we are using a floating/dockable widget we must show/hide that
         // only and not the mapper widget (otherwise it messes up {shrinks
-        // to a minimal size} the mapper inside the container QDockWidget). This
+        // to a minimal size} the mapper inside the container dock widget). This
         // is the same as the case for a TConsole inside a TDockWidget in
         // (void) TDockWidget::setVisible(bool).
         // When in a dock widget, check the parent's visibility, not the child's,
@@ -4770,17 +4718,21 @@ void Host::toggleMapperVisibility()
 
 void Host::createMapper(const bool loadDefaultMap)
 {
+    // The console owns the map dock; bail if the profile has no console yet or is
+    // already being torn down.
+    if (!mpConsole) {
+        return;
+    }
     auto pMap = mpMap.data();
     auto hostName(getName());
-    mpDockableMapWidget = new QDockWidget(tr("Map - %1").arg(hostName));
-    mpDockableMapWidget->setObjectName(qsl("dockMap_%1").arg(hostName));
+    mpConsole->createMapperDock(tr("Map - %1").arg(hostName), qsl("dockMap_%1").arg(hostName));
     // Arrange for TMap member values to be copied from the Host masters so they
     // are in place when the 2D mapper is created:
     getPlayerRoomStyleDetails(pMap->mPlayerRoomStyle, pMap->mPlayerRoomOuterDiameterPercentage, pMap->mPlayerRoomInnerDiameterPercentage, pMap->mPlayerRoomOuterColor, pMap->mPlayerRoomInnerColor);
 
-    pMap->mpMapper = new dlgMapper(mpDockableMapWidget, this, pMap); //FIXME: mpHost definieren
+    pMap->mpMapper = new dlgMapper(mpConsole->mpDockableMapWidget, this, pMap); //FIXME: mpHost definieren
     pMap->mpMapper->setStyleSheet(mProfileStyleSheet);
-    mpDockableMapWidget->setWidget(pMap->mpMapper);
+    mpConsole->mpDockableMapWidget->setWidget(pMap->mpMapper);
 
     if (loadDefaultMap && pMap->mpRoomDB->isEmpty()) {
         qDebug() << "Host::create_mapper() - restore map case 3.";
@@ -4805,7 +4757,7 @@ void Host::createMapper(const bool loadDefaultMap)
             pMap->mpMapper->show();
         }
     }
-    mudlet::self()->addDockWidget(Qt::RightDockWidgetArea, mpDockableMapWidget);
+    mudlet::self()->addDockWidget(Qt::RightDockWidgetArea, mpConsole->mpDockableMapWidget);
 
     // XXX: should this be called multiple times?
     mudlet::self()->loadWindowLayout();
@@ -4814,7 +4766,7 @@ void Host::createMapper(const bool loadDefaultMap)
     // restored a previous hidden state, but when first creating the mapper, we
     // always want it to be visible.
     pMap->mpMapper->show();
-    mpDockableMapWidget->show();
+    mpConsole->mpDockableMapWidget->show();
     pMap->mpMapper->updateEmptyStateOverlay();
 
     check_for_mappingscript();
@@ -5185,7 +5137,7 @@ void Host::setBorders(QMargins borders)
     auto y = mpConsole->height();
     const QSize s = QSize(x, y);
     QResizeEvent event(s, s);
-    QApplication::sendEvent(mpConsole, &event);
+    QCoreApplication::sendEvent(mpConsole, &event);
     mpConsole->raiseMudletSysWindowResizeEvent(x, y);
 }
 
diff --git a/src/Host.h b/src/Host.h
index 7b6153add..39c05a2ce 100644
--- a/src/Host.h
+++ b/src/Host.h
@@ -57,12 +57,8 @@
 #include "TMxpProcessor.h"
 #include "TMxpFrameManager.h"
 
-class QDialog;
-class QDockWidget;
 class QJsonObject;
 class QKeyEvent;
-class QPushButton;
-class QListWidget;
 
 class TEvent;
 class TArea;
@@ -818,7 +814,6 @@ public:
     bool mMapperCenterSmallAreas = false;
     bool mVersionInTTYPE = false;
     QSet mDoubleClickIgnore;
-    QPointer mpDockableMapWidget;
     bool mEnableTextAnalyzer = false;
     bool mWritingHostAndModules = false;
     // Set from profile preferences, if the timer interval is less
@@ -883,6 +878,11 @@ signals:
     void signal_editorThemeChanged();
     void signal_remoteEchoChanged(bool enabled);
     void signal_forceMXPProcessorOnChanged(bool enabled);
+    // The frontend (TMainConsole) owns the dialogs these drive; the strings are
+    // built here so they stay in Host's translation context.
+    void signal_showMapperScriptReminder();
+    void signal_showUnpackingProgress(const QString& message, const QString& title);
+    void signal_hideUnpackingProgress();
 
 private slots:
     void slot_purgeTemps();
diff --git a/src/TDetachedWindow.cpp b/src/TDetachedWindow.cpp
index 8199db245..b314e4dc7 100644
--- a/src/TDetachedWindow.cpp
+++ b/src/TDetachedWindow.cpp
@@ -126,9 +126,9 @@ TDetachedWindow::~TDetachedWindow()
                     if (auto pHost = mudletInstance->getHostManager().getHost(profileName)) {
                         auto pMap = pHost->mpMap.data();
 
-                        if (pMap && pHost->mpDockableMapWidget) {
+                        if (pMap && pHost->mpConsole && pHost->mpConsole->mpDockableMapWidget) {
                             // Find the main window's mapper
-                            auto mainMapWidget = pHost->mpDockableMapWidget->widget();
+                            auto mainMapWidget = pHost->mpConsole->mpDockableMapWidget->widget();
 
                             if (auto mainMapper = qobject_cast(mainMapWidget)) {
                                 pMap->mpMapper = mainMapper;
@@ -151,9 +151,9 @@ TDetachedWindow::~TDetachedWindow()
                 if (auto pHost = mudletInstance->getHostManager().getHost(mCurrentProfileName)) {
                     auto pMap = pHost->mpMap.data();
 
-                    if (pMap && pHost->mpDockableMapWidget) {
+                    if (pMap && pHost->mpConsole && pHost->mpConsole->mpDockableMapWidget) {
                         // Find the main window's mapper
-                        auto mainMapWidget = pHost->mpDockableMapWidget->widget();
+                        auto mainMapWidget = pHost->mpConsole->mpDockableMapWidget->widget();
 
                         if (auto mainMapper = qobject_cast(mainMapWidget)) {
                             pMap->mpMapper = mainMapper;
@@ -1561,8 +1561,8 @@ void TDetachedWindow::updateDockWidgetVisibilityForProfile(const QString& profil
                 if (auto pMudlet = mudlet::self()) {
                     if (auto pHost = pMudlet->getHostManager().getHost(dockProfileName)) {
                         if (auto pMap = pHost->mpMap.data()) {
-                            if (pHost->mpDockableMapWidget) {
-                                auto mainMapWidget = pHost->mpDockableMapWidget->widget();
+                            if (pHost->mpConsole && pHost->mpConsole->mpDockableMapWidget) {
+                                auto mainMapWidget = pHost->mpConsole->mpDockableMapWidget->widget();
 
                                 if (auto mainMapper = qobject_cast(mainMapWidget)) {
                                     pMap->mpMapper = mainMapper;
@@ -2054,8 +2054,8 @@ bool TDetachedWindow::removeProfile(const QString& profileName)
             if (auto pMudlet = mudlet::self()) {
                 if (auto pHost = pMudlet->getHostManager().getHost(profileName)) {
                     if (auto pMap = pHost->mpMap.data()) {
-                        if (pHost->mpDockableMapWidget) {
-                            auto mainMapWidget = pHost->mpDockableMapWidget->widget();
+                        if (pHost->mpConsole && pHost->mpConsole->mpDockableMapWidget) {
+                            auto mainMapWidget = pHost->mpConsole->mpDockableMapWidget->widget();
 
                             if (auto mainMapper = qobject_cast(mainMapWidget)) {
                                 pMap->mpMapper = mainMapper;
@@ -2785,8 +2785,8 @@ void TDetachedWindow::slot_showMapperDialog()
             mpMapDockWidget = nullptr;
 
             // Restore the main window's mapper as the active one
-            if (pHost->mpDockableMapWidget) {
-                auto mainMapWidget = pHost->mpDockableMapWidget->widget();
+            if (pHost->mpConsole && pHost->mpConsole->mpDockableMapWidget) {
+                auto mainMapWidget = pHost->mpConsole->mpDockableMapWidget->widget();
                 if (auto mainMapper = qobject_cast(mainMapWidget)) {
                     pMap->mpMapper = mainMapper;
                 }
@@ -2802,7 +2802,7 @@ void TDetachedWindow::slot_showMapperDialog()
 
     // Store the main window's mapper temporarily so we can restore it later
     QPointer mainMapper = pMap->mpMapper;
-    QPointer mainDockWidget = pHost->mpDockableMapWidget;
+    QPointer mainDockWidget = (pHost->mpConsole ? pHost->mpConsole->mpDockableMapWidget : nullptr);
 
     // Create a new mapper instance for the detached window
     // We need to copy player room style details first
@@ -2881,8 +2881,8 @@ void TDetachedWindow::slot_showMapperDialog()
             }
 
             // Restore the main window's mapper as the active one when hiding
-            if (pHost->mpDockableMapWidget) {
-                auto mainMapWidget = pHost->mpDockableMapWidget->widget();
+            if (pHost->mpConsole && pHost->mpConsole->mpDockableMapWidget) {
+                auto mainMapWidget = pHost->mpConsole->mpDockableMapWidget->widget();
                 if (auto mainMapper = qobject_cast(mainMapWidget)) {
                     pMap->mpMapper = mainMapper;
                 }
@@ -3251,8 +3251,8 @@ void TDetachedWindow::addTransferredDockWidget(const QString& mapKey, QDockWidge
             }
 
             // Restore the main window's mapper as the active one when hiding
-            if (pHost->mpDockableMapWidget) {
-                auto mainMapWidget = pHost->mpDockableMapWidget->widget();
+            if (pHost->mpConsole && pHost->mpConsole->mpDockableMapWidget) {
+                auto mainMapWidget = pHost->mpConsole->mpDockableMapWidget->widget();
 
                 if (auto mainMapper = qobject_cast(mainMapWidget)) {
                     pMap->mpMapper = mainMapper;
diff --git a/src/TDockWidget.cpp b/src/TDockWidget.cpp
index 0cab7209e..dd7cafeaf 100644
--- a/src/TDockWidget.cpp
+++ b/src/TDockWidget.cpp
@@ -30,6 +30,7 @@ TDockWidget::TDockWidget(Host* pH, const QString& consoleName)
 , mWidgetConsoleName(consoleName)
 , mpHost(pH)
 {
+    setFeatures(QDockWidget::DockWidgetClosable | QDockWidget::DockWidgetMovable | QDockWidget::DockWidgetFloatable);
 }
 
 // This sets the mutual pointers that the TConsole and the TDockWidget now
diff --git a/src/TMainConsole.cpp b/src/TMainConsole.cpp
index b0e561c96..a75235ea1 100644
--- a/src/TMainConsole.cpp
+++ b/src/TMainConsole.cpp
@@ -40,10 +40,14 @@
 #include "mudlet.h"
 #include "GifTracker.h"
 
+#include 
+#include 
+#include 
 #include 
 #include 
 #include 
 #include 
+#include 
 #include 
 #include 
 #include 
@@ -82,6 +86,15 @@ TMainConsole::TMainConsole(Host* pH, QWidget* parent)
 
 TMainConsole::~TMainConsole()
 {
+    // Neither is a child of this console: the map dock is reparented onto the main
+    // window by addDockWidget(), and the unpacking dialog is parentless. So neither
+    // dies with the console automatically.
+    if (mpDockableMapWidget) {
+        mpDockableMapWidget->deleteLater();
+    }
+    if (mpUnpackingDialog) {
+        mpUnpackingDialog->deleteLater();
+    }
     if (mpHunspell_system) {
         Hunspell_destroy(mpHunspell_system);
         mpHunspell_system = nullptr;
@@ -828,7 +841,7 @@ std::pair TMainConsole::setLabelCustomCursor(const QString& name,
 std::pair TMainConsole::createMapper(const QString& windowname, int x, int y, int width, int height)
 {
     auto pW = mDockWidgetMap.value(windowname);
-    auto pM = mpHost->mpDockableMapWidget;
+    auto pM = mpDockableMapWidget;
     if (pM) {
         return {false, qsl("cannot create mapper. Do you already use a map window?")};
     }
@@ -1729,6 +1742,87 @@ void TMainConsole::closePackageDownloadProgress()
     }
 }
 
+void TMainConsole::createMapperDock(const QString& title, const QString& objectName)
+{
+    mpDockableMapWidget = new QDockWidget(title);
+    mpDockableMapWidget->setObjectName(objectName);
+}
+
+void TMainConsole::showMapperScriptReminder()
+{
+    QUiLoader loader;
+    QFile file(qsl(":/ui/lacking_mapper_script.ui"));
+    if (!file.open(QFile::ReadOnly)) {
+        qWarning() << "TMainConsole::showMapperScriptReminder() WARNING - failed to open lacking_mapper_script.ui for reading:" << file.errorString();
+        return;
+    }
+
+    auto dialog = qobject_cast(loader.load(&file, mudlet::self()));
+    file.close();
+    if (!dialog) {
+        qWarning() << "TMainConsole::showMapperScriptReminder() WARNING - could not load the mapping-script reminder dialog.";
+        return;
+    }
+
+    connect(dialog, &QDialog::accepted, mudlet::self(), &mudlet::slot_openMappingScriptsPage);
+
+    dialog->show();
+    dialog->raise();
+    dialog->activateWindow();
+}
+
+void TMainConsole::showUnpackingProgress(const QString& message, const QString& title)
+{
+    // deleteLater() not close(): the dialog is parentless with no WA_DeleteOnClose,
+    // so closing it would leak it once we overwrite the pointer below.
+    if (mpUnpackingDialog) {
+        mpUnpackingDialog->deleteLater();
+    }
+
+    QUiLoader loader;
+    QFile uiFile(qsl(":/ui/package_manager_unpack.ui"));
+    if (!uiFile.open(QFile::ReadOnly)) {
+        qWarning() << "TMainConsole::showUnpackingProgress() WARNING - failed to open package_manager_unpack.ui for reading:" << uiFile.errorString();
+        return;
+    }
+    auto* pDialog = qobject_cast(loader.load(&uiFile, nullptr));
+    uiFile.close();
+    if (!pDialog) {
+        qWarning() << "TMainConsole::showUnpackingProgress() WARNING - could not load the unpacking progress dialog.";
+        return;
+    }
+    mpUnpackingDialog = pDialog;
+
+    // Trap: processEvents() below can deliver a re-entrant install (or its
+    // matching hide) that replaces or clears mpUnpackingDialog and disposes of
+    // this frame's dialog. Drive a local pointer, never the member, and bail if
+    // our dialog is taken out from under us.
+    QPointer dialog = pDialog;
+
+    if (auto* pLabel = dialog->findChild(qsl("label"))) {
+        pLabel->setText(message);
+    }
+    dialog->hide(); // Must hide to change WindowModality
+    dialog->setWindowTitle(title);
+    dialog->setWindowModality(Qt::ApplicationModal);
+    dialog->show();
+    QCoreApplication::processEvents();
+    if (!dialog) {
+        return;
+    }
+    dialog->raise();
+    dialog->repaint();                 // Force a redraw
+    QCoreApplication::processEvents(); // Try to ensure we are on top of any other dialogs and freshly drawn
+}
+
+void TMainConsole::closeUnpackingProgress()
+{
+    if (mpUnpackingDialog) {
+        mpUnpackingDialog->deleteLater();
+        mpUnpackingDialog = nullptr;
+    }
+}
+
 void TMainConsole::setupVideoOutput(TMediaPlayer* player, bool& setupSucceeded)
 {
     setupSucceeded = false;
diff --git a/src/TMainConsole.h b/src/TMainConsole.h
index 88358f6ce..4e27139e7 100644
--- a/src/TMainConsole.h
+++ b/src/TMainConsole.h
@@ -38,6 +38,8 @@
 
 class TMediaPlayer;
 class TTextBox;
+class QDialog;
+class QDockWidget;
 class QProgressDialog;
 
 class TMainConsole : public TConsole
@@ -95,6 +97,10 @@ public:
     void showPackageDownloadProgress(const QString& title, const QString& cancelText);
     void updatePackageDownloadProgress(qint64 got, qint64 total);
     void closePackageDownloadProgress();
+    void createMapperDock(const QString& title, const QString& objectName);
+    void showMapperScriptReminder();
+    void showUnpackingProgress(const QString& message, const QString& title);
+    void closeUnpackingProgress();
     void setupVideoOutput(TMediaPlayer* player, bool& setupSucceeded);
     void hideVideoOutput(TMediaPlayer* player);
     const QString& getSystemSpellDictionary() const { return mSpellDic; }
@@ -131,6 +137,8 @@ public:
     QTextStream mLogStream;
     bool mLogToLogFile = false;
     QPointer mpPackageDownloadProgressDialog;
+    QPointer mpDockableMapWidget;
+    QPointer mpUnpackingDialog;
 
 
 public slots:
diff --git a/src/mudlet.cpp b/src/mudlet.cpp
index c14b87e62..4aa8ec22d 100644
--- a/src/mudlet.cpp
+++ b/src/mudlet.cpp
@@ -2203,6 +2203,10 @@ void mudlet::addConsoleForNewHost(Host* pH)
     connect(&pH->mTelnet, &cTelnet::signal_packageDownloadProgress, pConsole, &TMainConsole::updatePackageDownloadProgress, Qt::UniqueConnection);
     connect(&pH->mTelnet, &cTelnet::signal_packageDownloadFinished, pConsole, &TMainConsole::closePackageDownloadProgress, Qt::UniqueConnection);
 
+    connect(pH, &Host::signal_showMapperScriptReminder, pConsole, &TMainConsole::showMapperScriptReminder, Qt::UniqueConnection);
+    connect(pH, &Host::signal_showUnpackingProgress, pConsole, &TMainConsole::showUnpackingProgress, Qt::UniqueConnection);
+    connect(pH, &Host::signal_hideUnpackingProgress, pConsole, &TMainConsole::closeUnpackingProgress, Qt::UniqueConnection);
+
     if (pH->mpMedia) {
         // Pin DirectConnection so the bool& out-parameter is filled synchronously, never queued.
         connect(pH->mpMedia.data(), &TMedia::signal_setupVideoOutput, pConsole, &TMainConsole::setupVideoOutput, static_cast(Qt::DirectConnection | Qt::UniqueConnection));
@@ -4218,8 +4222,8 @@ void mudlet::slot_showMapperDialog()
             mpCurrentMapDockWidget = nullptr;
 
             // Restore the host's default mapper if it exists
-            if (pHost->mpDockableMapWidget) {
-                auto hostMapWidget = pHost->mpDockableMapWidget->widget();
+            if (pHost->mpConsole && pHost->mpConsole->mpDockableMapWidget) {
+                auto hostMapWidget = pHost->mpConsole->mpDockableMapWidget->widget();
 
                 if (auto hostMapper = qobject_cast(hostMapWidget)) {
                     pMap->mpMapper = hostMapper;
@@ -4231,8 +4235,8 @@ void mudlet::slot_showMapperDialog()
     }
 
     // If the host already has its default dock widget, hide it to avoid conflicts
-    if (pHost->mpDockableMapWidget) {
-        pHost->mpDockableMapWidget->setVisible(false);
+    if (pHost->mpConsole && pHost->mpConsole->mpDockableMapWidget) {
+        pHost->mpConsole->mpDockableMapWidget->setVisible(false);
     }
 
     // Create a new docked mapper widget for this profile in the main window
@@ -4323,8 +4327,8 @@ void mudlet::slot_showMapperDialog()
             }
 
             // Restore the host's default mapper when hiding
-            if (pHost->mpDockableMapWidget) {
-                auto hostMapWidget = pHost->mpDockableMapWidget->widget();
+            if (pHost->mpConsole && pHost->mpConsole->mpDockableMapWidget) {
+                auto hostMapWidget = pHost->mpConsole->mpDockableMapWidget->widget();
 
                 if (auto hostMapper = qobject_cast(hostMapWidget)) {
                     pMap->mpMapper = hostMapper;
@@ -8706,8 +8710,8 @@ void mudlet::updateMainWindowDockWidgetVisibilityForProfile(const QString& profi
                 // Restore host's default mapper for the other profile
                 if (auto pHost = mHostManager.getHost(dockProfileName)) {
                     if (auto pMap = pHost->mpMap.data()) {
-                        if (pHost->mpDockableMapWidget) {
-                            auto hostMapWidget = pHost->mpDockableMapWidget->widget();
+                        if (pHost->mpConsole && pHost->mpConsole->mpDockableMapWidget) {
+                            auto hostMapWidget = pHost->mpConsole->mpDockableMapWidget->widget();
 
                             if (auto hostMapper = qobject_cast(hostMapWidget)) {
                                 pMap->mpMapper = hostMapper;
diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt
index afb190c0f..07423a104 100644
--- a/test/functional_tests/CMakeLists.txt
+++ b/test/functional_tests/CMakeLists.txt
@@ -32,6 +32,7 @@ set(FUNCTIONAL_TEST_SOURCES
     PackageSelfUninstallTest.cpp
     MapRoundTripTest.cpp
     UndoServerWrapTest.cpp
+    HostWidgetDecouplingTest.cpp
     ActionSelfUninstallTest.cpp
 )
 
@@ -101,6 +102,9 @@ set_tests_properties(LogRestartDuplicateLineTest PROPERTIES TIMEOUT 300)
 # map data, so they need a longer timeout
 set_tests_properties(ProfileRoundTripTest MapRoundTripTest PROPERTIES TIMEOUT 300)
 
+# HostWidgetDecouplingTest creates a fresh profile per test method, so it needs a longer timeout
+set_tests_properties(HostWidgetDecouplingTest PROPERTIES TIMEOUT 300)
+
 # TDiscordModeTest drives the real discord-rpc library end-to-end. The library's
 # reconnect backoff is a process-global (60s ceiling) that the suite's
 # init/shutdown churn can inflate, so a fresh handshake can take a while (see
diff --git a/test/functional_tests/HostWidgetDecouplingTest.cpp b/test/functional_tests/HostWidgetDecouplingTest.cpp
new file mode 100644
index 000000000..f1862cceb
--- /dev/null
+++ b/test/functional_tests/HostWidgetDecouplingTest.cpp
@@ -0,0 +1,372 @@
+/***************************************************************************
+ *   Copyright (C) 2026 by Mudlet Developers                               *
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the GNU General Public License as published by  *
+ *   the Free Software Foundation; either version 2 of the License, or     *
+ *   (at your option) any later version.                                   *
+ *                                                                         *
+ *   This program is distributed in the hope that it will be useful,       *
+ *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
+ *   GNU General Public License for more details.                          *
+ *                                                                         *
+ *   You should have received a copy of the GNU General Public License     *
+ *   along with this program; if not, write to the                         *
+ *   Free Software Foundation, Inc.,                                       *
+ *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
+ ***************************************************************************/
+
+#include 
+
+#include 
+
+#include "Host.h"
+#include "MudletInstanceCoordinator.h"
+#include "TMainConsole.h"
+#include "TelnetServerStub.h"
+#include "ctelnet.h"
+#include "dlgConnectionProfiles.h"
+#include "mudlet.h"
+#include "utils.h"
+
+#include 
+#include 
+#include 
+#include 
+
+extern void qInitResources_mudlet();
+extern void qInitResources_qm();
+extern void qInitResources_additional_splash_screens();
+extern void qInitResources_mudlet_fonts_common();
+extern void qInitResources_mudlet_fonts_posix();
+void initializeQRCResourcesForHostWidgetDecoupling();
+
+using namespace std::chrono_literals;
+
+// Exercises the widget-free seams introduced when Host was de-widgeted: the
+// dockable map widget is now created and owned by the profile's main console
+// (TMainConsole), and the mapping-script reminder and package-unpacking dialogs
+// are shown by the frontend in response to Host signals carrying already
+// translated strings. These tests verify that ownership moved and that the
+// signals drive the frontend widgets as expected.
+class HostWidgetDecouplingTest : public QObject
+{
+    Q_OBJECT
+
+private:
+    TelnetServerStub* mpServer = nullptr;
+    const QString mHostname = "Test-Host-Widget-Decoupling";
+    const QString mLocalhost = "localhost";
+    QString mPort;
+
+private slots:
+    void initTestCase() { initializeQRCResourcesForHostWidgetDecoupling(); }
+
+    void init()
+    {
+        mpServer = new TelnetServerStub(qApp);
+        // Bind an ephemeral OS-assigned port so parallel test runs (e.g. across
+        // git worktrees) do not collide on a shared fixed port.
+        mpServer->start(mLocalhost, 0);
+        mPort = QString::number(mpServer->serverPort());
+        mudlet::start();
+        mudlet::self()->setupConfig();
+        mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique("MudletInstanceCoordinator"));
+        mudlet::self()->init();
+        mudlet::self()->setStorePasswordsSecurely(false);
+        deleteProfileDirectory(mHostname);
+    }
+
+    // The dockable map widget used to be a QDockWidget member of Host; it now
+    // lives on (and is owned by) the profile's TMainConsole. Creating the mapper
+    // must populate that console-owned pointer.
+    void test_dockableMapperOwnedByConsole()
+    {
+        startProfile(mHostname, mLocalhost, mPort);
+        auto host = mudlet::self()->getActiveHost();
+        QVERIFY2(host, "No active host available for the test.");
+        QVERIFY2(host->mpConsole, "The active host has no main console.");
+
+        QVERIFY2(!host->mpConsole->mpDockableMapWidget, "A fresh profile must not have a dockable map widget yet.");
+
+        host->showHideOrCreateMapper(true);
+
+        QVERIFY2(host->mpConsole->mpDockableMapWidget, "Creating the mapper must give the console a dockable map widget it owns.");
+        QCOMPARE(host->mpConsole->mpDockableMapWidget->objectName(), qsl("dockMap_%1").arg(host->getName()));
+    }
+
+    // setMapperTitle is still a Host-facing (Lua) call, but it now drives the
+    // console-owned dock: it must fail when there is no dock and set the window
+    // title on the console's dock once one exists.
+    void test_setMapperTitleDrivesConsoleDock()
+    {
+        startProfile(mHostname, mLocalhost, mPort);
+        auto host = mudlet::self()->getActiveHost();
+        QVERIFY2(host, "No active host available for the test.");
+        QVERIFY2(host->mpConsole, "The active host has no main console.");
+
+        auto [okWithoutDock, messageWithoutDock] = host->setMapperTitle(qsl("anything"));
+        QVERIFY2(!okWithoutDock, "setMapperTitle must fail when there is no dockable map widget.");
+
+        host->showHideOrCreateMapper(true);
+        QVERIFY2(host->mpConsole->mpDockableMapWidget, "The mapper dock was not created.");
+
+        auto [okWithDock, messageWithDock] = host->setMapperTitle(qsl("Custom map title"));
+        QVERIFY2(okWithDock, qPrintable(messageWithDock));
+        QCOMPARE(host->mpConsole->mpDockableMapWidget->windowTitle(), qsl("Custom map title"));
+    }
+
+    // The mapping-script reminder used to be a QDialog built inside Host; it is
+    // now shown by the frontend in response to signal_showMapperScriptReminder().
+    // Verify the frontend handler actually raises a dialog parented on the main
+    // window. (Whether Host emits the signal depends on the profile's script
+    // state, which is Host-side logic unchanged by this refactor, so we drive
+    // the handler directly here.)
+    void test_mappingScriptReminderShownByConsole()
+    {
+        startProfile(mHostname, mLocalhost, mPort);
+        auto host = mudlet::self()->getActiveHost();
+        QVERIFY2(host, "No active host available for the test.");
+        QVERIFY2(host->mpConsole, "The active host has no main console.");
+
+        const int dialogsBefore = mudlet::self()->findChildren().count();
+        host->mpConsole->showMapperScriptReminder();
+        const int dialogsAfter = mudlet::self()->findChildren().count();
+        QVERIFY2(dialogsAfter > dialogsBefore, "showMapperScriptReminder must raise a reminder dialog owned by the main window.");
+    }
+
+    // The package-unpacking progress dialog is now owned by the console and
+    // shown from Host's signal payload. A second show must replace (not stack
+    // on top of) the first, and closing must dispose of it.
+    void test_unpackingProgressDialogReplacedAndClosed()
+    {
+        startProfile(mHostname, mLocalhost, mPort);
+        auto host = mudlet::self()->getActiveHost();
+        QVERIFY2(host, "No active host available for the test.");
+        QVERIFY2(host->mpConsole, "The active host has no main console.");
+
+        auto console = host->mpConsole;
+        QVERIFY2(!console->mpUnpackingDialog, "There must be no unpacking dialog before one is requested.");
+
+        console->showUnpackingProgress(qsl("Unpacking package:\n\"first\"\nplease wait..."), qsl("Unpacking"));
+        QVERIFY2(console->mpUnpackingDialog, "showUnpackingProgress must create a dialog.");
+        QCOMPARE(console->mpUnpackingDialog->windowTitle(), qsl("Unpacking"));
+        if (auto* pLabel = console->mpUnpackingDialog->findChild(qsl("label"))) {
+            QVERIFY2(pLabel->text().contains(qsl("first")), "The dialog label did not carry the message payload.");
+        }
+
+        // Track the first dialog: a replacement must dispose of it, not leak it
+        // (the dialog is parentless, so nothing else would ever delete it).
+        QPointer firstDialog = console->mpUnpackingDialog;
+        console->showUnpackingProgress(qsl("Unpacking package:\n\"second\"\nplease wait..."), qsl("Unpacking"));
+        QVERIFY2(console->mpUnpackingDialog, "A replacement unpacking dialog must exist.");
+        QVERIFY2(console->mpUnpackingDialog != firstDialog, "The replacement must be a distinct dialog.");
+        if (auto* pLabel = console->mpUnpackingDialog->findChild(qsl("label"))) {
+            QVERIFY2(pLabel->text().contains(qsl("second")), "The replacement dialog did not carry the new message payload.");
+        }
+        QTest::qWait(50ms); // let the replaced dialog's queued deleteLater() run
+        QVERIFY2(!firstDialog, "Replacing the unpacking dialog must dispose of the previous one, not leak it.");
+
+        console->closeUnpackingProgress();
+        QTest::qWait(50ms);
+        QVERIFY2(!console->mpUnpackingDialog, "closeUnpackingProgress must dispose of the dialog.");
+    }
+
+    // Regression guard: showUnpackingProgress() spins the event loop via
+    // processEvents(). A deferred install completion can deliver a re-entrant
+    // close (or a second show) during that spin, disposing of the dialog and
+    // clearing mpUnpackingDialog. The frame must not then dereference the member.
+    // Before the fix it did (mpUnpackingDialog->raise() on a nulled member) and
+    // crashed; now it drives a local pointer, so reaching this test's end without
+    // a crash is the assertion.
+    void test_reentrantUnpackingProgressDoesNotCrash()
+    {
+        startProfile(mHostname, mLocalhost, mPort);
+        auto host = mudlet::self()->getActiveHost();
+        QVERIFY2(host, "No active host available for the test.");
+        QVERIFY2(host->mpConsole, "The active host has no main console.");
+        auto console = host->mpConsole;
+
+        // Queue a re-entrant close to fire while showUnpackingProgress() is inside
+        // its first processEvents(), mimicking a deferred install completion.
+        QMetaObject::invokeMethod(
+                qApp,
+                [console]() {
+                    console->closeUnpackingProgress();
+                },
+                Qt::QueuedConnection);
+
+        console->showUnpackingProgress(qsl("Unpacking package:\n\"reentrant\"\nplease wait..."), qsl("Unpacking"));
+
+        QTest::qWait(50ms);
+        QVERIFY2(!console->mpUnpackingDialog, "The re-entrant close should have left no unpacking dialog behind.");
+    }
+
+    // The tests above drive the console's handlers directly, so they would all
+    // still pass if the Host -> console connections made in
+    // mudlet::addConsoleForNewHost() were lost (that function is a merge-conflict
+    // hot spot). This one installs a real package instead, so the show and hide
+    // signals have to travel the production wiring to reach the dialog.
+    void test_unpackingDialogDrivenByInstall()
+    {
+        startProfile(mHostname, mLocalhost, mPort);
+        auto host = mudlet::self()->getActiveHost();
+        QVERIFY2(host, "No active host available for the test.");
+        QVERIFY2(host->mpConsole, "The active host has no main console.");
+        auto console = host->mpConsole;
+
+        QTemporaryDir packageDir;
+        QVERIFY2(packageDir.isValid(), "Could not create a temporary directory for the test package.");
+        const QString packagePath = packageDir.filePath(qsl("HostWidgetDecouplingPackage.zip"));
+        QVERIFY2(writeEmptyZipArchive(packagePath), "Could not write the test package archive.");
+
+        // installPackage() postpones the whole install (and so emits nothing) if a
+        // profile save is still in flight from loading the profile.
+        QTRY_VERIFY(!host->currentlySavingProfile());
+
+        QSignalSpy showSpy(host, &Host::signal_showUnpackingProgress);
+        QSignalSpy hideSpy(host, &Host::signal_hideUnpackingProgress);
+
+        // Connected after the console's own handler, so it observes the dialog
+        // that handler has just put up - if the wiring is intact.
+        QObject captureContext;
+        bool dialogUpWhileUnpacking = false;
+        QPointer dialogWhileUnpacking;
+        connect(host, &Host::signal_showUnpackingProgress, &captureContext, [&](const QString&, const QString&) {
+            dialogWhileUnpacking = console->mpUnpackingDialog;
+            dialogUpWhileUnpacking = !dialogWhileUnpacking.isNull();
+        });
+
+        auto [ok, message] = host->installPackage(packagePath, enums::PackageModuleType::Package, false);
+        QVERIFY2(ok, qPrintable(message));
+
+        QCOMPARE(showSpy.count(), 1);
+        QCOMPARE(hideSpy.count(), 1);
+        QVERIFY2(dialogUpWhileUnpacking, "Installing a package must put the unpacking dialog up via the Host signal.");
+        QVERIFY2(!console->mpUnpackingDialog, "Finishing the install must take the unpacking dialog down again.");
+        QTest::qWait(50ms); // let the dialog's queued deleteLater() run
+        QVERIFY2(dialogWhileUnpacking.isNull(), "The unpacking dialog was taken down but never disposed of.");
+    }
+
+    // The map dock moved from Host to TMainConsole, so disposing of it is now the
+    // console destructor's job. addDockWidget() reparents the dock onto the main
+    // window, which outlives the profile, so nothing else would clean it up.
+    void test_mapDockDestroyedOnProfileClose()
+    {
+        startProfile(mHostname, mLocalhost, mPort);
+        auto host = mudlet::self()->getActiveHost();
+        QVERIFY2(host, "No active host available for the test.");
+        QVERIFY2(host->mpConsole, "The active host has no main console.");
+
+        host->showHideOrCreateMapper(true);
+        QPointer dock = host->mpConsole->mpDockableMapWidget;
+        QVERIFY2(dock, "The mapper dock was not created.");
+
+        // Forcing the close stops TMainConsole::closeEvent() asking whether the
+        // profile should be saved, which would block on a modal dialog here.
+        // requestClose() is the half of the profile-close path that disposes of
+        // the console; the mudlet::closeHost() that normally follows it only
+        // removes the tab and the Host, and would reopen the connection dialog
+        // as the last profile went away.
+        host->forceClose();
+        QVERIFY2(host->requestClose(), "Closing the profile was refused.");
+
+        // Two chained deferred deletes to get through: the console (it carries
+        // WA_DeleteOnClose) and then, from its destructor, the dock.
+        QTest::qWait(500ms);
+        QVERIFY2(dock.isNull(), "Closing the profile must destroy the map dock the console owns.");
+    }
+
+    void cleanup()
+    {
+        delete mpServer;
+        mpServer = nullptr;
+        deleteProfileDirectory(mHostname);
+        delete mudlet::self();
+    }
+
+    // Utility function to manually start a profile like a user would do via the
+    // GUI
+    void startProfile(const QString& hostname, const QString& address, const QString& port)
+    {
+        QTimer::singleShot(0, qApp, [hostname, address, port]() {
+            mudlet::self()->startAutoLogin({});
+            QTest::qWait(100ms);
+            QTest::mouseClick(mudlet::self()->mpConnectionDialog->new_profile_button, Qt::LeftButton);
+            QTest::qWait(100ms);
+            QTest::keyClicks(QApplication::focusWidget(), hostname);
+            QTest::qWait(100ms);
+            QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab);
+            QTest::qWait(100ms);
+            QTest::keyClicks(QApplication::focusWidget(), address);
+            QTest::qWait(100ms);
+            QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab);
+            QTest::qWait(100ms);
+            QTest::keyClicks(QApplication::focusWidget(), port);
+            QTest::qWait(100ms);
+            QTest::keyClick(QApplication::focusWidget(), Qt::Key_Return);
+        });
+
+        QSignalSpy spy(mudlet::self(), &mudlet::signal_profileLoaded);
+        if (!spy.wait(5s)) {
+            QFAIL("Profile took too long to load.");
+        }
+        auto host = mudlet::self()->getActiveHost();
+        if (!host) {
+            QFAIL("No active host available for the test.");
+        }
+
+        QSignalSpy spy2(&(host->mTelnet), &cTelnet::signal_connected);
+        if (!spy2.wait(2s)) {
+            QFAIL("Could not connect with the host.");
+        }
+    }
+
+    // Utility function producing the smallest valid zip archive there is: a lone
+    // end-of-central-directory record holding no entries. installPackage() only
+    // has to find a real archive to unpack for the dialog wiring to be exercised;
+    // what is inside it is beside the point here.
+    bool writeEmptyZipArchive(const QString& path)
+    {
+        static const char endOfCentralDirectoryRecord[22] = {'P', 'K', '\x05', '\x06'};
+        QFile archive(path);
+        if (!archive.open(QIODevice::WriteOnly)) {
+            return false;
+        }
+        const bool written = archive.write(endOfCentralDirectoryRecord, sizeof(endOfCentralDirectoryRecord)) == static_cast(sizeof(endOfCentralDirectoryRecord));
+        archive.close();
+        return written;
+    }
+
+    // Utility function
+    void deleteProfileDirectory(const QString& profileName)
+    {
+        const QString path = mudlet::getMudletPath(enums::profileHomePath, profileName);
+        QDir dir(path);
+
+        if (!dir.exists()) {
+            qInfo() << "Profile directory does not exist:" << path;
+            return;
+        }
+        dir.removeRecursively();
+    }
+};
+
+void initializeQRCResourcesForHostWidgetDecoupling()
+{
+#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN
+    qInitResources_additional_splash_screens();
+#endif
+#ifdef INCLUDE_FONTS
+    qInitResources_mudlet_fonts_common();
+#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD)
+    qInitResources_mudlet_fonts_posix();
+#endif
+#endif
+    qInitResources_mudlet();
+    qInitResources_qm();
+}
+
+#include "HostWidgetDecouplingTest.moc"
+QTEST_MAIN(HostWidgetDecouplingTest)

From 0f9bc0a4be02eb23fa9647dc9e9cd48bd2fcded4 Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Sun, 2 Aug 2026 15:33:07 +0200
Subject: [PATCH 035/155] infrastructure: decouple the mapper engine from UI
 dialogs (#9513)

#### Brief overview of PR changes/additions
- Removes all raw Qt Widgets usage from the map engine: `TMap.{h,cpp}`
no longer owns a `QProgressDialog` (and drops a dead `QFileDialog`
include), and `XMLimport.{h,cpp}` no longer pulls in `QApplication` (the
clipboard read now uses `QGuiApplication::clipboard()`, which lives in
Qt Gui).
- The standalone map-progress dialog (shown when the mapper is not
visible, for map download / XML import and JSON export/import) is now
driven by Qt signals carrying pre-translated payloads; the frontend
(`TMainConsole`) owns the actual `QProgressDialog`, and a user cancel
returns to the engine through `TMap::slot_mapProgressDialogCancelled()`.
- Adds `MapProgressDialogSeamTest` covering the transfer-progress state
machine, a JSON export/import round trip driving the new signals, a
mid-import cancel delivered through the seam (the highest-risk change,
since the JSON reader used to poll `QProgressDialog::wasCanceled()`
synchronously), and an XML map import re-entered from inside a running
JSON operation.

#### Motivation for adding to Mudlet
Second concrete step of the re-scoped libmudlet plan (a Qt-Widgets-free
`mudlet_core` for headless use, testability and WASM). It copies the
seam template established in #9507: core emits a pre-translated payload
-> frontend owns the widget -> a callback slot returns the answer. The
Qt Widgets dependency audit (`cmake/audit-core-widgets.sh`) drops from
**151 to 147** offending files; `TMap.cpp`, `TMap.h`, `XMLimport.cpp`
and `XMLimport.h` are all now clean. The mapper-owned inline progress
path (`dlgMapper`/`T2DMap`, Mudlet's own widgets) is deliberately
untouched here - those move wholesale in the later target-split phase.

#### Other info (issues closed, discussion etc)
Part of #8681 / #9011. Existing translations are unaffected: every
progress string keeps its `TMap` `tr()` context, so current translations
carry straight over. Two new strings do arrive, both with `//:`
translator comments - the warnings shown when a map download or an XML
map import is refused because a JSON import/export is already running.
The JSON dialog stays non-modal and the download/import dialog keeps its
modeless styling, each applied by the frontend. The engine keeps its own
`mMapProgressStandalone` / `mMapProgressCancelRequested` /
`mMapProgressStandaloneMaximum` state to replace the widget read-backs
it used to do (`!= nullptr`, `wasCanceled()`, `maximum()`). If a map
operation ever reaches the engine before a console is wired (checked via
`isSignalConnected`), `TMap::warnIfMapProgressUnwired()` logs a loud
`qWarning` rather than silently running with no progress UI.

It also closes a latent null-dereference that exists on `development`
today. With the mapper visible a map download takes the inline-progress
path, leaving `mpProgressDialog` null - so a JSON export started
meanwhile sails past the `if (mpProgressDialog)` "already in progress"
check and creates a dialog of its own. When the download then finishes
inside the `processEvents()` pump the export is running,
`clearTransferProgress()` deletes and nulls *that* dialog, and the
export's next `incrementJsonProgressDialog()` dereferences null. The
engine now records whose dialog is up (`mMapProgressIsTransfer`) so a
transfer only ever closes its own, and `importMap()` refuses to start
while a JSON operation holds the progress - the mirror of the guard
`downloadMap()` has.

Two review-driven details worth flagging: the frontend only wires the
dialog's cancel to the engine when the operation is actually cancelable,
so a non-cancelable local XML import no longer turns a window-close into
a spurious "Map download was canceled" message; and the standalone
download/import dialog is now parented to the console (like the JSON one
always was, and like #9507's package-download dialog), so it centres on
and dies with the profile window. The three `#include `
additions to `Host.cpp` / `dlgTriggerEditor.cpp` /
`dlgConnectionProfiles.cpp` replace the transitive include they used to
get from `XMLimport.h`; all three are already Qt Widgets consumers, so
the audit count is unaffected.

Assisted-by: Claude:claude-opus-4-8
Assisted-by: Claude:claude-opus-5

**Test case:** With a mapper window open, use a game that supports map
download (or call `downloadMap()`) and confirm the progress dialog
shows, updates, and its Abort cancels the download. Then with the mapper
window closed, run `exportJsonMap()` and `importJsonMap()` on a large
map and confirm the non-modal JSON progress dialog appears, updates its
Areas/Rooms/Labels counts, and that clicking Abort during an import
stops it with an "aborted by user" result. Load a local XML map
(Settings -> Map -> load) and confirm closing its progress window does
not print a "Map download was canceled" line. Everything should behave
exactly as on `development`.

#### Demo (before & after)


https://github.com/user-attachments/assets/f1c62580-2d03-4e5b-a6ee-f6e2b78d113d
---
 src/Host.cpp                                  |   1 +
 src/TMainConsole.cpp                          |  92 ++++++
 src/TMainConsole.h                            |  10 +
 src/TMap.cpp                                  | 263 +++++++++-------
 src/TMap.h                                    |  34 +-
 src/XMLimport.cpp                             |   4 +-
 src/XMLimport.h                               |   6 +-
 src/dlgConnectionProfiles.cpp                 |   1 +
 src/dlgTriggerEditor.cpp                      |   1 +
 src/mudlet.cpp                                |  15 +
 test/functional_tests/CMakeLists.txt          |   3 +-
 .../MapProgressDialogSeamTest.cpp             | 297 ++++++++++++++++++
 12 files changed, 600 insertions(+), 127 deletions(-)
 create mode 100644 test/functional_tests/MapProgressDialogSeamTest.cpp

diff --git a/src/Host.cpp b/src/Host.cpp
index 167e32419..b51b006bf 100644
--- a/src/Host.cpp
+++ b/src/Host.cpp
@@ -60,6 +60,7 @@
 
 #include 
 #include 
+#include 
 #include 
 #include 
 #include 
diff --git a/src/TMainConsole.cpp b/src/TMainConsole.cpp
index a75235ea1..9cf79da15 100644
--- a/src/TMainConsole.cpp
+++ b/src/TMainConsole.cpp
@@ -42,6 +42,7 @@
 
 #include 
 #include 
+#include 
 #include 
 #include 
 #include 
@@ -1742,6 +1743,97 @@ void TMainConsole::closePackageDownloadProgress()
     }
 }
 
+void TMainConsole::createMapProgressDialog(const QString& title, const QString& label, const QString& cancelButtonText, int minimum, int maximum)
+{
+    if (mpMapProgressDialog) {
+        mpMapProgressDialog->hide();
+        mpMapProgressDialog->deleteLater();
+    }
+    auto pHost = getHost();
+    // If canceled() cannot be wired to the map, omit the cancel button rather
+    // than show one that does nothing.
+    const bool cancelWirable = pHost && !pHost->mpMap.isNull();
+    // Deliberately not WA_DeleteOnClose: the JSON import keeps updating this
+    // dialog from a processEvents loop, so it must outlive a mid-operation
+    // dismissal; we delete it explicitly instead.
+    mpMapProgressDialog = new QProgressDialog(label, cancelWirable ? cancelButtonText : QString(), minimum, maximum, this);
+    mpMapProgressDialog->setWindowTitle(title);
+    mpMapProgressDialog->setWindowIcon(QIcon(qsl(":/icons/mudlet_map_download.png")));
+    mpMapProgressDialog->setAutoClose(false);
+    mpMapProgressDialog->setAutoReset(false);
+    // QProgressDialog still emits canceled() on Escape or window-close even with
+    // no cancel button, so only connect it when the operation is cancelable;
+    // otherwise a non-cancelable import could be aborted by a spurious cancel.
+    if (cancelWirable && !cancelButtonText.isEmpty()) {
+        connect(mpMapProgressDialog, &QProgressDialog::canceled, pHost->mpMap.data(), &TMap::slot_mapProgressDialogCancelled);
+    }
+}
+
+void TMainConsole::showMapTransferProgress(const QString& title, const QString& label, const QString& cancelButtonText)
+{
+    createMapProgressDialog(title, label, cancelButtonText, 0, 0);
+    mpMapProgressDialog->setMinimumWidth(300);
+    mpMapProgressDialog->setMinimumDuration(0);
+    mpMapProgressDialog->show();
+}
+
+void TMainConsole::showMapJsonProgress(const QString& title, const QString& label, const QString& cancelButtonText, int maximum)
+{
+    createMapProgressDialog(title, label, cancelButtonText, 0, maximum);
+    mpMapProgressDialog->setWindowModality(Qt::NonModal);
+    mpMapProgressDialog->setMinimumWidth(500);
+    mpMapProgressDialog->setMinimumDuration(1);
+}
+
+void TMainConsole::setMapProgressDialogLabel(const QString& text)
+{
+    if (mpMapProgressDialog) {
+        mpMapProgressDialog->setLabelText(text);
+    }
+}
+
+void TMainConsole::setMapProgressDialogRange(int minimum, int maximum)
+{
+    if (mpMapProgressDialog) {
+        mpMapProgressDialog->setRange(minimum, maximum);
+    }
+}
+
+void TMainConsole::setMapProgressDialogValue(int value)
+{
+    if (mpMapProgressDialog) {
+        mpMapProgressDialog->setValue(value);
+    }
+}
+
+void TMainConsole::disableMapProgressDialogCancel()
+{
+    if (mpMapProgressDialog) {
+        // Taking the button away does not stop a window-close from emitting
+        // canceled(), so drop the connection as well - by this point the
+        // operation can no longer be stopped. Only ours goes, leaving
+        // QProgressDialog's own canceled() -> cancel() wiring intact.
+        if (auto pHost = getHost(); pHost && !pHost->mpMap.isNull()) {
+            disconnect(mpMapProgressDialog, &QProgressDialog::canceled, pHost->mpMap.data(), &TMap::slot_mapProgressDialogCancelled);
+        }
+        mpMapProgressDialog->setCancelButton(nullptr);
+    }
+}
+
+void TMainConsole::closeMapProgressDialog()
+{
+    if (mpMapProgressDialog) {
+        // hide() rather than close() so we don't re-enter QProgressDialog's
+        // closeEvent -> cancel() while a cancel is already being handled.
+        mpMapProgressDialog->hide();
+        mpMapProgressDialog->deleteLater();
+        // deleteLater() leaves the QPointer set until the event loop gets to
+        // run, which a synchronous JSON operation will not let it do, so forget
+        // the dialog now and make any late writes to it no-ops.
+        mpMapProgressDialog = nullptr;
+    }
+}
+
 void TMainConsole::createMapperDock(const QString& title, const QString& objectName)
 {
     mpDockableMapWidget = new QDockWidget(title);
diff --git a/src/TMainConsole.h b/src/TMainConsole.h
index 4e27139e7..de16a42a5 100644
--- a/src/TMainConsole.h
+++ b/src/TMainConsole.h
@@ -97,6 +97,13 @@ public:
     void showPackageDownloadProgress(const QString& title, const QString& cancelText);
     void updatePackageDownloadProgress(qint64 got, qint64 total);
     void closePackageDownloadProgress();
+    void showMapTransferProgress(const QString& title, const QString& label, const QString& cancelButtonText);
+    void showMapJsonProgress(const QString& title, const QString& label, const QString& cancelButtonText, int maximum);
+    void setMapProgressDialogLabel(const QString& text);
+    void setMapProgressDialogRange(int minimum, int maximum);
+    void setMapProgressDialogValue(int value);
+    void disableMapProgressDialogCancel();
+    void closeMapProgressDialog();
     void createMapperDock(const QString& title, const QString& objectName);
     void showMapperScriptReminder();
     void showUnpackingProgress(const QString& message, const QString& title);
@@ -137,6 +144,7 @@ public:
     QTextStream mLogStream;
     bool mLogToLogFile = false;
     QPointer mpPackageDownloadProgressDialog;
+    QPointer mpMapProgressDialog;
     QPointer mpDockableMapWidget;
     QPointer mpUnpackingDialog;
 
@@ -156,6 +164,8 @@ signals:
 
 
 private:
+    void createMapProgressDialog(const QString& title, const QString& label, const QString& cancelButtonText, int minimum, int maximum);
+
     // Was public in Host class but made private there and cloned to here
     // (for main TConsole) to prevent it being changed without going through the
     // process to load in the changed dictionary:
diff --git a/src/TMap.cpp b/src/TMap.cpp
index 3912181da..dcb17f21a 100644
--- a/src/TMap.cpp
+++ b/src/TMap.cpp
@@ -39,15 +39,14 @@
 #include 
 #include 
 #include 
-#include 
 #include 
 #include 
 #include 
 #include 
 #include 
+#include 
 #include 
 #include 
-#include 
 #include 
 #include 
 #include 
@@ -2500,6 +2499,15 @@ void TMap::downloadMap(const QString& remoteUrl, const QString& localFileName)
         postMessage(warnMsg);
         return;
     }
+
+    if (mMapProgressStandalone) {
+        //: Shown in the main console when a map download is refused
+        const QString warnMsg = tr("[ WARN ]  - Attempt made to download an XML map while a map import or\n"
+                                   "export is already in progress - wait for that operation to complete\n"
+                                   "before retrying!");
+        postMessage(warnMsg);
+        return;
+    }
     mImportRunning = true;
     // MUST clear this flag when done under ALL circumstances
 
@@ -2591,6 +2599,23 @@ bool TMap::importMap(QFile& file, QString* errMsg)
         }
         return false;
     }
+
+    if (mMapProgressStandalone) {
+        // readXmlMapFile() would see the JSON operation's progress dialog as its
+        // own, skip creating one, and then mapClear() the map out from under it:
+        if (errMsg) {
+            //: Error returned by the loadMap() Lua function
+            *errMsg = tr("loadMap: unable to perform request, a map import or export is\n"
+                         "already in progress.");
+        } else {
+            //: Shown in the main console when a map import is refused
+            const QString warnMsg = tr("[ WARN ]  - Attempt made to import an XML map while a map import or\n"
+                                       "export is already in progress - wait for that operation to complete\n"
+                                       "before retrying!");
+            postMessage(warnMsg);
+        }
+        return false;
+    }
     mImportRunning = true;
     // MUST clear this flag when done under ALL circumstances
 
@@ -2828,23 +2853,18 @@ void TMap::createTransferProgress(const QString& title, const QString& label, bo
         return;
     }
 
-    mpProgressDialog = new QProgressDialog(label, cancelable ? tr("Abort") : QString(), 0, 0);
-    mpProgressDialog->setWindowTitle(title);
-    mpProgressDialog->setWindowIcon(QIcon(qsl(":/icons/mudlet_map_download.png")));
-    mpProgressDialog->setMinimumWidth(300);
-    mpProgressDialog->setAutoClose(false);
-    mpProgressDialog->setAutoReset(false);
-    mpProgressDialog->setMinimumDuration(0); // Normally waits for 4 seconds before showing
-    if (cancelable) {
-        connect(mpProgressDialog, &QProgressDialog::canceled, this, &TMap::slot_downloadCancel);
-    }
-    mpProgressDialog->show();
+    mMapProgressStandalone = true;
+    mMapProgressIsTransfer = true;
+    mMapProgressCancelRequested = false;
+    mMapProgressStandaloneMaximum = 0;
+    warnIfMapProgressUnwired(__func__, true);
+    emit signal_mapTransferProgressStart(title, label, cancelable ? tr("Abort") : QString());
 }
 
 void TMap::updateTransferProgressLabel(const QString& text)
 {
-    if (mpProgressDialog) {
-        mpProgressDialog->setLabelText(text);
+    if (mMapProgressStandalone) {
+        emit signal_mapProgressSetLabel(text);
     } else if (mpMapper) {
         mpMapper->setMapProgressLabel(text);
     }
@@ -2852,8 +2872,9 @@ void TMap::updateTransferProgressLabel(const QString& text)
 
 void TMap::updateTransferProgressRange(int minimum, int maximum)
 {
-    if (mpProgressDialog) {
-        mpProgressDialog->setRange(minimum, maximum);
+    if (mMapProgressStandalone) {
+        mMapProgressStandaloneMaximum = maximum;
+        emit signal_mapProgressSetRange(minimum, maximum);
     } else if (mpMapper) {
         mpMapper->setMapProgressRange(minimum, maximum);
     }
@@ -2861,8 +2882,8 @@ void TMap::updateTransferProgressRange(int minimum, int maximum)
 
 void TMap::updateTransferProgressValue(int value)
 {
-    if (mpProgressDialog) {
-        mpProgressDialog->setValue(value);
+    if (mMapProgressStandalone) {
+        emit signal_mapProgressSetValue(value);
     } else if (mpMapper) {
         mpMapper->setMapProgressValue(value);
     }
@@ -2870,8 +2891,8 @@ void TMap::updateTransferProgressValue(int value)
 
 int TMap::transferProgressMaximum() const
 {
-    if (mpProgressDialog) {
-        return mpProgressDialog->maximum();
+    if (mMapProgressStandalone) {
+        return mMapProgressStandaloneMaximum;
     }
     if (mpMapper) {
         return mpMapper->mapProgressMaximum();
@@ -2881,13 +2902,13 @@ int TMap::transferProgressMaximum() const
 
 bool TMap::hasActiveTransferProgress() const
 {
-    return mpProgressDialog != nullptr || (mpMapper && mpMapper->isMapProgressVisible());
+    return mMapProgressStandalone || (mpMapper && mpMapper->isMapProgressVisible());
 }
 
 void TMap::disableTransferProgressCancel()
 {
-    if (mpProgressDialog) {
-        mpProgressDialog->setCancelButton(nullptr);
+    if (mMapProgressStandalone) {
+        emit signal_mapProgressDisableCancel();
     } else if (mpMapper) {
         mpMapper->setMapProgressCancelable(false);
     }
@@ -2895,9 +2916,12 @@ void TMap::disableTransferProgressCancel()
 
 void TMap::clearTransferProgress()
 {
-    if (mpProgressDialog) {
-        mpProgressDialog->deleteLater();
-        mpProgressDialog = nullptr;
+    // Only close a transfer-owned standalone dialog: a concurrent JSON
+    // import/export owns the standalone progress state and must keep it.
+    if (mMapProgressStandalone && mMapProgressIsTransfer) {
+        mMapProgressStandalone = false;
+        mMapProgressIsTransfer = false;
+        emit signal_mapProgressClose();
         return;
     }
     if (mpMapper) {
@@ -2906,6 +2930,28 @@ void TMap::clearTransferProgress()
     }
 }
 
+void TMap::slot_mapProgressDialogCancelled()
+{
+    // The JSON path polls mMapProgressCancelRequested in its increment loop; the
+    // transfer path needs its network reply aborted here.
+    mMapProgressCancelRequested = true;
+    if (mMapProgressIsTransfer) {
+        slot_downloadCancel();
+    }
+}
+
+void TMap::warnIfMapProgressUnwired(const char* context, const bool transferPath)
+{
+    static const QMetaMethod transferStart = QMetaMethod::fromSignal(&TMap::signal_mapTransferProgressStart);
+    static const QMetaMethod jsonStart = QMetaMethod::fromSignal(&TMap::signal_mapJsonProgressStart);
+    static const QMetaMethod progressClose = QMetaMethod::fromSignal(&TMap::signal_mapProgressClose);
+    if (isSignalConnected(transferPath ? transferStart : jsonStart) && isSignalConnected(progressClose)) {
+        return;
+    }
+    qWarning().nospace() << "TMap::" << context
+                         << "() WARNING - no frontend is connected to show the map progress dialog; the operation will run without a visible progress dialog and cannot be canceled from one.";
+}
+
 QHash> TMap::roomSymbolsHash()
 {
     QHash> results;
@@ -2989,7 +3035,7 @@ std::pair TMap::writeJsonMapFile(const QString& dest)
         destination.append(QLatin1String(".json"));
     }
 
-    if (mpProgressDialog) {
+    if (mMapProgressStandalone) {
         return {false, qsl("import or export already in progress")};
     }
 
@@ -3002,35 +3048,31 @@ std::pair TMap::writeJsonMapFile(const QString& dest)
         }
     }
 
-    mpProgressDialog = new QProgressDialog(tr("Exporting JSON map data from %1\n"
-                                              "Areas: %2 of: %3   Rooms: %4 of: %5   Labels: %6 of: %7...")
-                                                   .arg(mProfileName,
-                                                        QLatin1String("0"),
-                                                        QString::number(mProgressDialogAreasTotal),
-                                                        QLatin1String("0"),
-                                                        QString::number(mProgressDialogRoomsTotal),
-                                                        QLatin1String("0"),
-                                                        QString::number(mProgressDialogLabelsTotal)),
-                                           tr("Abort"),
-                                           0,
-                                           mProgressDialogRoomsTotal,
-                                           mpHost->mpConsole);
-    mpProgressDialog->setValue(0);
-    mpProgressDialog->setWindowModality(Qt::NonModal);
+    mMapProgressStandalone = true;
+    mMapProgressIsTransfer = false;
+    mMapProgressCancelRequested = false;
+    mMapProgressStandaloneMaximum = static_cast(mProgressDialogRoomsTotal);
+    warnIfMapProgressUnwired(__func__, false);
     //: This is a title of a progress window.
-    mpProgressDialog->setWindowTitle(tr("Map JSON export"));
-    mpProgressDialog->setWindowIcon(QIcon(qsl(":/icons/mudlet_map_download.png")));
-    mpProgressDialog->setMinimumWidth(500);
-    mpProgressDialog->setAutoClose(false);
-    mpProgressDialog->setAutoReset(false);
-    mpProgressDialog->setMinimumDuration(1); // Normally waits for 4 seconds before showing
+    emit signal_mapJsonProgressStart(tr("Map JSON export"),
+                                     tr("Exporting JSON map data from %1\n"
+                                        "Areas: %2 of: %3   Rooms: %4 of: %5   Labels: %6 of: %7...")
+                                             .arg(mProfileName,
+                                                  QLatin1String("0"),
+                                                  QString::number(mProgressDialogAreasTotal),
+                                                  QLatin1String("0"),
+                                                  QString::number(mProgressDialogRoomsTotal),
+                                                  QLatin1String("0"),
+                                                  QString::number(mProgressDialogLabelsTotal)),
+                                     tr("Abort"),
+                                     static_cast(mProgressDialogRoomsTotal));
+    emit signal_mapProgressSetValue(0);
     qApp->processEvents();
     QSaveFile file(destination);
     if (!file.open(QFile::OpenMode(QFile::Text | QFile::WriteOnly))) {
         qWarning().noquote().nospace() << "TMap::writeJsonMapFile(...) WARNING - Could not open save file \"" << destination << "\".";
-        mpProgressDialog->setAttribute(Qt::WA_DeleteOnClose, true);
-        mpProgressDialog->close();
-        mpProgressDialog = nullptr;
+        emit signal_mapProgressClose();
+        mMapProgressStandalone = false;
         return {false, qsl("could not open save file \"%1\", reason: %2").arg(destination.toHtmlEscaped(), file.errorString())};
     }
 
@@ -3066,9 +3108,8 @@ std::pair TMap::writeJsonMapFile(const QString& dest)
     }
     if (abort) {
         file.cancelWriting();
-        mpProgressDialog->setAttribute(Qt::WA_DeleteOnClose, true);
-        mpProgressDialog->close();
-        mpProgressDialog = nullptr;
+        emit signal_mapProgressClose();
+        mMapProgressStandalone = false;
         return {false, qsl("aborted by user")};
     }
 
@@ -3147,20 +3188,19 @@ std::pair TMap::writeJsonMapFile(const QString& dest)
     mapObj.insert(QLatin1String("playerRoomOuterDiameterPercentage"), static_cast(mPlayerRoomOuterDiameterPercentage));
     mapObj.insert(QLatin1String("playerRoomInnerDiameterPercentage"), static_cast(mPlayerRoomInnerDiameterPercentage));
 
-    mpProgressDialog->setLabelText(tr("Exporting JSON map file from %1 - writing data to file:\n"
-                                      "%2 ...")
-                                           .arg(mProfileName, destination));
-    mpProgressDialog->setValue(0);
+    emit signal_mapProgressSetLabel(tr("Exporting JSON map file from %1 - writing data to file:\n"
+                                       "%2 ...")
+                                            .arg(mProfileName, destination));
+    emit signal_mapProgressSetValue(0);
     // Hide the cancel button as we can't stop now:
-    mpProgressDialog->setCancelButton(nullptr);
+    emit signal_mapProgressDisableCancel();
     file.write(QJsonDocument(mapObj).toJson(QJsonDocument::Indented));
     if (!file.commit()) {
         qDebug() << "TMap::writeJsonMapFile: error saving JSON map: " << file.errorString();
     }
 
-    mpProgressDialog->setAttribute(Qt::WA_DeleteOnClose, true);
-    mpProgressDialog->close();
-    mpProgressDialog = nullptr;
+    emit signal_mapProgressClose();
+    mMapProgressStandalone = false;
 
     return {file.error() == QFileDevice::NoError, ((file.error() == QFileDevice::NoError) ? QString() : qsl("could not export file, reason: %1").arg(file.errorString()))};
 }
@@ -3168,12 +3208,12 @@ std::pair TMap::writeJsonMapFile(const QString& dest)
 // The translatable messages are used within this file and do not need to
 // mention the file concerned whereas the untranslated messages are used by the
 // Lua sub-system and do need to report the file:
-std::pair TMap::readJsonMapFile(const QString& source, const bool translatableTexts, const bool allowUserCancellation)
+std::pair TMap::readJsonMapFile(const QString& source, const bool translatableTexts)
 {
     const QString oldDefaultAreaName{mDefaultAreaName};
     const QString oldUnnamedName{mUnnamedAreaName};
 
-    if (mpProgressDialog) {
+    if (mMapProgressStandalone) {
         return {false, (translatableTexts ? tr("import or export already in progress") : qsl("import or export already in progress"))};
     }
 
@@ -3227,28 +3267,25 @@ std::pair TMap::readJsonMapFile(const QString& source, const bool
     mProgressDialogRoomsCount = 0;
     mProgressDialogLabelsTotal = qRound(mapObj[QLatin1String("labelCount")].toDouble());
     mProgressDialogLabelsCount = 0;
-    mpProgressDialog = new QProgressDialog(tr("Importing JSON map data to %1\n"
-                                              "Areas: %2 of: %3   Rooms: %4 of: %5   Labels: %6 of: %7...")
-                                                   .arg(mProfileName,
-                                                        QLatin1String("0"),
-                                                        QString::number(mProgressDialogAreasTotal),
-                                                        QLatin1String("0"),
-                                                        QString::number(mProgressDialogRoomsTotal),
-                                                        QLatin1String("0"),
-                                                        QString::number(mProgressDialogLabelsTotal)),
-                                           (allowUserCancellation ? tr("Abort") : QString()),
-                                           0,
-                                           mProgressDialogRoomsTotal,
-                                           mpHost->mpConsole);
-    mpProgressDialog->setValue(0);
-    mpProgressDialog->setWindowModality(Qt::NonModal);
+    mMapProgressStandalone = true;
+    mMapProgressIsTransfer = false;
+    mMapProgressCancelRequested = false;
+    mMapProgressStandaloneMaximum = static_cast(mProgressDialogRoomsTotal);
+    warnIfMapProgressUnwired(__func__, false);
     //: This is a title of a progress window.
-    mpProgressDialog->setWindowTitle(tr("Map JSON import"));
-    mpProgressDialog->setWindowIcon(QIcon(qsl(":/icons/mudlet_map_download.png")));
-    mpProgressDialog->setMinimumWidth(500);
-    mpProgressDialog->setAutoClose(false);
-    mpProgressDialog->setAutoReset(false);
-    mpProgressDialog->setMinimumDuration(1); // Normally waits for 4 seconds before showing
+    emit signal_mapJsonProgressStart(tr("Map JSON import"),
+                                     tr("Importing JSON map data to %1\n"
+                                        "Areas: %2 of: %3   Rooms: %4 of: %5   Labels: %6 of: %7...")
+                                             .arg(mProfileName,
+                                                  QLatin1String("0"),
+                                                  QString::number(mProgressDialogAreasTotal),
+                                                  QLatin1String("0"),
+                                                  QString::number(mProgressDialogRoomsTotal),
+                                                  QLatin1String("0"),
+                                                  QString::number(mProgressDialogLabelsTotal)),
+                                     tr("Abort"),
+                                     static_cast(mProgressDialogRoomsTotal));
+    emit signal_mapProgressSetValue(0);
     qApp->processEvents();
 
     mDefaultAreaName = mapObj[QLatin1String("defaultAreaName")].toString();
@@ -3325,18 +3362,15 @@ std::pair TMap::readJsonMapFile(const QString& source, const bool
         auto [id, name] = pArea->readJsonArea(mapObj.value(QLatin1String("areas")).toArray(), i);
         ++mProgressDialogAreasCount;
         if (incrementJsonProgressDialog(false, true, 0)) {
-            if (allowUserCancellation) {
-                abort = true;
-            }
+            abort = true;
             break;
         }
         // This will populate the TRoomDB::areas and TRoomDB::areaNameMap:
         pNewRoomDB->addArea(pArea.release(), id, name);
     }
     if (abort) {
-        mpProgressDialog->setAttribute(Qt::WA_DeleteOnClose, true);
-        mpProgressDialog->close();
-        mpProgressDialog = nullptr;
+        emit signal_mapProgressClose();
+        mMapProgressStandalone = false;
         mDefaultAreaName = oldDefaultAreaName;
         mUnnamedAreaName = oldUnnamedName;
         return {false, (translatableTexts ? tr("aborted by user") : qsl("aborted by user"))};
@@ -3368,9 +3402,8 @@ std::pair TMap::readJsonMapFile(const QString& source, const bool
     if (mpMapper && mpMapper->mp2dMap) {
         mpMapper->mp2dMap->setPlayerRoomStyle(mPlayerRoomStyle);
     }
-    mpProgressDialog->setAttribute(Qt::WA_DeleteOnClose, true);
-    mpProgressDialog->close();
-    mpProgressDialog = nullptr;
+    emit signal_mapProgressClose();
+    mMapProgressStandalone = false;
     return {true, QString()};
 }
 
@@ -3469,30 +3502,30 @@ bool TMap::incrementJsonProgressDialog(const bool isExportNotImport, const bool
         mProgressDialogLabelsCount += increment;
     }
 
-    mpProgressDialog->setValue(mProgressDialogRoomsCount);
+    emit signal_mapProgressSetValue(static_cast(mProgressDialogRoomsCount));
     if (isExportNotImport) {
-        mpProgressDialog->setLabelText(tr("Exporting JSON map data from %1\n"
-                                          "Areas: %2 of: %3   Rooms: %4 of: %5   Labels: %6 of: %7...")
-                                               .arg(mProfileName,
-                                                    QString::number(mProgressDialogAreasCount),
-                                                    QString::number(mProgressDialogAreasTotal),
-                                                    QString::number(mProgressDialogRoomsCount),
-                                                    QString::number(mProgressDialogRoomsTotal),
-                                                    QString::number(mProgressDialogLabelsCount),
-                                                    QString::number(mProgressDialogLabelsTotal)));
+        emit signal_mapProgressSetLabel(tr("Exporting JSON map data from %1\n"
+                                           "Areas: %2 of: %3   Rooms: %4 of: %5   Labels: %6 of: %7...")
+                                                .arg(mProfileName,
+                                                     QString::number(mProgressDialogAreasCount),
+                                                     QString::number(mProgressDialogAreasTotal),
+                                                     QString::number(mProgressDialogRoomsCount),
+                                                     QString::number(mProgressDialogRoomsTotal),
+                                                     QString::number(mProgressDialogLabelsCount),
+                                                     QString::number(mProgressDialogLabelsTotal)));
     } else {
-        mpProgressDialog->setLabelText(tr("Importing JSON map data to %1\n"
-                                          "Areas: %2 of: %3   Rooms: %4 of: %5   Labels: %6 of: %7...")
-                                               .arg(mProfileName,
-                                                    QString::number(mProgressDialogAreasCount),
-                                                    QString::number(mProgressDialogAreasTotal),
-                                                    QString::number(mProgressDialogRoomsCount),
-                                                    QString::number(mProgressDialogRoomsTotal),
-                                                    QString::number(mProgressDialogLabelsCount),
-                                                    QString::number(mProgressDialogLabelsTotal)));
+        emit signal_mapProgressSetLabel(tr("Importing JSON map data to %1\n"
+                                           "Areas: %2 of: %3   Rooms: %4 of: %5   Labels: %6 of: %7...")
+                                                .arg(mProfileName,
+                                                     QString::number(mProgressDialogAreasCount),
+                                                     QString::number(mProgressDialogAreasTotal),
+                                                     QString::number(mProgressDialogRoomsCount),
+                                                     QString::number(mProgressDialogRoomsTotal),
+                                                     QString::number(mProgressDialogLabelsCount),
+                                                     QString::number(mProgressDialogLabelsTotal)));
     }
     qApp->processEvents();
-    return mpProgressDialog->wasCanceled();
+    return mMapProgressCancelRequested;
 }
 
 void TMap::updateArea(int areaId)
diff --git a/src/TMap.h b/src/TMap.h
index 616e9baec..844b8eb5a 100644
--- a/src/TMap.h
+++ b/src/TMap.h
@@ -67,7 +67,6 @@ class TRoom;
 class TRoomDB;
 class QFile;
 class QNetworkAccessManager;
-class QProgressDialog;
 class MapInfoContributorManager;
 
 class TMap : public QObject
@@ -79,6 +78,18 @@ signals:
     void signal_areaChanged(int areaId);
     void signal_mmpMapLocationChanged();
 
+    // Map-progress seam for the libmudlet split (#8681, #9011): the map engine
+    // must stay free of Qt Widgets, so it emits these pre-translated payloads for
+    // the frontend (TMainConsole) to render as a QProgressDialog. Cancellation
+    // returns through slot_mapProgressDialogCancelled().
+    void signal_mapTransferProgressStart(const QString& title, const QString& label, const QString& cancelButtonText);
+    void signal_mapJsonProgressStart(const QString& title, const QString& label, const QString& cancelButtonText, int maximum);
+    void signal_mapProgressSetLabel(const QString& text);
+    void signal_mapProgressSetRange(int minimum, int maximum);
+    void signal_mapProgressSetValue(int value);
+    void signal_mapProgressDisableCancel();
+    void signal_mapProgressClose();
+
 private:
     QString mDefaultAreaName;
     QString mUnnamedAreaName;
@@ -160,9 +171,10 @@ public:
     void reportProgressToProgressDialog(int, int);
 
     // Download/import progress helpers. Use the inline progress widget in the
-    // mapper when it is visible, otherwise fall back to a modal QProgressDialog.
-    // Do NOT use these from the JSON export/import paths - those keep their own
-    // dedicated QProgressDialog.
+    // mapper when it is visible, otherwise ask the frontend for a standalone
+    // progress dialog via signal_mapTransferProgressStart(). Do NOT use these
+    // from the JSON export/import paths - those drive their own frontend dialog
+    // through signal_mapJsonProgressStart().
     void createTransferProgress(const QString& title, const QString& label, bool cancelable);
     void updateTransferProgressLabel(const QString& text);
     void updateTransferProgressRange(int minimum, int maximum);
@@ -185,7 +197,7 @@ public:
     void setRoomNamesShown(bool shown);
 
     std::pair writeJsonMapFile(const QString&);
-    std::pair readJsonMapFile(const QString&, const bool translatableTexts = false, const bool allowUserCancellation = true);
+    std::pair readJsonMapFile(const QString&, const bool translatableTexts = false);
     qsizetype getCurrentProgressRoomCount() const { return mProgressDialogRoomsCount; }
     bool incrementJsonProgressDialog(const bool isExportNotImport, const bool isRoomNotLabel, const int increment = 1);
     QString getDefaultAreaName() const { return mDefaultAreaName; }
@@ -363,6 +375,9 @@ public slots:
     void slot_downloadCancel();
     void slot_downloadError(QNetworkReply::NetworkError);
     void slot_replyFinished(QNetworkReply*);
+    // Called by the frontend when the user cancels the standalone map-progress
+    // dialog it owns on our behalf.
+    void slot_mapProgressDialogCancelled();
 
 
 private:
@@ -375,6 +390,7 @@ private:
                              const QString& exitKey,
                              const QSet& unUsableRoomSet);
     const QString createFileHeaderLine(QString, QChar);
+    void warnIfMapProgressUnwired(const char* context, bool transferPath);
     void writeJsonUserData(QJsonObject&) const;
     void readJsonUserData(const QJsonObject&);
     bool validatePotentialMapFile(QFile&, QDataStream&);
@@ -401,7 +417,13 @@ private:
     int mExpectedFileSize = 0;
     bool mImportRunning = false;
 
-    QProgressDialog* mpProgressDialog = nullptr;
+    // Engine-side mirror of the frontend-owned dialog, which the engine can't
+    // read back. mMapProgressStandalone also serves as the "import/export already
+    // running" guard (see writeJsonMapFile()/readJsonMapFile()).
+    bool mMapProgressStandalone = false;
+    bool mMapProgressIsTransfer = false;
+    bool mMapProgressCancelRequested = false;
+    int mMapProgressStandaloneMaximum = 0;
     // Using during updates of text in progress dialog partially from other
     // classes:
     qsizetype mProgressDialogAreasTotal = 0;
diff --git a/src/XMLimport.cpp b/src/XMLimport.cpp
index dd052e49c..6436b4106 100644
--- a/src/XMLimport.cpp
+++ b/src/XMLimport.cpp
@@ -35,6 +35,8 @@
 #include "mudlet.h"
 
 #include 
+#include 
+#include 
 #include 
 #include 
 
@@ -226,7 +228,7 @@ std::pair XMLimport::importPackage(QFile* pfile, QString packName
 std::pair XMLimport::importFromClipboard()
 {
     QString xml;
-    QClipboard* clipboard = QApplication::clipboard();
+    QClipboard* clipboard = QGuiApplication::clipboard();
     std::pair result;
 
     xml = clipboard->text(QClipboard::Clipboard);
diff --git a/src/XMLimport.h b/src/XMLimport.h
index a98de68a1..c2a81d8b5 100644
--- a/src/XMLimport.h
+++ b/src/XMLimport.h
@@ -27,13 +27,11 @@
 
 #include "dlgTriggerEditor.h"
 
-#include 
 #include 
 #include 
 #include 
 #include 
 #include 
-#include 
 
 class Host;
 class TAction;
@@ -100,7 +98,7 @@ private:
     void readHiddenVariables();
 
     void readStringList(QStringList&, const QString&);
-    void readIntegerList(QList&, const QString& parentName, const QString &whatIsParent);
+    void readIntegerList(QList&, const QString& parentName, const QString& whatIsParent);
     void readModulesDetailsMap(QMap&);
     void getVersionString(QString&);
     QString readScriptElement();
@@ -126,7 +124,7 @@ private:
     bool gotScript = false;
     int module = 0;
     int mMaxRoomId = 0;
-    quint8 mVersionMajor = 1; // 0 to 255
+    quint8 mVersionMajor = 1;  // 0 to 255
     quint16 mVersionMinor = 0; // 0 to 999 for 3 digit decimal value. Cannot be a quint8 as that only allows x.255 for the decimal
 };
 
diff --git a/src/dlgConnectionProfiles.cpp b/src/dlgConnectionProfiles.cpp
index 0611b1ce5..4a35b10c9 100644
--- a/src/dlgConnectionProfiles.cpp
+++ b/src/dlgConnectionProfiles.cpp
@@ -37,6 +37,7 @@
 
 #include 
 #include 
+#include 
 #include 
 #include 
 #include 
diff --git a/src/dlgTriggerEditor.cpp b/src/dlgTriggerEditor.cpp
index ef9eb02f2..b9a5ca924 100644
--- a/src/dlgTriggerEditor.cpp
+++ b/src/dlgTriggerEditor.cpp
@@ -57,6 +57,7 @@
 #include "utils.h"
 #include "edbee/models/textdocumentscopes.h"
 
+#include 
 #include 
 #include 
 #include 
diff --git a/src/mudlet.cpp b/src/mudlet.cpp
index 4aa8ec22d..2a22b9a99 100644
--- a/src/mudlet.cpp
+++ b/src/mudlet.cpp
@@ -2207,6 +2207,21 @@ void mudlet::addConsoleForNewHost(Host* pH)
     connect(pH, &Host::signal_showUnpackingProgress, pConsole, &TMainConsole::showUnpackingProgress, Qt::UniqueConnection);
     connect(pH, &Host::signal_hideUnpackingProgress, pConsole, &TMainConsole::closeUnpackingProgress, Qt::UniqueConnection);
 
+    // Wire the map engine's progress signals to the console that owns the dialog.
+    // Must be connected before the profile's map is loaded (further down in
+    // slot_connectionDialogueFinished()), or early map operations have no
+    // frontend to show progress.
+    if (!pH->mpMap.isNull()) {
+        auto pMap = pH->mpMap.data();
+        connect(pMap, &TMap::signal_mapTransferProgressStart, pConsole, &TMainConsole::showMapTransferProgress, Qt::UniqueConnection);
+        connect(pMap, &TMap::signal_mapJsonProgressStart, pConsole, &TMainConsole::showMapJsonProgress, Qt::UniqueConnection);
+        connect(pMap, &TMap::signal_mapProgressSetLabel, pConsole, &TMainConsole::setMapProgressDialogLabel, Qt::UniqueConnection);
+        connect(pMap, &TMap::signal_mapProgressSetRange, pConsole, &TMainConsole::setMapProgressDialogRange, Qt::UniqueConnection);
+        connect(pMap, &TMap::signal_mapProgressSetValue, pConsole, &TMainConsole::setMapProgressDialogValue, Qt::UniqueConnection);
+        connect(pMap, &TMap::signal_mapProgressDisableCancel, pConsole, &TMainConsole::disableMapProgressDialogCancel, Qt::UniqueConnection);
+        connect(pMap, &TMap::signal_mapProgressClose, pConsole, &TMainConsole::closeMapProgressDialog, Qt::UniqueConnection);
+    }
+
     if (pH->mpMedia) {
         // Pin DirectConnection so the bool& out-parameter is filled synchronously, never queued.
         connect(pH->mpMedia.data(), &TMedia::signal_setupVideoOutput, pConsole, &TMainConsole::setupVideoOutput, static_cast(Qt::DirectConnection | Qt::UniqueConnection));
diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt
index 07423a104..59578a602 100644
--- a/test/functional_tests/CMakeLists.txt
+++ b/test/functional_tests/CMakeLists.txt
@@ -31,6 +31,7 @@ set(FUNCTIONAL_TEST_SOURCES
     ProfileLoadTempFileTest.cpp
     PackageSelfUninstallTest.cpp
     MapRoundTripTest.cpp
+    MapProgressDialogSeamTest.cpp
     UndoServerWrapTest.cpp
     HostWidgetDecouplingTest.cpp
     ActionSelfUninstallTest.cpp
@@ -100,7 +101,7 @@ set_tests_properties(LogRestartDuplicateLineTest PROPERTIES TIMEOUT 300)
 
 # The round-trip tests boot a full mudlet instance and save/reload profile and
 # map data, so they need a longer timeout
-set_tests_properties(ProfileRoundTripTest MapRoundTripTest PROPERTIES TIMEOUT 300)
+set_tests_properties(ProfileRoundTripTest MapRoundTripTest MapProgressDialogSeamTest PROPERTIES TIMEOUT 300)
 
 # HostWidgetDecouplingTest creates a fresh profile per test method, so it needs a longer timeout
 set_tests_properties(HostWidgetDecouplingTest PROPERTIES TIMEOUT 300)
diff --git a/test/functional_tests/MapProgressDialogSeamTest.cpp b/test/functional_tests/MapProgressDialogSeamTest.cpp
new file mode 100644
index 000000000..f17acfbfa
--- /dev/null
+++ b/test/functional_tests/MapProgressDialogSeamTest.cpp
@@ -0,0 +1,297 @@
+/***************************************************************************
+ *   Copyright (C) 2026 by Mudlet Developers                               *
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the GNU General Public License as published by  *
+ *   the Free Software Foundation; either version 2 of the License, or     *
+ *   (at your option) any later version.                                   *
+ *                                                                         *
+ *   This program is distributed in the hope that it will be useful,       *
+ *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
+ *   GNU General Public License for more details.                          *
+ *                                                                         *
+ *   You should have received a copy of the GNU General Public License     *
+ *   along with this program; if not, write to the                         *
+ *   Free Software Foundation, Inc.,                                       *
+ *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
+ ***************************************************************************/
+
+/*
+ * Tests the map-progress seam introduced for the libmudlet split (#8681,
+ * #9011): the Qt-Widgets-free TMap no longer owns a QProgressDialog and instead
+ * emits pre-translated payloads for the frontend to render, while cancellation
+ * returns through TMap::slot_mapProgressDialogCancelled().
+ *
+ * These tests stand in for the frontend with plain signal recorders and drive
+ * the engine directly, so they verify the engine half of the seam without any
+ * widget:
+ *   - the download/XML transfer-progress state machine emits the right signals
+ *     and keeps its own maximum/active state (the old QProgressDialog read-backs)
+ *   - a JSON export and re-import announce and close their progress dialogs and
+ *     leave no stuck "operation already in progress" state
+ *   - a cancel delivered through the seam mid-import makes the JSON reader abort,
+ *     the exact behaviour that used to depend on QProgressDialog::wasCanceled()
+ *
+ * Run with: ctest -R MapProgressDialogSeamTest -V
+ */
+
+#include 
+
+#include 
+#include 
+
+#include "Host.h"
+#include "HostManager.h"
+#include "MudletInstanceCoordinator.h"
+#include "TMap.h"
+#include "TRoomDB.h"
+#include "mudlet.h"
+
+extern void qInitResources_mudlet();
+extern void qInitResources_qm();
+extern void qInitResources_additional_splash_screens();
+extern void qInitResources_mudlet_fonts_common();
+extern void qInitResources_mudlet_fonts_posix();
+void initializeQRCResourcesForMapProgressDialogSeamTest();
+
+class MapProgressDialogSeamTest : public QObject
+{
+    Q_OBJECT
+
+private:
+    Host* mpSource = nullptr;
+    Host* mpTarget = nullptr;
+    const QString mSourceName = qsl("MapProgressSeamSource-Test");
+    const QString mTargetName = qsl("MapProgressSeamTarget-Test");
+    QTemporaryDir mSaveDir;
+
+    void buildSmallMap(Host* pHost)
+    {
+        TMap* pMap = pHost->mpMap.data();
+        TRoomDB* pDB = pMap->mpRoomDB.get();
+        const int areaA = pDB->addArea(qsl("Area A"));
+        const int areaB = pDB->addArea(qsl("Area B"));
+        QVERIFY(areaA > 0);
+        QVERIFY(areaB > 0);
+        int id = 1;
+        for (const int areaId : {areaA, areaB}) {
+            for (int i = 0; i < 3; ++i, ++id) {
+                QVERIFY(pMap->addRoom(id));
+                QVERIFY(pMap->setRoomArea(id, areaId, false));
+                QVERIFY(pMap->setRoomCoordinates(id, i, i, 0));
+            }
+        }
+    }
+
+    void deleteProfileDirectory(const QString& profileName)
+    {
+        const QString path = mudlet::getMudletPath(enums::profileHomePath, profileName);
+        QDir dir(path);
+        if (dir.exists()) {
+            dir.removeRecursively();
+        }
+    }
+
+private slots:
+    void initTestCase()
+    {
+        initializeQRCResourcesForMapProgressDialogSeamTest();
+
+        mudlet::start();
+        mudlet::self()->setupConfig();
+        mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique("MudletInstanceCoordinator"));
+        mudlet::self()->init();
+        mudlet::self()->setStorePasswordsSecurely(false);
+        deleteProfileDirectory(mSourceName);
+        deleteProfileDirectory(mTargetName);
+
+        QVERIFY(mSaveDir.isValid());
+
+        auto& hostManager = mudlet::self()->getHostManager();
+        QVERIFY2(hostManager.addHost(mSourceName, qsl("23"), QString(), QString()), "failed to create the source Host");
+        mpSource = hostManager.getHost(mSourceName);
+        QVERIFY(mpSource);
+        QVERIFY2(hostManager.addHost(mTargetName, qsl("23"), QString(), QString()), "failed to create the target Host");
+        mpTarget = hostManager.getHost(mTargetName);
+        QVERIFY(mpTarget);
+
+        buildSmallMap(mpSource);
+        if (QTest::currentTestFailed()) {
+            return;
+        }
+    }
+
+    void cleanupTestCase()
+    {
+        mpSource = nullptr;
+        mpTarget = nullptr;
+        deleteProfileDirectory(mSourceName);
+        deleteProfileDirectory(mTargetName);
+        delete mudlet::self();
+    }
+
+    // The download/XML transfer path: with no visible mapper the engine takes
+    // the standalone-dialog branch, which must now be pure signals plus the
+    // engine-side state that replaced the QProgressDialog read-backs.
+    void test_transferProgressStateMachine()
+    {
+        TMap* pMap = mpSource->mpMap.data();
+        QSignalSpy startSpy(pMap, &TMap::signal_mapTransferProgressStart);
+        QSignalSpy rangeSpy(pMap, &TMap::signal_mapProgressSetRange);
+        QSignalSpy valueSpy(pMap, &TMap::signal_mapProgressSetValue);
+        QSignalSpy labelSpy(pMap, &TMap::signal_mapProgressSetLabel);
+        QSignalSpy disableSpy(pMap, &TMap::signal_mapProgressDisableCancel);
+        QSignalSpy closeSpy(pMap, &TMap::signal_mapProgressClose);
+        QVERIFY(startSpy.isValid());
+
+        QVERIFY(!pMap->hasActiveTransferProgress());
+
+        pMap->createTransferProgress(qsl("A title"), qsl("A label"), true);
+        QCOMPARE(startSpy.count(), 1);
+        QCOMPARE(startSpy.at(0).at(0).toString(), qsl("A title"));
+        QCOMPARE(startSpy.at(0).at(1).toString(), qsl("A label"));
+        // cancelable == true carries the pre-translated Abort button text:
+        QCOMPARE(startSpy.at(0).at(2).toString(), qsl("Abort"));
+        QVERIFY(pMap->hasActiveTransferProgress());
+        QCOMPARE(pMap->transferProgressMaximum(), 0);
+
+        pMap->updateTransferProgressRange(0, 100);
+        QCOMPARE(rangeSpy.count(), 1);
+        QCOMPARE(rangeSpy.at(0).at(1).toInt(), 100);
+        // Read-back must come from the engine's cached maximum, not a widget:
+        QCOMPARE(pMap->transferProgressMaximum(), 100);
+
+        pMap->updateTransferProgressValue(42);
+        QCOMPARE(valueSpy.count(), 1);
+        QCOMPARE(valueSpy.at(0).at(0).toInt(), 42);
+
+        pMap->updateTransferProgressLabel(qsl("Working"));
+        QCOMPARE(labelSpy.count(), 1);
+        QCOMPARE(labelSpy.at(0).at(0).toString(), qsl("Working"));
+
+        pMap->disableTransferProgressCancel();
+        QCOMPARE(disableSpy.count(), 1);
+
+        pMap->clearTransferProgress();
+        QCOMPARE(closeSpy.count(), 1);
+        QVERIFY(!pMap->hasActiveTransferProgress());
+    }
+
+    void test_jsonExportImportDrivesProgressSignals()
+    {
+        TMap* pSourceMap = mpSource->mpMap.data();
+        const QString file = qsl("%1/seam.json").arg(mSaveDir.path());
+
+        QSignalSpy exportStartSpy(pSourceMap, &TMap::signal_mapJsonProgressStart);
+        QSignalSpy exportCloseSpy(pSourceMap, &TMap::signal_mapProgressClose);
+        const auto [wrote, writeMsg] = pSourceMap->writeJsonMapFile(file);
+        QVERIFY2(wrote, qPrintable(writeMsg));
+        QCOMPARE(exportStartSpy.count(), 1);
+        QCOMPARE(exportStartSpy.at(0).at(0).toString(), qsl("Map JSON export"));
+        // Exactly one close: a second would mean the dialog was torn down twice:
+        QCOMPARE(exportCloseSpy.count(), 1);
+        // The engine must not stay "in progress" (that would reject the next op):
+        QVERIFY(!pSourceMap->hasActiveTransferProgress());
+
+        TMap* pTargetMap = mpTarget->mpMap.data();
+        QSignalSpy importStartSpy(pTargetMap, &TMap::signal_mapJsonProgressStart);
+        QSignalSpy importCloseSpy(pTargetMap, &TMap::signal_mapProgressClose);
+        const auto [read, readMsg] = pTargetMap->readJsonMapFile(file);
+        QVERIFY2(read, qPrintable(readMsg));
+        QCOMPARE(importStartSpy.count(), 1);
+        QCOMPARE(importStartSpy.at(0).at(0).toString(), qsl("Map JSON import"));
+        QCOMPARE(importCloseSpy.count(), 1);
+        QVERIFY(!pTargetMap->hasActiveTransferProgress());
+    }
+
+    // The highest-risk seam: the JSON reader used to poll
+    // QProgressDialog::wasCanceled(); it now polls a flag set by
+    // slot_mapProgressDialogCancelled(). Acting as the frontend, deliver a
+    // cancel the instant the import announces its dialog and confirm the read
+    // aborts with the user-cancel result and clears its state.
+    void test_jsonImportCancellationAbortsViaSeam()
+    {
+        TMap* pSourceMap = mpSource->mpMap.data();
+        const QString file = qsl("%1/cancel.json").arg(mSaveDir.path());
+        // Spying on both ends of a dialog's life also stands in for a wired-up
+        // frontend, so the engine's "nobody is showing this" warning stays quiet:
+        QSignalSpy exportStartSpy(pSourceMap, &TMap::signal_mapJsonProgressStart);
+        QSignalSpy exportCloseSpy(pSourceMap, &TMap::signal_mapProgressClose);
+        const auto [wrote, writeMsg] = pSourceMap->writeJsonMapFile(file);
+        QVERIFY2(wrote, qPrintable(writeMsg));
+        QCOMPARE(exportStartSpy.count(), 1);
+        QCOMPARE(exportCloseSpy.count(), 1);
+
+        TMap* pTargetMap = mpTarget->mpMap.data();
+        QSignalSpy importCloseSpy(pTargetMap, &TMap::signal_mapProgressClose);
+        const QMetaObject::Connection cancelOnStart = connect(pTargetMap, &TMap::signal_mapJsonProgressStart, pTargetMap, [pTargetMap]() {
+            pTargetMap->slot_mapProgressDialogCancelled();
+        });
+        const auto [read, readMsg] = pTargetMap->readJsonMapFile(file);
+        disconnect(cancelOnStart);
+
+        QVERIFY(!read);
+        QCOMPARE(readMsg, qsl("aborted by user"));
+        // An aborted import must still take its progress dialog down with it:
+        QCOMPARE(importCloseSpy.count(), 1);
+        QVERIFY(!pTargetMap->hasActiveTransferProgress());
+    }
+
+    // An XML map import started while a JSON operation owns the progress dialog
+    // must be refused: readXmlMapFile() would otherwise mistake the JSON
+    // operation's dialog for its own and mapClear() the map mid-import. The
+    // re-entrancy is real - a Lua loadMap() from a timer lands in the
+    // qApp->processEvents() the JSON reader pumps.
+    void test_xmlImportRefusedWhileJsonOperationOwnsProgress()
+    {
+        TMap* pSourceMap = mpSource->mpMap.data();
+        const QString file = qsl("%1/reentrancy.json").arg(mSaveDir.path());
+        QSignalSpy exportStartSpy(pSourceMap, &TMap::signal_mapJsonProgressStart);
+        QSignalSpy exportCloseSpy(pSourceMap, &TMap::signal_mapProgressClose);
+        const auto [wrote, writeMsg] = pSourceMap->writeJsonMapFile(file);
+        QVERIFY2(wrote, qPrintable(writeMsg));
+        QCOMPARE(exportStartSpy.count(), 1);
+        QCOMPARE(exportCloseSpy.count(), 1);
+
+        TMap* pTargetMap = mpTarget->mpMap.data();
+        QSignalSpy importCloseSpy(pTargetMap, &TMap::signal_mapProgressClose);
+        bool importAttempted = false;
+        bool importAccepted = true;
+        QString importError;
+        const QMetaObject::Connection reenter = connect(pTargetMap, &TMap::signal_mapJsonProgressStart, pTargetMap, [&]() {
+            importAttempted = true;
+            QFile xmlMap(qsl("%1/no-such-map.xml").arg(mSaveDir.path()));
+            importAccepted = pTargetMap->importMap(xmlMap, &importError);
+        });
+        const auto [read, readMsg] = pTargetMap->readJsonMapFile(file);
+        disconnect(reenter);
+
+        QVERIFY(importAttempted);
+        QVERIFY2(!importAccepted, "importMap() ran on top of an in-flight JSON import");
+        // Refused by the in-progress guard, not by failing to read the file:
+        QVERIFY2(importError.contains(qsl("already in progress")), qPrintable(importError));
+        // ...and the JSON operation it interrupted still completed:
+        QVERIFY2(read, qPrintable(readMsg));
+        QCOMPARE(importCloseSpy.count(), 1);
+        QVERIFY(!pTargetMap->hasActiveTransferProgress());
+    }
+};
+
+void initializeQRCResourcesForMapProgressDialogSeamTest()
+{
+#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN
+    qInitResources_additional_splash_screens();
+#endif
+#ifdef INCLUDE_FONTS
+    qInitResources_mudlet_fonts_common();
+#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD)
+    qInitResources_mudlet_fonts_posix();
+#endif
+#endif
+    qInitResources_mudlet();
+    qInitResources_qm();
+}
+
+#include "MapProgressDialogSeamTest.moc"
+QTEST_MAIN(MapProgressDialogSeamTest)

From b6a3e936d3e71749f50254c1509c68a14cf22033 Mon Sep 17 00:00:00 2001
From: elements-of-boredom 
Date: Sun, 2 Aug 2026 08:33:47 -0500
Subject: [PATCH 036/155] improve: do not copy leading spaces in multi-line
 select (#9560)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Copying text from the main console no longer pads the first line with
extra leading spaces when a multi-line selection starts in the middle of
a line.

Previously, if you started a copy partway through a line (e.g. selecting
"is a fat dog" out of "My dog is a fat \ndog") and the selection
continued onto the next line, the pasted text would come out with the
first line padded with blank spaces equal to the starting column offset
e.g. pasting " is a fat dog" instead of "is a fat dog".

This change removes that padding so copied text matches what was
actually selected.
Screenshot 2026-07-29 at 8 40 11 AM


#### Motivation for adding to Mudlet

Constantly having to fix the copy/paste by removing unexpected
whitespace

#### Other info (issues closed, discussion etc)

Closes: [#4956](https://github.com/Mudlet/Mudlet/issues/4956)

A companion Lua package, ["Aligned
Copy"](https://github.com/Mudlet/mudlet-package-repository/pull/739),
has been published to the Mudlet package repository for anyone who
relied on the old column-aligned behaviour (e.g. for preserving
indentation when copying ASCII maps/tables). It adds a separate, opt-in
"Copy (aligned)" entry to the main console's right-click menu that
reproduces the previous padding behaviour, so this fix removes the
padding by default without removing the functionality for those who want
it.
---
 src/TTextEdit.cpp | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/src/TTextEdit.cpp b/src/TTextEdit.cpp
index 013077005..beeec15d3 100644
--- a/src/TTextEdit.cpp
+++ b/src/TTextEdit.cpp
@@ -2283,12 +2283,9 @@ QString TTextEdit::getSelectedText(const QChar& newlineChar, const bool showTime
             textLines[0] = textLines.at(0).mid(startPos, endPos - startPos + 1);
         }
     } else {
-        // replace a number of QChars at the front with a corresponding
-        // number of spaces to push the first line to the right so it lines up
-        // with the following lines:
+        // trim characters off the front of the first line according to startPos:
         if (!textLines.at(0).isEmpty()) {
             textLines[0] = textLines.at(0).mid(startPos);
-            textLines[0] = QString(QChar::Space).repeated(startPos) % textLines.at(0);
         }
         // and chop off the required number of QChars from the end of the last
         // line:

From 8bf74a820b6b2828e821370aa9fd15d1d6c63698 Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Sun, 2 Aug 2026 16:31:35 +0200
Subject: [PATCH 037/155] infrastructure: document the LSan tracer-crash CI
 flake (#9592)

#### Brief overview of PR changes/additions

- Comment-only addition to `asan-suppressions.txt`, next to the existing
`` Mesa flake note.
- Documents a rare CI flake: LeakSanitizer's stop-the-world tracer
segfaults ("Tracer caught signal 11") during exit, aborting before any
leak report - the job then fails on exitcode=1 with no actual leak
found.
- No `leak:` line can fix it; seen on development runs 26705214438 /
28641460889 and PR run 30744002320, roughly 1 in 250-500 leak-job runs.
Remedy is re-running the job.

#### Motivation for adding to Mudlet

So the next person who hits this failure doesn't have to re-derive that
it's a flake and can just re-run the job.

#### Other info (issues closed, discussion etc)

Comment-only change - nothing to test.

Assisted-by: Claude:claude-fable-5
---
 asan-suppressions.txt | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/asan-suppressions.txt b/asan-suppressions.txt
index c390f636a..f24d21cf3 100644
--- a/asan-suppressions.txt
+++ b/asan-suppressions.txt
@@ -44,6 +44,22 @@ leak:_dri.so
 # Mesa. Do not try to silence it with a leak: line here (there is no name to
 # match) - keep the GL context from being created/destroyed under the sanitizer
 # test-side instead, as PR #9534 did for the show3dMapView test.
+#
+# A second un-suppressible flake lives on the same CI job: LeakSanitizer's
+# stop-the-world tracer - the helper process that ptrace-attaches at exit to
+# scan memory for live pointers - itself segfaults during exit-time teardown,
+# apparently racing driver/X cleanup. The job log then ends with
+#   Tracer caught signal 11: addr=0x... pc=0x... sp=0x...
+#   ==NNNNN==LeakSanitizer has encountered a fatal error.
+# right after "mudlet::~mudlet() INFO - uninstalling translation...", with no
+# leak report at all, and the busted summary line goes missing too (LSan's
+# Die() skips the stdio flush - the Lua tests themselves passed). Since
+# exitcode=1 the job fails. Suppressions filter leak *reports*, and this
+# aborts before reporting begins, so nothing in this file can help; it is
+# also unrelated to the change under test (the same faulting instruction was
+# observed on development-branch runs 26705214438 and 28641460889 and on PR
+# run 30744002320, at a rate of roughly 1 in 250-500 leak-job runs). If a
+# leak job fails with this signature, just re-run it.
 
 # ==============================================================================
 # Fontconfig library leaks

From 92f01b850a4ad988584620576a48cdaedb878c4f Mon Sep 17 00:00:00 2001
From: Mike Conley 
Date: Sun, 2 Aug 2026 13:11:37 -0400
Subject: [PATCH 038/155] Fix looping sounds playing only once (#9569)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

#### Brief overview of PR changes/additions

Looping media (`loops=-1`) plays only once on Qt's FFmpeg multimedia
backend.

That backend ends a track by emitting `StoppedState` **first** and
`EndOfMedia` **second**, and it skips the `EndOfMedia` notification when
the playback engine was destroyed in between:

```cpp
if (currentPlaybackEngine)
    stateChanged(QMediaPlayer::StoppedState);

if (currentPlaybackEngine)
    mediaStatusChanged(QMediaPlayer::EndOfMedia);
```

Mudlet restarts a loop from its `EndOfMedia` handler, but
`TMedia::handlePlayerPlaybackStateChanged()` called `setSource(QUrl())`
immediately on `StoppedState`. That destroyed the engine, so
`EndOfMedia` never arrived and the loop died after one pass.

This defers the cleanup by one event-loop turn and re-checks the
playback state, so a loop restart can claim the player first while a
genuinely stopped player is still torn down.

#### Motivation for adding to Mudlet

Fixes #9566. Ambient/background music tracks stop after a single pass,
which affects any game using `Client.Media.Play` with `loops: -1`, MSP,
or `playMusicFile()`.

The immediate source clearing was introduced by #9237 as a
resource-cleanup measure. That cleanup is preserved here — it just runs
one event-loop turn later, and only if the player is still stopped.

#### Other info (issues closed, discussion etc)

Fixes #9566. Regression introduced by #9237 (merged 2026-04-29), so 4.21
and 4.22 are affected; 4.20.1 and earlier are not.

**Verified on Windows against the FFmpeg backend.** The bug reproduces
on unfixed code there, and this change resolves it without regressing
the cleanup that #9237 added.

It is worth being explicit that this could not be confirmed on macOS:
that platform ships `libdarwinmediaplugin`, which emits `EndOfMedia`
*before* `StoppedState` — the reverse ordering — so the loop restarts
before any cleanup runs and the bug cannot occur there at all. Reverting
the fix on macOS produced identical behaviour. The fix is therefore
specific to backends with the FFmpeg ordering, which is where the issue
was reported.

A functional test is included
(`test/functional_tests/TMediaLoopTest.cpp`) covering both halves of the
contract: a looping track must survive the stop/restart cycle, and a
one-shot track must still be cleaned up. It probes the backend before
asserting and **skips** unless that backend can both finish a clip and
emit `StoppedState` before `EndOfMedia`. Without that guard the looping
assertion passes on broken code, which is exactly what happened on
macOS. Expected results:

- FFmpeg backend → runs and asserts
- macOS darwin backend → skips (cannot exhibit the bug)
- Anywhere media stalls under `QT_QPA_PLATFORM=offscreen`, which the
functional suite forces → skips

So it may well skip in CI; that is intentional and preferable to a test
that always passes.

---------

Signed-off-by: Michael Conley 
---
 src/TMedia.cpp                           |  59 ++-
 src/TMedia.h                             |  16 +
 test/functional_tests/CMakeLists.txt     |   5 +
 test/functional_tests/TMediaLoopTest.cpp | 479 +++++++++++++++++++++++
 4 files changed, 553 insertions(+), 6 deletions(-)
 create mode 100644 test/functional_tests/TMediaLoopTest.cpp

diff --git a/src/TMedia.cpp b/src/TMedia.cpp
index cdc25ff3d..b4955c0b0 100644
--- a/src/TMedia.cpp
+++ b/src/TMedia.cpp
@@ -34,6 +34,7 @@
 #include 
 #include 
 #include 
+#include 
 
 // Public
 TMedia::TMedia(Host* pHost, const QString& profileName)
@@ -571,6 +572,22 @@ void TMedia::stopAllMediaPlayers()
     }
 }
 
+int TMedia::playersHoldingSource() const
+{
+    const auto countHeld = [](const QList>& list) {
+        int held = 0;
+        for (const auto& player : list) {
+            if (player && player->mediaPlayer() && !player->mediaPlayer()->source().isEmpty()) {
+                ++held;
+            }
+        }
+        return held;
+    };
+
+    return countHeld(mMSPSoundList) + countHeld(mMSPMusicList) + countHeld(mGMCPSoundList) + countHeld(mGMCPMusicList) + countHeld(mGMCPVideoList) + countHeld(mAPISoundList) + countHeld(mAPIMusicList)
+           + countHeld(mAPIVideoList);
+}
+
 void TMedia::setMediaPlayersMuted(const TMediaData::MediaProtocol mediaProtocol, const bool state)
 {
     TMediaData mediaData{};
@@ -1076,9 +1093,11 @@ void TMedia::connectMediaPlayer(std::shared_ptr& player)
                     QUrl nextMedia = lockedPlayer->playlist()->next();
 
                     if (!nextMedia.isEmpty()) {
+                        lockedPlayer->noteContinued();
                         lockedPlayer->mediaPlayer()->setSource(nextMedia);
                         lockedPlayer->mediaPlayer()->play();
                     } else if (lockedPlayer->playlist()->playbackMode() == TMediaPlaylist::Loop) {
+                        lockedPlayer->noteContinued();
                         lockedPlayer->playlist()->setCurrentIndex(0);
                         lockedPlayer->mediaPlayer()->setSource(lockedPlayer->playlist()->currentMedia());
                         lockedPlayer->mediaPlayer()->play();
@@ -1350,6 +1369,13 @@ void TMedia::handlePlayerPlaybackStateChanged(QMediaPlayerPlaybackState playback
     }
 
     if (playbackState == QMediaPlayer::StoppedState) {
+        // Captured before the event below, because a sysMediaFinished handler runs
+        // synchronously and may hand this player to the next track.
+        const std::weak_ptr weakPlayer = player;
+        const TMediaData stoppedData = player->mediaData();
+        const quint64 claimGeneration = player->claimGeneration();
+        const quint64 continuationGeneration = player->continuationGeneration();
+
         TEvent mediaFinished{};
         mediaFinished.mArgumentList.append(qsl("sysMediaFinished"));
 
@@ -1370,14 +1396,33 @@ void TMedia::handlePlayerPlaybackStateChanged(QMediaPlayerPlaybackState playback
             mpHost->raiseEvent(mediaFinished);
         }
 
-        player->mediaPlayer()->setSource(QUrl());
+        // Deferred so the backend can still emit EndOfMedia, which is what restarts a loop:
+        // clearing the source here destroys the playback engine and that signal never arrives.
+        QTimer::singleShot(0, this, [this, weakPlayer, stoppedData, claimGeneration, continuationGeneration] {
+            const auto lockedPlayer = weakPlayer.lock();
+            const bool stillOurs = lockedPlayer && lockedPlayer->claimGeneration() == claimGeneration;
+            // Backends that emit EndOfMedia before StoppedState have already restarted the
+            // loop by now, so a player still playing its own track has not stopped either.
+            const bool sameMediaContinues =
+                    lockedPlayer && (lockedPlayer->continuationGeneration() != continuationGeneration || (stillOurs && lockedPlayer->getPlaybackState() == QMediaPlayer::PlayingState));
 
-        if (player->mediaData().mediaWidget() == TMediaData::MediaWidgetLabel && player->mediaData().mediaClose() == TMediaData::MediaCloseEnabled && player->mediaPlayer()->videoOutput() != nullptr) {
-            emit signal_hideVideoOutput(player.get());
-        }
+            if (sameMediaContinues) {
+                return;
+            }
 
-        //: This word is part of a sentence like "Music stops" when the music is about to stop.
-        printClosedCaption(player->mediaData(), tr("stops"));
+            // Only release a player nothing else has taken over: a claimed one is already
+            // loading its new source, which on an asynchronous backend still reads as stopped.
+            if (stillOurs && lockedPlayer->mediaPlayer() && lockedPlayer->getPlaybackState() == QMediaPlayer::StoppedState) {
+                lockedPlayer->mediaPlayer()->setSource(QUrl());
+
+                if (stoppedData.mediaWidget() == TMediaData::MediaWidgetLabel && stoppedData.mediaClose() == TMediaData::MediaCloseEnabled && lockedPlayer->mediaPlayer()->videoOutput() != nullptr) {
+                    emit signal_hideVideoOutput(lockedPlayer.get());
+                }
+            }
+
+            //: This word is part of a sentence like "Music stops" when the music is about to stop.
+            printClosedCaption(stoppedData, tr("stops"));
+        });
         return;
     } else if (playbackState == QMediaPlayer::PlayingState && player->mediaData().mediaVolume() != TMediaData::MediaVolumePreload) { // NOLINT(readability-else-after-return)
         TEvent mediaStarted{};
@@ -1613,6 +1658,7 @@ void TMedia::play(TMediaData& mediaData)
         }
 
         const QUrl mediaSource = mediaData.mediaInput() == TMediaData::MediaInputFile ? QUrl::fromLocalFile(absolutePathFileName) : QUrl(absolutePathFileName);
+        pPlayer->noteClaimed();
         pPlayer->mediaPlayer()->setSource(mediaSource);
     } else {
         if (mediaData.mediaLoops() == TMediaData::MediaLoopsRepeat) { // Repeat indefinitely
@@ -1679,6 +1725,7 @@ void TMedia::play(TMediaData& mediaData)
 
         playlist->setCurrentIndex(0);
         pPlayer->setPlaylist(playlist);
+        pPlayer->noteClaimed();
         pPlayer->mediaPlayer()->setSource(playlist->currentMedia());
     }
 
diff --git a/src/TMedia.h b/src/TMedia.h
index 545188571..cc4823d5c 100644
--- a/src/TMedia.h
+++ b/src/TMedia.h
@@ -62,6 +62,16 @@ public:
 
     TMediaData mediaData() const { return mMediaData; }
     void setMediaData(TMediaData& mediaData) { mMediaData = mediaData; }
+
+    // A stop is acted on one event-loop turn late, by which time a stopped player is
+    // indistinguishable from one asynchronously loading a source set since. These
+    // record what happened in between: a claim is this player being given a new source
+    // to play, a continuation is its own playlist advancing or looping.
+    quint64 claimGeneration() const { return mClaimGeneration; }
+    void noteClaimed() { ++mClaimGeneration; }
+    quint64 continuationGeneration() const { return mContinuationGeneration; }
+    void noteContinued() { ++mContinuationGeneration; }
+
     QMediaPlayer* mediaPlayer() const { return mMediaPlayer.get(); }
     bool isInitialized() const { return initialized; }
     QMediaPlayer::PlaybackState getPlaybackState() const
@@ -117,6 +127,8 @@ private:
     std::unique_ptr mMediaPlayer;
     std::unique_ptr mPlaylist;
     bool initialized = false;
+    quint64 mClaimGeneration = 0;
+    quint64 mContinuationGeneration = 0;
 };
 
 class TMedia : public QObject
@@ -149,6 +161,10 @@ public:
     void printClosedCaption(const TMediaData& mediaData, const QString& action) const;
     void stopAllMediaPlayers();
 
+    // Number of players still holding a media source. Releasing that source is the only
+    // observable effect of the deferred stop cleanup, so tests need a way to see it.
+    int playersHoldingSource() const;
+
     // Returns true if mediaFileName would resolve to a location outside mediaRoot, either
     // lexically (e.g. via "../" traversal) or through a symlink component that already exists
     // under mediaRoot but points elsewhere. Static so it can be unit-tested without a Host.
diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt
index 59578a602..374c46930 100644
--- a/test/functional_tests/CMakeLists.txt
+++ b/test/functional_tests/CMakeLists.txt
@@ -35,6 +35,7 @@ set(FUNCTIONAL_TEST_SOURCES
     UndoServerWrapTest.cpp
     HostWidgetDecouplingTest.cpp
     ActionSelfUninstallTest.cpp
+    TMediaLoopTest.cpp
 )
 
 set(FUNCTIONAL_TEST_UTILS
@@ -99,6 +100,10 @@ set_tests_properties(InsertTextCapTest PROPERTIES TIMEOUT 300)
 # LogRestartDuplicateLineTest creates a fresh profile per test method, so it needs a longer timeout
 set_tests_properties(LogRestartDuplicateLineTest PROPERTIES TIMEOUT 300)
 
+# TMediaLoopTest probes the audio backend and creates a fresh profile per test method,
+# and each clip has to be waited out in real time, so it needs a longer timeout
+set_tests_properties(TMediaLoopTest PROPERTIES TIMEOUT 300)
+
 # The round-trip tests boot a full mudlet instance and save/reload profile and
 # map data, so they need a longer timeout
 set_tests_properties(ProfileRoundTripTest MapRoundTripTest MapProgressDialogSeamTest PROPERTIES TIMEOUT 300)
diff --git a/test/functional_tests/TMediaLoopTest.cpp b/test/functional_tests/TMediaLoopTest.cpp
new file mode 100644
index 000000000..34800aeba
--- /dev/null
+++ b/test/functional_tests/TMediaLoopTest.cpp
@@ -0,0 +1,479 @@
+/***************************************************************************
+ *   Copyright (C) 2026 by Mudlet Developers                               *
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the GNU General Public License as published by  *
+ *   the Free Software Foundation; either version 2 of the License, or     *
+ *   (at your option) any later version.                                   *
+ *                                                                         *
+ *   This program is distributed in the hope that it will be useful,       *
+ *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
+ *   GNU General Public License for more details.                          *
+ *                                                                         *
+ *   You should have received a copy of the GNU General Public License     *
+ *   along with this program; if not, write to the                         *
+ *   Free Software Foundation, Inc.,                                       *
+ *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
+ ***************************************************************************/
+
+#include 
+#include 
+#include 
+#include 
+#include 
+
+#include 
+
+#include "Host.h"
+#include "MudletInstanceCoordinator.h"
+#include "TMedia.h"
+#include "TMediaData.h"
+#include "TelnetServerStub.h"
+#include "dlgConnectionProfiles.h"
+#include "mudlet.h"
+#include "utils.h"
+
+extern void qInitResources_mudlet();
+extern void qInitResources_qm();
+extern void qInitResources_additional_splash_screens();
+extern void qInitResources_mudlet_fonts_common();
+extern void qInitResources_mudlet_fonts_posix();
+void initializeQRCResourcesForMediaLoop();
+
+using namespace std::chrono_literals;
+
+/*
+ * Regression guard for "Client.Media loops=-1 plays once" (issue #9566).
+ *
+ * Qt's FFmpeg backend ends a track by emitting StoppedState first and only then
+ * EndOfMedia, and it skips the EndOfMedia notification if the playback engine
+ * disappeared in between. Mudlet restarts a loop from its EndOfMedia handler, so
+ * when the StoppedState handler cleared the source immediately (added by #9237 as
+ * a cleanup measure) it destroyed the engine, EndOfMedia never arrived and an
+ * indefinitely looping track played exactly once.
+ *
+ * The cleanup is therefore deferred by one event-loop turn and re-checks the
+ * playback state, which lets a loop restart claim the player first. Both halves of
+ * that contract are covered here: a looping track must survive the stop/restart
+ * cycle, and a one-shot track must still be torn down so #9237 is not regressed.
+ *
+ * Both assertions depend on the platform actually decoding a clip through to
+ * EndOfMedia. Some setups cannot - notably the macOS darwin backend under
+ * QT_QPA_PLATFORM=offscreen, which the functional suite sets, stalls in
+ * LoadingMedia indefinitely. TMedia reports a stalled player as still playing, so
+ * without a capability check the looping assertion would pass on broken code too.
+ * Each test therefore probes a plain QMediaPlayer first and skips if the backend
+ * cannot finish a clip.
+ */
+class TMediaLoopTest : public QObject
+{
+    Q_OBJECT
+
+private:
+    TelnetServerStub* mpServer = nullptr;
+    const QString mHostname = "Test-Media-Loop";
+    const QString mPort = "4012";
+    const QString mLocalhost = "localhost";
+
+    // Length of the generated clip. Long enough that "still playing" cannot be an
+    // artefact of start-up latency, short enough to loop several times quickly.
+    static constexpr int clipMs = 400;
+
+    // Probed once, because the probe has to wait out a whole clip and the suite gives
+    // every functional test a single wall-clock budget for all of its slots.
+    QTemporaryDir mProbeDir;
+    // Set when the backend cannot decode a clip through to EndOfMedia at all.
+    QString mCannotPlayReason;
+    // Set when the backend ends a track with EndOfMedia before StoppedState.
+    QString mWrongOrderReason;
+    // Set when the backend starts playing synchronously, so a player that has just been
+    // re-sourced can never be mistaken for a stopped one.
+    QString mSynchronousStartReason;
+
+private slots:
+    void initTestCase()
+    {
+        initializeQRCResourcesForMediaLoop();
+        probeBackend();
+    }
+
+    void init()
+    {
+        mpServer = new TelnetServerStub(qApp);
+        mpServer->start(mLocalhost, mPort.toUShort());
+        mudlet::start();
+        mudlet::self()->setupConfig();
+        mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique("MudletInstanceCoordinator"));
+        mudlet::self()->init();
+        mudlet::self()->setStorePasswordsSecurely(false);
+        deleteProfileDirectory(mHostname);
+    }
+
+    // A looping track must still be playing well after its first pass would have
+    // ended. Before the fix the first StoppedState cleared the source, EndOfMedia
+    // was never delivered and the player dropped out of the playing set for good.
+    void test_loopingTrackKeepsPlayingPastFirstPass()
+    {
+        if (!mCannotPlayReason.isEmpty()) {
+            QSKIP(qPrintable(mCannotPlayReason));
+        }
+        if (!mWrongOrderReason.isEmpty()) {
+            QSKIP(qPrintable(mWrongOrderReason));
+        }
+
+        auto* media = startProfileAndGetMedia();
+        QVERIFY(media);
+
+        const QString fileName = writeClip(qsl("loop.wav"));
+
+        TMediaData data = clipData(fileName);
+        data.setMediaLoops(TMediaData::MediaLoopsRepeat);
+        media->playMedia(data);
+
+        QVERIFY2(waitForPlaying(media, fileName), "The looping track never started playing.");
+
+        // Span several passes so a single missed restart cannot pass by luck.
+        QTest::qWait(clipMs * 4);
+
+        QVERIFY2(playing(media, fileName), "A loops=-1 track stopped after its first pass - the StoppedState cleanup suppressed EndOfMedia and the loop never restarted.");
+    }
+
+    // The deferred cleanup must still fire for a genuinely finished track, otherwise
+    // the resource release that #9237 added would be lost. Releasing the source is the
+    // only observable effect of the deferred stop cleanup: playingMedia() drops a player
+    // the moment it reports StoppedState, well before that cleanup runs.
+    void test_oneShotTrackIsCleanedUpWhenItFinishes()
+    {
+        if (!mCannotPlayReason.isEmpty()) {
+            QSKIP(qPrintable(mCannotPlayReason));
+        }
+
+        auto* media = startProfileAndGetMedia();
+        QVERIFY(media);
+
+        const QString fileName = writeClip(qsl("oneshot.wav"));
+
+        TMediaData data = clipData(fileName);
+        data.setMediaLoops(TMediaData::MediaLoopsDefault);
+        media->playMedia(data);
+
+        QVERIFY2(waitForPlaying(media, fileName), "The one-shot track never started playing.");
+
+        const bool cleanedUp = QTest::qWaitFor(
+                [&]() {
+                    return !playing(media, fileName) && media->playersHoldingSource() == 0;
+                },
+                QDeadlineTimer(10s));
+
+        QVERIFY2(cleanedUp, "A finished one-shot track never released its media source - the deferred cleanup did not run.");
+    }
+
+    // A player that is handed to a different track in the same event-loop turn, as
+    // stopMusic() followed by playMusic{} in one script does, must keep the new source.
+    // The pending cleanup belongs to the track that stopped, and on this backend the
+    // player still reads as stopped while it loads the new one.
+    void test_reusedPlayerKeepsTheTrackThatClaimedIt()
+    {
+        if (!mCannotPlayReason.isEmpty()) {
+            QSKIP(qPrintable(mCannotPlayReason));
+        }
+        if (!mSynchronousStartReason.isEmpty()) {
+            QSKIP(qPrintable(mSynchronousStartReason));
+        }
+
+        auto* media = startProfileAndGetMedia();
+        QVERIFY(media);
+
+        const QString firstFile = writeClip(qsl("first.wav"));
+        const QString secondFile = writeClip(qsl("second.wav"));
+
+        TMediaData first = clipData(firstFile);
+        first.setMediaLoops(TMediaData::MediaLoopsRepeat);
+        media->playMedia(first);
+
+        QVERIFY2(waitForPlaying(media, firstFile), "The first track never started playing.");
+
+        TMediaData stopFirst = clipData(firstFile);
+        media->stopMedia(stopFirst);
+
+        TMediaData second = clipData(secondFile);
+        second.setMediaLoops(TMediaData::MediaLoopsRepeat);
+        media->playMedia(second);
+
+        QVERIFY2(waitForPlaying(media, secondFile), "The replacement track never started playing.");
+
+        // Past the turn the stopped track's cleanup was scheduled for.
+        QTest::qWait(clipMs);
+
+        QVERIFY2(playing(media, secondFile), "The replacement track was cut off - the previous track's deferred cleanup cleared the source out from under it.");
+    }
+
+    // continue=false restarts a track by stopping it and re-sourcing the same player
+    // inside one call. That player is matched, not claimed, so nothing in the reuse path
+    // tells the pending cleanup that the track it belongs to has already been replaced.
+    void test_restartedTrackKeepsItsNewSource()
+    {
+        if (!mCannotPlayReason.isEmpty()) {
+            QSKIP(qPrintable(mCannotPlayReason));
+        }
+        if (!mSynchronousStartReason.isEmpty()) {
+            QSKIP(qPrintable(mSynchronousStartReason));
+        }
+
+        auto* media = startProfileAndGetMedia();
+        QVERIFY(media);
+
+        const QString fileName = writeClip(qsl("restart.wav"));
+
+        TMediaData data = clipData(fileName);
+        data.setMediaLoops(TMediaData::MediaLoopsRepeat);
+        media->playMedia(data);
+
+        QVERIFY2(waitForPlaying(media, fileName), "The track never started playing.");
+
+        TMediaData restart = clipData(fileName);
+        restart.setMediaLoops(TMediaData::MediaLoopsRepeat);
+        restart.setMediaContinue(TMediaData::MediaContinueRestart);
+        media->playMedia(restart);
+
+        // Past the turn the stop inside that restart scheduled its cleanup for.
+        QTest::qWait(clipMs);
+
+        QVERIFY2(playing(media, fileName), "A restarted track was cut off - the cleanup deferred by its own stop cleared the source it had just been given.");
+    }
+
+    void cleanup()
+    {
+        delete mpServer;
+        mpServer = nullptr;
+        deleteProfileDirectory(mHostname);
+        delete mudlet::self();
+    }
+
+private:
+    TMedia* startProfileAndGetMedia()
+    {
+        startProfile(mHostname, mLocalhost, mPort);
+        auto host = mudlet::self()->getActiveHost();
+        if (!host) {
+            QTest::qFail("No active host available for the test.", __FILE__, __LINE__);
+            return nullptr;
+        }
+        auto* media = host->mpMedia.data();
+        if (!media) {
+            QTest::qFail("Host has no TMedia instance.", __FILE__, __LINE__);
+            return nullptr;
+        }
+        return media;
+    }
+
+    // Records what this backend is and is not able to demonstrate.
+    //
+    //   - A backend that stalls in LoadingMedia (macOS darwin under
+    //     QT_QPA_PLATFORM=offscreen, which the functional suite sets) never stops, and
+    //     TMedia reports a stalled player as still playing, so nothing below is
+    //     observable at all.
+    //   - A backend that emits EndOfMedia *before* StoppedState (macOS darwin under
+    //     cocoa) restarts a loop before any cleanup can run, so issue #9566 cannot occur
+    //     and the looping assertion would hold on broken code. Only the
+    //     StoppedState-first ordering (Qt's FFmpeg backend) can reproduce it. The other
+    //     two tests turn on an explicit stop, so they hold on any backend that plays.
+    void probeBackend()
+    {
+        if (!mProbeDir.isValid()) {
+            mCannotPlayReason = qsl("Could not create a temporary directory for the backend probe.");
+            return;
+        }
+
+        const QString path = qsl("%1/probe.wav").arg(mProbeDir.path());
+        QFile file(path);
+        if (!file.open(QIODevice::WriteOnly)) {
+            mCannotPlayReason = qsl("Could not write the backend probe clip.");
+            return;
+        }
+        file.write(wavBytes());
+        file.close();
+
+        QMediaPlayer probe;
+        auto* output = new QAudioOutput(&probe);
+        output->setMuted(true);
+        probe.setAudioOutput(output);
+
+        bool sawEndOfMedia = false;
+        bool stoppedCameFirst = false;
+        connect(&probe, &QMediaPlayer::mediaStatusChanged, this, [&](QMediaPlayer::MediaStatus status) {
+            if (status == QMediaPlayer::EndOfMedia) {
+                sawEndOfMedia = true;
+            }
+        });
+        connect(&probe, &QMediaPlayer::playbackStateChanged, this, [&](QMediaPlayer::PlaybackState state) {
+            if (state == QMediaPlayer::StoppedState && !sawEndOfMedia) {
+                stoppedCameFirst = true;
+            }
+        });
+
+        probe.setSource(QUrl::fromLocalFile(path));
+        probe.play();
+        // Whether a player that has just been handed a source still reads as stopped is
+        // the whole reason the deferred cleanup needs to check who owns the player.
+        const bool startsSynchronously = probe.playbackState() == QMediaPlayer::PlayingState;
+
+        const bool finished = QTest::qWaitFor(
+                [&]() {
+                    return sawEndOfMedia;
+                },
+                QDeadlineTimer(10s));
+        probe.stop();
+
+        if (!finished) {
+            mCannotPlayReason = qsl("This Qt Multimedia backend cannot decode a clip to completion here (it stalls before EndOfMedia), so media playback behaviour cannot be observed.");
+            return;
+        }
+        if (!stoppedCameFirst) {
+            mWrongOrderReason = qsl("This Qt Multimedia backend emits EndOfMedia before StoppedState, so the loop restarts before any cleanup runs and issue #9566 cannot occur here. Needs a "
+                                    "StoppedState-first backend such as Qt's FFmpeg one.");
+        }
+        if (startsSynchronously) {
+            mSynchronousStartReason = qsl("This Qt Multimedia backend reaches PlayingState synchronously, so a player that has just been claimed by another track never reads as stopped and cannot "
+                                          "have its source cleared out from under it. Needs a backend that loads asynchronously, such as Qt's FFmpeg one.");
+        }
+    }
+
+    TMediaData clipData(const QString& fileName) const
+    {
+        TMediaData data;
+        data.setMediaProtocol(TMediaData::MediaProtocolAPI);
+        data.setMediaType(TMediaData::MediaTypeMusic);
+        data.setMediaInput(TMediaData::MediaInputFile);
+        data.setMediaFileName(fileName);
+        data.setMediaVolume(1); // audible enough to play, quiet enough not to disturb a desktop run
+        return data;
+    }
+
+    // TMedia reports a player only while it is actually playing (or still loading),
+    // which is the observable this regression turns on.
+    bool playing(TMedia* media, const QString& fileName) const
+    {
+        TMediaData criteria = clipData(fileName);
+        return !media->playingMedia(criteria).isEmpty();
+    }
+
+    bool waitForPlaying(TMedia* media, const QString& fileName, std::chrono::milliseconds timeout = 10s)
+    {
+        return QTest::qWaitFor(
+                [&]() {
+                    return playing(media, fileName);
+                },
+                QDeadlineTimer(timeout));
+    }
+
+    // Writes a silent 16-bit mono PCM WAV into the profile media directory. Silence is
+    // fine: the test asserts on playback state transitions, not on what is heard.
+    QString writeClip(const QString& fileName) const
+    {
+        const QString mediaPath = mudlet::getMudletPath(enums::profileMediaPath, mHostname);
+        if (!QDir().mkpath(mediaPath)) {
+            QTest::qFail("Could not create the profile media directory.", __FILE__, __LINE__);
+            return {};
+        }
+
+        QFile file(qsl("%1/%2").arg(mediaPath, fileName));
+        if (!file.open(QIODevice::WriteOnly)) {
+            QTest::qFail("Could not write the test media file.", __FILE__, __LINE__);
+            return {};
+        }
+        file.write(wavBytes());
+        file.close();
+        return fileName;
+    }
+
+    // A silent 16-bit mono PCM WAV. Silence is fine: the tests assert on playback state
+    // transitions, not on what is heard.
+    static QByteArray wavBytes()
+    {
+        constexpr int sampleRate = 8000;
+        constexpr int bytesPerSample = 2;
+        const int dataBytes = sampleRate * bytesPerSample * clipMs / 1000;
+
+        QByteArray wav;
+        QDataStream out(&wav, QIODevice::WriteOnly);
+        out.setByteOrder(QDataStream::LittleEndian);
+
+        out.writeRawData("RIFF", 4);
+        out << static_cast(36 + dataBytes);
+        out.writeRawData("WAVE", 4);
+        out.writeRawData("fmt ", 4);
+        out << static_cast(16); // PCM header size
+        out << static_cast(1);  // PCM, uncompressed
+        out << static_cast(1);  // mono
+        out << static_cast(sampleRate);
+        out << static_cast(sampleRate * bytesPerSample); // byte rate
+        out << static_cast(bytesPerSample);              // block align
+        out << static_cast(8 * bytesPerSample);          // bits per sample
+        out.writeRawData("data", 4);
+        out << static_cast(dataBytes);
+        wav.append(QByteArray(dataBytes, '\0'));
+
+        return wav;
+    }
+
+    // Utility function to manually start a profile like a user would do via the
+    // GUI
+    void startProfile(const QString& hostname, const QString& address, const QString& port)
+    {
+        QTimer::singleShot(0, qApp, [hostname, address, port]() {
+            mudlet::self()->startAutoLogin({});
+            QTest::qWait(100ms);
+            QTest::mouseClick(mudlet::self()->mpConnectionDialog->new_profile_button, Qt::LeftButton);
+            QTest::qWait(100ms);
+            QTest::keyClicks(QApplication::focusWidget(), hostname);
+            QTest::qWait(100ms);
+            QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab);
+            QTest::qWait(100ms);
+            QTest::keyClicks(QApplication::focusWidget(), address);
+            QTest::qWait(100ms);
+            QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab);
+            QTest::qWait(100ms);
+            QTest::keyClicks(QApplication::focusWidget(), port);
+            QTest::qWait(100ms);
+            QTest::keyClick(QApplication::focusWidget(), Qt::Key_Return);
+        });
+
+        QSignalSpy spy(mudlet::self(), &mudlet::signal_profileLoaded);
+        if (!spy.wait(5s)) {
+            QFAIL("Profile took too long to load.");
+        }
+    }
+
+    // Utility function
+    void deleteProfileDirectory(const QString& profileName)
+    {
+        const QString path = mudlet::getMudletPath(enums::profileHomePath, profileName);
+        QDir dir(path);
+
+        if (!dir.exists()) {
+            qInfo() << "Profile directory does not exist:" << path;
+            return;
+        }
+        dir.removeRecursively();
+    }
+};
+
+void initializeQRCResourcesForMediaLoop()
+{
+#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN
+    qInitResources_additional_splash_screens();
+#endif
+#ifdef INCLUDE_FONTS
+    qInitResources_mudlet_fonts_common();
+#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD)
+    qInitResources_mudlet_fonts_posix();
+#endif
+#endif
+    qInitResources_mudlet();
+    qInitResources_qm();
+}
+
+#include "TMediaLoopTest.moc"
+QTEST_MAIN(TMediaLoopTest)

From 05b0b354959f853d5c147d6408d1bb40686da25d Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Sun, 2 Aug 2026 11:05:54 +0200
Subject: [PATCH 039/155] infrastructure: window and label geometry/visibility
 Lua API tests

142 busted specs in UI_spec.lua covering the raw (non-Geyser) window and
label API: creation geometry and containment, moveWindow/resizeWindow,
show/hideWindow, label text and style readback, fonts, borders,
timestamps, scrolling state, mouse and command line menu events,
setTextFormat, setWindow reparenting and the matching error contracts.

Assisted-by: Claude:claude-opus-4-8
---
 src/mudlet-lua/tests/UI_spec.lua | 1268 ++++++++++++++++++++++++++++++
 1 file changed, 1268 insertions(+)

diff --git a/src/mudlet-lua/tests/UI_spec.lua b/src/mudlet-lua/tests/UI_spec.lua
index 1fdef7dfb..4281fc127 100644
--- a/src/mudlet-lua/tests/UI_spec.lua
+++ b/src/mudlet-lua/tests/UI_spec.lua
@@ -2758,3 +2758,1271 @@ describe("Window state getters", function()
     end)
   end)
 end)
+
+-- Raw window/label API: creation geometry, movement, visibility, text and
+-- state readback. Uses getWindowGeometry/windowVisible/getLabelText plus the
+-- pre-existing getters; Geyser wrappers are covered in the Geyser* specs.
+describe("Window and label state", function()
+  -- user windows cannot be deleted from Lua, so keep the names unique per run
+  local suffix = ("-%d-%d"):format(os.time(), math.random(100000))
+  local function name(base)
+    return base .. suffix
+  end
+
+  -- one shared user window for the whole block: opening one is expensive and
+  -- Lua cannot delete it again, only hide it
+  local sharedUserWindow = name("wlsUserWindow")
+
+  setup(function()
+    -- loadLayout is off so a saved layout cannot move the window under us
+    openUserWindow(sharedUserWindow, false)
+  end)
+
+  teardown(function()
+    hideWindow(sharedUserWindow)
+  end)
+
+  describe("creation, containment and type of window elements", function()
+    local label = name("wlsLabel")
+    local console = name("wlsConsole")
+    local scrollBox = name("wlsScrollBox")
+    local cmdLine = name("wlsCmdLine")
+    local textEdit = name("wlsTextEdit")
+    local userWindow = sharedUserWindow
+    local childLabel = name("wlsChildLabel")
+    local childConsole = name("wlsChildConsole")
+    local scrollBoxLabel = name("wlsScrollBoxLabel")
+
+    setup(function()
+      createLabel(label, 11, 22, 133, 44, 1)
+      createMiniConsole(console, 12, 23, 300, 150)
+      createScrollBox(scrollBox, 13, 24, 120, 90)
+      createCommandLine(cmdLine, 14, 25, 140, 35)
+      createTextEdit(textEdit, 15, 26, 160, 110)
+      createLabel(userWindow, childLabel, 5, 6, 40, 20, 1)
+      createMiniConsole(userWindow, childConsole, 7, 8, 200, 100)
+      createLabel(scrollBox, scrollBoxLabel, 4, 5, 30, 20, 1)
+    end)
+
+    teardown(function()
+      deleteLabel(childLabel)
+      deleteMiniConsole(childConsole)
+      deleteLabel(scrollBoxLabel)
+      deleteLabel(label)
+      deleteMiniConsole(console)
+      deleteScrollBox(scrollBox)
+      deleteCommandLine(cmdLine)
+      deleteTextEdit(textEdit)
+    end)
+
+    -- geometry straight after creation in the main window is covered by the
+    -- "Window state getters" block above; these cover the other two parents
+
+    it("a label created in a user window is positioned inside that window", function()
+      -- the coordinates are relative to the parent, not to the main window
+      assert.are.same({5, 6, 40, 20}, {getWindowGeometry(childLabel)})
+    end)
+
+    it("a miniconsole created in a user window is positioned inside that window", function()
+      assert.are.same({7, 8, 200, 100}, {getWindowGeometry(childConsole)})
+    end)
+
+    it("a label created in a scroll box is positioned inside that scroll box", function()
+      assert.are.same({4, 5, 30, 20}, {getWindowGeometry(scrollBoxLabel)})
+    end)
+
+    it("every created element is visible and reports its own type", function()
+      assert.is_true(windowVisible(label))
+      assert.is_true(windowVisible(console))
+      assert.is_true(windowVisible(scrollBox))
+      assert.is_true(windowVisible(cmdLine))
+      assert.is_true(windowVisible(textEdit))
+      assert.are.equal("label", windowType(label))
+      assert.are.equal("miniconsole", windowType(console))
+      assert.are.equal("commandline", windowType(cmdLine))
+      assert.are.equal("textedit", windowType(textEdit))
+      -- windowType is deliberately not asserted for the scroll box: it has no
+      -- scroll box branch, so it reports a live scroll box as unknown
+    end)
+
+    it("openUserWindow reports the window as a userwindow and is repeatable", function()
+      assert.are.equal("userwindow", windowType(userWindow))
+      -- re-opening an already open user window re-shows the same dock rather
+      -- than reporting the name as taken
+      assert.is_true(openUserWindow(userWindow, false))
+    end)
+
+    it("openUserWindow refuses a name already taken by a label", function()
+      local ok, err = openUserWindow(label)
+      assert.is_nil(ok)
+      assert.are.equal(("label with the name '%s' already exists"):format(label), err)
+    end)
+
+    it("createMiniConsole on an existing name moves and resizes it instead", function()
+      local ok, err = createMiniConsole(console, 40, 50, 260, 130)
+      local geometry = {getWindowGeometry(console)}
+      -- put it back before asserting so a failure here cannot cascade
+      createMiniConsole(console, 12, 23, 300, 150)
+      assert.is_false(ok)
+      assert.are.equal(("miniconsole '%s' already exists, moving/resizing '%s'"):format(console, console), err)
+      assert.are.same({40, 50, 260, 130}, geometry)
+    end)
+
+    it("createScrollBox on an existing name moves and resizes it instead", function()
+      local ok, err = createScrollBox(scrollBox, 41, 51, 261, 131)
+      local geometry = {getWindowGeometry(scrollBox)}
+      createScrollBox(scrollBox, 13, 24, 120, 90)
+      assert.is_false(ok)
+      assert.are.equal(("scrollBox '%s' already exists, moving/resizing '%s'"):format(scrollBox, scrollBox), err)
+      assert.are.same({41, 51, 261, 131}, geometry)
+    end)
+
+    it("createCommandLine hard-errors without a name", function()
+      local ok, err = pcall(createCommandLine)
+      assert.is_false(ok)
+      assert.is_truthy(err:find("createCommandLine: bad argument #1 type", 1, true))
+    end)
+
+    it("createTextEdit hard-errors without a name", function()
+      local ok, err = pcall(createTextEdit)
+      assert.is_false(ok)
+      assert.is_truthy(err:find("createTextEdit: bad argument #1 type", 1, true))
+    end)
+
+    it("createScrollBox hard-errors without a name", function()
+      local ok, err = pcall(createScrollBox)
+      assert.is_false(ok)
+      assert.is_truthy(err:find("createScrollBox: bad argument #1 type", 1, true))
+    end)
+  end)
+
+  describe("moveWindow and resizeWindow", function()
+    local label = name("wlsMoveLabel")
+    local console = name("wlsMoveConsole")
+    local scrollBox = name("wlsMoveScrollBox")
+    local cmdLine = name("wlsMoveCmdLine")
+    local textEdit = name("wlsMoveTextEdit")
+
+    setup(function()
+      createLabel(label, 10, 10, 100, 50, 1)
+      createMiniConsole(console, 130, 10, 200, 50)
+      createScrollBox(scrollBox, 10, 70, 100, 50)
+      createCommandLine(cmdLine, 10, 130, 100, 30)
+      createTextEdit(textEdit, 10, 170, 100, 50)
+    end)
+
+    teardown(function()
+      deleteLabel(label)
+      deleteMiniConsole(console)
+      deleteScrollBox(scrollBox)
+      deleteCommandLine(cmdLine)
+      deleteTextEdit(textEdit)
+    end)
+
+    it("moveWindow relocates a miniconsole", function()
+      moveWindow(console, 21, 31)
+      local x, y = getWindowGeometry(console)
+      assert.are.same({21, 31}, {x, y})
+    end)
+
+    it("moveWindow relocates a scroll box", function()
+      moveWindow(scrollBox, 33, 44)
+      local x, y = getWindowGeometry(scrollBox)
+      assert.are.same({33, 44}, {x, y})
+    end)
+
+    it("moveWindow relocates a text edit", function()
+      moveWindow(textEdit, 77, 88)
+      local x, y = getWindowGeometry(textEdit)
+      assert.are.same({77, 88}, {x, y})
+    end)
+
+    it("resizeWindow resizes a command line", function()
+      resizeWindow(cmdLine, 180, 40)
+      local _, _, w, h = getWindowGeometry(cmdLine)
+      assert.are.same({180, 40}, {w, h})
+    end)
+
+    it("resizeWindow resizes a label", function()
+      resizeWindow(label, 210, 95)
+      local _, _, w, h = getWindowGeometry(label)
+      assert.are.same({210, 95}, {w, h})
+    end)
+
+    it("moveWindow truncates fractional coordinates", function()
+      -- the coordinates are read as doubles and cast to int, so .9 is dropped
+      moveWindow(label, 70.9, 80.9)
+      local x, y = getWindowGeometry(label)
+      assert.are.same({70, 80}, {x, y})
+    end)
+
+    it("moveWindow and resizeWindow return no values for an unknown window", function()
+      -- both silently ignore names they cannot resolve, returning nothing at
+      -- all rather than nil - so count the returns instead of reading one
+      assert.are.equal(0, select("#", moveWindow(name("wlsNoSuchWindow"), 1, 2)))
+      assert.are.equal(0, select("#", resizeWindow(name("wlsNoSuchWindow"), 1, 2)))
+    end)
+
+    it("moveWindow and resizeWindow hard-error without arguments", function()
+      local movedOk, movedErr = pcall(moveWindow)
+      assert.is_false(movedOk)
+      assert.is_truthy(movedErr:find("moveWindow: bad argument #1 type", 1, true))
+      local resizedOk, resizedErr = pcall(resizeWindow)
+      assert.is_false(resizedOk)
+      assert.is_truthy(resizedErr:find("resizeWindow: bad argument #1 type", 1, true))
+    end)
+  end)
+
+  describe("showWindow and hideWindow", function()
+    local label = name("wlsShowLabel")
+    local textEdit = name("wlsShowTextEdit")
+
+    setup(function()
+      createLabel(label, 10, 10, 60, 30, 1)
+      createTextEdit(textEdit, 10, 50, 100, 60)
+    end)
+
+    teardown(function()
+      deleteLabel(label)
+      deleteTextEdit(textEdit)
+    end)
+
+    it("showWindow returns true for an element it knows", function()
+      assert.is_true(showWindow(label))
+    end)
+
+    it("showWindow returns false for an unknown name", function()
+      assert.is_false(showWindow(name("wlsNoSuchWindow")))
+    end)
+
+    it("showWindow returns false for the main window", function()
+      -- the main console is not one of the elements show/hideWindow act on
+      assert.is_false(showWindow("main"))
+    end)
+
+    it("hideWindow returns no value but does hide the element", function()
+      assert.are.equal(0, select("#", hideWindow(label)))
+      assert.is_false(windowVisible(label))
+      showWindow(label)
+      assert.is_true(windowVisible(label))
+    end)
+
+    it("hideWindow returns no value for an unknown name", function()
+      assert.are.equal(0, select("#", hideWindow(name("wlsNoSuchWindow"))))
+    end)
+
+    it("hides and shows a text edit", function()
+      assert.is_true(windowVisible(textEdit))
+      hideWindow(textEdit)
+      assert.is_false(windowVisible(textEdit))
+      showWindow(textEdit)
+      assert.is_true(windowVisible(textEdit))
+    end)
+
+    it("showWindow and hideWindow hard-error without a name", function()
+      local shownOk, shownErr = pcall(showWindow)
+      assert.is_false(shownOk)
+      assert.is_truthy(shownErr:find("showWindow: bad argument #1 type", 1, true))
+      local hiddenOk, hiddenErr = pcall(hideWindow)
+      assert.is_false(hiddenOk)
+      assert.is_truthy(hiddenErr:find("hideWindow: bad argument #1 type", 1, true))
+    end)
+  end)
+
+  describe("label text readback", function()
+    local label = name("wlsTextLabel")
+    local console = name("wlsTextConsole")
+
+    setup(function()
+      createLabel(label, 10, 10, 200, 40, 1)
+      createMiniConsole(console, 10, 60, 300, 100)
+    end)
+
+    before_each(function()
+      echo(label, "")
+      clearWindow(console)
+    end)
+
+    teardown(function()
+      deleteLabel(label)
+      deleteMiniConsole(console)
+    end)
+
+    it("a freshly created label has no text", function()
+      local fresh = name("wlsFreshLabel")
+      createLabel(fresh, 0, 0, 10, 10, 1)
+      assert.are.equal("", getLabelText(fresh))
+      deleteLabel(fresh)
+    end)
+
+    it("echo stores HTML markup on a label verbatim", function()
+      -- labels are QLabels: the markup is kept as given, not stripped
+      echo(label, "bold text")
+      assert.are.equal("bold text", getLabelText(label))
+    end)
+
+    it("echo keeps an anchor tag verbatim", function()
+      echo(label, [[link]])
+      assert.are.equal([[link]], getLabelText(label))
+    end)
+
+    it("cecho renders to HTML that still carries the plain text", function()
+      cecho(label, "redtext")
+      local text = getLabelText(label)
+      assert.are.equal("dechotext")
+      local text = getLabelText(label)
+      assert.are.equal(" 0)
+      assert.is_true(h > 0)
+    end)
+
+    it("getLabelSizeHint rejects an empty name and an unknown label", function()
+      local ok, err = getLabelSizeHint("")
+      assert.is_nil(ok)
+      assert.are.equal("label name cannot be an empty string", err)
+      local ok2, err2 = getLabelSizeHint(name("wlsNoSuchLabel"))
+      assert.is_nil(ok2)
+      assert.are.equal(("label '%s' does not exist"):format(name("wlsNoSuchLabel")), err2)
+    end)
+
+    it("setBackgroundColor and getBackgroundColor work on a label", function()
+      assert.is_true(setBackgroundColor(label, 5, 6, 7, 255))
+      assert.are.same({5, 6, 7, 255}, {getBackgroundColor(label)})
+    end)
+
+    local linkStyleCalls = {
+      {name = "setLinkStyle", call = function(target) return setLinkStyle(target, "red", "blue", true) end},
+      {name = "resetLinkStyle", call = function(target) return resetLinkStyle(target) end},
+      {name = "clearVisitedLinks", call = function(target) return clearVisitedLinks(target) end},
+    }
+
+    for _, entry in ipairs(linkStyleCalls) do
+      it(entry.name .. " succeeds on a label and reports an unknown one", function()
+        assert.is_true(entry.call(label))
+        local ok, err = entry.call(name("wlsNoSuchLabel"))
+        assert.is_nil(ok)
+        assert.are.equal(("label '%s' not found"):format(name("wlsNoSuchLabel")), err)
+      end)
+    end
+  end)
+
+  describe("label callback setters", function()
+    local label = name("wlsCallbackLabel")
+
+    setup(function()
+      createLabel(label, 10, 10, 60, 30, 1)
+    end)
+
+    teardown(function()
+      deleteLabel(label)
+    end)
+
+    it("setLabelClickCallback accepts a function", function()
+      assert.is_true(setLabelClickCallback(label, function() end))
+    end)
+
+    it("setLabelClickCallback accepts extra arguments for the callback", function()
+      assert.is_true(setLabelClickCallback(label, function() end, "one", 2))
+    end)
+
+    it("setLabelClickCallback accepts a function name as a string", function()
+      -- the Lua wrapper turns a string into a function calling that name
+      assert.is_true(setLabelClickCallback(label, "wlsNoSuchGlobalFunction"))
+    end)
+
+    it("setLabelClickCallback hard-errors on a value that is neither function, string nor nil", function()
+      local ok, err = pcall(setLabelClickCallback, label, 42)
+      assert.is_false(ok)
+      assert.is_truthy(err:find("setLabelClickCallback: bad argument #2 type (function expected, got number!)", 1, true))
+    end)
+
+    it("setLabelClickCallback rejects an empty label name", function()
+      local ok, err = setLabelClickCallback("", function() end)
+      assert.is_nil(ok)
+      assert.are.equal("label name cannot be an empty string", err)
+    end)
+
+    local callbackSetters = {
+      "setLabelClickCallback",
+      "setLabelDoubleClickCallback",
+      "setLabelReleaseCallback",
+      "setLabelMoveCallback",
+      "setLabelWheelCallback",
+      "setLabelOnEnter",
+      "setLabelOnLeave",
+    }
+
+    for _, setter in ipairs(callbackSetters) do
+      it(setter .. " reports an unknown label", function()
+        local ok, err = _G[setter](name("wlsNoSuchLabel"), function() end)
+        assert.is_nil(ok)
+        assert.are.equal(("label name '%s' not found"):format(name("wlsNoSuchLabel")), err)
+      end)
+    end
+  end)
+
+  describe("font readback", function()
+    local console = name("wlsFontConsole")
+
+    setup(function()
+      createMiniConsole(console, 10, 10, 300, 150)
+    end)
+
+    teardown(function()
+      deleteMiniConsole(console)
+    end)
+
+    it("setFontSize round-trips through getFontSize", function()
+      assert.is_true(setFontSize(console, 14))
+      assert.are.equal(14, getFontSize(console))
+    end)
+
+    it("setMiniConsoleFontSize round-trips through getFontSize", function()
+      assert.is_true(setMiniConsoleFontSize(console, 9))
+      assert.are.equal(9, getFontSize(console))
+    end)
+
+    it("getFontSize, getFont and setFontSize report an unknown window", function()
+      local unknown = name("wlsNoSuchWindow")
+      local ok, err = getFontSize(unknown)
+      assert.is_nil(ok)
+      assert.are.equal(('window "%s" not found'):format(unknown), err)
+      local ok2, err2 = getFont(unknown)
+      assert.is_nil(ok2)
+      assert.are.equal(('window "%s" not found'):format(unknown), err2)
+      local ok3, err3 = setFontSize(unknown, 10)
+      assert.is_nil(ok3)
+      assert.are.equal(('window "%s" not found'):format(unknown), err3)
+    end)
+
+    it("setFont changes the font getFont reports, and can be set back", function()
+      local original = getFont(console)
+      assert.is_true(#original > 0)
+      -- pick a family the font database really offers; a handful of the names
+      -- it lists are aliases that resolve to something else, so allow a few
+      -- attempts rather than trusting the first one
+      local families = {}
+      for family in pairs(getAvailableFonts()) do
+        families[#families + 1] = family
+      end
+      table.sort(families)
+      local applied
+      local attempts = 0
+      for _, family in ipairs(families) do
+        if family ~= original and attempts < 10 then
+          attempts = attempts + 1
+          setFont(console, family)
+          if getFont(console) == family then
+            applied = family
+            break
+          end
+        end
+      end
+      assert.is_string(applied)
+      assert.are.equal(applied, getFont(console))
+      assert.is_true(setFont(console, original))
+      assert.are.equal(original, getFont(console))
+    end)
+
+    it("setFont rejects a font that is not available", function()
+      local ok, err = setFont(console, "wlsNoSuchFontFamily")
+      assert.is_nil(ok)
+      assert.are.equal("font 'wlsNoSuchFontFamily' is not available", err)
+    end)
+
+    it("setFont rejects an empty font name", function()
+      local ok, err = setFont(console, "")
+      assert.is_nil(ok)
+      assert.are.equal("font must not be empty", err)
+    end)
+
+    it("getAvailableFonts returns a table keyed by font name", function()
+      local fonts = getAvailableFonts()
+      assert.is_table(fonts)
+      local count = 0
+      for fontName, present in pairs(fonts) do
+        assert.is_string(fontName)
+        assert.is_true(present)
+        count = count + 1
+      end
+      assert.is_true(count > 0)
+    end)
+
+    it("calcFontSize returns a positive cell size for a font size", function()
+      local w, h = calcFontSize(12)
+      assert.is_true(w > 0)
+      assert.is_true(h > 0)
+    end)
+
+    it("calcFontSize returns a positive cell size for a size and font name", function()
+      -- name a family the console itself resolved to, so this cannot silently
+      -- fall through to the substituted default font
+      local w, h = calcFontSize(12, getFont(console))
+      assert.is_true(w > 0)
+      assert.is_true(h > 0)
+    end)
+
+    it("calcFontSize on a window grows with that window's font size", function()
+      setMiniConsoleFontSize(console, 8)
+      local smallWidth, smallHeight = calcFontSize(console)
+      setMiniConsoleFontSize(console, 20)
+      local largeWidth, largeHeight = calcFontSize(console)
+      assert.is_true(largeWidth > smallWidth)
+      assert.is_true(largeHeight > smallHeight)
+    end)
+
+    it("calcFontSize returns nil for an unknown window", function()
+      assert.is_nil(calcFontSize(name("wlsNoSuchWindow")))
+    end)
+  end)
+
+  describe("console metrics", function()
+    local console = name("wlsMetricConsole")
+
+    setup(function()
+      createMiniConsole(console, 10, 10, 200, 150)
+      setMiniConsoleFontSize(console, 10)
+    end)
+
+    teardown(function()
+      deleteMiniConsole(console)
+    end)
+
+    it("getColumnCount grows when the console is made wider", function()
+      resizeWindow(console, 200, 150)
+      local narrow = getColumnCount(console)
+      resizeWindow(console, 600, 150)
+      local wide = getColumnCount(console)
+      assert.is_true(narrow > 0)
+      assert.is_true(wide > narrow)
+    end)
+
+    it("getRowCount grows when the console is made taller", function()
+      resizeWindow(console, 600, 150)
+      local short = getRowCount(console)
+      resizeWindow(console, 600, 400)
+      local tall = getRowCount(console)
+      assert.is_true(short > 0)
+      assert.is_true(tall > short)
+    end)
+
+    it("getColumnCount and getRowCount report an unknown window", function()
+      local unknown = name("wlsNoSuchWindow")
+      local ok, err = getColumnCount(unknown)
+      assert.is_nil(ok)
+      assert.are.equal(('window "%s" not found'):format(unknown), err)
+      local ok2, err2 = getRowCount(unknown)
+      assert.is_nil(ok2)
+      assert.are.equal(('window "%s" not found'):format(unknown), err2)
+    end)
+
+    it("getMainWindowSize returns a positive width and height", function()
+      local w, h = getMainWindowSize()
+      assert.is_true(w > 0)
+      assert.is_true(h > 0)
+    end)
+
+    it("getMainConsoleWidth returns a positive width", function()
+      assert.is_true(getMainConsoleWidth() > 0)
+    end)
+
+    it("getProfileTabNumber returns the one-based tab position", function()
+      assert.is_true(getProfileTabNumber() >= 1)
+    end)
+
+    it("getUserWindowSize returns the size of a user window", function()
+      -- the height of a dock that has never been laid out by a window manager
+      -- is not meaningful headless, so only the width is pinned
+      local w, h = getUserWindowSize(sharedUserWindow)
+      assert.is_number(w)
+      assert.is_number(h)
+      assert.is_true(w > 0)
+    end)
+  end)
+
+  describe("border sizes and colour", function()
+    local originalSizes
+    local originalColor
+
+    setup(function()
+      originalSizes = getBorderSizes()
+      originalColor = {getBorderColor()}
+    end)
+
+    teardown(function()
+      setBorderSizes(originalSizes.top, originalSizes.right, originalSizes.bottom, originalSizes.left)
+      setBorderColor(originalColor[1], originalColor[2], originalColor[3])
+    end)
+
+    it("the individual border setters round-trip through their getters", function()
+      setBorderTop(7)
+      setBorderRight(10)
+      setBorderBottom(8)
+      setBorderLeft(9)
+      assert.are.equal(7, getBorderTop())
+      assert.are.equal(10, getBorderRight())
+      assert.are.equal(8, getBorderBottom())
+      assert.are.equal(9, getBorderLeft())
+      assert.are.same({top = 7, right = 10, bottom = 8, left = 9}, getBorderSizes())
+    end)
+
+    it("setBorderSizes with one argument sets all four borders", function()
+      setBorderSizes(3)
+      assert.are.same({top = 3, right = 3, bottom = 3, left = 3}, getBorderSizes())
+    end)
+
+    it("setBorderSizes with two arguments takes height then width", function()
+      setBorderSizes(4, 5)
+      assert.are.same({top = 4, right = 5, bottom = 4, left = 5}, getBorderSizes())
+    end)
+
+    it("setBorderSizes with three arguments takes top, width, bottom", function()
+      setBorderSizes(1, 2, 3)
+      assert.are.same({top = 1, right = 2, bottom = 3, left = 2}, getBorderSizes())
+    end)
+
+    it("setBorderSizes with four arguments takes top, right, bottom, left", function()
+      setBorderSizes(1, 2, 3, 4)
+      assert.are.same({top = 1, right = 2, bottom = 3, left = 4}, getBorderSizes())
+    end)
+
+    it("setBorderSizes with no arguments leaves the borders alone", function()
+      setBorderSizes(6, 6, 6, 6)
+      setBorderSizes()
+      assert.are.same({top = 6, right = 6, bottom = 6, left = 6}, getBorderSizes())
+    end)
+
+    it("setBorderTop hard-errors on a non-number", function()
+      local ok, err = pcall(setBorderTop, "wide")
+      assert.is_false(ok)
+      assert.is_truthy(err:find("setBorderTop: bad argument #1 type", 1, true))
+    end)
+
+    it("setBorderColor round-trips through getBorderColor", function()
+      setBorderColor(11, 22, 33)
+      assert.are.same({11, 22, 33}, {getBorderColor()})
+    end)
+  end)
+
+  describe("timestamps", function()
+    local console = name("wlsStampConsole")
+
+    setup(function()
+      createMiniConsole(console, 10, 10, 200, 100)
+    end)
+
+    teardown(function()
+      deleteMiniConsole(console)
+    end)
+
+    it("a new miniconsole has timestamps off, and they can be turned on and off", function()
+      assert.is_false(timeStampsEnabled(console))
+      assert.is_true(enableTimeStamps(console))
+      assert.is_true(timeStampsEnabled(console))
+      assert.is_true(disableTimeStamps(console))
+      assert.is_false(timeStampsEnabled(console))
+    end)
+
+    -- Both refusals share one message, and on the enable path it reads
+    -- "timestamps were not enabled ..." when they in fact already are - so the
+    -- shape is asserted rather than that wrong wording, which should change.
+    it("enableTimeStamps refuses when timestamps are already on", function()
+      enableTimeStamps(console)
+      local ok, err = enableTimeStamps(console)
+      assert.is_nil(ok)
+      assert.is_string(err)
+      disableTimeStamps(console)
+    end)
+
+    it("disableTimeStamps refuses when timestamps are already off", function()
+      disableTimeStamps(console)
+      local ok, err = disableTimeStamps(console)
+      assert.is_nil(ok)
+      assert.is_string(err)
+    end)
+
+    it("timeStampsEnabled reports an unknown window", function()
+      local unknown = name("wlsNoSuchWindow")
+      local ok, err = timeStampsEnabled(unknown)
+      assert.is_nil(ok)
+      assert.are.equal(('window "%s" not found'):format(unknown), err)
+    end)
+  end)
+
+  describe("scrolling state", function()
+    local console = name("wlsScrollConsole")
+
+    setup(function()
+      createMiniConsole(console, 10, 10, 200, 100)
+    end)
+
+    teardown(function()
+      deleteMiniConsole(console)
+    end)
+
+    it("scrollingActive is true for the main window", function()
+      assert.is_true(scrollingActive("main"))
+    end)
+
+    it("disableScrolling and enableScrolling toggle scrollingActive", function()
+      assert.is_true(scrollingActive(console))
+      assert.is_true(disableScrolling(console))
+      assert.is_false(scrollingActive(console))
+      assert.is_true(enableScrolling(console))
+      assert.is_true(scrollingActive(console))
+    end)
+
+    it("getScroll follows the buffer as lines arrive", function()
+      clearWindow(console)
+      assert.are.equal(0, getScroll(console))
+      for i = 1, 30 do
+        echo(console, "line " .. i .. "\n")
+      end
+      -- the view stays at the tail, so the reported position is the last line
+      assert.are.equal(getLastLineNumber(console), getScroll(console))
+      assert.are.equal(30, getScroll(console))
+      clearWindow(console)
+    end)
+
+    local unknownWindowCalls = {
+      {name = "scrollingActive", call = function(target) return scrollingActive(target) end},
+      {name = "getScroll", call = function(target) return getScroll(target) end},
+      {name = "scrollTo", call = function(target) return scrollTo(target, 1) end},
+      {name = "disableScrollBar", call = function(target) return disableScrollBar(target) end},
+      {name = "enableScrollBar", call = function(target) return enableScrollBar(target) end},
+      {name = "disableHorizontalScrollBar", call = function(target) return disableHorizontalScrollBar(target) end},
+      {name = "enableHorizontalScrollBar", call = function(target) return enableHorizontalScrollBar(target) end},
+      {name = "enableScrolling", call = function(target) return enableScrolling(target) end},
+      {name = "disableScrolling", call = function(target) return disableScrolling(target) end},
+    }
+
+    for _, entry in ipairs(unknownWindowCalls) do
+      it(entry.name .. " reports an unknown window", function()
+        local unknown = name("wlsNoSuchWindow")
+        local ok, err = entry.call(unknown)
+        assert.is_nil(ok)
+        assert.are.equal(('window "%s" not found'):format(unknown), err)
+      end)
+    end
+
+    it("the scroll bar toggles return no value for a console they know", function()
+      assert.are.equal(0, select("#", disableScrollBar(console)))
+      assert.are.equal(0, select("#", enableScrollBar(console)))
+      assert.are.equal(0, select("#", disableHorizontalScrollBar(console)))
+      assert.are.equal(0, select("#", enableHorizontalScrollBar(console)))
+    end)
+  end)
+
+  describe("clipboard", function()
+    local originalText
+
+    setup(function()
+      -- this is the real system clipboard, so put back whatever was in it
+      originalText = getClipboardText()
+    end)
+
+    teardown(function()
+      setClipboardText(originalText)
+    end)
+
+    it("setClipboardText round-trips through getClipboardText", function()
+      assert.is_true(setClipboardText("wls clipboard text"))
+      assert.are.equal("wls clipboard text", getClipboardText())
+    end)
+
+    it("setClipboardText hard-errors on a table", function()
+      local ok, err = pcall(setClipboardText, {})
+      assert.is_false(ok)
+      assert.is_truthy(err:find("setClipboardText: bad argument #1 type", 1, true))
+    end)
+  end)
+
+  describe("mouse events", function()
+    local unique = name("wlsMouseEvent")
+    local minimal = name("wlsMouseEventMinimal")
+
+    teardown(function()
+      removeMouseEvent(unique)
+      removeMouseEvent(minimal)
+    end)
+
+    it("addMouseEvent registers an entry that getMouseEvents reports back", function()
+      assert.is_true(addMouseEvent(unique, "wlsEventName", "Display name", "Tooltip text"))
+      local events = getMouseEvents()
+      assert.is_table(events)
+      assert.are.same({
+        ["event name"] = "wlsEventName",
+        ["display name"] = "Display name",
+        ["tooltip text"] = "Tooltip text",
+      }, events[unique])
+    end)
+
+    it("addMouseEvent defaults the display name to the unique name", function()
+      assert.is_true(addMouseEvent(minimal, "wlsMinimalEvent"))
+      assert.are.same({
+        ["event name"] = "wlsMinimalEvent",
+        ["display name"] = minimal,
+        ["tooltip text"] = "",
+      }, getMouseEvents()[minimal])
+    end)
+
+    it("addMouseEvent refuses a name that is already registered", function()
+      addMouseEvent(unique, "wlsEventName")
+      local ok, err = addMouseEvent(unique, "wlsEventName")
+      assert.is_nil(ok)
+      assert.are.equal(("mouse event '%s' already exists"):format(unique), err)
+    end)
+
+    it("removeMouseEvent drops the entry", function()
+      addMouseEvent(unique, "wlsEventName")
+      assert.is_true(removeMouseEvent(unique))
+      assert.is_nil(getMouseEvents()[unique])
+    end)
+
+    it("removeMouseEvent refuses an event that is not registered", function()
+      removeMouseEvent(unique)
+      local ok, err = removeMouseEvent(unique)
+      assert.is_nil(ok)
+      assert.are.equal(("mouse event '%s' does not exist"):format(unique), err)
+    end)
+  end)
+
+  describe("command line menu events and visibility", function()
+    local cmdLine = name("wlsMenuCmdLine")
+    -- the main command line outlives this block, so its menu items are named
+    -- per run and removed again in the teardown
+    local menuLabel = name("wlsMenuLabel")
+    local otherMenuLabel = name("wlsMenuLabel2")
+
+    setup(function()
+      createCommandLine(cmdLine, 10, 10, 150, 30)
+    end)
+
+    teardown(function()
+      removeCommandLineMenuEvent(menuLabel)
+      deleteCommandLine(cmdLine)
+    end)
+
+    it("a menu event added to the main command line can be removed again", function()
+      assert.is_true(addCommandLineMenuEvent(menuLabel, "wlsMenuEvent"))
+      assert.is_true(removeCommandLineMenuEvent(menuLabel))
+    end)
+
+    it("removing a menu event twice reports false and a message", function()
+      addCommandLineMenuEvent(menuLabel, "wlsMenuEvent")
+      removeCommandLineMenuEvent(menuLabel)
+      local ok, err = removeCommandLineMenuEvent(menuLabel)
+      assert.is_false(ok)
+      assert.are.equal(("removeCommandLineMenuEvent: cannot remove '%s', menu item does not exist"):format(menuLabel), err)
+    end)
+
+    it("a menu event can be added to a named command line", function()
+      assert.is_true(addCommandLineMenuEvent(cmdLine, otherMenuLabel, "wlsMenuEvent2"))
+      assert.is_true(removeCommandLineMenuEvent(cmdLine, otherMenuLabel))
+    end)
+
+    it("addCommandLineMenuEvent reports an unknown command line", function()
+      local unknown = name("wlsNoSuchCmdLine")
+      local ok, err = addCommandLineMenuEvent(unknown, "label", "event")
+      assert.is_nil(ok)
+      assert.are.equal(('command line "%s" not found'):format(unknown), err)
+    end)
+
+    it("disableCommandLine hides a command line and enableCommandLine shows it", function()
+      assert.is_true(windowVisible(cmdLine))
+      assert.is_true(disableCommandLine(cmdLine))
+      assert.is_false(windowVisible(cmdLine))
+      assert.is_true(enableCommandLine(cmdLine))
+      assert.is_true(windowVisible(cmdLine))
+    end)
+
+    it("the main command line cannot be enabled or disabled", function()
+      local ok, err = disableCommandLine("main")
+      assert.is_nil(ok)
+      assert.are.equal("this function is not permitted on the main command line", err)
+      local ok2, err2 = enableCommandLine("main")
+      assert.is_nil(ok2)
+      assert.are.equal("this function is not permitted on the main command line", err2)
+    end)
+
+    it("enableCommandLine reports an unknown command line", function()
+      local unknown = name("wlsNoSuchCmdLine")
+      local ok, err = enableCommandLine(unknown)
+      assert.is_nil(ok)
+      assert.are.equal(('command line "%s" not found'):format(unknown), err)
+    end)
+  end)
+
+  describe("setTextFormat", function()
+    local console = name("wlsFormatConsole")
+
+    setup(function()
+      createMiniConsole(console, 10, 10, 400, 100)
+    end)
+
+    before_each(function()
+      clearWindow(console)
+      resetFormat(console)
+      moveCursor(console, 0, 0)
+      deselect(console)
+    end)
+
+    teardown(function()
+      deleteMiniConsole(console)
+    end)
+
+    it("sets the colours and attributes of following output", function()
+      assert.is_true(setTextFormat(console, 1, 2, 3, 250, 251, 252, true, false, true))
+      echo(console, "formatted\n")
+      moveCursor(console, 0, 0)
+      selectSection(console, 0, 3)
+      local format = getTextFormat(console)
+      assert.are.same({250, 251, 252}, format.foreground)
+      assert.are.same({1, 2, 3}, format.background)
+      assert.is_true(format.bold)
+      assert.is_true(format.italic)
+      assert.is_false(format.underline)
+    end)
+
+    it("clamps colour components above 255", function()
+      setTextFormat(console, 0, 0, 0, 999, 0, 0, false, false, false)
+      echo(console, "clamped\n")
+      moveCursor(console, 0, 0)
+      selectSection(console, 0, 3)
+      assert.are.same({255, 0, 0}, getTextFormat(console).foreground)
+    end)
+
+    it("sets the optional strikeout, overline and reverse attributes", function()
+      assert.is_true(setTextFormat(console, 1, 2, 3, 4, 5, 6, false, false, false, true, true, true))
+      echo(console, "optional\n")
+      moveCursor(console, 0, 0)
+      selectSection(console, 0, 3)
+      local format = getTextFormat(console)
+      assert.is_true(format.strikeout)
+      assert.is_true(format.overline)
+      assert.is_true(format.reverse)
+      assert.is_false(format.bold)
+    end)
+
+    it("accepts an optional blink mode and reports it back", function()
+      assert.is_true(setTextFormat(console, 0, 0, 0, 1, 2, 3, false, false, false, false, false, false, "slow"))
+      echo(console, "slow blink\n")
+      moveCursor(console, 0, 0)
+      selectSection(console, 0, 3)
+      assert.are.equal("slow", getTextFormat(console).blinking)
+    end)
+
+    it("rejects an unknown blink mode", function()
+      local ok, err = setTextFormat(console, 0, 0, 0, 1, 2, 3, false, false, false, false, false, false, "sometimes")
+      assert.is_nil(ok)
+      assert.are.equal('blink mode must be "none", "slow", or "fast", got "sometimes"', err)
+    end)
+
+    it("takes numbers as well as booleans for the attribute flags", function()
+      assert.is_true(setTextFormat(console, 0, 0, 0, 1, 2, 3, 1, 0, 1))
+      echo(console, "numeric\n")
+      moveCursor(console, 0, 0)
+      selectSection(console, 0, 3)
+      local format = getTextFormat(console)
+      assert.is_true(format.bold)
+      assert.is_false(format.underline)
+      assert.is_true(format.italic)
+    end)
+
+    -- setTextFormat's argument-type errors are deliberately not covered: the
+    -- lua_error() they raise longjmps past the destructor of the QVector the
+    -- function builds first, so exercising them leaks and fails the leak check
+
+    it("returns false and a message for an unknown window", function()
+      -- unlike most of the UI API this one reports false rather than nil
+      local unknown = name("wlsNoSuchWindow")
+      local ok, err = setTextFormat(unknown, 0, 0, 0, 0, 0, 0, false, false, false)
+      assert.is_false(ok)
+      assert.are.equal(("window '%s' does not exist"):format(unknown), err)
+    end)
+  end)
+
+  describe("command line colours", function()
+    local console = name("wlsCommandColorConsole")
+
+    setup(function()
+      createMiniConsole(console, 10, 10, 200, 100)
+    end)
+
+    teardown(function()
+      deleteMiniConsole(console)
+    end)
+
+    it("setCommandForegroundColor and setCommandBackgroundColor accept a console", function()
+      assert.is_true(setCommandForegroundColor(console, 10, 20, 30))
+      assert.is_true(setCommandBackgroundColor(console, 40, 50, 60, 128))
+    end)
+
+    it("both reject a colour component outside 0-255", function()
+      local ok, err = setCommandForegroundColor(console, 300, 0, 0)
+      assert.is_nil(ok)
+      assert.are.equal("red value 300 needs to be between 0-255", err)
+      local ok2, err2 = setCommandBackgroundColor(console, 0, 300, 0)
+      assert.is_nil(ok2)
+      assert.are.equal("green value 300 needs to be between 0-255", err2)
+    end)
+
+    it("both report an unknown window", function()
+      local unknown = name("wlsNoSuchWindow")
+      local ok, err = setCommandForegroundColor(unknown, 1, 2, 3)
+      assert.is_nil(ok)
+      assert.are.equal(("window/label '%s' not found"):format(unknown), err)
+      local ok2, err2 = setCommandBackgroundColor(unknown, 1, 2, 3)
+      assert.is_nil(ok2)
+      assert.are.equal(("window/label '%s' not found"):format(unknown), err2)
+    end)
+  end)
+
+  describe("getImageSize", function()
+    it("returns the size of a bundled image", function()
+      local w, h = getImageSize(":/icons/mudlet.png")
+      assert.is_true(w > 0)
+      assert.is_true(h > 0)
+    end)
+
+    it("rejects an empty location", function()
+      local ok, err = getImageSize("")
+      assert.is_nil(ok)
+      assert.are.equal("image location cannot be an empty string", err)
+    end)
+
+    it("reports a location it cannot read", function()
+      local ok, err = getImageSize("/wls/no/such/image.png")
+      assert.is_nil(ok)
+      assert.are.equal("couldn't retrieve image size, is the location '/wls/no/such/image.png' correct?", err)
+    end)
+  end)
+
+  describe("setWindow reparenting", function()
+    local label = name("wlsReparentLabel")
+    local userWindow = sharedUserWindow
+
+    setup(function()
+      createLabel(label, 11, 22, 100, 50, 1)
+    end)
+
+    before_each(function()
+      setWindow("main", label, 11, 22, true)
+    end)
+
+    teardown(function()
+      deleteLabel(label)
+    end)
+
+    it("moves an element into a user window at the given position", function()
+      assert.is_true(setWindow(userWindow, label, 3, 4, true))
+      local x, y, w, h = getWindowGeometry(label)
+      assert.are.same({3, 4, 100, 50}, {x, y, w, h})
+      assert.is_true(windowVisible(label))
+    end)
+
+    it("moves an element back to the main window", function()
+      setWindow(userWindow, label, 3, 4, true)
+      assert.is_true(setWindow("main", label, 60, 70, true))
+      local x, y = getWindowGeometry(label)
+      assert.are.same({60, 70}, {x, y})
+    end)
+
+    -- Qt hides a widget when it is reparented, and setWindow only calls show()
+    -- again when asked to, so an unshown element stays hidden after the move
+    it("leaves a reparented element hidden when asked not to show it", function()
+      assert.is_true(setWindow(userWindow, label, 3, 4, false))
+      assert.is_false(windowVisible(label))
+    end)
+
+    it("defaults to the origin and to showing the element", function()
+      assert.is_true(setWindow(userWindow, label))
+      local x, y = getWindowGeometry(label)
+      assert.are.same({0, 0}, {x, y})
+      assert.is_true(windowVisible(label))
+    end)
+
+    it("reports an element it cannot find", function()
+      local unknown = name("wlsNoSuchElement")
+      local ok, err = setWindow("main", unknown, 0, 0, true)
+      assert.is_nil(ok)
+      assert.are.equal(("element '%s' not found"):format(unknown), err)
+    end)
+
+    it("reports a parent window it cannot find", function()
+      local unknown = name("wlsNoSuchWindow")
+      local ok, err = setWindow(unknown, label, 0, 0, true)
+      assert.is_nil(ok)
+      assert.are.equal(("window '%s' not found"):format(unknown), err)
+    end)
+  end)
+
+  describe("user window title and stylesheet", function()
+    local userWindow = sharedUserWindow
+
+    teardown(function()
+      -- the window itself cannot be deleted, so undo what these specs set
+      resetUserWindowTitle(userWindow)
+      setUserWindowStyleSheet(userWindow, "")
+    end)
+
+    it("setUserWindowTitle accepts a title and reports an unknown window", function()
+      assert.is_true(setUserWindowTitle(userWindow, "A title"))
+      local unknown = name("wlsNoSuchWindow")
+      local ok, err = setUserWindowTitle(unknown, "A title")
+      assert.is_nil(ok)
+      assert.are.equal(("user window name '%s' not found"):format(unknown), err)
+    end)
+
+    it("setUserWindowStyleSheet accepts a stylesheet and reports an unknown window", function()
+      assert.is_true(setUserWindowStyleSheet(userWindow, "background-color: rgb(1,2,3);"))
+      local unknown = name("wlsNoSuchWindow")
+      local ok, err = setUserWindowStyleSheet(unknown, "background-color: rgb(1,2,3);")
+      assert.is_nil(ok)
+      assert.are.equal(("userwindow name '%s' not found"):format(unknown), err)
+    end)
+  end)
+
+  describe("stacking and buffer transfer", function()
+    local label = name("wlsStackLabel")
+    local source = name("wlsStackSource")
+    local target = name("wlsStackTarget")
+
+    setup(function()
+      createLabel(label, 10, 10, 60, 30, 1)
+      createMiniConsole(source, 10, 50, 300, 100)
+      createMiniConsole(target, 10, 160, 300, 100)
+    end)
+
+    teardown(function()
+      deleteLabel(label)
+      deleteMiniConsole(source)
+      deleteMiniConsole(target)
+    end)
+
+    it("raiseWindow and lowerWindow accept an element they know", function()
+      assert.is_true(raiseWindow(label))
+      assert.is_true(lowerWindow(label))
+    end)
+
+    it("raiseWindow and lowerWindow return false for an unknown element", function()
+      local unknown = name("wlsNoSuchWindow")
+      assert.is_false(raiseWindow(unknown))
+      assert.is_false(lowerWindow(unknown))
+    end)
+
+    it("pasteWindow places the copied selection into another console", function()
+      clearWindow(source)
+      clearWindow(target)
+      echo(source, "pasted line\n")
+      moveCursor(source, 0, 0)
+      selectCurrentLine(source)
+      copy(source)
+      pasteWindow(target)
+      assert.are.equal(1, getLineCount(target))
+      assert.are.same({"pasted line"}, getLines(target, 0, 1))
+    end)
+
+    it("pasteWindow hard-errors on a non-string window name", function()
+      local ok, err = pcall(pasteWindow, {})
+      assert.is_false(ok)
+      assert.is_truthy(err:find("pasteWindow: bad argument #1 type", 1, true))
+    end)
+
+    it("deleteTextEdit reports a text edit it cannot find", function()
+      local unknown = name("wlsNoSuchTextEdit")
+      local ok, err = deleteTextEdit(unknown)
+      assert.is_false(ok)
+      assert.are.equal(("text edit name '%s' not found"):format(unknown), err)
+    end)
+
+    it("deleteLabel refuses to delete something that is not a label", function()
+      local ok, err = deleteLabel(source)
+      assert.is_false(ok)
+      assert.are.equal(("label name '%s' not found"):format(source), err)
+    end)
+  end)
+end)

From 48eec974beded7fd6ebbf8f1d02a944399d30bfe Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Sun, 2 Aug 2026 12:57:32 +0200
Subject: [PATCH 040/155] infrastructure: drop attempt cap in setFont
 round-trip test

The 10-attempt cap could be exhausted by alias families, failing the
test even when a later family round-trips. Scanning every family costs
~0.24s worst case and only in the path that would otherwise fail.

Assisted-by: Claude:claude-opus-5
---
 src/mudlet-lua/tests/UI_spec.lua | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/src/mudlet-lua/tests/UI_spec.lua b/src/mudlet-lua/tests/UI_spec.lua
index 4281fc127..8b8f5b892 100644
--- a/src/mudlet-lua/tests/UI_spec.lua
+++ b/src/mudlet-lua/tests/UI_spec.lua
@@ -3281,19 +3281,17 @@ describe("Window and label state", function()
     it("setFont changes the font getFont reports, and can be set back", function()
       local original = getFont(console)
       assert.is_true(#original > 0)
-      -- pick a family the font database really offers; a handful of the names
-      -- it lists are aliases that resolve to something else, so allow a few
-      -- attempts rather than trusting the first one
+      -- pick a family the font database really offers; some of the names it
+      -- lists are generic aliases (Monospace, Serif, ...) that resolve to a
+      -- different family, so keep looking until one actually round-trips
       local families = {}
       for family in pairs(getAvailableFonts()) do
         families[#families + 1] = family
       end
       table.sort(families)
       local applied
-      local attempts = 0
       for _, family in ipairs(families) do
-        if family ~= original and attempts < 10 then
-          attempts = attempts + 1
+        if family ~= original then
           setFont(console, family)
           if getFont(console) == family then
             applied = family

From 44da9ec2379d396640e7b9c3252b02096c939ac0 Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Sun, 2 Aug 2026 16:25:26 +0200
Subject: [PATCH 041/155] fix: setTextFormat leak, createLabel return
 convention, windowType scrollbox

setTextFormat built a QVector and a QString before validating its
arguments, so every lua_error() on the type paths longjmped past their
destructors. createLabel's two helpers held QStrings across the same kind
of raise. Both now build owning objects only once nothing else can raise.

createLabel discarded its helpers' return count and always returned 1, so a
failed call handed Lua just the message string - truthy, so the failure was
undetectable. It now returns the documented false + message.

windowType gained a scroll box branch, and its not-found message now names
every type it checks.

UI_spec.lua flips the specs that documented the old behaviour and covers
setTextFormat's argument-type errors, which the leak used to block.

Fixes #9576
Fixes #9577
Fixes #9578

Assisted-by: Claude:claude-opus-5
---
 src/Host.cpp                     |  4 ++
 src/TLuaInterpreter.cpp          | 13 +++---
 src/TLuaInterpreter.h            |  4 +-
 src/TLuaInterpreterUI.cpp        | 39 +++++++++--------
 src/mudlet-lua/tests/UI_spec.lua | 75 +++++++++++++++++++++++++++++---
 5 files changed, 104 insertions(+), 31 deletions(-)

diff --git a/src/Host.cpp b/src/Host.cpp
index b51b006bf..99d806cf1 100644
--- a/src/Host.cpp
+++ b/src/Host.cpp
@@ -4891,6 +4891,10 @@ std::optional Host::windowType(const QString& name) const
         }
     }
 
+    if (mpConsole->mScrollBoxMap.contains(name)) {
+        return {qsl("scrollbox")};
+    }
+
     if (mpConsole->mSubCommandLineMap.contains(name)) {
         return {qsl("commandline")};
     }
diff --git a/src/TLuaInterpreter.cpp b/src/TLuaInterpreter.cpp
index dcc0c14be..44f09148c 100644
--- a/src/TLuaInterpreter.cpp
+++ b/src/TLuaInterpreter.cpp
@@ -1387,7 +1387,10 @@ int TLuaInterpreter::getMudletInfo(lua_State* L)
 }
 
 // Internal Function createLabel in an UserWindow
-int TLuaInterpreter::createLabelUserWindow(lua_State* L, const QString& windowName, const QString& labelName)
+// The names arrive as the Lua-owned strings still anchored at stack indexes 1 and
+// 2 rather than as QStrings: every check below can raise, and lua_error() longjmps
+// past C++ destructors, so the QStrings are only built once nothing else can raise
+int TLuaInterpreter::createLabelUserWindow(lua_State* L, const char* windowName, const char* labelName)
 {
     const int n = lua_gettop(L);
     const int x = getVerifiedInt(L, "createLabel", 3, "label x-coordinate");
@@ -1420,7 +1423,7 @@ int TLuaInterpreter::createLabelUserWindow(lua_State* L, const QString& windowNa
     }
 
     Host& host = getHostFromLua(L);
-    if (auto [success, message] = host.createLabel(windowName, labelName, x, y, width, height, fillBackground, clickthrough); !success) {
+    if (auto [success, message] = host.createLabel(QString{windowName}, QString{labelName}, x, y, width, height, fillBackground, clickthrough); !success) {
         // We should, perhaps be returning a nil here but the published API
         // says the function returns true or false and we cannot change that now
         return warnArgumentValue(L, "createLabel", message, true);
@@ -1431,9 +1434,9 @@ int TLuaInterpreter::createLabelUserWindow(lua_State* L, const QString& windowNa
 }
 
 // Internal Function create Label in MainWindow
-int TLuaInterpreter::createLabelMainWindow(lua_State* L, const QString& labelName)
+// See createLabelUserWindow() for why the name is not a QString
+int TLuaInterpreter::createLabelMainWindow(lua_State* L, const char* labelName)
 {
-    const QString windowName = QLatin1String("main");
     const int n = lua_gettop(L);
     const int x = getVerifiedInt(L, "createLabel", 2, "label x-coordinate");
     const int y = getVerifiedInt(L, "createLabel", 3, "label y-coordinate");
@@ -1465,7 +1468,7 @@ int TLuaInterpreter::createLabelMainWindow(lua_State* L, const QString& labelNam
     }
 
     Host& host = getHostFromLua(L);
-    if (auto [success, message] = host.createLabel(windowName, labelName, x, y, width, height, fillBackground, clickthrough); !success) {
+    if (auto [success, message] = host.createLabel(qsl("main"), QString{labelName}, x, y, width, height, fillBackground, clickthrough); !success) {
         // We should, perhaps be returning a nil here but the published API
         // says the function returns true or false and we cannot change that now
         return warnArgumentValue(L, "createLabel", message, true);
diff --git a/src/TLuaInterpreter.h b/src/TLuaInterpreter.h
index 42ca5650c..1f8e64eae 100644
--- a/src/TLuaInterpreter.h
+++ b/src/TLuaInterpreter.h
@@ -446,8 +446,8 @@ public:
     static int createMiniConsole(lua_State*);
     static int createScrollBox(lua_State*);
     static int createLabel(lua_State*);
-    static int createLabelMainWindow(lua_State*, const QString& labelName);
-    static int createLabelUserWindow(lua_State*, const QString& windowName, const QString& labelName);
+    static int createLabelMainWindow(lua_State*, const char* labelName);
+    static int createLabelUserWindow(lua_State*, const char* windowName, const char* labelName);
     static int deleteLabel(lua_State*);
     static int deleteMiniConsole(lua_State*);
     static int deleteCommandLine(lua_State*);
diff --git a/src/TLuaInterpreterUI.cpp b/src/TLuaInterpreterUI.cpp
index c0fcb4e23..0b71e13e6 100644
--- a/src/TLuaInterpreterUI.cpp
+++ b/src/TLuaInterpreterUI.cpp
@@ -59,6 +59,7 @@
 #include "glwidget_integration.h"
 #endif
 
+#include 
 #include 
 #include 
 
@@ -352,26 +353,19 @@ int TLuaInterpreter::createCommandLine(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#createLabel
 int TLuaInterpreter::createLabel(lua_State* L)
 {
-    QString labelName;
-    QString windowName = QLatin1String("main");
-
     if (lua_type(L, 1) != LUA_TSTRING) {
         lua_pushfstring(L, "createLabel: bad argument #1 type (label or parent window name as string expected, got %s!)", luaL_typename(L, 1));
         return lua_error(L);
     }
-    if ((lua_type(L, 1) == LUA_TSTRING) && (lua_type(L, 2) == LUA_TSTRING)) {
-        windowName = lua_tostring(L, 1);
-        labelName = lua_tostring(L, 2);
-        createLabelUserWindow(L, windowName, labelName);
-    } else if ((lua_type(L, 1) == LUA_TSTRING) && (lua_type(L, 2) == LUA_TNUMBER)) {
-        labelName = lua_tostring(L, 1);
-        createLabelMainWindow(L, labelName);
-    } else {
-        lua_pushfstring(L, "createLabel: bad argument #2 type (label name as string or label x-coordinate as number expected, got %s!)", luaL_typename(L, 2));
-        return lua_error(L);
+    if (lua_type(L, 2) == LUA_TSTRING) {
+        return createLabelUserWindow(L, lua_tostring(L, 1), lua_tostring(L, 2));
+    }
+    if (lua_type(L, 2) == LUA_TNUMBER) {
+        return createLabelMainWindow(L, lua_tostring(L, 1));
     }
 
-    return 1;
+    lua_pushfstring(L, "createLabel: bad argument #2 type (label name as string or label x-coordinate as number expected, got %s!)", luaL_typename(L, 2));
+    return lua_error(L);
 }
 
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#createMiniConsole
@@ -3303,9 +3297,16 @@ int TLuaInterpreter::setTextFormat(lua_State* L)
 
     const int n = lua_gettop(L);
 
-    const QString windowName{WINDOW_NAME(L, 1)};
+    // Every argument check below can raise a Lua error, and lua_error() longjmps
+    // past C++ destructors - so nothing holding heap memory may be alive while they
+    // run: the window name stays the Lua-owned string anchored at stack index 1 and
+    // the colour components a plain array until the last check has passed. The
+    // blinkMode QString further down is exempt only because it holds a
+    // QStringLiteral until after the last raise; give it a computed default and the
+    // leak comes back
+    const char* windowNameCString = WINDOW_NAME(L, 1);
 
-    QVector colorComponents(6); // 0-2 RGB background, 3-5 RGB foreground
+    std::array colorComponents{}; // 0-2 RGB background, 3-5 RGB foreground
     colorComponents[0] = qRound(qBound(0.0, getVerifiedDouble(L, __func__, 2, "red background color component"), 255.0));
     colorComponents[1] = qRound(qBound(0.0, getVerifiedDouble(L, __func__, 3, "green background color component"), 255.0));
     colorComponents[2] = qRound(qBound(0.0, getVerifiedDouble(L, __func__, 4, "blue background color component"), 255.0));
@@ -3406,8 +3407,8 @@ int TLuaInterpreter::setTextFormat(lua_State* L)
                                         | (reverse ? TChar::Reverse : TChar::None) | (strikeout ? TChar::StrikeOut : TChar::None) | (underline ? TChar::Underline : TChar::None)
                                         | (fastBlink ? TChar::FastBlink : (slowBlink ? TChar::Blink : TChar::None));
 
-    if (!host.mpConsole->setTextFormat(
-                windowName, QColor(colorComponents.at(3), colorComponents.at(4), colorComponents.at(5)), QColor(colorComponents.at(0), colorComponents.at(1), colorComponents.at(2)), flags)) {
+    const QString windowName{windowNameCString};
+    if (!host.mpConsole->setTextFormat(windowName, QColor(colorComponents[3], colorComponents[4], colorComponents[5]), QColor(colorComponents[0], colorComponents[1], colorComponents[2]), flags)) {
         return warnArgumentValue(L, __func__, qsl("window '%1' does not exist").arg(windowName), true);
     }
 
@@ -3752,7 +3753,7 @@ int TLuaInterpreter::windowType(lua_State* L)
     }
 
     lua_pushnil(L);
-    lua_pushfstring(L, "'%s' is not a known label, any type of console, nor command line", windowName.toUtf8().constData());
+    lua_pushfstring(L, "'%s' is not a known label, any type of console, command line, text edit, nor scroll box", windowName.toUtf8().constData());
     return 2;
 }
 
diff --git a/src/mudlet-lua/tests/UI_spec.lua b/src/mudlet-lua/tests/UI_spec.lua
index 8b8f5b892..efd1b6fbe 100644
--- a/src/mudlet-lua/tests/UI_spec.lua
+++ b/src/mudlet-lua/tests/UI_spec.lua
@@ -133,11 +133,22 @@ describe("Tests UI functions", function()
       assert.are.equal(windowType("fake commandline"), nil)
     end)
 
+    it("Should identify a scroll box", function()
+      createScrollBox("testscrollbox", 0,0,100,100)
+
+      assert.are.equal(windowType("testscrollbox"), "scrollbox")
+    end)
+
+    it("Should not identify a non-existing scroll box", function()
+      assert.are.equal(windowType("fake scrollbox"), nil)
+    end)
+
     teardown(function()
       deleteLabel("testlabel")
       hideWindow("testuserwindow")
       hideWindow("testminiconsole")
       disableCommandLine("testcommandline")
+      deleteScrollBox("testscrollbox")
     end)
   end)
 
@@ -2841,8 +2852,7 @@ describe("Window and label state", function()
       assert.are.equal("miniconsole", windowType(console))
       assert.are.equal("commandline", windowType(cmdLine))
       assert.are.equal("textedit", windowType(textEdit))
-      -- windowType is deliberately not asserted for the scroll box: it has no
-      -- scroll box branch, so it reports a live scroll box as unknown
+      assert.are.equal("scrollbox", windowType(scrollBox))
     end)
 
     it("openUserWindow reports the window as a userwindow and is repeatable", function()
@@ -2858,6 +2868,37 @@ describe("Window and label state", function()
       assert.are.equal(("label with the name '%s' already exists"):format(label), err)
     end)
 
+    it("createLabel on an existing name returns false and a message", function()
+      local ok, err = createLabel(label, 41, 51, 61, 71, 1)
+      assert.is_false(ok)
+      assert.are.equal(("label '%s' already exists"):format(label), err)
+      -- the parented form reports the same way
+      local childOk, childErr = createLabel(userWindow, childLabel, 4, 5, 30, 20, 1)
+      assert.is_false(childOk)
+      assert.are.equal(("label '%s' already exists"):format(childLabel), childErr)
+      -- unlike createMiniConsole/createScrollBox a refused createLabel must leave
+      -- the existing labels alone rather than moving and resizing them
+      assert.are.same({11, 22, 133, 44}, {getWindowGeometry(label)})
+      assert.are.same({5, 6, 40, 20}, {getWindowGeometry(childLabel)})
+    end)
+
+    it("createLabel on a name taken by a miniconsole returns false and a message", function()
+      local ok, err = createLabel(console, 1, 2, 3, 4, 1)
+      assert.is_false(ok)
+      assert.are.equal(("a miniconsole/userwindow with the name '%s' already exists"):format(console), err)
+    end)
+
+    it("createLabel hard-errors on a non-number coordinate", function()
+      -- a string second argument selects the parented form, so the two forms
+      -- report the same argument number for different coordinates
+      local mainOk, mainErr = pcall(createLabel, name("wlsBadCoordLabel"), 0, "here", 40, 40, 1)
+      assert.is_false(mainOk)
+      assert.is_truthy(mainErr:find("createLabel: bad argument #3 type (label y-coordinate", 1, true))
+      local childOk, childErr = pcall(createLabel, userWindow, name("wlsBadCoordChild"), "here", 0, 40, 40, 1)
+      assert.is_false(childOk)
+      assert.is_truthy(childErr:find("createLabel: bad argument #3 type (label x-coordinate", 1, true))
+    end)
+
     it("createMiniConsole on an existing name moves and resizes it instead", function()
       local ok, err = createMiniConsole(console, 40, 50, 260, 130)
       local geometry = {getWindowGeometry(console)}
@@ -3810,9 +3851,33 @@ describe("Window and label state", function()
       assert.is_true(format.italic)
     end)
 
-    -- setTextFormat's argument-type errors are deliberately not covered: the
-    -- lua_error() they raise longjmps past the destructor of the QVector the
-    -- function builds first, so exercising them leaks and fails the leak check
+    -- these four cover setTextFormat's raising paths, which used to leak the
+    -- objects the function built before validating (issue #9576) - they assert the
+    -- messages, the leak checker asserts the rest
+
+    it("hard-errors on a non-number colour component", function()
+      local ok, err = pcall(setTextFormat, console, "red", 0, 0, 0, 0, 0, false, false, false)
+      assert.is_false(ok)
+      assert.is_truthy(err:find("setTextFormat: bad argument #2 type", 1, true))
+    end)
+
+    it("hard-errors on a non-boolean attribute", function()
+      local ok, err = pcall(setTextFormat, console, 0, 0, 0, 0, 0, 0, "yes", false, false)
+      assert.is_false(ok)
+      assert.is_truthy(err:find("setTextFormat: bad argument #8 type", 1, true))
+    end)
+
+    it("hard-errors on a non-boolean optional attribute", function()
+      local ok, err = pcall(setTextFormat, console, 0, 0, 0, 0, 0, 0, false, false, false, "yes")
+      assert.is_false(ok)
+      assert.is_truthy(err:find("setTextFormat: bad argument #11 type", 1, true))
+    end)
+
+    it("hard-errors on a blink mode that is not a string", function()
+      local ok, err = pcall(setTextFormat, console, 0, 0, 0, 0, 0, 0, false, false, false, false, false, false, {})
+      assert.is_false(ok)
+      assert.is_truthy(err:find("setTextFormat: bad argument #14 type", 1, true))
+    end)
 
     it("returns false and a message for an unknown window", function()
       -- unlike most of the UI API this one reports false rather than nil

From c1ba72991996f9aff7e04d916b1d7859113b4db9 Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Sun, 2 Aug 2026 12:02:45 +0200
Subject: [PATCH 042/155] infrastructure: move media and TTS specs into
 Media_spec.lua

Pure relocation: the media contract specs leave Networking_spec.lua and the
text-to-speech ones leave Miscallaneous_spec.lua, unchanged, so the audio side
of the Lua API has one home.

Assisted-by: Claude:claude-opus-4-8
---
 src/mudlet-lua/tests/Media_spec.lua         | 254 ++++++++++++++++++++
 src/mudlet-lua/tests/Miscallaneous_spec.lua |  91 -------
 src/mudlet-lua/tests/Networking_spec.lua    | 156 +-----------
 3 files changed, 259 insertions(+), 242 deletions(-)
 create mode 100644 src/mudlet-lua/tests/Media_spec.lua

diff --git a/src/mudlet-lua/tests/Media_spec.lua b/src/mudlet-lua/tests/Media_spec.lua
new file mode 100644
index 000000000..a7a4137b6
--- /dev/null
+++ b/src/mudlet-lua/tests/Media_spec.lua
@@ -0,0 +1,254 @@
+-- Specs for the media and text-to-speech Lua APIs.
+--
+-- Both families were previously homed in other domain spec files: the media
+-- contracts in Networking_spec.lua and the text-to-speech ones in
+-- Miscallaneous_spec.lua. They live here now so the audio side of the API has
+-- one home. The specs themselves are unchanged by that move.
+
+local function contains(haystack, needle)
+  return type(haystack) == "string" and haystack:find(needle, 1, true) ~= nil
+end
+
+-- Asserts that calling fn raises a Lua error whose message contains needle.
+-- Matching a message substring (rather than merely "did it error?") ensures the
+-- function is actually registered and reached its own argument validation: an
+-- unregistered/nil function would raise a different "attempt to call" error.
+local function assertArgError(fn, needle)
+  local ok, err = pcall(fn)
+  assert.is_false(ok)
+  assert.is_true(contains(err, needle))
+end
+
+describe("Media playback functions validate their parameters", function()
+  -- None of these reach playMedia()/stopMedia() on a real file, so no playback
+  -- is started: each returns before the media engine is touched.
+  describe("playSoundFile", function()
+    it("raises a Lua error when called with no arguments", function()
+      assertArgError(function() playSoundFile() end, "playSoundFile: need at least one argument")
+    end)
+
+    it("raises a Lua error when the table form has no name", function()
+      assert.has_error(function() playSoundFile({}) end)
+    end)
+
+    it("raises a Lua error for a negative fadein in the table form", function()
+      assert.has_error(function() playSoundFile({name = "x.wav", fadein = -1}) end)
+    end)
+
+    it("returns nil when the ordered form supplies no filename", function()
+      local ok, err = playSoundFile(nil)
+      assert.is_nil(ok)
+      assert.is_true(contains(err, "missing argument 1"))
+    end)
+  end)
+
+  describe("playMusicFile", function()
+    it("raises a Lua error when called with no arguments", function()
+      assertArgError(function() playMusicFile() end, "playMusicFile: need at least one argument")
+    end)
+
+    it("raises a Lua error when the table form has no name", function()
+      assert.has_error(function() playMusicFile({}) end)
+    end)
+
+    it("raises a Lua error for a negative fadeout in the table form", function()
+      assert.has_error(function() playMusicFile({name = "x.mp3", fadeout = -5}) end)
+    end)
+
+    it("raises a clean, non-doubled error when continue is not a boolean", function()
+      -- Regression #9547 (same defect class): the field publicName must not carry
+      -- "must be boolean", which errorArgumentType would then double.
+      local ok, err = pcall(function() playMusicFile({name = "x.mp3", continue = "yes"}) end)
+      assert.is_false(ok)
+      assert.is_true(contains(err, "value for continue as boolean expected, got string!"), tostring(err))
+      assert.is_false(contains(err, "must be boolean"), tostring(err))
+    end)
+  end)
+
+  describe("playVideoFile", function()
+    -- playVideoFileAsTableArgument shared the identical doubled-message defect on
+    -- its continue/stream/close boolean fields (#9547 defect class).
+    it("raises a clean, non-doubled error when continue is not a boolean", function()
+      local ok, err = pcall(function() playVideoFile({name = "x.mp4", continue = "yes"}) end)
+      assert.is_false(ok)
+      assert.is_true(contains(err, "value for continue as boolean expected, got string!"), tostring(err))
+      assert.is_false(contains(err, "must be boolean"), tostring(err))
+    end)
+
+    it("raises a clean, non-doubled error when stream is not a boolean", function()
+      local ok, err = pcall(function() playVideoFile({name = "x.mp4", stream = "yes"}) end)
+      assert.is_false(ok)
+      assert.is_true(contains(err, "value for stream as boolean expected, got string!"), tostring(err))
+      assert.is_false(contains(err, "must be boolean"), tostring(err))
+    end)
+
+    it("raises a clean, non-doubled error when close is not a boolean", function()
+      local ok, err = pcall(function() playVideoFile({name = "x.mp4", close = "yes"}) end)
+      assert.is_false(ok)
+      assert.is_true(contains(err, "value for close as boolean expected, got string!"), tostring(err))
+      assert.is_false(contains(err, "must be boolean"), tostring(err))
+    end)
+  end)
+
+  describe("getPlayingSounds", function()
+    it("raises a clean, non-doubled error when priority is not an integer", function()
+      -- Regression #9547 (same defect class): "value for priority must be integer"
+      -- doubled into "must be integer as number expected".
+      local ok, err = pcall(function() getPlayingSounds({priority = "high"}) end)
+      assert.is_false(ok)
+      assert.is_true(contains(err, "value for priority as number expected, got string!"), tostring(err))
+      assert.is_false(contains(err, "must be integer"), tostring(err))
+    end)
+  end)
+
+  describe("stopSounds", function()
+    it("returns true when stopping everything with no arguments", function()
+      assert.is_true(stopSounds())
+    end)
+
+    it("raises a Lua error for a negative fadeout in the table form", function()
+      assert.has_error(function() stopSounds({fadeout = -1}) end)
+    end)
+
+    it("raises a clean, non-doubled error when priority is not an integer", function()
+      -- Regression #9547 (same defect class, adjacent field in this very parser):
+      -- "value for priority must be integer" doubled the type constraint.
+      local ok, err = pcall(function() stopSounds({priority = "high"}) end)
+      assert.is_false(ok)
+      assert.is_true(contains(err, "value for priority as number expected, got string!"), tostring(err))
+      assert.is_false(contains(err, "must be integer"), tostring(err))
+    end)
+
+    it("raises a clean, non-doubled error when fadeaway is not a boolean", function()
+      -- Regression #9547: the message must not double "boolean" (the field's
+      -- publicName previously carried "must be boolean" while the type validator
+      -- also appended "as boolean expected"). It is reported like the sibling
+      -- table-field validations in this parser (fadeout, name, key).
+      local ok, err = pcall(function() stopSounds({fadeaway = "yes"}) end)
+      assert.is_false(ok)
+      assert.is_true(contains(err, "value for fadeaway as boolean expected, got string!"), tostring(err))
+      assert.is_false(contains(err, "must be boolean"), tostring(err))
+    end)
+  end)
+
+  -- stopMusic and stopVideos parse the same table shape and shared the identical
+  -- doubled-"boolean" fadeaway defect fixed for stopSounds (#9547).
+  describe("stopMusic", function()
+    it("raises a clean, non-doubled error when fadeaway is not a boolean", function()
+      local ok, err = pcall(function() stopMusic({fadeaway = "yes"}) end)
+      assert.is_false(ok)
+      assert.is_true(contains(err, "value for fadeaway as boolean expected, got string!"), tostring(err))
+      assert.is_false(contains(err, "must be boolean"), tostring(err))
+    end)
+  end)
+
+  describe("stopVideos", function()
+    it("raises a clean, non-doubled error when fadeaway is not a boolean", function()
+      local ok, err = pcall(function() stopVideos({fadeaway = "yes"}) end)
+      assert.is_false(ok)
+      assert.is_true(contains(err, "value for fadeaway as boolean expected, got string!"), tostring(err))
+      assert.is_false(contains(err, "must be boolean"), tostring(err))
+    end)
+  end)
+end)
+
+describe("receiveMSP reports MSP is not enabled while offline", function()
+  it("returns nil and a message when MSP has not been negotiated", function()
+    local ok, err = receiveMSP("!!SOUND(x.wav)")
+    assert.is_nil(ok)
+    assert.is_true(contains(err, "MSP is not currently enabled"))
+  end)
+end)
+
+describe("Tests the text-to-speech Lua API", function()
+    describe("Tests the functionality of ttsGetQueue", function()
+      -- Mudlet compiled without TTS support installs dummy tts functions
+      -- which return nil, whereas the real ttsGetQueue() returns a table
+      local function ttsAvailable()
+        return type(ttsGetQueue()) == "table"
+      end
+
+      it("should return a table when called without an index", function()
+        if not ttsAvailable() then
+          pending("TTS is not available in this build")
+          return
+        end
+        assert.is_table(ttsGetQueue())
+      end)
+
+      it("should return false for an index just past the end of the queue", function()
+        if not ttsAvailable() then
+          pending("TTS is not available in this build")
+          return
+        end
+        ttsClearQueue()
+        -- on an empty queue, index 1 is exactly one past the end (index == size)
+        assert.is_false(ttsGetQueue(1))
+      end)
+
+      it("should return false for an index below the start of the queue", function()
+        if not ttsAvailable() then
+          pending("TTS is not available in this build")
+          return
+        end
+        assert.is_false(ttsGetQueue(0))
+      end)
+    end)
+
+    describe("Tests the text-to-speech mock engine", function()
+      -- ttsBuild() selects Qt's deterministic mock engine under MUDLET_TEST_MODE,
+      -- so these specs only run in test mode and never drive a developer's real
+      -- speech engine. Where the mock plugin is absent they skip so local runs
+      -- still pass; CI sets MUDLET_TEST_REQUIRE_TTS_MOCK to turn that skip into a
+      -- failure, so a broken mock selection cannot hide behind a green skip. Async
+      -- speech events (ttsSpeechStarted...) need the waitForEvent helper and are
+      -- left to the post-enabler TTS specs.
+      local testMode = os.getenv("MUDLET_TEST_MODE")
+      local requireMock = os.getenv("MUDLET_TEST_REQUIRE_TTS_MOCK")
+
+      local function ttsEngineAvailable()
+        return testMode and type(ttsGetVoices) == "function" and type(ttsGetVoices()) == "table" and #ttsGetVoices() > 0
+      end
+
+      -- Returns true when the caller should stop because no engine is available
+      -- and skipping is permitted; fails hard where the mock is mandatory.
+      local function ttsEngineUnavailable()
+        if ttsEngineAvailable() then
+          return false
+        end
+        if requireMock then
+          assert.is_true(false, "MUDLET_TEST_REQUIRE_TTS_MOCK is set but the mock TTS engine has no voices - it was not selected")
+        end
+        pending("mock TTS engine unavailable (run with MUDLET_TEST_MODE and Qt's mock plugin)")
+        return true
+      end
+
+      it("ttsGetVoices returns a non-empty list of voice-name strings", function()
+        if ttsEngineUnavailable() then
+          return
+        end
+        local voices = ttsGetVoices()
+        assert.is_table(voices)
+        assert.is_true(#voices > 0)
+        for _, name in ipairs(voices) do
+          assert.is_string(name)
+        end
+        -- ttsGetState maps the freshly built engine's ready state to its string
+        assert.equals("ttsSpeechReady", ttsGetState())
+      end)
+
+      it("ttsSpeak accepts valid text and rejects whitespace-only text", function()
+        if ttsEngineUnavailable() then
+          return
+        end
+        -- valid text is accepted without leaving the engine in the error state
+        ttsSpeak("Mudlet self test speaking")
+        assert.is_true(ttsGetState() ~= "ttsSpeechError")
+        ttsSkip()
+        -- contract: whitespace-only text is rejected with nil + message
+        local ok, err = ttsSpeak("   ")
+        assert.is_nil(ok)
+        assert.is_string(err)
+      end)
+    end)
+  end)
diff --git a/src/mudlet-lua/tests/Miscallaneous_spec.lua b/src/mudlet-lua/tests/Miscallaneous_spec.lua
index f46d7287f..a320fe654 100644
--- a/src/mudlet-lua/tests/Miscallaneous_spec.lua
+++ b/src/mudlet-lua/tests/Miscallaneous_spec.lua
@@ -53,40 +53,6 @@ describe("Tests C++ functions in the Miscallaneous category", function()
       end)
     end)
 
-    describe("Tests the functionality of ttsGetQueue", function()
-      -- Mudlet compiled without TTS support installs dummy tts functions
-      -- which return nil, whereas the real ttsGetQueue() returns a table
-      local function ttsAvailable()
-        return type(ttsGetQueue()) == "table"
-      end
-
-      it("should return a table when called without an index", function()
-        if not ttsAvailable() then
-          pending("TTS is not available in this build")
-          return
-        end
-        assert.is_table(ttsGetQueue())
-      end)
-
-      it("should return false for an index just past the end of the queue", function()
-        if not ttsAvailable() then
-          pending("TTS is not available in this build")
-          return
-        end
-        ttsClearQueue()
-        -- on an empty queue, index 1 is exactly one past the end (index == size)
-        assert.is_false(ttsGetQueue(1))
-      end)
-
-      it("should return false for an index below the start of the queue", function()
-        if not ttsAvailable() then
-          pending("TTS is not available in this build")
-          return
-        end
-        assert.is_false(ttsGetQueue(0))
-      end)
-    end)
-
     describe("Tests the functionality of getTimestamp", function()
       it("should return a string for a valid line number", function()
         echo("getTimestamp test line\n")
@@ -128,63 +94,6 @@ describe("Tests C++ functions in the Miscallaneous category", function()
       end)
     end)
 
-    describe("Tests the text-to-speech mock engine", function()
-      -- ttsBuild() selects Qt's deterministic mock engine under MUDLET_TEST_MODE,
-      -- so these specs only run in test mode and never drive a developer's real
-      -- speech engine. Where the mock plugin is absent they skip so local runs
-      -- still pass; CI sets MUDLET_TEST_REQUIRE_TTS_MOCK to turn that skip into a
-      -- failure, so a broken mock selection cannot hide behind a green skip. Async
-      -- speech events (ttsSpeechStarted...) need the waitForEvent helper and are
-      -- left to the post-enabler TTS specs.
-      local testMode = os.getenv("MUDLET_TEST_MODE")
-      local requireMock = os.getenv("MUDLET_TEST_REQUIRE_TTS_MOCK")
-
-      local function ttsEngineAvailable()
-        return testMode and type(ttsGetVoices) == "function" and type(ttsGetVoices()) == "table" and #ttsGetVoices() > 0
-      end
-
-      -- Returns true when the caller should stop because no engine is available
-      -- and skipping is permitted; fails hard where the mock is mandatory.
-      local function ttsEngineUnavailable()
-        if ttsEngineAvailable() then
-          return false
-        end
-        if requireMock then
-          assert.is_true(false, "MUDLET_TEST_REQUIRE_TTS_MOCK is set but the mock TTS engine has no voices - it was not selected")
-        end
-        pending("mock TTS engine unavailable (run with MUDLET_TEST_MODE and Qt's mock plugin)")
-        return true
-      end
-
-      it("ttsGetVoices returns a non-empty list of voice-name strings", function()
-        if ttsEngineUnavailable() then
-          return
-        end
-        local voices = ttsGetVoices()
-        assert.is_table(voices)
-        assert.is_true(#voices > 0)
-        for _, name in ipairs(voices) do
-          assert.is_string(name)
-        end
-        -- ttsGetState maps the freshly built engine's ready state to its string
-        assert.equals("ttsSpeechReady", ttsGetState())
-      end)
-
-      it("ttsSpeak accepts valid text and rejects whitespace-only text", function()
-        if ttsEngineUnavailable() then
-          return
-        end
-        -- valid text is accepted without leaving the engine in the error state
-        ttsSpeak("Mudlet self test speaking")
-        assert.is_true(ttsGetState() ~= "ttsSpeechError")
-        ttsSkip()
-        -- contract: whitespace-only text is rejected with nil + message
-        local ok, err = ttsSpeak("   ")
-        assert.is_nil(ok)
-        assert.is_string(err)
-      end)
-    end)
-
     describe("Tests HTTP requests against the local fixture server", function()
       -- Exercises getHTTP/downloadFile against the fixture server started by the
       -- "Start fixture HTTP server" workflow step, whose port is handed over in
diff --git a/src/mudlet-lua/tests/Networking_spec.lua b/src/mudlet-lua/tests/Networking_spec.lua
index af075d0e2..5d026a1b7 100644
--- a/src/mudlet-lua/tests/Networking_spec.lua
+++ b/src/mudlet-lua/tests/Networking_spec.lua
@@ -1,19 +1,14 @@
--- Contract-only specs for the networking, MMCP, media and Discord APIs.
+-- Contract-only specs for the networking, MMCP and Discord APIs. The media
+-- contracts that used to be here now live in Media_spec.lua.
 --
 -- These functions all depend on live infrastructure for their real effect
--- (a connected game server, connected MMCP peers, an audio device, a running
--- Discord client). Those effects are covered by separate, stub-backed work.
+-- (a connected game server, connected MMCP peers, a running Discord client).
+-- Those effects are covered by separate, stub-backed work.
 -- What is verified here is the part that is fully deterministic offline:
 -- argument validation, and the nil+message / hard-error shapes each function
 -- returns when its precondition (a connection, a peer, an enabled protocol,
 -- an available API) is not met. Nothing here mocks a real API function, opens
--- a socket, issues an HTTP request or asserts playback.
---
--- This is a new per-domain spec file. The standing convention is to extend an
--- existing domain spec file, but there is no existing home for the networking,
--- MMCP, media or Discord Lua API; this file provides one for their contract
--- layer. Whether to keep it as a single combined file is a convention call for
--- review.
+-- a socket or issues an HTTP request.
 
 local function contains(haystack, needle)
   return type(haystack) == "string" and haystack:find(needle, 1, true) ~= nil
@@ -400,147 +395,6 @@ describe("MMCP chat commands report the absence of a session", function()
   end)
 end)
 
-describe("Media playback functions validate their parameters", function()
-  -- None of these reach playMedia()/stopMedia() on a real file, so no playback
-  -- is started: each returns before the media engine is touched.
-  describe("playSoundFile", function()
-    it("raises a Lua error when called with no arguments", function()
-      assertArgError(function() playSoundFile() end, "playSoundFile: need at least one argument")
-    end)
-
-    it("raises a Lua error when the table form has no name", function()
-      assert.has_error(function() playSoundFile({}) end)
-    end)
-
-    it("raises a Lua error for a negative fadein in the table form", function()
-      assert.has_error(function() playSoundFile({name = "x.wav", fadein = -1}) end)
-    end)
-
-    it("returns nil when the ordered form supplies no filename", function()
-      local ok, err = playSoundFile(nil)
-      assert.is_nil(ok)
-      assert.is_true(contains(err, "missing argument 1"))
-    end)
-  end)
-
-  describe("playMusicFile", function()
-    it("raises a Lua error when called with no arguments", function()
-      assertArgError(function() playMusicFile() end, "playMusicFile: need at least one argument")
-    end)
-
-    it("raises a Lua error when the table form has no name", function()
-      assert.has_error(function() playMusicFile({}) end)
-    end)
-
-    it("raises a Lua error for a negative fadeout in the table form", function()
-      assert.has_error(function() playMusicFile({name = "x.mp3", fadeout = -5}) end)
-    end)
-
-    it("raises a clean, non-doubled error when continue is not a boolean", function()
-      -- Regression #9547 (same defect class): the field publicName must not carry
-      -- "must be boolean", which errorArgumentType would then double.
-      local ok, err = pcall(function() playMusicFile({name = "x.mp3", continue = "yes"}) end)
-      assert.is_false(ok)
-      assert.is_true(contains(err, "value for continue as boolean expected, got string!"), tostring(err))
-      assert.is_false(contains(err, "must be boolean"), tostring(err))
-    end)
-  end)
-
-  describe("playVideoFile", function()
-    -- playVideoFileAsTableArgument shared the identical doubled-message defect on
-    -- its continue/stream/close boolean fields (#9547 defect class).
-    it("raises a clean, non-doubled error when continue is not a boolean", function()
-      local ok, err = pcall(function() playVideoFile({name = "x.mp4", continue = "yes"}) end)
-      assert.is_false(ok)
-      assert.is_true(contains(err, "value for continue as boolean expected, got string!"), tostring(err))
-      assert.is_false(contains(err, "must be boolean"), tostring(err))
-    end)
-
-    it("raises a clean, non-doubled error when stream is not a boolean", function()
-      local ok, err = pcall(function() playVideoFile({name = "x.mp4", stream = "yes"}) end)
-      assert.is_false(ok)
-      assert.is_true(contains(err, "value for stream as boolean expected, got string!"), tostring(err))
-      assert.is_false(contains(err, "must be boolean"), tostring(err))
-    end)
-
-    it("raises a clean, non-doubled error when close is not a boolean", function()
-      local ok, err = pcall(function() playVideoFile({name = "x.mp4", close = "yes"}) end)
-      assert.is_false(ok)
-      assert.is_true(contains(err, "value for close as boolean expected, got string!"), tostring(err))
-      assert.is_false(contains(err, "must be boolean"), tostring(err))
-    end)
-  end)
-
-  describe("getPlayingSounds", function()
-    it("raises a clean, non-doubled error when priority is not an integer", function()
-      -- Regression #9547 (same defect class): "value for priority must be integer"
-      -- doubled into "must be integer as number expected".
-      local ok, err = pcall(function() getPlayingSounds({priority = "high"}) end)
-      assert.is_false(ok)
-      assert.is_true(contains(err, "value for priority as number expected, got string!"), tostring(err))
-      assert.is_false(contains(err, "must be integer"), tostring(err))
-    end)
-  end)
-
-  describe("stopSounds", function()
-    it("returns true when stopping everything with no arguments", function()
-      assert.is_true(stopSounds())
-    end)
-
-    it("raises a Lua error for a negative fadeout in the table form", function()
-      assert.has_error(function() stopSounds({fadeout = -1}) end)
-    end)
-
-    it("raises a clean, non-doubled error when priority is not an integer", function()
-      -- Regression #9547 (same defect class, adjacent field in this very parser):
-      -- "value for priority must be integer" doubled the type constraint.
-      local ok, err = pcall(function() stopSounds({priority = "high"}) end)
-      assert.is_false(ok)
-      assert.is_true(contains(err, "value for priority as number expected, got string!"), tostring(err))
-      assert.is_false(contains(err, "must be integer"), tostring(err))
-    end)
-
-    it("raises a clean, non-doubled error when fadeaway is not a boolean", function()
-      -- Regression #9547: the message must not double "boolean" (the field's
-      -- publicName previously carried "must be boolean" while the type validator
-      -- also appended "as boolean expected"). It is reported like the sibling
-      -- table-field validations in this parser (fadeout, name, key).
-      local ok, err = pcall(function() stopSounds({fadeaway = "yes"}) end)
-      assert.is_false(ok)
-      assert.is_true(contains(err, "value for fadeaway as boolean expected, got string!"), tostring(err))
-      assert.is_false(contains(err, "must be boolean"), tostring(err))
-    end)
-  end)
-
-  -- stopMusic and stopVideos parse the same table shape and shared the identical
-  -- doubled-"boolean" fadeaway defect fixed for stopSounds (#9547).
-  describe("stopMusic", function()
-    it("raises a clean, non-doubled error when fadeaway is not a boolean", function()
-      local ok, err = pcall(function() stopMusic({fadeaway = "yes"}) end)
-      assert.is_false(ok)
-      assert.is_true(contains(err, "value for fadeaway as boolean expected, got string!"), tostring(err))
-      assert.is_false(contains(err, "must be boolean"), tostring(err))
-    end)
-  end)
-
-  describe("stopVideos", function()
-    it("raises a clean, non-doubled error when fadeaway is not a boolean", function()
-      local ok, err = pcall(function() stopVideos({fadeaway = "yes"}) end)
-      assert.is_false(ok)
-      assert.is_true(contains(err, "value for fadeaway as boolean expected, got string!"), tostring(err))
-      assert.is_false(contains(err, "must be boolean"), tostring(err))
-    end)
-  end)
-end)
-
-describe("receiveMSP reports MSP is not enabled while offline", function()
-  it("returns nil and a message when MSP has not been negotiated", function()
-    local ok, err = receiveMSP("!!SOUND(x.wav)")
-    assert.is_nil(ok)
-    assert.is_true(contains(err, "MSP is not currently enabled"))
-  end)
-end)
-
 describe("Discord Lua API availability contract", function()
   -- Every rich-presence function is gated on the Discord API being available
   -- (the discord-rpc library loaded and Discord enabled for this profile). In

From 77056411f958c75ea4df0d332768494e2c5bcb57 Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Sun, 2 Aug 2026 12:12:05 +0200
Subject: [PATCH 043/155] infrastructure: download, HTTP, media and TTS effect
 tests

Adds effect specs for downloadFile and the HTTP verbs against the local
fixture server, for media playback via a generated WAV, and for the TTS
family driven by Qt's mock engine. The download and HTTP smoke specs move out
of Miscallaneous_spec into Networking_spec, where they are superseded by the
effect specs.

The fixture server grows an /echo endpoint that answers any verb and reports
back the method, headers and body it received, so postHTTP, putHTTP,
deleteHTTP and customHTTP can be checked against what actually went on the
wire, and it sets a header and a cookie on every response so the response
table each event carries can be checked too.

CI gains MUDLET_TEST_REQUIRE_HTTP_FIXTURE and MUDLET_TEST_REQUIRE_MEDIA so a
fixture server or media backend that stops reaching the specs fails the run
rather than quietly skipping the coverage.

Assisted-by: Claude:claude-opus-4-8
---
 .github/workflows/build-mudlet-pr.yml       |   7 +
 .github/workflows/build-mudlet.yml          |   7 +
 .gitignore                                  |   4 +
 CI/http-fixture-server.py                   |  67 ++
 src/mudlet-lua/tests/Media_spec.lua         | 773 ++++++++++++++++++--
 src/mudlet-lua/tests/Miscallaneous_spec.lua |  40 -
 src/mudlet-lua/tests/Networking_spec.lua    | 411 ++++++++++-
 7 files changed, 1199 insertions(+), 110 deletions(-)

diff --git a/.github/workflows/build-mudlet-pr.yml b/.github/workflows/build-mudlet-pr.yml
index 482bdadb6..e56f852be 100644
--- a/.github/workflows/build-mudlet-pr.yml
+++ b/.github/workflows/build-mudlet-pr.yml
@@ -481,6 +481,12 @@ jobs:
         AUTORUN_BUSTED_TESTS: 'true'
         MUDLET_TEST_MODE: 1
         MUDLET_TEST_REQUIRE_TTS_MOCK: 1
+        MUDLET_TEST_REQUIRE_HTTP_FIXTURE: 1
+        # Qt Multimedia runs a player here even without an audio device, so a
+        # media effect spec that cannot play is a regression rather than an
+        # environment quirk. macOS is left without this until CI confirms the
+        # same holds there.
+        MUDLET_TEST_REQUIRE_MEDIA: 1
         TESTS_DIRECTORY: ${{github.workspace}}/src/mudlet-lua/tests
         QUIT_MUDLET_AFTER_TESTS: 'true'
         ASAN_OPTIONS: ${{ matrix.enable_asan == 'true' && 'detect_leaks=1' || '' }}
@@ -494,6 +500,7 @@ jobs:
         AUTORUN_BUSTED_TESTS: 'true'
         MUDLET_TEST_MODE: 1
         MUDLET_TEST_REQUIRE_TTS_MOCK: 1
+        MUDLET_TEST_REQUIRE_HTTP_FIXTURE: 1
         TESTS_DIRECTORY: ${{github.workspace}}/src/mudlet-lua/tests
         QUIT_MUDLET_AFTER_TESTS: 'true'
         ASAN_OPTIONS: detect_leaks=0
diff --git a/.github/workflows/build-mudlet.yml b/.github/workflows/build-mudlet.yml
index 2717d0c88..375f8785d 100644
--- a/.github/workflows/build-mudlet.yml
+++ b/.github/workflows/build-mudlet.yml
@@ -517,6 +517,12 @@ jobs:
         AUTORUN_BUSTED_TESTS: 'true'
         MUDLET_TEST_MODE: 1
         MUDLET_TEST_REQUIRE_TTS_MOCK: 1
+        MUDLET_TEST_REQUIRE_HTTP_FIXTURE: 1
+        # Qt Multimedia runs a player here even without an audio device, so a
+        # media effect spec that cannot play is a regression rather than an
+        # environment quirk. macOS is left without this until CI confirms the
+        # same holds there.
+        MUDLET_TEST_REQUIRE_MEDIA: 1
         TESTS_DIRECTORY: ${{github.workspace}}/src/mudlet-lua/tests
         QUIT_MUDLET_AFTER_TESTS: 'true'
         ASAN_OPTIONS: ${{ matrix.enable_asan == 'true' && 'detect_leaks=1' || '' }}
@@ -530,6 +536,7 @@ jobs:
         AUTORUN_BUSTED_TESTS: 'true'
         MUDLET_TEST_MODE: 1
         MUDLET_TEST_REQUIRE_TTS_MOCK: 1
+        MUDLET_TEST_REQUIRE_HTTP_FIXTURE: 1
         TESTS_DIRECTORY: ${{github.workspace}}/src/mudlet-lua/tests
         QUIT_MUDLET_AFTER_TESTS: 'true'
         ASAN_OPTIONS: detect_leaks=0
diff --git a/.gitignore b/.gitignore
index f86ea5a91..049ce18a0 100644
--- a/.gitignore
+++ b/.gitignore
@@ -54,3 +54,7 @@ CMakeSettings.json
 # flatpak builder
 CI/.flatpak-builder
 CI/build-dir
+
+# python bytecode (CI helper scripts)
+__pycache__/
+*.pyc
diff --git a/CI/http-fixture-server.py b/CI/http-fixture-server.py
index 1ba2a2408..148daa10e 100644
--- a/CI/http-fixture-server.py
+++ b/CI/http-fixture-server.py
@@ -5,6 +5,13 @@ Serves the sibling ``http-fixtures/`` directory over localhost so the Lua test
 suite can exercise getHTTP/downloadFile against a real, local endpoint instead
 of the public internet.
 
+Requests below ``/echo`` are answered by an echo endpoint instead of from disk:
+it accepts GET and every verb this handler has no method of its own for
+(postHTTP/putHTTP/deleteHTTP/customHTTP all need one) and reports the method,
+path, request headers and body it received back in the response body, which is
+what lets a spec prove that what Mudlet put on the wire is what the caller
+asked for. HEAD is the one exception: it keeps serving files from disk.
+
 An OS-assigned (ephemeral) port is used rather than a fixed one: Mudlet CI may
 run several jobs on the same machine, and a hard-coded port would risk
 collisions there. The chosen port is written to the file named by the
@@ -18,6 +25,8 @@ import socketserver
 
 FIXTURES_DIR = os.path.join(os.path.dirname(os.path.abspath(__file__)), "http-fixtures")
 
+ECHO_PATH = "/echo"
+
 
 class QuietHandler(http.server.SimpleHTTPRequestHandler):
     def __init__(self, *args, **kwargs):
@@ -27,8 +36,66 @@ class QuietHandler(http.server.SimpleHTTPRequestHandler):
         # Keep CI logs quiet; the tests assert on effects, not on server chatter.
         pass
 
+    def end_headers(self):
+        # Both are sent on every response, including the static file ones, so a
+        # spec can assert that the response headers and cookies tables Mudlet
+        # builds reach Lua.
+        self.send_header("X-Mudlet-Fixture", "1")
+        self.send_header("Set-Cookie", "mudlet-fixture=1; Path=/")
+        super().end_headers()
+
+    def do_GET(self):
+        if self.echo_requested():
+            self.echo()
+            return
+        super().do_GET()
+
+    def __getattr__(self, name):
+        # BaseHTTPRequestHandler dispatches "VERB /path" to a do_VERB method and
+        # answers 501 when there is none. Only GET and HEAD have one, so every
+        # other verb - POST/PUT/DELETE plus whatever customHTTP() invents - is
+        # routed here and handled by the echo endpoint. Matching against the
+        # verb being dispatched keeps a mistyped attribute elsewhere in this
+        # class an AttributeError instead of silently becoming an echo.
+        # __dict__ rather than self.command: the attribute only exists once a
+        # request line has been parsed, and reading it through the instance
+        # would come straight back here.
+        if name.startswith("do_") and name == "do_%s" % self.__dict__.get("command"):
+            return self.echo
+        raise AttributeError(name)
+
+    def echo_requested(self):
+        return self.path == ECHO_PATH or self.path.startswith(ECHO_PATH + "/") or self.path.startswith(ECHO_PATH + "?")
+
+    def echo(self):
+        if not self.echo_requested():
+            self.send_error(404, "Not Found", "only %s answers this method" % ECHO_PATH)
+            return
+
+        try:
+            length = int(self.headers.get("Content-Length") or 0)
+        except ValueError:
+            length = 0
+        body = self.rfile.read(length) if length > 0 else b""
+
+        lines = ["method=%s" % self.command, "path=%s" % self.path]
+        for name, value in self.headers.items():
+            lines.append("header:%s=%s" % (name.lower(), value))
+        # Body last: it is the only part that may itself contain newlines.
+        lines.append("body=%s" % body.decode("utf-8", "replace"))
+        payload = "\n".join(lines).encode("utf-8")
+
+        self.send_response(200)
+        self.send_header("Content-Type", "text/plain; charset=utf-8")
+        self.send_header("Content-Length", str(len(payload)))
+        self.end_headers()
+        self.wfile.write(payload)
+
 
 def main():
+    # Single-threaded on purpose: the specs issue one request at a time, and
+    # HTTP/1.0 (the default here) closes each connection, so no request can
+    # block another.
     with socketserver.TCPServer(("127.0.0.1", 0), QuietHandler) as httpd:
         port = httpd.server_address[1]
         port_file = os.environ.get("MUDLET_TEST_HTTP_PORT_FILE")
diff --git a/src/mudlet-lua/tests/Media_spec.lua b/src/mudlet-lua/tests/Media_spec.lua
index a7a4137b6..5024851d7 100644
--- a/src/mudlet-lua/tests/Media_spec.lua
+++ b/src/mudlet-lua/tests/Media_spec.lua
@@ -3,7 +3,13 @@
 -- Both families were previously homed in other domain spec files: the media
 -- contracts in Networking_spec.lua and the text-to-speech ones in
 -- Miscallaneous_spec.lua. They live here now so the audio side of the API has
--- one home. The specs themselves are unchanged by that move.
+-- one home.
+--
+-- The contract specs check what is deterministic without any backend at all:
+-- argument validation and the nil+message / hard-error shapes. The effect specs
+-- need a backend, so they play a WAV these specs generate into the profile's
+-- media directory and drive Qt's mock speech engine, and they skip cleanly
+-- where neither is available. Nothing here mocks a real API function.
 
 local function contains(haystack, needle)
   return type(haystack) == "string" and haystack:find(needle, 1, true) ~= nil
@@ -101,9 +107,22 @@ describe("Media playback functions validate their parameters", function()
     end)
   end)
 
+  describe("pauseSounds", function()
+    it("raises a Lua error when the single argument is not a table", function()
+      assertArgError(function() pauseSounds(5) end, "pauseSounds: needs to be a table")
+    end)
+  end)
+
+  describe("pauseMusic", function()
+    it("raises a Lua error when the single argument is not a table", function()
+      assertArgError(function() pauseMusic("all") end, "pauseMusic: needs to be a table")
+    end)
+  end)
+
   describe("stopSounds", function()
     it("returns true when stopping everything with no arguments", function()
       assert.is_true(stopSounds())
+      assert.equals(0, #getPlayingSounds())
     end)
 
     it("raises a Lua error for a negative fadeout in the table form", function()
@@ -152,6 +171,304 @@ describe("Media playback functions validate their parameters", function()
   end)
 end)
 
+describe("Media playback effects with a generated sound file", function()
+  -- The API media functions play files out of the profile's own media
+  -- directory, so instead of shipping a binary fixture these specs write a
+  -- short WAV there: 150ms of 8 bit, 8kHz mono silence, which every decoder
+  -- accepts and which keeps a play-to-finish round trip under a fifth of a
+  -- second.
+  --
+  -- Playback needs Qt Multimedia to actually run a player. It does so without
+  -- any audio device - verified locally with PulseAudio and ALSA made
+  -- unreachable, where the ffmpeg backend still drives the player from start
+  -- to finish - which is the situation on CI. Should an environment turn up
+  -- where it cannot, the canary in mediaPlaybackUnavailable() pends these
+  -- specs instead of failing them.
+  -- Two files: a short one for the spec that waits for playback to end on its
+  -- own, and a long one for the specs that have to still be playing when they
+  -- stop or pause it, so a slow runner cannot turn a natural finish into a
+  -- spurious failure.
+  local soundFile = "busted-media-tone.wav"
+  local longSoundFile = "busted-media-hold.wav"
+  local mediaDirectory = getMudletHomeDir() .. "/media"
+  local playbackObserved
+
+  local function littleEndian(value, byteCount)
+    local bytes = {}
+    for _ = 1, byteCount do
+      bytes[#bytes + 1] = string.char(value % 256)
+      value = math.floor(value / 256)
+    end
+    return table.concat(bytes)
+  end
+
+  local function silentWav(milliseconds)
+    local sampleRate = 8000
+    -- 128 is silence for unsigned 8 bit samples
+    local samples = string.rep(string.char(128), math.floor(sampleRate * milliseconds / 1000))
+    local format = "fmt " .. littleEndian(16, 4) .. littleEndian(1, 2) .. littleEndian(1, 2)
+      .. littleEndian(sampleRate, 4) .. littleEndian(sampleRate, 4) .. littleEndian(1, 2) .. littleEndian(8, 2)
+    local data = "data" .. littleEndian(#samples, 4) .. samples
+    local body = "WAVE" .. format .. data
+    return "RIFF" .. littleEndian(#body, 4) .. body
+  end
+
+  local function writeMediaFile(name, milliseconds)
+    lfs.mkdir(mediaDirectory)
+    local handle = io.open(mediaDirectory .. "/" .. name, "wb")
+    assert.is_not_nil(handle, "could not write the media fixture " .. name)
+    handle:write(silentWav(milliseconds))
+    handle:close()
+  end
+
+  local function writeSoundFiles()
+    writeMediaFile(soundFile, 150)
+    writeMediaFile(longSoundFile, 10000)
+  end
+
+  -- Collects every occurrence of a media event for the duration of one spec.
+  -- stopSounds() and pauseSounds() change the player's state inside the call
+  -- itself, so the matching event is raised before a waitForEvent() could be
+  -- armed; a handler sees those as well as the asynchronous ones.
+  local function collect(eventName, into)
+    local handler = registerAnonymousEventHandler(eventName, function(_, file, path, mediaType, key, tag)
+      into[#into + 1] = {file = file, path = path, mediaType = mediaType, key = key, tag = tag}
+    end)
+    finally(function() killAnonymousEventHandler(handler) end)
+  end
+
+  -- CI sets this so a missing playback turns into a failure there rather than
+  -- into a green skip; a developer's machine without a media backend still
+  -- passes.
+  local requireMedia = os.getenv("MUDLET_TEST_REQUIRE_MEDIA")
+
+  -- Returns true when the caller must stop because this environment has no
+  -- working media backend at all. Runs one throwaway playback to find out, and
+  -- takes its fixtures back out of the profile when there is no point keeping
+  -- them.
+  local function mediaPlaybackUnavailable()
+    if playbackObserved == nil then
+      writeSoundFiles()
+      playSoundFile({name = soundFile, key = "busted-media-canary"})
+      playbackObserved = waitForEvent("sysMediaStarted", 5000) ~= nil
+      stopSounds()
+      if not playbackObserved then
+        os.remove(mediaDirectory .. "/" .. soundFile)
+        os.remove(mediaDirectory .. "/" .. longSoundFile)
+      end
+    end
+    if playbackObserved then
+      return false
+    end
+    if requireMedia then
+      assert.is_true(false, "MUDLET_TEST_REQUIRE_MEDIA is set but playing a sound raised no sysMediaStarted event")
+    end
+    pending("Qt Multimedia did not start playback in this environment")
+    return true
+  end
+
+  after_each(function()
+    stopSounds()
+    stopMusic()
+  end)
+
+  it("playSoundFile plays the file and reports it from start to finish", function()
+    if mediaPlaybackUnavailable() then
+      return
+    end
+    writeSoundFiles()
+    assert.is_true(playSoundFile({name = soundFile, key = "busted-key", tag = "busted-tag"}))
+
+    local event, file, path, mediaType, key, tag = waitForEvent("sysMediaStarted", 5000)
+    assert.equals("sysMediaStarted", event)
+    assert.equals(soundFile, file)
+    assert.equals(mediaDirectory .. "/" .. soundFile, path)
+    assert.equals("sound", mediaType)
+    assert.equals("busted-key", key)
+    assert.equals("busted-tag", tag)
+
+    local finishedEvent, finishedFile, _, finishedType, finishedKey = waitForEvent("sysMediaFinished", 5000)
+    assert.equals("sysMediaFinished", finishedEvent)
+    assert.equals(soundFile, finishedFile)
+    assert.equals("sound", finishedType)
+    assert.equals("busted-key", finishedKey)
+    assert.equals(0, #getPlayingSounds())
+  end)
+
+  it("playSoundFile plays a file given in the ordered argument form", function()
+    if mediaPlaybackUnavailable() then
+      return
+    end
+    writeSoundFiles()
+    -- name[,volume]: the ordered form has its own parser, and it is the form
+    -- most scripts use
+    assert.is_true(playSoundFile(longSoundFile, 80))
+    assert.equals("sysMediaStarted", (waitForEvent("sysMediaStarted", 5000)))
+
+    local playing = getPlayingSounds()
+    assert.equals(1, #playing)
+    assert.equals(longSoundFile, playing[1].name)
+    assert.equals(80, playing[1].volume)
+  end)
+
+  it("getPlayingSounds lists the sound that is playing", function()
+    if mediaPlaybackUnavailable() then
+      return
+    end
+    writeSoundFiles()
+    assert.is_true(playSoundFile({name = longSoundFile, key = "busted-listed", tag = "busted-listed-tag"}))
+    assert.equals("sysMediaStarted", (waitForEvent("sysMediaStarted", 5000)))
+
+    local playing = getPlayingSounds()
+    assert.equals(1, #playing)
+    assert.equals(longSoundFile, playing[1].name)
+    assert.equals("busted-listed", playing[1].key)
+    assert.equals("busted-listed-tag", playing[1].tag)
+    assert.is_number(playing[1].volume)
+  end)
+
+  it("stopSounds stops the sound and reports it as finished", function()
+    if mediaPlaybackUnavailable() then
+      return
+    end
+    local finished = {}
+    collect("sysMediaFinished", finished)
+
+    writeSoundFiles()
+    assert.is_true(playSoundFile({name = longSoundFile, key = "busted-stopped"}))
+    assert.equals("sysMediaStarted", (waitForEvent("sysMediaStarted", 5000)))
+    assert.equals(1, #getPlayingSounds())
+
+    assert.is_true(stopSounds())
+    if #finished == 0 then
+      waitForEvent("sysMediaFinished", 5000)
+    end
+    -- the file runs for ten seconds, so a finish reported this soon after the
+    -- start is the stop taking effect rather than the file running out
+    assert.equals(1, #finished)
+    assert.equals("busted-stopped", finished[1].key)
+    assert.equals(0, #getPlayingSounds())
+  end)
+
+  it("pauseSounds parks the sound and playing it again resumes it", function()
+    if mediaPlaybackUnavailable() then
+      return
+    end
+    local paused = {}
+    collect("sysMediaPaused", paused)
+
+    writeSoundFiles()
+    assert.is_true(playSoundFile({name = longSoundFile, key = "busted-paused"}))
+    assert.equals("sysMediaStarted", (waitForEvent("sysMediaStarted", 5000)))
+
+    assert.is_true(pauseSounds())
+    if #paused == 0 then
+      -- the backend here reports the pause inside the call; wait in case
+      -- another one reports it a turn later
+      waitForEvent("sysMediaPaused", 5000)
+    end
+    assert.equals(1, #paused)
+    assert.equals("busted-paused", paused[1].key)
+    assert.equals(0, #getPlayingSounds())
+    local pausedSounds = getPausedSounds()
+    assert.equals(1, #pausedSounds)
+    assert.equals(longSoundFile, pausedSounds[1].name)
+
+    -- playing the same file again resumes the paused player rather than
+    -- starting a second one
+    playSoundFile({name = longSoundFile, key = "busted-paused"})
+    assert.equals(1, #getPlayingSounds())
+    assert.equals(0, #getPausedSounds())
+  end)
+
+  it("the key filter picks out which sound is listed and stopped", function()
+    if mediaPlaybackUnavailable() then
+      return
+    end
+    writeSoundFiles()
+    assert.is_true(playSoundFile({name = longSoundFile, key = "busted-filter"}))
+    assert.equals("sysMediaStarted", (waitForEvent("sysMediaStarted", 5000)))
+
+    assert.equals(1, #getPlayingSounds({key = "busted-filter"}))
+    assert.equals(0, #getPlayingSounds({key = "busted-other-key"}))
+
+    -- a stop aimed at another key leaves this sound alone
+    assert.is_true(stopSounds({key = "busted-other-key"}))
+    assert.equals(1, #getPlayingSounds())
+
+    assert.is_true(stopSounds({key = "busted-filter"}))
+    assert.equals(0, #getPlayingSounds())
+  end)
+
+  it("playMusicFile reports the music type and stopMusic ends it", function()
+    if mediaPlaybackUnavailable() then
+      return
+    end
+    writeSoundFiles()
+    assert.is_true(playMusicFile({name = longSoundFile, key = "busted-music"}))
+
+    local event, file, _, mediaType, key = waitForEvent("sysMediaStarted", 5000)
+    assert.equals("sysMediaStarted", event)
+    assert.equals(longSoundFile, file)
+    assert.equals("music", mediaType)
+    assert.equals("busted-music", key)
+
+    local music = getPlayingMusic()
+    assert.equals(1, #music)
+    assert.equals(longSoundFile, music[1].name)
+    assert.equals("busted-music", music[1].key)
+    -- sounds and music are tracked separately
+    assert.equals(0, #getPlayingSounds())
+
+    assert.is_true(stopMusic())
+    assert.equals(0, #getPlayingMusic())
+  end)
+
+  it("pauseMusic parks the music and playing it again resumes it", function()
+    if mediaPlaybackUnavailable() then
+      return
+    end
+    writeSoundFiles()
+    assert.is_true(playMusicFile({name = longSoundFile, key = "busted-music-paused"}))
+    assert.equals("sysMediaStarted", (waitForEvent("sysMediaStarted", 5000)))
+
+    assert.is_true(pauseMusic())
+    assert.equals(0, #getPlayingMusic())
+    assert.equals(1, #getPausedMusic())
+    assert.equals(longSoundFile, getPausedMusic()[1].name)
+
+    playMusicFile({name = longSoundFile, key = "busted-music-paused"})
+    assert.equals(1, #getPlayingMusic())
+    assert.equals(0, #getPausedMusic())
+  end)
+
+  it("playSoundFile starts nothing for a file the media directory does not have", function()
+    if mediaPlaybackUnavailable() then
+      return
+    end
+    -- the return value only says the request was understood; with no file and
+    -- no download url configured there is nothing to play
+    assert.is_true(playSoundFile("busted-media-absent.wav"))
+    assert.equals(0, #getPlayingSounds())
+  end)
+
+  it("purgeMediaCache empties the profile's media directory", function()
+    if mediaPlaybackUnavailable() then
+      return
+    end
+    writeSoundFiles()
+    local soundPath = mediaDirectory .. "/" .. soundFile
+    assert.is_not_nil(lfs.attributes(soundPath, "mode"))
+    assert.is_true(playSoundFile({name = longSoundFile, key = "busted-purged"}))
+    assert.equals("sysMediaStarted", (waitForEvent("sysMediaStarted", 5000)))
+
+    assert.is_true(purgeMediaCache())
+    -- it stops every player before removing the directory
+    assert.equals(0, #getPlayingSounds())
+    assert.is_nil(lfs.attributes(soundPath, "mode"))
+  end)
+end)
+
 describe("receiveMSP reports MSP is not enabled while offline", function()
   it("returns nil and a message when MSP has not been negotiated", function()
     local ok, err = receiveMSP("!!SOUND(x.wav)")
@@ -161,59 +478,41 @@ describe("receiveMSP reports MSP is not enabled while offline", function()
 end)
 
 describe("Tests the text-to-speech Lua API", function()
-    describe("Tests the functionality of ttsGetQueue", function()
-      -- Mudlet compiled without TTS support installs dummy tts functions
-      -- which return nil, whereas the real ttsGetQueue() returns a table
-      local function ttsAvailable()
+    describe("Tests the text-to-speech family", function()
+      -- Mudlet can be compiled without TTS at all, in which case Other.lua
+      -- installs no-op shims that return nil instead of the real functions.
+      -- ttsGetQueue() returning a table is the cheapest proof that the real
+      -- ones are in place.
+      local function ttsSupported()
         return type(ttsGetQueue()) == "table"
       end
 
-      it("should return a table when called without an index", function()
-        if not ttsAvailable() then
-          pending("TTS is not available in this build")
-          return
+      -- Returns true when the caller should stop because this build has no TTS
+      -- functions to test.
+      local function ttsUnsupported()
+        if ttsSupported() then
+          return false
         end
-        assert.is_table(ttsGetQueue())
-      end)
+        pending("Mudlet was compiled without TTS support")
+        return true
+      end
 
-      it("should return false for an index just past the end of the queue", function()
-        if not ttsAvailable() then
-          pending("TTS is not available in this build")
-          return
-        end
-        ttsClearQueue()
-        -- on an empty queue, index 1 is exactly one past the end (index == size)
-        assert.is_false(ttsGetQueue(1))
-      end)
-
-      it("should return false for an index below the start of the queue", function()
-        if not ttsAvailable() then
-          pending("TTS is not available in this build")
-          return
-        end
-        assert.is_false(ttsGetQueue(0))
-      end)
-    end)
-
-    describe("Tests the text-to-speech mock engine", function()
-      -- ttsBuild() selects Qt's deterministic mock engine under MUDLET_TEST_MODE,
-      -- so these specs only run in test mode and never drive a developer's real
-      -- speech engine. Where the mock plugin is absent they skip so local runs
-      -- still pass; CI sets MUDLET_TEST_REQUIRE_TTS_MOCK to turn that skip into a
-      -- failure, so a broken mock selection cannot hide behind a green skip. Async
-      -- speech events (ttsSpeechStarted...) need the waitForEvent helper and are
-      -- left to the post-enabler TTS specs.
+      -- ttsBuild() selects Qt's deterministic mock engine under
+      -- MUDLET_TEST_MODE, so the effect specs below never drive a developer's
+      -- real speech engine and nothing is ever spoken out loud. Where the mock
+      -- plugin is absent Qt leaves the engine with no voices, and those specs
+      -- skip so a local run still passes; CI sets MUDLET_TEST_REQUIRE_TTS_MOCK
+      -- to turn that skip into a failure, so a broken mock selection cannot
+      -- hide behind a green skip.
       local testMode = os.getenv("MUDLET_TEST_MODE")
       local requireMock = os.getenv("MUDLET_TEST_REQUIRE_TTS_MOCK")
 
-      local function ttsEngineAvailable()
-        return testMode and type(ttsGetVoices) == "function" and type(ttsGetVoices()) == "table" and #ttsGetVoices() > 0
+      local function mockEngineReady()
+        return testMode and ttsSupported() and #ttsGetVoices() > 0
       end
 
-      -- Returns true when the caller should stop because no engine is available
-      -- and skipping is permitted; fails hard where the mock is mandatory.
-      local function ttsEngineUnavailable()
-        if ttsEngineAvailable() then
+      local function noMockEngine()
+        if mockEngineReady() then
           return false
         end
         if requireMock then
@@ -223,32 +522,392 @@ describe("Tests the text-to-speech Lua API", function()
         return true
       end
 
-      it("ttsGetVoices returns a non-empty list of voice-name strings", function()
-        if ttsEngineUnavailable() then
+      -- Collects every occurrence of an event for the duration of one spec.
+      -- The mock engine changes state inside the ttsSpeak()/ttsSkip() call
+      -- itself, so the matching event is raised before a waitForEvent() could
+      -- be armed; a handler sees those as well as the asynchronous ones.
+      local function collect(eventName, into)
+        local handler = registerAnonymousEventHandler(eventName, function(_, first)
+          into[#into + 1] = first == nil and true or first
+        end)
+        finally(function() killAnonymousEventHandler(handler) end)
+      end
+
+      -- The mock engine speaks in real time at roughly a tenth of a second per
+      -- word, so every utterance in these specs is deliberately short.
+      after_each(function()
+        if ttsSupported() then
+          -- clear first: skipping while the queue still holds a line starts
+          -- speaking that line, which would run on into the next spec
+          ttsClearQueue()
+          ttsSkip()
+        end
+      end)
+
+      it("ttsSpeak rejects whitespace-only text", function()
+        if ttsUnsupported() then
+          return
+        end
+        local ok, err = ttsSpeak("   ")
+        assert.is_nil(ok)
+        assert.is_true(err:find("skipped empty text to speak (TTS)", 1, true) ~= nil)
+      end)
+
+      it("ttsQueue rejects whitespace-only text", function()
+        if ttsUnsupported() then
+          return
+        end
+        local ok, err = ttsQueue("\t \n")
+        assert.is_nil(ok)
+        assert.is_true(err:find("skipped empty text to speak (TTS)", 1, true) ~= nil)
+      end)
+
+      it("ttsSpeak and ttsQueue raise a Lua error for a non-string argument", function()
+        if ttsUnsupported() then
+          return
+        end
+        assert.has_error(function() ttsSpeak({}) end)
+        assert.has_error(function() ttsQueue({}) end)
+      end)
+
+      it("the rate, pitch and volume setters raise a Lua error for a non-number", function()
+        if ttsUnsupported() then
+          return
+        end
+        assert.has_error(function() ttsSetRate("fast") end)
+        assert.has_error(function() ttsSetPitch({}) end)
+        assert.has_error(function() ttsSetVolume(false) end)
+      end)
+
+      it("ttsGetQueue returns a table and false for out-of-range indexes", function()
+        if ttsUnsupported() then
+          return
+        end
+        ttsClearQueue()
+        assert.is_table(ttsGetQueue())
+        -- Regression #9471: on an empty queue index 1 is exactly one past the
+        -- end (index == size), which used to pass the bounds check and read
+        -- out of range.
+        assert.is_false(ttsGetQueue(1))
+        assert.is_false(ttsGetQueue(0))
+      end)
+
+      it("ttsClearQueue reports an out-of-range index instead of removing anything", function()
+        if ttsUnsupported() then
+          return
+        end
+        ttsClearQueue()
+        local ok, err = ttsClearQueue(3)
+        assert.is_nil(ok)
+        assert.equals("index 3 out of bounds for queue size 0", err)
+      end)
+
+      it("ttsGetState reports one of the documented states", function()
+        if ttsUnsupported() then
+          return
+        end
+        -- ttsUnknownState is deliberately not accepted: it is the fallback the
+        -- state switch prints for a state it does not know about, so allowing
+        -- it here would make this assertion impossible to fail.
+        local states = {
+          ttsSpeechReady = true, ttsSpeechPaused = true,
+          ttsSpeechStarted = true, ttsSpeechError = true,
+        }
+        assert.is_true(states[ttsGetState()] == true, ttsGetState())
+      end)
+
+      it("ttsGetRate, ttsGetPitch and ttsGetVolume return numbers", function()
+        if ttsUnsupported() then
+          return
+        end
+        assert.is_number(ttsGetRate())
+        assert.is_number(ttsGetPitch())
+        assert.is_number(ttsGetVolume())
+      end)
+
+      it("the voice setters return false for a voice that does not exist", function()
+        if ttsUnsupported() then
+          return
+        end
+        assert.is_false(ttsSetVoiceByIndex(0))
+        assert.is_false(ttsSetVoiceByIndex(9999))
+        assert.is_false(ttsSetVoiceByName("no such voice is installed"))
+      end)
+
+      it("the voice setters raise a Lua error for a wrongly typed argument", function()
+        if ttsUnsupported() then
+          return
+        end
+        assert.has_error(function() ttsSetVoiceByIndex("first") end)
+        assert.has_error(function() ttsSetVoiceByName({}) end)
+      end)
+
+      it("ttsGetVoices lists the mock engine's voices and ttsGetCurrentVoice names one of them", function()
+        if noMockEngine() then
           return
         end
         local voices = ttsGetVoices()
-        assert.is_table(voices)
         assert.is_true(#voices > 0)
+        local current = ttsGetCurrentVoice()
+        assert.is_string(current)
+        assert.is_true(table.contains(voices, current), current)
         for _, name in ipairs(voices) do
           assert.is_string(name)
         end
-        -- ttsGetState maps the freshly built engine's ready state to its string
+      end)
+
+      it("ttsSpeak speaks the text and reports it until the engine goes ready again", function()
+        if noMockEngine() then
+          return
+        end
+        local started, ready = {}, {}
+        collect("ttsSpeechStarted", started)
+        collect("ttsSpeechReady", ready)
+
+        ttsSpeak("Mudlet spec one")
+        assert.equals("ttsSpeechStarted", ttsGetState())
+        assert.equals("Mudlet spec one", ttsGetCurrentLine())
+        assert.equals(1, #started)
+
+        assert.equals("ttsSpeechReady", (waitForEvent("ttsSpeechReady", 5000)))
+        assert.equals("ttsSpeechReady", ttsGetState())
+        assert.equals(1, #ready)
+        -- with nothing being spoken the line is no longer reported
+        local line, err = ttsGetCurrentLine()
+        assert.is_nil(line)
+        assert.is_true(err:find("not speaking any text", 1, true) ~= nil)
+      end)
+
+      it("ttsSpeak drops angle brackets from the text it speaks", function()
+        if noMockEngine() then
+          return
+        end
+        -- discussion: https://github.com/Mudlet/Mudlet/issues/4689
+        ttsSpeak("bold")
+        assert.equals("bbold/b", ttsGetCurrentLine())
+      end)
+
+      it("ttsPause holds the utterance and ttsResume runs it to the end", function()
+        if noMockEngine() then
+          return
+        end
+        local paused = {}
+        collect("ttsSpeechPaused", paused)
+
+        ttsSpeak("pause this line")
+        assert.equals("ttsSpeechStarted", ttsGetState())
+        ttsPause()
+        -- the engine reports the pause asynchronously
+        assert.equals("ttsSpeechPaused", (waitForEvent("ttsSpeechPaused", 5000)))
+        assert.equals("ttsSpeechPaused", ttsGetState())
+        assert.equals(1, #paused)
+        -- the paused utterance is still the current one
+        assert.equals("pause this line", ttsGetCurrentLine())
+
+        ttsResume()
+        assert.equals("ttsSpeechStarted", ttsGetState())
+        assert.equals("ttsSpeechReady", (waitForEvent("ttsSpeechReady", 5000)))
         assert.equals("ttsSpeechReady", ttsGetState())
       end)
 
-      it("ttsSpeak accepts valid text and rejects whitespace-only text", function()
-        if ttsEngineUnavailable() then
+      it("ttsSkip ends the current utterance immediately", function()
+        if noMockEngine() then
           return
         end
-        -- valid text is accepted without leaving the engine in the error state
-        ttsSpeak("Mudlet self test speaking")
-        assert.is_true(ttsGetState() ~= "ttsSpeechError")
+        local ready = {}
+        collect("ttsSpeechReady", ready)
+
+        ttsSpeak("a long enough sentence that it cannot possibly finish on its own by now")
+        assert.equals("ttsSpeechStarted", ttsGetState())
         ttsSkip()
-        -- contract: whitespace-only text is rejected with nil + message
-        local ok, err = ttsSpeak("   ")
-        assert.is_nil(ok)
-        assert.is_string(err)
+        -- the utterance would take over a second to speak, so a ready state
+        -- straight after the call can only be the skip taking effect
+        assert.equals("ttsSpeechReady", ttsGetState())
+        assert.equals(1, #ready)
+      end)
+
+      it("ttsQueue holds lines while the engine is busy and ttsGetQueue reads them back", function()
+        if noMockEngine() then
+          return
+        end
+        local queued = {}
+        collect("ttsSpeechQueued", queued)
+
+        ttsClearQueue()
+        ttsSpeak("occupying the engine with a line that takes a while to speak")
+        ttsQueue("queued one")
+        ttsQueue("queued two")
+        assert.equals(2, #ttsGetQueue())
+        assert.equals("queued one", ttsGetQueue(1))
+        assert.equals("queued two", ttsGetQueue(2))
+        assert.equals(2, #queued)
+        assert.equals("queued one", queued[1])
+        assert.equals("queued two", queued[2])
+
+        -- an explicit index inserts rather than appends
+        ttsQueue("queued zero", 1)
+        assert.same({"queued zero", "queued one", "queued two"}, ttsGetQueue())
+
+        ttsClearQueue(1)
+        assert.same({"queued one", "queued two"}, ttsGetQueue())
+        ttsClearQueue()
+        assert.equals(0, #ttsGetQueue())
+      end)
+
+      it("ttsQueue speaks straight away when the engine is idle", function()
+        if noMockEngine() then
+          return
+        end
+        ttsClearQueue()
+        assert.equals("ttsSpeechReady", ttsGetState())
+
+        ttsQueue("queued while idle")
+        -- nothing is waiting, so the line is taken back off the queue and
+        -- spoken instead of being held
+        assert.equals(0, #ttsGetQueue())
+        assert.equals("ttsSpeechStarted", ttsGetState())
+        assert.equals("queued while idle", ttsGetCurrentLine())
+      end)
+
+      it("ttsQueue drops angle brackets like ttsSpeak does", function()
+        if noMockEngine() then
+          return
+        end
+        ttsClearQueue()
+        ttsSpeak("occupying the engine with a line that takes a while to speak")
+        ttsQueue("queued")
+        assert.same({"iqueued/i"}, ttsGetQueue())
+      end)
+
+      it("ttsQueue clamps an index outside the queue instead of failing", function()
+        if noMockEngine() then
+          return
+        end
+        ttsClearQueue()
+        ttsSpeak("occupying the engine with a line that takes a while to speak")
+        ttsQueue("middle")
+        ttsQueue("beyond the end", 99)
+        ttsQueue("before the start", -5)
+        assert.same({"before the start", "middle", "beyond the end"}, ttsGetQueue())
+      end)
+
+      it("ttsSkip moves on to the next queued line", function()
+        if noMockEngine() then
+          return
+        end
+        ttsClearQueue()
+        ttsSpeak("occupying the engine with a line that takes a while to speak")
+        ttsQueue("the line after the skip")
+        assert.equals(1, #ttsGetQueue())
+
+        ttsSkip()
+        assert.equals(0, #ttsGetQueue())
+        assert.equals("the line after the skip", ttsGetCurrentLine())
+      end)
+
+      it("a queued line starts speaking when the current one ends", function()
+        if noMockEngine() then
+          return
+        end
+        ttsClearQueue()
+        ttsSpeak("first line")
+        ttsQueue("second line")
+        assert.equals(1, #ttsGetQueue())
+
+        assert.equals("ttsSpeechReady", (waitForEvent("ttsSpeechReady", 5000)))
+        -- the queue is drained by the state change that ended the first line
+        assert.equals(0, #ttsGetQueue())
+        assert.equals("second line", ttsGetCurrentLine())
+      end)
+
+      it("ttsSetRate, ttsSetPitch and ttsSetVolume are read back and clamped", function()
+        if noMockEngine() then
+          return
+        end
+        local rates, pitches, volumes = {}, {}, {}
+        collect("ttsRateChanged", rates)
+        collect("ttsPitchChanged", pitches)
+        collect("ttsVolumeChanged", volumes)
+        local rate, pitch, volume = ttsGetRate(), ttsGetPitch(), ttsGetVolume()
+        finally(function()
+          ttsSetRate(rate)
+          ttsSetPitch(pitch)
+          ttsSetVolume(volume)
+        end)
+
+        ttsSetRate(0.5)
+        assert.equals(0.5, ttsGetRate())
+        ttsSetRate(5)
+        assert.equals(1, ttsGetRate())
+        ttsSetRate(-5)
+        assert.equals(-1, ttsGetRate())
+        assert.same({0.5, 1, -1}, rates)
+
+        ttsSetPitch(0.25)
+        assert.equals(0.25, ttsGetPitch())
+        ttsSetPitch(9)
+        assert.equals(1, ttsGetPitch())
+        ttsSetPitch(-9)
+        assert.equals(-1, ttsGetPitch())
+        assert.same({0.25, 1, -1}, pitches)
+
+        ttsSetVolume(0.3)
+        assert.equals(0.3, ttsGetVolume())
+        ttsSetVolume(9)
+        assert.equals(1, ttsGetVolume())
+        -- volume clamps to zero rather than to -1
+        ttsSetVolume(-9)
+        assert.equals(0, ttsGetVolume())
+        assert.same({0.3, 1, 0}, volumes)
+      end)
+
+      it("the voice setters switch voice and report it back", function()
+        if noMockEngine() then
+          return
+        end
+        local voices = ttsGetVoices()
+        if #voices < 2 then
+          pending("the mock engine offers only one voice in this environment")
+          return
+        end
+        local changes = {}
+        local originalVoice = ttsGetCurrentVoice()
+        collect("ttsVoiceChanged", changes)
+        finally(function() ttsSetVoiceByName(originalVoice) end)
+
+        -- ttsSetVoiceByName's return value is deliberately not asserted here;
+        -- see the pending spec below for why.
+        ttsSetVoiceByName(voices[2])
+        assert.equals(voices[2], ttsGetCurrentVoice())
+        assert.is_true(ttsSetVoiceByIndex(1))
+        assert.equals(voices[1], ttsGetCurrentVoice())
+        assert.same({voices[2], voices[1]}, changes)
+      end)
+
+      it("ttsSpeechStarted carries the text that just started being spoken", function()
+        if noMockEngine() then
+          return
+        end
+        -- Not asserted, because it does not hold: ttsSpeak() calls say() before
+        -- it stores the text, and the engine changes state inside say(), so the
+        -- event is raised while the previous utterance is still recorded as the
+        -- current one. ttsGetCurrentLine() is correct, and the spec above uses
+        -- it; the event's own argument lags one utterance behind. The queue
+        -- drain path in ttsStateChanged() has the same ordering.
+        pending("ttsSpeechStarted reports the previously spoken text, not the one that just started")
+      end)
+
+      it("ttsSetVoiceByName reports success for a voice it switched to", function()
+        if noMockEngine() then
+          return
+        end
+        -- Not asserted, because it does not hold: ttsSetVoiceByName pushes its
+        -- boolean result onto the Lua stack before raising ttsVoiceChanged, and
+        -- dispatching that event clears the stack underneath it, so the caller
+        -- is handed whatever is left there (a C function, in practice) instead
+        -- of true. Its sibling ttsSetVoiceByIndex pushes after raising the
+        -- event and does return true, which is what the spec above checks.
+        pending("ttsSetVoiceByName's return value is destroyed by the ttsVoiceChanged event it raises")
       end)
     end)
   end)
diff --git a/src/mudlet-lua/tests/Miscallaneous_spec.lua b/src/mudlet-lua/tests/Miscallaneous_spec.lua
index a320fe654..6278bc677 100644
--- a/src/mudlet-lua/tests/Miscallaneous_spec.lua
+++ b/src/mudlet-lua/tests/Miscallaneous_spec.lua
@@ -94,44 +94,4 @@ describe("Tests C++ functions in the Miscallaneous category", function()
       end)
     end)
 
-    describe("Tests HTTP requests against the local fixture server", function()
-      -- Exercises getHTTP/downloadFile against the fixture server started by the
-      -- "Start fixture HTTP server" workflow step, whose port is handed over in
-      -- MUDLET_TEST_HTTP_PORT. Skips cleanly when that is unset (a local run with
-      -- no fixture server) so the suite still passes. The wire response is
-      -- asynchronous (sysDownloadDone); asserting on it needs the waitForEvent
-      -- helper and is left to the post-enabler HTTP specs.
-      local port = os.getenv("MUDLET_TEST_HTTP_PORT")
-
-      -- Runs everywhere (no server needed): an invalid url is rejected up front.
-      it("getHTTP rejects an invalid url with nil and a message", function()
-        local ok, err = getHTTP("")
-        assert.is_nil(ok)
-        assert.is_string(err)
-      end)
-
-      it("getHTTP accepts a request to the local fixture server", function()
-        if not port then
-          pending("MUDLET_TEST_HTTP_PORT not set (fixture HTTP server not running)")
-          return
-        end
-        local ok, actualUrl = getHTTP("http://127.0.0.1:" .. port .. "/fixture.txt")
-        assert.is_true(ok)
-        assert.is_string(actualUrl)
-        assert.is_true(actualUrl:find("127.0.0.1:" .. port, 1, true) ~= nil)
-      end)
-
-      it("downloadFile accepts a request to the local fixture server", function()
-        if not port then
-          pending("MUDLET_TEST_HTTP_PORT not set (fixture HTTP server not running)")
-          return
-        end
-        local target = getMudletHomeDir() .. "/busted-http-fixture.txt"
-        os.remove(target)
-        local ok, actualUrl = downloadFile(target, "http://127.0.0.1:" .. port .. "/fixture.txt")
-        assert.is_true(ok)
-        assert.is_string(actualUrl)
-        assert.is_true(actualUrl:find("127.0.0.1:" .. port, 1, true) ~= nil)
-      end)
-    end)
   end)
diff --git a/src/mudlet-lua/tests/Networking_spec.lua b/src/mudlet-lua/tests/Networking_spec.lua
index 5d026a1b7..43d4deb7b 100644
--- a/src/mudlet-lua/tests/Networking_spec.lua
+++ b/src/mudlet-lua/tests/Networking_spec.lua
@@ -1,14 +1,18 @@
--- Contract-only specs for the networking, MMCP and Discord APIs. The media
--- contracts that used to be here now live in Media_spec.lua.
+-- Specs for the networking, MMCP and Discord APIs. The media contracts that
+-- used to be here now live in Media_spec.lua.
 --
--- These functions all depend on live infrastructure for their real effect
--- (a connected game server, connected MMCP peers, a running Discord client).
--- Those effects are covered by separate, stub-backed work.
--- What is verified here is the part that is fully deterministic offline:
--- argument validation, and the nil+message / hard-error shapes each function
--- returns when its precondition (a connection, a peer, an enabled protocol,
--- an available API) is not met. Nothing here mocks a real API function, opens
--- a socket or issues an HTTP request.
+-- Most of these functions depend on live infrastructure for their real effect
+-- (a connected game server, connected MMCP peers, a running Discord client),
+-- and for those what is verified here is the part that is fully deterministic
+-- offline: argument validation, and the nil+message / hard-error shapes each
+-- function returns when its precondition (a connection, a peer, an enabled
+-- protocol, an available API) is not met.
+--
+-- The download and HTTP families are the exception: their infrastructure can be
+-- stood up locally, so their real effects are checked against the fixture
+-- server in CI/http-fixture-server.py, whose ephemeral port arrives in
+-- MUDLET_TEST_HTTP_PORT. They skip cleanly when it is absent so the suite still
+-- passes without a server. Nothing here mocks a real API function.
 
 local function contains(haystack, needle)
   return type(haystack) == "string" and haystack:find(needle, 1, true) ~= nil
@@ -163,7 +167,8 @@ describe("HTTP and download functions validate arguments before issuing a reques
     end)
 
     it("raises a Lua error when headers is not a table", function()
-      assertArgError(function() getHTTP("http://localhost/", 5) end, "getHTTP: bad argument")
+      assertArgError(function() getHTTP("http://localhost/", 5) end,
+        "getHTTP: bad argument #2 type (headers as a table expected, got number!)")
     end)
 
     it("raises a Lua error when a header value is not a string", function()
@@ -183,7 +188,8 @@ describe("HTTP and download functions validate arguments before issuing a reques
     end)
 
     it("raises a Lua error when headers is not a table", function()
-      assertArgError(function() deleteHTTP("http://localhost/", 5) end, "deleteHTTP: bad argument")
+      assertArgError(function() deleteHTTP("http://localhost/", 5) end,
+        "deleteHTTP: bad argument #2 type (headers as a table expected, got number!)")
     end)
 
     it("raises a Lua error when a header value is not a string", function()
@@ -207,7 +213,8 @@ describe("HTTP and download functions validate arguments before issuing a reques
     end)
 
     it("raises a Lua error when headers is not a table", function()
-      assertArgError(function() postHTTP("payload", "http://localhost/", 5) end, "postHTTP: bad argument")
+      assertArgError(function() postHTTP("payload", "http://localhost/", 5) end,
+        "postHTTP: bad argument #3 type (headers as a table expected, got number!)")
     end)
   end)
 
@@ -219,6 +226,26 @@ describe("HTTP and download functions validate arguments before issuing a reques
     it("raises a Lua error when the url is missing", function()
       assertArgError(function() putHTTP("payload") end, "putHTTP: bad argument")
     end)
+
+    it("returns nil for an invalid url without issuing a request", function()
+      local ok, err = putHTTP("payload", "")
+      assert.is_nil(ok)
+      assert.is_true(contains(err, "url is invalid"))
+    end)
+
+    it("raises a Lua error when headers is not a table", function()
+      assertArgError(function() putHTTP("payload", "http://localhost/", 5) end,
+        "putHTTP: bad argument #3 type (headers as a table expected, got number!)")
+    end)
+  end)
+
+  describe("the optional file argument", function()
+    it("returns nil and a message when the file cannot be read", function()
+      local ok, err = postHTTP("payload", "http://localhost/", {}, getMudletHomeDir() .. "/busted-no-such-upload.txt")
+      assert.is_nil(ok)
+      assert.is_true(contains(err, "couldn't open"), tostring(err))
+      assert.is_true(contains(err, "busted-no-such-upload.txt"), tostring(err))
+    end)
   end)
 
   describe("customHTTP", function()
@@ -255,6 +282,364 @@ describe("HTTP and download functions validate arguments before issuing a reques
   end)
 end)
 
+describe("Downloads and HTTP verbs against the local fixture server", function()
+  -- CI starts CI/http-fixture-server.py before the suite and passes its
+  -- ephemeral port in MUDLET_TEST_HTTP_PORT. The server serves
+  -- CI/http-fixtures/ and answers any verb below /echo by reporting the
+  -- method, headers and body it received, which is how these specs prove what
+  -- Mudlet actually put on the wire. Every response carries the
+  -- X-Mudlet-Fixture header so the response table each event delivers can be
+  -- checked too.
+  --
+  -- The requests are asynchronous: nothing is sent until the event loop runs,
+  -- which only happens inside waitForEvent(), so arming the wait after issuing
+  -- the request cannot miss the reply.
+  local httpPort = os.getenv("MUDLET_TEST_HTTP_PORT")
+  -- the contents of CI/http-fixtures/fixture.txt
+  local fixtureBody = "Mudlet self-test HTTP fixture.\n"
+
+  local function fixtureUrl(path)
+    return "http://127.0.0.1:" .. httpPort .. path
+  end
+
+  -- Returns true when the caller must stop because there is no server to talk
+  -- to. A developer's local run without the fixture server still passes; CI
+  -- sets MUDLET_TEST_REQUIRE_HTTP_FIXTURE so that a workflow which stops
+  -- handing the port over fails instead of quietly skipping the whole family.
+  local requireFixture = os.getenv("MUDLET_TEST_REQUIRE_HTTP_FIXTURE")
+
+  local function noFixtureServer()
+    if httpPort then
+      return false
+    end
+    if requireFixture then
+      assert.is_true(false, "MUDLET_TEST_REQUIRE_HTTP_FIXTURE is set but MUDLET_TEST_HTTP_PORT is not - the fixture server did not reach the specs")
+    end
+    pending("MUDLET_TEST_HTTP_PORT is not set (fixture HTTP server not running)")
+    return true
+  end
+
+  local function readFile(path)
+    local handle = io.open(path, "rb")
+    if not handle then
+      return nil
+    end
+    local body = handle:read("*a")
+    handle:close()
+    return body
+  end
+
+  local function writeFile(path, body)
+    local handle = io.open(path, "wb")
+    handle:write(body)
+    handle:close()
+  end
+
+  -- Qt normalises the header names it hands back (they arrive lower-cased from
+  -- Qt 6.7 on, as sent before that), so look the header up without relying on
+  -- its case.
+  local function headerValue(response, name)
+    for key, value in pairs(response.headers) do
+      if key:lower() == name:lower() then
+        return value
+      end
+    end
+    return nil
+  end
+
+  -- Proves the response reached Lua as a table carrying the header and the
+  -- cookie that the fixture server sets on every response, rather than as some
+  -- other truthy value.
+  local function assertFixtureResponse(response)
+    assert.is_table(response)
+    assert.is_table(response.headers)
+    assert.is_table(response.cookies)
+    assert.equals("1", headerValue(response, "X-Mudlet-Fixture"))
+    assert.equals("1", response.cookies["mudlet-fixture"])
+  end
+
+  describe("downloadFile", function()
+    it("writes the fixture to disk and reports it in sysDownloadDone", function()
+      if noFixtureServer() then
+        return
+      end
+      local target = getMudletHomeDir() .. "/busted-download-done.txt"
+      os.remove(target)
+      finally(function() os.remove(target) end)
+      local queued, actualUrl = downloadFile(target, fixtureUrl("/fixture.txt"))
+      assert.is_true(queued)
+      assert.equals(fixtureUrl("/fixture.txt"), actualUrl)
+
+      local event, localFile, bytesWritten, response = waitForEvent("sysDownloadDone", 2000)
+      assert.equals("sysDownloadDone", event)
+      assert.equals(target, localFile)
+      assert.equals(#fixtureBody, bytesWritten)
+      assert.equals(fixtureBody, readFile(target))
+      assertFixtureResponse(response)
+    end)
+
+    it("reports the download's progress while it runs", function()
+      if noFixtureServer() then
+        return
+      end
+      local target = getMudletHomeDir() .. "/busted-download-progress.txt"
+      os.remove(target)
+      -- Collected through a handler rather than a wait of its own: how many
+      -- progress events Qt emits for a 31 byte body is not fixed, but the last
+      -- one must account for the whole body.
+      local progress = {}
+      local handler = registerAnonymousEventHandler("sysDownloadFileProgress", function(_, url, downloaded, total)
+        progress[#progress + 1] = {url = url, downloaded = downloaded, total = total}
+      end)
+      finally(function()
+        killAnonymousEventHandler(handler)
+        os.remove(target)
+      end)
+
+      assert.is_true(downloadFile(target, fixtureUrl("/fixture.txt")))
+      assert.equals("sysDownloadDone", (waitForEvent("sysDownloadDone", 2000)))
+
+      assert.is_true(#progress > 0)
+      local last = progress[#progress]
+      assert.equals(fixtureUrl("/fixture.txt"), last.url)
+      assert.equals(#fixtureBody, last.downloaded)
+      assert.equals(#fixtureBody, last.total)
+    end)
+
+    it("raises sysDownloadError and writes no file when the url 404s", function()
+      if noFixtureServer() then
+        return
+      end
+      local target = getMudletHomeDir() .. "/busted-download-missing.txt"
+      os.remove(target)
+      finally(function() os.remove(target) end)
+      assert.is_true(downloadFile(target, fixtureUrl("/no-such-fixture.txt")))
+
+      local event, message, localFile, url, response = waitForEvent("sysDownloadError", 2000)
+      assert.equals("sysDownloadError", event)
+      assert.is_string(message)
+      assert.equals(target, localFile)
+      assert.equals(fixtureUrl("/no-such-fixture.txt"), url)
+      assertFixtureResponse(response)
+      assert.is_nil(readFile(target))
+    end)
+
+    it("raises sysDownloadError naming the local file when it cannot be written", function()
+      if noFixtureServer() then
+        return
+      end
+      -- the directory does not exist, so QSaveFile cannot open the target: this
+      -- path reports a local reason as its fourth argument where the network
+      -- error path reports the url
+      local target = getMudletHomeDir() .. "/busted-no-such-directory/download.txt"
+      assert.is_true(downloadFile(target, fixtureUrl("/fixture.txt")))
+
+      local event, message, localFile, reason = waitForEvent("sysDownloadError", 2000)
+      assert.equals("sysDownloadError", event)
+      assert.equals("Couldn't save to the destination file", message)
+      assert.equals(target, localFile)
+      assert.equals("Couldn't open the destination file for writing (permission errors?)", reason)
+    end)
+  end)
+
+  describe("getHTTP", function()
+    it("delivers the fixture's body in sysGetHttpDone", function()
+      if noFixtureServer() then
+        return
+      end
+      local queued = getHTTP(fixtureUrl("/fixture.txt"))
+      assert.is_true(queued)
+
+      local event, url, body, response = waitForEvent("sysGetHttpDone", 2000)
+      assert.equals("sysGetHttpDone", event)
+      assert.equals(fixtureUrl("/fixture.txt"), url)
+      assert.equals(fixtureBody, body)
+      assertFixtureResponse(response)
+    end)
+
+    it("sends the custom headers it was given", function()
+      if noFixtureServer() then
+        return
+      end
+      assert.is_true(getHTTP(fixtureUrl("/echo"), {["X-Mudlet-Test"] = "get-header"}))
+
+      local event, _, body = waitForEvent("sysGetHttpDone", 2000)
+      assert.equals("sysGetHttpDone", event)
+      assert.is_true(contains(body, "method=GET"))
+      assert.is_true(contains(body, "header:x-mudlet-test=get-header"), body)
+      -- setNetworkRequestDefaults() puts Mudlet's own user agent on the request
+      assert.is_true(contains(body, "header:user-agent=Mozilla/5.0 (Mudlet/"), body)
+    end)
+
+    it("raises sysGetHttpError for a url that 404s", function()
+      if noFixtureServer() then
+        return
+      end
+      assert.is_true(getHTTP(fixtureUrl("/no-such-fixture.txt")))
+
+      local event, message, url, response = waitForEvent("sysGetHttpError", 2000)
+      assert.equals("sysGetHttpError", event)
+      assert.is_string(message)
+      assert.equals(fixtureUrl("/no-such-fixture.txt"), url)
+      assertFixtureResponse(response)
+    end)
+  end)
+
+  describe("postHTTP", function()
+    it("sends its data and headers, and reports the reply in sysPostHttpDone", function()
+      if noFixtureServer() then
+        return
+      end
+      local queued = postHTTP("posted=payload", fixtureUrl("/echo"), {["X-Mudlet-Test"] = "post-header"})
+      assert.is_true(queued)
+
+      local event, url, body, response = waitForEvent("sysPostHttpDone", 2000)
+      assert.equals("sysPostHttpDone", event)
+      assert.equals(fixtureUrl("/echo"), url)
+      assert.is_true(contains(body, "method=POST"), body)
+      assert.is_true(contains(body, "header:x-mudlet-test=post-header"), body)
+      assert.is_true(contains(body, "body=posted=payload"), body)
+      assertFixtureResponse(response)
+    end)
+
+    it("sends a file's contents in place of the data argument", function()
+      if noFixtureServer() then
+        return
+      end
+      local upload = getMudletHomeDir() .. "/busted-http-upload.txt"
+      writeFile(upload, "contents from the uploaded file")
+      finally(function() os.remove(upload) end)
+
+      assert.is_true(postHTTP("data that must be ignored", fixtureUrl("/echo"), {}, upload))
+
+      local event, _, body = waitForEvent("sysPostHttpDone", 2000)
+      assert.equals("sysPostHttpDone", event)
+      assert.is_true(contains(body, "body=contents from the uploaded file"), body)
+      assert.is_false(contains(body, "data that must be ignored"))
+    end)
+
+    it("accepts a nil data argument when a file is supplied", function()
+      if noFixtureServer() then
+        return
+      end
+      local upload = getMudletHomeDir() .. "/busted-http-upload-only.txt"
+      writeFile(upload, "file body with no data argument")
+      finally(function() os.remove(upload) end)
+
+      assert.is_true(postHTTP(nil, fixtureUrl("/echo"), {}, upload))
+
+      local event, _, body = waitForEvent("sysPostHttpDone", 2000)
+      assert.equals("sysPostHttpDone", event)
+      assert.is_true(contains(body, "body=file body with no data argument"), body)
+    end)
+
+    it("raises sysPostHttpError when the endpoint refuses the verb", function()
+      if noFixtureServer() then
+        return
+      end
+      -- Only /echo accepts a POST; the static fixture path answers 404.
+      assert.is_true(postHTTP("payload", fixtureUrl("/fixture.txt")))
+
+      local event, message, url, response = waitForEvent("sysPostHttpError", 2000)
+      assert.equals("sysPostHttpError", event)
+      assert.is_string(message)
+      assert.equals(fixtureUrl("/fixture.txt"), url)
+      assertFixtureResponse(response)
+    end)
+  end)
+
+  describe("putHTTP", function()
+    it("sends its data with the PUT verb and reports sysPutHttpDone", function()
+      if noFixtureServer() then
+        return
+      end
+      local queued = putHTTP("put=payload", fixtureUrl("/echo"), {["X-Mudlet-Test"] = "put-header"})
+      assert.is_true(queued)
+
+      local event, url, body, response = waitForEvent("sysPutHttpDone", 2000)
+      assert.equals("sysPutHttpDone", event)
+      assert.equals(fixtureUrl("/echo"), url)
+      assert.is_true(contains(body, "method=PUT"), body)
+      assert.is_true(contains(body, "header:x-mudlet-test=put-header"), body)
+      assert.is_true(contains(body, "body=put=payload"), body)
+      assertFixtureResponse(response)
+    end)
+
+    it("raises sysPutHttpError when the endpoint refuses the verb", function()
+      if noFixtureServer() then
+        return
+      end
+      assert.is_true(putHTTP("payload", fixtureUrl("/fixture.txt")))
+
+      local event, message, url = waitForEvent("sysPutHttpError", 2000)
+      assert.equals("sysPutHttpError", event)
+      assert.is_string(message)
+      assert.equals(fixtureUrl("/fixture.txt"), url)
+    end)
+  end)
+
+  describe("deleteHTTP", function()
+    it("sends the DELETE verb and reports sysDeleteHttpDone", function()
+      if noFixtureServer() then
+        return
+      end
+      local queued = deleteHTTP(fixtureUrl("/echo"), {["X-Mudlet-Test"] = "delete-header"})
+      assert.is_true(queued)
+
+      local event, url, body, response = waitForEvent("sysDeleteHttpDone", 2000)
+      assert.equals("sysDeleteHttpDone", event)
+      assert.equals(fixtureUrl("/echo"), url)
+      assert.is_true(contains(body, "method=DELETE"), body)
+      assert.is_true(contains(body, "header:x-mudlet-test=delete-header"), body)
+      assertFixtureResponse(response)
+    end)
+
+    it("raises sysDeleteHttpError when the endpoint refuses the verb", function()
+      if noFixtureServer() then
+        return
+      end
+      assert.is_true(deleteHTTP(fixtureUrl("/fixture.txt")))
+
+      local event, message, url = waitForEvent("sysDeleteHttpError", 2000)
+      assert.equals("sysDeleteHttpError", event)
+      assert.is_string(message)
+      assert.equals(fixtureUrl("/fixture.txt"), url)
+    end)
+  end)
+
+  describe("customHTTP", function()
+    it("sends the verb it was given and echoes it back in sysCustomHttpDone", function()
+      if noFixtureServer() then
+        return
+      end
+      local queued = customHTTP("REPORT", "custom=payload", fixtureUrl("/echo"), {["X-Mudlet-Test"] = "custom-header"})
+      assert.is_true(queued)
+
+      local event, url, body, method, response = waitForEvent("sysCustomHttpDone", 2000)
+      assert.equals("sysCustomHttpDone", event)
+      assert.equals(fixtureUrl("/echo"), url)
+      assert.equals("REPORT", method)
+      assert.is_true(contains(body, "method=REPORT"), body)
+      assert.is_true(contains(body, "header:x-mudlet-test=custom-header"), body)
+      assert.is_true(contains(body, "body=custom=payload"), body)
+      assertFixtureResponse(response)
+    end)
+
+    it("raises sysCustomHttpError naming the verb when the endpoint refuses it", function()
+      if noFixtureServer() then
+        return
+      end
+      assert.is_true(customHTTP("REPORT", "payload", fixtureUrl("/fixture.txt")))
+
+      local event, message, url, method = waitForEvent("sysCustomHttpError", 2000)
+      assert.equals("sysCustomHttpError", event)
+      assert.is_string(message)
+      assert.equals(fixtureUrl("/fixture.txt"), url)
+      assert.equals("REPORT", method)
+    end)
+  end)
+end)
+
 describe("openUrl validates its argument without launching anything", function()
   it("raises a Lua error when the url is missing", function()
     assertArgError(function() openUrl() end, "openUrl: bad argument")

From d762957bba9e620cc46962aca4265abc27314225 Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Sun, 2 Aug 2026 13:01:02 +0200
Subject: [PATCH 044/155] infrastructure: fix Windows media path assert, spare
 the media cache

sysMediaStarted carries QUrl::path(), which prefixes a drive-lettered
Windows path with a slash, so the path assertion failed on windows64.
Normalise it before comparing.

purgeMediaCache() empties the whole profile media directory, so the purge
spec now moves anything that is not its own fixture aside and puts it back.

Record what CI answered about macOS: its runners start no player, so the
media gate stays off there.

Assisted-by: Claude:claude-opus-5
---
 .github/workflows/build-mudlet-pr.yml |  6 +++--
 .github/workflows/build-mudlet.yml    |  6 +++--
 src/mudlet-lua/tests/Media_spec.lua   | 38 ++++++++++++++++++++++++++-
 3 files changed, 45 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/build-mudlet-pr.yml b/.github/workflows/build-mudlet-pr.yml
index e56f852be..221d3bb7b 100644
--- a/.github/workflows/build-mudlet-pr.yml
+++ b/.github/workflows/build-mudlet-pr.yml
@@ -484,8 +484,8 @@ jobs:
         MUDLET_TEST_REQUIRE_HTTP_FIXTURE: 1
         # Qt Multimedia runs a player here even without an audio device, so a
         # media effect spec that cannot play is a regression rather than an
-        # environment quirk. macOS is left without this until CI confirms the
-        # same holds there.
+        # environment quirk. macOS runners start no player at all, so the gate
+        # stays off there.
         MUDLET_TEST_REQUIRE_MEDIA: 1
         TESTS_DIRECTORY: ${{github.workspace}}/src/mudlet-lua/tests
         QUIT_MUDLET_AFTER_TESTS: 'true'
@@ -501,6 +501,8 @@ jobs:
         MUDLET_TEST_MODE: 1
         MUDLET_TEST_REQUIRE_TTS_MOCK: 1
         MUDLET_TEST_REQUIRE_HTTP_FIXTURE: 1
+        # No MUDLET_TEST_REQUIRE_MEDIA: Qt Multimedia starts no player on the
+        # macOS runners, so the media effect specs pend here by design.
         TESTS_DIRECTORY: ${{github.workspace}}/src/mudlet-lua/tests
         QUIT_MUDLET_AFTER_TESTS: 'true'
         ASAN_OPTIONS: detect_leaks=0
diff --git a/.github/workflows/build-mudlet.yml b/.github/workflows/build-mudlet.yml
index 375f8785d..b77b2fc0f 100644
--- a/.github/workflows/build-mudlet.yml
+++ b/.github/workflows/build-mudlet.yml
@@ -520,8 +520,8 @@ jobs:
         MUDLET_TEST_REQUIRE_HTTP_FIXTURE: 1
         # Qt Multimedia runs a player here even without an audio device, so a
         # media effect spec that cannot play is a regression rather than an
-        # environment quirk. macOS is left without this until CI confirms the
-        # same holds there.
+        # environment quirk. macOS runners start no player at all, so the gate
+        # stays off there.
         MUDLET_TEST_REQUIRE_MEDIA: 1
         TESTS_DIRECTORY: ${{github.workspace}}/src/mudlet-lua/tests
         QUIT_MUDLET_AFTER_TESTS: 'true'
@@ -537,6 +537,8 @@ jobs:
         MUDLET_TEST_MODE: 1
         MUDLET_TEST_REQUIRE_TTS_MOCK: 1
         MUDLET_TEST_REQUIRE_HTTP_FIXTURE: 1
+        # No MUDLET_TEST_REQUIRE_MEDIA: Qt Multimedia starts no player on the
+        # macOS runners, so the media effect specs pend here by design.
         TESTS_DIRECTORY: ${{github.workspace}}/src/mudlet-lua/tests
         QUIT_MUDLET_AFTER_TESTS: 'true'
         ASAN_OPTIONS: detect_leaks=0
diff --git a/src/mudlet-lua/tests/Media_spec.lua b/src/mudlet-lua/tests/Media_spec.lua
index 5024851d7..87d5a25de 100644
--- a/src/mudlet-lua/tests/Media_spec.lua
+++ b/src/mudlet-lua/tests/Media_spec.lua
@@ -226,6 +226,34 @@ describe("Media playback effects with a generated sound file", function()
     writeMediaFile(longSoundFile, 10000)
   end
 
+  -- purgeMediaCache() empties the whole media directory, not just the fixtures
+  -- these specs wrote, and the self-test profile persists between runs on a
+  -- developer's machine. Anything else already in there is moved aside for the
+  -- duration of the spec and put back afterwards.
+  local function preserveMediaDirectory()
+    local stash = getMudletHomeDir() .. "/busted-media-stash"
+    local preserved = {}
+    for entry in lfs.dir(mediaDirectory) do
+      if entry ~= "." and entry ~= ".." and entry ~= soundFile and entry ~= longSoundFile then
+        preserved[#preserved + 1] = entry
+      end
+    end
+    if #preserved == 0 then
+      return
+    end
+    lfs.mkdir(stash)
+    for _, entry in ipairs(preserved) do
+      os.rename(mediaDirectory .. "/" .. entry, stash .. "/" .. entry)
+    end
+    finally(function()
+      lfs.mkdir(mediaDirectory)
+      for _, entry in ipairs(preserved) do
+        os.rename(stash .. "/" .. entry, mediaDirectory .. "/" .. entry)
+      end
+      lfs.rmdir(stash)
+    end)
+  end
+
   -- Collects every occurrence of a media event for the duration of one spec.
   -- stopSounds() and pauseSounds() change the player's state inside the call
   -- itself, so the matching event is raised before a waitForEvent() could be
@@ -237,6 +265,13 @@ describe("Media playback effects with a generated sound file", function()
     finally(function() killAnonymousEventHandler(handler) end)
   end
 
+  -- The media events carry QUrl::path(), which puts a slash in front of a
+  -- drive-lettered Windows path ("/C:/..."). Take that back off so one
+  -- expected value works on every platform.
+  local function eventPath(path)
+    return (tostring(path):gsub("^/(%a:/)", "%1"))
+  end
+
   -- CI sets this so a missing playback turns into a failure there rather than
   -- into a green skip; a developer's machine without a media backend still
   -- passes.
@@ -282,7 +317,7 @@ describe("Media playback effects with a generated sound file", function()
     local event, file, path, mediaType, key, tag = waitForEvent("sysMediaStarted", 5000)
     assert.equals("sysMediaStarted", event)
     assert.equals(soundFile, file)
-    assert.equals(mediaDirectory .. "/" .. soundFile, path)
+    assert.equals(mediaDirectory .. "/" .. soundFile, eventPath(path))
     assert.equals("sound", mediaType)
     assert.equals("busted-key", key)
     assert.equals("busted-tag", tag)
@@ -457,6 +492,7 @@ describe("Media playback effects with a generated sound file", function()
       return
     end
     writeSoundFiles()
+    preserveMediaDirectory()
     local soundPath = mediaDirectory .. "/" .. soundFile
     assert.is_not_nil(lfs.attributes(soundPath, "mode"))
     assert.is_true(playSoundFile({name = longSoundFile, key = "busted-purged"}))

From 74bd6748e88094358e9d57d21b61bbb4aadaf32a Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Sun, 2 Aug 2026 15:38:16 +0200
Subject: [PATCH 045/155] infrastructure: run the HTTP fixture server on
 Windows CI

The 17 HTTP effect specs pended on Windows: only the Linux and macOS jobs
start CI/http-fixture-server.py. Start it in the same msys2 shell that runs
the tests, since a backgrounded process is not guaranteed to survive into
the next step, and require the fixture (and the mock TTS engine) so a
missing one fails the job instead of skipping the specs.

Assisted-by: Claude:claude-opus-5
---
 .github/workflows/build-mudlet-win-pr.yml | 37 ++++++++++++++++++++++-
 .github/workflows/build-mudlet-win.yml    | 37 ++++++++++++++++++++++-
 2 files changed, 72 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/build-mudlet-win-pr.yml b/.github/workflows/build-mudlet-win-pr.yml
index a46349762..ce0a0d019 100644
--- a/.github/workflows/build-mudlet-win-pr.yml
+++ b/.github/workflows/build-mudlet-win-pr.yml
@@ -113,11 +113,13 @@ jobs:
         QT_FORCE_STDERR_LOGGING: 1
 
     - name: (Windows) Run Lua tests
-      timeout-minutes: 1
+      timeout-minutes: 2
       shell: msys2 {0}
       env:
         AUTORUN_BUSTED_TESTS: 'true'
         MUDLET_TEST_MODE: 1
+        MUDLET_TEST_REQUIRE_TTS_MOCK: 1
+        MUDLET_TEST_REQUIRE_HTTP_FIXTURE: 1
         TESTS_DIRECTORY: ${{github.workspace}}/src/mudlet-lua/tests
         QUIT_MUDLET_AFTER_TESTS: 'true'
       run: |
@@ -126,6 +128,39 @@ jobs:
         LUA_CPATH=$(cygpath -u "$(luarocks --lua-version 5.1 path --lr-cpath)" )
         export LUA_CPATH
 
+        # Linux and macOS start the fixture HTTP server in a step of their own,
+        # but each msys2 step here is its own shell and a process backgrounded
+        # in one is not guaranteed to still be around in the next, so start the
+        # server in the very shell that runs the tests and stop it on the way
+        # out. Paths are handed over in mixed form (C:/...) because bash and
+        # the native Windows python both understand that.
+        temp_dir="$(cygpath -m "${RUNNER_TEMP}")"
+        port_file="${temp_dir}/mudlet-http-fixture-port"
+        fixture_log="${temp_dir}/http-fixture-server.log"
+        rm -f "${port_file}"
+        python_bin=python3
+        command -v "${python_bin}" > /dev/null 2>&1 || python_bin=python
+        MUDLET_TEST_HTTP_PORT_FILE="${port_file}" "${python_bin}" "$GITHUB_WORKSPACE/CI/http-fixture-server.py" > "${fixture_log}" 2>&1 &
+        fixture_pid=$!
+        trap 'kill "${fixture_pid}" > /dev/null 2>&1 || true' EXIT
+        for _ in $(seq 1 100); do
+          [ -s "${port_file}" ] && break
+          sleep 0.1
+        done
+        if [ ! -s "${port_file}" ]; then
+          echo "fixture HTTP server failed to start" >&2
+          cat "${fixture_log}" 2>/dev/null || true
+          exit 1
+        fi
+        MUDLET_TEST_HTTP_PORT="$(cat "${port_file}")"
+        export MUDLET_TEST_HTTP_PORT
+        if ! curl -fsS "http://127.0.0.1:${MUDLET_TEST_HTTP_PORT}/fixture.txt" > /dev/null; then
+          echo "fixture HTTP server is not serving fixtures" >&2
+          cat "${fixture_log}" 2>/dev/null || true
+          exit 1
+        fi
+        echo "fixture HTTP server ready on 127.0.0.1:${MUDLET_TEST_HTTP_PORT}"
+
         $GITHUB_WORKSPACE/build-$MSYSTEM/release/mudlet.exe --profile "Mudlet self-test"
 
     - name: Passed Lua tests
diff --git a/.github/workflows/build-mudlet-win.yml b/.github/workflows/build-mudlet-win.yml
index 81eb538c5..e76187acd 100644
--- a/.github/workflows/build-mudlet-win.yml
+++ b/.github/workflows/build-mudlet-win.yml
@@ -119,11 +119,13 @@ jobs:
         QT_FORCE_STDERR_LOGGING: 1
 
     - name: (Windows) Run Lua tests
-      timeout-minutes: 1
+      timeout-minutes: 2
       shell: msys2 {0}
       env:
         AUTORUN_BUSTED_TESTS: 'true'
         MUDLET_TEST_MODE: 1
+        MUDLET_TEST_REQUIRE_TTS_MOCK: 1
+        MUDLET_TEST_REQUIRE_HTTP_FIXTURE: 1
         TESTS_DIRECTORY: ${{github.workspace}}/src/mudlet-lua/tests
         QUIT_MUDLET_AFTER_TESTS: 'true'
       run: |
@@ -132,6 +134,39 @@ jobs:
         LUA_CPATH=$(cygpath -u "$(luarocks --lua-version 5.1 path --lr-cpath)" )
         export LUA_CPATH
 
+        # Linux and macOS start the fixture HTTP server in a step of their own,
+        # but each msys2 step here is its own shell and a process backgrounded
+        # in one is not guaranteed to still be around in the next, so start the
+        # server in the very shell that runs the tests and stop it on the way
+        # out. Paths are handed over in mixed form (C:/...) because bash and
+        # the native Windows python both understand that.
+        temp_dir="$(cygpath -m "${RUNNER_TEMP}")"
+        port_file="${temp_dir}/mudlet-http-fixture-port"
+        fixture_log="${temp_dir}/http-fixture-server.log"
+        rm -f "${port_file}"
+        python_bin=python3
+        command -v "${python_bin}" > /dev/null 2>&1 || python_bin=python
+        MUDLET_TEST_HTTP_PORT_FILE="${port_file}" "${python_bin}" "$GITHUB_WORKSPACE/CI/http-fixture-server.py" > "${fixture_log}" 2>&1 &
+        fixture_pid=$!
+        trap 'kill "${fixture_pid}" > /dev/null 2>&1 || true' EXIT
+        for _ in $(seq 1 100); do
+          [ -s "${port_file}" ] && break
+          sleep 0.1
+        done
+        if [ ! -s "${port_file}" ]; then
+          echo "fixture HTTP server failed to start" >&2
+          cat "${fixture_log}" 2>/dev/null || true
+          exit 1
+        fi
+        MUDLET_TEST_HTTP_PORT="$(cat "${port_file}")"
+        export MUDLET_TEST_HTTP_PORT
+        if ! curl -fsS "http://127.0.0.1:${MUDLET_TEST_HTTP_PORT}/fixture.txt" > /dev/null; then
+          echo "fixture HTTP server is not serving fixtures" >&2
+          cat "${fixture_log}" 2>/dev/null || true
+          exit 1
+        fi
+        echo "fixture HTTP server ready on 127.0.0.1:${MUDLET_TEST_HTTP_PORT}"
+
         $GITHUB_WORKSPACE/build-$MSYSTEM/release/mudlet.exe --profile "Mudlet self-test"
 
     - name: Passed Lua tests

From 7ca3198bd72770d20c7b0a9f1cd0044051b5f4a6 Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Sun, 2 Aug 2026 16:14:49 +0200
Subject: [PATCH 046/155] infrastructure: keep the HTTP fixtures byte-exact,
 harden the Windows step

Windows CI checks out with core.autocrlf on, which turned the fixture's
newline into CRLF and made three specs see 32 bytes where they expect 31.
Also stop the server with a signal msys2 can deliver to a native process,
print its log either way, cap the health check and declare the Python the
fixture server needs.

Assisted-by: Claude:claude-opus-5
---
 .gitattributes                            |  4 ++++
 .github/workflows/build-mudlet-win-pr.yml | 11 +++++++----
 .github/workflows/build-mudlet-win.yml    | 11 +++++++----
 CI/setup-windows-sdk.sh                   |  5 ++++-
 4 files changed, 22 insertions(+), 9 deletions(-)
 create mode 100644 .gitattributes

diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 000000000..80df9c528
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,4 @@
+# CI/http-fixtures/ is served byte for byte to the networking specs, which
+# assert the exact bodies that come back, so a Windows checkout must not turn
+# its newlines into CRLF.
+CI/http-fixtures/** -text
diff --git a/.github/workflows/build-mudlet-win-pr.yml b/.github/workflows/build-mudlet-win-pr.yml
index ce0a0d019..ea76d448b 100644
--- a/.github/workflows/build-mudlet-win-pr.yml
+++ b/.github/workflows/build-mudlet-win-pr.yml
@@ -142,21 +142,24 @@ jobs:
         command -v "${python_bin}" > /dev/null 2>&1 || python_bin=python
         MUDLET_TEST_HTTP_PORT_FILE="${port_file}" "${python_bin}" "$GITHUB_WORKSPACE/CI/http-fixture-server.py" > "${fixture_log}" 2>&1 &
         fixture_pid=$!
-        trap 'kill "${fixture_pid}" > /dev/null 2>&1 || true' EXIT
+        # Disowned so that stopping it is not reported as a job crash, and -9
+        # because a plain SIGTERM does not reach a native Windows process from
+        # msys2. The server's log is one line when all is well, so print it
+        # either way rather than only where trouble is expected.
+        disown "${fixture_pid}" 2>/dev/null || true
+        trap 'kill -9 "${fixture_pid}" > /dev/null 2>&1 || true; cat "${fixture_log}" 2>/dev/null || true' EXIT
         for _ in $(seq 1 100); do
           [ -s "${port_file}" ] && break
           sleep 0.1
         done
         if [ ! -s "${port_file}" ]; then
           echo "fixture HTTP server failed to start" >&2
-          cat "${fixture_log}" 2>/dev/null || true
           exit 1
         fi
         MUDLET_TEST_HTTP_PORT="$(cat "${port_file}")"
         export MUDLET_TEST_HTTP_PORT
-        if ! curl -fsS "http://127.0.0.1:${MUDLET_TEST_HTTP_PORT}/fixture.txt" > /dev/null; then
+        if ! curl -fsS --max-time 10 "http://127.0.0.1:${MUDLET_TEST_HTTP_PORT}/fixture.txt" > /dev/null; then
           echo "fixture HTTP server is not serving fixtures" >&2
-          cat "${fixture_log}" 2>/dev/null || true
           exit 1
         fi
         echo "fixture HTTP server ready on 127.0.0.1:${MUDLET_TEST_HTTP_PORT}"
diff --git a/.github/workflows/build-mudlet-win.yml b/.github/workflows/build-mudlet-win.yml
index e76187acd..358965622 100644
--- a/.github/workflows/build-mudlet-win.yml
+++ b/.github/workflows/build-mudlet-win.yml
@@ -148,21 +148,24 @@ jobs:
         command -v "${python_bin}" > /dev/null 2>&1 || python_bin=python
         MUDLET_TEST_HTTP_PORT_FILE="${port_file}" "${python_bin}" "$GITHUB_WORKSPACE/CI/http-fixture-server.py" > "${fixture_log}" 2>&1 &
         fixture_pid=$!
-        trap 'kill "${fixture_pid}" > /dev/null 2>&1 || true' EXIT
+        # Disowned so that stopping it is not reported as a job crash, and -9
+        # because a plain SIGTERM does not reach a native Windows process from
+        # msys2. The server's log is one line when all is well, so print it
+        # either way rather than only where trouble is expected.
+        disown "${fixture_pid}" 2>/dev/null || true
+        trap 'kill -9 "${fixture_pid}" > /dev/null 2>&1 || true; cat "${fixture_log}" 2>/dev/null || true' EXIT
         for _ in $(seq 1 100); do
           [ -s "${port_file}" ] && break
           sleep 0.1
         done
         if [ ! -s "${port_file}" ]; then
           echo "fixture HTTP server failed to start" >&2
-          cat "${fixture_log}" 2>/dev/null || true
           exit 1
         fi
         MUDLET_TEST_HTTP_PORT="$(cat "${port_file}")"
         export MUDLET_TEST_HTTP_PORT
-        if ! curl -fsS "http://127.0.0.1:${MUDLET_TEST_HTTP_PORT}/fixture.txt" > /dev/null; then
+        if ! curl -fsS --max-time 10 "http://127.0.0.1:${MUDLET_TEST_HTTP_PORT}/fixture.txt" > /dev/null; then
           echo "fixture HTTP server is not serving fixtures" >&2
-          cat "${fixture_log}" 2>/dev/null || true
           exit 1
         fi
         echo "fixture HTTP server ready on 127.0.0.1:${MUDLET_TEST_HTTP_PORT}"
diff --git a/CI/setup-windows-sdk.sh b/CI/setup-windows-sdk.sh
index d0e453d26..93ae425ef 100644
--- a/CI/setup-windows-sdk.sh
+++ b/CI/setup-windows-sdk.sh
@@ -19,7 +19,9 @@
 #   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             #
 ###########################################################################
 
-# Version: 2.3.0    Switch from MINGW64 to CLANG64 
+# Version: 2.4.0    Add Python, needed by the fixture HTTP server the Lua
+#                   tests run against
+#          2.3.0    Switch from MINGW64 to CLANG64
 #          2.2.0    Add CMake package for CMake-based builds
 #          2.1.0    Remove MINGW32 since upstream no longer supports it
 #          2.0.0    Rework to build on an MSYS2 MINGW64 Github workflow
@@ -128,6 +130,7 @@ while true; do
     "${MINGW_PACKAGE_PREFIX}-ninja" \
     "${MINGW_PACKAGE_PREFIX}-assimp" \
     "${MINGW_PACKAGE_PREFIX}-curl" \
+    "${MINGW_PACKAGE_PREFIX}-python" \
     "${MINGW_PACKAGE_PREFIX}-uasm" \
     "${MINGW_PACKAGE_PREFIX}-cmake" \
     "${MINGW_PACKAGE_PREFIX}-jq"; then

From 7e3f7917acaa0bc446614f09c205675a2888ee73 Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Sun, 2 Aug 2026 11:12:56 +0200
Subject: [PATCH 047/155] infrastructure: Geyser geometry and visibility tests

Cover the Geyser layer with effect specs built on the Wave 0 getters
(getWindowGeometry, windowVisible, getLabelText): constraint resolution,
move/resize/hide/show, nesting, VBox/HBox layout, gauge sizing, label
text and format readback, button and adjustable container state.

Assisted-by: Claude:claude-opus-4-8
---
 .../tests/GeyserAdjustableContainer_spec.lua  |  98 +++
 src/mudlet-lua/tests/GeyserButton_spec.lua    | 178 +++++-
 src/mudlet-lua/tests/GeyserContainer_spec.lua | 576 ++++++++++++++++++
 src/mudlet-lua/tests/GeyserGauge_spec.lua     | 289 +++++++++
 src/mudlet-lua/tests/GeyserHBox_spec.lua      | 143 +++++
 src/mudlet-lua/tests/GeyserLabel_spec.lua     | 347 +++++++++++
 .../tests/GeyserMiniConsole_spec.lua          | 184 ++++++
 .../tests/GeyserStyleSheet_spec.lua           |  37 +-
 src/mudlet-lua/tests/GeyserVBox_spec.lua      | 154 +++++
 src/mudlet-lua/tests/GeyserWindow_spec.lua    | 187 ++++++
 10 files changed, 2191 insertions(+), 2 deletions(-)
 create mode 100644 src/mudlet-lua/tests/GeyserContainer_spec.lua
 create mode 100644 src/mudlet-lua/tests/GeyserGauge_spec.lua
 create mode 100644 src/mudlet-lua/tests/GeyserHBox_spec.lua
 create mode 100644 src/mudlet-lua/tests/GeyserMiniConsole_spec.lua
 create mode 100644 src/mudlet-lua/tests/GeyserVBox_spec.lua
 create mode 100644 src/mudlet-lua/tests/GeyserWindow_spec.lua

diff --git a/src/mudlet-lua/tests/GeyserAdjustableContainer_spec.lua b/src/mudlet-lua/tests/GeyserAdjustableContainer_spec.lua
index 8ef886ce9..67794166c 100644
--- a/src/mudlet-lua/tests/GeyserAdjustableContainer_spec.lua
+++ b/src/mudlet-lua/tests/GeyserAdjustableContainer_spec.lua
@@ -110,4 +110,102 @@ describe("Tests functionality of Adjustable.Container", function()
       ac:hide()
     end)
   end)
+
+  -- Geometry, visibility and title readback, asserted on the widgets the
+  -- container builds rather than on its bookkeeping alone.
+  describe("Adjustable.Container widget state", function()
+    local container
+
+    local function geometry(name)
+      local x, y, width, height = getWindowGeometry(name)
+      return {x = x, y = y, width = width, height = height}
+    end
+
+    before_each(function()
+      container = Adjustable.Container:new({
+        name = "gasContainer",
+        x = 20,
+        y = 30,
+        width = 200,
+        height = 200,
+        autoLoad = false,
+        autoSave = false,
+      })
+    end)
+
+    after_each(function()
+      if container and Geyser.windowList.gasContainer == container then
+        container:delete()
+      end
+      container = nil
+    end)
+
+    it("puts its backdrop label over the container's geometry", function()
+      assert.are.equal("label", windowType("gasContaineradjLabel"))
+      assert.are.same({x = 20, y = 30, width = 200, height = 200}, geometry("gasContaineradjLabel"))
+      assert.is_true(windowVisible("gasContaineradjLabel"))
+    end)
+
+    it("drags its labels along when the container moves and resizes", function()
+      container:move(60, 70)
+      container:resize(100, 120)
+      assert.are.same({x = 60, y = 70, width = 100, height = 120}, geometry("gasContaineradjLabel"))
+    end)
+
+    it("hides and shows every widget it owns", function()
+      container:hide()
+      assert.is_false(windowVisible("gasContaineradjLabel"))
+      container:show()
+      assert.is_true(windowVisible("gasContaineradjLabel"))
+    end)
+
+    it("writes the title onto the backdrop label", function()
+      container:setTitle("My Title", "red", "c")
+      local text = getLabelText("gasContaineradjLabel")
+      assert.is_truthy(text:find("My Title", 1, true))
+      assert.is_truthy(text:find("color: #ff0000", 1, true))
+      assert.is_truthy(text:find('align="center"', 1, true))
+      assert.are.equal("My Title", container.titleText)
+    end)
+
+    it("titles itself after its name to begin with", function()
+      assert.are.equal("gasContainer - Adjustable Container", container.titleText)
+      assert.is_truthy(getLabelText("gasContaineradjLabel"):find("gasContainer - Adjustable Container", 1, true))
+    end)
+
+    it("stops drawing the title while the container is locked", function()
+      container:setTitle("before lock")
+      assert.is_truthy(getLabelText("gasContaineradjLabel"):find("before lock", 1, true))
+      -- the standard lock style clears the title bar so the container reads as
+      -- locked down
+      container:lockContainer()
+      assert.is_true(container.locked)
+      assert.is_nil(getLabelText("gasContaineradjLabel"):find("before lock", 1, true))
+      container:setTitle("after lock")
+      assert.are.equal("after lock", container.titleText)
+      assert.is_nil(getLabelText("gasContaineradjLabel"):find("after lock", 1, true))
+      -- unlocking redraws the title that was stored while locked
+      container:unlockContainer()
+      assert.is_false(container.locked)
+      assert.is_truthy(getLabelText("gasContaineradjLabel"):find("after lock", 1, true))
+    end)
+
+    it("shrinks to the title bar when minimized and grows back when restored", function()
+      container:minimize()
+      assert.is_true(container.minimized)
+      local minimized = geometry("gasContaineradjLabel")
+      assert.are.equal(200, minimized.width)
+      assert.is_true(minimized.height < 200)
+      assert.are.equal(container.buttonsize + 10, minimized.height)
+      container:restore()
+      assert.is_false(container.minimized)
+      assert.are.same({x = 20, y = 30, width = 200, height = 200}, geometry("gasContaineradjLabel"))
+    end)
+
+    it("deletes all of its widgets", function()
+      container:delete()
+      assert.is_nil(getWindowGeometry("gasContaineradjLabel"))
+      assert.is_nil(Geyser.windowList.gasContainer)
+    end)
+  end)
 end)
diff --git a/src/mudlet-lua/tests/GeyserButton_spec.lua b/src/mudlet-lua/tests/GeyserButton_spec.lua
index 876c41482..8c01b4e33 100644
--- a/src/mudlet-lua/tests/GeyserButton_spec.lua
+++ b/src/mudlet-lua/tests/GeyserButton_spec.lua
@@ -142,4 +142,180 @@ describe("Tests functionality of Geyser.Button", function()
       assert.spy(toolTipSpy).was.called_with(match.is_ref(gb), gb.downTooltip, gb.toolTipDuration)
     end)
   end)
-end)
\ No newline at end of file
+
+  -- The blocks above watch the calls a button makes; these assert what the
+  -- widget ends up looking like, through getWindowGeometry and getLabelText.
+  describe('Geyser.Button widget state', function()
+    local created
+
+    local function geometry(name)
+      local x, y, width, height = getWindowGeometry(name)
+      return {x = x, y = y, width = width, height = height}
+    end
+
+    local function track(object)
+      created[#created + 1] = object
+      return object
+    end
+
+    local function alive(object)
+      if not object or not object.container or not object.container.windowList then
+        return false
+      end
+      return object.container.windowList[object.name] == object
+    end
+
+    before_each(function()
+      created = {}
+    end)
+
+    after_each(function()
+      for _, object in ipairs(created) do
+        if alive(object) then
+          object:delete()
+        end
+      end
+      created = {}
+    end)
+
+    it('creates a label widget at the constrained geometry', function()
+      track(Geyser.Button:new({name = "gbsGeometry", x = 5, y = 6, width = 70, height = 30}))
+      assert.are.equal("label", windowType("gbsGeometry"))
+      assert.are.same({x = 5, y = 6, width = 70, height = 30}, geometry("gbsGeometry"))
+      assert.is_true(windowVisible("gbsGeometry"))
+    end)
+
+    it('falls back to the button default size, not the label one', function()
+      track(Geyser.Button:new({name = "gbsDefaultSize", x = 0, y = 0}))
+      local actual = geometry("gbsDefaultSize")
+      assert.are.equal(50, actual.width)
+      assert.are.equal(50, actual.height)
+    end)
+
+    it('shows the up message on the label to start with', function()
+      track(Geyser.Button:new({name = "gbsUpMessage", x = 0, y = 0, width = 60, height = 20, msg = "press me"}))
+      assert.is_truthy(getLabelText("gbsUpMessage"):find("press me", 1, true))
+    end)
+
+    it('swaps the label text with the state of a two state button', function()
+      local button = track(Geyser.Button:new({
+        name = "gbsTwoState",
+        x = 0, y = 0, width = 60, height = 20,
+        msg = "up text",
+        downMsg = "down text",
+        twoState = true,
+      }))
+      assert.is_truthy(getLabelText("gbsTwoState"):find("up text", 1, true))
+      button:setState("down")
+      assert.is_truthy(getLabelText("gbsTwoState"):find("down text", 1, true))
+      button:setState("up")
+      assert.is_truthy(getLabelText("gbsTwoState"):find("up text", 1, true))
+    end)
+
+    it('refuses to push a single state button down', function()
+      local button = track(Geyser.Button:new({
+        name = "gbsSingleState",
+        x = 0, y = 0, width = 60, height = 20,
+        msg = "up text",
+        downMsg = "down text",
+      }))
+      local result, message = button:setState("down")
+      assert.is_nil(result)
+      assert.are.equal("cannot set a single state button's state to 'down', only 'up'", message)
+      -- the refusal happens before anything is drawn, so the button still
+      -- shows its up message
+      assert.is_truthy(getLabelText("gbsSingleState"):find("up text", 1, true))
+    end)
+
+    it('rejects a state that is not a string or not a known state', function()
+      local button = track(Geyser.Button:new({name = "gbsBadState", x = 0, y = 0, width = 60, height = 20}))
+      local result, message = button:setState(7)
+      assert.is_nil(result)
+      assert.is_truthy(message:find("state as string expected, got number", 1, true))
+      local badResult, badMessage = button:setState("sideways")
+      assert.is_nil(badResult)
+      assert.is_truthy(badMessage:find("state must be one of 'up' or 'down'", 1, true))
+      assert.are.equal("up", button.state)
+    end)
+
+    it('applies the stylesheet of the state it is put into', function()
+      local button = track(Geyser.Button:new({
+        name = "gbsStyles",
+        x = 0, y = 0, width = 60, height = 20,
+        twoState = true,
+        style = "background-color: black;",
+        downStyle = "background-color: blue;",
+      }))
+      button:setState("up")
+      assert.are.equal("background-color: black;", getLabelStyleSheet("gbsStyles"))
+      button:setState("down")
+      assert.are.equal("background-color: blue;", getLabelStyleSheet("gbsStyles"))
+    end)
+
+    it('setMsg and setDownMsg redraw the button in its current state', function()
+      local button = track(Geyser.Button:new({
+        name = "gbsMessages",
+        x = 0, y = 0, width = 60, height = 20,
+        twoState = true,
+      }))
+      button:setMsg("new up")
+      assert.is_truthy(getLabelText("gbsMessages"):find("new up", 1, true))
+      button:setDownMsg("new down")
+      button:setState("down")
+      assert.is_truthy(getLabelText("gbsMessages"):find("new down", 1, true))
+      local result, message = button:setMsg(42)
+      assert.is_nil(result)
+      assert.is_truthy(message:find("msg as string expected, got number", 1, true))
+    end)
+
+    it('press walks a two state button through both messages', function()
+      local pressed = 0
+      local button = track(Geyser.Button:new({
+        name = "gbsPress",
+        x = 0, y = 0, width = 60, height = 20,
+        msg = "up text",
+        downMsg = "down text",
+        twoState = true,
+        clickFunction = function() pressed = pressed + 1 end,
+        downFunction = function() pressed = pressed + 1 end,
+      }))
+      button:press()
+      assert.are.equal("down", button.state)
+      assert.is_truthy(getLabelText("gbsPress"):find("down text", 1, true))
+      button:press()
+      assert.are.equal("up", button.state)
+      assert.is_truthy(getLabelText("gbsPress"):find("up text", 1, true))
+      assert.are.equal(2, pressed)
+    end)
+
+    it('disableTwoState puts the button back up', function()
+      local button = track(Geyser.Button:new({
+        name = "gbsDisableTwoState",
+        x = 0, y = 0, width = 60, height = 20,
+        msg = "up text",
+        downMsg = "down text",
+        twoState = true,
+      }))
+      button:setState("down")
+      button:disableTwoState()
+      assert.is_false(button.twoState)
+      assert.are.equal("up", button.state)
+      assert.is_truthy(getLabelText("gbsDisableTwoState"):find("up text", 1, true))
+    end)
+
+    it('hides and shows the button widget', function()
+      local button = track(Geyser.Button:new({name = "gbsVisible", x = 0, y = 0, width = 60, height = 20}))
+      button:hide()
+      assert.is_false(windowVisible("gbsVisible"))
+      button:show()
+      assert.is_true(windowVisible("gbsVisible"))
+    end)
+
+    it('deletes its widget', function()
+      local button = Geyser.Button:new({name = "gbsDelete", x = 0, y = 0, width = 60, height = 20})
+      button:delete()
+      assert.is_nil(getWindowGeometry("gbsDelete"))
+      assert.is_nil(Geyser.windowList.gbsDelete)
+    end)
+  end)
+end)
diff --git a/src/mudlet-lua/tests/GeyserContainer_spec.lua b/src/mudlet-lua/tests/GeyserContainer_spec.lua
new file mode 100644
index 000000000..cb229215d
--- /dev/null
+++ b/src/mudlet-lua/tests/GeyserContainer_spec.lua
@@ -0,0 +1,576 @@
+-- Geyser resolves its constraints against the live main window, whose size
+-- differs between machines, so expectations are computed from
+-- getMainWindowSize() at assert time rather than hardcoded. Mudlet truncates
+-- the doubles handed to moveWindow()/resizeWindow() (static_cast), which
+-- is why the expectations are floored.
+local function floor(value)
+  return math.floor(value)
+end
+
+-- Containers themselves have no Mudlet widget, so geometry is read back from a
+-- child label - the widget Geyser actually moves and resizes.
+local function geometry(name)
+  local x, y, width, height = getWindowGeometry(name)
+  return {x = x, y = y, width = width, height = height}
+end
+
+describe("Tests functionality of Geyser.Container", function()
+  local created
+
+  local function track(object)
+    created[#created + 1] = object
+    return object
+  end
+
+  -- A cascading parent delete unlinks its children from its windowList, which
+  -- is how we tell an object has already been deleted and must not be deleted
+  -- again.
+  local function alive(object)
+    if not object or not object.container or not object.container.windowList then
+      return false
+    end
+    return object.container.windowList[object.name] == object
+  end
+
+  before_each(function()
+    created = {}
+  end)
+
+  after_each(function()
+    for _, object in ipairs(created) do
+      if alive(object) then
+        object:delete()
+      end
+    end
+    created = {}
+  end)
+
+  describe("Geyser.Container:new and Geyser.Container:new2", function()
+    it("generates a name and defaults the type to container", function()
+      local container = track(Geyser.Container:new())
+      assert.are.equal("container", container.type)
+      assert.is_truthy(container.name:find("^anon_window_%d+$"))
+      assert.are.same({}, container.windows)
+    end)
+
+    it("registers a top level container with the root Geyser window list", function()
+      local container = track(Geyser.Container:new({name = "gcsRegistered"}))
+      assert.are.equal(container, Geyser.windowList.gcsRegistered)
+      assert.is_truthy(table.index_of(Geyser.windows, "gcsRegistered"))
+      assert.are.equal(Geyser, container.container)
+      assert.are.equal("main", container.windowname)
+    end)
+
+    it("has no Mudlet widget of its own", function()
+      track(Geyser.Container:new({name = "gcsNoWidget", x = 0, y = 0, width = 100, height = 100}))
+      local result, message = getWindowGeometry("gcsNoWidget")
+      assert.is_nil(result)
+      assert.is_truthy(message:find("gcsNoWidget", 1, true))
+      assert.is_nil(windowType("gcsNoWidget"))
+    end)
+
+    it("adds a child to the container given as the second argument", function()
+      local parent = track(Geyser.Container:new({name = "gcsParent", x = 0, y = 0, width = 100, height = 100}))
+      local child = track(Geyser.Container:new({name = "gcsChild"}, parent))
+      assert.are.equal(parent, child.container)
+      assert.are.equal(child, parent.windowList.gcsChild)
+      assert.are.same({"gcsChild"}, parent.windows)
+      assert.is_nil(Geyser.windowList.gcsChild)
+    end)
+
+    it("new2 marks the container as using add2", function()
+      local container = track(Geyser.Container:new2({name = "gcsAdd2", x = 0, y = 0, width = 50, height = 50}))
+      assert.is_true(container.useAdd2)
+      assert.is_false(container.hidden)
+      assert.is_false(container.auto_hidden)
+    end)
+
+    it("raises an error when the container argument is not a container", function()
+      local ok, message = pcall(function()
+        return Geyser.Container:new({name = "gcsBadParent"}, "notacontainer")
+      end)
+      assert.is_false(ok)
+      assert.is_truthy(tostring(message):find("add", 1, true))
+    end)
+  end)
+
+  describe("Geyser.calc_constraints and Geyser.set_constraints", function()
+    it("places a child at the pixel position it was given", function()
+      track(Geyser.Label:new({name = "gcsPixels", x = 12, y = 34, width = 120, height = 56}))
+      assert.are.same({x = 12, y = 34, width = 120, height = 56}, geometry("gcsPixels"))
+    end)
+
+    it("uses Geyser's defaults when no constraints are given", function()
+      track(Geyser.Label:new({name = "gcsDefaults"}))
+      assert.are.same({x = 10, y = 10, width = 300, height = 200}, geometry("gcsDefaults"))
+    end)
+
+    it("resolves percentages against the main window", function()
+      local mainWidth, mainHeight = getMainWindowSize()
+      track(Geyser.Label:new({name = "gcsPercent", x = "10%", y = "20%", width = "50%", height = "25%"}))
+      assert.are.same({
+        x = floor(0.1 * mainWidth),
+        y = floor(0.2 * mainHeight),
+        width = floor(0.5 * mainWidth),
+        height = floor(0.25 * mainHeight),
+      }, geometry("gcsPercent"))
+    end)
+
+    it("adds a pixel offset to a percentage constraint", function()
+      local mainWidth = getMainWindowSize()
+      track(Geyser.Label:new({name = "gcsOffset", x = "50%+10", y = 0, width = "10%-5", height = 20}))
+      local actual = geometry("gcsOffset")
+      assert.are.equal(floor(0.5 * mainWidth + 10), actual.x)
+      assert.are.equal(floor(0.1 * mainWidth - 5), actual.width)
+    end)
+
+    it("measures negative pixel constraints from the far edge", function()
+      local mainWidth, mainHeight = getMainWindowSize()
+      track(Geyser.Label:new({name = "gcsNegative", x = "-100px", y = "-50px", width = "100px", height = "50px"}))
+      assert.are.same({x = mainWidth - 100, y = mainHeight - 50, width = 100, height = 50}, geometry("gcsNegative"))
+    end)
+
+    it("scales character constraints with the font size", function()
+      local charWidth, charHeight = calcFontSize(9)
+      track(Geyser.Label:new({name = "gcsChars", x = 0, y = 0, width = "10c", height = "2c", fontSize = 9}))
+      local actual = geometry("gcsChars")
+      assert.are.equal(10 * charWidth, actual.width)
+      assert.are.equal(2 * charHeight, actual.height)
+    end)
+
+    it("resolves a child's percentages against its container, not the main window", function()
+      local container = track(Geyser.Container:new({name = "gcsBox", x = 100, y = 50, width = 400, height = 200}))
+      track(Geyser.Label:new({name = "gcsBoxChild", x = "50%", y = "50%", width = "50%", height = "50%"}, container))
+      assert.are.same({x = 300, y = 150, width = 200, height = 100}, geometry("gcsBoxChild"))
+    end)
+
+    it("resolves percentages through two levels of nesting", function()
+      local outer = track(Geyser.Container:new({name = "gcsOuter", x = 100, y = 50, width = 400, height = 200}))
+      local middle = track(Geyser.Container:new({name = "gcsMiddle", x = "50%", y = 0, width = "50%", height = "100%"}, outer))
+      track(Geyser.Label:new({name = "gcsLeaf", x = "50%", y = "50%", width = "50%", height = "50%"}, middle))
+      -- middle spans x 300..500, y 50..250, so the leaf starts halfway into it
+      assert.are.same({x = 400, y = 150, width = 100, height = 100}, geometry("gcsLeaf"))
+    end)
+  end)
+
+  describe("Geyser.Container:move and Geyser.Container:resize", function()
+    local container
+
+    before_each(function()
+      container = track(Geyser.Container:new({name = "gcsMover", x = 100, y = 50, width = 400, height = 200}))
+      track(Geyser.Label:new({name = "gcsMoverChild", x = "50%", y = "50%", width = "50%", height = "50%"}, container))
+    end)
+
+    it("drags the children of the container along", function()
+      container:move(200, 60)
+      assert.are.same({x = 400, y = 160, width = 200, height = 100}, geometry("gcsMoverChild"))
+    end)
+
+    it("re-resolves the size of percentage children", function()
+      container:resize(200, 100)
+      assert.are.same({x = 200, y = 100, width = 100, height = 50}, geometry("gcsMoverChild"))
+    end)
+
+    it("keeps the constraint that was passed as nil", function()
+      container:move(nil, 150)
+      -- numeric constraints are normalised to a pixel string as they are applied
+      assert.are.equal("100px", container.x)
+      assert.are.equal("150px", container.y)
+      container:resize(nil, 100)
+      assert.are.equal("400px", container.width)
+      assert.are.equal("100px", container.height)
+      assert.are.same({x = 300, y = 200, width = 200, height = 50}, geometry("gcsMoverChild"))
+    end)
+
+    it("moves a label to the pixels it was given", function()
+      local label = track(Geyser.Label:new({name = "gcsMoveLabel", x = 0, y = 0, width = 40, height = 20}))
+      label:move(70, 80)
+      label:resize(90, 30)
+      assert.are.same({x = 70, y = 80, width = 90, height = 30}, geometry("gcsMoveLabel"))
+    end)
+  end)
+
+  describe("Geyser.Container:hide, show, hide_impl and show_impl", function()
+    local container
+
+    before_each(function()
+      container = track(Geyser.Container:new({name = "gcsVisible", x = 0, y = 0, width = 100, height = 100}))
+      track(Geyser.Label:new({name = "gcsVisibleChild"}, container))
+    end)
+
+    it("hides and shows the widgets of its children", function()
+      assert.is_true(windowVisible("gcsVisibleChild"))
+      container:hide()
+      assert.is_false(windowVisible("gcsVisibleChild"))
+      container:show()
+      assert.is_true(windowVisible("gcsVisibleChild"))
+    end)
+
+    it("marks children hidden by their container as auto_hidden", function()
+      local child = container.windowList.gcsVisibleChild
+      container:hide()
+      assert.is_true(container.hidden)
+      assert.is_false(child.hidden)
+      assert.is_true(child.auto_hidden)
+      container:show()
+      assert.is_false(child.auto_hidden)
+    end)
+
+    it("refuses to show a child while its container is hidden", function()
+      local child = container.windowList.gcsVisibleChild
+      container:hide()
+      assert.is_false(child:show())
+      assert.is_false(windowVisible("gcsVisibleChild"))
+      -- the request is remembered, so the child reappears with its container
+      assert.is_false(child.hidden)
+      container:show()
+      assert.is_true(windowVisible("gcsVisibleChild"))
+    end)
+
+    it("hides and shows a label directly", function()
+      local label = track(Geyser.Label:new({name = "gcsSelfHide", x = 0, y = 0, width = 30, height = 30}))
+      label:hide()
+      assert.is_true(label.hidden)
+      assert.is_false(windowVisible("gcsSelfHide"))
+      label:show()
+      assert.is_false(label.hidden)
+      assert.is_true(windowVisible("gcsSelfHide"))
+    end)
+  end)
+
+  describe("Geyser.Container:raise, lower, raiseAll and lowerAll", function()
+    -- Mudlet exposes no z-order readback, so these assert the ordering Geyser
+    -- keeps in container.windows - the order it replays z-order changes from.
+    local container
+
+    before_each(function()
+      container = track(Geyser.Container:new({name = "gcsStack", x = 0, y = 0, width = 100, height = 100}))
+      track(Geyser.Label:new({name = "gcsStack1"}, container))
+      track(Geyser.Label:new({name = "gcsStack2"}, container))
+    end)
+
+    it("moves a raised window to the end of its container's ordering", function()
+      assert.are.same({"gcsStack1", "gcsStack2"}, container.windows)
+      container.windowList.gcsStack1:raise()
+      assert.are.same({"gcsStack2", "gcsStack1"}, container.windows)
+    end)
+
+    it("leaves the ordering alone when the topmost window is raised", function()
+      container.windowList.gcsStack2:raise()
+      assert.are.same({"gcsStack1", "gcsStack2"}, container.windows)
+    end)
+
+    it("moves a lowered window to the front of the ordering", function()
+      container.windowList.gcsStack2:lower()
+      assert.are.same({"gcsStack2", "gcsStack1"}, container.windows)
+    end)
+
+    it("leaves the ordering alone when the bottom window is lowered", function()
+      container.windowList.gcsStack1:lower()
+      assert.are.same({"gcsStack1", "gcsStack2"}, container.windows)
+    end)
+
+    it("keeps the relative order when raising or lowering the whole container", function()
+      container:raiseAll()
+      assert.are.same({"gcsStack1", "gcsStack2"}, container.windows)
+      assert.is_nil(Geyser.Container.windowTable)
+      container:lowerAll()
+      assert.are.same({"gcsStack1", "gcsStack2"}, container.windows)
+      assert.is_nil(Geyser.Container.windowTable)
+    end)
+  end)
+
+  describe("Geyser.Container:delete", function()
+    it("deletes the widgets of its children", function()
+      local container = Geyser.Container:new({name = "gcsDelete", x = 0, y = 0, width = 100, height = 100})
+      Geyser.Label:new({name = "gcsDeleteChild"}, container)
+      assert.is_not_nil(getWindowGeometry("gcsDeleteChild"))
+      container:delete()
+      assert.is_nil(getWindowGeometry("gcsDeleteChild"))
+      assert.are.same({}, container.windowList)
+      assert.are.same({}, container.windows)
+    end)
+
+    it("unregisters a top level container from the root Geyser lists", function()
+      local container = Geyser.Container:new({name = "gcsDeleteRoot", x = 0, y = 0, width = 10, height = 10})
+      container:delete()
+      assert.is_nil(Geyser.windowList.gcsDeleteRoot)
+      assert.is_nil(table.index_of(Geyser.windows, "gcsDeleteRoot"))
+    end)
+
+    it("unregisters a child from its parent", function()
+      local container = track(Geyser.Container:new({name = "gcsDeleteParent", x = 0, y = 0, width = 100, height = 100}))
+      local child = Geyser.Label:new({name = "gcsDeleteMe"}, container)
+      child:delete()
+      assert.is_nil(container.windowList.gcsDeleteMe)
+      assert.are.same({}, container.windows)
+      assert.is_nil(getWindowGeometry("gcsDeleteMe"))
+    end)
+  end)
+
+  describe("Geyser.Container:setFontSize", function()
+    it("rejects a font size that is not a number", function()
+      local container = track(Geyser.Container:new({name = "gcsFont", x = 0, y = 0, width = 100, height = 100}))
+      local ok, message = pcall(function() container:setFontSize("nope") end)
+      assert.is_false(ok)
+      assert.is_truthy(tostring(message):find("fontSize must be a number", 1, true))
+      assert.are.equal(8, container.fontSize)
+    end)
+
+    it("re-resolves character sized constraints for its children", function()
+      local container = track(Geyser.Container:new({name = "gcsFontBox", x = 0, y = 0, width = "20c", height = "4c", fontSize = 8}))
+      track(Geyser.Label:new({name = "gcsFontChild", x = 0, y = 0, width = "100%", height = "100%"}, container))
+      local smallWidth, smallHeight = calcFontSize(8)
+      assert.are.same({x = 0, y = 0, width = 20 * smallWidth, height = 4 * smallHeight}, geometry("gcsFontChild"))
+      container:setFontSize(16)
+      local bigWidth, bigHeight = calcFontSize(16)
+      assert.are.equal(16, container.fontSize)
+      assert.are.same({x = 0, y = 0, width = 20 * bigWidth, height = 4 * bigHeight}, geometry("gcsFontChild"))
+    end)
+  end)
+
+  describe("Geyser.Container:calculate_dynamic_window_size", function()
+    it("returns the full size when the container holds at most one window", function()
+      local container = track(Geyser.Container:new({name = "gcsDyn1", x = 0, y = 0, width = 300, height = 200}))
+      assert.are.same({width = 300, height = 200}, container:calculate_dynamic_window_size())
+      track(Geyser.Label:new({name = "gcsDyn1Child"}, container))
+      assert.are.same({width = 300, height = 200}, container:calculate_dynamic_window_size())
+    end)
+
+    it("splits the space between dynamic windows", function()
+      local container = track(Geyser.Container:new({name = "gcsDyn2", x = 0, y = 0, width = 300, height = 200}))
+      track(Geyser.Label:new({name = "gcsDyn2A"}, container))
+      track(Geyser.Label:new({name = "gcsDyn2B"}, container))
+      assert.are.same({width = 150, height = 100}, container:calculate_dynamic_window_size())
+    end)
+
+    it("leaves fixed windows out of the split", function()
+      local container = track(Geyser.Container:new({name = "gcsDyn3", x = 0, y = 0, width = 300, height = 200}))
+      track(Geyser.Label:new({
+        name = "gcsDyn3Fixed",
+        width = 100,
+        height = 50,
+        h_policy = Geyser.Fixed,
+        v_policy = Geyser.Fixed,
+      }, container))
+      track(Geyser.Label:new({name = "gcsDyn3Dynamic"}, container))
+      assert.are.same({width = 200, height = 150}, container:calculate_dynamic_window_size())
+    end)
+
+    it("accounts for a stretch factor", function()
+      local container = track(Geyser.Container:new({name = "gcsDyn4", x = 0, y = 0, width = 400, height = 400}))
+      track(Geyser.Label:new({name = "gcsDyn4A", v_stretch_factor = 3}, container))
+      track(Geyser.Label:new({name = "gcsDyn4B"}, container))
+      -- the stretch factor counts as three shares against one, so a share is a quarter
+      assert.are.equal(100, container:calculate_dynamic_window_size().height)
+    end)
+  end)
+
+  describe("Geyser.Container:flash", function()
+    it("puts a flash label over the container's geometry", function()
+      local container = track(Geyser.Container:new({name = "gcsFlash", x = 20, y = 30, width = 80, height = 40}))
+      container:flash(0.1)
+      assert.are.same({x = 20, y = 30, width = 80, height = 40}, geometry("gcsFlash_dimensions_flash"))
+      assert.is_true(windowVisible("gcsFlash_dimensions_flash"))
+      -- the flash label belongs to no Geyser container, so remove it by hand
+      deleteLabel("gcsFlash_dimensions_flash")
+    end)
+
+    it("creates nothing when told not to flash", function()
+      local container = track(Geyser.Container:new({name = "gcsNoFlash", x = 20, y = 30, width = 80, height = 40}))
+      container:flash(0.1, false)
+      assert.is_nil(getWindowGeometry("gcsNoFlash_dimensions_flash"))
+    end)
+  end)
+
+  describe("Geyser:add, Geyser:base_add and Geyser:add2", function()
+    it("tracks an added window once, even when it is added twice", function()
+      local container = track(Geyser.Container:new({name = "gcsAdd", x = 0, y = 0, width = 100, height = 100}))
+      local label = track(Geyser.Label:new({name = "gcsAdded"}, container))
+      container:add(label)
+      assert.are.same({"gcsAdded"}, container.windows)
+      assert.are.equal(label, container.windowList.gcsAdded)
+    end)
+
+    it("takes a window away from its previous container", function()
+      local first = track(Geyser.Container:new({name = "gcsAddFrom", x = 0, y = 0, width = 100, height = 100}))
+      local second = track(Geyser.Container:new({name = "gcsAddTo", x = 200, y = 0, width = 100, height = 100}))
+      local label = track(Geyser.Label:new({name = "gcsAddMoved", x = 0, y = 0, width = "100%", height = "100%"}, first))
+      second:add(label)
+      assert.is_nil(first.windowList.gcsAddMoved)
+      assert.are.same({}, first.windows)
+      assert.are.equal(label, second.windowList.gcsAddMoved)
+      assert.are.equal(200, geometry("gcsAddMoved").x)
+    end)
+
+    it("keeps a new child of a hidden add2 container hidden", function()
+      local container = track(Geyser.Container:new2({name = "gcsAdd2Box", x = 0, y = 0, width = 100, height = 100}))
+      container:hide()
+      local label = track(Geyser.Label:new2({name = "gcsAdd2Child"}, container))
+      assert.is_true(label.auto_hidden)
+      assert.is_false(windowVisible("gcsAdd2Child"))
+      container:show()
+      assert.is_true(windowVisible("gcsAdd2Child"))
+    end)
+  end)
+
+  describe("Geyser:remove", function()
+    it("drops the window from both of the container's lists", function()
+      local container = track(Geyser.Container:new({name = "gcsRemove", x = 0, y = 0, width = 100, height = 100}))
+      local label = track(Geyser.Label:new({name = "gcsRemoved"}, container))
+      container:remove(label)
+      assert.is_nil(container.windowList.gcsRemoved)
+      assert.are.same({}, container.windows)
+      -- removing only unhooks the bookkeeping, the widget stays alive
+      assert.is_not_nil(getWindowGeometry("gcsRemoved"))
+      deleteLabel("gcsRemoved")
+    end)
+  end)
+
+  describe("Geyser:changeContainer", function()
+    local from, to
+
+    before_each(function()
+      from = track(Geyser.Container:new({name = "gcsFrom", x = 0, y = 0, width = 200, height = 200}))
+      to = track(Geyser.Container:new({name = "gcsTo", x = 300, y = 100, width = 200, height = 200}))
+    end)
+
+    it("re-resolves the window's constraints against its new container", function()
+      local label = track(Geyser.Label:new({name = "gcsChanging", x = "50%", y = "50%", width = "50%", height = "50%"}, from))
+      assert.are.same({x = 100, y = 100, width = 100, height = 100}, geometry("gcsChanging"))
+      label:changeContainer(to)
+      assert.are.equal(to, label.container)
+      assert.is_nil(from.windowList.gcsChanging)
+      assert.are.same({x = 400, y = 200, width = 100, height = 100}, geometry("gcsChanging"))
+    end)
+
+    it("returns nil and a message when the window is already in that container", function()
+      local label = track(Geyser.Label:new({name = "gcsSameContainer"}, from))
+      local result, message = label:changeContainer(from)
+      assert.is_nil(result)
+      assert.is_truthy(message:find("already in this container", 1, true))
+    end)
+
+    it("returns nil and a message for something that is not a container", function()
+      local label = track(Geyser.Label:new({name = "gcsBadContainer"}, from))
+      local result, message = label:changeContainer("notacontainer")
+      assert.is_nil(result)
+      assert.are.equal("didn't get a valid container", message)
+      assert.are.equal(from, label.container)
+      local nilResult, nilMessage = label:changeContainer(nil)
+      assert.is_nil(nilResult)
+      assert.are.equal("didn't get a valid container", nilMessage)
+    end)
+
+    it("refuses to put a container inside itself", function()
+      local result, message = from:changeContainer(from)
+      assert.is_nil(result)
+      assert.are.equal("didn't get a valid container", message)
+    end)
+
+    it("moves a window back to the root window when passed \"main\"", function()
+      local label = track(Geyser.Label:new({name = "gcsBackToMain", x = "50%", y = 0, width = 10, height = 10}, from))
+      label:changeContainer("main")
+      assert.are.equal(Geyser, label.container)
+      assert.are.equal(floor(0.5 * getMainWindowSize()), geometry("gcsBackToMain").x)
+    end)
+  end)
+
+  describe("Geyser:begin_update, Geyser:end_update and Geyser:reposition", function()
+    it("toggles the deferred update flag", function()
+      Geyser:begin_update()
+      assert.is_true(Geyser.defer_updates)
+      Geyser:end_update()
+      assert.is_false(Geyser.defer_updates)
+    end)
+  end)
+
+  describe("GeyserReposition", function()
+    it("restores geometry that was changed behind Geyser's back", function()
+      local mainWidth, mainHeight = getMainWindowSize()
+      track(Geyser.Label:new({name = "gcsReposition", x = 10, y = 10, width = 100, height = 50}))
+      moveWindow("gcsReposition", 400, 400)
+      resizeWindow("gcsReposition", 20, 20)
+      assert.are.same({x = 400, y = 400, width = 20, height = 20}, geometry("gcsReposition"))
+      GeyserReposition("sysWindowResizeEvent", mainWidth, mainHeight)
+      assert.are.same({x = 10, y = 10, width = 100, height = 50}, geometry("gcsReposition"))
+    end)
+
+    it("ignores events that are not window resizes", function()
+      track(Geyser.Label:new({name = "gcsNoReposition", x = 10, y = 10, width = 100, height = 50}))
+      moveWindow("gcsNoReposition", 300, 300)
+      GeyserReposition("sysSomeOtherEvent", 100, 100)
+      assert.are.equal(300, geometry("gcsNoReposition").x)
+    end)
+  end)
+
+  describe("Geyser.nameGen", function()
+    it("hands out a new name every time", function()
+      local first = Geyser.nameGen()
+      local second = Geyser.nameGen()
+      assert.are_not.equal(first, second)
+      assert.is_truthy(first:find("^anon_window_%d+$"))
+    end)
+
+    it("uses the type it is given in the name", function()
+      assert.is_truthy(Geyser.nameGen("gauge"):find("^anon_gauge_%d+$"))
+    end)
+  end)
+
+  describe("Geyser.copyTable", function()
+    it("copies the entries of a table", function()
+      local source = {name = "x", width = "10px"}
+      local copy = Geyser.copyTable(source)
+      assert.are.same(source, copy)
+      copy.name = "y"
+      assert.are.equal("x", source.name)
+    end)
+
+    it("shares nested tables that do not ask to be cloned", function()
+      local nested = {1, 2}
+      local copy = Geyser.copyTable({nested = nested})
+      assert.are.equal(nested, copy.nested)
+    end)
+
+    it("clones a nested table that provides __clone", function()
+      local nested = {__clone = function() return {cloned = true} end}
+      local copy = Geyser.copyTable({nested = nested})
+      assert.are_not.equal(nested, copy.nested)
+      assert.is_true(copy.nested.cloned)
+    end)
+
+    it("returns an empty table for nil", function()
+      assert.are.same({}, Geyser.copyTable(nil))
+    end)
+  end)
+
+  describe("Geyser.hideAll and Geyser.showAll", function()
+    it("only touches windows of the type it is given", function()
+      -- a private type keeps the sweep away from widgets other specs own
+      local mine = track(Geyser.Container:new({name = "gcsSweep", type = "gcsprobe", x = 0, y = 0, width = 50, height = 50}))
+      track(Geyser.Label:new({name = "gcsSweepChild"}, mine))
+      track(Geyser.Label:new({name = "gcsUnswept", x = 0, y = 0, width = 20, height = 20}))
+      Geyser.hideAll("gcsprobe")
+      assert.is_false(windowVisible("gcsSweepChild"))
+      assert.is_true(windowVisible("gcsUnswept"))
+      Geyser.showAll("gcsprobe")
+      assert.is_true(windowVisible("gcsSweepChild"))
+      assert.is_true(windowVisible("gcsUnswept"))
+      assert.is_not_nil(mine.windowList.gcsSweepChild)
+    end)
+  end)
+
+  describe("Geyser reuses a name that is already taken", function()
+    it("replaces the tracked window without duplicating the ordering entry", function()
+      local first = track(Geyser.Label:new({name = "gcsDuplicate", x = 0, y = 0, width = 30, height = 30}))
+      local windowCount = #Geyser.windows
+      local second = track(Geyser.Label:new({name = "gcsDuplicate", x = 5, y = 5, width = 60, height = 60}))
+      assert.are.equal(windowCount, #Geyser.windows)
+      assert.are.equal(second, Geyser.windowList.gcsDuplicate)
+      assert.are.same({x = 5, y = 5, width = 60, height = 60}, geometry("gcsDuplicate"))
+      -- both objects drive the same widget, which is why reusing a name is a trap
+      first:move(11, 12)
+      assert.are.same({x = 11, y = 12, width = 30, height = 30}, geometry("gcsDuplicate"))
+    end)
+  end)
+end)
diff --git a/src/mudlet-lua/tests/GeyserGauge_spec.lua b/src/mudlet-lua/tests/GeyserGauge_spec.lua
new file mode 100644
index 000000000..a27c01826
--- /dev/null
+++ b/src/mudlet-lua/tests/GeyserGauge_spec.lua
@@ -0,0 +1,289 @@
+-- A gauge is a container holding three labels: back (the full size backdrop),
+-- front (the part that shrinks with the value) and text (the caption). Only
+-- the front label changes geometry, so that is where setValue is measured.
+local function geometry(name)
+  local x, y, width, height = getWindowGeometry(name)
+  return {x = x, y = y, width = width, height = height}
+end
+
+describe("Tests functionality of Geyser.Gauge", function()
+  local created
+
+  local function track(object)
+    created[#created + 1] = object
+    return object
+  end
+
+  local function alive(object)
+    if not object or not object.container or not object.container.windowList then
+      return false
+    end
+    return object.container.windowList[object.name] == object
+  end
+
+  before_each(function()
+    created = {}
+  end)
+
+  after_each(function()
+    for _, object in ipairs(created) do
+      if alive(object) then
+        object:delete()
+      end
+    end
+    created = {}
+  end)
+
+  describe("Geyser.Gauge:new and Geyser.Gauge:new2", function()
+    it("builds a back, front and text label over the gauge's geometry", function()
+      local gauge = track(Geyser.Gauge:new({name = "ggsNew", x = 10, y = 20, width = 200, height = 40}))
+      assert.are.equal("gauge", gauge.type)
+      assert.are.equal(100, gauge.value)
+      assert.are.same({"ggsNew_back", "ggsNew_front", "ggsNew_text"}, gauge.windows)
+      for _, name in ipairs({"ggsNew_back", "ggsNew_front", "ggsNew_text"}) do
+        assert.are.equal("label", windowType(name))
+        assert.are.same({x = 10, y = 20, width = 200, height = 40}, geometry(name))
+      end
+      -- the gauge itself is a container, so it has no widget
+      assert.is_nil(getWindowGeometry("ggsNew"))
+    end)
+
+    it("defaults to a horizontal, non strict gauge", function()
+      local gauge = track(Geyser.Gauge:new({name = "ggsDefaults", x = 0, y = 0, width = 100, height = 20}))
+      assert.are.equal("horizontal", gauge.orientation)
+      assert.is_false(gauge.strict)
+    end)
+
+    it("echoes the message constraint onto the text label", function()
+      track(Geyser.Gauge:new({name = "ggsMessage", x = 0, y = 0, width = 100, height = 20, message = "50%"}))
+      assert.is_truthy(getLabelText("ggsMessage_text"):find("50%%"))
+    end)
+
+    it("new2 marks the gauge as using add2", function()
+      local gauge = track(Geyser.Gauge:new2({name = "ggsNew2", x = 0, y = 0, width = 100, height = 20}))
+      assert.is_true(gauge.useAdd2)
+      assert.are.equal("gauge", gauge.type)
+    end)
+  end)
+
+  describe("Geyser.Gauge:setValue", function()
+    local gauge
+
+    before_each(function()
+      gauge = track(Geyser.Gauge:new({name = "ggsValue", x = 0, y = 0, width = 200, height = 40}))
+    end)
+
+    it("sizes the front label to the percentage given", function()
+      gauge:setValue(25)
+      assert.are.equal(25, gauge.value)
+      assert.are.same({x = 0, y = 0, width = 50, height = 40}, geometry("ggsValue_front"))
+      gauge:setValue(75)
+      assert.are.equal(150, geometry("ggsValue_front").width)
+    end)
+
+    it("treats a second argument as the maximum", function()
+      gauge:setValue(50, 200)
+      assert.are.equal(25, gauge.value)
+      assert.are.equal(50, geometry("ggsValue_front").width)
+    end)
+
+    it("leaves the back label at full size", function()
+      gauge:setValue(10)
+      assert.are.same({x = 0, y = 0, width = 200, height = 40}, geometry("ggsValue_back"))
+      assert.are.same({x = 0, y = 0, width = 200, height = 40}, geometry("ggsValue_text"))
+    end)
+
+    it("clamps a negative value to empty", function()
+      gauge:setValue(-20)
+      assert.are.equal(0, gauge.value)
+      assert.are.equal(0, geometry("ggsValue_front").width)
+    end)
+
+    it("lets the front overflow past the back unless the gauge is strict", function()
+      gauge:setValue(150)
+      assert.are.equal(150, gauge.value)
+      assert.are.equal(300, geometry("ggsValue_front").width)
+    end)
+
+    it("caps a strict gauge at its own width", function()
+      local strict = track(Geyser.Gauge:new({name = "ggsStrict", x = 0, y = 0, width = 200, height = 40, strict = true}))
+      strict:setValue(150)
+      assert.are.equal(100, strict.value)
+      assert.are.equal(200, geometry("ggsStrict_front").width)
+    end)
+
+    it("writes the optional third argument onto the text label", function()
+      gauge:setValue(40, 100, "40 of 100")
+      assert.is_truthy(getLabelText("ggsValue_text"):find("40 of 100", 1, true))
+    end)
+
+    it("rejects a value that is not a number", function()
+      local ok, message = pcall(function() gauge:setValue("x") end)
+      assert.is_false(ok)
+      assert.is_truthy(tostring(message):find("currentValue as number expected, got string", 1, true))
+    end)
+
+    it("rejects a maximum that is not a number", function()
+      local ok, message = pcall(function() gauge:setValue(5, "y") end)
+      assert.is_false(ok)
+      assert.is_truthy(tostring(message):find("maxValue as number expected, got string", 1, true))
+    end)
+  end)
+
+  describe("Geyser.Gauge orientations", function()
+    it("fills a vertical gauge from the bottom", function()
+      local gauge = track(Geyser.Gauge:new({name = "ggsVertical", x = 0, y = 0, width = 100, height = 200, orientation = "vertical"}))
+      gauge:setValue(25)
+      assert.are.same({x = 0, y = 150, width = 100, height = 50}, geometry("ggsVertical_front"))
+      assert.are.same({x = 0, y = 0, width = 100, height = 200}, geometry("ggsVertical_back"))
+    end)
+
+    it("fills a goofy gauge from the right", function()
+      local gauge = track(Geyser.Gauge:new({name = "ggsGoofy", x = 0, y = 0, width = 200, height = 40, orientation = "goofy"}))
+      gauge:setValue(25)
+      assert.are.same({x = 150, y = 0, width = 50, height = 40}, geometry("ggsGoofy_front"))
+    end)
+
+    it("fills a batty gauge from the top", function()
+      local gauge = track(Geyser.Gauge:new({name = "ggsBatty", x = 0, y = 0, width = 100, height = 200, orientation = "batty"}))
+      gauge:setValue(25)
+      assert.are.same({x = 0, y = 0, width = 100, height = 50}, geometry("ggsBatty_front"))
+    end)
+  end)
+
+  describe("Geyser.Gauge:setStyleSheet", function()
+    it("keeps the front label inside the back label's margins", function()
+      local gauge = track(Geyser.Gauge:new({name = "ggsMargin", x = 0, y = 0, width = 200, height = 40}))
+      gauge:setStyleSheet("margin: 5px; background-color: red;", "margin: 5px; background-color: blue;")
+      assert.are.same({x = 0, y = 0, width = 200, height = 40}, geometry("ggsMargin_back"))
+      assert.are.same({x = 5, y = 5, width = 190, height = 30}, geometry("ggsMargin_front"))
+    end)
+
+    it("strips the margin from the front stylesheet but not the back", function()
+      local gauge = track(Geyser.Gauge:new({name = "ggsCss", x = 0, y = 0, width = 200, height = 40}))
+      gauge:setStyleSheet("margin: 5px; background-color: red;", "margin: 5px; background-color: blue;")
+      assert.is_nil(getLabelStyleSheet("ggsCss_front"):find("margin", 1, true))
+      assert.is_truthy(getLabelStyleSheet("ggsCss_front"):find("background-color: red;", 1, true))
+      assert.is_truthy(getLabelStyleSheet("ggsCss_back"):find("margin: 5px;", 1, true))
+      assert.are.equal("margin: 5px; background-color: blue;", gauge.backCSS)
+    end)
+
+    it("uses the front stylesheet for the back when only one is given", function()
+      local gauge = track(Geyser.Gauge:new({name = "ggsOneCss", x = 0, y = 0, width = 100, height = 20}))
+      gauge:setStyleSheet("background-color: green;")
+      assert.are.equal("background-color: green;", gauge.backCSS)
+      assert.are.equal("background-color: green;", getLabelStyleSheet("ggsOneCss_back"))
+    end)
+
+    it("applies a text stylesheet when one is given", function()
+      local gauge = track(Geyser.Gauge:new({name = "ggsTextCss", x = 0, y = 0, width = 100, height = 20}))
+      gauge:setStyleSheet("background-color: green;", nil, "color: white;")
+      assert.are.equal("color: white;", getLabelStyleSheet("ggsTextCss_text"))
+    end)
+
+    it("keeps the current value when the stylesheet changes", function()
+      local gauge = track(Geyser.Gauge:new({name = "ggsCssValue", x = 0, y = 0, width = 200, height = 40}))
+      gauge:setValue(50)
+      gauge:setStyleSheet("background-color: red;")
+      assert.are.equal(50, gauge.value)
+      assert.are.equal(100, geometry("ggsCssValue_front").width)
+    end)
+  end)
+
+  describe("Geyser.Gauge text", function()
+    local gauge
+
+    before_each(function()
+      gauge = track(Geyser.Gauge:new({name = "ggsText", x = 0, y = 0, width = 200, height = 40}))
+    end)
+
+    it("writes setText onto the text label", function()
+      gauge:setText("hello gauge")
+      assert.is_truthy(getLabelText("ggsText_text"):find("hello gauge", 1, true))
+    end)
+
+    it("echoes with a colour", function()
+      gauge:echo("colored", "red")
+      local text = getLabelText("ggsText_text")
+      assert.is_truthy(text:find("colored", 1, true))
+      assert.is_truthy(text:find("color: #ff0000", 1, true))
+    end)
+
+    it("mirrors the text label's format state back onto the gauge", function()
+      gauge:setBold(true)
+      gauge:setItalics(true)
+      gauge:setUnderline(true)
+      gauge:setStrikethrough(true)
+      gauge:setText("styled")
+      local text = getLabelText("ggsText_text")
+      assert.is_truthy(text:find("", 1, true))
+      assert.is_truthy(text:find("", 1, true))
+      assert.is_truthy(text:find("", 1, true))
+      assert.is_truthy(text:find("", 1, true))
+      assert.are.equal(gauge.text.format, gauge.format)
+      assert.is_true(gauge.formatTable.bold)
+    end)
+
+    it("sets the font size of the text label", function()
+      gauge:setFontSize(18)
+      gauge:setText("bigger")
+      assert.is_truthy(getLabelText("ggsText_text"):find("font%-size: 18pt"))
+    end)
+
+    it("aligns the text label", function()
+      gauge:setAlignment("center")
+      gauge:setText("middle")
+      assert.is_truthy(getLabelText("ggsText_text"):find('align="center"', 1, true))
+    end)
+
+    it("sets the text colour", function()
+      gauge:setFgColor("#00ff00")
+      gauge:setText("green")
+      assert.is_truthy(getLabelText("ggsText_text"):find("color: #00ff00", 1, true))
+    end)
+  end)
+
+  describe("Geyser.Gauge geometry and visibility", function()
+    it("moves and resizes all three labels", function()
+      local gauge = track(Geyser.Gauge:new({name = "ggsMove", x = 0, y = 0, width = 200, height = 40}))
+      gauge:setValue(50)
+      gauge:move(60, 70)
+      gauge:resize(100, 20)
+      assert.are.same({x = 60, y = 70, width = 100, height = 20}, geometry("ggsMove_back"))
+      assert.are.same({x = 60, y = 70, width = 100, height = 20}, geometry("ggsMove_text"))
+      -- the front label keeps its share of the new size
+      assert.are.same({x = 60, y = 70, width = 50, height = 20}, geometry("ggsMove_front"))
+    end)
+
+    it("hides and shows all three labels", function()
+      local gauge = track(Geyser.Gauge:new({name = "ggsHide", x = 0, y = 0, width = 100, height = 20}))
+      gauge:hide()
+      for _, name in ipairs({"ggsHide_back", "ggsHide_front", "ggsHide_text"}) do
+        assert.is_false(windowVisible(name))
+      end
+      gauge:show()
+      for _, name in ipairs({"ggsHide_back", "ggsHide_front", "ggsHide_text"}) do
+        assert.is_true(windowVisible(name))
+      end
+    end)
+
+    it("sizes a percentage gauge against its container", function()
+      local container = track(Geyser.Container:new({name = "ggsBox", x = 100, y = 100, width = 400, height = 100}))
+      local gauge = track(Geyser.Gauge:new({name = "ggsInBox", x = 0, y = 0, width = "50%", height = "100%"}, container))
+      gauge:setValue(50)
+      assert.are.same({x = 100, y = 100, width = 200, height = 100}, geometry("ggsInBox_back"))
+      assert.are.same({x = 100, y = 100, width = 100, height = 100}, geometry("ggsInBox_front"))
+    end)
+  end)
+
+  describe("Geyser.Gauge:type_delete", function()
+    it("deletes the back, front and text labels with the gauge", function()
+      local gauge = Geyser.Gauge:new({name = "ggsDelete", x = 0, y = 0, width = 100, height = 20})
+      gauge:delete()
+      for _, name in ipairs({"ggsDelete_back", "ggsDelete_front", "ggsDelete_text"}) do
+        assert.is_nil(getWindowGeometry(name))
+      end
+      assert.is_nil(Geyser.windowList.ggsDelete)
+    end)
+  end)
+end)
diff --git a/src/mudlet-lua/tests/GeyserHBox_spec.lua b/src/mudlet-lua/tests/GeyserHBox_spec.lua
new file mode 100644
index 000000000..71bc647f8
--- /dev/null
+++ b/src/mudlet-lua/tests/GeyserHBox_spec.lua
@@ -0,0 +1,143 @@
+-- An HBox lays its children out left to right by rewriting their constraints
+-- as percentages of the box, so the pixel expectations below are the box
+-- geometry divided by the shares each child is entitled to.
+local function geometry(name)
+  local x, y, width, height = getWindowGeometry(name)
+  return {x = x, y = y, width = width, height = height}
+end
+
+describe("Tests functionality of Geyser.HBox", function()
+  local created
+
+  local function track(object)
+    created[#created + 1] = object
+    return object
+  end
+
+  local function alive(object)
+    if not object or not object.container or not object.container.windowList then
+      return false
+    end
+    return object.container.windowList[object.name] == object
+  end
+
+  before_each(function()
+    created = {}
+  end)
+
+  after_each(function()
+    for _, object in ipairs(created) do
+      if alive(object) then
+        object:delete()
+      end
+    end
+    created = {}
+  end)
+
+  describe("Geyser.HBox:new and Geyser.HBox:new2", function()
+    it("defaults the type to hbox and starts empty", function()
+      local box = track(Geyser.HBox:new({name = "ghbNew", x = 0, y = 0, width = 100, height = 100}))
+      assert.are.equal("hbox", box.type)
+      assert.are.same({}, box.windows)
+      assert.is_nil(getWindowGeometry("ghbNew"))
+    end)
+
+    it("new2 marks the box as using add2", function()
+      local box = track(Geyser.HBox:new2({name = "ghbNew2", x = 0, y = 0, width = 100, height = 100}))
+      assert.is_true(box.useAdd2)
+      assert.are.equal("hbox", box.type)
+    end)
+  end)
+
+  describe("Geyser.HBox:add and Geyser.HBox:organize", function()
+    it("gives a single child the whole box", function()
+      local box = track(Geyser.HBox:new({name = "ghbOne", x = 10, y = 20, width = 200, height = 100}))
+      track(Geyser.Label:new({name = "ghbOneChild"}, box))
+      assert.are.same({x = 10, y = 20, width = 200, height = 100}, geometry("ghbOneChild"))
+    end)
+
+    it("splits the box evenly between two children", function()
+      local box = track(Geyser.HBox:new({name = "ghbTwo", x = 0, y = 300, width = 200, height = 100}))
+      track(Geyser.Label:new({name = "ghbTwoA"}, box))
+      track(Geyser.Label:new({name = "ghbTwoB"}, box))
+      assert.are.same({x = 0, y = 300, width = 100, height = 100}, geometry("ghbTwoA"))
+      assert.are.same({x = 100, y = 300, width = 100, height = 100}, geometry("ghbTwoB"))
+    end)
+
+    it("re-splits the box when another child is added", function()
+      local box = track(Geyser.HBox:new({name = "ghbFour", x = 0, y = 0, width = 400, height = 40}))
+      track(Geyser.Label:new({name = "ghbFourA"}, box))
+      track(Geyser.Label:new({name = "ghbFourB"}, box))
+      assert.are.equal(200, geometry("ghbFourA").width)
+      track(Geyser.Label:new({name = "ghbFourC"}, box))
+      track(Geyser.Label:new({name = "ghbFourD"}, box))
+      for index, name in ipairs({"ghbFourA", "ghbFourB", "ghbFourC", "ghbFourD"}) do
+        assert.are.same({x = (index - 1) * 100, y = 0, width = 100, height = 40}, geometry(name))
+      end
+    end)
+
+    it("stretches children over the full height of the box", function()
+      local box = track(Geyser.HBox:new({name = "ghbTall", x = 0, y = 0, width = 200, height = 120}))
+      track(Geyser.Label:new({name = "ghbTallChild", height = 20}, box))
+      assert.are.equal("100%", box.windowList.ghbTallChild.height)
+      assert.are.equal(120, geometry("ghbTallChild").height)
+    end)
+
+    it("keeps a fixed width child at its size and gives the rest away", function()
+      local box = track(Geyser.HBox:new({name = "ghbFixed", x = 0, y = 0, width = 300, height = 60}))
+      track(Geyser.Label:new({name = "ghbFixedChild", width = 100, h_policy = Geyser.Fixed}, box))
+      track(Geyser.Label:new({name = "ghbDynamic"}, box))
+      assert.is_true(box.contains_fixed)
+      assert.are.same({x = 0, y = 0, width = 100, height = 60}, geometry("ghbFixedChild"))
+      local dynamic = geometry("ghbDynamic")
+      assert.are.equal(200, dynamic.width)
+      -- the dynamic child starts where the fixed one ends, up to the pixel the
+      -- percentage of a third loses to truncation
+      assert.is_true(dynamic.x == 99 or dynamic.x == 100, "unexpected x " .. tostring(dynamic.x))
+    end)
+
+    it("gives a stretch factor its extra share of the width", function()
+      local box = track(Geyser.HBox:new({name = "ghbStretch", x = 0, y = 0, width = 400, height = 100}))
+      track(Geyser.Label:new({name = "ghbStretchA", h_stretch_factor = 3}, box))
+      track(Geyser.Label:new({name = "ghbStretchB"}, box))
+      assert.are.same({x = 0, y = 0, width = 300, height = 100}, geometry("ghbStretchA"))
+      assert.are.same({x = 300, y = 0, width = 100, height = 100}, geometry("ghbStretchB"))
+    end)
+  end)
+
+  describe("Geyser.HBox:reposition", function()
+    local box
+
+    before_each(function()
+      box = track(Geyser.HBox:new({name = "ghbMove", x = 10, y = 20, width = 200, height = 100}))
+      track(Geyser.Label:new({name = "ghbMoveA"}, box))
+      track(Geyser.Label:new({name = "ghbMoveB"}, box))
+    end)
+
+    it("drags the row along when the box moves", function()
+      box:move(50, 60)
+      assert.are.same({x = 50, y = 60, width = 100, height = 100}, geometry("ghbMoveA"))
+      assert.are.same({x = 150, y = 60, width = 100, height = 100}, geometry("ghbMoveB"))
+    end)
+
+    it("re-splits the row when the box is resized", function()
+      box:resize(100, 50)
+      assert.are.same({x = 10, y = 20, width = 50, height = 50}, geometry("ghbMoveA"))
+      assert.are.same({x = 60, y = 20, width = 50, height = 50}, geometry("ghbMoveB"))
+    end)
+  end)
+
+  describe("Geyser.HBox visibility", function()
+    it("hides and shows the whole row", function()
+      local box = track(Geyser.HBox:new({name = "ghbHide", x = 0, y = 0, width = 100, height = 100}))
+      track(Geyser.Label:new({name = "ghbHideA"}, box))
+      track(Geyser.Label:new({name = "ghbHideB"}, box))
+      box:hide()
+      assert.is_false(windowVisible("ghbHideA"))
+      assert.is_false(windowVisible("ghbHideB"))
+      box:show()
+      assert.is_true(windowVisible("ghbHideA"))
+      assert.is_true(windowVisible("ghbHideB"))
+    end)
+  end)
+end)
diff --git a/src/mudlet-lua/tests/GeyserLabel_spec.lua b/src/mudlet-lua/tests/GeyserLabel_spec.lua
index d2e10ee3c..a7e2b43bc 100644
--- a/src/mudlet-lua/tests/GeyserLabel_spec.lua
+++ b/src/mudlet-lua/tests/GeyserLabel_spec.lua
@@ -106,3 +106,350 @@ describe("Tests functionality of Geyser.Label", function()
     end)
   end)
 end)
+
+-- Geometry, visibility and text readback for Geyser.Label, asserted against
+-- the widget itself through getWindowGeometry/windowVisible/getLabelText
+-- rather than by spying on the echo call.
+describe("Geyser.Label widget state", function()
+  local created
+
+  local function geometry(name)
+    local x, y, width, height = getWindowGeometry(name)
+    return {x = x, y = y, width = width, height = height}
+  end
+
+  local function track(object)
+    created[#created + 1] = object
+    return object
+  end
+
+  local function alive(object)
+    if not object or not object.container or not object.container.windowList then
+      return false
+    end
+    return object.container.windowList[object.name] == object
+  end
+
+  before_each(function()
+    created = {}
+  end)
+
+  after_each(function()
+    for _, object in ipairs(created) do
+      if alive(object) then
+        object:delete()
+      end
+    end
+    created = {}
+  end)
+
+  describe("Geyser.Label:new and Geyser.Label:new2", function()
+    it("creates a visible label widget at the constrained geometry", function()
+      local label = track(Geyser.Label:new({name = "glsNew", x = 15, y = 25, width = 120, height = 40}))
+      assert.are.equal("label", label.type)
+      assert.are.equal("label", windowType("glsNew"))
+      assert.are.same({x = 15, y = 25, width = 120, height = 40}, geometry("glsNew"))
+      assert.is_true(windowVisible("glsNew"))
+      assert.are.equal("main", label.windowname)
+    end)
+
+    it("resolves percentages against its container", function()
+      local container = track(Geyser.Container:new({name = "glsBox", x = 100, y = 50, width = 400, height = 200}))
+      track(Geyser.Label:new({name = "glsInBox", x = "25%", y = "50%", width = "50%", height = "25%"}, container))
+      assert.are.same({x = 200, y = 150, width = 200, height = 50}, geometry("glsInBox"))
+    end)
+
+    it("new2 marks the label as using add2", function()
+      local label = track(Geyser.Label:new2({name = "glsNew2", x = 0, y = 0, width = 40, height = 20}))
+      assert.is_true(label.useAdd2)
+      assert.are.equal("label", windowType("glsNew2"))
+    end)
+  end)
+
+  describe("Geyser.Label geometry and visibility", function()
+    local label
+
+    before_each(function()
+      label = track(Geyser.Label:new({name = "glsMove", x = 10, y = 20, width = 100, height = 50}))
+    end)
+
+    it("moves and resizes the widget", function()
+      label:move(70, 80)
+      label:resize(90, 30)
+      assert.are.same({x = 70, y = 80, width = 90, height = 30}, geometry("glsMove"))
+    end)
+
+    it("hides and shows the widget", function()
+      label:hide()
+      assert.is_false(windowVisible("glsMove"))
+      assert.is_true(label.hidden)
+      label:show()
+      assert.is_true(windowVisible("glsMove"))
+      assert.is_false(label.hidden)
+    end)
+  end)
+
+  describe("Geyser.Label:echo, rawEcho and clear", function()
+    local label
+
+    before_each(function()
+      label = track(Geyser.Label:new({name = "glsText", x = 0, y = 0, width = 200, height = 50}))
+    end)
+
+    it("wraps the message in a styled div", function()
+      label:echo("hello label")
+      local text = getLabelText("glsText")
+      assert.is_truthy(text:find("hello label", 1, true))
+      assert.is_truthy(text:find("font%-size: 8pt"))
+      assert.are.equal("hello label", label.message)
+    end)
+
+    it("reuses the last message when echoed with no arguments", function()
+      label:echo("sticky")
+      label:echo()
+      assert.is_truthy(getLabelText("glsText"):find("sticky", 1, true))
+    end)
+
+    it("colours the text with the colour it is given", function()
+      label:echo("red text", "red")
+      assert.is_truthy(getLabelText("glsText"):find("color: #ff0000", 1, true))
+      assert.are.equal("red", label.fgColor)
+    end)
+
+    it("leaves the colour to the stylesheet when told nocolor", function()
+      label:echo("plain", "nocolor")
+      assert.is_nil(getLabelText("glsText"):find("color: #", 1, true))
+    end)
+
+    it("applies a format string given to echo", function()
+      label:echo("formatted", nil, "cb14")
+      local text = getLabelText("glsText")
+      assert.is_truthy(text:find('align="center"', 1, true))
+      assert.is_truthy(text:find("formatted", 1, true))
+      assert.is_truthy(text:find("font%-size: 14pt"))
+    end)
+
+    it("rawEcho writes the markup through untouched", function()
+      label:rawEcho("raw")
+      assert.are.equal("raw", getLabelText("glsText"))
+    end)
+
+    it("clear empties the label", function()
+      label:echo("something")
+      label:clear()
+      assert.are.equal("", getLabelText("glsText"))
+      assert.are.equal("", label.message)
+    end)
+
+    it("decho, hecho and cecho put their colours into the markup", function()
+      label:decho("<0,0,255>blue")
+      assert.is_truthy(getLabelText("glsText"):find("blue", 1, true))
+      label:hecho("|cff0000red")
+      assert.is_truthy(getLabelText("glsText"):find("red", 1, true))
+      label:cecho("green")
+      assert.is_truthy(getLabelText("glsText"):find("green", 1, true))
+    end)
+  end)
+
+  describe("Geyser.Label format setters", function()
+    local label
+
+    before_each(function()
+      label = track(Geyser.Label:new({name = "glsFormat", x = 0, y = 0, width = 200, height = 50}))
+      label:echo("styled")
+    end)
+
+    it("turns bold, italics, underline and strikethrough into markup", function()
+      label:setBold(true)
+      assert.is_truthy(getLabelText("glsFormat"):find("styled", 1, true))
+      label:setItalics(true)
+      label:setUnderline(true)
+      label:setStrikethrough(true)
+      local text = getLabelText("glsFormat")
+      assert.is_truthy(text:find("", 1, true))
+      assert.is_truthy(text:find("", 1, true))
+      assert.is_truthy(text:find("", 1, true))
+      -- the font size was put into the format string first, the flags append
+      assert.are.equal("8bius", label.format)
+    end)
+
+    it("takes the markup away again", function()
+      label:setBold(true)
+      label:setBold(false)
+      assert.is_nil(getLabelText("glsFormat"):find("", 1, true))
+      assert.is_nil(label.format:find("b"))
+    end)
+
+    it("sets the font size in the markup", function()
+      label:setFontSize(20)
+      assert.is_truthy(getLabelText("glsFormat"):find("font%-size: 20pt"))
+      assert.are.equal(20, label.fontSize)
+    end)
+
+    it("sets the alignment in the markup", function()
+      label:setAlignment("center")
+      assert.is_truthy(getLabelText("glsFormat"):find('align="center"', 1, true))
+      label:setAlignment("right")
+      assert.is_truthy(getLabelText("glsFormat"):find('align="right"', 1, true))
+      label:setAlignment("")
+      assert.is_nil(getLabelText("glsFormat"):find("align=", 1, true))
+    end)
+
+    it("sets the text colour", function()
+      label:setFgColor("#00ff00")
+      assert.is_truthy(getLabelText("glsFormat"):find("color: #00ff00", 1, true))
+    end)
+
+    it("setFormat replaces the whole format at once", function()
+      label:setFormat("ci18")
+      local text = getLabelText("glsFormat")
+      assert.is_truthy(text:find('align="center"', 1, true))
+      assert.is_truthy(text:find("styled", 1, true))
+      assert.is_truthy(text:find("font%-size: 18pt"))
+      assert.is_nil(text:find("", 1, true))
+    end)
+
+    it("processFormatString fills in the format table", function()
+      label:processFormatString("bu12")
+      assert.are.equal(true, label.formatTable.bold)
+      assert.are.equal(true, label.formatTable.underline)
+      assert.are.equal(false, label.formatTable.italics)
+      assert.are.equal("12", label.formatTable.fontSize)
+      assert.are.equal("", label.formatTable.alignment)
+    end)
+
+    it("keeps the label's own font size when the format string has no number", function()
+      label:setFontSize(11)
+      label:processFormatString("b")
+      assert.are.equal(11, label.formatTable.fontSize)
+      assert.are.equal("b11", label.format)
+    end)
+
+    it("rejects an alignment it does not know", function()
+      local ok, message = pcall(function() label:setAlignment("nonsense") end)
+      assert.is_false(ok)
+      assert.is_truthy(tostring(message):find("invalid alignment sent", 1, true))
+    end)
+
+    it("rejects a font size that is not a number", function()
+      local ok, message = pcall(function() label:setFontSize("big") end)
+      assert.is_false(ok)
+      assert.is_truthy(tostring(message):find("fontSize as number expected, got string", 1, true))
+    end)
+
+    it("rejects a format that is not a string", function()
+      local ok, message = pcall(function() label:processFormatString(42) end)
+      assert.is_false(ok)
+      assert.is_truthy(tostring(message):find("format as string expected, got number", 1, true))
+    end)
+  end)
+
+  describe("Geyser.Label:getSizeHint and the auto adjust family", function()
+    local label
+
+    before_each(function()
+      label = track(Geyser.Label:new({name = "glsHint", x = 0, y = 0, width = 400, height = 200}))
+      label:echo("some text in a label")
+    end)
+
+    it("reports a size hint big enough for the content", function()
+      local width, height = label:getSizeHint()
+      assert.is_true(width > 0)
+      assert.is_true(height > 0)
+      assert.is_true(width < 400)
+    end)
+
+    it("adjustSize resizes the widget to the hint", function()
+      local width, height = label:getSizeHint()
+      label:adjustSize()
+      assert.are.same({x = 0, y = 0, width = width, height = height}, geometry("glsHint"))
+    end)
+
+    it("adjustWidth only touches the width", function()
+      local width = label:getSizeHint()
+      label:adjustWidth()
+      assert.are.same({x = 0, y = 0, width = width, height = 200}, geometry("glsHint"))
+    end)
+
+    it("adjustHeight only touches the height", function()
+      local _, height = label:getSizeHint()
+      label:adjustHeight()
+      assert.are.same({x = 0, y = 0, width = 400, height = height}, geometry("glsHint"))
+    end)
+
+    it("enableAutoAdjustSize makes every echo fit the content", function()
+      assert.is_true(label:enableAutoAdjustSize())
+      label:echo("tiny")
+      local width, height = label:getSizeHint()
+      assert.are.same({x = 0, y = 0, width = width, height = height}, geometry("glsHint"))
+    end)
+
+    it("enableAutoAdjustSize can be limited to one dimension", function()
+      label:enableAutoAdjustSize(false)
+      assert.is_false(label.autoWidth)
+      assert.is_true(label.autoHeight)
+      label:echo("tiny")
+      local _, height = label:getSizeHint()
+      assert.are.same({x = 0, y = 0, width = 400, height = height}, geometry("glsHint"))
+    end)
+
+    it("disableAutoAdjustSize leaves the size alone again", function()
+      label:enableAutoAdjustSize()
+      label:echo("tiny")
+      assert.is_true(label:disableAutoAdjustSize())
+      label:resize(400, 200)
+      label:echo("a much longer piece of text than before")
+      assert.are.same({x = 0, y = 0, width = 400, height = 200}, geometry("glsHint"))
+    end)
+  end)
+
+  describe("Geyser.Label:setStyleSheet and Geyser.Label:getFormat", function()
+    local label
+
+    before_each(function()
+      label = track(Geyser.Label:new({name = "glsStyle", x = 0, y = 0, width = 100, height = 50}))
+    end)
+
+    it("round-trips a stylesheet through Mudlet", function()
+      label:setStyleSheet("background-color: red; border: 1px solid white;")
+      assert.are.equal("background-color: red; border: 1px solid white;", getLabelStyleSheet("glsStyle"))
+      assert.are.equal("background-color: red; border: 1px solid white;", label.stylesheet)
+    end)
+
+    it("reuses the stored stylesheet when called with no argument", function()
+      label.stylesheet = "background-color: blue;"
+      label:setStyleSheet()
+      assert.are.equal("background-color: blue;", getLabelStyleSheet("glsStyle"))
+    end)
+
+    it("setTiledBackgroundImage puts the image into the stylesheet", function()
+      label:setTiledBackgroundImage("/tmp/nosuchimage.png")
+      assert.are.equal("background-image: url(/tmp/nosuchimage.png);", getLabelStyleSheet("glsStyle"))
+    end)
+
+    it("getFormat reports the label's format defaults", function()
+      local format = label:getFormat()
+      assert.are.equal("table", type(format))
+      assert.is_false(format.bold)
+      assert.is_false(format.italic)
+      assert.are.equal("table", type(format.foreground))
+    end)
+  end)
+
+  describe("Geyser.Label:type_delete", function()
+    it("deletes the widget with the object", function()
+      local label = Geyser.Label:new({name = "glsDelete", x = 0, y = 0, width = 40, height = 20})
+      assert.is_not_nil(getWindowGeometry("glsDelete"))
+      label:delete()
+      assert.is_nil(getWindowGeometry("glsDelete"))
+      assert.is_nil(Geyser.windowList.glsDelete)
+    end)
+
+    it("clears the nested label bookkeeping", function()
+      local label = Geyser.Label:new({name = "glsNested", x = 0, y = 0, width = 40, height = 20})
+      label.nestedLabels = {"something"}
+      label:delete()
+      assert.are.same({}, label.nestedLabels)
+    end)
+  end)
+end)
diff --git a/src/mudlet-lua/tests/GeyserMiniConsole_spec.lua b/src/mudlet-lua/tests/GeyserMiniConsole_spec.lua
new file mode 100644
index 000000000..75fe1153f
--- /dev/null
+++ b/src/mudlet-lua/tests/GeyserMiniConsole_spec.lua
@@ -0,0 +1,184 @@
+local function geometry(name)
+  local x, y, width, height = getWindowGeometry(name)
+  return {x = x, y = y, width = width, height = height}
+end
+
+describe("Tests functionality of Geyser.MiniConsole", function()
+  local created
+
+  local function track(object)
+    created[#created + 1] = object
+    return object
+  end
+
+  local function alive(object)
+    if not object or not object.container or not object.container.windowList then
+      return false
+    end
+    return object.container.windowList[object.name] == object
+  end
+
+  before_each(function()
+    created = {}
+  end)
+
+  after_each(function()
+    for _, object in ipairs(created) do
+      if alive(object) then
+        object:delete()
+      end
+    end
+    created = {}
+  end)
+
+  describe("Geyser.MiniConsole:new and Geyser.MiniConsole:new2", function()
+    it("creates a miniconsole widget at the constrained geometry", function()
+      local console = track(Geyser.MiniConsole:new({name = "gmcNew", x = 30, y = 40, width = 300, height = 150}))
+      -- Geyser's own type string is camel cased, Mudlet's windowType is not
+      assert.are.equal("miniConsole", console.type)
+      assert.are.equal("miniconsole", windowType("gmcNew"))
+      assert.are.same({x = 30, y = 40, width = 300, height = 150}, geometry("gmcNew"))
+      assert.is_true(windowVisible("gmcNew"))
+    end)
+
+    it("resolves percentages against its container", function()
+      local container = track(Geyser.Container:new({name = "gmcBox", x = 100, y = 50, width = 400, height = 200}))
+      track(Geyser.MiniConsole:new({name = "gmcInBox", x = "25%", y = "50%", width = "50%", height = "50%"}, container))
+      assert.are.same({x = 200, y = 150, width = 200, height = 100}, geometry("gmcInBox"))
+    end)
+
+    it("takes the font size from its container when it is not given one", function()
+      local container = track(Geyser.Container:new({name = "gmcFontBox", x = 0, y = 0, width = 200, height = 100, fontSize = 12}))
+      track(Geyser.MiniConsole:new({name = "gmcInheritsFont"}, container))
+      assert.are.equal(12, getFontSize("gmcInheritsFont"))
+    end)
+
+    it("new2 marks the console as using add2", function()
+      local console = track(Geyser.MiniConsole:new2({name = "gmcNew2", x = 0, y = 0, width = 100, height = 50}))
+      assert.is_true(console.useAdd2)
+      assert.are.equal("miniconsole", windowType("gmcNew2"))
+    end)
+  end)
+
+  describe("Geyser.MiniConsole geometry and visibility", function()
+    local console
+
+    before_each(function()
+      console = track(Geyser.MiniConsole:new({name = "gmcMove", x = 10, y = 20, width = 200, height = 100}))
+    end)
+
+    it("moves and resizes the widget", function()
+      console:move(60, 70)
+      console:resize(120, 60)
+      assert.are.same({x = 60, y = 70, width = 120, height = 60}, geometry("gmcMove"))
+    end)
+
+    it("hides and shows the widget", function()
+      console:hide()
+      assert.is_false(windowVisible("gmcMove"))
+      console:show()
+      assert.is_true(windowVisible("gmcMove"))
+    end)
+
+    it("follows its container when the container moves", function()
+      local container = track(Geyser.Container:new({name = "gmcDragBox", x = 0, y = 0, width = 200, height = 100}))
+      track(Geyser.MiniConsole:new({name = "gmcDragged", x = 0, y = 0, width = "100%", height = "100%"}, container))
+      container:move(150, 30)
+      assert.are.same({x = 150, y = 30, width = 200, height = 100}, geometry("gmcDragged"))
+    end)
+  end)
+
+  describe("Geyser.MiniConsole:setWrap and the auto wrap family", function()
+    it("sets the wrap column", function()
+      local console = track(Geyser.MiniConsole:new({name = "gmcWrap", x = 0, y = 0, width = 300, height = 100}))
+      console:setWrap(42)
+      assert.are.equal(42, console.wrapAt)
+      assert.are.equal(42, getWindowWrap("gmcWrap"))
+    end)
+
+    it("refuses to set the wrap while auto wrap is on", function()
+      local console = track(Geyser.MiniConsole:new({name = "gmcWrapLocked", x = 0, y = 0, width = 300, height = 100}))
+      console:enableAutoWrap()
+      local result, message = console:setWrap(11)
+      assert.is_nil(result)
+      assert.is_truthy(message:find("autoWrap is enabled", 1, true))
+      assert.are_not.equal(11, getWindowWrap("gmcWrapLocked"))
+    end)
+
+    it("derives the wrap from the width when auto wrap is on", function()
+      local console = track(Geyser.MiniConsole:new({name = "gmcAutoWrap", x = 0, y = 0, width = 300, height = 100, wrapAt = "auto"}))
+      local charWidth = calcFontSize("gmcAutoWrap")
+      assert.is_true(console.autoWrap)
+      assert.are.equal(math.floor(300 / charWidth), getWindowWrap("gmcAutoWrap"))
+    end)
+
+    it("re-derives the wrap when the console is resized", function()
+      local console = track(Geyser.MiniConsole:new({name = "gmcRewrap", x = 0, y = 0, width = 300, height = 100, autoWrap = true}))
+      local charWidth = calcFontSize("gmcRewrap")
+      assert.are.equal(math.floor(300 / charWidth), getWindowWrap("gmcRewrap"))
+      console:resize(150, 100)
+      assert.are.equal(math.floor(150 / charWidth), getWindowWrap("gmcRewrap"))
+    end)
+
+    it("stops re-deriving the wrap once auto wrap is disabled", function()
+      local console = track(Geyser.MiniConsole:new({name = "gmcNoAutoWrap", x = 0, y = 0, width = 300, height = 100, autoWrap = true}))
+      console:disableAutoWrap()
+      console:setWrap(17)
+      console:resize(150, 100)
+      assert.is_false(console.autoWrap)
+      assert.are.equal(17, getWindowWrap("gmcNoAutoWrap"))
+    end)
+
+    it("reports that resetAutoWrap has nothing to do when auto wrap is off", function()
+      local console = track(Geyser.MiniConsole:new({name = "gmcResetWrap", x = 0, y = 0, width = 300, height = 100}))
+      local result, message = console:resetAutoWrap()
+      assert.is_nil(result)
+      assert.is_truthy(message:find("Autowrap is not enabled", 1, true))
+    end)
+  end)
+
+  describe("Geyser.MiniConsole:setFontSize and Geyser.MiniConsole:getFont", function()
+    it("changes the font size of the console", function()
+      local console = track(Geyser.MiniConsole:new({name = "gmcFont", x = 0, y = 0, width = 300, height = 100, fontSize = 8}))
+      assert.are.equal(8, getFontSize("gmcFont"))
+      console:setFontSize(14)
+      assert.are.equal(14, getFontSize("gmcFont"))
+      assert.are.equal(14, console.fontSize)
+    end)
+
+    it("re-derives an auto wrap from the new font size", function()
+      local console = track(Geyser.MiniConsole:new({name = "gmcFontWrap", x = 0, y = 0, width = 300, height = 100, fontSize = 8, autoWrap = true}))
+      local smallWrap = getWindowWrap("gmcFontWrap")
+      console:setFontSize(20)
+      local bigWrap = getWindowWrap("gmcFontWrap")
+      assert.are.equal(math.floor(300 / calcFontSize("gmcFontWrap")), bigWrap)
+      assert.is_true(bigWrap < smallWrap)
+    end)
+
+    it("reports the font family in use", function()
+      local console = track(Geyser.MiniConsole:new({name = "gmcFontFamily", x = 0, y = 0, width = 300, height = 100}))
+      assert.are.equal(getFont("gmcFontFamily"), console:getFont())
+      assert.are.equal(console.font, getFont("gmcFontFamily"))
+    end)
+  end)
+
+  describe("Geyser.MiniConsole:clear", function()
+    it("empties the console", function()
+      local console = track(Geyser.MiniConsole:new({name = "gmcClear", x = 0, y = 0, width = 300, height = 100}))
+      console:echo("one\ntwo\n")
+      assert.is_true(getLineCount("gmcClear") > 1)
+      console:clear()
+      assert.are.equal(0, getLineCount("gmcClear"))
+    end)
+  end)
+
+  describe("Geyser.MiniConsole:type_delete", function()
+    it("deletes the widget with the object", function()
+      local console = Geyser.MiniConsole:new({name = "gmcDelete", x = 0, y = 0, width = 100, height = 50})
+      assert.is_not_nil(getWindowGeometry("gmcDelete"))
+      console:delete()
+      assert.is_nil(getWindowGeometry("gmcDelete"))
+      assert.is_nil(Geyser.windowList.gmcDelete)
+    end)
+  end)
+end)
diff --git a/src/mudlet-lua/tests/GeyserStyleSheet_spec.lua b/src/mudlet-lua/tests/GeyserStyleSheet_spec.lua
index 6e21db07d..db785a142 100644
--- a/src/mudlet-lua/tests/GeyserStyleSheet_spec.lua
+++ b/src/mudlet-lua/tests/GeyserStyleSheet_spec.lua
@@ -303,4 +303,39 @@ describe("Tests functionality of Geyser.StyleSheet", function()
       assert.equal(expected, actual)
     end)
   end)
-end)
\ No newline at end of file
+
+  -- The blocks above work on the stylesheet object alone; this one puts an
+  -- assembled sheet onto a real widget and reads it back out of Mudlet.
+  describe("Tests applying a Geyser.StyleSheet to a widget", function()
+    local label
+
+    before_each(function()
+      label = Geyser.Label:new({name = "gssLabel", x = 0, y = 0, width = 100, height = 50})
+    end)
+
+    after_each(function()
+      if label and Geyser.windowList.gssLabel == label then
+        label:delete()
+      end
+      label = nil
+    end)
+
+    it("applies an inherited stylesheet to a label", function()
+      local parent = Geyser.StyleSheet:new("background-color: black;\ncolor: green;")
+      local child = Geyser.StyleSheet:new("color: blue;", parent)
+      label:setStyleSheet(child:getCSS())
+      local applied = getLabelStyleSheet("gssLabel")
+      assert.is_truthy(applied:find("background-color: black;", 1, true))
+      assert.is_truthy(applied:find("color: blue;", 1, true))
+      assert.is_nil(applied:find("color: green;", 1, true))
+    end)
+
+    it("follows a change made to the parent sheet after the fact", function()
+      local parent = Geyser.StyleSheet:new("background-color: black;")
+      local child = Geyser.StyleSheet:new("color: blue;", parent)
+      parent:set("border", "1px solid white")
+      label:setStyleSheet(child:getCSS())
+      assert.is_truthy(getLabelStyleSheet("gssLabel"):find("border: 1px solid white;", 1, true))
+    end)
+  end)
+end)
diff --git a/src/mudlet-lua/tests/GeyserVBox_spec.lua b/src/mudlet-lua/tests/GeyserVBox_spec.lua
new file mode 100644
index 000000000..1fa23d398
--- /dev/null
+++ b/src/mudlet-lua/tests/GeyserVBox_spec.lua
@@ -0,0 +1,154 @@
+-- A VBox stacks its children top to bottom by rewriting their constraints as
+-- percentages of the box, so the pixel expectations below are the box geometry
+-- divided by the shares each child is entitled to.
+local function geometry(name)
+  local x, y, width, height = getWindowGeometry(name)
+  return {x = x, y = y, width = width, height = height}
+end
+
+describe("Tests functionality of Geyser.VBox", function()
+  local created
+
+  local function track(object)
+    created[#created + 1] = object
+    return object
+  end
+
+  local function alive(object)
+    if not object or not object.container or not object.container.windowList then
+      return false
+    end
+    return object.container.windowList[object.name] == object
+  end
+
+  before_each(function()
+    created = {}
+  end)
+
+  after_each(function()
+    for _, object in ipairs(created) do
+      if alive(object) then
+        object:delete()
+      end
+    end
+    created = {}
+  end)
+
+  describe("Geyser.VBox:new and Geyser.VBox:new2", function()
+    it("defaults the type to VBox and starts empty", function()
+      local box = track(Geyser.VBox:new({name = "gvbNew", x = 0, y = 0, width = 100, height = 100}))
+      assert.are.equal("VBox", box.type)
+      assert.are.same({}, box.windows)
+      -- a box is a container, so it has no widget of its own
+      assert.is_nil(getWindowGeometry("gvbNew"))
+    end)
+
+    it("new2 marks the box as using add2", function()
+      local box = track(Geyser.VBox:new2({name = "gvbNew2", x = 0, y = 0, width = 100, height = 100}))
+      assert.is_true(box.useAdd2)
+      assert.are.equal("VBox", box.type)
+    end)
+  end)
+
+  describe("Geyser.VBox:add and Geyser.VBox:organize", function()
+    it("gives a single child the whole box", function()
+      local box = track(Geyser.VBox:new({name = "gvbOne", x = 10, y = 20, width = 200, height = 100}))
+      track(Geyser.Label:new({name = "gvbOneChild"}, box))
+      assert.are.same({x = 10, y = 20, width = 200, height = 100}, geometry("gvbOneChild"))
+    end)
+
+    it("splits the box evenly between two children", function()
+      local box = track(Geyser.VBox:new({name = "gvbTwo", x = 0, y = 0, width = 200, height = 200}))
+      track(Geyser.Label:new({name = "gvbTwoA"}, box))
+      track(Geyser.Label:new({name = "gvbTwoB"}, box))
+      assert.are.same({x = 0, y = 0, width = 200, height = 100}, geometry("gvbTwoA"))
+      assert.are.same({x = 0, y = 100, width = 200, height = 100}, geometry("gvbTwoB"))
+    end)
+
+    it("re-splits the box when another child is added", function()
+      local box = track(Geyser.VBox:new({name = "gvbThree", x = 50, y = 60, width = 100, height = 100}))
+      track(Geyser.Label:new({name = "gvbThreeA"}, box))
+      track(Geyser.Label:new({name = "gvbThreeB"}, box))
+      assert.are.equal(50, geometry("gvbThreeA").height)
+      track(Geyser.Label:new({name = "gvbThreeC"}, box))
+      -- a third of the box does not divide into whole pixels, and Mudlet
+      -- truncates the pixel values it is handed
+      for index, name in ipairs({"gvbThreeA", "gvbThreeB", "gvbThreeC"}) do
+        local expectedY = math.floor(60 + (index - 1) * 100 / 3)
+        assert.are.same({x = 50, y = expectedY, width = 100, height = 33}, geometry(name))
+      end
+    end)
+
+    it("stretches children over the full width of the box", function()
+      local box = track(Geyser.VBox:new({name = "gvbWide", x = 0, y = 0, width = 240, height = 100}))
+      track(Geyser.Label:new({name = "gvbWideChild", width = 20}, box))
+      assert.are.equal("100%", box.windowList.gvbWideChild.width)
+      assert.are.equal(240, geometry("gvbWideChild").width)
+    end)
+
+    it("keeps a fixed height child at its size and splits the rest", function()
+      local box = track(Geyser.VBox:new({name = "gvbFixed", x = 0, y = 0, width = 200, height = 300}))
+      track(Geyser.Label:new({name = "gvbFixedChild", height = 60, v_policy = Geyser.Fixed}, box))
+      track(Geyser.Label:new({name = "gvbDynamicA"}, box))
+      track(Geyser.Label:new({name = "gvbDynamicB"}, box))
+      assert.is_true(box.contains_fixed)
+      assert.are.same({x = 0, y = 0, width = 200, height = 60}, geometry("gvbFixedChild"))
+      assert.are.same({x = 0, y = 60, width = 200, height = 120}, geometry("gvbDynamicA"))
+      assert.are.same({x = 0, y = 180, width = 200, height = 120}, geometry("gvbDynamicB"))
+    end)
+
+    it("gives a stretch factor its extra share of the height", function()
+      local box = track(Geyser.VBox:new({name = "gvbStretch", x = 0, y = 0, width = 200, height = 400}))
+      track(Geyser.Label:new({name = "gvbStretchA", v_stretch_factor = 3}, box))
+      track(Geyser.Label:new({name = "gvbStretchB"}, box))
+      -- three shares against one out of a four share pool
+      assert.are.same({x = 0, y = 0, width = 200, height = 300}, geometry("gvbStretchA"))
+      assert.are.same({x = 0, y = 300, width = 200, height = 100}, geometry("gvbStretchB"))
+    end)
+  end)
+
+  describe("Geyser.VBox:reposition", function()
+    local box
+
+    before_each(function()
+      box = track(Geyser.VBox:new({name = "gvbMove", x = 10, y = 20, width = 200, height = 200}))
+      track(Geyser.Label:new({name = "gvbMoveA"}, box))
+      track(Geyser.Label:new({name = "gvbMoveB"}, box))
+    end)
+
+    it("drags the stack along when the box moves", function()
+      box:move(50, 60)
+      assert.are.same({x = 50, y = 60, width = 200, height = 100}, geometry("gvbMoveA"))
+      assert.are.same({x = 50, y = 160, width = 200, height = 100}, geometry("gvbMoveB"))
+    end)
+
+    it("re-splits the stack when the box is resized", function()
+      box:resize(100, 100)
+      assert.are.same({x = 10, y = 20, width = 100, height = 50}, geometry("gvbMoveA"))
+      assert.are.same({x = 10, y = 70, width = 100, height = 50}, geometry("gvbMoveB"))
+    end)
+
+    it("keeps a fixed child flush against its neighbour after a resize", function()
+      local fixedBox = track(Geyser.VBox:new({name = "gvbFixedMove", x = 0, y = 0, width = 200, height = 200}))
+      track(Geyser.Label:new({name = "gvbFixedMoveA", height = 50, v_policy = Geyser.Fixed}, fixedBox))
+      track(Geyser.Label:new({name = "gvbFixedMoveB"}, fixedBox))
+      fixedBox:resize(200, 250)
+      assert.are.same({x = 0, y = 0, width = 200, height = 50}, geometry("gvbFixedMoveA"))
+      assert.are.same({x = 0, y = 50, width = 200, height = 200}, geometry("gvbFixedMoveB"))
+    end)
+  end)
+
+  describe("Geyser.VBox visibility", function()
+    it("hides and shows the whole stack", function()
+      local box = track(Geyser.VBox:new({name = "gvbHide", x = 0, y = 0, width = 100, height = 100}))
+      track(Geyser.Label:new({name = "gvbHideA"}, box))
+      track(Geyser.Label:new({name = "gvbHideB"}, box))
+      box:hide()
+      assert.is_false(windowVisible("gvbHideA"))
+      assert.is_false(windowVisible("gvbHideB"))
+      box:show()
+      assert.is_true(windowVisible("gvbHideA"))
+      assert.is_true(windowVisible("gvbHideB"))
+    end)
+  end)
+end)
diff --git a/src/mudlet-lua/tests/GeyserWindow_spec.lua b/src/mudlet-lua/tests/GeyserWindow_spec.lua
new file mode 100644
index 000000000..39e49c3c4
--- /dev/null
+++ b/src/mudlet-lua/tests/GeyserWindow_spec.lua
@@ -0,0 +1,187 @@
+-- Geyser.Window is the abstract base for the Mudlet primitives that hold text.
+-- Its methods are exercised through a Geyser.MiniConsole, the simplest
+-- subclass that owns a real widget, and read back with the console getters.
+-- Selects the most recently echoed line so getCurrentLine/getTextFormat report
+-- on it. Mudlet does not count the empty line the trailing newline leaves
+-- behind, so the last written line is the last one getLineCount knows about.
+local function lastLine(name)
+  moveCursor(name, 0, getLineCount(name) - 1)
+  selectCurrentLine(name)
+  return getCurrentLine(name)
+end
+
+describe("Tests functionality of Geyser.Window", function()
+  local created
+  local console
+
+  local function track(object)
+    created[#created + 1] = object
+    return object
+  end
+
+  local function alive(object)
+    if not object or not object.container or not object.container.windowList then
+      return false
+    end
+    return object.container.windowList[object.name] == object
+  end
+
+  before_each(function()
+    created = {}
+    console = track(Geyser.MiniConsole:new({name = "gwsConsole", x = 0, y = 0, width = 300, height = 100}))
+  end)
+
+  after_each(function()
+    for _, object in ipairs(created) do
+      if alive(object) then
+        object:delete()
+      end
+    end
+    created = {}
+  end)
+
+  describe("Geyser.Window:new", function()
+    it("defaults the type to window and owns no widget of its own", function()
+      local window = track(Geyser.Window:new({name = "gwsAbstract", x = 0, y = 0, width = 100, height = 100}))
+      assert.are.equal("window", window.type)
+      assert.are.equal(window, Geyser.windowList.gwsAbstract)
+      -- Geyser.Window is abstract: only its subclasses create a Mudlet primitive
+      assert.is_nil(getWindowGeometry("gwsAbstract"))
+    end)
+
+    it("provides the colour defaults its subclasses inherit", function()
+      local window = track(Geyser.Window:new({name = "gwsColours", x = 0, y = 0, width = 10, height = 10}))
+      assert.are.equal("white", window.fgColor)
+      assert.are.equal("black", window.bgColor)
+      assert.are.equal("#202020", window.color)
+      assert.are.equal("", window.message)
+    end)
+  end)
+
+  describe("Geyser.Window:echo, cecho, decho and hecho", function()
+    it("echoes plain text and remembers the message", function()
+      console:echo("plain line\n")
+      assert.are.equal("plain line\n", console.message)
+      assert.are.equal("plain line", lastLine("gwsConsole"))
+    end)
+
+    it("cecho colours the text by name", function()
+      console:cecho("green line\n")
+      assert.are.equal("green line", lastLine("gwsConsole"))
+      assert.are.same({0, 255, 0}, getTextFormat("gwsConsole").foreground)
+    end)
+
+    it("decho colours the text by rgb triple", function()
+      console:decho("<0,0,255>blue line\n")
+      assert.are.equal("blue line", lastLine("gwsConsole"))
+      assert.are.same({0, 0, 255}, getTextFormat("gwsConsole").foreground)
+    end)
+
+    it("hecho colours the text by hex code", function()
+      console:hecho("|cff0000red line\n")
+      assert.are.equal("red line", lastLine("gwsConsole"))
+      assert.are.same({255, 0, 0}, getTextFormat("gwsConsole").foreground)
+    end)
+
+    it("reuses the last message when called without one", function()
+      console:echo("remembered\n")
+      console:cecho()
+      assert.are.equal("remembered\n", console.message)
+      assert.are.equal("remembered", lastLine("gwsConsole"))
+    end)
+  end)
+
+  describe("Geyser.Window:setFgColor, setBgColor, getFgColor and getBgColor", function()
+    it("round-trips the foreground colour", function()
+      console:setFgColor(255, 0, 0)
+      console:echo("coloured\n")
+      lastLine("gwsConsole")
+      assert.are.same({255, 0, 0}, getTextFormat("gwsConsole").foreground)
+      local red, green, blue = console:getFgColor()
+      assert.are.same({255, 0, 0}, {red, green, blue})
+    end)
+
+    it("round-trips the background colour", function()
+      console:setBgColor(0, 0, 255)
+      console:echo("coloured\n")
+      lastLine("gwsConsole")
+      assert.are.same({0, 0, 255}, getTextFormat("gwsConsole").background)
+      local red, green, blue = console:getBgColor()
+      assert.are.same({0, 0, 255}, {red, green, blue})
+    end)
+
+    it("accepts a colour name", function()
+      console:setFgColor("green")
+      console:echo("named\n")
+      lastLine("gwsConsole")
+      assert.are.same({0, 255, 0}, getTextFormat("gwsConsole").foreground)
+    end)
+
+    it("accepts a hex colour", function()
+      console:setFgColor("#ff00ff")
+      console:echo("hexed\n")
+      lastLine("gwsConsole")
+      assert.are.same({255, 0, 255}, getTextFormat("gwsConsole").foreground)
+    end)
+  end)
+
+  describe("Geyser.Window:setTextFormat, setBold, setUnderline and setItalics", function()
+    it("starts out with no attributes set", function()
+      console:echo("first\n")
+      lastLine("gwsConsole")
+      local format = getTextFormat("gwsConsole")
+      assert.is_false(format.bold)
+      assert.is_false(format.italic)
+      assert.is_false(format.underline)
+    end)
+
+    it("turns bold, italics and underline on and off again", function()
+      console:setBold(true)
+      console:setItalics(true)
+      console:setUnderline(true)
+      console:echo("styled\n")
+      lastLine("gwsConsole")
+      local styled = getTextFormat("gwsConsole")
+      assert.is_true(styled.bold)
+      assert.is_true(styled.italic)
+      assert.is_true(styled.underline)
+      console:setBold(false)
+      console:setItalics(false)
+      console:setUnderline(false)
+      console:echo("plain\n")
+      lastLine("gwsConsole")
+      local plain = getTextFormat("gwsConsole")
+      assert.is_false(plain.bold)
+      assert.is_false(plain.italic)
+      assert.is_false(plain.underline)
+    end)
+
+    it("sets both colours and all attributes at once", function()
+      -- the first colour triple is the background and the second the
+      -- foreground, matching Mudlet's setTextFormat
+      console:setTextFormat(10, 20, 30, 200, 100, 50, true, true, true)
+      console:echo("formatted\n")
+      lastLine("gwsConsole")
+      local format = getTextFormat("gwsConsole")
+      assert.are.same({10, 20, 30}, format.background)
+      assert.are.same({200, 100, 50}, format.foreground)
+      assert.is_true(format.bold)
+      assert.is_true(format.underline)
+      assert.is_true(format.italic)
+    end)
+  end)
+
+  describe("Geyser.Window:paste", function()
+    it("pastes a selection copied from another console", function()
+      local source = track(Geyser.MiniConsole:new({name = "gwsSource", x = 0, y = 0, width = 300, height = 100}))
+      source:echo("copy me\n")
+      moveCursor("gwsSource", 0, 0)
+      selectCurrentLine("gwsSource")
+      copy("gwsSource")
+      console:paste()
+      moveCursor("gwsConsole", 0, 0)
+      selectCurrentLine("gwsConsole")
+      assert.are.equal("copy me", getCurrentLine("gwsConsole"))
+    end)
+  end)
+end)

From 2bc85b62febe514a77d6d282e4f68c8b59c89199 Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Sun, 2 Aug 2026 11:41:13 +0200
Subject: [PATCH 048/155] infrastructure: address review of the Geyser specs

Sweep the right click menu labels an Adjustable.Container leaves behind,
clean up through finally() where an assertion could strand a widget,
replace weak assertions, add the deferred update effect specs, and name
the describes after the functions they cover so the coverage recount
picks them up.

Assisted-by: Claude:claude-opus-4-8
---
 .../tests/GeyserAdjustableContainer_spec.lua  | 30 ++++++-
 src/mudlet-lua/tests/GeyserButton_spec.lua    |  6 +-
 src/mudlet-lua/tests/GeyserContainer_spec.lua | 86 +++++++++++++------
 src/mudlet-lua/tests/GeyserGauge_spec.lua     |  7 +-
 src/mudlet-lua/tests/GeyserHBox_spec.lua      | 12 +--
 src/mudlet-lua/tests/GeyserLabel_spec.lua     | 27 +++---
 .../tests/GeyserMiniConsole_spec.lua          | 19 ++--
 src/mudlet-lua/tests/GeyserVBox_spec.lua      |  4 +-
 src/mudlet-lua/tests/GeyserWindow_spec.lua    | 18 ++--
 9 files changed, 143 insertions(+), 66 deletions(-)

diff --git a/src/mudlet-lua/tests/GeyserAdjustableContainer_spec.lua b/src/mudlet-lua/tests/GeyserAdjustableContainer_spec.lua
index 67794166c..c04d434c4 100644
--- a/src/mudlet-lua/tests/GeyserAdjustableContainer_spec.lua
+++ b/src/mudlet-lua/tests/GeyserAdjustableContainer_spec.lua
@@ -138,6 +138,28 @@ describe("Tests functionality of Adjustable.Container", function()
         container:delete()
       end
       container = nil
+      -- Deleting an Adjustable.Container does not take its right click menu
+      -- labels with it: they are registered as top level Geyser objects, so
+      -- the cascade never reaches them. Sweep them by name, and unregister
+      -- the container from Adjustable's own bookkeeping, so nothing of this
+      -- spec is left behind for the rest of the suite.
+      local leftovers = {}
+      for name in pairs(Geyser.windowList) do
+        if name:find("^gasContainer") then
+          leftovers[#leftovers + 1] = name
+        end
+      end
+      for _, name in ipairs(leftovers) do
+        local object = Geyser.windowList[name]
+        if object then
+          object:delete()
+        end
+      end
+      Adjustable.Container.all.gasContainer = nil
+      local index = table.index_of(Adjustable.Container.all_windows, "gasContainer")
+      if index then
+        table.remove(Adjustable.Container.all_windows, index)
+      end
     end)
 
     it("puts its backdrop label over the container's geometry", function()
@@ -196,15 +218,19 @@ describe("Tests functionality of Adjustable.Container", function()
       local minimized = geometry("gasContaineradjLabel")
       assert.are.equal(200, minimized.width)
       assert.is_true(minimized.height < 200)
-      assert.are.equal(container.buttonsize + 10, minimized.height)
+      -- buttonsize is stored as a string, hence the conversion
+      assert.are.equal(tonumber(container.buttonsize) + 10, minimized.height)
       container:restore()
       assert.is_false(container.minimized)
       assert.are.same({x = 20, y = 30, width = 200, height = 200}, geometry("gasContaineradjLabel"))
     end)
 
-    it("deletes all of its widgets", function()
+    it("deletes the container and its backdrop label", function()
+      -- the right click menu labels it created are not part of the cascade,
+      -- so they are swept by name in after_each instead
       container:delete()
       assert.is_nil(getWindowGeometry("gasContaineradjLabel"))
+      assert.is_nil(getWindowGeometry("gasContainerexitLabel"))
       assert.is_nil(Geyser.windowList.gasContainer)
     end)
   end)
diff --git a/src/mudlet-lua/tests/GeyserButton_spec.lua b/src/mudlet-lua/tests/GeyserButton_spec.lua
index 8c01b4e33..eadff82a9 100644
--- a/src/mudlet-lua/tests/GeyserButton_spec.lua
+++ b/src/mudlet-lua/tests/GeyserButton_spec.lua
@@ -223,7 +223,9 @@ describe("Tests functionality of Geyser.Button", function()
       assert.is_nil(result)
       assert.are.equal("cannot set a single state button's state to 'down', only 'up'", message)
       -- the refusal happens before anything is drawn, so the button still
-      -- shows its up message
+      -- shows its up message. button.state is deliberately not asserted here:
+      -- setState writes it before the refusal, which is a Geyser bug to fix
+      -- rather than a contract to pin down.
       assert.is_truthy(getLabelText("gbsSingleState"):find("up text", 1, true))
     end)
 
@@ -312,7 +314,7 @@ describe("Tests functionality of Geyser.Button", function()
     end)
 
     it('deletes its widget', function()
-      local button = Geyser.Button:new({name = "gbsDelete", x = 0, y = 0, width = 60, height = 20})
+      local button = track(Geyser.Button:new({name = "gbsDelete", x = 0, y = 0, width = 60, height = 20}))
       button:delete()
       assert.is_nil(getWindowGeometry("gbsDelete"))
       assert.is_nil(Geyser.windowList.gbsDelete)
diff --git a/src/mudlet-lua/tests/GeyserContainer_spec.lua b/src/mudlet-lua/tests/GeyserContainer_spec.lua
index cb229215d..dc9eb5312 100644
--- a/src/mudlet-lua/tests/GeyserContainer_spec.lua
+++ b/src/mudlet-lua/tests/GeyserContainer_spec.lua
@@ -2,11 +2,8 @@
 -- differs between machines, so expectations are computed from
 -- getMainWindowSize() at assert time rather than hardcoded. Mudlet truncates
 -- the doubles handed to moveWindow()/resizeWindow() (static_cast), which
--- is why the expectations are floored.
-local function floor(value)
-  return math.floor(value)
-end
-
+-- for the positive geometry used here is math.floor.
+--
 -- Containers themselves have no Mudlet widget, so geometry is read back from a
 -- child label - the widget Geyser actually moves and resizes.
 local function geometry(name)
@@ -45,7 +42,7 @@ describe("Tests functionality of Geyser.Container", function()
     created = {}
   end)
 
-  describe("Geyser.Container:new and Geyser.Container:new2", function()
+  describe("Geyser.Container:new/new2", function()
     it("generates a name and defaults the type to container", function()
       local container = track(Geyser.Container:new())
       assert.are.equal("container", container.type)
@@ -94,7 +91,7 @@ describe("Tests functionality of Geyser.Container", function()
     end)
   end)
 
-  describe("Geyser.calc_constraints and Geyser.set_constraints", function()
+  describe("Geyser.calc_constraints/set_constraints", function()
     it("places a child at the pixel position it was given", function()
       track(Geyser.Label:new({name = "gcsPixels", x = 12, y = 34, width = 120, height = 56}))
       assert.are.same({x = 12, y = 34, width = 120, height = 56}, geometry("gcsPixels"))
@@ -109,10 +106,10 @@ describe("Tests functionality of Geyser.Container", function()
       local mainWidth, mainHeight = getMainWindowSize()
       track(Geyser.Label:new({name = "gcsPercent", x = "10%", y = "20%", width = "50%", height = "25%"}))
       assert.are.same({
-        x = floor(0.1 * mainWidth),
-        y = floor(0.2 * mainHeight),
-        width = floor(0.5 * mainWidth),
-        height = floor(0.25 * mainHeight),
+        x = math.floor(0.1 * mainWidth),
+        y = math.floor(0.2 * mainHeight),
+        width = math.floor(0.5 * mainWidth),
+        height = math.floor(0.25 * mainHeight),
       }, geometry("gcsPercent"))
     end)
 
@@ -120,8 +117,8 @@ describe("Tests functionality of Geyser.Container", function()
       local mainWidth = getMainWindowSize()
       track(Geyser.Label:new({name = "gcsOffset", x = "50%+10", y = 0, width = "10%-5", height = 20}))
       local actual = geometry("gcsOffset")
-      assert.are.equal(floor(0.5 * mainWidth + 10), actual.x)
-      assert.are.equal(floor(0.1 * mainWidth - 5), actual.width)
+      assert.are.equal(math.floor(0.5 * mainWidth + 10), actual.x)
+      assert.are.equal(math.floor(0.1 * mainWidth - 5), actual.width)
     end)
 
     it("measures negative pixel constraints from the far edge", function()
@@ -153,7 +150,7 @@ describe("Tests functionality of Geyser.Container", function()
     end)
   end)
 
-  describe("Geyser.Container:move and Geyser.Container:resize", function()
+  describe("Geyser.Container:move/resize", function()
     local container
 
     before_each(function()
@@ -190,7 +187,7 @@ describe("Tests functionality of Geyser.Container", function()
     end)
   end)
 
-  describe("Geyser.Container:hide, show, hide_impl and show_impl", function()
+  describe("Geyser.Container:hide/show/hide_impl/show_impl", function()
     local container
 
     before_each(function()
@@ -238,7 +235,7 @@ describe("Tests functionality of Geyser.Container", function()
     end)
   end)
 
-  describe("Geyser.Container:raise, lower, raiseAll and lowerAll", function()
+  describe("Geyser.Container:raise/lower/raiseAll/lowerAll", function()
     -- Mudlet exposes no z-order readback, so these assert the ordering Geyser
     -- keeps in container.windows - the order it replays z-order changes from.
     local container
@@ -273,17 +270,19 @@ describe("Tests functionality of Geyser.Container", function()
     it("keeps the relative order when raising or lowering the whole container", function()
       container:raiseAll()
       assert.are.same({"gcsStack1", "gcsStack2"}, container.windows)
-      assert.is_nil(Geyser.Container.windowTable)
       container:lowerAll()
       assert.are.same({"gcsStack1", "gcsStack2"}, container.windows)
+      -- lowerAll walks the tree through a scratch table it must clean up again
       assert.is_nil(Geyser.Container.windowTable)
     end)
   end)
 
   describe("Geyser.Container:delete", function()
+    -- the objects here are tracked as well as deleted by hand, so a failing
+    -- assertion before the delete cannot strand a widget
     it("deletes the widgets of its children", function()
-      local container = Geyser.Container:new({name = "gcsDelete", x = 0, y = 0, width = 100, height = 100})
-      Geyser.Label:new({name = "gcsDeleteChild"}, container)
+      local container = track(Geyser.Container:new({name = "gcsDelete", x = 0, y = 0, width = 100, height = 100}))
+      track(Geyser.Label:new({name = "gcsDeleteChild"}, container))
       assert.is_not_nil(getWindowGeometry("gcsDeleteChild"))
       container:delete()
       assert.is_nil(getWindowGeometry("gcsDeleteChild"))
@@ -292,7 +291,7 @@ describe("Tests functionality of Geyser.Container", function()
     end)
 
     it("unregisters a top level container from the root Geyser lists", function()
-      local container = Geyser.Container:new({name = "gcsDeleteRoot", x = 0, y = 0, width = 10, height = 10})
+      local container = track(Geyser.Container:new({name = "gcsDeleteRoot", x = 0, y = 0, width = 10, height = 10}))
       container:delete()
       assert.is_nil(Geyser.windowList.gcsDeleteRoot)
       assert.is_nil(table.index_of(Geyser.windows, "gcsDeleteRoot"))
@@ -300,7 +299,7 @@ describe("Tests functionality of Geyser.Container", function()
 
     it("unregisters a child from its parent", function()
       local container = track(Geyser.Container:new({name = "gcsDeleteParent", x = 0, y = 0, width = 100, height = 100}))
-      local child = Geyser.Label:new({name = "gcsDeleteMe"}, container)
+      local child = track(Geyser.Label:new({name = "gcsDeleteMe"}, container))
       child:delete()
       assert.is_nil(container.windowList.gcsDeleteMe)
       assert.are.same({}, container.windows)
@@ -369,11 +368,11 @@ describe("Tests functionality of Geyser.Container", function()
   describe("Geyser.Container:flash", function()
     it("puts a flash label over the container's geometry", function()
       local container = track(Geyser.Container:new({name = "gcsFlash", x = 20, y = 30, width = 80, height = 40}))
+      -- the flash label belongs to no Geyser container, so remove it by hand
+      finally(function() deleteLabel("gcsFlash_dimensions_flash") end)
       container:flash(0.1)
       assert.are.same({x = 20, y = 30, width = 80, height = 40}, geometry("gcsFlash_dimensions_flash"))
       assert.is_true(windowVisible("gcsFlash_dimensions_flash"))
-      -- the flash label belongs to no Geyser container, so remove it by hand
-      deleteLabel("gcsFlash_dimensions_flash")
     end)
 
     it("creates nothing when told not to flash", function()
@@ -383,7 +382,7 @@ describe("Tests functionality of Geyser.Container", function()
     end)
   end)
 
-  describe("Geyser:add, Geyser:base_add and Geyser:add2", function()
+  describe("Geyser:base_add/add/add2", function()
     it("tracks an added window once, even when it is added twice", function()
       local container = track(Geyser.Container:new({name = "gcsAdd", x = 0, y = 0, width = 100, height = 100}))
       local label = track(Geyser.Label:new({name = "gcsAdded"}, container))
@@ -418,12 +417,14 @@ describe("Tests functionality of Geyser.Container", function()
     it("drops the window from both of the container's lists", function()
       local container = track(Geyser.Container:new({name = "gcsRemove", x = 0, y = 0, width = 100, height = 100}))
       local label = track(Geyser.Label:new({name = "gcsRemoved"}, container))
+      -- a removed window is no longer anyone's child, so nothing else will
+      -- clean its widget up
+      finally(function() deleteLabel("gcsRemoved") end)
       container:remove(label)
       assert.is_nil(container.windowList.gcsRemoved)
       assert.are.same({}, container.windows)
       -- removing only unhooks the bookkeeping, the widget stays alive
       assert.is_not_nil(getWindowGeometry("gcsRemoved"))
-      deleteLabel("gcsRemoved")
     end)
   end)
 
@@ -472,20 +473,49 @@ describe("Tests functionality of Geyser.Container", function()
       local label = track(Geyser.Label:new({name = "gcsBackToMain", x = "50%", y = 0, width = 10, height = 10}, from))
       label:changeContainer("main")
       assert.are.equal(Geyser, label.container)
-      assert.are.equal(floor(0.5 * getMainWindowSize()), geometry("gcsBackToMain").x)
+      assert.are.equal(math.floor(0.5 * getMainWindowSize()), geometry("gcsBackToMain").x)
     end)
   end)
 
-  describe("Geyser:begin_update, Geyser:end_update and Geyser:reposition", function()
+  describe("Geyser:begin_update/end_update/reposition", function()
     it("toggles the deferred update flag", function()
+      -- leaving the flag set would stop every later spec repositioning
+      finally(function() Geyser.defer_updates = false end)
       Geyser:begin_update()
       assert.is_true(Geyser.defer_updates)
       Geyser:end_update()
       assert.is_false(Geyser.defer_updates)
     end)
+
+    it("holds back the layout of a box while its updates are deferred", function()
+      local box = track(Geyser.VBox:new({name = "gcsDeferred", x = 0, y = 0, width = 200, height = 200}))
+      box:begin_update()
+      finally(function() box.defer_updates = false end)
+      track(Geyser.Label:new({name = "gcsDeferredA"}, box))
+      track(Geyser.Label:new({name = "gcsDeferredB"}, box))
+      -- the children keep their own constraints instead of being stacked
+      assert.are.same({x = 10, y = 10, width = 300, height = 200}, geometry("gcsDeferredA"))
+      assert.are.same({x = 10, y = 10, width = 300, height = 200}, geometry("gcsDeferredB"))
+      box:end_update()
+      assert.is_false(box.defer_updates)
+      box:organize()
+      assert.are.same({x = 0, y = 0, width = 200, height = 100}, geometry("gcsDeferredA"))
+      assert.are.same({x = 0, y = 100, width = 200, height = 100}, geometry("gcsDeferredB"))
+    end)
+
+    it("lays a box out as its children arrive when updates are not deferred", function()
+      local box = track(Geyser.VBox:new({name = "gcsUndeferred", x = 0, y = 0, width = 200, height = 200}))
+      track(Geyser.Label:new({name = "gcsUndeferredA"}, box))
+      track(Geyser.Label:new({name = "gcsUndeferredB"}, box))
+      assert.are.same({x = 0, y = 0, width = 200, height = 100}, geometry("gcsUndeferredA"))
+      assert.are.same({x = 0, y = 100, width = 200, height = 100}, geometry("gcsUndeferredB"))
+    end)
   end)
 
   describe("GeyserReposition", function()
+    -- GeyserReposition works on every top level Geyser object, including any
+    -- another spec file left behind; that is harmless, as it only restores
+    -- each object to the geometry its own constraints ask for.
     it("restores geometry that was changed behind Geyser's back", function()
       local mainWidth, mainHeight = getMainWindowSize()
       track(Geyser.Label:new({name = "gcsReposition", x = 10, y = 10, width = 100, height = 50}))
@@ -544,7 +574,7 @@ describe("Tests functionality of Geyser.Container", function()
     end)
   end)
 
-  describe("Geyser.hideAll and Geyser.showAll", function()
+  describe("Geyser.hideAll/showAll", function()
     it("only touches windows of the type it is given", function()
       -- a private type keeps the sweep away from widgets other specs own
       local mine = track(Geyser.Container:new({name = "gcsSweep", type = "gcsprobe", x = 0, y = 0, width = 50, height = 50}))
diff --git a/src/mudlet-lua/tests/GeyserGauge_spec.lua b/src/mudlet-lua/tests/GeyserGauge_spec.lua
index a27c01826..99ae92807 100644
--- a/src/mudlet-lua/tests/GeyserGauge_spec.lua
+++ b/src/mudlet-lua/tests/GeyserGauge_spec.lua
@@ -34,7 +34,7 @@ describe("Tests functionality of Geyser.Gauge", function()
     created = {}
   end)
 
-  describe("Geyser.Gauge:new and Geyser.Gauge:new2", function()
+  describe("Geyser.Gauge:new/new2", function()
     it("builds a back, front and text label over the gauge's geometry", function()
       local gauge = track(Geyser.Gauge:new({name = "ggsNew", x = 10, y = 20, width = 200, height = 40}))
       assert.are.equal("gauge", gauge.type)
@@ -220,8 +220,9 @@ describe("Tests functionality of Geyser.Gauge", function()
       assert.is_truthy(text:find("", 1, true))
       assert.is_truthy(text:find("", 1, true))
       assert.is_truthy(text:find("", 1, true))
-      assert.are.equal(gauge.text.format, gauge.format)
+      assert.are.equal("8bius", gauge.format)
       assert.is_true(gauge.formatTable.bold)
+      assert.is_true(gauge.formatTable.strikethrough)
     end)
 
     it("sets the font size of the text label", function()
@@ -278,7 +279,7 @@ describe("Tests functionality of Geyser.Gauge", function()
 
   describe("Geyser.Gauge:type_delete", function()
     it("deletes the back, front and text labels with the gauge", function()
-      local gauge = Geyser.Gauge:new({name = "ggsDelete", x = 0, y = 0, width = 100, height = 20})
+      local gauge = track(Geyser.Gauge:new({name = "ggsDelete", x = 0, y = 0, width = 100, height = 20}))
       gauge:delete()
       for _, name in ipairs({"ggsDelete_back", "ggsDelete_front", "ggsDelete_text"}) do
         assert.is_nil(getWindowGeometry(name))
diff --git a/src/mudlet-lua/tests/GeyserHBox_spec.lua b/src/mudlet-lua/tests/GeyserHBox_spec.lua
index 71bc647f8..7168db7b3 100644
--- a/src/mudlet-lua/tests/GeyserHBox_spec.lua
+++ b/src/mudlet-lua/tests/GeyserHBox_spec.lua
@@ -34,7 +34,7 @@ describe("Tests functionality of Geyser.HBox", function()
     created = {}
   end)
 
-  describe("Geyser.HBox:new and Geyser.HBox:new2", function()
+  describe("Geyser.HBox:new/new2", function()
     it("defaults the type to hbox and starts empty", function()
       local box = track(Geyser.HBox:new({name = "ghbNew", x = 0, y = 0, width = 100, height = 100}))
       assert.are.equal("hbox", box.type)
@@ -49,7 +49,7 @@ describe("Tests functionality of Geyser.HBox", function()
     end)
   end)
 
-  describe("Geyser.HBox:add and Geyser.HBox:organize", function()
+  describe("Geyser.HBox:add/organize", function()
     it("gives a single child the whole box", function()
       local box = track(Geyser.HBox:new({name = "ghbOne", x = 10, y = 20, width = 200, height = 100}))
       track(Geyser.Label:new({name = "ghbOneChild"}, box))
@@ -91,9 +91,11 @@ describe("Tests functionality of Geyser.HBox", function()
       assert.are.same({x = 0, y = 0, width = 100, height = 60}, geometry("ghbFixedChild"))
       local dynamic = geometry("ghbDynamic")
       assert.are.equal(200, dynamic.width)
-      -- the dynamic child starts where the fixed one ends, up to the pixel the
-      -- percentage of a third loses to truncation
-      assert.is_true(dynamic.x == 99 or dynamic.x == 100, "unexpected x " .. tostring(dynamic.x))
+      -- the dynamic child should start at 100, where the fixed one ends, but
+      -- organize() hands out positions as percentages: a third of 300px comes
+      -- back as 99.999999999999 and Mudlet truncates it, leaving a one pixel
+      -- gap. Pinned so the day the layout is fixed this spec says so.
+      assert.are.equal(99, dynamic.x)
     end)
 
     it("gives a stretch factor its extra share of the width", function()
diff --git a/src/mudlet-lua/tests/GeyserLabel_spec.lua b/src/mudlet-lua/tests/GeyserLabel_spec.lua
index a7e2b43bc..d2de28fa8 100644
--- a/src/mudlet-lua/tests/GeyserLabel_spec.lua
+++ b/src/mudlet-lua/tests/GeyserLabel_spec.lua
@@ -110,7 +110,7 @@ end)
 -- Geometry, visibility and text readback for Geyser.Label, asserted against
 -- the widget itself through getWindowGeometry/windowVisible/getLabelText
 -- rather than by spying on the echo call.
-describe("Geyser.Label widget state", function()
+describe("Tests functionality of Geyser.Label widget state", function()
   local created
 
   local function geometry(name)
@@ -143,7 +143,7 @@ describe("Geyser.Label widget state", function()
     created = {}
   end)
 
-  describe("Geyser.Label:new and Geyser.Label:new2", function()
+  describe("Geyser.Label:new/new2", function()
     it("creates a visible label widget at the constrained geometry", function()
       local label = track(Geyser.Label:new({name = "glsNew", x = 15, y = 25, width = 120, height = 40}))
       assert.are.equal("label", label.type)
@@ -189,7 +189,7 @@ describe("Geyser.Label widget state", function()
     end)
   end)
 
-  describe("Geyser.Label:echo, rawEcho and clear", function()
+  describe("Geyser.Label:echo/rawEcho/decho/hecho/cecho and Geyser.Label:clear", function()
     local label
 
     before_each(function()
@@ -243,11 +243,17 @@ describe("Geyser.Label widget state", function()
 
     it("decho, hecho and cecho put their colours into the markup", function()
       label:decho("<0,0,255>blue")
-      assert.is_truthy(getLabelText("glsText"):find("blue", 1, true))
+      local blue = getLabelText("glsText")
+      assert.is_truthy(blue:find("blue", 1, true))
+      assert.is_truthy(blue:find("color: rgb(0, 0, 255)", 1, true))
       label:hecho("|cff0000red")
-      assert.is_truthy(getLabelText("glsText"):find("red", 1, true))
+      local red = getLabelText("glsText")
+      assert.is_truthy(red:find("red", 1, true))
+      assert.is_truthy(red:find("color: rgb(255, 0, 0)", 1, true))
       label:cecho("green")
-      assert.is_truthy(getLabelText("glsText"):find("green", 1, true))
+      local green = getLabelText("glsText")
+      assert.is_truthy(green:find("green", 1, true))
+      assert.is_truthy(green:find("color: rgb(0, 255, 0)", 1, true))
     end)
   end)
 
@@ -344,7 +350,7 @@ describe("Geyser.Label widget state", function()
     end)
   end)
 
-  describe("Geyser.Label:getSizeHint and the auto adjust family", function()
+  describe("Geyser.Label:getSizeHint and Geyser.Label auto-size adjustSize/adjustHeight/adjustWidth/autoAdjustSize/enableAutoAdjustSize/disableAutoAdjustSize", function()
     local label
 
     before_each(function()
@@ -356,7 +362,8 @@ describe("Geyser.Label widget state", function()
       local width, height = label:getSizeHint()
       assert.is_true(width > 0)
       assert.is_true(height > 0)
-      assert.is_true(width < 400)
+      -- the hint comes from the font metrics, so it is only bounded loosely
+      assert.is_true(width < 400, "size hint width was " .. tostring(width))
     end)
 
     it("adjustSize resizes the widget to the hint", function()
@@ -438,7 +445,7 @@ describe("Geyser.Label widget state", function()
 
   describe("Geyser.Label:type_delete", function()
     it("deletes the widget with the object", function()
-      local label = Geyser.Label:new({name = "glsDelete", x = 0, y = 0, width = 40, height = 20})
+      local label = track(Geyser.Label:new({name = "glsDelete", x = 0, y = 0, width = 40, height = 20}))
       assert.is_not_nil(getWindowGeometry("glsDelete"))
       label:delete()
       assert.is_nil(getWindowGeometry("glsDelete"))
@@ -446,7 +453,7 @@ describe("Geyser.Label widget state", function()
     end)
 
     it("clears the nested label bookkeeping", function()
-      local label = Geyser.Label:new({name = "glsNested", x = 0, y = 0, width = 40, height = 20})
+      local label = track(Geyser.Label:new({name = "glsNested", x = 0, y = 0, width = 40, height = 20}))
       label.nestedLabels = {"something"}
       label:delete()
       assert.are.same({}, label.nestedLabels)
diff --git a/src/mudlet-lua/tests/GeyserMiniConsole_spec.lua b/src/mudlet-lua/tests/GeyserMiniConsole_spec.lua
index 75fe1153f..18b0344d9 100644
--- a/src/mudlet-lua/tests/GeyserMiniConsole_spec.lua
+++ b/src/mudlet-lua/tests/GeyserMiniConsole_spec.lua
@@ -31,7 +31,7 @@ describe("Tests functionality of Geyser.MiniConsole", function()
     created = {}
   end)
 
-  describe("Geyser.MiniConsole:new and Geyser.MiniConsole:new2", function()
+  describe("Geyser.MiniConsole:new/new2", function()
     it("creates a miniconsole widget at the constrained geometry", function()
       local console = track(Geyser.MiniConsole:new({name = "gmcNew", x = 30, y = 40, width = 300, height = 150}))
       -- Geyser's own type string is camel cased, Mudlet's windowType is not
@@ -88,7 +88,7 @@ describe("Tests functionality of Geyser.MiniConsole", function()
     end)
   end)
 
-  describe("Geyser.MiniConsole:setWrap and the auto wrap family", function()
+  describe("Geyser.MiniConsole:setWrap/enableAutoWrap/disableAutoWrap/resetAutoWrap", function()
     it("sets the wrap column", function()
       local console = track(Geyser.MiniConsole:new({name = "gmcWrap", x = 0, y = 0, width = 300, height = 100}))
       console:setWrap(42)
@@ -137,7 +137,7 @@ describe("Tests functionality of Geyser.MiniConsole", function()
     end)
   end)
 
-  describe("Geyser.MiniConsole:setFontSize and Geyser.MiniConsole:getFont", function()
+  describe("Geyser.MiniConsole:setFontSize/getFont", function()
     it("changes the font size of the console", function()
       local console = track(Geyser.MiniConsole:new({name = "gmcFont", x = 0, y = 0, width = 300, height = 100, fontSize = 8}))
       assert.are.equal(8, getFontSize("gmcFont"))
@@ -155,10 +155,15 @@ describe("Tests functionality of Geyser.MiniConsole", function()
       assert.is_true(bigWrap < smallWrap)
     end)
 
-    it("reports the font family in use", function()
+    it("reads the font family back out of Mudlet", function()
       local console = track(Geyser.MiniConsole:new({name = "gmcFontFamily", x = 0, y = 0, width = 300, height = 100}))
-      assert.are.equal(getFont("gmcFontFamily"), console:getFont())
-      assert.are.equal(console.font, getFont("gmcFontFamily"))
+      local family = getFont("gmcFontFamily")
+      assert.are.equal("string", type(family))
+      assert.is_true(#family > 0)
+      -- getFont refreshes the cached family rather than reporting the cache
+      console.font = "not the real font"
+      assert.are.equal(family, console:getFont())
+      assert.are.equal(family, console.font)
     end)
   end)
 
@@ -174,7 +179,7 @@ describe("Tests functionality of Geyser.MiniConsole", function()
 
   describe("Geyser.MiniConsole:type_delete", function()
     it("deletes the widget with the object", function()
-      local console = Geyser.MiniConsole:new({name = "gmcDelete", x = 0, y = 0, width = 100, height = 50})
+      local console = track(Geyser.MiniConsole:new({name = "gmcDelete", x = 0, y = 0, width = 100, height = 50}))
       assert.is_not_nil(getWindowGeometry("gmcDelete"))
       console:delete()
       assert.is_nil(getWindowGeometry("gmcDelete"))
diff --git a/src/mudlet-lua/tests/GeyserVBox_spec.lua b/src/mudlet-lua/tests/GeyserVBox_spec.lua
index 1fa23d398..7b526b6e5 100644
--- a/src/mudlet-lua/tests/GeyserVBox_spec.lua
+++ b/src/mudlet-lua/tests/GeyserVBox_spec.lua
@@ -34,7 +34,7 @@ describe("Tests functionality of Geyser.VBox", function()
     created = {}
   end)
 
-  describe("Geyser.VBox:new and Geyser.VBox:new2", function()
+  describe("Geyser.VBox:new/new2", function()
     it("defaults the type to VBox and starts empty", function()
       local box = track(Geyser.VBox:new({name = "gvbNew", x = 0, y = 0, width = 100, height = 100}))
       assert.are.equal("VBox", box.type)
@@ -50,7 +50,7 @@ describe("Tests functionality of Geyser.VBox", function()
     end)
   end)
 
-  describe("Geyser.VBox:add and Geyser.VBox:organize", function()
+  describe("Geyser.VBox:add/organize", function()
     it("gives a single child the whole box", function()
       local box = track(Geyser.VBox:new({name = "gvbOne", x = 10, y = 20, width = 200, height = 100}))
       track(Geyser.Label:new({name = "gvbOneChild"}, box))
diff --git a/src/mudlet-lua/tests/GeyserWindow_spec.lua b/src/mudlet-lua/tests/GeyserWindow_spec.lua
index 39e49c3c4..22215de1f 100644
--- a/src/mudlet-lua/tests/GeyserWindow_spec.lua
+++ b/src/mudlet-lua/tests/GeyserWindow_spec.lua
@@ -1,11 +1,15 @@
 -- Geyser.Window is the abstract base for the Mudlet primitives that hold text.
 -- Its methods are exercised through a Geyser.MiniConsole, the simplest
 -- subclass that owns a real widget, and read back with the console getters.
--- Selects the most recently echoed line so getCurrentLine/getTextFormat report
--- on it. Mudlet does not count the empty line the trailing newline leaves
--- behind, so the last written line is the last one getLineCount knows about.
+
+-- Selects the line last written by a newline terminated echo so
+-- getCurrentLine/getTextFormat report on it. getLineCount returns the index of
+-- the console's last line rather than a count, and the trailing newline leaves
+-- the cursor on that (still empty) last line, so the text is one line above it.
 local function lastLine(name)
-  moveCursor(name, 0, getLineCount(name) - 1)
+  local index = getLineCount(name) - 1
+  assert.is_true(index >= 0, "nothing has been echoed to " .. name .. " yet")
+  moveCursor(name, 0, index)
   selectCurrentLine(name)
   return getCurrentLine(name)
 end
@@ -58,7 +62,7 @@ describe("Tests functionality of Geyser.Window", function()
     end)
   end)
 
-  describe("Geyser.Window:echo, cecho, decho and hecho", function()
+  describe("Geyser.Window:echo/cecho/decho/hecho", function()
     it("echoes plain text and remembers the message", function()
       console:echo("plain line\n")
       assert.are.equal("plain line\n", console.message)
@@ -91,7 +95,7 @@ describe("Tests functionality of Geyser.Window", function()
     end)
   end)
 
-  describe("Geyser.Window:setFgColor, setBgColor, getFgColor and getBgColor", function()
+  describe("Geyser.Window:getFgColor/getBgColor/setBgColor/setFgColor", function()
     it("round-trips the foreground colour", function()
       console:setFgColor(255, 0, 0)
       console:echo("coloured\n")
@@ -125,7 +129,7 @@ describe("Tests functionality of Geyser.Window", function()
     end)
   end)
 
-  describe("Geyser.Window:setTextFormat, setBold, setUnderline and setItalics", function()
+  describe("Geyser.Window:setTextFormat/setBold/setUnderline/setItalics", function()
     it("starts out with no attributes set", function()
       console:echo("first\n")
       lastLine("gwsConsole")

From b58eefc000e8cc2f151579f3628ba5c1a0a3427d Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Sun, 2 Aug 2026 11:55:03 +0200
Subject: [PATCH 049/155] infrastructure: deepen the Geyser specs after
 test-coverage review

Assert the raise/lower recursion through the calls it makes, add the
remaining constraint forms (negative percentage, negative width, bare
negative numbers, function constraints) and their error contract, cover
the gauge CSS shorthand arities, an all-fixed container, the HBox fixed
child resize and Adjustable.Container padding.

Assisted-by: Claude:claude-opus-4-8
---
 .../tests/GeyserAdjustableContainer_spec.lua  |  15 +++
 src/mudlet-lua/tests/GeyserContainer_spec.lua | 115 +++++++++++++++++-
 src/mudlet-lua/tests/GeyserGauge_spec.lua     |  31 +++++
 src/mudlet-lua/tests/GeyserHBox_spec.lua      |  12 ++
 .../tests/GeyserMiniConsole_spec.lua          |   3 +-
 src/mudlet-lua/tests/GeyserVBox_spec.lua      |   3 +
 6 files changed, 175 insertions(+), 4 deletions(-)

diff --git a/src/mudlet-lua/tests/GeyserAdjustableContainer_spec.lua b/src/mudlet-lua/tests/GeyserAdjustableContainer_spec.lua
index c04d434c4..d6d8d664b 100644
--- a/src/mudlet-lua/tests/GeyserAdjustableContainer_spec.lua
+++ b/src/mudlet-lua/tests/GeyserAdjustableContainer_spec.lua
@@ -174,6 +174,21 @@ describe("Tests functionality of Adjustable.Container", function()
       assert.are.same({x = 60, y = 70, width = 100, height = 120}, geometry("gasContaineradjLabel"))
     end)
 
+    it("puts a child inside the padding and below the title bar", function()
+      Geyser.Label:new({name = "gasChild", x = 0, y = 0, width = "100%", height = "100%"}, container)
+      -- padding on the left and right, twice that at the top to leave room for
+      -- the title bar
+      assert.are.equal(10, container.padding)
+      assert.are.same({x = 30, y = 50, width = 180, height = 170}, geometry("gasChild"))
+    end)
+
+    it("setPadding moves and resizes the children", function()
+      Geyser.Label:new({name = "gasPaddedChild", x = 0, y = 0, width = "100%", height = "100%"}, container)
+      container:setPadding(30)
+      assert.are.equal(30, container.padding)
+      assert.are.same({x = 50, y = 90, width = 140, height = 110}, geometry("gasPaddedChild"))
+    end)
+
     it("hides and shows every widget it owns", function()
       container:hide()
       assert.is_false(windowVisible("gasContaineradjLabel"))
diff --git a/src/mudlet-lua/tests/GeyserContainer_spec.lua b/src/mudlet-lua/tests/GeyserContainer_spec.lua
index dc9eb5312..7ba2cf2d2 100644
--- a/src/mudlet-lua/tests/GeyserContainer_spec.lua
+++ b/src/mudlet-lua/tests/GeyserContainer_spec.lua
@@ -141,6 +141,62 @@ describe("Tests functionality of Geyser.Container", function()
       assert.are.same({x = 300, y = 150, width = 200, height = 100}, geometry("gcsBoxChild"))
     end)
 
+    it("treats a negative percentage as the remainder of the container", function()
+      local container = track(Geyser.Container:new({name = "gcsNegBox", x = 0, y = 0, width = 200, height = 100}))
+      track(Geyser.Label:new({name = "gcsNegPercent", x = "-25%", y = 0, width = "-50%", height = "100%"}, container))
+      -- -25% means 75% along, -50% means half the container wide
+      assert.are.same({x = 150, y = 0, width = 100, height = 100}, geometry("gcsNegPercent"))
+    end)
+
+    it("stretches a negative width to the far edge of the container", function()
+      local container = track(Geyser.Container:new({name = "gcsNegWidthBox", x = 0, y = 0, width = 200, height = 100}))
+      track(Geyser.Label:new({name = "gcsNegWidth", x = 10, y = 0, width = "-10px", height = 20}, container))
+      -- from x 10 to ten pixels short of the container's right edge
+      assert.are.same({x = 10, y = 0, width = 180, height = 20}, geometry("gcsNegWidth"))
+    end)
+
+    it("measures a bare negative number from the far edge too", function()
+      local container = track(Geyser.Container:new({name = "gcsBareBox", x = 0, y = 0, width = 200, height = 100}))
+      track(Geyser.Label:new({name = "gcsBareNegative", x = -5, y = 0, width = 20, height = 20}, container))
+      assert.are.equal(195, geometry("gcsBareNegative").x)
+    end)
+
+    it("calls a constraint that is a function", function()
+      local container = track(Geyser.Container:new({name = "gcsFuncBox", x = 0, y = 0, width = 200, height = 100}))
+      track(Geyser.Label:new({
+        name = "gcsFunctionConstraint",
+        x = function() return 25 end,
+        y = 0,
+        width = function() return 50 end,
+        height = 20,
+      }, container))
+      assert.are.same({x = 25, y = 0, width = 50, height = 20}, geometry("gcsFunctionConstraint"))
+    end)
+
+    it("raises an error on a constraint it cannot parse", function()
+      -- the object is registered before its constraints are resolved, so the
+      -- failed attempt has to be swept out of the root window list by hand
+      finally(function()
+        local zombie = Geyser.windowList.gcsBadConstraint
+        if zombie then
+          zombie:delete()
+        end
+      end)
+      local ok, message = pcall(function()
+        return Geyser.Label:new({name = "gcsBadConstraint", x = 0, y = 0, width = true, height = 20})
+      end)
+      assert.is_false(ok)
+      assert.is_truthy(tostring(message):find("GeyserSetConstraints.lua", 1, true))
+      assert.is_nil(getWindowGeometry("gcsBadConstraint"))
+    end)
+
+    it("leaves the widget where it was when a move is given a bad constraint", function()
+      local label = track(Geyser.Label:new({name = "gcsBadMove", x = 10, y = 10, width = 50, height = 50}))
+      local ok = pcall(function() label:move("nonsense", 20) end)
+      assert.is_false(ok)
+      assert.are.same({x = 10, y = 10, width = 50, height = 50}, geometry("gcsBadMove"))
+    end)
+
     it("resolves percentages through two levels of nesting", function()
       local outer = track(Geyser.Container:new({name = "gcsOuter", x = 100, y = 50, width = 400, height = 200}))
       local middle = track(Geyser.Container:new({name = "gcsMiddle", x = "50%", y = 0, width = "50%", height = "100%"}, outer))
@@ -267,10 +323,35 @@ describe("Tests functionality of Geyser.Container", function()
       assert.are.same({"gcsStack1", "gcsStack2"}, container.windows)
     end)
 
-    it("keeps the relative order when raising or lowering the whole container", function()
+    -- raiseAll and lowerAll leave container.windows untouched by design (they
+    -- raise children with changeWindowIndex false), and Mudlet has no z-order
+    -- readback, so the only observable is which windows they hand to
+    -- raiseWindow/lowerWindow and in what order. busted's spy calls the real
+    -- function through, so this still exercises Mudlet itself.
+    it("raises itself and then every child, top down", function()
+      local raised = spy.on(_G, "raiseWindow")
+      finally(function() _G.raiseWindow:revert() end)
       container:raiseAll()
+      assert.spy(raised).was.called(3)
+      local order = {}
+      for index, call in ipairs(raised.calls) do
+        order[index] = call.vals[1]
+      end
+      assert.are.same({"gcsStack", "gcsStack1", "gcsStack2"}, order)
       assert.are.same({"gcsStack1", "gcsStack2"}, container.windows)
+    end)
+
+    it("lowers the deepest child first and itself last", function()
+      local lowered = spy.on(_G, "lowerWindow")
+      finally(function() _G.lowerWindow:revert() end)
       container:lowerAll()
+      assert.spy(lowered).was.called(3)
+      local order = {}
+      for index, call in ipairs(lowered.calls) do
+        order[index] = call.vals[1]
+      end
+      -- reverse order, so the children keep their stacking relative to each other
+      assert.are.same({"gcsStack2", "gcsStack1", "gcsStack"}, order)
       assert.are.same({"gcsStack1", "gcsStack2"}, container.windows)
       -- lowerAll walks the tree through a scratch table it must clean up again
       assert.is_nil(Geyser.Container.windowTable)
@@ -316,7 +397,9 @@ describe("Tests functionality of Geyser.Container", function()
       assert.are.equal(8, container.fontSize)
     end)
 
-    it("re-resolves character sized constraints for its children", function()
+    -- the container's own size is what changes here; a child that carries its
+    -- own character constraint keeps its own fontSize and does not follow
+    it("re-resolves its own character sized constraints, moving its children with it", function()
       local container = track(Geyser.Container:new({name = "gcsFontBox", x = 0, y = 0, width = "20c", height = "4c", fontSize = 8}))
       track(Geyser.Label:new({name = "gcsFontChild", x = 0, y = 0, width = "100%", height = "100%"}, container))
       local smallWidth, smallHeight = calcFontSize(8)
@@ -356,6 +439,20 @@ describe("Tests functionality of Geyser.Container", function()
       assert.are.same({width = 200, height = 150}, container:calculate_dynamic_window_size())
     end)
 
+    it("reports no share at all when every window is fixed", function()
+      local container = track(Geyser.Container:new({name = "gcsDyn5", x = 0, y = 0, width = 200, height = 100}))
+      for index = 1, 2 do
+        track(Geyser.Label:new({
+          name = "gcsDyn5Fixed" .. index,
+          width = 100,
+          height = 50,
+          h_policy = Geyser.Fixed,
+          v_policy = Geyser.Fixed,
+        }, container))
+      end
+      assert.are.same({width = 0, height = 0}, container:calculate_dynamic_window_size())
+    end)
+
     it("accounts for a stretch factor", function()
       local container = track(Geyser.Container:new({name = "gcsDyn4", x = 0, y = 0, width = 400, height = 400}))
       track(Geyser.Label:new({name = "gcsDyn4A", v_stretch_factor = 3}, container))
@@ -503,6 +600,15 @@ describe("Tests functionality of Geyser.Container", function()
       assert.are.same({x = 0, y = 100, width = 200, height = 100}, geometry("gcsDeferredB"))
     end)
 
+    it("does nothing when Geyser:reposition is called outside a resize event", function()
+      -- Geyser:reposition hands GeyserReposition no event, and GeyserReposition
+      -- only acts on the two resize events, so this is a no-op by construction
+      track(Geyser.Label:new({name = "gcsRepositionNoop", x = 10, y = 10, width = 100, height = 50}))
+      moveWindow("gcsRepositionNoop", 300, 300)
+      Geyser:reposition()
+      assert.are.equal(300, geometry("gcsRepositionNoop").x)
+    end)
+
     it("lays a box out as its children arrive when updates are not deferred", function()
       local box = track(Geyser.VBox:new({name = "gcsUndeferred", x = 0, y = 0, width = 200, height = 200}))
       track(Geyser.Label:new({name = "gcsUndeferredA"}, box))
@@ -575,6 +681,9 @@ describe("Tests functionality of Geyser.Container", function()
   end)
 
   describe("Geyser.hideAll/showAll", function()
+    -- calling either without a type would sweep every Geyser widget in the
+    -- profile, including the ones other spec files own, so only the filtered
+    -- form is exercised here
     it("only touches windows of the type it is given", function()
       -- a private type keeps the sweep away from widgets other specs own
       local mine = track(Geyser.Container:new({name = "gcsSweep", type = "gcsprobe", x = 0, y = 0, width = 50, height = 50}))
@@ -586,7 +695,7 @@ describe("Tests functionality of Geyser.Container", function()
       Geyser.showAll("gcsprobe")
       assert.is_true(windowVisible("gcsSweepChild"))
       assert.is_true(windowVisible("gcsUnswept"))
-      assert.is_not_nil(mine.windowList.gcsSweepChild)
+      assert.is_false(mine.hidden)
     end)
   end)
 
diff --git a/src/mudlet-lua/tests/GeyserGauge_spec.lua b/src/mudlet-lua/tests/GeyserGauge_spec.lua
index 99ae92807..d851f7c6a 100644
--- a/src/mudlet-lua/tests/GeyserGauge_spec.lua
+++ b/src/mudlet-lua/tests/GeyserGauge_spec.lua
@@ -159,6 +159,37 @@ describe("Tests functionality of Geyser.Gauge", function()
       assert.are.same({x = 5, y = 5, width = 190, height = 30}, geometry("ggsMargin_front"))
     end)
 
+    it("reads a two value margin as vertical then horizontal", function()
+      local gauge = track(Geyser.Gauge:new({name = "ggsTwoValue", x = 0, y = 0, width = 200, height = 100}))
+      gauge:setStyleSheet("margin: 10px 30px;", "margin: 10px 30px;")
+      assert.are.same({x = 30, y = 10, width = 140, height = 80}, geometry("ggsTwoValue_front"))
+    end)
+
+    it("reads a four value margin as top, right, bottom, left", function()
+      local gauge = track(Geyser.Gauge:new({name = "ggsFourValue", x = 0, y = 0, width = 200, height = 100}))
+      gauge:setStyleSheet("margin: 1px 2px 3px 4px;", "margin: 1px 2px 3px 4px;")
+      assert.are.same({x = 4, y = 1, width = 194, height = 96}, geometry("ggsFourValue_front"))
+    end)
+
+    it("makes room for a border on the back label", function()
+      local gauge = track(Geyser.Gauge:new({name = "ggsBorder", x = 0, y = 0, width = 200, height = 100}))
+      gauge:setStyleSheet("border: 2px solid red;", "border: 2px solid red;")
+      assert.are.same({x = 2, y = 2, width = 196, height = 96}, geometry("ggsBorder_front"))
+    end)
+
+    it("makes room for padding on the back label", function()
+      local gauge = track(Geyser.Gauge:new({name = "ggsPadding", x = 0, y = 0, width = 200, height = 100}))
+      gauge:setStyleSheet("padding: 3px;", "padding: 3px;")
+      assert.are.same({x = 3, y = 3, width = 194, height = 94}, geometry("ggsPadding_front"))
+    end)
+
+    it("adds margin, border and padding together", function()
+      local gauge = track(Geyser.Gauge:new({name = "ggsCombined", x = 0, y = 0, width = 200, height = 100}))
+      local css = "margin: 2px; border: 1px solid red; padding: 3px;"
+      gauge:setStyleSheet(css, css)
+      assert.are.same({x = 6, y = 6, width = 188, height = 88}, geometry("ggsCombined_front"))
+    end)
+
     it("strips the margin from the front stylesheet but not the back", function()
       local gauge = track(Geyser.Gauge:new({name = "ggsCss", x = 0, y = 0, width = 200, height = 40}))
       gauge:setStyleSheet("margin: 5px; background-color: red;", "margin: 5px; background-color: blue;")
diff --git a/src/mudlet-lua/tests/GeyserHBox_spec.lua b/src/mudlet-lua/tests/GeyserHBox_spec.lua
index 7168db7b3..eca123c7d 100644
--- a/src/mudlet-lua/tests/GeyserHBox_spec.lua
+++ b/src/mudlet-lua/tests/GeyserHBox_spec.lua
@@ -42,6 +42,9 @@ describe("Tests functionality of Geyser.HBox", function()
       assert.is_nil(getWindowGeometry("ghbNew"))
     end)
 
+    -- children of a new2 box are not laid out at all: HBox overrides add but
+    -- not add2, so organize() is never reached. Left unspecified rather than
+    -- pinned, since the layout is what a caller of new2 is asking for.
     it("new2 marks the box as using add2", function()
       local box = track(Geyser.HBox:new2({name = "ghbNew2", x = 0, y = 0, width = 100, height = 100}))
       assert.is_true(box.useAdd2)
@@ -127,6 +130,15 @@ describe("Tests functionality of Geyser.HBox", function()
       assert.are.same({x = 10, y = 20, width = 50, height = 50}, geometry("ghbMoveA"))
       assert.are.same({x = 60, y = 20, width = 50, height = 50}, geometry("ghbMoveB"))
     end)
+
+    it("keeps a fixed child flush against its neighbour after a resize", function()
+      local fixedBox = track(Geyser.HBox:new({name = "ghbFixedMove", x = 0, y = 0, width = 200, height = 60}))
+      track(Geyser.Label:new({name = "ghbFixedMoveA", width = 50, h_policy = Geyser.Fixed}, fixedBox))
+      track(Geyser.Label:new({name = "ghbFixedMoveB"}, fixedBox))
+      fixedBox:resize(250, 60)
+      assert.are.same({x = 0, y = 0, width = 50, height = 60}, geometry("ghbFixedMoveA"))
+      assert.are.same({x = 50, y = 0, width = 200, height = 60}, geometry("ghbFixedMoveB"))
+    end)
   end)
 
   describe("Geyser.HBox visibility", function()
diff --git a/src/mudlet-lua/tests/GeyserMiniConsole_spec.lua b/src/mudlet-lua/tests/GeyserMiniConsole_spec.lua
index 18b0344d9..1857b4620 100644
--- a/src/mudlet-lua/tests/GeyserMiniConsole_spec.lua
+++ b/src/mudlet-lua/tests/GeyserMiniConsole_spec.lua
@@ -99,10 +99,11 @@ describe("Tests functionality of Geyser.MiniConsole", function()
     it("refuses to set the wrap while auto wrap is on", function()
       local console = track(Geyser.MiniConsole:new({name = "gmcWrapLocked", x = 0, y = 0, width = 300, height = 100}))
       console:enableAutoWrap()
+      local derivedWrap = getWindowWrap("gmcWrapLocked")
       local result, message = console:setWrap(11)
       assert.is_nil(result)
       assert.is_truthy(message:find("autoWrap is enabled", 1, true))
-      assert.are_not.equal(11, getWindowWrap("gmcWrapLocked"))
+      assert.are.equal(derivedWrap, getWindowWrap("gmcWrapLocked"))
     end)
 
     it("derives the wrap from the width when auto wrap is on", function()
diff --git a/src/mudlet-lua/tests/GeyserVBox_spec.lua b/src/mudlet-lua/tests/GeyserVBox_spec.lua
index 7b526b6e5..5aab5092a 100644
--- a/src/mudlet-lua/tests/GeyserVBox_spec.lua
+++ b/src/mudlet-lua/tests/GeyserVBox_spec.lua
@@ -43,6 +43,9 @@ describe("Tests functionality of Geyser.VBox", function()
       assert.is_nil(getWindowGeometry("gvbNew"))
     end)
 
+    -- children of a new2 box are not laid out at all: VBox overrides add but
+    -- not add2, so organize() is never reached. Left unspecified rather than
+    -- pinned, since the layout is what a caller of new2 is asking for.
     it("new2 marks the box as using add2", function()
       local box = track(Geyser.VBox:new2({name = "gvbNew2", x = 0, y = 0, width = 100, height = 100}))
       assert.is_true(box.useAdd2)

From 56eded5f603130d806a5a2914b0da3c140f90d46 Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Sun, 2 Aug 2026 16:19:18 +0200
Subject: [PATCH 050/155] fix: Adjustable.Container resetTitle error and delete
 leaks

resetTitle() nils titleText and lets setTitle() rebuild the default, but
that default was string.format("%s - Adjustable Container") with nothing
to fill the %s, so it always threw. Feed it the container's name. Its
colour fallback is likewise only reachable once resetTitle() has cleared
it, so point that at the constructor's grey for a reset to restore what
creation produced.

Deleting a container left a lot behind. Right click menu labels are
created as top level Geyser objects rather than as children of the menu,
so Geyser.Container:delete()'s cascade never reached them: 15 labels per
container, plus the menu's "More..." labels, plus its
Adjustable.Container.all / all_windows entries. The autosave handler and,
for an attached container, the resize handler and the
Adjustable.Container.Attached entry outlived it too, so a deleted
container kept saving itself over whatever later took its name and kept
reserving a main window border. Clean all of it up in a type_delete().

Labels are only deleted while still registered against the container they
were added to, so deleting a stale handle cannot take a same-named live
container's widgets with it, and menus belonging to a container in a user
window are still found.

Fixes #9582
Fixes #9583

Assisted-by: Claude:claude-opus-5
---
 .../lua/geyser/GeyserAdjustableContainer.lua  |  83 +++++++++-
 .../tests/GeyserAdjustableContainer_spec.lua  | 144 +++++++++++++++---
 2 files changed, 206 insertions(+), 21 deletions(-)

diff --git a/src/mudlet-lua/lua/geyser/GeyserAdjustableContainer.lua b/src/mudlet-lua/lua/geyser/GeyserAdjustableContainer.lua
index 3d36132e8..0dfa769cb 100644
--- a/src/mudlet-lua/lua/geyser/GeyserAdjustableContainer.lua
+++ b/src/mudlet-lua/lua/geyser/GeyserAdjustableContainer.lua
@@ -60,8 +60,10 @@ end
 -- @param format A format list to use. 'c' - center, 'l' - left, 'r' - right,  'b' - bold, 'i' - italics, 'u' - underline, 's' - strikethrough,  '##' - font size.  For example, "cb18" specifies center bold 18pt font be used.  Order doesn't matter.
 function Adjustable.Container:setTitle(text, color, format)
     self.titleFormat = format or self.titleFormat or "l"
-    self.titleText = text or self.titleText or string.format("%s - Adjustable Container")
-    self.titleTxtColor = color or self.titleTxtColor or "green"
+    self.titleText = text or self.titleText or string.format("%s - Adjustable Container", self.name)
+    -- the fallback is only reached once resetTitle() has cleared the colour, so
+    -- it has to be the constructor's default for a reset to restore it
+    self.titleTxtColor = color or self.titleTxtColor or "grey"
     if self.locked and (self.connectedContainers or self.lockStyle == "standard" or self.lockStyle == "border" or self.lockStyle == "full") then
         return
     end
@@ -857,6 +859,81 @@ function Adjustable.Container:reposition()
     )
 end
 
+-- internal function: a container recreated under the same name builds its labels
+-- with the same widget names, so deleting the stale object must not take the live
+-- container's widgets with it
+-- @param label the label to delete if it is still the registered one
+local function deleteIfStillRegistered(label)
+    -- ask the container the label was added to: menu labels of a container that
+    -- lives in a user window are registered there, not in Geyser.windowList
+    local windowList = label and label.delete and label.container and label.container.windowList
+    if windowList and windowList[label.name] == label then
+        label:delete()
+    end
+end
+
+-- internal function to delete the "More..." labels doNestShow adds to a menu that
+-- does not fit on screen. They are kept in Geyser.Label.scrollV/scrollH, keyed by
+-- the menu they scroll, rather than in the menu's own MenuLabels.
+-- @param label the menu label whose scroll labels are to be deleted
+local function deleteScrollLabels(label)
+    for _, cache in pairs({vertical = Geyser.Label.scrollV, horizontal = Geyser.Label.scrollH}) do
+        local scrollLabels = cache[label]
+        if scrollLabels then
+            cache[label] = nil
+            for _, scrollLabel in ipairs(scrollLabels) do
+                deleteIfStillRegistered(scrollLabel)
+            end
+        end
+    end
+end
+
+-- internal function to delete the labels of a right click menu and of all its submenus.
+-- Menu labels are created as top level Geyser objects rather than as children of
+-- the menu they belong to, so Geyser.Container:delete()'s cascade never reaches them.
+-- @param menu the menu label whose MenuLabels are to be deleted
+local function deleteMenuLabels(menu)
+    if not menu or not menu.MenuLabels then
+        return
+    end
+    local menuLabels = menu.MenuLabels
+    menu.MenuLabels = {}
+    deleteScrollLabels(menu)
+    for _, label in pairs(menuLabels) do
+        deleteMenuLabels(label)
+        deleteIfStillRegistered(label)
+    end
+end
+
+-- internal function called by Geyser.Container:delete() to clean up what the
+-- delete cascade cannot reach: the right click menu labels, the event handlers
+-- that keep firing on a deleted container, and the container's entries in
+-- Adjustable.Container's own bookkeeping
+function Adjustable.Container:type_delete()
+    deleteMenuLabels(self.adjLabel and self.adjLabel.rightClickMenu)
+    -- detach() also kills the resize handler and drops the container out of
+    -- Adjustable.Container.Attached, which otherwise keeps reserving a border
+    if self.attached then
+        self:detach()
+    end
+    self:disconnect()
+    -- not disableAutoSave(), which kills an already nil handler and errors
+    if self.autoSaveHandler then
+        killAnonymousEventHandler(self.autoSaveHandler)
+        self.autoSaveHandler = nil
+    end
+    self.autoSave = false
+    -- a container recreated under the same name has taken over the registration,
+    -- so only unregister while it is still ours
+    if Adjustable.Container.all[self.name] == self then
+        Adjustable.Container.all[self.name] = nil
+        local index = table.index_of(Adjustable.Container.all_windows, self.name)
+        if index then
+            table.remove(Adjustable.Container.all_windows, index)
+        end
+    end
+end
+
 --- deletes the file where your saved settings are stored
 -- @param dir defines directory where the saved file is in [optional]
 -- @see Adjustable.Container:save
@@ -1040,7 +1117,7 @@ end
 --@param cons.attLabel.txt  text of the "attached menu" item
 --@param cons.lockStylesLabel.txt  text of the "lockstyle menu" item
 --@param cons.customItemsLabel.txt  text of the "custom menu" item
---@param[opt="green"] cons.titleTxtColor  color of the title text
+--@param[opt="grey"] cons.titleTxtColor  color of the title text
 --@param cons.titleText  title text
 --@param cons.titleFormat  a format list to use. 'c' - center, 'l' - left, 'r' - right,  'b' - bold, 'i' - italics, 'u' - underline, 's' - strikethrough,  '##' - font size.
 --@param[opt="standard"] cons.lockStyle  choose lockstyle at creation. possible integrated lockstyle are: "standard", "border", "light" and "full"
diff --git a/src/mudlet-lua/tests/GeyserAdjustableContainer_spec.lua b/src/mudlet-lua/tests/GeyserAdjustableContainer_spec.lua
index d6d8d664b..c80571fe8 100644
--- a/src/mudlet-lua/tests/GeyserAdjustableContainer_spec.lua
+++ b/src/mudlet-lua/tests/GeyserAdjustableContainer_spec.lua
@@ -16,10 +16,12 @@ describe("Tests functionality of Adjustable.Container", function()
     end)
 
     after_each(function()
-      -- Clean up the container after each test
-      if testContainer then
-        testContainer:hide()
+      -- deleting rather than hiding keeps the container, its right click menu
+      -- and the submenu addConnectMenu builds out of every later spec file
+      if testContainer and Geyser.windowList.testAdjustableContainer == testContainer then
+        testContainer:delete()
       end
+      testContainer = nil
     end)
 
     it("should successfully add connect menu on first call", function()
@@ -107,7 +109,7 @@ describe("Tests functionality of Adjustable.Container", function()
       assert.equals(10, ac.padding)
       assert.equals("standard", ac.lockStyle)
 
-      ac:hide()
+      ac:delete()
     end)
   end)
 
@@ -115,13 +117,32 @@ describe("Tests functionality of Adjustable.Container", function()
   -- container builds rather than on its bookkeeping alone.
   describe("Adjustable.Container widget state", function()
     local container
+    local topLevelBefore
 
     local function geometry(name)
       local x, y, width, height = getWindowGeometry(name)
       return {x = x, y = y, width = width, height = height}
     end
 
+    -- Every top level Geyser object registered since this spec's container was
+    -- built. Snapshotting rather than matching on the container's name catches
+    -- leaks whatever they are called, such as the menu's "More..." labels.
+    local function newTopLevelObjects()
+      local new = {}
+      for name in pairs(Geyser.windowList) do
+        if not topLevelBefore[name] then
+          new[#new + 1] = name
+        end
+      end
+      table.sort(new)
+      return new
+    end
+
     before_each(function()
+      topLevelBefore = {}
+      for name in pairs(Geyser.windowList) do
+        topLevelBefore[name] = true
+      end
       container = Adjustable.Container:new({
         name = "gasContainer",
         x = 20,
@@ -134,21 +155,17 @@ describe("Tests functionality of Adjustable.Container", function()
     end)
 
     after_each(function()
+      -- a delete that throws must not skip the sweep below, or it strands the
+      -- container and its menu labels for the rest of the suite
+      local deleted, deleteError = true, nil
       if container and Geyser.windowList.gasContainer == container then
-        container:delete()
+        deleted, deleteError = pcall(function() container:delete() end)
       end
       container = nil
-      -- Deleting an Adjustable.Container does not take its right click menu
-      -- labels with it: they are registered as top level Geyser objects, so
-      -- the cascade never reaches them. Sweep them by name, and unregister
-      -- the container from Adjustable's own bookkeeping, so nothing of this
-      -- spec is left behind for the rest of the suite.
-      local leftovers = {}
-      for name in pairs(Geyser.windowList) do
-        if name:find("^gasContainer") then
-          leftovers[#leftovers + 1] = name
-        end
-      end
+      -- the whole suite shares one Lua state, so anything left registered here
+      -- would follow later spec files around: sweep it, but report it rather
+      -- than quietly repairing a delete that stopped cleaning up after itself
+      local leftovers = newTopLevelObjects()
       for _, name in ipairs(leftovers) do
         local object = Geyser.windowList[name]
         if object then
@@ -160,6 +177,12 @@ describe("Tests functionality of Adjustable.Container", function()
       if index then
         table.remove(Adjustable.Container.all_windows, index)
       end
+      -- the delete throwing is the root cause, so report it ahead of the leak
+      -- it would have caused
+      if not deleted then
+        error(deleteError)
+      end
+      assert.are.same({}, leftovers)
     end)
 
     it("puts its backdrop label over the container's geometry", function()
@@ -240,13 +263,98 @@ describe("Tests functionality of Adjustable.Container", function()
       assert.are.same({x = 20, y = 30, width = 200, height = 200}, geometry("gasContaineradjLabel"))
     end)
 
+    it("titles itself after its name again after resetTitle", function()
+      container:setTitle("My Title", "red", "c")
+      container:resetTitle()
+      assert.are.equal("gasContainer - Adjustable Container", container.titleText)
+      -- back to what the constructor produced, colour and alignment included
+      assert.are.equal("grey", container.titleTxtColor)
+      assert.are.equal("l", container.titleFormat)
+      local text = getLabelText("gasContaineradjLabel")
+      assert.is_truthy(text:find("gasContainer - Adjustable Container", 1, true))
+      assert.is_truthy(text:find("color: " .. Geyser.Color.hex("grey"), 1, true))
+    end)
+
     it("deletes the container and its backdrop label", function()
-      -- the right click menu labels it created are not part of the cascade,
-      -- so they are swept by name in after_each instead
       container:delete()
       assert.is_nil(getWindowGeometry("gasContaineradjLabel"))
       assert.is_nil(getWindowGeometry("gasContainerexitLabel"))
       assert.is_nil(Geyser.windowList.gasContainer)
     end)
+
+    it("takes its right click menu labels and its registration with it", function()
+      -- menu labels are registered as top level Geyser objects rather than as
+      -- children of the menu, so only the container's own delete reaches them
+      local menuLabelName = container.lockLabel.name
+      local lockStyleLabelName = container.adjLabel:findMenuElement("lockStylesLabel.standard").name
+      assert.is_not_nil(Geyser.windowList[menuLabelName])
+      assert.is_not_nil(Geyser.windowList[lockStyleLabelName])
+      container:delete()
+      -- listed by name: a leaked Geyser object prints as the whole widget tree
+      assert.are.same({}, newTopLevelObjects())
+      assert.is_nil(getWindowGeometry(menuLabelName))
+      assert.is_nil(getWindowGeometry(lockStyleLabelName))
+      assert.is_nil(Adjustable.Container.all.gasContainer)
+      assert.is_nil(table.index_of(Adjustable.Container.all_windows, "gasContainer"))
+    end)
+
+    it("takes the menu labels of a container inside a user window with it", function()
+      -- menu labels of a container in a user window are registered in that
+      -- window's list rather than in Geyser.windowList
+      local userWindow = Geyser.UserWindow:new({name = "gasUserWindow", x = 0, y = 0, width = 300, height = 300})
+      finally(function()
+        -- a user window gets a root container of its own, which is what has to
+        -- go for the window and everything in it to be cleaned up
+        local root = Geyser.windowList.gasUserWindowContainer
+        if root then
+          root:delete()
+        end
+      end)
+      local inWindow = Adjustable.Container:new({
+        name = "gasInUserWindow",
+        x = 0, y = 0, width = 100, height = 100,
+        autoLoad = false,
+        autoSave = false,
+      }, userWindow)
+      local menuLabelName = inWindow.lockLabel.name
+      assert.is_not_nil(getWindowGeometry(menuLabelName))
+      inWindow:delete()
+      assert.is_nil(getWindowGeometry(menuLabelName))
+    end)
+
+    it("takes its autosave handler with it", function()
+      local saving = Adjustable.Container:new({
+        name = "gasSavingContainer",
+        x = 0, y = 0, width = 100, height = 100,
+        autoLoad = false,
+      })
+      assert.is_not_nil(saving.autoSaveHandler)
+      saving:delete()
+      -- left registered, the handler would write a deleted container's geometry
+      -- back out at exit, over whatever took its name in the meantime
+      assert.is_nil(saving.autoSaveHandler)
+      assert.is_false(saving.autoSave)
+    end)
+
+    it("leaves another adjustable container's registration alone", function()
+      local other = Adjustable.Container:new({
+        name = "gasOtherContainer",
+        x = 0, y = 0, width = 100, height = 100,
+        autoLoad = false,
+        autoSave = false,
+      })
+      finally(function()
+        if Geyser.windowList.gasOtherContainer == other then
+          other:delete()
+        end
+      end)
+      local otherMenuLabelName = other.lockLabel.name
+      container:delete()
+      assert.are.equal(other, Adjustable.Container.all.gasOtherContainer)
+      assert.is_not_nil(table.index_of(Adjustable.Container.all_windows, "gasOtherContainer"))
+      assert.are.equal(other.lockLabel, Geyser.windowList[otherMenuLabelName])
+      assert.is_not_nil(getWindowGeometry(otherMenuLabelName))
+      other:delete()
+    end)
   end)
 end)

From 684982b15649281848ab72419a7e88daaeefba36 Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Sun, 2 Aug 2026 16:19:18 +0200
Subject: [PATCH 051/155] fix: Geyser.Button:setState refuses 'down' before
 writing it

On a single state button setState("down") wrote self.state and only then
returned the refusal, so the rejected state stuck and the next press()
sent downCommand. Check twoState before touching self.state.

A successful 'down' now returns true as 'up' already did, otherwise it is
indistinguishable from those refusals; and the constructor falls back to
'up' rather than holding a state it was refused, which used to leave the
button unpainted.

Fixes #9584

Assisted-by: Claude:claude-opus-5
---
 src/mudlet-lua/lua/geyser/GeyserButton.lua | 16 ++++++--
 src/mudlet-lua/tests/GeyserButton_spec.lua | 44 ++++++++++++++++++++--
 2 files changed, 52 insertions(+), 8 deletions(-)

diff --git a/src/mudlet-lua/lua/geyser/GeyserButton.lua b/src/mudlet-lua/lua/geyser/GeyserButton.lua
index b4aa5b5e4..b71ee7a7a 100644
--- a/src/mudlet-lua/lua/geyser/GeyserButton.lua
+++ b/src/mudlet-lua/lua/geyser/GeyserButton.lua
@@ -52,7 +52,12 @@ function Geyser.Button:new(cons, container)
   local me = self.parent:new(cons, container)
   setmetatable(me, self)
   me:setClickCallback(function() me:press() end)
-  me:setState(me.state)
+  -- an unusable state constraint would otherwise leave the button holding it
+  -- and never painted, since setState returns before drawing anything
+  if not me:setState(me.state) then
+    me.state = "up"
+    me:setState("up")
+  end
   me:resize() -- to pick up the Geyser.Button default size rather than Geyser.Label's
   return me
 end
@@ -70,6 +75,9 @@ function Geyser.Button:setState(state)
   if state ~= "up" and state ~= "down" then
     return nil, f"bad argument #1 value (state must be one of 'up' or 'down', got {state})"
   end
+  if state == "down" and not self.twoState then
+    return nil, "cannot set a single state button's state to 'down', only 'up'"
+  end
   self.state = state
   if state == "up" then
     self:echo(self.msg)
@@ -85,9 +93,6 @@ function Geyser.Button:setState(state)
     self:setToolTip(self.tooltip, self.toolTipDuration)
     return true
   end
-  if not self.twoState then
-    return nil, "cannot set a single state button's state to 'down', only 'up'"
-  end
   self:echo(self.downMsg)
   if self.downStyle then
     if type(self.downStyle) == "table" then
@@ -99,6 +104,9 @@ function Geyser.Button:setState(state)
     self.parent.setColor(self, self.downColor)
   end
   self:setToolTip(self.downTooltip, self.toolTipDuration)
+  -- both branches report success, otherwise a legitimate 'down' is
+  -- indistinguishable from the refusals above
+  return true
 end
 
 --- Handles clicking the button. If the button is twoState, also handles switching the button's state
diff --git a/src/mudlet-lua/tests/GeyserButton_spec.lua b/src/mudlet-lua/tests/GeyserButton_spec.lua
index eadff82a9..195442b97 100644
--- a/src/mudlet-lua/tests/GeyserButton_spec.lua
+++ b/src/mudlet-lua/tests/GeyserButton_spec.lua
@@ -222,13 +222,49 @@ describe("Tests functionality of Geyser.Button", function()
       local result, message = button:setState("down")
       assert.is_nil(result)
       assert.are.equal("cannot set a single state button's state to 'down', only 'up'", message)
-      -- the refusal happens before anything is drawn, so the button still
-      -- shows its up message. button.state is deliberately not asserted here:
-      -- setState writes it before the refusal, which is a Geyser bug to fix
-      -- rather than a contract to pin down.
+      -- the refusal happens before anything is written, so neither the stored
+      -- state nor the drawn message move
+      assert.are.equal("up", button.state)
       assert.is_truthy(getLabelText("gbsSingleState"):find("up text", 1, true))
     end)
 
+    it('keeps clicking a refused single state button on its up command', function()
+      local clicks, downs = 0, 0
+      local button = track(Geyser.Button:new({
+        name = "gbsRefusedPress",
+        x = 0, y = 0, width = 60, height = 20,
+        clickFunction = function() clicks = clicks + 1 end,
+        downFunction = function() downs = downs + 1 end,
+      }))
+      button:setState("down")
+      button:press()
+      assert.are.equal(1, clicks)
+      assert.are.equal(0, downs)
+      assert.are.equal("up", button.state)
+    end)
+
+    it('reports success for both states of a two state button', function()
+      local button = track(Geyser.Button:new({
+        name = "gbsStateResult",
+        x = 0, y = 0, width = 60, height = 20,
+        twoState = true,
+      }))
+      -- a legitimate 'down' has to be distinguishable from a refusal
+      assert.is_true(button:setState("down"))
+      assert.is_true(button:setState("up"))
+    end)
+
+    it('will not start a single state button in the down state', function()
+      local button = track(Geyser.Button:new({
+        name = "gbsDownConstraint",
+        x = 0, y = 0, width = 60, height = 20,
+        msg = "up text",
+        state = "down",
+      }))
+      assert.are.equal("up", button.state)
+      assert.is_truthy(getLabelText("gbsDownConstraint"):find("up text", 1, true))
+    end)
+
     it('rejects a state that is not a string or not a known state', function()
       local button = track(Geyser.Button:new({name = "gbsBadState", x = 0, y = 0, width = 60, height = 20}))
       local result, message = button:setState(7)

From f3d68436ca43a8490e733fb576417969050d2201 Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Sun, 2 Aug 2026 16:19:36 +0200
Subject: [PATCH 052/155] fix: lay out new2 boxes, and apply the layout
 end_update deferred

VBox/HBox override add but not add2, so children created with new2 -
which reach the container through add2 - never triggered organize() and
kept their raw constructor geometry. Override add2 as well.

end_update() was a no-op: it calls reposition(), which hands
GeyserReposition() no event, and neither event branch matched a nil one.
Treat a nil event as "reposition everything", and have the boxes remember
the organize() they skipped while deferred so that reposition can flush
it. The flag is only honoured once the deferral is over, so moving a box
mid-deferral no longer flushes it early, and only cleared after organize()
returns so the work is not lost if it throws.

GeyserReposition now walks a snapshot of the window names, since
repositioning raises events and a handler that creates or deletes a top
level window would be mutating the table being iterated. An unrecognised
event says so rather than silently doing nothing.

Fixes #9585
Fixes #9586

Assisted-by: Claude:claude-opus-5
---
 src/mudlet-lua/lua/geyser/GeyserHBox.lua      | 30 +++++++--
 .../lua/geyser/GeyserReposition.lua           | 35 ++++++++--
 src/mudlet-lua/lua/geyser/GeyserVBox.lua      | 32 +++++++--
 src/mudlet-lua/tests/GeyserContainer_spec.lua | 67 +++++++++++++++++--
 src/mudlet-lua/tests/GeyserHBox_spec.lua      | 12 +++-
 src/mudlet-lua/tests/GeyserVBox_spec.lua      | 24 ++++++-
 6 files changed, 172 insertions(+), 28 deletions(-)

diff --git a/src/mudlet-lua/lua/geyser/GeyserHBox.lua b/src/mudlet-lua/lua/geyser/GeyserHBox.lua
index f6bc841b9..4a6bb8391 100644
--- a/src/mudlet-lua/lua/geyser/GeyserHBox.lua
+++ b/src/mudlet-lua/lua/geyser/GeyserHBox.lua
@@ -8,6 +8,18 @@ Geyser.HBox = Geyser.Container:new({
   name = "HBoxClass"
 })
 
+-- Internal function: lays the box out, or remembers that it still has to be laid
+-- out when updates are being deferred, so that the reposition end_update() runs
+-- picks the work up again
+-- @param box the HBox to organize
+local function organizeOrDefer(box)
+  if box.defer_updates then
+    box.pending_organize = true
+  else
+    box:organize()
+  end
+end
+
 function Geyser.HBox:add (window, cons)
   -- VBox/HBox have their own add function therefore passing off add2 should be possible without
   -- overwriting their add functions
@@ -16,9 +28,14 @@ function Geyser.HBox:add (window, cons)
   else
     Geyser.add(self, window, cons)
   end
-  if not self.defer_updates then
-    self:organize()
-  end
+  organizeOrDefer(self)
+end
+
+-- add2 has to be overridden as well, otherwise children created with new2 reach
+-- Geyser.add2 directly and the box never lays them out
+function Geyser.HBox:add2 (window, cons, passAdd2, exclude)
+  Geyser.add2(self, window, cons, passAdd2, exclude)
+  organizeOrDefer(self)
 end
 
 --- Responsible for organizing the elements inside the HBox
@@ -61,8 +78,13 @@ end
 
 function Geyser.HBox:reposition()
   Geyser.Container.reposition(self)
-  if self.contains_fixed then
+  -- contains_fixed prevents gaps when items have fixed size and is deliberately
+  -- not deferred, pending_organize
+  -- flushes a layout that was skipped while updates were deferred. Clearing it
+  -- only after organize() keeps the work queued if organize() throws.
+  if self.contains_fixed or (self.pending_organize and not self.defer_updates) then
     self:organize()
+    self.pending_organize = nil
   end
 end
 
diff --git a/src/mudlet-lua/lua/geyser/GeyserReposition.lua b/src/mudlet-lua/lua/geyser/GeyserReposition.lua
index c8a351ebd..79e0a820a 100644
--- a/src/mudlet-lua/lua/geyser/GeyserReposition.lua
+++ b/src/mudlet-lua/lua/geyser/GeyserReposition.lua
@@ -5,16 +5,39 @@
 
 --- Responds to sysWindowResizeEvent and causes all windows managed
 -- by Geyser to update their sizes and positions.
--- @param event a sysWindowResizeEvent or sysUserWindowResizeEvent event
+-- Called without an event by Geyser:reposition(), which is how Geyser:end_update()
+-- applies the layout it deferred; that call is meant for every window Geyser owns.
+-- @param event a sysWindowResizeEvent or sysUserWindowResizeEvent event, or nil to reposition everything
 -- @param w the new width
 -- @param h the new height
 -- @param arg additional arguments
 function GeyserReposition(event, w, h, arg)
-  for _, window in pairs(Geyser.windowList) do
-    if event == "sysUserWindowResizeEvent" and window.type == "userwindow" and arg.."Container" == window.name then
-      window:reposition()
-    elseif event == "sysWindowResizeEvent" and window.type ~= "userwindow" then 
-      window:reposition()
+  if event ~= nil and event ~= "sysWindowResizeEvent" and event ~= "sysUserWindowResizeEvent" then
+    -- otherwise a mistyped event name is indistinguishable from a no-op
+    debugc(string.format("GeyserReposition: ignoring the unknown event '%s'", tostring(event)))
+    return
+  end
+  if event == "sysUserWindowResizeEvent" and not arg then
+    debugc("GeyserReposition: sysUserWindowResizeEvent needs the name of the user window that was resized")
+    return
+  end
+  -- repositioning raises events, and a handler that creates or deletes a top
+  -- level window would be mutating windowList mid-traversal, so work off a
+  -- snapshot of the names and re-check each one is still there
+  local names = {}
+  for name in pairs(Geyser.windowList) do
+    names[#names + 1] = name
+  end
+  for _, name in ipairs(names) do
+    local window = Geyser.windowList[name]
+    if window then
+      if event == nil then
+        window:reposition()
+      elseif event == "sysUserWindowResizeEvent" and window.type == "userwindow" and arg.."Container" == window.name then
+        window:reposition()
+      elseif event == "sysWindowResizeEvent" and window.type ~= "userwindow" then
+        window:reposition()
+      end
     end
   end
 end
diff --git a/src/mudlet-lua/lua/geyser/GeyserVBox.lua b/src/mudlet-lua/lua/geyser/GeyserVBox.lua
index 40c021c3f..ea4263fa5 100644
--- a/src/mudlet-lua/lua/geyser/GeyserVBox.lua
+++ b/src/mudlet-lua/lua/geyser/GeyserVBox.lua
@@ -8,6 +8,18 @@ Geyser.VBox = Geyser.Container:new({
   name = "VBoxClass"
 })
 
+-- Internal function: lays the box out, or remembers that it still has to be laid
+-- out when updates are being deferred, so that the reposition end_update() runs
+-- picks the work up again
+-- @param box the VBox to organize
+local function organizeOrDefer(box)
+  if box.defer_updates then
+    box.pending_organize = true
+  else
+    box:organize()
+  end
+end
+
 function Geyser.VBox:add (window, cons)
   -- VBox/HBox have their own add function therefore passing off add2 should be possible without
   -- overwriting their add functions
@@ -16,10 +28,15 @@ function Geyser.VBox:add (window, cons)
   else
     Geyser.add(self, window, cons)
   end
-  
-  if not self.defer_updates then
-    self:organize()
-  end
+
+  organizeOrDefer(self)
+end
+
+-- add2 has to be overridden as well, otherwise children created with new2 reach
+-- Geyser.add2 directly and the box never lays them out
+function Geyser.VBox:add2 (window, cons, passAdd2, exclude)
+  Geyser.add2(self, window, cons, passAdd2, exclude)
+  organizeOrDefer(self)
 end
 
 --- Responsible for organizing the elements inside the VBox
@@ -62,8 +79,13 @@ end
 
 function Geyser.VBox:reposition()
   Geyser.Container.reposition(self)
-  if self.contains_fixed then -- prevent gaps when items have fixed size
+  -- contains_fixed prevents gaps when items have fixed size and is deliberately
+  -- not deferred, pending_organize
+  -- flushes a layout that was skipped while updates were deferred. Clearing it
+  -- only after organize() keeps the work queued if organize() throws.
+  if self.contains_fixed or (self.pending_organize and not self.defer_updates) then
     self:organize()
+    self.pending_organize = nil
   end
 end
 
diff --git a/src/mudlet-lua/tests/GeyserContainer_spec.lua b/src/mudlet-lua/tests/GeyserContainer_spec.lua
index 7ba2cf2d2..1ee8d7c54 100644
--- a/src/mudlet-lua/tests/GeyserContainer_spec.lua
+++ b/src/mudlet-lua/tests/GeyserContainer_spec.lua
@@ -593,20 +593,73 @@ describe("Tests functionality of Geyser.Container", function()
       -- the children keep their own constraints instead of being stacked
       assert.are.same({x = 10, y = 10, width = 300, height = 200}, geometry("gcsDeferredA"))
       assert.are.same({x = 10, y = 10, width = 300, height = 200}, geometry("gcsDeferredB"))
+      -- end_update applies the layout that was held back, without the caller
+      -- having to organize the box itself
       box:end_update()
       assert.is_false(box.defer_updates)
-      box:organize()
       assert.are.same({x = 0, y = 0, width = 200, height = 100}, geometry("gcsDeferredA"))
       assert.are.same({x = 0, y = 100, width = 200, height = 100}, geometry("gcsDeferredB"))
     end)
 
-    it("does nothing when Geyser:reposition is called outside a resize event", function()
-      -- Geyser:reposition hands GeyserReposition no event, and GeyserReposition
-      -- only acts on the two resize events, so this is a no-op by construction
-      track(Geyser.Label:new({name = "gcsRepositionNoop", x = 10, y = 10, width = 100, height = 50}))
-      moveWindow("gcsRepositionNoop", 300, 300)
+    it("holds back the layout of an hbox while its updates are deferred", function()
+      local box = track(Geyser.HBox:new({name = "gcsDeferredH", x = 0, y = 0, width = 200, height = 200}))
+      box:begin_update()
+      finally(function() box.defer_updates = false end)
+      track(Geyser.Label:new({name = "gcsDeferredHA"}, box))
+      track(Geyser.Label:new({name = "gcsDeferredHB"}, box))
+      assert.are.same({x = 10, y = 10, width = 300, height = 200}, geometry("gcsDeferredHA"))
+      box:end_update()
+      assert.are.same({x = 0, y = 0, width = 100, height = 200}, geometry("gcsDeferredHA"))
+      assert.are.same({x = 100, y = 0, width = 100, height = 200}, geometry("gcsDeferredHB"))
+    end)
+
+    it("holds back the layout of a new2 box, which fills through add2", function()
+      local box = track(Geyser.VBox:new2({name = "gcsDeferred2", x = 0, y = 0, width = 200, height = 200}))
+      box:begin_update()
+      finally(function() box.defer_updates = false end)
+      track(Geyser.Label:new2({name = "gcsDeferred2A"}, box))
+      track(Geyser.Label:new2({name = "gcsDeferred2B"}, box))
+      assert.are.same({x = 10, y = 10, width = 300, height = 200}, geometry("gcsDeferred2A"))
+      box:end_update()
+      assert.are.same({x = 0, y = 0, width = 200, height = 100}, geometry("gcsDeferred2A"))
+      assert.are.same({x = 0, y = 100, width = 200, height = 100}, geometry("gcsDeferred2B"))
+    end)
+
+    it("keeps holding the layout back when the box itself is moved", function()
+      -- move() repositions, and reposition is what flushes the deferred layout,
+      -- so it must not undo the deferral it was asked for
+      local box = track(Geyser.VBox:new({name = "gcsDeferredMove", x = 0, y = 0, width = 200, height = 200}))
+      box:begin_update()
+      finally(function() box.defer_updates = false end)
+      track(Geyser.Label:new({name = "gcsDeferredMoveA"}, box))
+      track(Geyser.Label:new({name = "gcsDeferredMoveB"}, box))
+      box:move(0, 0)
+      assert.are.same({x = 10, y = 10, width = 300, height = 200}, geometry("gcsDeferredMoveA"))
+      box:end_update()
+      assert.are.same({x = 0, y = 0, width = 200, height = 100}, geometry("gcsDeferredMoveA"))
+    end)
+
+    it("lays a box out that was filled during a deferral of the root window", function()
+      -- leaving the flag set would stop every later spec repositioning
+      finally(function() Geyser.defer_updates = false end)
+      local box = track(Geyser.VBox:new({name = "gcsRootDeferred", x = 0, y = 0, width = 200, height = 200}))
+      Geyser:begin_update()
+      track(Geyser.Label:new({name = "gcsRootDeferredA"}, box))
+      track(Geyser.Label:new({name = "gcsRootDeferredB"}, box))
+      Geyser:end_update()
+      assert.are.same({x = 0, y = 0, width = 200, height = 100}, geometry("gcsRootDeferredA"))
+      assert.are.same({x = 0, y = 100, width = 200, height = 100}, geometry("gcsRootDeferredB"))
+    end)
+
+    it("repositions every window when Geyser:reposition is called directly", function()
+      -- Geyser:reposition hands GeyserReposition no event, which is how
+      -- end_update flushes what was deferred, so it applies to everything
+      -- a leaked deferral would make this a no-op for a reason of its own
+      assert.is_false(Geyser.defer_updates)
+      track(Geyser.Label:new({name = "gcsRepositionDirect", x = 10, y = 10, width = 100, height = 50}))
+      moveWindow("gcsRepositionDirect", 300, 300)
       Geyser:reposition()
-      assert.are.equal(300, geometry("gcsRepositionNoop").x)
+      assert.are.same({x = 10, y = 10, width = 100, height = 50}, geometry("gcsRepositionDirect"))
     end)
 
     it("lays a box out as its children arrive when updates are not deferred", function()
diff --git a/src/mudlet-lua/tests/GeyserHBox_spec.lua b/src/mudlet-lua/tests/GeyserHBox_spec.lua
index eca123c7d..b0bd836fd 100644
--- a/src/mudlet-lua/tests/GeyserHBox_spec.lua
+++ b/src/mudlet-lua/tests/GeyserHBox_spec.lua
@@ -42,14 +42,20 @@ describe("Tests functionality of Geyser.HBox", function()
       assert.is_nil(getWindowGeometry("ghbNew"))
     end)
 
-    -- children of a new2 box are not laid out at all: HBox overrides add but
-    -- not add2, so organize() is never reached. Left unspecified rather than
-    -- pinned, since the layout is what a caller of new2 is asking for.
     it("new2 marks the box as using add2", function()
       local box = track(Geyser.HBox:new2({name = "ghbNew2", x = 0, y = 0, width = 100, height = 100}))
       assert.is_true(box.useAdd2)
       assert.are.equal("hbox", box.type)
     end)
+
+    it("lines the children of a new2 box up the same way new does", function()
+      local box = track(Geyser.HBox:new2({name = "ghbNew2Layout", x = 0, y = 0, width = 200, height = 100}))
+      -- the children arrive through add2 rather than add
+      track(Geyser.Label:new2({name = "ghbNew2A", x = 10, y = 10, width = 300, height = 200}, box))
+      track(Geyser.Label:new2({name = "ghbNew2B", x = 10, y = 10, width = 300, height = 200}, box))
+      assert.are.same({x = 0, y = 0, width = 100, height = 100}, geometry("ghbNew2A"))
+      assert.are.same({x = 100, y = 0, width = 100, height = 100}, geometry("ghbNew2B"))
+    end)
   end)
 
   describe("Geyser.HBox:add/organize", function()
diff --git a/src/mudlet-lua/tests/GeyserVBox_spec.lua b/src/mudlet-lua/tests/GeyserVBox_spec.lua
index 5aab5092a..13de26edc 100644
--- a/src/mudlet-lua/tests/GeyserVBox_spec.lua
+++ b/src/mudlet-lua/tests/GeyserVBox_spec.lua
@@ -43,14 +43,32 @@ describe("Tests functionality of Geyser.VBox", function()
       assert.is_nil(getWindowGeometry("gvbNew"))
     end)
 
-    -- children of a new2 box are not laid out at all: VBox overrides add but
-    -- not add2, so organize() is never reached. Left unspecified rather than
-    -- pinned, since the layout is what a caller of new2 is asking for.
     it("new2 marks the box as using add2", function()
       local box = track(Geyser.VBox:new2({name = "gvbNew2", x = 0, y = 0, width = 100, height = 100}))
       assert.is_true(box.useAdd2)
       assert.are.equal("VBox", box.type)
     end)
+
+    it("stacks the children of a new2 box the same way new does", function()
+      local box = track(Geyser.VBox:new2({name = "gvbNew2Layout", x = 0, y = 0, width = 200, height = 200}))
+      -- the children arrive through add2 rather than add
+      track(Geyser.Label:new2({name = "gvbNew2A", x = 10, y = 10, width = 300, height = 200}, box))
+      track(Geyser.Label:new2({name = "gvbNew2B", x = 10, y = 10, width = 300, height = 200}, box))
+      assert.are.same({x = 0, y = 0, width = 200, height = 100}, geometry("gvbNew2A"))
+      assert.are.same({x = 0, y = 100, width = 200, height = 100}, geometry("gvbNew2B"))
+    end)
+
+    it("lays out a new2 box nested in another new2 box", function()
+      local outer = track(Geyser.HBox:new2({name = "gvbNestedOuter", x = 0, y = 0, width = 200, height = 200}))
+      local inner = track(Geyser.VBox:new2({name = "gvbNestedInner"}, outer))
+      track(Geyser.Label:new2({name = "gvbNestedSibling"}, outer))
+      track(Geyser.Label:new2({name = "gvbNestedA"}, inner))
+      track(Geyser.Label:new2({name = "gvbNestedB"}, inner))
+      -- the inner box takes half the outer one, and splits it between its own two
+      assert.are.same({x = 0, y = 0, width = 100, height = 100}, geometry("gvbNestedA"))
+      assert.are.same({x = 0, y = 100, width = 100, height = 100}, geometry("gvbNestedB"))
+      assert.are.same({x = 100, y = 0, width = 100, height = 200}, geometry("gvbNestedSibling"))
+    end)
   end)
 
   describe("Geyser.VBox:add/organize", function()

From 32611277f9be83e3fbbdf0c04b9427f896290bcc Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Sun, 2 Aug 2026 16:19:36 +0200
Subject: [PATCH 053/155] fix: gauge three value CSS shorthand and non-positive
 maximums

The margin/border/padding parser handled 1, 2 and 4 values but let the
CSS 3-value form fall through to the else that returns no spacing, so
"margin: 10px 20px 30px" was dropped entirely.

setValue(n, 0) divided by zero and left value at inf until a later valid
call; a negative maximum left it negative and NaN passed straight
through. Refuse the whole class and leave the gauge on the reading it
already had. Games do report a zero maximum while a stat is still
unknown, so this returns nil and a message rather than raising, which
would abort the rest of the caller's handler, and says so once in the
debug console so a frozen gauge is not a mystery.

Fixes #9587
Fixes #9588

Assisted-by: Claude:claude-opus-5
---
 src/mudlet-lua/lua/geyser/GeyserGauge.lua | 19 +++++++++++++++
 src/mudlet-lua/tests/GeyserGauge_spec.lua | 29 +++++++++++++++++++++++
 2 files changed, 48 insertions(+)

diff --git a/src/mudlet-lua/lua/geyser/GeyserGauge.lua b/src/mudlet-lua/lua/geyser/GeyserGauge.lua
index 6e4006ccc..3aaba1b46 100644
--- a/src/mudlet-lua/lua/geyser/GeyserGauge.lua
+++ b/src/mudlet-lua/lua/geyser/GeyserGauge.lua
@@ -56,6 +56,9 @@ local function extractCSSSpacing(css, property)
   elseif #values == 2 then
     -- top/bottom, left/right
     return values[2], values[2], values[1], values[1]
+  elseif #values == 3 then
+    -- top, left/right, bottom
+    return values[2], values[2], values[1], values[3]
   elseif #values == 4 then
     -- top, right, bottom, left
     return values[4], values[2], values[1], values[3]
@@ -70,9 +73,24 @@ end
 --        used to set the gauge.
 -- @param maxValue Maximum numeric value.  Optionally nil, see above.
 -- @param text The text to display on the gauge, it is optional.
+-- @return true, or nil and a message if maxValue has no reading to give
 function Geyser.Gauge:setValue (currentValue, maxValue, text)
   assert(type(currentValue) == "number", string.format("bad argument #1 type (currentValue as number expected, got %s!)", type(currentValue)))
   assert(maxValue == nil or type(maxValue) == "number", string.format("bad argument #2 type (optional maxValue as number expected, got %s!)", type(maxValue)))
+  -- A zero, negative or NaN maximum has no sensible reading: dividing by it leaves
+  -- the gauge on an infinite or negative value that sticks until the next good
+  -- call. Games do report these while a stat is still unknown, so refuse the
+  -- reading and leave the gauge as it was rather than aborting the caller.
+  if maxValue ~= nil and not (maxValue > 0) then
+    local message = string.format("Geyser.Gauge:setValue: bad argument #2 value (maxValue must be a positive number, got %s!) - gauge '%s' was left as it was", tostring(maxValue), self.name)
+    -- latched, because a game that reports a bad maximum reports it every prompt
+    if not self.warnedBadMaxValue then
+      self.warnedBadMaxValue = true
+      debugc(message)
+    end
+    return nil, message
+  end
+  self.warnedBadMaxValue = nil
   -- Use sensible defaults for missing parameters.
   if currentValue < 0 then
     currentValue = 0
@@ -157,6 +175,7 @@ function Geyser.Gauge:setValue (currentValue, maxValue, text)
   if text then
     self.text:echo(text)
   end
+  return true
 end
 
 --- Sets the gauge color.
diff --git a/src/mudlet-lua/tests/GeyserGauge_spec.lua b/src/mudlet-lua/tests/GeyserGauge_spec.lua
index d851f7c6a..b9deb6991 100644
--- a/src/mudlet-lua/tests/GeyserGauge_spec.lua
+++ b/src/mudlet-lua/tests/GeyserGauge_spec.lua
@@ -128,6 +128,23 @@ describe("Tests functionality of Geyser.Gauge", function()
       assert.is_false(ok)
       assert.is_truthy(tostring(message):find("maxValue as number expected, got string", 1, true))
     end)
+
+    it("refuses a maximum that is not positive instead of going infinite", function()
+      gauge:setValue(25)
+      -- a zero maximum used to leave value at inf, a negative one at a negative
+      -- value, and both stuck until the next good call
+      for _, bad in ipairs({0, -10, 0 / 0}) do
+        local result, message = gauge:setValue(5, bad)
+        assert.is_nil(result)
+        assert.is_not_nil(message)
+        assert.is_truthy(message:find("maxValue must be a positive number", 1, true))
+      end
+      -- refusing is not fatal, and leaves the gauge on the value it already had
+      assert.are.equal(25, gauge.value)
+      assert.are.equal(50, geometry("ggsValue_front").width)
+      -- a good reading has to be distinguishable from those refusals
+      assert.is_true(gauge:setValue(50, 100))
+    end)
   end)
 
   describe("Geyser.Gauge orientations", function()
@@ -165,6 +182,18 @@ describe("Tests functionality of Geyser.Gauge", function()
       assert.are.same({x = 30, y = 10, width = 140, height = 80}, geometry("ggsTwoValue_front"))
     end)
 
+    it("reads a three value margin as top, horizontal, bottom", function()
+      local gauge = track(Geyser.Gauge:new({name = "ggsThreeValue", x = 0, y = 0, width = 200, height = 100}))
+      gauge:setStyleSheet("margin: 10px 20px 30px;", "margin: 10px 20px 30px;")
+      assert.are.same({x = 20, y = 10, width = 160, height = 60}, geometry("ggsThreeValue_front"))
+    end)
+
+    it("reads a three value padding the same way as a margin", function()
+      local gauge = track(Geyser.Gauge:new({name = "ggsThreePadding", x = 0, y = 0, width = 200, height = 100}))
+      gauge:setStyleSheet("padding: 4px 6px 8px;", "padding: 4px 6px 8px;")
+      assert.are.same({x = 6, y = 4, width = 188, height = 88}, geometry("ggsThreePadding_front"))
+    end)
+
     it("reads a four value margin as top, right, bottom, left", function()
       local gauge = track(Geyser.Gauge:new({name = "ggsFourValue", x = 0, y = 0, width = 200, height = 100}))
       gauge:setStyleSheet("margin: 1px 2px 3px 4px;", "margin: 1px 2px 3px 4px;")

From 56f4233e4425bd52c43c8c0c06b7235b89d45564 Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Sun, 2 Aug 2026 16:19:36 +0200
Subject: [PATCH 054/155] fix: Geyser.Window:echo() keeps the stored message

echo() assigned self.message unconditionally, so calling it with no
argument blanked the window; cecho/decho/hecho all use "message or
self.message" and redisplay instead. Those three had their assignment and
their echo crammed onto one line, which is how the difference went
unnoticed, so give them a line each.

Fixes #9589

Assisted-by: Claude:claude-opus-5
---
 src/mudlet-lua/lua/geyser/GeyserWindow.lua | 11 +++++++----
 src/mudlet-lua/tests/GeyserWindow_spec.lua | 10 ++++++++++
 2 files changed, 17 insertions(+), 4 deletions(-)

diff --git a/src/mudlet-lua/lua/geyser/GeyserWindow.lua b/src/mudlet-lua/lua/geyser/GeyserWindow.lua
index 47a8aaeec..1adf492fa 100644
--- a/src/mudlet-lua/lua/geyser/GeyserWindow.lua
+++ b/src/mudlet-lua/lua/geyser/GeyserWindow.lua
@@ -26,7 +26,7 @@ Geyser.Window = Geyser.Container:new({
 --- Prints a message to the window
 -- @param message The message to print. Can contain html formatting.
 function Geyser.Window:echo(message)
-  self.message = message
+  self.message = message or self.message
   echo(self.name, self.message)
 end
 
@@ -34,21 +34,24 @@ end
 -- @param message The message to print. Uses color formatting information -
 -- a message of "Hi" would make 'Hi' red.
 function Geyser.Window:cecho(message)
-  self.message = message or self.message cecho(self.name, self.message)
+  self.message = message or self.message
+  cecho(self.name, self.message)
 end
 
 --- Prints a message to the window.
 -- @param message The message to print. Uses color formatting information -
 -- a message of "<255,0,0>Hi" would make 'Hi' red.
 function Geyser.Window:decho(message)
-  self.message = message or self.message decho(self.name, self.message)
+  self.message = message or self.message
+  decho(self.name, self.message)
 end
 
 --- Prints a message to the window.
 -- @param message The message to print. Uses color formatting information -
 -- a message of "|cff0000Hi" would make 'Hi' red.
 function Geyser.Window:hecho(message)
-  self.message = message or self.message hecho(self.name, self.message)
+  self.message = message or self.message
+  hecho(self.name, self.message)
 end
 
 --- Get the window's foreground color.
diff --git a/src/mudlet-lua/tests/GeyserWindow_spec.lua b/src/mudlet-lua/tests/GeyserWindow_spec.lua
index 22215de1f..2f8e041b6 100644
--- a/src/mudlet-lua/tests/GeyserWindow_spec.lua
+++ b/src/mudlet-lua/tests/GeyserWindow_spec.lua
@@ -93,6 +93,16 @@ describe("Tests functionality of Geyser.Window", function()
       assert.are.equal("remembered\n", console.message)
       assert.are.equal("remembered", lastLine("gwsConsole"))
     end)
+
+    it("echo without a message redisplays the stored one instead of wiping it", function()
+      console:echo("kept\n")
+      local lines = getLineCount("gwsConsole")
+      console:echo()
+      assert.are.equal("kept\n", console.message)
+      -- the line count pins that it was written again, not merely left alone
+      assert.are.equal(lines + 1, getLineCount("gwsConsole"))
+      assert.are.equal("kept", lastLine("gwsConsole"))
+    end)
   end)
 
   describe("Geyser.Window:getFgColor/getBgColor/setBgColor/setFgColor", function()

From 3bd0e173c71717df038f1e23d23e4f1bff1a4b15 Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Sun, 2 Aug 2026 20:15:54 +0200
Subject: [PATCH 055/155] infrastructure: real-firing timer and script family
 Lua API tests (#9572)

#### Brief overview of PR changes/additions

- 69 new busted specs in `Other_spec.lua` for the timer API
(`tempTimer`, `killTimer`, `remainingTime`, `permTimer`,
`enableTimer`/`disableTimer`, `exists`/`isActive`) and the script family
(`permScript`, `getScript`, `setScript`, `appendScript`, `enableScript`,
`disableScript`).
- Timer effect specs assert the timer *actually fired* - a side effect
observed after the `waitForEvent` helper (#9527) pumped the event loop.
No sleeps.
- Permanent timers and scripts cannot be deleted from Lua and are saved
with the profile, so the specs disable/blank what they create and count
relative to what is already there, staying green when the suite is
re-run against one profile.

#### Motivation for adding to Mudlet

These 14 functions were previously untested or mocked-only; timer firing
had never been covered at all because there was no way to wait for it.
Part of the Lua API coverage programme.

#### Other info (issues closed, discussion etc)

Warts found while writing these, not frozen into specs and to be filed
separately: `tempTimer` with a negative delay wraps to a ~24 hour timer
instead of erroring; `TLuaInterpreter::compile` reports the script's
name instead of the Lua error (reads the wrong stack slot); `killTimer`
returns true for an already-killed timer.

**Test case:** full busted suite 1307 -> 1376 passing, 0 failures, green
twice on a fresh profile and three times in a row against one shared
profile; no measurable runtime change. Sabotage-verified: 14 of the new
specs were shown to fail when the underlying C++/Lua behaviour was
locally broken (killTimer, enableTimer, remainingTime, setScriptCode,
disableScript, appendScript).

Assisted-by: Claude:claude-opus-5
Signed-off-by: Vadim Peretokin 
---
 src/mudlet-lua/tests/Other_spec.lua | 719 ++++++++++++++++++++++++++++
 1 file changed, 719 insertions(+)

diff --git a/src/mudlet-lua/tests/Other_spec.lua b/src/mudlet-lua/tests/Other_spec.lua
index 039610abd..9302e69c5 100644
--- a/src/mudlet-lua/tests/Other_spec.lua
+++ b/src/mudlet-lua/tests/Other_spec.lua
@@ -968,3 +968,722 @@ describe("Tests Other.lua functions", function()
       translateTable()
   ]]
 end)
+
+describe("Tests the timer API", function()
+  -- These drive the real timer engine: every effect assertion is made after the
+  -- timer has actually fired, observed through the waitForEvent test helper which
+  -- pumps the Qt event loop rather than sleeping.
+
+  -- Temporary timers are killed and permanent ones disabled after every spec, so
+  -- no timer created here can still fire during a later spec, even if one of the
+  -- assertions above the clean-up code fails.
+  --
+  -- Permanent timers cannot be deleted, only disabled, and the profile is written
+  -- out when Mudlet closes: running the suite twice against the same profile
+  -- starts the second run with the first run's (disabled) permanent timers still
+  -- in place. Specs below therefore count relative to what already exists rather
+  -- than assuming the timer they just made is the only one of its name.
+  local temporaryTimerIds = {}
+  local permanentTimerNames = {}
+  local settleCounter = 0
+
+  local function trackTemp(id)
+    if type(id) == "number" and id > 0 then
+      table.insert(temporaryTimerIds, id)
+    end
+    return id
+  end
+
+  local function trackPerm(name)
+    table.insert(permanentTimerNames, name)
+    return name
+  end
+
+  -- Waits for one of this block's own events, reporting the timeout message
+  -- instead of a bare nil when the event never arrives.
+  local function waitFor(eventName)
+    local name, message = waitForEvent(eventName, 5000)
+    assert.equals(eventName, name, "waiting for " .. eventName .. ": " .. tostring(message))
+    return name
+  end
+
+  -- Returns once `seconds` of real time have passed, by waiting for an event
+  -- raised from a real timer. Lua runs to completion between event loop turns, so
+  -- the timer cannot have fired before the wait below is in place. Each call gets
+  -- its own event name so that a settling timer which outlived a failing spec can
+  -- never satisfy a later one.
+  local function settle(seconds)
+    settleCounter = settleCounter + 1
+    local eventName = "w2aTimerSpecSettled" .. settleCounter
+    trackTemp(tempTimer(seconds, function() raiseEvent(eventName) end))
+    waitFor(eventName)
+  end
+
+  before_each(function()
+    _G.W2aTimerSpec = {fired = 0, order = {}}
+  end)
+
+  after_each(function()
+    for _, id in ipairs(temporaryTimerIds) do
+      pcall(killTimer, id)
+    end
+    temporaryTimerIds = {}
+    for _, name in ipairs(permanentTimerNames) do
+      pcall(disableTimer, name)
+    end
+    permanentTimerNames = {}
+    _G.W2aTimerSpec = nil
+    _G.W2aPermTimerFires = nil
+  end)
+
+  describe("Tests the functionality of tempTimer", function()
+    it("errors when called without a delay", function()
+      assert.has_error(function() tempTimer() end)
+    end)
+
+    it("errors when the delay is not a number", function()
+      assert.has_error(function() tempTimer({}, [[]]) end)
+    end)
+
+    it("errors when the body is neither a string nor a function", function()
+      assert.has_error(function() tempTimer(0.1, {}) end)
+    end)
+
+    it("returns -1 and a message when the code does not compile", function()
+      local id, message = tempTimer(0.1, "this is ( not lua")
+      assert.equals(-1, id)
+      assert.is_string(message)
+      assert.is_truthy(message:find("compile", 1, true),
+        "the failure should say the code could not be compiled, got: " .. tostring(message))
+    end)
+
+    it("fires a code-string body in the global environment", function()
+      trackTemp(tempTimer(0.05, [[
+        _G.W2aTimerSpec.fired = _G.W2aTimerSpec.fired + 1
+        raiseEvent("w2aTempTimerFired")
+      ]]))
+      waitFor("w2aTempTimerFired")
+      assert.equals(1, _G.W2aTimerSpec.fired)
+    end)
+
+    it("fires a function body", function()
+      trackTemp(tempTimer(0.05, function()
+        _G.W2aTimerSpec.fired = _G.W2aTimerSpec.fired + 1
+        raiseEvent("w2aTempTimerFunctionFired")
+      end))
+      waitFor("w2aTempTimerFunctionFired")
+      assert.equals(1, _G.W2aTimerSpec.fired)
+    end)
+
+    it("fires a zero delay timer", function()
+      trackTemp(tempTimer(0, function() raiseEvent("w2aZeroDelayTimerFired") end))
+      waitFor("w2aZeroDelayTimerFired")
+    end)
+
+    it("does not repeat by default", function()
+      -- a repeating 50ms timer would have fired several times over the 150ms below
+      trackTemp(tempTimer(0.05, function()
+        _G.W2aTimerSpec.fired = _G.W2aTimerSpec.fired + 1
+      end))
+      settle(0.15)
+      assert.equals(1, _G.W2aTimerSpec.fired)
+    end)
+
+    it("errors when the repeating argument is not a boolean", function()
+      assert.has_error(function() tempTimer(0.1, [[]], "w2aNotABoolean") end)
+    end)
+
+    it("repeats until killed when the repeating argument is true", function()
+      local id = trackTemp(tempTimer(0.02, [[
+        _G.W2aTimerSpec.fired = _G.W2aTimerSpec.fired + 1
+        raiseEvent("w2aRepeatingTimerFired")
+      ]], true))
+      assert.is_true(id > 0)
+      -- three separate waits, so each firing has to happen for itself
+      waitFor("w2aRepeatingTimerFired")
+      waitFor("w2aRepeatingTimerFired")
+      waitFor("w2aRepeatingTimerFired")
+      assert.is_true(killTimer(id))
+      assert.is_true(_G.W2aTimerSpec.fired >= 3,
+        "a repeating timer should fire more than once, fired " .. tostring(_G.W2aTimerSpec.fired) .. " times")
+    end)
+
+    it("runs a timer scheduled from inside another timer", function()
+      trackTemp(tempTimer(0, function()
+        table.insert(_G.W2aTimerSpec.order, "outer")
+        trackTemp(tempTimer(0, function()
+          table.insert(_G.W2aTimerSpec.order, "inner")
+          raiseEvent("w2aNestedTimerFired")
+        end))
+      end))
+      waitFor("w2aNestedTimerFired")
+      assert.are.same({"outer", "inner"}, _G.W2aTimerSpec.order)
+    end)
+  end)
+
+  describe("Tests the functionality of killTimer", function()
+    -- killTimer looks its argument up by name; temporary timers are simply named
+    -- after the id it returns, which is why passing that id works.
+    it("errors when called without an argument", function()
+      assert.has_error(function() killTimer() end)
+    end)
+
+    it("returns false when nothing of that name exists", function()
+      assert.is_false(killTimer("w2aNoSuchTimerName"))
+    end)
+
+    it("returns false for a permanent timer, which cannot be killed", function()
+      local before = exists("W2aPermTimerUnkillable", "timer")
+      assert.is_true(permTimer(trackPerm("W2aPermTimerUnkillable"), "", 30, [[]]) > 0)
+      assert.equals(before + 1, exists("W2aPermTimerUnkillable", "timer"))
+      assert.is_false(killTimer("W2aPermTimerUnkillable"))
+      assert.equals(before + 1, exists("W2aPermTimerUnkillable", "timer"),
+        "a permanent timer survives killTimer")
+    end)
+
+    it("stops a pending timer from ever firing and deactivates it", function()
+      local id = trackTemp(tempTimer(0.05, function()
+        _G.W2aTimerSpec.fired = _G.W2aTimerSpec.fired + 1
+      end))
+      assert.equals(1, isActive(id, "timer"))
+      assert.is_true(killTimer(id))
+      -- the killed timer object itself is only freed by the timer unit's deferred
+      -- cleanup, so check the state a user can see straight away instead
+      assert.equals(0, isActive(id, "timer"), "a killed timer is no longer active")
+      assert.is_nil((remainingTime(id)), "a killed timer is no longer counting down")
+      settle(0.15)
+      assert.equals(0, _G.W2aTimerSpec.fired, "a killed timer must never fire")
+    end)
+
+    it("stops a repeating timer", function()
+      local id = trackTemp(tempTimer(0.02, function()
+        _G.W2aTimerSpec.fired = _G.W2aTimerSpec.fired + 1
+        if _G.W2aTimerSpec.fired == 2 then raiseEvent("w2aRepeatingTimerToKill") end
+      end, true))
+      waitFor("w2aRepeatingTimerToKill")
+      assert.is_true(killTimer(id))
+      local firedWhenKilled = _G.W2aTimerSpec.fired
+      settle(0.15)
+      assert.equals(firedWhenKilled, _G.W2aTimerSpec.fired,
+        "a killed repeating timer must not fire again")
+    end)
+
+    it("kills a repeating timer from inside its own callback", function()
+      -- killing a timer while its own body is running is the deferred-delete
+      -- path: the timer unit may only free the object once the callback has
+      -- returned, but the kill still has to stop it firing again
+      local id
+      id = trackTemp(tempTimer(0.02, function()
+        _G.W2aTimerSpec.fired = _G.W2aTimerSpec.fired + 1
+        _G.W2aTimerSpec.killed = killTimer(id)
+        raiseEvent("w2aSelfKillingTimerFired")
+      end, true))
+      waitFor("w2aSelfKillingTimerFired")
+      assert.is_true(_G.W2aTimerSpec.killed,
+        "killTimer should report success from inside the timer's own callback")
+      local firedWhenKilled = _G.W2aTimerSpec.fired
+      settle(0.15)
+      assert.equals(firedWhenKilled, _G.W2aTimerSpec.fired,
+        "a self-killed timer must not fire again")
+    end)
+  end)
+
+  describe("Tests the functionality of remainingTime", function()
+    it("errors when given something that is neither a number nor a string", function()
+      assert.has_error(function() remainingTime({}) end)
+    end)
+
+    it("returns nil and a message for a number that is not a timer id", function()
+      local left, message = remainingTime(999999)
+      assert.is_nil(left)
+      assert.is_string(message)
+      assert.is_truthy(message:find("999999", 1, true))
+    end)
+
+    it("returns nil and a message for a name that is not a timer", function()
+      local left, message = remainingTime("w2aNoSuchTimerName")
+      assert.is_nil(left)
+      assert.is_string(message)
+      assert.is_truthy(message:find("w2aNoSuchTimerName", 1, true))
+    end)
+
+    it("returns nil and a message for an inactive timer", function()
+      -- permanent timers are created inactive, so their QTimer is not running
+      assert.is_true(permTimer(trackPerm("W2aPermTimerIdle"), "", 30, [[]]) > 0)
+      local left, message = remainingTime("W2aPermTimerIdle")
+      assert.is_nil(left)
+      assert.is_string(message)
+      assert.is_truthy(message:find("inactive", 1, true))
+    end)
+
+    it("reports the time left on a pending temporary timer in seconds", function()
+      local id = trackTemp(tempTimer(10, [[]]))
+      local left = remainingTime(id)
+      assert.is_number(left)
+      assert.is_true(left > 9 and left <= 10,
+        "a 10 second timer should have just under 10 seconds left, got " .. tostring(left))
+    end)
+
+    it("resolves a running temporary timer by its name, which is its id", function()
+      local id = trackTemp(tempTimer(10, [[]]))
+      local left = remainingTime(tostring(id))
+      assert.is_number(left)
+      assert.is_true(left > 9 and left <= 10,
+        "a 10 second timer should have just under 10 seconds left, got " .. tostring(left))
+    end)
+
+    it("resolves a running permanent timer by name", function()
+      assert.is_true(permTimer(trackPerm("W2aPermTimerCountdown"), "", 30, [[]]) > 0)
+      assert.is_true(enableTimer("W2aPermTimerCountdown"))
+      local left = remainingTime("W2aPermTimerCountdown")
+      assert.is_number(left)
+      assert.is_true(left > 29 and left <= 30,
+        "a 30 second timer should have just under 30 seconds left, got " .. tostring(left))
+    end)
+  end)
+
+  describe("Tests the functionality of permTimer with enableTimer and disableTimer", function()
+    it("errors when the parent group does not exist", function()
+      assert.has_error(function()
+        permTimer("W2aPermTimerOrphan", "w2aNoSuchTimerGroup", 1, [[]])
+      end)
+    end)
+
+    it("errors when the code does not compile", function()
+      assert.has_error(function()
+        permTimer(trackPerm("W2aPermTimerBadCode"), "", 1, "this is ( not lua")
+      end)
+    end)
+
+    it("errors when the interval is missing", function()
+      assert.has_error(function() permTimer("W2aPermTimerNoInterval", "") end)
+    end)
+
+    it("enableTimer and disableTimer error when called without a name", function()
+      assert.has_error(function() enableTimer() end)
+      assert.has_error(function() disableTimer() end)
+    end)
+
+    it("reports whether a timer of that name was found", function()
+      assert.is_true(permTimer(trackPerm("W2aPermTimerToggle"), "", 30, [[]]) > 0)
+      assert.is_true(enableTimer("W2aPermTimerToggle"))
+      assert.is_true(disableTimer("W2aPermTimerToggle"))
+      assert.is_false(enableTimer("w2aNoSuchTimerName"))
+      assert.is_false(disableTimer("w2aNoSuchTimerName"))
+    end)
+
+    it("does not fire while it is disabled", function()
+      -- permanent timers start out inactive and must be enabled before they run
+      assert.is_true(permTimer(trackPerm("W2aPermTimerDisabled"), "", 0.05,
+        [[_G.W2aPermTimerFires = (_G.W2aPermTimerFires or 0) + 1]]) > 0)
+      assert.equals(0, isActive("W2aPermTimerDisabled", "timer"))
+      settle(0.15)
+      assert.is_nil(_G.W2aPermTimerFires, "a disabled permanent timer must not fire")
+    end)
+
+    it("fires once enabled", function()
+      assert.is_true(permTimer(trackPerm("W2aPermTimerEnabled"), "", 0.05, [[
+        _G.W2aPermTimerFires = (_G.W2aPermTimerFires or 0) + 1
+        raiseEvent("w2aPermTimerFired")
+      ]]) > 0)
+      assert.is_true(enableTimer("W2aPermTimerEnabled"))
+      waitFor("w2aPermTimerFired")
+      disableTimer("W2aPermTimerEnabled")
+      assert.is_true((_G.W2aPermTimerFires or 0) >= 1)
+    end)
+
+    it("stops firing again once disabled", function()
+      assert.is_true(permTimer(trackPerm("W2aPermTimerStopped"), "", 0.05, [[
+        _G.W2aPermTimerFires = (_G.W2aPermTimerFires or 0) + 1
+        raiseEvent("w2aPermTimerStoppedFired")
+      ]]) > 0)
+      assert.is_true(enableTimer("W2aPermTimerStopped"))
+      waitFor("w2aPermTimerStoppedFired")
+      assert.is_true(disableTimer("W2aPermTimerStopped"))
+      local firedWhenDisabled = _G.W2aPermTimerFires
+      settle(0.15)
+      assert.equals(firedWhenDisabled, _G.W2aPermTimerFires,
+        "a disabled permanent timer must not fire again")
+    end)
+  end)
+
+  describe("Tests exists and isActive for timers", function()
+    it("both return nil and a message for an unknown item type", function()
+      -- exists lowercases the type before quoting it back, so use a type that is
+      -- lowercase to begin with and both messages can be checked the same way
+      local existing, existsMessage = exists("W2aWhatever", "w2anotanitemtype")
+      assert.is_nil(existing)
+      assert.is_string(existsMessage)
+      assert.is_truthy(existsMessage:find("w2anotanitemtype", 1, true))
+      local active, isActiveMessage = isActive("W2aWhatever", "w2anotanitemtype")
+      assert.is_nil(active)
+      assert.is_string(isActiveMessage)
+      assert.is_truthy(isActiveMessage:find("w2anotanitemtype", 1, true))
+    end)
+
+    it("both return nil and a message for a negative id", function()
+      local existing, existsMessage = exists(-1, "timer")
+      assert.is_nil(existing)
+      assert.is_string(existsMessage)
+      assert.is_truthy(existsMessage:find("-1", 1, true))
+      local active, isActiveMessage = isActive(-1, "timer")
+      assert.is_nil(active)
+      assert.is_string(isActiveMessage)
+      assert.is_truthy(isActiveMessage:find("-1", 1, true))
+    end)
+
+    it("exists counts a temporary timer by id and by name", function()
+      local id = trackTemp(tempTimer(10, [[]]))
+      -- a temporary timer is named after its own id
+      assert.equals(1, exists(id, "timer"))
+      assert.equals(1, exists(tostring(id), "timer"))
+      assert.equals(0, exists(id + 100000, "timer"))
+      assert.equals(0, exists("w2aNoSuchTimerName", "timer"))
+    end)
+
+    it("exists counts every permanent timer sharing a name", function()
+      local before = exists("W2aPermTimerTwins", "timer")
+      assert.is_true(permTimer(trackPerm("W2aPermTimerTwins"), "", 30, [[]]) > 0)
+      assert.equals(before + 1, exists("W2aPermTimerTwins", "timer"))
+      assert.is_true(permTimer(trackPerm("W2aPermTimerTwins"), "", 30, [[]]) > 0)
+      assert.equals(before + 2, exists("W2aPermTimerTwins", "timer"))
+    end)
+
+    it("isActive follows the enabled state of a permanent timer", function()
+      assert.is_true(permTimer(trackPerm("W2aPermTimerActivity"), "", 30, [[]]) > 0)
+      -- enabling and disabling by name acts on every timer of that name
+      local named = exists("W2aPermTimerActivity", "timer")
+      assert.equals(0, isActive("W2aPermTimerActivity", "timer"),
+        "a newly created permanent timer is inactive")
+      assert.is_true(enableTimer("W2aPermTimerActivity"))
+      assert.equals(named, isActive("W2aPermTimerActivity", "timer"))
+      assert.is_true(disableTimer("W2aPermTimerActivity"))
+      assert.equals(0, isActive("W2aPermTimerActivity", "timer"))
+    end)
+
+    it("isActive only reports a timer inside a disabled group as active when ancestors are not checked", function()
+      -- a permTimer with no interval and no code is a group/folder
+      assert.is_true(permTimer(trackPerm("W2aTimerGroup"), "", 0, "") > 0)
+      assert.is_true(permTimer(trackPerm("W2aTimerInGroup"), "W2aTimerGroup", 30,
+        [[_G.W2aPermTimerFires = (_G.W2aPermTimerFires or 0) + 1]]) > 0)
+      local named = exists("W2aTimerInGroup", "timer")
+      assert.is_true(enableTimer("W2aTimerInGroup"))
+      assert.equals(named, isActive("W2aTimerInGroup", "timer"))
+      assert.equals(0, isActive("W2aTimerInGroup", "timer", true),
+        "the enclosing group is still disabled")
+      -- and the flag is not the whole story: a timer whose group is disabled is
+      -- not counting down, whatever isActive says without checkAncestors
+      assert.is_nil((remainingTime("W2aTimerInGroup")),
+        "a timer in a disabled group should not be running")
+      assert.is_true(enableTimer("W2aTimerGroup"))
+      assert.equals(named, isActive("W2aTimerInGroup", "timer", true))
+      assert.is_number(remainingTime("W2aTimerInGroup"),
+        "enabling the group should start the timers inside it")
+    end)
+  end)
+end)
+
+describe("Tests the script API", function()
+  -- Permanent scripts cannot be removed from Lua, only blanked and disabled, and
+  -- the profile is written out when Mudlet closes: running the suite twice against
+  -- the same profile starts the second run with the first run's (empty, inactive)
+  -- scripts still present. Specs below therefore work out the position of the
+  -- script they just created instead of assuming it is the first of its name, and
+  -- count relative to what was already there. Script bodies create their own table
+  -- rather than assuming one exists, so a body that is recompiled later - when a
+  -- saved profile is loaded again, say - can never raise.
+  local createdScriptNames = {}
+
+  -- Creates a permanent script, returning its id and its position among the
+  -- scripts of that name, which is what getScript and setScript index by. New
+  -- scripts get the highest id, so they come last.
+  local function makeScript(name, parent, code)
+    table.insert(createdScriptNames, name)
+    local position = exists(name, "script") + 1
+    return permScript(name, parent, code), position
+  end
+
+  before_each(function()
+    _G.W2aScriptSpec = {}
+  end)
+
+  teardown(function()
+    for _, name in ipairs(createdScriptNames) do
+      pcall(disableScript, name)
+      -- blank every script of that name, duplicates included, so that nothing
+      -- created here can run again if the profile is saved and reloaded
+      for position = 1, exists(name, "script") do
+        pcall(setScript, name, "", position)
+      end
+    end
+    createdScriptNames = {}
+    _G.W2aScriptSpec = nil
+  end)
+
+  describe("Tests the functionality of permScript", function()
+    it("errors when the name is missing", function()
+      assert.has_error(function() permScript() end)
+    end)
+
+    it("errors when the parent group does not exist", function()
+      assert.has_error(function()
+        permScript("W2aScriptOrphan", "w2aNoSuchScriptGroup", [[]])
+      end)
+    end)
+
+    it("errors when the code does not parse", function()
+      assert.has_error(function()
+        makeScript("W2aScriptBadCode", "", "this is ( not lua")
+      end)
+    end)
+
+    it("creates nothing when the body parses but raises when it is run", function()
+      -- a script's body runs as it is compiled, so a body that raises fails
+      -- creation just like one that does not parse
+      local before = exists("W2aScriptRaises", "script")
+      assert.has_error(function()
+        makeScript("W2aScriptRaises", "", [[error("w2a script boom")]])
+      end)
+      assert.equals(before, exists("W2aScriptRaises", "script"))
+    end)
+
+    it("creates a script whose body runs immediately", function()
+      local before = exists("W2aScriptCreated", "script")
+      local id = makeScript("W2aScriptCreated", "", [[
+        _G.W2aScriptSpec = _G.W2aScriptSpec or {}
+        _G.W2aScriptSpec.created = true
+      ]])
+      assert.is_number(id)
+      assert.is_true(id > 0)
+      assert.is_true(_G.W2aScriptSpec.created, "a script's body runs when it is compiled")
+      assert.equals(before + 1, exists("W2aScriptCreated", "script"))
+    end)
+
+    it("creates a script inside a group", function()
+      -- a permScript with no code is a group/folder
+      assert.is_true(makeScript("W2aScriptGroup", "", "") > 0)
+      assert.is_true(makeScript("W2aScriptInGroup", "W2aScriptGroup", [[
+        _G.W2aScriptSpec = _G.W2aScriptSpec or {}
+        _G.W2aScriptSpec.inGroup = true
+      ]]) > 0)
+      assert.is_true(_G.W2aScriptSpec.inGroup)
+      local named = exists("W2aScriptInGroup", "script")
+      assert.is_true(enableScript("W2aScriptInGroup"))
+      assert.equals(named, isActive("W2aScriptInGroup", "script"))
+      assert.equals(0, isActive("W2aScriptInGroup", "script", true),
+        "the enclosing group is still disabled")
+      assert.is_true(enableScript("W2aScriptGroup"))
+      assert.equals(named, isActive("W2aScriptInGroup", "script", true))
+    end)
+  end)
+
+  describe("Tests the functionality of getScript", function()
+    it("errors when called without a name", function()
+      assert.has_error(function() getScript() end)
+    end)
+
+    it("returns -1 and a message for a script that does not exist", function()
+      local code, message = getScript("w2aNoSuchScriptName")
+      assert.equals(-1, code)
+      assert.is_string(message)
+      assert.is_truthy(message:find("w2aNoSuchScriptName", 1, true))
+    end)
+
+    it("returns -1 and a message for a position that does not exist", function()
+      local _, position = makeScript("W2aScriptOnePosition", "", [[local w2aOnly = 1]])
+      local beyondTheLast = position + 1
+      local code, message = getScript("W2aScriptOnePosition", beyondTheLast)
+      assert.equals(-1, code)
+      assert.is_string(message)
+      assert.is_truthy(message:find("position " .. beyondTheLast, 1, true))
+    end)
+
+    it("returns -1 and a message for position zero, as positions start at one", function()
+      makeScript("W2aScriptPositionZero", "", [[local w2aOnly = 1]])
+      local code, message = getScript("W2aScriptPositionZero", 0)
+      assert.equals(-1, code)
+      assert.is_string(message)
+      assert.is_truthy(message:find("position 0", 1, true))
+    end)
+
+    it("returns the code and the id of the script", function()
+      local body = [[local w2aReadBack = "getScript round trip"]]
+      local id, position = makeScript("W2aScriptReadBack", "", body)
+      local code, readId = getScript("W2aScriptReadBack", position)
+      assert.equals(body, code)
+      assert.equals(id, readId)
+    end)
+
+    it("reads the script at the requested position when several share a name", function()
+      local firstId, firstPosition = makeScript("W2aScriptDuplicate", "", [[local w2aFirst = 1]])
+      local secondId, secondPosition = makeScript("W2aScriptDuplicate", "", [[local w2aSecond = 2]])
+      assert.equals(firstPosition + 1, secondPosition)
+      local firstCode, firstReadId = getScript("W2aScriptDuplicate", firstPosition)
+      local secondCode, secondReadId = getScript("W2aScriptDuplicate", secondPosition)
+      assert.equals([[local w2aFirst = 1]], firstCode)
+      assert.equals(firstId, firstReadId)
+      assert.equals([[local w2aSecond = 2]], secondCode)
+      assert.equals(secondId, secondReadId)
+    end)
+  end)
+
+  describe("Tests the functionality of setScript", function()
+    it("errors for a script name that does not exist", function()
+      assert.has_error(function() setScript("w2aNoSuchScriptName", [[]]) end)
+    end)
+
+    it("errors for an empty name", function()
+      assert.has_error(function() setScript("", [[]]) end)
+    end)
+
+    it("errors for position zero, as positions start at one", function()
+      makeScript("W2aScriptSetPositionZero", "", [[local w2aOnly = 1]])
+      assert.has_error(function()
+        setScript("W2aScriptSetPositionZero", [[local w2aChanged = 1]], 0)
+      end)
+    end)
+
+    it("errors when the code is not a string", function()
+      local _, position = makeScript("W2aScriptBadNewCode", "", [[local w2aOriginal = 1]])
+      assert.has_error(function() setScript("W2aScriptBadNewCode", {}, position) end)
+    end)
+
+    it("replaces the code, returns the id and runs the new body", function()
+      local id, position = makeScript("W2aScriptReplaced", "", [[local w2aOriginal = 1]])
+      local newBody = [[
+        _G.W2aScriptSpec = _G.W2aScriptSpec or {}
+        _G.W2aScriptSpec.replaced = true
+      ]]
+      assert.equals(id, setScript("W2aScriptReplaced", newBody, position))
+      assert.equals(newBody, (getScript("W2aScriptReplaced", position)))
+      assert.is_true(_G.W2aScriptSpec.replaced, "the replacement body should have run")
+    end)
+
+    it("rejects code that does not parse before touching the script", function()
+      -- this one never reaches the script: setScript syntax checks its code
+      -- argument first
+      local body = [[local w2aKept = 1]]
+      local _, position = makeScript("W2aScriptKeptCode", "", body)
+      assert.has_error(function() setScript("W2aScriptKeptCode", "this is ( not lua", position) end)
+      assert.equals(body, (getScript("W2aScriptKeptCode", position)))
+    end)
+
+    it("puts the previous code back when the new body raises as it is run", function()
+      -- code that parses gets past the argument check and is then run as it is
+      -- compiled into the script, so this is the path that has to roll back
+      local body = [[local w2aRolledBack = 1]]
+      local _, position = makeScript("W2aScriptRollback", "", body)
+      assert.has_error(function()
+        setScript("W2aScriptRollback", [[error("w2a setScript boom")]], position)
+      end)
+      assert.equals(body, (getScript("W2aScriptRollback", position)))
+    end)
+
+    it("sets the script at the requested position when several share a name", function()
+      local _, firstPosition = makeScript("W2aScriptSetPosition", "", [[local w2aFirst = 1]])
+      local secondId, secondPosition = makeScript("W2aScriptSetPosition", "", [[local w2aSecond = 2]])
+      assert.equals(secondId, setScript("W2aScriptSetPosition", [[local w2aSecondChanged = 2]], secondPosition))
+      assert.equals([[local w2aFirst = 1]], (getScript("W2aScriptSetPosition", firstPosition)))
+      assert.equals([[local w2aSecondChanged = 2]], (getScript("W2aScriptSetPosition", secondPosition)))
+    end)
+  end)
+
+  describe("Tests the functionality of appendScript", function()
+    it("errors when the name is not a string", function()
+      assert.has_error(function() appendScript(42, [[]]) end,
+        "appendScript: bad argument #1 type (script name as string expected, got number!)")
+    end)
+
+    it("errors when the code is not a string", function()
+      assert.has_error(function() appendScript("W2aScriptAppended", 42) end,
+        "appendScript: bad argument #2 type (lua code as string expected, got number!)")
+    end)
+
+    it("errors instead of creating anything when the script does not exist", function()
+      -- appendScript does not check getScript's -1 sentinel, so what actually
+      -- reports the missing script is the setScript underneath it; either way
+      -- nothing may be created
+      assert.has_error(function() appendScript("w2aNoSuchScriptName", [[local w2aNew = 1]]) end)
+      assert.equals(0, exists("w2aNoSuchScriptName", "script"))
+    end)
+
+    it("adds the new code on a line of its own after the existing code", function()
+      local body = [[local w2aOriginal = 1]]
+      local _, position = makeScript("W2aScriptAppended", "", body)
+      appendScript("W2aScriptAppended", [[local w2aAppended = 2]], position)
+      assert.equals(body .. "\n" .. [[local w2aAppended = 2]],
+        (getScript("W2aScriptAppended", position)))
+    end)
+
+    it("appends to the first script of that name when no position is given", function()
+      makeScript("W2aScriptAppendDefault", "", [[local w2aOriginal = 1]])
+      -- whatever is at position 1 is what the default has to append to
+      local firstBefore = (getScript("W2aScriptAppendDefault", 1))
+      assert.is_string(firstBefore)
+      appendScript("W2aScriptAppendDefault", [[local w2aDefaultAppended = 2]])
+      assert.equals(firstBefore .. "\n" .. [[local w2aDefaultAppended = 2]],
+        (getScript("W2aScriptAppendDefault", 1)))
+    end)
+
+    it("runs the appended code", function()
+      local _, position = makeScript("W2aScriptAppendRuns", "", [[local w2aOriginal = 1]])
+      appendScript("W2aScriptAppendRuns", [[
+        _G.W2aScriptSpec = _G.W2aScriptSpec or {}
+        _G.W2aScriptSpec.appended = true
+      ]], position)
+      assert.is_true(_G.W2aScriptSpec.appended)
+    end)
+  end)
+
+  describe("Tests the functionality of enableScript and disableScript", function()
+    it("error when called without a name", function()
+      assert.has_error(function() enableScript() end)
+      assert.has_error(function() disableScript() end)
+    end)
+
+    it("return nil and a message when no script of that name exists", function()
+      local enabled, enableMessage = enableScript("w2aNoSuchScriptName")
+      assert.is_nil(enabled)
+      assert.is_string(enableMessage)
+      assert.is_truthy(enableMessage:find("w2aNoSuchScriptName", 1, true))
+      local disabled, disableMessage = disableScript("w2aNoSuchScriptName")
+      assert.is_nil(disabled)
+      assert.is_string(disableMessage)
+      assert.is_truthy(disableMessage:find("w2aNoSuchScriptName", 1, true))
+    end)
+
+    it("toggle the active state a script reports through isActive", function()
+      assert.is_true(makeScript("W2aScriptToggled", "", [[local w2aOnly = 1]]) > 0)
+      -- enabling and disabling by name acts on every script of that name
+      local named = exists("W2aScriptToggled", "script")
+      assert.equals(0, isActive("W2aScriptToggled", "script"),
+        "a newly created script is inactive")
+      assert.is_true(enableScript("W2aScriptToggled"))
+      assert.equals(named, isActive("W2aScriptToggled", "script"))
+      assert.is_true(disableScript("W2aScriptToggled"))
+      assert.equals(0, isActive("W2aScriptToggled", "script"))
+    end)
+
+    it("toggle every script sharing a name, not just the first", function()
+      assert.is_true(makeScript("W2aScriptToggledTwice", "", [[local w2aFirst = 1]]) > 0)
+      assert.is_true(makeScript("W2aScriptToggledTwice", "", [[local w2aSecond = 2]]) > 0)
+      local named = exists("W2aScriptToggledTwice", "script")
+      assert.is_true(named >= 2)
+      assert.is_true(enableScript("W2aScriptToggledTwice"))
+      assert.equals(named, isActive("W2aScriptToggledTwice", "script"))
+      assert.is_true(disableScript("W2aScriptToggledTwice"))
+      assert.equals(0, isActive("W2aScriptToggledTwice", "script"))
+    end)
+
+    it("do not disturb a differently named script", function()
+      assert.is_true(makeScript("W2aScriptUntouched", "", [[local w2aOne = 1]]) > 0)
+      assert.is_true(makeScript("W2aScriptSwitched", "", [[local w2aTwo = 2]]) > 0)
+      local untouched = exists("W2aScriptUntouched", "script")
+      assert.is_true(enableScript("W2aScriptUntouched"))
+      assert.is_true(enableScript("W2aScriptSwitched"))
+      assert.is_true(disableScript("W2aScriptSwitched"))
+      assert.equals(untouched, isActive("W2aScriptUntouched", "script"))
+      assert.equals(0, isActive("W2aScriptSwitched", "script"))
+    end)
+  end)
+end)

From 102a08fc518c587e719e01149dc1629a871d5a06 Mon Sep 17 00:00:00 2001
From: Delwing 
Date: Sun, 2 Aug 2026 22:23:12 +0200
Subject: [PATCH 056/155] Infrastucture: ignore multiple build targets (#9562)

so any local custom target is already excluded
---
 .gitignore | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/.gitignore b/.gitignore
index 049ce18a0..cd577ad2a 100644
--- a/.gitignore
+++ b/.gitignore
@@ -31,10 +31,7 @@ CMakeLists.txt.user
 
 #CLion
 .idea
-cmake-build-debug
-cmake-build-minsizerel
-cmake-build-release
-cmake-build-relwithdebinfo
+cmake-build-*/
 
 #VS Code
 .vscode/*.code-workspace

From 3474cb58dc582993a1294528a956a1531e3f4ff7 Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Mon, 3 Aug 2026 06:24:40 +0200
Subject: [PATCH 057/155] fix: media start events fired too early when
 replaying a just-stopped sound (#9611)

#### Brief overview of PR changes/additions
- Since #9569 deferred the stop cleanup, replaying the file a player
just finished starts it synchronously, raising sysMediaStarted inside
the playSoundFile()/playMusicFile() call itself instead of
asynchronously as before
- Clear the reused player's stale source at claim time in
TMedia::play(), so every fresh play request loads asynchronously again;
the #9569 looping fix is untouched (TMediaLoopTest still passes 6/6, 0
skipped)

#### Motivation for adding to Mudlet
Unbreaks CI for all open PRs: the 6 Media_spec.lua failures on ubuntu
and windows64 (waitForEvent armed after the call misses the
now-synchronous event) come from this.

#### Other info
Root cause is #9569 (92f01b850) merged an hour before the media specs;
their CI runs never overlapped. Assisted-by: Claude:claude-fable-5

**Test case:** busted Media_spec.lua - 6 failures on current
development, 54/0/0 with this fix (full suite 1801/0/0).
---
 src/TMedia.cpp | 21 +++++++++++++++++++++
 src/TMedia.h   |  1 +
 2 files changed, 22 insertions(+)

diff --git a/src/TMedia.cpp b/src/TMedia.cpp
index b4955c0b0..c5985d6a6 100644
--- a/src/TMedia.cpp
+++ b/src/TMedia.cpp
@@ -588,6 +588,25 @@ int TMedia::playersHoldingSource() const
            + countHeld(mAPIVideoList);
 }
 
+// The cleanup that releases a stopped player's source runs one event-loop turn
+// after the stop (see handlePlayerPlaybackStateChanged), so a player reused for
+// a new play request can still hold the file it just finished. Replaying that
+// same file leaves QMediaPlayer with its media already loaded, so play() starts
+// it synchronously, raising sysMediaStarted re-entrantly inside the script call
+// that started it. Finish the deferred cleanup here instead, so every fresh
+// play request loads its media asynchronously, as it did when the cleanup ran
+// at stop time.
+void TMedia::releaseStoppedSource(const std::shared_ptr& player)
+{
+    if (!player || !player->mediaPlayer()) {
+        return;
+    }
+
+    if (player->getPlaybackState() == QMediaPlayer::StoppedState && !player->mediaPlayer()->source().isEmpty()) {
+        player->mediaPlayer()->setSource(QUrl());
+    }
+}
+
 void TMedia::setMediaPlayersMuted(const TMediaData::MediaProtocol mediaProtocol, const bool state)
 {
     TMediaData mediaData{};
@@ -1658,6 +1677,7 @@ void TMedia::play(TMediaData& mediaData)
         }
 
         const QUrl mediaSource = mediaData.mediaInput() == TMediaData::MediaInputFile ? QUrl::fromLocalFile(absolutePathFileName) : QUrl(absolutePathFileName);
+        releaseStoppedSource(pPlayer);
         pPlayer->noteClaimed();
         pPlayer->mediaPlayer()->setSource(mediaSource);
     } else {
@@ -1725,6 +1745,7 @@ void TMedia::play(TMediaData& mediaData)
 
         playlist->setCurrentIndex(0);
         pPlayer->setPlaylist(playlist);
+        releaseStoppedSource(pPlayer);
         pPlayer->noteClaimed();
         pPlayer->mediaPlayer()->setSource(playlist->currentMedia());
     }
diff --git a/src/TMedia.h b/src/TMedia.h
index cc4823d5c..a2566dbc0 100644
--- a/src/TMedia.h
+++ b/src/TMedia.h
@@ -183,6 +183,7 @@ private:
     bool isMediaMatch(const std::shared_ptr& player, const TMediaData& mediaData);
     bool resume(TMediaData mediaData);
     void setMediaPlayersMuted(const TMediaData::MediaProtocol mediaProtocol, const bool state);
+    static void releaseStoppedSource(const std::shared_ptr& player);
     void transitionNonRelativeFile(TMediaData& mediaData);
     QString getStreamUrl(const TMediaData& mediaData);
     QUrl parseUrl(TMediaData& mediaData);

From bf95b4bebefabeca6a7c7075775402b0f3f256bc Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Mon, 3 Aug 2026 08:51:38 +0200
Subject: [PATCH 058/155] fix: ttsSetVoiceByName return garbage and stale
 ttsSpeechStarted text (#9595)

Two TTS bugs the Wave 2 specs found and documented as pending. Both are
ordering mistakes where an event is raised too early, so scripts that
listen for TTS events get wrong data.

- `ttsSetVoiceByName` pushed its `true` before raising
`ttsVoiceChanged`. Event dispatch is synchronous and
`callEventHandler()` ends with `lua_pop(L, lua_gettop(L))`, so whenever
a handler was listening the caller got stack garbage (a C function, in
practice) instead of `true`. Now pushed after the event, as
`ttsSetVoiceByIndex` already does.
- `ttsSpeak()` and the queue drain in `ttsStateChanged()` recorded
`speechCurrent` after `say()`, but the engine switches to Speaking
inside that call, so `ttsSpeechStarted` carried the *previous* utterance
(empty on the session's first one). Recorded before `say()` now, in both
places.
- Flips the two specs that documented these as pending, and pins each
half of the ordering fix separately so a one-sided regression names
itself.

Fixes #9590
Fixes #9591

Stacked on #9573 - the specs it adds live in `Media_spec.lua`, so this
targets `specs-http-media-tts` and will retarget to `development` when
that merges.

**Test case:** busted suite 1360 successes / 0 failures / 0 errors / 0
pending twice (baseline 1356/0/0/**2 pending** - both pendings were
these bugs); fail-without-fix confirmed per hunk - reverting only
`ttsSetVoiceByName` gives `function: 0x...` where `true` is expected,
only `ttsSpeak()` gives `''` then `'second line'` for the text that just
started, only the queue drain gives `'the line that gets skipped'`
twice.

Assisted-by: Claude:claude-opus-5
---
 src/TLuaInterpreterTextToSpeech.cpp |  15 ++--
 src/mudlet-lua/tests/Media_spec.lua | 113 ++++++++++++++++++++++------
 2 files changed, 100 insertions(+), 28 deletions(-)

diff --git a/src/TLuaInterpreterTextToSpeech.cpp b/src/TLuaInterpreterTextToSpeech.cpp
index 134c9a12e..7f763d00a 100644
--- a/src/TLuaInterpreterTextToSpeech.cpp
+++ b/src/TLuaInterpreterTextToSpeech.cpp
@@ -161,11 +161,12 @@ void TLuaInterpreter::ttsStateChanged(QTextToSpeech::State state)
         return;
     }
 
-    QString textToSay;
-    textToSay = speechQueue.takeFirst();
+    const QString textToSay = speechQueue.takeFirst();
 
-    speechUnit->say(textToSay);
+    // recorded before say() because the engine can switch to Speaking inside
+    // that call, and this function reports speechCurrent with the event
     speechCurrent = textToSay;
+    speechUnit->say(textToSay);
 
     return;
 }
@@ -403,8 +404,10 @@ int TLuaInterpreter::ttsSpeak(lua_State* L)
         }
     }
 
-    speechUnit->say(textToSay);
+    // recorded before say() because the engine can switch to Speaking inside
+    // that call, and ttsStateChanged() reports speechCurrent with the event
     speechCurrent = textToSay;
+    speechUnit->say(textToSay);
     return 0;
 }
 
@@ -522,7 +525,6 @@ int TLuaInterpreter::ttsSetVoiceByName(lua_State* L)
     for (const auto& voice : speechVoices) {
         if (voice.name() == nextVoice) {
             speechUnit->setVoice(voice);
-            lua_pushboolean(L, true);
 
             TEvent event{};
             event.mArgumentList.append(QLatin1String("ttsVoiceChanged"));
@@ -531,6 +533,9 @@ int TLuaInterpreter::ttsSetVoiceByName(lua_State* L)
             event.mArgumentTypeList.append(ARGUMENT_TYPE_STRING);
             mudlet::self()->getHostManager().postInterHostEvent(NULL, event, true);
 
+            // pushed only after the event: dispatching it runs Lua event
+            // handlers, which clear this lua_State's stack
+            lua_pushboolean(L, true);
             return 1;
         }
     }
diff --git a/src/mudlet-lua/tests/Media_spec.lua b/src/mudlet-lua/tests/Media_spec.lua
index 87d5a25de..3ca8fd684 100644
--- a/src/mudlet-lua/tests/Media_spec.lua
+++ b/src/mudlet-lua/tests/Media_spec.lua
@@ -558,6 +558,20 @@ describe("Tests the text-to-speech Lua API", function()
         return true
       end
 
+      -- Switching voice needs a second voice to switch to. Gated like
+      -- noMockEngine() so a mock engine that stopped offering two voices cannot
+      -- quietly turn the voice-switching specs green by pending them.
+      local function tooFewVoices()
+        if #ttsGetVoices() >= 2 then
+          return false
+        end
+        if requireMock then
+          assert.is_true(false, "MUDLET_TEST_REQUIRE_TTS_MOCK is set but the mock TTS engine offers fewer than two voices")
+        end
+        pending("the mock engine offers only one voice in this environment")
+        return true
+      end
+
       -- Collects every occurrence of an event for the duration of one spec.
       -- The mock engine changes state inside the ttsSpeak()/ttsSkip() call
       -- itself, so the matching event is raised before a waitForEvent() could
@@ -703,7 +717,9 @@ describe("Tests the text-to-speech Lua API", function()
         ttsSpeak("Mudlet spec one")
         assert.equals("ttsSpeechStarted", ttsGetState())
         assert.equals("Mudlet spec one", ttsGetCurrentLine())
-        assert.equals(1, #started)
+        -- the first utterance of a session used to report an empty text here,
+        -- see the ttsSpeechStarted spec below
+        assert.same({"Mudlet spec one"}, started)
 
         assert.equals("ttsSpeechReady", (waitForEvent("ttsSpeechReady", 5000)))
         assert.equals("ttsSpeechReady", ttsGetState())
@@ -898,22 +914,16 @@ describe("Tests the text-to-speech Lua API", function()
       end)
 
       it("the voice setters switch voice and report it back", function()
-        if noMockEngine() then
+        if noMockEngine() or tooFewVoices() then
           return
         end
         local voices = ttsGetVoices()
-        if #voices < 2 then
-          pending("the mock engine offers only one voice in this environment")
-          return
-        end
         local changes = {}
         local originalVoice = ttsGetCurrentVoice()
         collect("ttsVoiceChanged", changes)
         finally(function() ttsSetVoiceByName(originalVoice) end)
 
-        -- ttsSetVoiceByName's return value is deliberately not asserted here;
-        -- see the pending spec below for why.
-        ttsSetVoiceByName(voices[2])
+        assert.is_true(ttsSetVoiceByName(voices[2]))
         assert.equals(voices[2], ttsGetCurrentVoice())
         assert.is_true(ttsSetVoiceByIndex(1))
         assert.equals(voices[1], ttsGetCurrentVoice())
@@ -924,26 +934,83 @@ describe("Tests the text-to-speech Lua API", function()
         if noMockEngine() then
           return
         end
-        -- Not asserted, because it does not hold: ttsSpeak() calls say() before
-        -- it stores the text, and the engine changes state inside say(), so the
-        -- event is raised while the previous utterance is still recorded as the
-        -- current one. ttsGetCurrentLine() is correct, and the spec above uses
-        -- it; the event's own argument lags one utterance behind. The queue
-        -- drain path in ttsStateChanged() has the same ordering.
-        pending("ttsSpeechStarted reports the previously spoken text, not the one that just started")
+        -- Regression #9591: the text used to be recorded after say() returned,
+        -- and the engine changes state inside say(), so the event carried the
+        -- previous utterance. The handler has to be armed up front because the
+        -- event is raised before ttsSpeak() returns.
+        -- The event only fires on a state transition, so the skip between the
+        -- two utterances is required: speaking over an utterance that is still
+        -- running raises no second event at all.
+        local started = {}
+        collect("ttsSpeechStarted", started)
+
+        ttsClearQueue()
+        ttsSpeak("first spoken line")
+        assert.same({"first spoken line"}, started)
+
+        ttsSkip()
+        ttsSpeak("second spoken line")
+        assert.same({"first spoken line", "second spoken line"}, started)
+      end)
+
+      it("ttsSpeechStarted carries the queued line the drain started speaking", function()
+        if noMockEngine() then
+          return
+        end
+        -- Regression #9591 again: the queue drain in ttsStateChanged() had the
+        -- same say()-before-record ordering as ttsSpeak(), so the event named
+        -- the utterance the skip had just ended rather than the queued one that
+        -- replaced it. ttsGetCurrentLine() reads correctly either way, so only
+        -- the event's own argument can catch this.
+        local started = {}
+        collect("ttsSpeechStarted", started)
+
+        ttsClearQueue()
+        ttsSpeak("the line that gets skipped")
+        ttsQueue("line taken off the queue")
+        ttsSkip()
+        assert.same({"the line that gets skipped", "line taken off the queue"}, started)
+      end)
+
+      it("speaking over a busy engine leaves the direct utterance current", function()
+        if noMockEngine() then
+          return
+        end
+        -- Guards the ordering the two specs above rely on: ttsSpeak() records
+        -- the text before say(), so an engine that drained the queue from
+        -- inside say() would leave the queued line reported as the current one
+        -- instead of the utterance actually asked for. Speaking over a busy
+        -- engine does not pass through Ready, so no drain happens.
+        ttsClearQueue()
+        ttsSpeak("the busy utterance")
+        ttsQueue("still queued")
+        ttsSpeak("the direct utterance")
+        assert.equals(1, #ttsGetQueue())
+        assert.equals("the direct utterance", ttsGetCurrentLine())
       end)
 
       it("ttsSetVoiceByName reports success for a voice it switched to", function()
         if noMockEngine() then
           return
         end
-        -- Not asserted, because it does not hold: ttsSetVoiceByName pushes its
-        -- boolean result onto the Lua stack before raising ttsVoiceChanged, and
-        -- dispatching that event clears the stack underneath it, so the caller
-        -- is handed whatever is left there (a C function, in practice) instead
-        -- of true. Its sibling ttsSetVoiceByIndex pushes after raising the
-        -- event and does return true, which is what the spec above checks.
-        pending("ttsSetVoiceByName's return value is destroyed by the ttsVoiceChanged event it raises")
+        local voices = ttsGetVoices()
+        if #voices < 2 then
+          pending("the mock engine offers only one voice in this environment")
+          return
+        end
+        -- Regression #9590: the result used to be pushed onto the Lua stack
+        -- before ttsVoiceChanged was raised, and dispatching that event clears
+        -- the stack underneath it, so the caller was handed stack garbage. A
+        -- handler must be listening for the event to reach Lua at all, which is
+        -- what collect() arranges here.
+        local changes = {}
+        collect("ttsVoiceChanged", changes)
+        local originalVoice = ttsGetCurrentVoice()
+        finally(function() ttsSetVoiceByName(originalVoice) end)
+
+        assert.is_true(ttsSetVoiceByName(voices[2]))
+        assert.equals(voices[2], ttsGetCurrentVoice())
+        assert.same({voices[2]}, changes)
       end)
     end)
   end)

From 81675b7eb6c0c01acb74d92dc92ee8cd8c1ce387 Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Mon, 3 Aug 2026 08:54:46 +0200
Subject: [PATCH 059/155] fix: tempTimer negative time, compile() error slot,
 killTimer idempotency (#9597)

Three bugs the Wave 2 timer/script specs turned up, each fixed and its
spec flipped to assert the fixed contract.

- **`tempTimer`/`permTimer` reject an out of range delay.**
`QTime::addMSecs()` wraps around the 24 hour clock, so `-1` silently
became a timer firing almost a day later (and `86400` one firing
immediately, on every event loop turn if repeating). Rejecting as a bad
argument rather than through `tempTimer`'s `-1` return matters:
`IDMgr:register` treats `-1` as a handler id, so `registerNamedTimer`
reported success for a timer that was never created.
- **`compile()` reports the Lua error, not the script's name.** It read
absolute stack slot 1, which inside the calling C function's frame is
that function's first argument. It now reads the error object Lua left
on top of the stack and restores the caller's stack instead of clearing
it.
- **`killTimer()` returns false for an already dead timer.** The
deferred delete cannot run while a timer script is on the call stack, so
the corpse stayed findable by name and a second kill claimed to have
done something. This also covers a one-shot that has already fired,
which is what the manual has always documented.

Fixes #9579
Fixes #9580
Fixes #9581

Stacked on #9572, whose specs this extends; it retargets to
`development` once that merges.

**Test case:** busted suite 1382 successes / 0 failures / 0 errors / 2
pending, twice; the 10 flipped or added specs all fail against the
unfixed binary (1372/10), e.g. `reason: Lua syntax error:0.125` instead
of the parser error, and the second `killTimer` returning `true`.

Assisted-by: Claude:claude-opus-5
---
 src/TLuaInterpreter.cpp              |  23 +++--
 src/TLuaInterpreterMudletObjects.cpp |  24 +++++
 src/TimerUnit.cpp                    |   8 ++
 src/mudlet-lua/tests/Other_spec.lua  | 129 ++++++++++++++++++++++++---
 4 files changed, 165 insertions(+), 19 deletions(-)

diff --git a/src/TLuaInterpreter.cpp b/src/TLuaInterpreter.cpp
index 44f09148c..bd516abb0 100644
--- a/src/TLuaInterpreter.cpp
+++ b/src/TLuaInterpreter.cpp
@@ -3286,13 +3286,22 @@ QString TLuaInterpreter::formatLuaCode(const QString& code)
 bool TLuaInterpreter::compile(const QString& code, QString& errorMsg, const QString& name)
 {
     lua_State* L = pGlobalLua;
+    // This runs on the global lua_State, which is shared with whatever C
+    // function is calling us, so everything already on the stack is that
+    // caller's and has to be left exactly as it was found:
+    const int callerStackTop = lua_gettop(L);
 
     const int error = (luaL_loadbuffer(L, code.toUtf8().constData(), strlen(code.toUtf8().constData()), name.toUtf8().constData()) || lua_pcall(L, 0, 0, 0));
 
     if (error) {
+        // The error object is on the top of the stack. Absolute slot 1 - which
+        // this used to read - is the calling C function's first argument, which
+        // is how a failure came to be reported as the script's own name.
         std::string e = "Lua syntax error:";
-        if (lua_isstring(L, 1)) {
-            e.append(lua_tostring(L, 1));
+        if (lua_isstring(L, -1)) {
+            e.append(lua_tostring(L, -1));
+        } else {
+            e.append("error object is a ").append(luaL_typename(L, -1)).append(" value");
         }
         errorMsg = "";
         errorMsg.append(QString::fromStdString(e).toHtmlEscaped().toUtf8());
@@ -3301,13 +3310,11 @@ bool TLuaInterpreter::compile(const QString& code, QString& errorMsg, const QStr
             auto& host = getHostFromLua(L);
             TDebug(Qt::white, Qt::red) << "\n " << e.c_str() << "\n" >> &host;
         }
-    } else {
-        if (mudlet::smDebugMode) {
-            auto& host = getHostFromLua(L);
-            TDebug(Qt::white, Qt::darkGreen) << "LUA: code compiled without errors. OK\n" >> &host;
-        }
+    } else if (mudlet::smDebugMode) {
+        auto& host = getHostFromLua(L);
+        TDebug(Qt::white, Qt::darkGreen) << "LUA: code compiled without errors. OK\n" >> &host;
     }
-    lua_pop(L, lua_gettop(L));
+    lua_settop(L, callerStackTop);
 
     return !error;
 }
diff --git a/src/TLuaInterpreterMudletObjects.cpp b/src/TLuaInterpreterMudletObjects.cpp
index 77a6ca766..955b9ae31 100644
--- a/src/TLuaInterpreterMudletObjects.cpp
+++ b/src/TLuaInterpreterMudletObjects.cpp
@@ -61,6 +61,7 @@
 #endif
 
 #include 
+#include 
 #include 
 #include 
 
@@ -112,6 +113,21 @@ static bool isMain(const QString& name)
     return false;
 }
 
+// Both timer creators turn the delay into the timer's interval with
+// QTime(0, 0, 0, 0).addMSecs(qRound(time * 1000)), which wraps around the 24
+// hour clock: a negative delay would silently give a timer firing almost a day
+// later, and a whole day one with no interval at all - firing on every event
+// loop turn, were it repeating. It is the rounded milliseconds that have to be
+// bounded and not the delay itself, as 86399.9995 seconds is under the day yet
+// rounds up onto it. Repeating the rounding here in the double domain keeps a
+// huge delay from overflowing the int conversion qRound() would do first, and
+// the comparison is written so that a NaN delay is rejected as well:
+static bool timerDelayFits(const double time)
+{
+    const double msec = std::floor(time * 1000.0 + 0.5);
+    return msec >= 0 && msec < 86400000;
+}
+
 #define WINDOW_NAME(ARG_L, ARG_pos)                                                                                                                                                                    \
     ({                                                                                                                                                                                                 \
         int pos_ = (ARG_pos);                                                                                                                                                                          \
@@ -1308,6 +1324,10 @@ int TLuaInterpreter::permTimer(lua_State* L)
     const QString name = getVerifiedString(L, __func__, 1, "timer name");
     const QString parent = getVerifiedString(L, __func__, 2, "timer parent name");
     const double time = getVerifiedDouble(L, __func__, 3, "time in seconds");
+    if (!timerDelayFits(time)) {
+        lua_pushfstring(L, "permTimer: bad argument #3 value (time in seconds must be at least 0 and less than 86400, got %f)", time);
+        return lua_error(L);
+    }
     Host& host = getHostFromLua(L);
     TLuaInterpreter* pLuaInterpreter = host.getLuaInterpreter();
     if (pLuaInterpreter->reportInvalidLuaCodeParam(L, "permTimer", 4)) {
@@ -2722,6 +2742,10 @@ int TLuaInterpreter::tempTimer(lua_State* L)
 {
     bool repeating{};
     const double time = getVerifiedDouble(L, __func__, 1, "time in seconds {maybe decimal}");
+    if (!timerDelayFits(time)) {
+        lua_pushfstring(L, "tempTimer: bad argument #1 value (time in seconds must be at least 0 and less than 86400, got %f)", time);
+        return lua_error(L);
+    }
     const int n = lua_gettop(L);
 
     Host& host = getHostFromLua(L);
diff --git a/src/TimerUnit.cpp b/src/TimerUnit.cpp
index 7fdb0f46d..fd6ecfa28 100644
--- a/src/TimerUnit.cpp
+++ b/src/TimerUnit.cpp
@@ -402,6 +402,14 @@ bool TimerUnit::killTimer(const QString& name)
             if (!timer->isTemporary()) {
                 return false;
             }
+            // An already killed timer is only unlinked from this list once
+            // doCleanup() gets to free it, which cannot happen while a timer
+            // script is on the call stack - so until then it is still findable
+            // by name. Killing it a second time achieves nothing and must be
+            // reported as the failure it is:
+            if (mCleanupSet.contains(timer)) {
+                return false;
+            }
             timer->killTimer();
             markCleanup(timer);
             return true;
diff --git a/src/mudlet-lua/tests/Other_spec.lua b/src/mudlet-lua/tests/Other_spec.lua
index 9302e69c5..1e363a321 100644
--- a/src/mudlet-lua/tests/Other_spec.lua
+++ b/src/mudlet-lua/tests/Other_spec.lua
@@ -1050,11 +1050,44 @@ describe("Tests the timer API", function()
     end)
 
     it("returns -1 and a message when the code does not compile", function()
-      local id, message = tempTimer(0.1, "this is ( not lua")
+      -- the delay is distinctive, and the compiled chunk is named after the
+      -- timer's numeric id, so nothing but a leak can put it in the message
+      local id, message = tempTimer(0.125, "this is ( not lua")
       assert.equals(-1, id)
-      assert.is_string(message)
+      assert.is_string(message, "the failure should come with a message")
       assert.is_truthy(message:find("compile", 1, true),
         "the failure should say the code could not be compiled, got: " .. tostring(message))
+      -- and the reason has to be what Lua said about the code
+      assert.is_truthy(message:find("near", 1, true),
+        "the reason should be the Lua error, got: " .. tostring(message))
+      assert.is_falsy(message:find("0.125", 1, true),
+        "the delay must not be reported as the Lua error, got: " .. tostring(message))
+    end)
+
+    it("errors for a negative delay", function()
+      -- an unguarded negative delay wraps around the 24 hour clock into a timer
+      -- that fires almost a day later, so it has to be rejected outright
+      assert.has_error(function() tempTimer(-1, [[]]) end)
+      assert.has_error(function() tempTimer(-1, function() end) end)
+    end)
+
+    it("errors for a delay of a day or more, which wraps around to zero", function()
+      assert.has_error(function() tempTimer(86400, [[]]) end)
+    end)
+
+    it("errors for a delay that only rounds up onto the day", function()
+      -- the delay becomes the interval through qRound(time * 1000), so a delay
+      -- of under 86400 seconds can still reach 86400000ms and wrap around to no
+      -- interval at all: it is the rounded milliseconds that have to be bounded
+      local ok, err = pcall(tempTimer, 86399.9999, [[]])
+      assert.is_false(ok,
+        "a delay rounding up to a whole day wraps to a zero interval and must be rejected")
+      assert.is_truthy(tostring(err):find("bad argument #1", 1, true),
+        "the delay should be reported as the offending argument, got: " .. tostring(err))
+      -- while a delay still under the day once rounded stays acceptable
+      local id = trackTemp(tempTimer(86399.4, [[]]))
+      assert.is_true(id > 0, "a delay under the day once rounded should still be accepted")
+      assert.is_true(killTimer(id))
     end)
 
     it("fires a code-string body in the global environment", function()
@@ -1141,6 +1174,32 @@ describe("Tests the timer API", function()
         "a permanent timer survives killTimer")
     end)
 
+    it("returns false the second time, as the timer is already dead", function()
+      local id = trackTemp(tempTimer(10, [[]]))
+      assert.is_true(killTimer(id))
+      assert.is_false(killTimer(id),
+        "killing an already killed timer achieves nothing and has to say so")
+      -- the object itself is only freed by the timer unit's deferred cleanup,
+      -- so check the state a user can see straight away instead
+      assert.equals(0, isActive(id, "timer"), "a killed timer is no longer active")
+      local left, message = remainingTime(id)
+      assert.is_nil(left, "a killed timer is no longer counting down")
+      -- "inactive" rather than "not a valid timerID" pins that the timer is
+      -- still present and merely stopped, which is what the second kill saw
+      assert.is_truthy(tostring(message):find("inactive", 1, true),
+        "the killed timer should still be present but stopped, got: " .. tostring(message))
+    end)
+
+    it("returns false for a one-shot timer that has already fired", function()
+      -- a fired one-shot temporary timer is queued for the same deferred cleanup
+      -- a killed one is, so it is just as dead - which is what the manual has
+      -- always said killTimer reports
+      local id = trackTemp(tempTimer(0, function() raiseEvent("w2aOneShotFinished") end))
+      waitFor("w2aOneShotFinished")
+      assert.is_false(killTimer(id),
+        "a one-shot timer that has already fired cannot be killed again")
+    end)
+
     it("stops a pending timer from ever firing and deactivates it", function()
       local id = trackTemp(tempTimer(0.05, function()
         _G.W2aTimerSpec.fired = _G.W2aTimerSpec.fired + 1
@@ -1176,11 +1235,14 @@ describe("Tests the timer API", function()
       id = trackTemp(tempTimer(0.02, function()
         _G.W2aTimerSpec.fired = _G.W2aTimerSpec.fired + 1
         _G.W2aTimerSpec.killed = killTimer(id)
+        _G.W2aTimerSpec.killedAgain = killTimer(id)
         raiseEvent("w2aSelfKillingTimerFired")
       end, true))
       waitFor("w2aSelfKillingTimerFired")
       assert.is_true(_G.W2aTimerSpec.killed,
         "killTimer should report success from inside the timer's own callback")
+      assert.is_false(_G.W2aTimerSpec.killedAgain,
+        "killing the same timer twice from inside its own callback must fail the second time")
       local firedWhenKilled = _G.W2aTimerSpec.fired
       settle(0.15)
       assert.equals(firedWhenKilled, _G.W2aTimerSpec.fired,
@@ -1250,15 +1312,42 @@ describe("Tests the timer API", function()
     end)
 
     it("errors when the code does not compile", function()
-      assert.has_error(function()
-        permTimer(trackPerm("W2aPermTimerBadCode"), "", 1, "this is ( not lua")
-      end)
+      local ok, err = pcall(permTimer, trackPerm("W2aPermTimerBadCode"), "", 1, "this is ( not lua")
+      assert.is_false(ok, "code that does not parse must not create a timer")
+      assert.is_truthy(tostring(err):find("near", 1, true),
+        "the reason should be the Lua error, not the timer's name, got: " .. tostring(err))
     end)
 
     it("errors when the interval is missing", function()
       assert.has_error(function() permTimer("W2aPermTimerNoInterval", "") end)
     end)
 
+    it("errors for a negative interval, creating nothing", function()
+      -- counted rather than compared with zero: permanent timers survive into a
+      -- second run of the suite against the same profile
+      local before = exists("W2aPermTimerNegative", "timer")
+      local ok, err = pcall(permTimer, trackPerm("W2aPermTimerNegative"), "", -1, [[]])
+      assert.is_false(ok,
+        "a negative interval must be rejected rather than wrapped around the 24 hour clock")
+      assert.equals(before, exists("W2aPermTimerNegative", "timer"),
+        "a rejected interval must not leave a timer behind")
+      assert.is_truthy(tostring(err):find("bad argument #3", 1, true),
+        "the interval should be reported as the offending argument, got: " .. tostring(err))
+    end)
+
+    it("errors for an interval that only rounds up onto the day, creating nothing", function()
+      -- as with tempTimer, it is the rounded milliseconds that wrap: 86399.9999
+      -- seconds is under the day but reaches it once rounded
+      local before = exists("W2aPermTimerRounding", "timer")
+      local ok, err = pcall(permTimer, trackPerm("W2aPermTimerRounding"), "", 86399.9999, [[]])
+      assert.is_false(ok,
+        "an interval rounding up to a whole day wraps to a zero interval and must be rejected")
+      assert.equals(before, exists("W2aPermTimerRounding", "timer"),
+        "a rejected interval must not leave a timer behind")
+      assert.is_truthy(tostring(err):find("bad argument #3", 1, true),
+        "the interval should be reported as the offending argument, got: " .. tostring(err))
+    end)
+
     it("enableTimer and disableTimer error when called without a name", function()
       assert.has_error(function() enableTimer() end)
       assert.has_error(function() disableTimer() end)
@@ -1441,10 +1530,25 @@ describe("Tests the script API", function()
       -- a script's body runs as it is compiled, so a body that raises fails
       -- creation just like one that does not parse
       local before = exists("W2aScriptRaises", "script")
-      assert.has_error(function()
-        makeScript("W2aScriptRaises", "", [[error("w2a script boom")]])
-      end)
+      -- the failure quotes the code it was given, so the message is built at run
+      -- time: finding it whole proves the Lua error was reported, not the code
+      -- that was handed in and not the script's name
+      local ok, err = pcall(makeScript, "W2aScriptRaises", "", [[error("w2a script" .. " boom")]])
+      assert.is_false(ok, "a body that raises must not create a script")
       assert.equals(before, exists("W2aScriptRaises", "script"))
+      assert.is_truthy(tostring(err):find("w2a script boom", 1, true),
+        "permScript should report the Lua error, got: " .. tostring(err))
+    end)
+
+    it("reports the type when the body raises something other than a string", function()
+      -- the error object is not a string, so there is no message to quote - the
+      -- reason still has to say what came back rather than name the script
+      local before = exists("W2aScriptObjectError", "script")
+      local ok, err = pcall(makeScript, "W2aScriptObjectError", "", [[error({w2a = true})]])
+      assert.is_false(ok, "a body that raises must not create a script")
+      assert.equals(before, exists("W2aScriptObjectError", "script"))
+      assert.is_truthy(tostring(err):find("error object is a table", 1, true),
+        "the reason should describe the error object, got: " .. tostring(err))
     end)
 
     it("creates a script whose body runs immediately", function()
@@ -1573,10 +1677,13 @@ describe("Tests the script API", function()
       -- compiled into the script, so this is the path that has to roll back
       local body = [[local w2aRolledBack = 1]]
       local _, position = makeScript("W2aScriptRollback", "", body)
-      assert.has_error(function()
-        setScript("W2aScriptRollback", [[error("w2a setScript boom")]], position)
-      end)
+      -- as in the permScript spec above, the raised message is assembled at run
+      -- time so that only the real Lua error can contain it
+      local ok, err = pcall(setScript, "W2aScriptRollback", [[error("w2a setScript" .. " boom")]], position)
+      assert.is_false(ok, "a body that raises must not be kept")
       assert.equals(body, (getScript("W2aScriptRollback", position)))
+      assert.is_truthy(tostring(err):find("w2a setScript boom", 1, true),
+        "setScript should report the Lua error, got: " .. tostring(err))
     end)
 
     it("sets the script at the requested position when several share a name", function()

From aad3948391ce78674b42c27f9d4f24af05fe8eb7 Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Mon, 3 Aug 2026 11:39:32 +0200
Subject: [PATCH 060/155] infrastructure: stop suppressing QString leaks in
 LSan enforcement (#9602)

#### Brief overview of PR changes/additions
- `leak:QArrayData::allocate2` in `asan-suppressions.txt` was labelled
"Qt array data allocation (internal caching)", but `allocate2` is Qt 6's
allocator for every 2-byte-element array, i.e. the buffer behind every
`QString` - so it hid every leaked QString in Mudlet. It has been there
since the suppression file was first written in #8316.
- Removing it surfaced 4462 bytes in 101 allocations per busted run, all
of them Mudlet's own and all one bug class: an argument QString stranded
when a *later* argument's validation called `lua_error()`, which
longjmps past C++ destructors. Nothing third-party was behind that line,
so nothing replaces it.
- All of them are fixed (perm\*/temp\* trigger, alias, timer, key and
script; the HTTP family; the media family; `setConfig`,
`setTriggerStayOpen`, `createLabel`, `calcFontSize`) with new
non-raising `checkStringArg`/`checkIntArg`/`checkBoolArg` validators
that `getVerifiedString`/`Int`/`Bool` are now built on, so error text
and the order errors are reported in cannot drift. A leak found on the
way out: the media table parsers stringified the `lua_next` key in
place, so `playSoundFile{"a.wav"}` failed with `invalid key to 'next'`
and leaked a `TMediaData`.

#### Motivation for adding to Mudlet
An LSan suppression matches if **any** frame in the stack matches, so
naming a Qt allocation primitive blanks out every leak that flows
through it - here that was the exact recurring bug class #9556 and #9599
fix by hand, making half of the leak enforcement added in #9481 inert.
The file now also records why the leak job's stacks stop at
`QArrayData::allocate2` (the Qt binaries CI installs have no frame
pointers) and the `fast_unwind_on_malloc=0` recipe for getting the real
caller. The sweep is by example rather than exhaustive: other functions
still hold a QString across a raise, and with the suppression gone the
first test to reach one will now fail CI.

**Test case:** with a QString deliberately leaked across a `lua_error()`
in `permAlias`, the busted suite exits 1 with `Direct leak of 60 byte(s)
in 1 object(s)`; restoring only the old suppression line makes the same
build exit 0 and report nothing. Without the injection: 2x `1309
successes / 0 failures / 0 errors / 0 pending` with no LeakSanitizer
output, ctest 60/60.

Assisted-by: Claude:claude-opus-5
---
 asan-suppressions.txt                |   17 +-
 src/TLuaInterpreter.cpp              |   97 +-
 src/TLuaInterpreter.h                |    5 +-
 src/TLuaInterpreterMedia.cpp         | 2795 ++++++++++++++++----------
 src/TLuaInterpreterMudletObjects.cpp |  599 +++---
 src/TLuaInterpreterNetworking.cpp    |   86 +-
 src/TLuaInterpreterUI.cpp            |   59 +-
 7 files changed, 2299 insertions(+), 1359 deletions(-)

diff --git a/asan-suppressions.txt b/asan-suppressions.txt
index f24d21cf3..bce68409b 100644
--- a/asan-suppressions.txt
+++ b/asan-suppressions.txt
@@ -22,6 +22,20 @@
 # compare against. Those have to be handled at their source, not here - see the
 # GPU driver note below for the recurring example.
 #
+# Do not suppress a Qt allocation primitive to quieten a report. By default
+# AddressSanitizer captures allocation stacks with the frame-pointer unwinder,
+# and the Qt binaries CI installs are built without frame pointers, so the walk
+# stops at the first Qt frame. Every leaked QString in the program then reports
+# as the same three-frame stack
+#   malloc / allocateHelper / QArrayData::allocate2
+# with no caller to identify it, and every leaked QByteArray as the allocate1
+# equivalent. Suppressing those symbols hides the whole class - which is what
+# `leak:QArrayData::allocate2` did here until it was removed. To get the real
+# callers of such a report, re-run with the accurate unwinder:
+#   ASAN_OPTIONS=fast_unwind_on_malloc=0:malloc_context_size=30
+# It costs roughly 3x the runtime of the test run, which is why CI does not use
+# it by default, but the stacks it produces name the leaking function.
+#
 # See: https://github.com/google/sanitizers/wiki/AddressSanitizerLeakSanitizer
 
 # ==============================================================================
@@ -127,9 +141,6 @@ leak:QFontEngineMultiFontConfig
 # Qt translation system (one-time initialization)
 leak:QTranslatorPrivate::do_load
 
-# Qt array data allocation (internal caching)
-leak:QArrayData::allocate2
-
 # ==============================================================================
 # OpenSSL 3 provider initialization leaks
 # One-time allocations made when Qt's OpenSSL TLS backend loads the default
diff --git a/src/TLuaInterpreter.cpp b/src/TLuaInterpreter.cpp
index bd516abb0..6fa6f83bc 100644
--- a/src/TLuaInterpreter.cpp
+++ b/src/TLuaInterpreter.cpp
@@ -185,14 +185,24 @@ TLuaInterpreter::~TLuaInterpreter()
 // See also: getVerifiedString, getVerifiedInt, getVerifiedFloat, errorArgumentType
 bool TLuaInterpreter::getVerifiedBool(lua_State* L, const char* functionName, const int pos, const char* publicName, const bool isOptional)
 {
-    if (!lua_isboolean(L, pos)) {
-        errorArgumentType(L, functionName, pos, publicName, "boolean", isOptional);
+    if (!checkBoolArg(L, functionName, pos, publicName, isOptional)) {
         lua_error(L);
         Q_UNREACHABLE();
     }
     return lua_toboolean(L, pos);
 }
 
+// No documentation available in wiki - internal function
+// The non-raising counterpart of getVerifiedBool - see checkStringArg()
+bool TLuaInterpreter::checkBoolArg(lua_State* L, const char* functionName, const int pos, const char* publicName, const bool isOptional)
+{
+    if (!lua_isboolean(L, pos)) {
+        errorArgumentType(L, functionName, pos, publicName, "boolean", isOptional);
+        return false;
+    }
+    return true;
+}
+
 // No documentation available in wiki - internal function
 // See also: getVerifiedBool
 /*static*/ std::pair TLuaInterpreter::getVerifiedStringOrInteger(lua_State* L, const char* functionName, const int pos, const char* publicName, const bool isOptional)
@@ -214,11 +224,27 @@ bool TLuaInterpreter::getVerifiedBool(lua_State* L, const char* functionName, co
 }
 
 // No documentation available in wiki - internal function
-// See also: getVerifiedBool
-QString TLuaInterpreter::getVerifiedString(lua_State* L, const char* functionName, const int pos, const char* publicName, const bool isOptional)
+// Leaves the "bad argument" message on the Lua stack instead of raising, so the
+// caller can raise it with `return lua_error(L)` at a point of its choosing.
+// lua_error() longjmps past C++ destructors: any QString already built from an
+// earlier argument would have its buffer stranded, so callers taking more than
+// one string check every argument here first - in argument order, so the same
+// failure is still the one reported - and only then build the QStrings.
+// See also: getVerifiedString, reportInvalidLuaCodeParam
+bool TLuaInterpreter::checkStringArg(lua_State* L, const char* functionName, const int pos, const char* publicName, const bool isOptional)
 {
     if (!lua_isstring(L, pos)) {
         errorArgumentType(L, functionName, pos, publicName, "string", isOptional);
+        return false;
+    }
+    return true;
+}
+
+// No documentation available in wiki - internal function
+// See also: getVerifiedBool
+QString TLuaInterpreter::getVerifiedString(lua_State* L, const char* functionName, const int pos, const char* publicName, const bool isOptional)
+{
+    if (!checkStringArg(L, functionName, pos, publicName, isOptional)) {
         lua_error(L);
         Q_UNREACHABLE();
     }
@@ -226,13 +252,12 @@ QString TLuaInterpreter::getVerifiedString(lua_State* L, const char* functionNam
 }
 
 // No documentation available in wiki - internal function
-// See also: getVerifiedBool
-int TLuaInterpreter::getVerifiedInt(lua_State* L, const char* functionName, const int pos, const char* publicName, const bool isOptional)
+// The non-raising counterpart of getVerifiedInt - see checkStringArg()
+bool TLuaInterpreter::checkIntArg(lua_State* L, const char* functionName, const int pos, const char* publicName, const bool isOptional)
 {
     if (!lua_isnumber(L, pos)) {
         errorArgumentType(L, functionName, pos, publicName, "number", isOptional);
-        lua_error(L);
-        Q_UNREACHABLE();
+        return false;
     }
     // lua_tointeger(...) returns a ptrdiff_t which on 64-bit platforms is a
     // signed 64 bit value, which is usually larger than an "int" a.k.a. an
@@ -250,10 +275,20 @@ int TLuaInterpreter::getVerifiedInt(lua_State* L, const char* functionName, cons
                         lua_tostring(L, pos),
                         std::numeric_limits::min(),
                         std::numeric_limits::max());
+        return false;
+    }
+    return true;
+}
+
+// No documentation available in wiki - internal function
+// See also: getVerifiedBool
+int TLuaInterpreter::getVerifiedInt(lua_State* L, const char* functionName, const int pos, const char* publicName, const bool isOptional)
+{
+    if (!checkIntArg(L, functionName, pos, publicName, isOptional)) {
         lua_error(L);
         Q_UNREACHABLE();
     }
-    return static_cast(result);
+    return static_cast(lua_tointeger(L, pos));
 }
 
 // No documentation available in wiki - internal function
@@ -4834,38 +4869,38 @@ double TLuaInterpreter::condenseMapLoad()
 }
 
 // No documentation available in wiki - internal function
-int TLuaInterpreter::performHttpRequest(lua_State* L, const char* functionName, const int pos, QNetworkAccessManager::Operation operation, const QString& verb)
+// `verb` is a const char* so that customHTTP() need not own a heap buffer
+// across the checks below - see checkStringArg()
+int TLuaInterpreter::performHttpRequest(lua_State* L, const char* functionName, const int pos, QNetworkAccessManager::Operation operation, const char* verb)
 {
     auto& host = getHostFromLua(L);
 
-    QString dataToPost;
     if (!lua_isstring(L, pos + 1) && !lua_isstring(L, pos + 4)) {
         lua_pushfstring(L, "%s: bad argument #%d type (data to send as string expected, got %s!)", functionName, pos + 1, luaL_typename(L, pos + 1));
         return lua_error(L);
     }
-    if (lua_isstring(L, pos + 1)) {
-        dataToPost = lua_tostring(L, pos + 1);
+    if (!checkStringArg(L, functionName, pos + 2, "remote url")) {
+        return lua_error(L);
     }
-
-    const QString urlString = getVerifiedString(L, functionName, pos + 2, "remote url");
-
-    // Validate the optional headers and file arguments before creating the QUrl
-    // / QNetworkRequest below: lua_error() longjmps past C++ destructors, so
-    // nothing heap-owning may be alive when a validation failure fires.
     validateHttpHeaders(L, pos + 3, functionName);
-
-    QString fileLocation;
     if (!lua_isstring(L, pos + 4) && !lua_isnoneornil(L, pos + 4)) {
         lua_pushfstring(L, "%s: bad argument #%d type (file to send as string location expected, got %s!)", functionName, pos + 4, luaL_typename(L, pos + 4));
         return lua_error(L);
     }
+
+    QString dataToPost;
+    if (lua_isstring(L, pos + 1)) {
+        dataToPost = lua_tostring(L, pos + 1);
+    }
+    const QString urlString{lua_tostring(L, pos + 2)};
+    QString fileLocation;
     if (lua_isstring(L, pos + 4)) {
         fileLocation = lua_tostring(L, pos + 4);
     }
 
     const QUrl url = QUrl::fromUserInput(urlString);
     if (!url.isValid()) {
-        return warnArgumentValue(L, __func__, qsl("url is invalid, reason: %1.").arg(url.errorString()));
+        return warnArgumentValue(L, functionName, qsl("url is invalid, reason: %1.").arg(url.errorString()));
     }
 
     QNetworkRequest request = QNetworkRequest(url);
@@ -4894,7 +4929,7 @@ int TLuaInterpreter::performHttpRequest(lua_State* L, const char* functionName,
         reply = host.mLuaInterpreter.mpFileDownloader->put(request, fileToUpload.isEmpty() ? dataToPost.toUtf8() : fileToUpload);
         break;
     default:
-        reply = host.mLuaInterpreter.mpFileDownloader->sendCustomRequest(request, verb.toUtf8(), fileToUpload.isEmpty() ? dataToPost.toUtf8() : fileToUpload);
+        reply = host.mLuaInterpreter.mpFileDownloader->sendCustomRequest(request, QByteArray{verb}, fileToUpload.isEmpty() ? dataToPost.toUtf8() : fileToUpload);
     };
 
     if (mudlet::smDebugMode) {
@@ -7524,14 +7559,21 @@ int TLuaInterpreter::setConfig(lua_State* L)
 {
     auto& host = getHostFromLua(L);
     const bool currentHost = (mudlet::self()->mpCurrentActiveHost == &host);
-    QString key = getVerifiedString(L, __func__, 1, "key");
+    if (!checkStringArg(L, __func__, 1, "key")) {
+        return lua_error(L);
+    }
+    // a view rather than a QString because the getVerified*() calls below raise -
+    // see checkStringArg(). Every comparison is against an ASCII literal, so
+    // reading the key as Latin-1 picks the branch a UTF-8 QString would; the two
+    // places that show the key decode it as UTF-8 there and then
+    const QLatin1StringView key{lua_tostring(L, 1)};
     if (key.isEmpty()) {
         return warnArgumentValue(L, __func__, "you must provide key");
     }
 
     auto success = [&]() {
         if (mudlet::smDebugMode) {
-            TDebug(Qt::white, Qt::blue) << qsl("setConfig: a script has changed %1\n").arg(key) >> &host;
+            TDebug(Qt::white, Qt::blue) << qsl("setConfig: a script has changed %1\n").arg(QString::fromUtf8(lua_tostring(L, 1))) >> &host;
         }
         lua_pushboolean(L, true);
         return 1;
@@ -7922,7 +7964,8 @@ int TLuaInterpreter::setConfig(lua_State* L)
 
     // Handle experiment keys
     if (key.startsWith(qsl("experiment."))) {
-        auto [result, errorMessage] = host.setExperimentEnabled(key, getVerifiedBool(L, __func__, 2, "value"));
+        const bool enabled = getVerifiedBool(L, __func__, 2, "value");
+        auto [result, errorMessage] = host.setExperimentEnabled(QString::fromUtf8(lua_tostring(L, 1)), enabled);
         if (!result) {
             return warnArgumentValue(L, __func__, errorMessage);
         }
@@ -7981,7 +8024,7 @@ int TLuaInterpreter::setConfig(lua_State* L)
         }
         return warnArgumentValue(L, __func__, result.second);
     }
-    return warnArgumentValue(L, __func__, qsl("'%1' isn't a valid configuration option").arg(key));
+    return warnArgumentValue(L, __func__, qsl("'%1' isn't a valid configuration option").arg(QString::fromUtf8(lua_tostring(L, 1))));
 }
 
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#announce
diff --git a/src/TLuaInterpreter.h b/src/TLuaInterpreter.h
index 1f8e64eae..2e8c284c9 100644
--- a/src/TLuaInterpreter.h
+++ b/src/TLuaInterpreter.h
@@ -823,6 +823,9 @@ public slots:
 private:
     static bool getVerifiedBool(lua_State*, const char* functionName, const int pos, const char* publicName, const bool isOptional = false);
     static QString getVerifiedString(lua_State*, const char* functionName, const int pos, const char* publicName, const bool isOptional = false);
+    static bool checkStringArg(lua_State*, const char* functionName, const int pos, const char* publicName, const bool isOptional = false);
+    static bool checkIntArg(lua_State*, const char* functionName, const int pos, const char* publicName, const bool isOptional = false);
+    static bool checkBoolArg(lua_State*, const char* functionName, const int pos, const char* publicName, const bool isOptional = false);
     static int getVerifiedInt(lua_State*, const char* functionName, const int pos, const char* publicName, const bool isOptional = false);
     static float getVerifiedFloat(lua_State*, const char* functionName, const int pos, const char* publicName, const bool isOptional = false);
     static double getVerifiedDouble(lua_State*, const char* functionName, const int pos, const char* publicName, const bool isOptional = false);
@@ -834,7 +837,7 @@ private:
     static int movieFunc(lua_State*, const QString& funcName);
     static std::pair discordApiEnabled(lua_State*, bool writeAccess = false);
     static void setRequestDefaults(const QUrl& url, QNetworkRequest& request);
-    static int performHttpRequest(lua_State*, const char* functionName, const int pos, QNetworkAccessManager::Operation operation, const QString& verb);
+    static int performHttpRequest(lua_State*, const char* functionName, const int pos, QNetworkAccessManager::Operation operation, const char* verb);
     static void validateHttpHeaders(lua_State*, const int index, const char* functionName);
     static void applyHttpHeaders(lua_State*, const int index, QNetworkRequest& request);
     // The last argument is only needed if the third one is true:
diff --git a/src/TLuaInterpreterMedia.cpp b/src/TLuaInterpreterMedia.cpp
index 9ddbe585b..7b1da0e09 100644
--- a/src/TLuaInterpreterMedia.cpp
+++ b/src/TLuaInterpreterMedia.cpp
@@ -34,11 +34,14 @@
 #include "TMedia.h"
 #include "mudlet.h"
 
+// The argument parsers below hold QStrings and TMediaData while they run, so
+// they type-check with TLuaInterpreter::check...Arg() and leave the raise until
+// the parsing scope has been left - see checkStringArg()
+
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#receiveMSP
 int TLuaInterpreter::receiveMSP(lua_State* L)
 {
     Host& host = getHostFromLua(L);
-    std::string msg;
 
     if (!host.mTelnet.isMSPEnabled()) {
         return warnArgumentValue(L, __func__, "MSP is not currently enabled");
@@ -49,7 +52,7 @@ int TLuaInterpreter::receiveMSP(lua_State* L)
         return lua_error(L);
     }
 
-    msg = host.mTelnet.encodeAndCookBytes(lua_tostring(L, 1));
+    const std::string msg = host.mTelnet.encodeAndCookBytes(lua_tostring(L, 1));
     host.mTelnet.setMSPVariables(QByteArray(msg.c_str(), msg.length()));
 
     lua_pushboolean(L, true);
@@ -60,43 +63,63 @@ int TLuaInterpreter::receiveMSP(lua_State* L)
 int TLuaInterpreter::loadMediaFileAsOrderedArguments(lua_State* L, const char* func)
 {
     const Host& host = getHostFromLua(L);
-    TMediaData mediaData{};
     const int numArgs = lua_gettop(L);
-    QString stringValue;
 
-    // name[,url])
-    for (int i = 1; i <= numArgs; i++) {
-        if (lua_isnil(L, i)) {
-            continue;
-        }
+    bool errorPushed = false;
+    {
+        TMediaData mediaData{};
+        QString stringValue;
 
-        switch (i) {
-        case 1:
-            stringValue = getVerifiedString(L, func, i, "name");
-
-            if (QDir::homePath().contains('\\')) {
-                stringValue.replace('/', R"(\)");
-            } else {
-                stringValue.replace('\\', "/");
+        // name[,url])
+        for (int i = 1; i <= numArgs && !errorPushed; i++) {
+            if (lua_isnil(L, i)) {
+                continue;
             }
 
-            mediaData.setMediaFileName(stringValue);
-            break;
-        case 2:
-            stringValue = getVerifiedString(L, func, i, "url");
-            mediaData.setMediaUrl(stringValue);
-            break;
+            switch (i) {
+            case 1:
+                if (!checkStringArg(L, func, i, "name")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                stringValue = lua_tostring(L, i);
+
+                if (QDir::homePath().contains('\\')) {
+                    stringValue.replace('/', R"(\)");
+                } else {
+                    stringValue.replace('\\', "/");
+                }
+
+                mediaData.setMediaFileName(stringValue);
+                break;
+            case 2:
+                if (!checkStringArg(L, func, i, "url")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaUrl(QString{lua_tostring(L, i)});
+                break;
+            }
+        }
+
+        if (!errorPushed) {
+            if (mediaData.mediaFileName().isEmpty()) {
+                return warnArgumentValue(L, func, QLatin1String("missing argument 1 (file to play)"));
+            }
+
+            mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
+            mediaData.setMediaVolume(TMediaData::MediaVolumePreload);
+
+            host.mpMedia->playMedia(mediaData);
         }
     }
 
-    if (mediaData.mediaFileName().isEmpty()) {
-        return warnArgumentValue(L, func, QLatin1String("missing argument 1 (file to play)"));
+    if (errorPushed) {
+        return lua_error(L);
     }
 
-    mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
-    mediaData.setMediaVolume(TMediaData::MediaVolumePreload);
-
-    host.mpMedia->playMedia(mediaData);
     lua_pushboolean(L, true);
     return 1;
 }
@@ -105,43 +128,67 @@ int TLuaInterpreter::loadMediaFileAsOrderedArguments(lua_State* L, const char* f
 int TLuaInterpreter::loadMediaFileAsTableArgument(lua_State* L, const char* func)
 {
     const Host& host = getHostFromLua(L);
-    TMediaData mediaData{};
 
-    lua_pushnil(L);
-    while (lua_next(L, 1) != 0) {
-        // key at index -2 and value at index -1
-        QString key = getVerifiedString(L, func, -2, "table keys");
-        key = key.toLower();
+    bool errorPushed = false;
+    {
+        TMediaData mediaData{};
 
-        if (key == QLatin1String("name") || key == QLatin1String("url")) {
-            QString value = getVerifiedString(L, func, -1, key == QLatin1String("name") ? "value for name" : "value for url");
+        lua_pushnil(L);
+        while (lua_next(L, 1) != 0) {
+            // key at index -2 and value at index -1
+            if (!checkStringArg(L, func, -2, "table keys")) {
+                errorPushed = true;
+                break;
+            }
 
-            if (key == QLatin1String("name") && !value.isEmpty()) {
-                if (QDir::homePath().contains('\\')) {
-                    value.replace('/', R"(\)");
-                } else {
-                    value.replace('\\', "/");
+            // read the key from a copy: lua_tostring() on the slot itself converts a
+            // numeric key in place, which makes the next lua_next() fail
+            lua_pushvalue(L, -2);
+            const QString key = QString{lua_tostring(L, -1)}.toLower();
+            lua_pop(L, 1);
+
+            if (key == QLatin1String("name") || key == QLatin1String("url")) {
+                if (!checkStringArg(L, func, -1, key == QLatin1String("name") ? "value for name" : "value for url")) {
+                    errorPushed = true;
+                    break;
                 }
 
-                mediaData.setMediaFileName(value);
-            } else if (key == QLatin1String("url") && !value.isEmpty()) {
-                mediaData.setMediaUrl(value);
+                QString value{lua_tostring(L, -1)};
+
+                if (key == QLatin1String("name") && !value.isEmpty()) {
+                    if (QDir::homePath().contains('\\')) {
+                        value.replace('/', R"(\)");
+                    } else {
+                        value.replace('\\', "/");
+                    }
+
+                    mediaData.setMediaFileName(value);
+                } else if (key == QLatin1String("url") && !value.isEmpty()) {
+                    mediaData.setMediaUrl(value);
+                }
             }
+
+            // removes value, but keeps key for next iteration
+            lua_pop(L, 1);
         }
 
-        // removes value, but keeps key for next iteration
-        lua_pop(L, 1);
+        if (!errorPushed) {
+            if (mediaData.mediaFileName().isEmpty()) {
+                lua_pushstring(L, R"(loadMusicFile: missing name (add name = "file to play"))");
+                errorPushed = true;
+            } else {
+                mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
+                mediaData.setMediaVolume(TMediaData::MediaVolumePreload);
+
+                host.mpMedia->playMedia(mediaData);
+            }
+        }
     }
 
-    if (mediaData.mediaFileName().isEmpty()) {
-        lua_pushstring(L, R"(loadMusicFile: missing name (add name = "file to play"))");
+    if (errorPushed) {
         return lua_error(L);
     }
 
-    mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
-    mediaData.setMediaVolume(TMediaData::MediaVolumePreload);
-
-    host.mpMedia->playMedia(mediaData);
     lua_pushboolean(L, true);
     return 1;
 }
@@ -196,119 +243,184 @@ int TLuaInterpreter::loadVideoFile(lua_State* L)
 int TLuaInterpreter::playMusicFileAsOrderedArguments(lua_State* L, const char* func)
 {
     const Host& host = getHostFromLua(L);
-    TMediaData mediaData{};
     const int numArgs = lua_gettop(L);
-    QString stringValue;
-    int intValue = 0;
-    bool boolValue = 0;
 
-    // name[,volume][,fadein][,fadeout][,start][,loops][,key][,tag][,continue][,url][,finish]
-    for (int i = 1; i <= numArgs; i++) {
-        if (lua_isnil(L, i)) {
-            continue;
+    bool errorPushed = false;
+    {
+        TMediaData mediaData{};
+        QString stringValue;
+        int intValue = 0;
+
+        // name[,volume][,fadein][,fadeout][,start][,loops][,key][,tag][,continue][,url][,finish]
+        for (int i = 1; i <= numArgs && !errorPushed; i++) {
+            if (lua_isnil(L, i)) {
+                continue;
+            }
+
+            switch (i) {
+            case 1:
+                if (!checkStringArg(L, func, i, "name")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                stringValue = lua_tostring(L, i);
+
+                if (QDir::homePath().contains('\\')) {
+                    stringValue.replace('/', R"(\)");
+                } else {
+                    stringValue.replace('\\', "/");
+                }
+
+                mediaData.setMediaFileName(stringValue);
+                break;
+            case 2:
+                if (!checkIntArg(L, func, i, "volume")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                intValue = static_cast(lua_tointeger(L, i));
+
+                if (intValue == TMediaData::MediaVolumePreload) {
+                    {
+                    } // Volume of 0 supports preloading
+                } else if (intValue > TMediaData::MediaVolumeMax) {
+                    intValue = TMediaData::MediaVolumeMax;
+                } else if (intValue < TMediaData::MediaVolumeMin) {
+                    intValue = TMediaData::MediaVolumeMin;
+                }
+
+                mediaData.setMediaVolume(intValue);
+                break;
+            case 3:
+                if (!checkIntArg(L, func, i, "fadein")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                intValue = static_cast(lua_tointeger(L, i));
+
+                if (intValue < 0) {
+                    lua_pushfstring(L, "playSoundFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "fadein", intValue);
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaFadeIn(intValue);
+                break;
+            case 4:
+                if (!checkIntArg(L, func, i, "fadeout")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                intValue = static_cast(lua_tointeger(L, i));
+
+                if (intValue < 0) {
+                    lua_pushfstring(L, "playSoundFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "fadeout", intValue);
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaFadeOut(intValue);
+                break;
+            case 5:
+                if (!checkIntArg(L, func, i, "start")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                intValue = static_cast(lua_tointeger(L, i));
+
+                if (intValue < 0) {
+                    lua_pushfstring(L, "playSoundFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "start", intValue);
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaStart(intValue);
+                break;
+            case 6:
+                if (!checkIntArg(L, func, i, "loops")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                intValue = static_cast(lua_tointeger(L, i));
+
+                if (intValue < TMediaData::MediaLoopsRepeat || intValue == 0) {
+                    intValue = TMediaData::MediaLoopsDefault;
+                }
+
+                mediaData.setMediaLoops(intValue);
+                break;
+            case 7:
+                if (!checkStringArg(L, func, i, "key")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaKey(QString{lua_tostring(L, i)});
+                break;
+            case 8:
+                if (!checkStringArg(L, func, i, "tag")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaTag(QString{lua_tostring(L, i)});
+                break;
+            case 9:
+                if (!checkBoolArg(L, func, i, "continue")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaContinue(lua_toboolean(L, i));
+                break;
+            case 10:
+                if (!checkStringArg(L, func, i, "url")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaUrl(QString{lua_tostring(L, i)});
+                break;
+            case 11:
+                if (!checkIntArg(L, func, i, "finish")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                intValue = static_cast(lua_tointeger(L, i));
+
+                if (intValue < 0) {
+                    lua_pushfstring(L, "playSoundFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "finish", intValue);
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaFinish(intValue);
+                break;
+            }
         }
 
-        switch (i) {
-        case 1:
-            stringValue = getVerifiedString(L, func, i, "name");
-
-            if (QDir::homePath().contains('\\')) {
-                stringValue.replace('/', R"(\)");
-            } else {
-                stringValue.replace('\\', "/");
+        if (!errorPushed) {
+            if (mediaData.mediaFileName().isEmpty()) {
+                return warnArgumentValue(L, func, QLatin1String("missing argument 1 (file to play)"));
             }
 
-            mediaData.setMediaFileName(stringValue);
-            break;
-        case 2:
-            intValue = getVerifiedInt(L, func, i, "volume");
-
-            if (intValue == TMediaData::MediaVolumePreload) {
-                {
-                } // Volume of 0 supports preloading
-            } else if (intValue > TMediaData::MediaVolumeMax) {
-                intValue = TMediaData::MediaVolumeMax;
-            } else if (intValue < TMediaData::MediaVolumeMin) {
-                intValue = TMediaData::MediaVolumeMin;
-            }
-
-            mediaData.setMediaVolume(intValue);
-            break;
-        case 3:
-            intValue = getVerifiedInt(L, func, i, "fadein");
-
-            if (intValue < 0) {
-                lua_pushfstring(L, "playSoundFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "fadein", intValue);
-                return lua_error(L);
-            }
-
-            mediaData.setMediaFadeIn(intValue);
-            break;
-        case 4:
-            intValue = getVerifiedInt(L, func, i, "fadeout");
-
-            if (intValue < 0) {
-                lua_pushfstring(L, "playSoundFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "fadeout", intValue);
-                return lua_error(L);
-            }
-
-            mediaData.setMediaFadeOut(intValue);
-            break;
-        case 5:
-            intValue = getVerifiedInt(L, func, i, "start");
-
-            if (intValue < 0) {
-                lua_pushfstring(L, "playSoundFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "start", intValue);
-                return lua_error(L);
-            }
-
-            mediaData.setMediaStart(intValue);
-            break;
-        case 6:
-            intValue = getVerifiedInt(L, func, i, "loops");
-
-            if (intValue < TMediaData::MediaLoopsRepeat || intValue == 0) {
-                intValue = TMediaData::MediaLoopsDefault;
-            }
-
-            mediaData.setMediaLoops(intValue);
-            break;
-        case 7:
-            stringValue = getVerifiedString(L, func, i, "key");
-            mediaData.setMediaKey(stringValue);
-            break;
-        case 8:
-            stringValue = getVerifiedString(L, func, i, "tag");
-            mediaData.setMediaTag(stringValue);
-            break;
-        case 9:
-            boolValue = getVerifiedBool(L, func, i, "continue");
-            mediaData.setMediaContinue(boolValue);
-            break;
-        case 10:
-            stringValue = getVerifiedString(L, func, i, "url");
-            mediaData.setMediaUrl(stringValue);
-            break;
-        case 11:
-            intValue = getVerifiedInt(L, func, i, "finish");
-
-            if (intValue < 0) {
-                lua_pushfstring(L, "playSoundFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "finish", intValue);
-                return lua_error(L);
-            }
-
-            mediaData.setMediaFinish(intValue);
-            break;
+            mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
+            mediaData.setMediaType(TMediaData::MediaTypeMusic);
+            host.mpMedia->playMedia(mediaData);
         }
     }
 
-    if (mediaData.mediaFileName().isEmpty()) {
-        return warnArgumentValue(L, func, QLatin1String("missing argument 1 (file to play)"));
+    if (errorPushed) {
+        return lua_error(L);
     }
 
-    mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
-    mediaData.setMediaType(TMediaData::MediaTypeMusic);
-    host.mpMedia->playMedia(mediaData);
     lua_pushboolean(L, true);
     return 1;
 }
@@ -317,116 +429,153 @@ int TLuaInterpreter::playMusicFileAsOrderedArguments(lua_State* L, const char* f
 int TLuaInterpreter::playMusicFileAsTableArgument(lua_State* L, const char* func)
 {
     const Host& host = getHostFromLua(L);
-    TMediaData mediaData{};
 
-    lua_pushnil(L);
-    while (lua_next(L, 1) != 0) {
-        // key at index -2 and value at index -1
-        QString key = getVerifiedString(L, func, -2, "table keys");
-        key = key.toLower();
+    bool errorPushed = false;
+    {
+        TMediaData mediaData{};
 
-        if (key == QLatin1String("name") || key == QLatin1String("url") || key == QLatin1String("key") || key == QLatin1String("tag") || key == QLatin1String("caption")) {
-            QString value = getVerifiedString(L,
-                                              func,
-                                              -1,
-                                              key == QLatin1String("name")      ? "value for name"
-                                              : key == QLatin1String("key")     ? "value for key"
-                                              : key == QLatin1String("tag")     ? "value for tag"
-                                              : key == QLatin1String("caption") ? "value for caption"
-                                                                                : "value for url");
-
-            if (key == QLatin1String("name") && !value.isEmpty()) {
-                if (QDir::homePath().contains('\\')) {
-                    value.replace('/', R"(\)");
-                } else {
-                    value.replace('\\', "/");
-                }
-
-                mediaData.setMediaFileName(value);
-            } else if (key == QLatin1String("url") && !value.isEmpty()) {
-                mediaData.setMediaUrl(value);
-            } else if (key == QLatin1String("key") && !value.isEmpty()) {
-                mediaData.setMediaKey(value);
-            } else if (key == QLatin1String("tag") && !value.isEmpty()) {
-                mediaData.setMediaTag(value);
-            } else if (key == QLatin1String("caption") && !value.isEmpty()) {
-                mediaData.setMediaCaption(value);
+        lua_pushnil(L);
+        while (lua_next(L, 1) != 0) {
+            // key at index -2 and value at index -1
+            if (!checkStringArg(L, func, -2, "table keys")) {
+                errorPushed = true;
+                break;
             }
-        } else if (key == QLatin1String("volume") || key == QLatin1String("fadein") || key == QLatin1String("fadeout") || key == QLatin1String("start") || key == QLatin1String("finish")
-                   || key == QLatin1String("loops")) {
-            int value = getVerifiedInt(L,
-                                       func,
-                                       -1,
-                                       key == QLatin1String("volume")    ? "value for volume"
-                                       : key == QLatin1String("fadein")  ? "value for fadein"
-                                       : key == QLatin1String("fadeout") ? "value for fadeout"
-                                       : key == QLatin1String("start")   ? "value for start"
-                                       : key == QLatin1String("finish")  ? "value for finish"
-                                                                         : "value for loops");
 
-            if (key == QLatin1String("volume")) {
-                if (value == TMediaData::MediaVolumePreload) {
-                    {
-                    } // Volume of 0 supports preloading
-                } else if (value > TMediaData::MediaVolumeMax) {
-                    value = TMediaData::MediaVolumeMax;
-                } else if (value < TMediaData::MediaVolumeMin) {
-                    value = TMediaData::MediaVolumeMin;
+            // read the key from a copy: lua_tostring() on the slot itself converts a
+            // numeric key in place, which makes the next lua_next() fail
+            lua_pushvalue(L, -2);
+            const QString key = QString{lua_tostring(L, -1)}.toLower();
+            lua_pop(L, 1);
+
+            if (key == QLatin1String("name") || key == QLatin1String("url") || key == QLatin1String("key") || key == QLatin1String("tag") || key == QLatin1String("caption")) {
+                if (!checkStringArg(L,
+                                    func,
+                                    -1,
+                                    key == QLatin1String("name")      ? "value for name"
+                                    : key == QLatin1String("key")     ? "value for key"
+                                    : key == QLatin1String("tag")     ? "value for tag"
+                                    : key == QLatin1String("caption") ? "value for caption"
+                                                                      : "value for url")) {
+                    errorPushed = true;
+                    break;
                 }
 
-                mediaData.setMediaVolume(value);
-            } else if (key == QLatin1String("fadein")) {
-                if (value < 0) {
-                    lua_pushfstring(L, "playMusicFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "fadein", value);
-                    return lua_error(L);
+                QString value{lua_tostring(L, -1)};
+
+                if (key == QLatin1String("name") && !value.isEmpty()) {
+                    if (QDir::homePath().contains('\\')) {
+                        value.replace('/', R"(\)");
+                    } else {
+                        value.replace('\\', "/");
+                    }
+
+                    mediaData.setMediaFileName(value);
+                } else if (key == QLatin1String("url") && !value.isEmpty()) {
+                    mediaData.setMediaUrl(value);
+                } else if (key == QLatin1String("key") && !value.isEmpty()) {
+                    mediaData.setMediaKey(value);
+                } else if (key == QLatin1String("tag") && !value.isEmpty()) {
+                    mediaData.setMediaTag(value);
+                } else if (key == QLatin1String("caption") && !value.isEmpty()) {
+                    mediaData.setMediaCaption(value);
+                }
+            } else if (key == QLatin1String("volume") || key == QLatin1String("fadein") || key == QLatin1String("fadeout") || key == QLatin1String("start") || key == QLatin1String("finish")
+                       || key == QLatin1String("loops")) {
+                if (!checkIntArg(L,
+                                 func,
+                                 -1,
+                                 key == QLatin1String("volume")    ? "value for volume"
+                                 : key == QLatin1String("fadein")  ? "value for fadein"
+                                 : key == QLatin1String("fadeout") ? "value for fadeout"
+                                 : key == QLatin1String("start")   ? "value for start"
+                                 : key == QLatin1String("finish")  ? "value for finish"
+                                                                   : "value for loops")) {
+                    errorPushed = true;
+                    break;
                 }
 
-                mediaData.setMediaFadeIn(value);
-            } else if (key == QLatin1String("fadeout")) {
-                if (value < 0) {
-                    lua_pushfstring(L, "playMusicFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "fadeout", value);
-                    return lua_error(L);
+                int value = static_cast(lua_tointeger(L, -1));
+
+                if (key == QLatin1String("volume")) {
+                    if (value == TMediaData::MediaVolumePreload) {
+                        {
+                        } // Volume of 0 supports preloading
+                    } else if (value > TMediaData::MediaVolumeMax) {
+                        value = TMediaData::MediaVolumeMax;
+                    } else if (value < TMediaData::MediaVolumeMin) {
+                        value = TMediaData::MediaVolumeMin;
+                    }
+
+                    mediaData.setMediaVolume(value);
+                } else if (key == QLatin1String("fadein")) {
+                    if (value < 0) {
+                        lua_pushfstring(L, "playMusicFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "fadein", value);
+                        errorPushed = true;
+                        break;
+                    }
+
+                    mediaData.setMediaFadeIn(value);
+                } else if (key == QLatin1String("fadeout")) {
+                    if (value < 0) {
+                        lua_pushfstring(L, "playMusicFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "fadeout", value);
+                        errorPushed = true;
+                        break;
+                    }
+
+                    mediaData.setMediaFadeOut(value);
+                } else if (key == QLatin1String("start")) {
+                    if (value < 0) {
+                        lua_pushfstring(L, "playMusicFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "start", value);
+                        errorPushed = true;
+                        break;
+                    }
+
+                    mediaData.setMediaStart(value);
+                } else if (key == QLatin1String("finish")) {
+                    if (value < 0) {
+                        lua_pushfstring(L, "playMusicFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "finish", value);
+                        errorPushed = true;
+                        break;
+                    }
+
+                    mediaData.setMediaFinish(value);
+                } else if (key == QLatin1String("loops")) {
+                    if (value < TMediaData::MediaLoopsRepeat || value == 0) {
+                        value = TMediaData::MediaLoopsDefault;
+                    }
+
+                    mediaData.setMediaLoops(value);
+                }
+            } else if (key == QLatin1String("continue")) {
+                if (!checkBoolArg(L, func, -1, "value for continue")) {
+                    errorPushed = true;
+                    break;
                 }
 
-                mediaData.setMediaFadeOut(value);
-            } else if (key == QLatin1String("start")) {
-                if (value < 0) {
-                    lua_pushfstring(L, "playMusicFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "start", value);
-                    return lua_error(L);
-                }
-
-                mediaData.setMediaStart(value);
-            } else if (key == QLatin1String("finish")) {
-                if (value < 0) {
-                    lua_pushfstring(L, "playMusicFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "finish", value);
-                    return lua_error(L);
-                }
-
-                mediaData.setMediaFinish(value);
-            } else if (key == QLatin1String("loops")) {
-                if (value < TMediaData::MediaLoopsRepeat || value == 0) {
-                    value = TMediaData::MediaLoopsDefault;
-                }
-
-                mediaData.setMediaLoops(value);
+                mediaData.setMediaContinue(lua_toboolean(L, -1));
             }
-        } else if (key == QLatin1String("continue")) {
-            const bool value = getVerifiedBool(L, func, -1, "value for continue");
-            mediaData.setMediaContinue(value);
+
+            // removes value, but keeps key for next iteration
+            lua_pop(L, 1);
         }
 
-        // removes value, but keeps key for next iteration
-        lua_pop(L, 1);
+        if (!errorPushed) {
+            if (mediaData.mediaFileName().isEmpty()) {
+                lua_pushstring(L, R"(playMusicFile: missing name (add name = "file to play"))");
+                errorPushed = true;
+            } else {
+                mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
+                mediaData.setMediaType(TMediaData::MediaTypeMusic);
+                host.mpMedia->playMedia(mediaData);
+            }
+        }
     }
 
-    if (mediaData.mediaFileName().isEmpty()) {
-        lua_pushstring(L, R"(playMusicFile: missing name (add name = "file to play"))");
+    if (errorPushed) {
         return lua_error(L);
     }
 
-    mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
-    mediaData.setMediaType(TMediaData::MediaTypeMusic);
-    host.mpMedia->playMedia(mediaData);
     lua_pushboolean(L, true);
     return 1;
 }
@@ -450,126 +599,193 @@ int TLuaInterpreter::playMusicFile(lua_State* L)
 int TLuaInterpreter::playSoundFileAsOrderedArguments(lua_State* L, const char* func)
 {
     const Host& host = getHostFromLua(L);
-    TMediaData mediaData{};
     const int numArgs = lua_gettop(L);
-    QString stringValue;
-    int intValue = 0;
 
-    // name[,volume][,fadein][,fadeout][,start][,loops][,key][,tag][,priority][,url][,finish]
-    for (int i = 1; i <= numArgs; i++) {
-        if (lua_isnil(L, i)) {
-            continue;
+    bool errorPushed = false;
+    {
+        TMediaData mediaData{};
+        QString stringValue;
+        int intValue = 0;
+
+        // name[,volume][,fadein][,fadeout][,start][,loops][,key][,tag][,priority][,url][,finish]
+        for (int i = 1; i <= numArgs && !errorPushed; i++) {
+            if (lua_isnil(L, i)) {
+                continue;
+            }
+
+            switch (i) {
+            case 1:
+                if (!checkStringArg(L, func, i, "name")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                stringValue = lua_tostring(L, i);
+
+                if (QDir::homePath().contains('\\')) {
+                    stringValue.replace('/', R"(\)");
+                } else {
+                    stringValue.replace('\\', "/");
+                }
+
+                mediaData.setMediaFileName(stringValue);
+                break;
+            case 2:
+                if (!checkIntArg(L, func, i, "volume")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                intValue = static_cast(lua_tointeger(L, i));
+
+                if (intValue == TMediaData::MediaVolumePreload) {
+                    {
+                    } // Volume of 0 supports preloading
+                } else if (intValue > TMediaData::MediaVolumeMax) {
+                    intValue = TMediaData::MediaVolumeMax;
+                } else if (intValue < TMediaData::MediaVolumeMin) {
+                    intValue = TMediaData::MediaVolumeMin;
+                }
+
+                mediaData.setMediaVolume(intValue);
+                break;
+            case 3:
+                if (!checkIntArg(L, func, i, "fadein")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                intValue = static_cast(lua_tointeger(L, i));
+
+                if (intValue < 0) {
+                    lua_pushfstring(L, "playSoundFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "fadein", intValue);
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaFadeIn(intValue);
+                break;
+            case 4:
+                if (!checkIntArg(L, func, i, "fadeout")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                intValue = static_cast(lua_tointeger(L, i));
+
+                if (intValue < 0) {
+                    lua_pushfstring(L, "playSoundFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "fadeout", intValue);
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaFadeOut(intValue);
+                break;
+            case 5:
+                if (!checkIntArg(L, func, i, "start")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                intValue = static_cast(lua_tointeger(L, i));
+
+                if (intValue < 0) {
+                    lua_pushfstring(L, "playSoundFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "start", intValue);
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaStart(intValue);
+                break;
+            case 6:
+                if (!checkIntArg(L, func, i, "loops")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                intValue = static_cast(lua_tointeger(L, i));
+
+                if (intValue < TMediaData::MediaLoopsRepeat || intValue == 0) {
+                    intValue = TMediaData::MediaLoopsDefault;
+                }
+
+                mediaData.setMediaLoops(intValue);
+                break;
+            case 7:
+                if (!checkStringArg(L, func, i, "key")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaKey(QString{lua_tostring(L, i)});
+                break;
+            case 8:
+                if (!checkStringArg(L, func, i, "tag")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaTag(QString{lua_tostring(L, i)});
+                break;
+            case 9:
+                if (!checkIntArg(L, func, i, "priority")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                intValue = static_cast(lua_tointeger(L, i));
+
+                if (intValue > TMediaData::MediaPriorityMax) {
+                    intValue = TMediaData::MediaPriorityMax;
+                } else if (intValue < TMediaData::MediaPriorityMin) {
+                    intValue = TMediaData::MediaPriorityMin;
+                }
+
+                mediaData.setMediaPriority(intValue);
+                break;
+            case 10:
+                if (!checkStringArg(L, func, i, "url")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaUrl(QString{lua_tostring(L, i)});
+                break;
+            case 11:
+                if (!checkIntArg(L, func, i, "finish")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                intValue = static_cast(lua_tointeger(L, i));
+
+                if (intValue < 0) {
+                    lua_pushfstring(L, "playSoundFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "finish", intValue);
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaFinish(intValue);
+                break;
+            }
         }
 
-        switch (i) {
-        case 1:
-            stringValue = getVerifiedString(L, func, i, "name");
-
-            if (QDir::homePath().contains('\\')) {
-                stringValue.replace('/', R"(\)");
-            } else {
-                stringValue.replace('\\', "/");
+        if (!errorPushed) {
+            if (mediaData.mediaFileName().isEmpty()) {
+                return warnArgumentValue(L, func, QLatin1String("missing argument 1 (file to play)"));
             }
 
-            mediaData.setMediaFileName(stringValue);
-            break;
-        case 2:
-            intValue = getVerifiedInt(L, func, i, "volume");
+            mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
+            mediaData.setMediaType(TMediaData::MediaTypeSound);
 
-            if (intValue == TMediaData::MediaVolumePreload) {
-                {
-                } // Volume of 0 supports preloading
-            } else if (intValue > TMediaData::MediaVolumeMax) {
-                intValue = TMediaData::MediaVolumeMax;
-            } else if (intValue < TMediaData::MediaVolumeMin) {
-                intValue = TMediaData::MediaVolumeMin;
-            }
-
-            mediaData.setMediaVolume(intValue);
-            break;
-        case 3:
-            intValue = getVerifiedInt(L, func, i, "fadein");
-
-            if (intValue < 0) {
-                lua_pushfstring(L, "playSoundFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "fadein", intValue);
-                return lua_error(L);
-            }
-
-            mediaData.setMediaFadeIn(intValue);
-            break;
-        case 4:
-            intValue = getVerifiedInt(L, func, i, "fadeout");
-
-            if (intValue < 0) {
-                lua_pushfstring(L, "playSoundFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "fadeout", intValue);
-                return lua_error(L);
-            }
-
-            mediaData.setMediaFadeOut(intValue);
-            break;
-        case 5:
-            intValue = getVerifiedInt(L, func, i, "start");
-
-            if (intValue < 0) {
-                lua_pushfstring(L, "playSoundFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "start", intValue);
-                return lua_error(L);
-            }
-
-            mediaData.setMediaStart(intValue);
-            break;
-        case 6:
-            intValue = getVerifiedInt(L, func, i, "loops");
-
-            if (intValue < TMediaData::MediaLoopsRepeat || intValue == 0) {
-                intValue = TMediaData::MediaLoopsDefault;
-            }
-
-            mediaData.setMediaLoops(intValue);
-            break;
-        case 7:
-            stringValue = getVerifiedString(L, func, i, "key");
-            mediaData.setMediaKey(stringValue);
-            break;
-        case 8:
-            stringValue = getVerifiedString(L, func, i, "tag");
-            mediaData.setMediaTag(stringValue);
-            break;
-        case 9:
-            intValue = getVerifiedInt(L, func, i, "priority");
-
-            if (intValue > TMediaData::MediaPriorityMax) {
-                intValue = TMediaData::MediaPriorityMax;
-            } else if (intValue < TMediaData::MediaPriorityMin) {
-                intValue = TMediaData::MediaPriorityMin;
-            }
-
-            mediaData.setMediaPriority(intValue);
-            break;
-        case 10:
-            stringValue = getVerifiedString(L, func, i, "url");
-            mediaData.setMediaUrl(stringValue);
-            break;
-        case 11:
-            intValue = getVerifiedInt(L, func, i, "finish");
-
-            if (intValue < 0) {
-                lua_pushfstring(L, "playSoundFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "finish", intValue);
-                return lua_error(L);
-            }
-
-            mediaData.setMediaFinish(intValue);
-            break;
+            host.mpMedia->playMedia(mediaData);
         }
     }
 
-    if (mediaData.mediaFileName().isEmpty()) {
-        return warnArgumentValue(L, func, QLatin1String("missing argument 1 (file to play)"));
+    if (errorPushed) {
+        return lua_error(L);
     }
 
-    mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
-    mediaData.setMediaType(TMediaData::MediaTypeSound);
-
-    host.mpMedia->playMedia(mediaData);
     lua_pushboolean(L, true);
     return 1;
 }
@@ -578,123 +794,156 @@ int TLuaInterpreter::playSoundFileAsOrderedArguments(lua_State* L, const char* f
 int TLuaInterpreter::playSoundFileAsTableArgument(lua_State* L, const char* func)
 {
     const Host& host = getHostFromLua(L);
-    TMediaData mediaData{};
 
-    lua_pushnil(L);
-    while (lua_next(L, 1) != 0) {
-        // key at index -2 and value at index -1
-        QString key = getVerifiedString(L, func, -2, "table keys");
-        key = key.toLower();
+    bool errorPushed = false;
+    {
+        TMediaData mediaData{};
 
-        if (key == QLatin1String("name") || key == QLatin1String("url") || key == QLatin1String("key") || key == QLatin1String("tag") || key == QLatin1String("caption")) {
-            QString value = getVerifiedString(L,
-                                              func,
-                                              -1,
-                                              key == QLatin1String("name")      ? "value for name"
-                                              : key == QLatin1String("key")     ? "value for key"
-                                              : key == QLatin1String("tag")     ? "value for tag"
-                                              : key == QLatin1String("caption") ? "value for caption"
-                                                                                : "value for url");
-
-            if (key == QLatin1String("name") && !value.isEmpty()) {
-                if (QDir::homePath().contains('\\')) {
-                    value.replace('/', R"(\)");
-                } else {
-                    value.replace('\\', "/");
-                }
-
-                mediaData.setMediaFileName(value);
-            } else if (key == QLatin1String("url") && !value.isEmpty()) {
-                mediaData.setMediaUrl(value);
-            } else if (key == QLatin1String("key") && !value.isEmpty()) {
-                mediaData.setMediaKey(value);
-            } else if (key == QLatin1String("tag") && !value.isEmpty()) {
-                mediaData.setMediaTag(value);
-            } else if (key == QLatin1String("caption") && !value.isEmpty()) {
-                mediaData.setMediaCaption(value);
+        lua_pushnil(L);
+        while (lua_next(L, 1) != 0) {
+            // key at index -2 and value at index -1
+            if (!checkStringArg(L, func, -2, "table keys")) {
+                errorPushed = true;
+                break;
             }
-        } else if (key == QLatin1String("volume") || key == QLatin1String("fadein") || key == QLatin1String("fadeout") || key == QLatin1String("start") || key == QLatin1String("finish")
-                   || key == QLatin1String("loops") || key == QLatin1String("priority")) {
-            int value = getVerifiedInt(L,
-                                       func,
-                                       -1,
-                                       key == QLatin1String("volume")    ? "value for volume"
-                                       : key == QLatin1String("fadein")  ? "value for fadein"
-                                       : key == QLatin1String("fadeout") ? "value for fadeout"
-                                       : key == QLatin1String("start")   ? "value for start"
-                                       : key == QLatin1String("finish")  ? "value for finish"
-                                       : key == QLatin1String("loops")   ? "value for loops"
-                                                                         : "value for priority");
 
-            if (key == QLatin1String("volume")) {
-                if (value == TMediaData::MediaVolumePreload) {
-                    {
-                    } // Volume of 0 supports preloading
-                } else if (value > TMediaData::MediaVolumeMax) {
-                    value = TMediaData::MediaVolumeMax;
-                } else if (value < TMediaData::MediaVolumeMin) {
-                    value = TMediaData::MediaVolumeMin;
+            // read the key from a copy: lua_tostring() on the slot itself converts a
+            // numeric key in place, which makes the next lua_next() fail
+            lua_pushvalue(L, -2);
+            const QString key = QString{lua_tostring(L, -1)}.toLower();
+            lua_pop(L, 1);
+
+            if (key == QLatin1String("name") || key == QLatin1String("url") || key == QLatin1String("key") || key == QLatin1String("tag") || key == QLatin1String("caption")) {
+                if (!checkStringArg(L,
+                                    func,
+                                    -1,
+                                    key == QLatin1String("name")      ? "value for name"
+                                    : key == QLatin1String("key")     ? "value for key"
+                                    : key == QLatin1String("tag")     ? "value for tag"
+                                    : key == QLatin1String("caption") ? "value for caption"
+                                                                      : "value for url")) {
+                    errorPushed = true;
+                    break;
                 }
 
-                mediaData.setMediaVolume(value);
-            } else if (key == QLatin1String("fadein")) {
-                if (value < 0) {
-                    lua_pushfstring(L, "playSoundFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "fadein", value);
-                    return lua_error(L);
+                QString value{lua_tostring(L, -1)};
+
+                if (key == QLatin1String("name") && !value.isEmpty()) {
+                    if (QDir::homePath().contains('\\')) {
+                        value.replace('/', R"(\)");
+                    } else {
+                        value.replace('\\', "/");
+                    }
+
+                    mediaData.setMediaFileName(value);
+                } else if (key == QLatin1String("url") && !value.isEmpty()) {
+                    mediaData.setMediaUrl(value);
+                } else if (key == QLatin1String("key") && !value.isEmpty()) {
+                    mediaData.setMediaKey(value);
+                } else if (key == QLatin1String("tag") && !value.isEmpty()) {
+                    mediaData.setMediaTag(value);
+                } else if (key == QLatin1String("caption") && !value.isEmpty()) {
+                    mediaData.setMediaCaption(value);
+                }
+            } else if (key == QLatin1String("volume") || key == QLatin1String("fadein") || key == QLatin1String("fadeout") || key == QLatin1String("start") || key == QLatin1String("finish")
+                       || key == QLatin1String("loops") || key == QLatin1String("priority")) {
+                if (!checkIntArg(L,
+                                 func,
+                                 -1,
+                                 key == QLatin1String("volume")    ? "value for volume"
+                                 : key == QLatin1String("fadein")  ? "value for fadein"
+                                 : key == QLatin1String("fadeout") ? "value for fadeout"
+                                 : key == QLatin1String("start")   ? "value for start"
+                                 : key == QLatin1String("finish")  ? "value for finish"
+                                 : key == QLatin1String("loops")   ? "value for loops"
+                                                                   : "value for priority")) {
+                    errorPushed = true;
+                    break;
                 }
 
-                mediaData.setMediaFadeIn(value);
-            } else if (key == QLatin1String("fadeout")) {
-                if (value < 0) {
-                    lua_pushfstring(L, "playSoundFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "fadeout", value);
-                    return lua_error(L);
-                }
+                int value = static_cast(lua_tointeger(L, -1));
 
-                mediaData.setMediaFadeOut(value);
-            } else if (key == QLatin1String("start")) {
-                if (value < 0) {
-                    lua_pushfstring(L, "playSoundFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "start", value);
-                    return lua_error(L);
-                }
+                if (key == QLatin1String("volume")) {
+                    if (value == TMediaData::MediaVolumePreload) {
+                        {
+                        } // Volume of 0 supports preloading
+                    } else if (value > TMediaData::MediaVolumeMax) {
+                        value = TMediaData::MediaVolumeMax;
+                    } else if (value < TMediaData::MediaVolumeMin) {
+                        value = TMediaData::MediaVolumeMin;
+                    }
 
-                mediaData.setMediaStart(value);
-            } else if (key == QLatin1String("finish")) {
-                if (value < 0) {
-                    lua_pushfstring(L, "playSoundFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "finish", value);
-                    return lua_error(L);
-                }
+                    mediaData.setMediaVolume(value);
+                } else if (key == QLatin1String("fadein")) {
+                    if (value < 0) {
+                        lua_pushfstring(L, "playSoundFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "fadein", value);
+                        errorPushed = true;
+                        break;
+                    }
 
-                mediaData.setMediaFinish(value);
-            } else if (key == QLatin1String("loops")) {
-                if (value < TMediaData::MediaLoopsRepeat || value == 0) {
-                    value = TMediaData::MediaLoopsDefault;
-                }
+                    mediaData.setMediaFadeIn(value);
+                } else if (key == QLatin1String("fadeout")) {
+                    if (value < 0) {
+                        lua_pushfstring(L, "playSoundFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "fadeout", value);
+                        errorPushed = true;
+                        break;
+                    }
 
-                mediaData.setMediaLoops(value);
-            } else if (key == QLatin1String("priority")) {
-                if (value > TMediaData::MediaPriorityMax) {
-                    value = TMediaData::MediaPriorityMax;
-                } else if (value < TMediaData::MediaPriorityMin) {
-                    value = TMediaData::MediaPriorityMin;
-                }
+                    mediaData.setMediaFadeOut(value);
+                } else if (key == QLatin1String("start")) {
+                    if (value < 0) {
+                        lua_pushfstring(L, "playSoundFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "start", value);
+                        errorPushed = true;
+                        break;
+                    }
 
-                mediaData.setMediaPriority(value);
+                    mediaData.setMediaStart(value);
+                } else if (key == QLatin1String("finish")) {
+                    if (value < 0) {
+                        lua_pushfstring(L, "playSoundFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "finish", value);
+                        errorPushed = true;
+                        break;
+                    }
+
+                    mediaData.setMediaFinish(value);
+                } else if (key == QLatin1String("loops")) {
+                    if (value < TMediaData::MediaLoopsRepeat || value == 0) {
+                        value = TMediaData::MediaLoopsDefault;
+                    }
+
+                    mediaData.setMediaLoops(value);
+                } else if (key == QLatin1String("priority")) {
+                    if (value > TMediaData::MediaPriorityMax) {
+                        value = TMediaData::MediaPriorityMax;
+                    } else if (value < TMediaData::MediaPriorityMin) {
+                        value = TMediaData::MediaPriorityMin;
+                    }
+
+                    mediaData.setMediaPriority(value);
+                }
             }
+
+            // removes value, but keeps key for next iteration
+            lua_pop(L, 1);
         }
 
-        // removes value, but keeps key for next iteration
-        lua_pop(L, 1);
+        if (!errorPushed) {
+            if (mediaData.mediaFileName().isEmpty()) {
+                lua_pushstring(L, R"(playSoundFile: missing name (add name = "file to play"))");
+                errorPushed = true;
+            } else {
+                mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
+                mediaData.setMediaType(TMediaData::MediaTypeSound);
+
+                host.mpMedia->playMedia(mediaData);
+            }
+        }
     }
 
-    if (mediaData.mediaFileName().isEmpty()) {
-        lua_pushstring(L, R"(playSoundFile: missing name (add name = "file to play"))");
+    if (errorPushed) {
         return lua_error(L);
     }
 
-    mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
-    mediaData.setMediaType(TMediaData::MediaTypeSound);
-
-    host.mpMedia->playMedia(mediaData);
     lua_pushboolean(L, true);
     return 1;
 }
@@ -718,98 +967,142 @@ int TLuaInterpreter::playSoundFile(lua_State* L)
 int TLuaInterpreter::playVideoFileAsTableArgument(lua_State* L, const char* func)
 {
     Host& host = getHostFromLua(L);
-    TMediaData mediaData{};
 
-    lua_pushnil(L);
-    while (lua_next(L, 1) != 0) {
-        // key at index -2 and value at index -1
-        QString key = getVerifiedString(L, func, -2, "table keys");
+    bool errorPushed = false;
+    {
+        TMediaData mediaData{};
 
-        if (!key.compare(QLatin1String("name"), Qt::CaseInsensitive) || !key.compare(QLatin1String("url"), Qt::CaseInsensitive) || !key.compare(QLatin1String("key"), Qt::CaseInsensitive)
-            || !key.compare(QLatin1String("tag"), Qt::CaseInsensitive)) {
-            QString value = getVerifiedString(L,
-                                              func,
-                                              -1,
-                                              !key.compare(QLatin1String("name"), Qt::CaseInsensitive)  ? "value for name"
-                                              : !key.compare(QLatin1String("key"), Qt::CaseInsensitive) ? "value for key"
-                                              : !key.compare(QLatin1String("tag"), Qt::CaseInsensitive) ? "value for tag"
-                                                                                                        : "value for url");
-
-            if (!key.compare(QLatin1String("name"), Qt::CaseInsensitive) && !value.isEmpty()) {
-                if (QDir::homePath().contains('\\')) {
-                    value.replace('/', R"(\)");
-                } else {
-                    value.replace('\\', "/");
-                }
-
-                mediaData.setMediaFileName(value);
-            } else if (!key.compare(QLatin1String("url"), Qt::CaseInsensitive) && !value.isEmpty()) {
-                mediaData.setMediaUrl(value);
-            } else if (!key.compare(QLatin1String("key"), Qt::CaseInsensitive) && !value.isEmpty()) {
-                mediaData.setMediaKey(value);
-            } else if (!key.compare(QLatin1String("tag"), Qt::CaseInsensitive) && !value.isEmpty()) {
-                mediaData.setMediaTag(value);
+        lua_pushnil(L);
+        while (lua_next(L, 1) != 0) {
+            // key at index -2 and value at index -1
+            if (!checkStringArg(L, func, -2, "table keys")) {
+                errorPushed = true;
+                break;
             }
-        } else if (!key.compare(QLatin1String("volume"), Qt::CaseInsensitive) || !key.compare(QLatin1String("start"), Qt::CaseInsensitive) || !key.compare(QLatin1String("finish"), Qt::CaseInsensitive)
-                   || !key.compare(QLatin1String("loops"), Qt::CaseInsensitive)) {
-            int value = getVerifiedInt(L,
-                                       func,
-                                       -1,
-                                       !key.compare(QLatin1String("volume"), Qt::CaseInsensitive)   ? "value for volume"
-                                       : !key.compare(QLatin1String("start"), Qt::CaseInsensitive)  ? "value for start"
-                                       : !key.compare(QLatin1String("finish"), Qt::CaseInsensitive) ? "value for finish"
-                                                                                                    : "value for loops");
 
-            if (!key.compare(QLatin1String("volume"), Qt::CaseInsensitive)) {
-                if (value != TMediaData::MediaVolumePreload) {
-                    value = qBound(static_cast(TMediaData::MediaVolumeMin), value, static_cast(TMediaData::MediaVolumeMax));
+            // read the key from a copy: lua_tostring() on the slot itself converts a
+            // numeric key in place, which makes the next lua_next() fail
+            lua_pushvalue(L, -2);
+            const QString key{lua_tostring(L, -1)};
+            lua_pop(L, 1);
+
+            if (!key.compare(QLatin1String("name"), Qt::CaseInsensitive) || !key.compare(QLatin1String("url"), Qt::CaseInsensitive) || !key.compare(QLatin1String("key"), Qt::CaseInsensitive)
+                || !key.compare(QLatin1String("tag"), Qt::CaseInsensitive)) {
+                if (!checkStringArg(L,
+                                    func,
+                                    -1,
+                                    !key.compare(QLatin1String("name"), Qt::CaseInsensitive)  ? "value for name"
+                                    : !key.compare(QLatin1String("key"), Qt::CaseInsensitive) ? "value for key"
+                                    : !key.compare(QLatin1String("tag"), Qt::CaseInsensitive) ? "value for tag"
+                                                                                              : "value for url")) {
+                    errorPushed = true;
+                    break;
                 }
 
-                mediaData.setMediaVolume(value);
-            } else if (!key.compare(QLatin1String("start"), Qt::CaseInsensitive)) {
-                if (value < 0) {
-                    lua_pushfstring(L, "playVideoFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "start", value);
-                    return lua_error(L);
+                QString value{lua_tostring(L, -1)};
+
+                if (!key.compare(QLatin1String("name"), Qt::CaseInsensitive) && !value.isEmpty()) {
+                    if (QDir::homePath().contains('\\')) {
+                        value.replace('/', R"(\)");
+                    } else {
+                        value.replace('\\', "/");
+                    }
+
+                    mediaData.setMediaFileName(value);
+                } else if (!key.compare(QLatin1String("url"), Qt::CaseInsensitive) && !value.isEmpty()) {
+                    mediaData.setMediaUrl(value);
+                } else if (!key.compare(QLatin1String("key"), Qt::CaseInsensitive) && !value.isEmpty()) {
+                    mediaData.setMediaKey(value);
+                } else if (!key.compare(QLatin1String("tag"), Qt::CaseInsensitive) && !value.isEmpty()) {
+                    mediaData.setMediaTag(value);
+                }
+            } else if (!key.compare(QLatin1String("volume"), Qt::CaseInsensitive) || !key.compare(QLatin1String("start"), Qt::CaseInsensitive)
+                       || !key.compare(QLatin1String("finish"), Qt::CaseInsensitive) || !key.compare(QLatin1String("loops"), Qt::CaseInsensitive)) {
+                if (!checkIntArg(L,
+                                 func,
+                                 -1,
+                                 !key.compare(QLatin1String("volume"), Qt::CaseInsensitive)   ? "value for volume"
+                                 : !key.compare(QLatin1String("start"), Qt::CaseInsensitive)  ? "value for start"
+                                 : !key.compare(QLatin1String("finish"), Qt::CaseInsensitive) ? "value for finish"
+                                                                                              : "value for loops")) {
+                    errorPushed = true;
+                    break;
                 }
 
-                mediaData.setMediaStart(value);
-            } else if (!key.compare(QLatin1String("finish"), Qt::CaseInsensitive)) {
-                if (value < 0) {
-                    lua_pushfstring(L, "playVideoFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "finish", value);
-                    return lua_error(L);
+                int value = static_cast(lua_tointeger(L, -1));
+
+                if (!key.compare(QLatin1String("volume"), Qt::CaseInsensitive)) {
+                    if (value != TMediaData::MediaVolumePreload) {
+                        value = qBound(static_cast(TMediaData::MediaVolumeMin), value, static_cast(TMediaData::MediaVolumeMax));
+                    }
+
+                    mediaData.setMediaVolume(value);
+                } else if (!key.compare(QLatin1String("start"), Qt::CaseInsensitive)) {
+                    if (value < 0) {
+                        lua_pushfstring(L, "playVideoFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "start", value);
+                        errorPushed = true;
+                        break;
+                    }
+
+                    mediaData.setMediaStart(value);
+                } else if (!key.compare(QLatin1String("finish"), Qt::CaseInsensitive)) {
+                    if (value < 0) {
+                        lua_pushfstring(L, "playVideoFile: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "finish", value);
+                        errorPushed = true;
+                        break;
+                    }
+
+                    mediaData.setMediaFinish(value);
+                } else if (!key.compare(QLatin1String("loops"), Qt::CaseInsensitive)) {
+                    if (value < TMediaData::MediaLoopsRepeat || value == 0) {
+                        value = TMediaData::MediaLoopsDefault;
+                    }
+
+                    mediaData.setMediaLoops(value);
+                }
+            } else if (!key.compare(QLatin1String("continue"), Qt::CaseInsensitive)) {
+                if (!checkBoolArg(L, func, -1, "value for continue")) {
+                    errorPushed = true;
+                    break;
                 }
 
-                mediaData.setMediaFinish(value);
-            } else if (!key.compare(QLatin1String("loops"), Qt::CaseInsensitive)) {
-                if (value < TMediaData::MediaLoopsRepeat || value == 0) {
-                    value = TMediaData::MediaLoopsDefault;
+                mediaData.setMediaContinue(lua_toboolean(L, -1));
+            } else if (!key.compare(QLatin1String("stream"), Qt::CaseInsensitive)) {
+                if (!checkBoolArg(L, func, -1, "value for stream")) {
+                    errorPushed = true;
+                    break;
                 }
 
-                mediaData.setMediaLoops(value);
+                mediaData.setMediaInput(lua_toboolean(L, -1) ? TMediaData::MediaInputStream : TMediaData::MediaInputNotSet);
+            } else if (!key.compare(QLatin1String("close"), Qt::CaseInsensitive)) {
+                if (!checkBoolArg(L, func, -1, "value for close")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaClose(lua_toboolean(L, -1) ? TMediaData::MediaCloseEnabled : TMediaData::MediaCloseDefault);
             }
-        } else if (!key.compare(QLatin1String("continue"), Qt::CaseInsensitive)) {
-            bool value = getVerifiedBool(L, func, -1, "value for continue");
-            mediaData.setMediaContinue(value);
-        } else if (!key.compare(QLatin1String("stream"), Qt::CaseInsensitive)) {
-            bool value = getVerifiedBool(L, func, -1, "value for stream");
-            mediaData.setMediaInput(value ? TMediaData::MediaInputStream : TMediaData::MediaInputNotSet);
-        } else if (!key.compare(QLatin1String("close"), Qt::CaseInsensitive)) {
-            bool value = getVerifiedBool(L, func, -1, "value for close");
-            mediaData.setMediaClose(value ? TMediaData::MediaCloseEnabled : TMediaData::MediaCloseDefault);
+
+            // removes value, but keeps key for next iteration
+            lua_pop(L, 1);
         }
 
-        // removes value, but keeps key for next iteration
-        lua_pop(L, 1);
+        if (!errorPushed) {
+            if (mediaData.mediaFileName().isEmpty()) {
+                lua_pushstring(L, R"(playVideoFile: missing name (add name = "file to play"))");
+                errorPushed = true;
+            } else {
+                mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
+                mediaData.setMediaType(TMediaData::MediaTypeVideo);
+                host.mpMedia->playMedia(mediaData);
+            }
+        }
     }
 
-    if (mediaData.mediaFileName().isEmpty()) {
-        lua_pushstring(L, R"(playVideoFile: missing name (add name = "file to play"))");
+    if (errorPushed) {
         return lua_error(L);
     }
 
-    mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
-    mediaData.setMediaType(TMediaData::MediaTypeVideo);
-    host.mpMedia->playMedia(mediaData);
     lua_pushboolean(L, true);
     return 1;
 }
@@ -883,91 +1176,136 @@ void TLuaInterpreter::processPlayingMediaTable(lua_State* L, TMediaData& mediaDa
 // Private
 int TLuaInterpreter::getPlayingMusicAsOrderedArguments(lua_State* L, const char* func)
 {
-    TMediaData mediaData{};
     const int numArgs = lua_gettop(L);
-    QString stringValue;
 
-    // values as ordered args: name[,key][,tag]
-    for (int i = 1; i <= numArgs; i++) {
-        if (lua_isnil(L, i)) {
-            continue;
-        }
+    bool errorPushed = false;
+    {
+        TMediaData mediaData{};
+        QString stringValue;
 
-        switch (i) {
-        case 1:
-            stringValue = getVerifiedString(L, func, i, "name");
-
-            if (QDir::homePath().contains('\\')) {
-                stringValue.replace('/', R"(\)");
-            } else {
-                stringValue.replace('\\', "/");
+        // values as ordered args: name[,key][,tag]
+        for (int i = 1; i <= numArgs && !errorPushed; i++) {
+            if (lua_isnil(L, i)) {
+                continue;
             }
 
-            mediaData.setMediaFileName(stringValue);
-            break;
-        case 2:
-            stringValue = getVerifiedString(L, func, i, "key");
-            mediaData.setMediaKey(stringValue);
-            break;
-        case 3:
-            stringValue = getVerifiedString(L, func, i, "tag");
-            mediaData.setMediaTag(stringValue);
-            break;
+            switch (i) {
+            case 1:
+                if (!checkStringArg(L, func, i, "name")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                stringValue = lua_tostring(L, i);
+
+                if (QDir::homePath().contains('\\')) {
+                    stringValue.replace('/', R"(\)");
+                } else {
+                    stringValue.replace('\\', "/");
+                }
+
+                mediaData.setMediaFileName(stringValue);
+                break;
+            case 2:
+                if (!checkStringArg(L, func, i, "key")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaKey(QString{lua_tostring(L, i)});
+                break;
+            case 3:
+                if (!checkStringArg(L, func, i, "tag")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaTag(QString{lua_tostring(L, i)});
+                break;
+            }
+        }
+
+        if (!errorPushed) {
+            mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
+            mediaData.setMediaType(TMediaData::MediaTypeMusic);
+
+            processPlayingMediaTable(L, mediaData);
         }
     }
 
-    mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
-    mediaData.setMediaType(TMediaData::MediaTypeMusic);
+    if (errorPushed) {
+        return lua_error(L);
+    }
 
-    processPlayingMediaTable(L, mediaData);
     return 1;
 }
 
 // Private
 int TLuaInterpreter::getPlayingMusicAsTableArgument(lua_State* L, const char* func)
 {
-    TMediaData mediaData{};
+    bool errorPushed = false;
+    {
+        TMediaData mediaData{};
 
-    lua_pushnil(L);
-    while (lua_next(L, 1) != 0) {
-        // key at index -2 and value at index -1
-        QString key = getVerifiedString(L, func, -2, "table keys");
-        key = key.toLower();
+        lua_pushnil(L);
+        while (lua_next(L, 1) != 0) {
+            // key at index -2 and value at index -1
+            if (!checkStringArg(L, func, -2, "table keys")) {
+                errorPushed = true;
+                break;
+            }
 
-        if (key == QLatin1String("name") || key == QLatin1String("key") || key == QLatin1String("tag")) {
-            QString value = getVerifiedString(L, func, -1, key == QLatin1String("name") ? "value for name" : key == QLatin1String("key") ? "value for key" : "value for tag");
+            // read the key from a copy: lua_tostring() on the slot itself converts a
+            // numeric key in place, which makes the next lua_next() fail
+            lua_pushvalue(L, -2);
+            const QString key = QString{lua_tostring(L, -1)}.toLower();
+            lua_pop(L, 1);
 
-            if (key == QLatin1String("name") && !value.isEmpty()) {
-                if (QDir::homePath().contains('\\')) {
-                    value.replace('/', R"(\)");
-                } else {
-                    value.replace('\\', "/");
+            if (key == QLatin1String("name") || key == QLatin1String("key") || key == QLatin1String("tag")) {
+                if (!checkStringArg(L, func, -1, key == QLatin1String("name") ? "value for name" : key == QLatin1String("key") ? "value for key" : "value for tag")) {
+                    errorPushed = true;
+                    break;
                 }
 
-                mediaData.setMediaFileName(value);
-            } else if (key == QLatin1String("key") && !value.isEmpty()) {
-                mediaData.setMediaKey(value);
-            } else if (key == QLatin1String("tag") && !value.isEmpty()) {
-                mediaData.setMediaTag(value);
+                QString value{lua_tostring(L, -1)};
+
+                if (key == QLatin1String("name") && !value.isEmpty()) {
+                    if (QDir::homePath().contains('\\')) {
+                        value.replace('/', R"(\)");
+                    } else {
+                        value.replace('\\', "/");
+                    }
+
+                    mediaData.setMediaFileName(value);
+                } else if (key == QLatin1String("key") && !value.isEmpty()) {
+                    mediaData.setMediaKey(value);
+                } else if (key == QLatin1String("tag") && !value.isEmpty()) {
+                    mediaData.setMediaTag(value);
+                }
             }
+
+            // removes value, but keeps key for next iteration
+            lua_pop(L, 1);
         }
 
-        // removes value, but keeps key for next iteration
-        lua_pop(L, 1);
+        if (!errorPushed) {
+            mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
+            mediaData.setMediaType(TMediaData::MediaTypeMusic);
+
+            processPlayingMediaTable(L, mediaData);
+        }
     }
 
-    mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
-    mediaData.setMediaType(TMediaData::MediaTypeMusic);
+    if (errorPushed) {
+        return lua_error(L);
+    }
 
-    processPlayingMediaTable(L, mediaData);
     return 1;
 }
 
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#getPlayingMusic
 int TLuaInterpreter::getPlayingMusic(lua_State* L)
 {
-    TMediaData mediaData{};
-
     if (lua_gettop(L)) {
         if (lua_istable(L, 1)) {
             return getPlayingMusicAsTableArgument(L, __func__);
@@ -976,7 +1314,7 @@ int TLuaInterpreter::getPlayingMusic(lua_State* L)
         return getPlayingMusicAsOrderedArguments(L, __func__);
     }
 
-    // no args
+    TMediaData mediaData{};
     mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
     mediaData.setMediaType(TMediaData::MediaTypeMusic);
 
@@ -987,113 +1325,168 @@ int TLuaInterpreter::getPlayingMusic(lua_State* L)
 // Private
 int TLuaInterpreter::getPlayingSoundsAsOrderedArguments(lua_State* L, const char* func)
 {
-    TMediaData mediaData{};
     const int numArgs = lua_gettop(L);
-    QString stringValue;
-    int intValue = 0;
 
-    // values as ordered args: name[,key][,tag][,priority])
-    for (int i = 1; i <= numArgs; i++) {
-        if (lua_isnil(L, i)) {
-            continue;
+    bool errorPushed = false;
+    {
+        TMediaData mediaData{};
+        QString stringValue;
+        int intValue = 0;
+
+        // values as ordered args: name[,key][,tag][,priority])
+        for (int i = 1; i <= numArgs && !errorPushed; i++) {
+            if (lua_isnil(L, i)) {
+                continue;
+            }
+
+            switch (i) {
+            case 1:
+                if (!checkStringArg(L, func, i, "name")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                stringValue = lua_tostring(L, i);
+
+                if (QDir::homePath().contains('\\')) {
+                    stringValue.replace('/', R"(\)");
+                } else {
+                    stringValue.replace('\\', "/");
+                }
+
+                mediaData.setMediaFileName(stringValue);
+                break;
+            case 2:
+                if (!checkStringArg(L, func, i, "key")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaKey(QString{lua_tostring(L, i)});
+                break;
+            case 3:
+                if (!checkStringArg(L, func, i, "tag")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaTag(QString{lua_tostring(L, i)});
+                break;
+            case 4:
+                if (!checkIntArg(L, func, i, "priority")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                intValue = static_cast(lua_tointeger(L, i));
+
+                if (intValue > TMediaData::MediaPriorityMax) {
+                    intValue = TMediaData::MediaPriorityMax;
+                } else if (intValue < TMediaData::MediaPriorityMin) {
+                    intValue = TMediaData::MediaPriorityMin;
+                }
+
+                mediaData.setMediaPriority(intValue);
+                break;
+            }
         }
 
-        switch (i) {
-        case 1:
-            stringValue = getVerifiedString(L, func, i, "name");
+        if (!errorPushed) {
+            mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
+            mediaData.setMediaType(TMediaData::MediaTypeSound);
 
-            if (QDir::homePath().contains('\\')) {
-                stringValue.replace('/', R"(\)");
-            } else {
-                stringValue.replace('\\', "/");
-            }
-
-            mediaData.setMediaFileName(stringValue);
-            break;
-        case 2:
-            stringValue = getVerifiedString(L, func, i, "key");
-            mediaData.setMediaKey(stringValue);
-            break;
-        case 3:
-            stringValue = getVerifiedString(L, func, i, "tag");
-            mediaData.setMediaTag(stringValue);
-            break;
-        case 4:
-            intValue = getVerifiedInt(L, func, i, "priority");
-
-            if (intValue > TMediaData::MediaPriorityMax) {
-                intValue = TMediaData::MediaPriorityMax;
-            } else if (intValue < TMediaData::MediaPriorityMin) {
-                intValue = TMediaData::MediaPriorityMin;
-            }
-
-            mediaData.setMediaPriority(intValue);
-            break;
+            processPlayingMediaTable(L, mediaData);
         }
     }
 
-    mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
-    mediaData.setMediaType(TMediaData::MediaTypeSound);
+    if (errorPushed) {
+        return lua_error(L);
+    }
 
-    processPlayingMediaTable(L, mediaData);
     return 1;
 }
 
 // Private
 int TLuaInterpreter::getPlayingSoundsAsTableArgument(lua_State* L, const char* func)
 {
-    TMediaData mediaData{};
+    bool errorPushed = false;
+    {
+        TMediaData mediaData{};
 
-    lua_pushnil(L);
-    while (lua_next(L, 1) != 0) {
-        // key at index -2 and value at index -1
-        QString key = getVerifiedString(L, func, -2, "table keys");
-        key = key.toLower();
+        lua_pushnil(L);
+        while (lua_next(L, 1) != 0) {
+            // key at index -2 and value at index -1
+            if (!checkStringArg(L, func, -2, "table keys")) {
+                errorPushed = true;
+                break;
+            }
 
-        if (key == QLatin1String("name") || key == QLatin1String("key") || key == QLatin1String("tag")) {
-            QString value = getVerifiedString(L, func, -1, key == QLatin1String("name") ? "value for name" : key == QLatin1String("key") ? "value for key" : "value for tag");
+            // read the key from a copy: lua_tostring() on the slot itself converts a
+            // numeric key in place, which makes the next lua_next() fail
+            lua_pushvalue(L, -2);
+            const QString key = QString{lua_tostring(L, -1)}.toLower();
+            lua_pop(L, 1);
 
-            if (key == QLatin1String("name") && !value.isEmpty()) {
-                if (QDir::homePath().contains('\\')) {
-                    value.replace('/', R"(\)");
-                } else {
-                    value.replace('\\', "/");
+            if (key == QLatin1String("name") || key == QLatin1String("key") || key == QLatin1String("tag")) {
+                if (!checkStringArg(L, func, -1, key == QLatin1String("name") ? "value for name" : key == QLatin1String("key") ? "value for key" : "value for tag")) {
+                    errorPushed = true;
+                    break;
                 }
 
-                mediaData.setMediaFileName(value);
-            } else if (key == QLatin1String("key") && !value.isEmpty()) {
-                mediaData.setMediaKey(value);
-            } else if (key == QLatin1String("tag") && !value.isEmpty()) {
-                mediaData.setMediaTag(value);
-            }
-        } else if (key == QLatin1String("priority")) {
-            int value = getVerifiedInt(L, func, -1, "value for priority");
+                QString value{lua_tostring(L, -1)};
 
-            if (value > TMediaData::MediaPriorityMax) {
-                value = TMediaData::MediaPriorityMax;
-            } else if (value < TMediaData::MediaPriorityMin) {
-                value = TMediaData::MediaPriorityMin;
+                if (key == QLatin1String("name") && !value.isEmpty()) {
+                    if (QDir::homePath().contains('\\')) {
+                        value.replace('/', R"(\)");
+                    } else {
+                        value.replace('\\', "/");
+                    }
+
+                    mediaData.setMediaFileName(value);
+                } else if (key == QLatin1String("key") && !value.isEmpty()) {
+                    mediaData.setMediaKey(value);
+                } else if (key == QLatin1String("tag") && !value.isEmpty()) {
+                    mediaData.setMediaTag(value);
+                }
+            } else if (key == QLatin1String("priority")) {
+                if (!checkIntArg(L, func, -1, "value for priority")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                int value = static_cast(lua_tointeger(L, -1));
+
+                if (value > TMediaData::MediaPriorityMax) {
+                    value = TMediaData::MediaPriorityMax;
+                } else if (value < TMediaData::MediaPriorityMin) {
+                    value = TMediaData::MediaPriorityMin;
+                }
+
+                mediaData.setMediaPriority(value);
             }
 
-            mediaData.setMediaPriority(value);
+            // removes value, but keeps key for next iteration
+            lua_pop(L, 1);
         }
 
-        // removes value, but keeps key for next iteration
-        lua_pop(L, 1);
+        if (!errorPushed) {
+            mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
+            mediaData.setMediaType(TMediaData::MediaTypeSound);
+
+            processPlayingMediaTable(L, mediaData);
+        }
     }
 
-    mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
-    mediaData.setMediaType(TMediaData::MediaTypeSound);
+    if (errorPushed) {
+        return lua_error(L);
+    }
 
-    processPlayingMediaTable(L, mediaData);
     return 1;
 }
 
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#getPlayingSounds
 int TLuaInterpreter::getPlayingSounds(lua_State* L)
 {
-    TMediaData mediaData{};
-
     if (lua_gettop(L)) {
         if (lua_istable(L, 1)) {
             return getPlayingSoundsAsTableArgument(L, __func__);
@@ -1102,7 +1495,7 @@ int TLuaInterpreter::getPlayingSounds(lua_State* L)
         return getPlayingSoundsAsOrderedArguments(L, __func__);
     }
 
-    // no args
+    TMediaData mediaData{};
     mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
     mediaData.setMediaType(TMediaData::MediaTypeSound);
 
@@ -1113,48 +1506,69 @@ int TLuaInterpreter::getPlayingSounds(lua_State* L)
 // Private
 int TLuaInterpreter::getPlayingVideosAsTableArgument(lua_State* L, const char* func)
 {
-    TMediaData mediaData{};
+    bool errorPushed = false;
+    {
+        TMediaData mediaData{};
 
-    lua_pushnil(L);
-    while (lua_next(L, 1) != 0) {
-        // key at index -2 and value at index -1
-        QString key = getVerifiedString(L, func, -2, "table keys");
-        key = key.toLower();
+        lua_pushnil(L);
+        while (lua_next(L, 1) != 0) {
+            // key at index -2 and value at index -1
+            if (!checkStringArg(L, func, -2, "table keys")) {
+                errorPushed = true;
+                break;
+            }
 
-        if (key == QLatin1String("name") || key == QLatin1String("key") || key == QLatin1String("tag")) {
-            QString value = getVerifiedString(L, func, -1, key == QLatin1String("name") ? "value for name" : key == QLatin1String("key") ? "value for key" : "value for tag");
+            // read the key from a copy: lua_tostring() on the slot itself converts a
+            // numeric key in place, which makes the next lua_next() fail
+            lua_pushvalue(L, -2);
+            const QString key = QString{lua_tostring(L, -1)}.toLower();
+            lua_pop(L, 1);
 
-            if (key == QLatin1String("name") && !value.isEmpty()) {
-                if (QDir::homePath().contains('\\')) {
-                    value.replace('/', R"(\)");
-                } else {
-                    value.replace('\\', "/");
+            if (key == QLatin1String("name") || key == QLatin1String("key") || key == QLatin1String("tag")) {
+                if (!checkStringArg(L, func, -1, key == QLatin1String("name") ? "value for name" : key == QLatin1String("key") ? "value for key" : "value for tag")) {
+                    errorPushed = true;
+                    break;
                 }
 
-                mediaData.setMediaFileName(value);
-            } else if (key == QLatin1String("key") && !value.isEmpty()) {
-                mediaData.setMediaKey(value);
-            } else if (key == QLatin1String("tag") && !value.isEmpty()) {
-                mediaData.setMediaTag(value);
+                QString value{lua_tostring(L, -1)};
+
+                if (key == QLatin1String("name") && !value.isEmpty()) {
+                    if (QDir::homePath().contains('\\')) {
+                        value.replace('/', R"(\)");
+                    } else {
+                        value.replace('\\', "/");
+                    }
+
+                    mediaData.setMediaFileName(value);
+                } else if (key == QLatin1String("key") && !value.isEmpty()) {
+                    mediaData.setMediaKey(value);
+                } else if (key == QLatin1String("tag") && !value.isEmpty()) {
+                    mediaData.setMediaTag(value);
+                }
             }
+
+            // removes value, but keeps key for next iteration
+            lua_pop(L, 1);
         }
 
-        // removes value, but keeps key for next iteration
-        lua_pop(L, 1);
+        if (!errorPushed) {
+            mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
+            mediaData.setMediaType(TMediaData::MediaTypeVideo);
+
+            processPlayingMediaTable(L, mediaData);
+        }
     }
 
-    mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
-    mediaData.setMediaType(TMediaData::MediaTypeVideo);
+    if (errorPushed) {
+        return lua_error(L);
+    }
 
-    processPlayingMediaTable(L, mediaData);
     return 1;
 }
 
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#getPlayingVideos
 int TLuaInterpreter::getPlayingVideos(lua_State* L)
 {
-    TMediaData mediaData{};
-
     if (lua_gettop(L)) {
         if (!lua_istable(L, 1)) {
             lua_pushfstring(L, "%s: needs to be a table", __func__);
@@ -1164,7 +1578,7 @@ int TLuaInterpreter::getPlayingVideos(lua_State* L)
         return getPlayingVideosAsTableArgument(L, __func__);
     }
 
-    // no args
+    TMediaData mediaData{};
     mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
     mediaData.setMediaType(TMediaData::MediaTypeVideo);
 
@@ -1225,48 +1639,69 @@ void TLuaInterpreter::processPausedMediaTable(lua_State* L, TMediaData& mediaDat
 // Private
 int TLuaInterpreter::getPausedSoundsAsTableArgument(lua_State* L, const char* func)
 {
-    TMediaData mediaData{};
+    bool errorPushed = false;
+    {
+        TMediaData mediaData{};
 
-    lua_pushnil(L);
-    while (lua_next(L, 1) != 0) {
-        // key at index -2 and value at index -1
-        QString key = getVerifiedString(L, func, -2, "table keys");
-        key = key.toLower();
+        lua_pushnil(L);
+        while (lua_next(L, 1) != 0) {
+            // key at index -2 and value at index -1
+            if (!checkStringArg(L, func, -2, "table keys")) {
+                errorPushed = true;
+                break;
+            }
 
-        if (key == QLatin1String("name") || key == QLatin1String("key") || key == QLatin1String("tag")) {
-            QString value = getVerifiedString(L, func, -1, key == QLatin1String("name") ? "value for name" : key == QLatin1String("key") ? "value for key" : "value for tag");
+            // read the key from a copy: lua_tostring() on the slot itself converts a
+            // numeric key in place, which makes the next lua_next() fail
+            lua_pushvalue(L, -2);
+            const QString key = QString{lua_tostring(L, -1)}.toLower();
+            lua_pop(L, 1);
 
-            if (key == QLatin1String("name") && !value.isEmpty()) {
-                if (QDir::homePath().contains('\\')) {
-                    value.replace('/', R"(\)");
-                } else {
-                    value.replace('\\', "/");
+            if (key == QLatin1String("name") || key == QLatin1String("key") || key == QLatin1String("tag")) {
+                if (!checkStringArg(L, func, -1, key == QLatin1String("name") ? "value for name" : key == QLatin1String("key") ? "value for key" : "value for tag")) {
+                    errorPushed = true;
+                    break;
                 }
 
-                mediaData.setMediaFileName(value);
-            } else if (key == QLatin1String("key") && !value.isEmpty()) {
-                mediaData.setMediaKey(value);
-            } else if (key == QLatin1String("tag") && !value.isEmpty()) {
-                mediaData.setMediaTag(value);
+                QString value{lua_tostring(L, -1)};
+
+                if (key == QLatin1String("name") && !value.isEmpty()) {
+                    if (QDir::homePath().contains('\\')) {
+                        value.replace('/', R"(\)");
+                    } else {
+                        value.replace('\\', "/");
+                    }
+
+                    mediaData.setMediaFileName(value);
+                } else if (key == QLatin1String("key") && !value.isEmpty()) {
+                    mediaData.setMediaKey(value);
+                } else if (key == QLatin1String("tag") && !value.isEmpty()) {
+                    mediaData.setMediaTag(value);
+                }
             }
+
+            // removes value, but keeps key for next iteration
+            lua_pop(L, 1);
         }
 
-        // removes value, but keeps key for next iteration
-        lua_pop(L, 1);
+        if (!errorPushed) {
+            mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
+            mediaData.setMediaType(TMediaData::MediaTypeSound);
+
+            processPausedMediaTable(L, mediaData);
+        }
     }
 
-    mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
-    mediaData.setMediaType(TMediaData::MediaTypeSound);
+    if (errorPushed) {
+        return lua_error(L);
+    }
 
-    processPausedMediaTable(L, mediaData);
     return 1;
 }
 
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#getPausedSounds
 int TLuaInterpreter::getPausedSounds(lua_State* L)
 {
-    TMediaData mediaData{};
-
     if (lua_gettop(L)) {
         if (!lua_istable(L, 1)) {
             lua_pushfstring(L, "%s: needs to be a table", __func__);
@@ -1276,7 +1711,7 @@ int TLuaInterpreter::getPausedSounds(lua_State* L)
         return getPausedSoundsAsTableArgument(L, __func__);
     }
 
-    // no args
+    TMediaData mediaData{};
     mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
     mediaData.setMediaType(TMediaData::MediaTypeSound);
 
@@ -1287,48 +1722,69 @@ int TLuaInterpreter::getPausedSounds(lua_State* L)
 // Private
 int TLuaInterpreter::getPausedMusicAsTableArgument(lua_State* L, const char* func)
 {
-    TMediaData mediaData{};
+    bool errorPushed = false;
+    {
+        TMediaData mediaData{};
 
-    lua_pushnil(L);
-    while (lua_next(L, 1) != 0) {
-        // key at index -2 and value at index -1
-        QString key = getVerifiedString(L, func, -2, "table keys");
-        key = key.toLower();
+        lua_pushnil(L);
+        while (lua_next(L, 1) != 0) {
+            // key at index -2 and value at index -1
+            if (!checkStringArg(L, func, -2, "table keys")) {
+                errorPushed = true;
+                break;
+            }
 
-        if (key == QLatin1String("name") || key == QLatin1String("key") || key == QLatin1String("tag")) {
-            QString value = getVerifiedString(L, func, -1, key == QLatin1String("name") ? "value for name" : key == QLatin1String("key") ? "value for key" : "value for tag");
+            // read the key from a copy: lua_tostring() on the slot itself converts a
+            // numeric key in place, which makes the next lua_next() fail
+            lua_pushvalue(L, -2);
+            const QString key = QString{lua_tostring(L, -1)}.toLower();
+            lua_pop(L, 1);
 
-            if (key == QLatin1String("name") && !value.isEmpty()) {
-                if (QDir::homePath().contains('\\')) {
-                    value.replace('/', R"(\)");
-                } else {
-                    value.replace('\\', "/");
+            if (key == QLatin1String("name") || key == QLatin1String("key") || key == QLatin1String("tag")) {
+                if (!checkStringArg(L, func, -1, key == QLatin1String("name") ? "value for name" : key == QLatin1String("key") ? "value for key" : "value for tag")) {
+                    errorPushed = true;
+                    break;
                 }
 
-                mediaData.setMediaFileName(value);
-            } else if (key == QLatin1String("key") && !value.isEmpty()) {
-                mediaData.setMediaKey(value);
-            } else if (key == QLatin1String("tag") && !value.isEmpty()) {
-                mediaData.setMediaTag(value);
+                QString value{lua_tostring(L, -1)};
+
+                if (key == QLatin1String("name") && !value.isEmpty()) {
+                    if (QDir::homePath().contains('\\')) {
+                        value.replace('/', R"(\)");
+                    } else {
+                        value.replace('\\', "/");
+                    }
+
+                    mediaData.setMediaFileName(value);
+                } else if (key == QLatin1String("key") && !value.isEmpty()) {
+                    mediaData.setMediaKey(value);
+                } else if (key == QLatin1String("tag") && !value.isEmpty()) {
+                    mediaData.setMediaTag(value);
+                }
             }
+
+            // removes value, but keeps key for next iteration
+            lua_pop(L, 1);
         }
 
-        // removes value, but keeps key for next iteration
-        lua_pop(L, 1);
+        if (!errorPushed) {
+            mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
+            mediaData.setMediaType(TMediaData::MediaTypeMusic);
+
+            processPausedMediaTable(L, mediaData);
+        }
     }
 
-    mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
-    mediaData.setMediaType(TMediaData::MediaTypeMusic);
+    if (errorPushed) {
+        return lua_error(L);
+    }
 
-    processPausedMediaTable(L, mediaData);
     return 1;
 }
 
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#getPausedMusic
 int TLuaInterpreter::getPausedMusic(lua_State* L)
 {
-    TMediaData mediaData{};
-
     if (lua_gettop(L)) {
         if (!lua_istable(L, 1)) {
             lua_pushfstring(L, "%s: needs to be a table", __func__);
@@ -1338,7 +1794,7 @@ int TLuaInterpreter::getPausedMusic(lua_State* L)
         return getPausedMusicAsTableArgument(L, __func__);
     }
 
-    // no args
+    TMediaData mediaData{};
     mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
     mediaData.setMediaType(TMediaData::MediaTypeMusic);
 
@@ -1349,48 +1805,69 @@ int TLuaInterpreter::getPausedMusic(lua_State* L)
 // Private
 int TLuaInterpreter::getPausedVideosAsTableArgument(lua_State* L, const char* func)
 {
-    TMediaData mediaData{};
+    bool errorPushed = false;
+    {
+        TMediaData mediaData{};
 
-    lua_pushnil(L);
-    while (lua_next(L, 1) != 0) {
-        // key at index -2 and value at index -1
-        QString key = getVerifiedString(L, func, -2, "table keys");
-        key = key.toLower();
+        lua_pushnil(L);
+        while (lua_next(L, 1) != 0) {
+            // key at index -2 and value at index -1
+            if (!checkStringArg(L, func, -2, "table keys")) {
+                errorPushed = true;
+                break;
+            }
 
-        if (key == QLatin1String("name") || key == QLatin1String("key") || key == QLatin1String("tag")) {
-            QString value = getVerifiedString(L, func, -1, key == QLatin1String("name") ? "value for name" : key == QLatin1String("key") ? "value for key" : "value for tag");
+            // read the key from a copy: lua_tostring() on the slot itself converts a
+            // numeric key in place, which makes the next lua_next() fail
+            lua_pushvalue(L, -2);
+            const QString key = QString{lua_tostring(L, -1)}.toLower();
+            lua_pop(L, 1);
 
-            if (key == QLatin1String("name") && !value.isEmpty()) {
-                if (QDir::homePath().contains('\\')) {
-                    value.replace('/', R"(\)");
-                } else {
-                    value.replace('\\', "/");
+            if (key == QLatin1String("name") || key == QLatin1String("key") || key == QLatin1String("tag")) {
+                if (!checkStringArg(L, func, -1, key == QLatin1String("name") ? "value for name" : key == QLatin1String("key") ? "value for key" : "value for tag")) {
+                    errorPushed = true;
+                    break;
                 }
 
-                mediaData.setMediaFileName(value);
-            } else if (key == QLatin1String("key") && !value.isEmpty()) {
-                mediaData.setMediaKey(value);
-            } else if (key == QLatin1String("tag") && !value.isEmpty()) {
-                mediaData.setMediaTag(value);
+                QString value{lua_tostring(L, -1)};
+
+                if (key == QLatin1String("name") && !value.isEmpty()) {
+                    if (QDir::homePath().contains('\\')) {
+                        value.replace('/', R"(\)");
+                    } else {
+                        value.replace('\\', "/");
+                    }
+
+                    mediaData.setMediaFileName(value);
+                } else if (key == QLatin1String("key") && !value.isEmpty()) {
+                    mediaData.setMediaKey(value);
+                } else if (key == QLatin1String("tag") && !value.isEmpty()) {
+                    mediaData.setMediaTag(value);
+                }
             }
+
+            // removes value, but keeps key for next iteration
+            lua_pop(L, 1);
         }
 
-        // removes value, but keeps key for next iteration
-        lua_pop(L, 1);
+        if (!errorPushed) {
+            mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
+            mediaData.setMediaType(TMediaData::MediaTypeVideo);
+
+            processPausedMediaTable(L, mediaData);
+        }
     }
 
-    mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
-    mediaData.setMediaType(TMediaData::MediaTypeVideo);
+    if (errorPushed) {
+        return lua_error(L);
+    }
 
-    processPausedMediaTable(L, mediaData);
     return 1;
 }
 
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#getPausedVideos
 int TLuaInterpreter::getPausedVideos(lua_State* L)
 {
-    TMediaData mediaData{};
-
     if (lua_gettop(L)) {
         if (!lua_istable(L, 1)) {
             lua_pushfstring(L, "%s: needs to be a table", __func__);
@@ -1400,7 +1877,7 @@ int TLuaInterpreter::getPausedVideos(lua_State* L)
         return getPausedVideosAsTableArgument(L, __func__);
     }
 
-    // no args
+    TMediaData mediaData{};
     mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
     mediaData.setMediaType(TMediaData::MediaTypeVideo);
 
@@ -1412,59 +1889,92 @@ int TLuaInterpreter::getPausedVideos(lua_State* L)
 int TLuaInterpreter::stopMusicAsOrderedArguments(lua_State* L, const char* func)
 {
     const Host& host = getHostFromLua(L);
-    TMediaData mediaData{};
     const int numArgs = lua_gettop(L);
-    QString stringValue;
-    bool boolValue;
-    int intValue;
 
-    // values as ordered args: name[,key][,tag][,fadeaway][,fadeout]
-    for (int i = 1; i <= numArgs; i++) {
-        if (lua_isnil(L, i)) {
-            continue;
+    bool errorPushed = false;
+    {
+        TMediaData mediaData{};
+        QString stringValue;
+        int intValue = 0;
+
+        // values as ordered args: name[,key][,tag][,fadeaway][,fadeout]
+        for (int i = 1; i <= numArgs && !errorPushed; i++) {
+            if (lua_isnil(L, i)) {
+                continue;
+            }
+
+            switch (i) {
+            case 1:
+                if (!checkStringArg(L, func, i, "name")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                stringValue = lua_tostring(L, i);
+
+                if (QDir::homePath().contains('\\')) {
+                    stringValue.replace('/', R"(\)");
+                } else {
+                    stringValue.replace('\\', "/");
+                }
+
+                mediaData.setMediaFileName(stringValue);
+                break;
+            case 2:
+                if (!checkStringArg(L, func, i, "key")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaKey(QString{lua_tostring(L, i)});
+                break;
+            case 3:
+                if (!checkStringArg(L, func, i, "tag")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaTag(QString{lua_tostring(L, i)});
+                break;
+            case 4:
+                if (!checkBoolArg(L, func, i, "fadeaway")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaFadeAway(lua_toboolean(L, i));
+                break;
+            case 5:
+                if (!checkIntArg(L, func, i, "fadeout")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                intValue = static_cast(lua_tointeger(L, i));
+
+                if (intValue < 0) {
+                    lua_pushfstring(L, "stopMusic: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "fadeout", intValue);
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaFadeOut(intValue);
+                break;
+            }
         }
 
-        switch (i) {
-        case 1:
-            stringValue = getVerifiedString(L, func, i, "name");
+        if (!errorPushed) {
+            mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
+            mediaData.setMediaType(TMediaData::MediaTypeMusic);
 
-            if (QDir::homePath().contains('\\')) {
-                stringValue.replace('/', R"(\)");
-            } else {
-                stringValue.replace('\\', "/");
-            }
-
-            mediaData.setMediaFileName(stringValue);
-            break;
-        case 2:
-            stringValue = getVerifiedString(L, func, i, "key");
-            mediaData.setMediaKey(stringValue);
-            break;
-        case 3:
-            stringValue = getVerifiedString(L, func, i, "tag");
-            mediaData.setMediaTag(stringValue);
-            break;
-        case 4:
-            boolValue = getVerifiedBool(L, func, i, "fadeaway");
-            mediaData.setMediaFadeAway(boolValue);
-            break;
-        case 5:
-            intValue = getVerifiedInt(L, func, i, "fadeout");
-
-            if (intValue < 0) {
-                lua_pushfstring(L, "stopMusic: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "fadeout", intValue);
-                return lua_error(L);
-            }
-
-            mediaData.setMediaFadeOut(intValue);
-            break;
+            host.mpMedia->stopMedia(mediaData);
         }
     }
 
-    mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
-    mediaData.setMediaType(TMediaData::MediaTypeMusic);
+    if (errorPushed) {
+        return lua_error(L);
+    }
 
-    host.mpMedia->stopMedia(mediaData);
     lua_pushboolean(L, true);
     return 1;
 }
@@ -1473,52 +1983,86 @@ int TLuaInterpreter::stopMusicAsOrderedArguments(lua_State* L, const char* func)
 int TLuaInterpreter::stopMusicAsTableArgument(lua_State* L, const char* func)
 {
     const Host& host = getHostFromLua(L);
-    TMediaData mediaData{};
 
-    lua_pushnil(L);
-    while (lua_next(L, 1) != 0) {
-        // key at index -2 and value at index -1
-        QString key = getVerifiedString(L, func, -2, "table keys");
-        key = key.toLower();
+    bool errorPushed = false;
+    {
+        TMediaData mediaData{};
 
-        if (key == QLatin1String("name") || key == QLatin1String("key") || key == QLatin1String("tag")) {
-            QString value = getVerifiedString(L, func, -1, key == QLatin1String("name") ? "value for name" : key == QLatin1String("key") ? "value for key" : "value for tag");
+        lua_pushnil(L);
+        while (lua_next(L, 1) != 0) {
+            // key at index -2 and value at index -1
+            if (!checkStringArg(L, func, -2, "table keys")) {
+                errorPushed = true;
+                break;
+            }
 
-            if (key == QLatin1String("name") && !value.isEmpty()) {
-                if (QDir::homePath().contains('\\')) {
-                    value.replace('/', R"(\)");
-                } else {
-                    value.replace('\\', "/");
+            // read the key from a copy: lua_tostring() on the slot itself converts a
+            // numeric key in place, which makes the next lua_next() fail
+            lua_pushvalue(L, -2);
+            const QString key = QString{lua_tostring(L, -1)}.toLower();
+            lua_pop(L, 1);
+
+            if (key == QLatin1String("name") || key == QLatin1String("key") || key == QLatin1String("tag")) {
+                if (!checkStringArg(L, func, -1, key == QLatin1String("name") ? "value for name" : key == QLatin1String("key") ? "value for key" : "value for tag")) {
+                    errorPushed = true;
+                    break;
                 }
 
-                mediaData.setMediaFileName(value);
-            } else if (key == QLatin1String("key") && !value.isEmpty()) {
-                mediaData.setMediaKey(value);
-            } else if (key == QLatin1String("tag") && !value.isEmpty()) {
-                mediaData.setMediaTag(value);
-            }
-        } else if (key == QLatin1String("fadeaway")) {
-            const bool value = getVerifiedBool(L, func, -1, "value for fadeaway");
-            mediaData.setMediaFadeAway(value);
-        } else if (key == QLatin1String("fadeout")) {
-            int value = getVerifiedInt(L, func, -1, "value for fadeout");
+                QString value{lua_tostring(L, -1)};
 
-            if (value < 0) {
-                lua_pushfstring(L, "stopMusic: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "fadeout", value);
-                return lua_error(L);
+                if (key == QLatin1String("name") && !value.isEmpty()) {
+                    if (QDir::homePath().contains('\\')) {
+                        value.replace('/', R"(\)");
+                    } else {
+                        value.replace('\\', "/");
+                    }
+
+                    mediaData.setMediaFileName(value);
+                } else if (key == QLatin1String("key") && !value.isEmpty()) {
+                    mediaData.setMediaKey(value);
+                } else if (key == QLatin1String("tag") && !value.isEmpty()) {
+                    mediaData.setMediaTag(value);
+                }
+            } else if (key == QLatin1String("fadeaway")) {
+                if (!checkBoolArg(L, func, -1, "value for fadeaway")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaFadeAway(lua_toboolean(L, -1));
+            } else if (key == QLatin1String("fadeout")) {
+                if (!checkIntArg(L, func, -1, "value for fadeout")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                const int value = static_cast(lua_tointeger(L, -1));
+
+                if (value < 0) {
+                    lua_pushfstring(L, "stopMusic: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "fadeout", value);
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaFadeOut(value);
             }
 
-            mediaData.setMediaFadeOut(value);
+            // removes value, but keeps key for next iteration
+            lua_pop(L, 1);
         }
 
-        // removes value, but keeps key for next iteration
-        lua_pop(L, 1);
+        if (!errorPushed) {
+            mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
+            mediaData.setMediaType(TMediaData::MediaTypeMusic);
+
+            host.mpMedia->stopMedia(mediaData);
+        }
     }
 
-    mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
-    mediaData.setMediaType(TMediaData::MediaTypeMusic);
+    if (errorPushed) {
+        return lua_error(L);
+    }
 
-    host.mpMedia->stopMedia(mediaData);
     lua_pushboolean(L, true);
     return 1;
 }
@@ -1527,7 +2071,6 @@ int TLuaInterpreter::stopMusicAsTableArgument(lua_State* L, const char* func)
 int TLuaInterpreter::stopMusic(lua_State* L)
 {
     const Host& host = getHostFromLua(L);
-    TMediaData mediaData{};
 
     if (lua_gettop(L)) {
         if (lua_istable(L, 1)) {
@@ -1537,7 +2080,7 @@ int TLuaInterpreter::stopMusic(lua_State* L)
         return stopMusicAsOrderedArguments(L, __func__);
     }
 
-    // no args
+    TMediaData mediaData{};
     mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
     mediaData.setMediaType(TMediaData::MediaTypeMusic);
 
@@ -1550,70 +2093,108 @@ int TLuaInterpreter::stopMusic(lua_State* L)
 int TLuaInterpreter::stopSoundsAsOrderedArguments(lua_State* L, const char* func)
 {
     const Host& host = getHostFromLua(L);
-    TMediaData mediaData{};
     const int numArgs = lua_gettop(L);
-    QString stringValue;
-    bool boolValue;
-    int intValue = 0;
 
-    // values as ordered args: name[,key][,tag][,priority][,fadeaway][,fadeout])
-    for (int i = 1; i <= numArgs; i++) {
-        if (lua_isnil(L, i)) {
-            continue;
+    bool errorPushed = false;
+    {
+        TMediaData mediaData{};
+        QString stringValue;
+        int intValue = 0;
+
+        // values as ordered args: name[,key][,tag][,priority][,fadeaway][,fadeout])
+        for (int i = 1; i <= numArgs && !errorPushed; i++) {
+            if (lua_isnil(L, i)) {
+                continue;
+            }
+
+            switch (i) {
+            case 1:
+                if (!checkStringArg(L, func, i, "name")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                stringValue = lua_tostring(L, i);
+
+                if (QDir::homePath().contains('\\')) {
+                    stringValue.replace('/', R"(\)");
+                } else {
+                    stringValue.replace('\\', "/");
+                }
+
+                mediaData.setMediaFileName(stringValue);
+                break;
+            case 2:
+                if (!checkStringArg(L, func, i, "key")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaKey(QString{lua_tostring(L, i)});
+                break;
+            case 3:
+                if (!checkStringArg(L, func, i, "tag")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaTag(QString{lua_tostring(L, i)});
+                break;
+            case 4:
+                if (!checkIntArg(L, func, i, "priority")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                intValue = static_cast(lua_tointeger(L, i));
+
+                if (intValue > TMediaData::MediaPriorityMax) {
+                    intValue = TMediaData::MediaPriorityMax;
+                } else if (intValue < TMediaData::MediaPriorityMin) {
+                    intValue = TMediaData::MediaPriorityMin;
+                }
+
+                mediaData.setMediaPriority(intValue);
+                break;
+            case 5:
+                if (!checkBoolArg(L, func, i, "fadeaway")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaFadeAway(lua_toboolean(L, i));
+                break;
+            case 6:
+                if (!checkIntArg(L, func, i, "fadeout")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                intValue = static_cast(lua_tointeger(L, i));
+
+                if (intValue < 0) {
+                    lua_pushfstring(L, "stopSounds: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "fadeout", intValue);
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaFadeOut(intValue);
+                break;
+            }
         }
 
-        switch (i) {
-        case 1:
-            stringValue = getVerifiedString(L, func, i, "name");
+        if (!errorPushed) {
+            mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
+            mediaData.setMediaType(TMediaData::MediaTypeSound);
 
-            if (QDir::homePath().contains('\\')) {
-                stringValue.replace('/', R"(\)");
-            } else {
-                stringValue.replace('\\', "/");
-            }
-
-            mediaData.setMediaFileName(stringValue);
-            break;
-        case 2:
-            stringValue = getVerifiedString(L, func, i, "key");
-            mediaData.setMediaKey(stringValue);
-            break;
-        case 3:
-            stringValue = getVerifiedString(L, func, i, "tag");
-            mediaData.setMediaTag(stringValue);
-            break;
-        case 4:
-            intValue = getVerifiedInt(L, func, i, "priority");
-
-            if (intValue > TMediaData::MediaPriorityMax) {
-                intValue = TMediaData::MediaPriorityMax;
-            } else if (intValue < TMediaData::MediaPriorityMin) {
-                intValue = TMediaData::MediaPriorityMin;
-            }
-
-            mediaData.setMediaPriority(intValue);
-            break;
-        case 5:
-            boolValue = getVerifiedBool(L, func, i, "fadeaway");
-            mediaData.setMediaFadeAway(boolValue);
-            break;
-        case 6:
-            intValue = getVerifiedInt(L, func, i, "fadeout");
-
-            if (intValue < 0) {
-                lua_pushfstring(L, "stopSounds: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "fadeout", intValue);
-                return lua_error(L);
-            }
-
-            mediaData.setMediaFadeOut(intValue);
-            break;
+            host.mpMedia->stopMedia(mediaData);
         }
     }
 
-    mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
-    mediaData.setMediaType(TMediaData::MediaTypeSound);
+    if (errorPushed) {
+        return lua_error(L);
+    }
 
-    host.mpMedia->stopMedia(mediaData);
     lua_pushboolean(L, true);
     return 1;
 }
@@ -1622,34 +2203,54 @@ int TLuaInterpreter::stopSoundsAsOrderedArguments(lua_State* L, const char* func
 int TLuaInterpreter::stopSoundsAsTableArgument(lua_State* L, const char* func)
 {
     const Host& host = getHostFromLua(L);
-    TMediaData mediaData{};
 
-    lua_pushnil(L);
-    while (lua_next(L, 1) != 0) {
-        // key at index -2 and value at index -1
-        QString key = getVerifiedString(L, func, -2, "table keys");
-        key = key.toLower();
+    bool errorPushed = false;
+    {
+        TMediaData mediaData{};
 
-        if (key == QLatin1String("name") || key == QLatin1String("key") || key == QLatin1String("tag")) {
-            QString value = getVerifiedString(L, func, -1, key == QLatin1String("name") ? "value for name" : key == QLatin1String("key") ? "value for key" : "value for tag");
+        lua_pushnil(L);
+        while (lua_next(L, 1) != 0) {
+            // key at index -2 and value at index -1
+            if (!checkStringArg(L, func, -2, "table keys")) {
+                errorPushed = true;
+                break;
+            }
 
-            if (key == QLatin1String("name") && !value.isEmpty()) {
-                if (QDir::homePath().contains('\\')) {
-                    value.replace('/', R"(\)");
-                } else {
-                    value.replace('\\', "/");
+            // read the key from a copy: lua_tostring() on the slot itself converts a
+            // numeric key in place, which makes the next lua_next() fail
+            lua_pushvalue(L, -2);
+            const QString key = QString{lua_tostring(L, -1)}.toLower();
+            lua_pop(L, 1);
+
+            if (key == QLatin1String("name") || key == QLatin1String("key") || key == QLatin1String("tag")) {
+                if (!checkStringArg(L, func, -1, key == QLatin1String("name") ? "value for name" : key == QLatin1String("key") ? "value for key" : "value for tag")) {
+                    errorPushed = true;
+                    break;
                 }
 
-                mediaData.setMediaFileName(value);
-            } else if (key == QLatin1String("key") && !value.isEmpty()) {
-                mediaData.setMediaKey(value);
-            } else if (key == QLatin1String("tag") && !value.isEmpty()) {
-                mediaData.setMediaTag(value);
-            }
-        } else if (key == QLatin1String("priority")) {
-            int value = getVerifiedInt(L, func, -1, "value for priority");
+                QString value{lua_tostring(L, -1)};
+
+                if (key == QLatin1String("name") && !value.isEmpty()) {
+                    if (QDir::homePath().contains('\\')) {
+                        value.replace('/', R"(\)");
+                    } else {
+                        value.replace('\\', "/");
+                    }
+
+                    mediaData.setMediaFileName(value);
+                } else if (key == QLatin1String("key") && !value.isEmpty()) {
+                    mediaData.setMediaKey(value);
+                } else if (key == QLatin1String("tag") && !value.isEmpty()) {
+                    mediaData.setMediaTag(value);
+                }
+            } else if (key == QLatin1String("priority")) {
+                if (!checkIntArg(L, func, -1, "value for priority")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                int value = static_cast(lua_tointeger(L, -1));
 
-            if (key == QLatin1String("priority")) {
                 if (value > TMediaData::MediaPriorityMax) {
                     value = TMediaData::MediaPriorityMax;
                 } else if (value < TMediaData::MediaPriorityMin) {
@@ -1657,29 +2258,46 @@ int TLuaInterpreter::stopSoundsAsTableArgument(lua_State* L, const char* func)
                 }
 
                 mediaData.setMediaPriority(value);
-            }
-        } else if (key == QLatin1String("fadeaway")) {
-            const bool value = getVerifiedBool(L, func, -1, "value for fadeaway");
-            mediaData.setMediaFadeAway(value);
-        } else if (key == QLatin1String("fadeout")) {
-            int value = getVerifiedInt(L, func, -1, "value for fadeout");
+            } else if (key == QLatin1String("fadeaway")) {
+                if (!checkBoolArg(L, func, -1, "value for fadeaway")) {
+                    errorPushed = true;
+                    break;
+                }
 
-            if (value < 0) {
-                lua_pushfstring(L, "stopSounds: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "fadeout", value);
-                return lua_error(L);
+                mediaData.setMediaFadeAway(lua_toboolean(L, -1));
+            } else if (key == QLatin1String("fadeout")) {
+                if (!checkIntArg(L, func, -1, "value for fadeout")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                const int value = static_cast(lua_tointeger(L, -1));
+
+                if (value < 0) {
+                    lua_pushfstring(L, "stopSounds: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "fadeout", value);
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaFadeOut(value);
             }
 
-            mediaData.setMediaFadeOut(value);
+            // removes value, but keeps key for next iteration
+            lua_pop(L, 1);
         }
 
-        // removes value, but keeps key for next iteration
-        lua_pop(L, 1);
+        if (!errorPushed) {
+            mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
+            mediaData.setMediaType(TMediaData::MediaTypeSound);
+
+            host.mpMedia->stopMedia(mediaData);
+        }
     }
 
-    mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
-    mediaData.setMediaType(TMediaData::MediaTypeSound);
+    if (errorPushed) {
+        return lua_error(L);
+    }
 
-    host.mpMedia->stopMedia(mediaData);
     lua_pushboolean(L, true);
     return 1;
 }
@@ -1688,7 +2306,6 @@ int TLuaInterpreter::stopSoundsAsTableArgument(lua_State* L, const char* func)
 int TLuaInterpreter::stopSounds(lua_State* L)
 {
     const Host& host = getHostFromLua(L);
-    TMediaData mediaData{};
 
     if (lua_gettop(L)) {
         if (lua_istable(L, 1)) {
@@ -1698,7 +2315,7 @@ int TLuaInterpreter::stopSounds(lua_State* L)
         return stopSoundsAsOrderedArguments(L, __func__);
     }
 
-    // no args
+    TMediaData mediaData{};
     mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
     mediaData.setMediaType(TMediaData::MediaTypeSound);
 
@@ -1711,52 +2328,86 @@ int TLuaInterpreter::stopSounds(lua_State* L)
 int TLuaInterpreter::stopVideosAsTableArgument(lua_State* L, const char* func)
 {
     const Host& host = getHostFromLua(L);
-    TMediaData mediaData{};
 
-    lua_pushnil(L);
-    while (lua_next(L, 1) != 0) {
-        // key at index -2 and value at index -1
-        QString key = getVerifiedString(L, func, -2, "table keys");
-        key = key.toLower();
+    bool errorPushed = false;
+    {
+        TMediaData mediaData{};
 
-        if (key == QLatin1String("name") || key == QLatin1String("key") || key == QLatin1String("tag")) {
-            QString value = getVerifiedString(L, func, -1, key == QLatin1String("name") ? "value for name" : key == QLatin1String("key") ? "value for key" : "value for tag");
+        lua_pushnil(L);
+        while (lua_next(L, 1) != 0) {
+            // key at index -2 and value at index -1
+            if (!checkStringArg(L, func, -2, "table keys")) {
+                errorPushed = true;
+                break;
+            }
 
-            if (key == QLatin1String("name") && !value.isEmpty()) {
-                if (QDir::homePath().contains('\\')) {
-                    value.replace('/', R"(\)");
-                } else {
-                    value.replace('\\', "/");
+            // read the key from a copy: lua_tostring() on the slot itself converts a
+            // numeric key in place, which makes the next lua_next() fail
+            lua_pushvalue(L, -2);
+            const QString key = QString{lua_tostring(L, -1)}.toLower();
+            lua_pop(L, 1);
+
+            if (key == QLatin1String("name") || key == QLatin1String("key") || key == QLatin1String("tag")) {
+                if (!checkStringArg(L, func, -1, key == QLatin1String("name") ? "value for name" : key == QLatin1String("key") ? "value for key" : "value for tag")) {
+                    errorPushed = true;
+                    break;
                 }
 
-                mediaData.setMediaFileName(value);
-            } else if (key == QLatin1String("key") && !value.isEmpty()) {
-                mediaData.setMediaKey(value);
-            } else if (key == QLatin1String("tag") && !value.isEmpty()) {
-                mediaData.setMediaTag(value);
-            }
-        } else if (key == QLatin1String("fadeaway")) {
-            const bool value = getVerifiedBool(L, func, -1, "value for fadeaway");
-            mediaData.setMediaFadeAway(value);
-        } else if (key == QLatin1String("fadeout")) {
-            int value = getVerifiedInt(L, func, -1, "value for fadeout");
+                QString value{lua_tostring(L, -1)};
 
-            if (value < 0) {
-                lua_pushfstring(L, "stopVideos: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "fadeout", value);
-                return lua_error(L);
+                if (key == QLatin1String("name") && !value.isEmpty()) {
+                    if (QDir::homePath().contains('\\')) {
+                        value.replace('/', R"(\)");
+                    } else {
+                        value.replace('\\', "/");
+                    }
+
+                    mediaData.setMediaFileName(value);
+                } else if (key == QLatin1String("key") && !value.isEmpty()) {
+                    mediaData.setMediaKey(value);
+                } else if (key == QLatin1String("tag") && !value.isEmpty()) {
+                    mediaData.setMediaTag(value);
+                }
+            } else if (key == QLatin1String("fadeaway")) {
+                if (!checkBoolArg(L, func, -1, "value for fadeaway")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaFadeAway(lua_toboolean(L, -1));
+            } else if (key == QLatin1String("fadeout")) {
+                if (!checkIntArg(L, func, -1, "value for fadeout")) {
+                    errorPushed = true;
+                    break;
+                }
+
+                const int value = static_cast(lua_tointeger(L, -1));
+
+                if (value < 0) {
+                    lua_pushfstring(L, "stopVideos: bad argument range for %s (values must be greater than or equal to 0, got value: %d)", "fadeout", value);
+                    errorPushed = true;
+                    break;
+                }
+
+                mediaData.setMediaFadeOut(value);
             }
 
-            mediaData.setMediaFadeOut(value);
+            // removes value, but keeps key for next iteration
+            lua_pop(L, 1);
         }
 
-        // removes value, but keeps key for next iteration
-        lua_pop(L, 1);
+        if (!errorPushed) {
+            mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
+            mediaData.setMediaType(TMediaData::MediaTypeVideo);
+
+            host.mpMedia->stopMedia(mediaData);
+        }
     }
 
-    mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
-    mediaData.setMediaType(TMediaData::MediaTypeVideo);
+    if (errorPushed) {
+        return lua_error(L);
+    }
 
-    host.mpMedia->stopMedia(mediaData);
     lua_pushboolean(L, true);
     return 1;
 }
@@ -1765,7 +2416,6 @@ int TLuaInterpreter::stopVideosAsTableArgument(lua_State* L, const char* func)
 int TLuaInterpreter::stopVideos(lua_State* L)
 {
     const Host& host = getHostFromLua(L);
-    TMediaData mediaData{};
 
     if (lua_gettop(L)) {
         if (!lua_istable(L, 1)) {
@@ -1776,7 +2426,7 @@ int TLuaInterpreter::stopVideos(lua_State* L)
         return stopVideosAsTableArgument(L, __func__);
     }
 
-    // no args
+    TMediaData mediaData{};
     mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
     mediaData.setMediaType(TMediaData::MediaTypeVideo);
 
@@ -1789,40 +2439,64 @@ int TLuaInterpreter::stopVideos(lua_State* L)
 int TLuaInterpreter::pauseSoundsAsTableArgument(lua_State* L, const char* func)
 {
     const Host& host = getHostFromLua(L);
-    TMediaData mediaData{};
 
-    lua_pushnil(L);
-    while (lua_next(L, 1) != 0) {
-        // key at index -2 and value at index -1
-        QString key = getVerifiedString(L, func, -2, "table keys");
-        key = key.toLower();
+    bool errorPushed = false;
+    {
+        TMediaData mediaData{};
 
-        if (key == QLatin1String("name") || key == QLatin1String("key") || key == QLatin1String("tag")) {
-            QString value = getVerifiedString(L, func, -1, key == QLatin1String("name") ? "value for name" : key == QLatin1String("key") ? "value for key" : "value for tag");
+        lua_pushnil(L);
+        while (lua_next(L, 1) != 0) {
+            // key at index -2 and value at index -1
+            if (!checkStringArg(L, func, -2, "table keys")) {
+                errorPushed = true;
+                break;
+            }
 
-            if (key == QLatin1String("name") && !value.isEmpty()) {
-                if (QDir::homePath().contains('\\')) {
-                    value.replace('/', R"(\)");
-                } else {
-                    value.replace('\\', "/");
+            // read the key from a copy: lua_tostring() on the slot itself converts a
+            // numeric key in place, which makes the next lua_next() fail
+            lua_pushvalue(L, -2);
+            const QString key = QString{lua_tostring(L, -1)}.toLower();
+            lua_pop(L, 1);
+
+            if (key == QLatin1String("name") || key == QLatin1String("key") || key == QLatin1String("tag")) {
+                if (!checkStringArg(L, func, -1, key == QLatin1String("name") ? "value for name" : key == QLatin1String("key") ? "value for key" : "value for tag")) {
+                    errorPushed = true;
+                    break;
                 }
 
-                mediaData.setMediaFileName(value);
-            } else if (key == QLatin1String("key") && !value.isEmpty()) {
-                mediaData.setMediaKey(value);
-            } else if (key == QLatin1String("tag") && !value.isEmpty()) {
-                mediaData.setMediaTag(value);
+                QString value{lua_tostring(L, -1)};
+
+                if (key == QLatin1String("name") && !value.isEmpty()) {
+                    if (QDir::homePath().contains('\\')) {
+                        value.replace('/', R"(\)");
+                    } else {
+                        value.replace('\\', "/");
+                    }
+
+                    mediaData.setMediaFileName(value);
+                } else if (key == QLatin1String("key") && !value.isEmpty()) {
+                    mediaData.setMediaKey(value);
+                } else if (key == QLatin1String("tag") && !value.isEmpty()) {
+                    mediaData.setMediaTag(value);
+                }
             }
+
+            // removes value, but keeps key for next iteration
+            lua_pop(L, 1);
         }
 
-        // removes value, but keeps key for next iteration
-        lua_pop(L, 1);
+        if (!errorPushed) {
+            mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
+            mediaData.setMediaType(TMediaData::MediaTypeSound);
+
+            host.mpMedia->pauseMedia(mediaData);
+        }
     }
 
-    mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
-    mediaData.setMediaType(TMediaData::MediaTypeSound);
+    if (errorPushed) {
+        return lua_error(L);
+    }
 
-    host.mpMedia->pauseMedia(mediaData);
     lua_pushboolean(L, true);
     return 1;
 }
@@ -1831,7 +2505,6 @@ int TLuaInterpreter::pauseSoundsAsTableArgument(lua_State* L, const char* func)
 int TLuaInterpreter::pauseSounds(lua_State* L)
 {
     const Host& host = getHostFromLua(L);
-    TMediaData mediaData{};
 
     if (lua_gettop(L)) {
         if (!lua_istable(L, 1)) {
@@ -1842,7 +2515,7 @@ int TLuaInterpreter::pauseSounds(lua_State* L)
         return pauseSoundsAsTableArgument(L, __func__);
     }
 
-    // no args
+    TMediaData mediaData{};
     mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
     mediaData.setMediaType(TMediaData::MediaTypeSound);
 
@@ -1855,40 +2528,64 @@ int TLuaInterpreter::pauseSounds(lua_State* L)
 int TLuaInterpreter::pauseMusicAsTableArgument(lua_State* L, const char* func)
 {
     const Host& host = getHostFromLua(L);
-    TMediaData mediaData{};
 
-    lua_pushnil(L);
-    while (lua_next(L, 1) != 0) {
-        // key at index -2 and value at index -1
-        QString key = getVerifiedString(L, func, -2, "table keys");
-        key = key.toLower();
+    bool errorPushed = false;
+    {
+        TMediaData mediaData{};
 
-        if (key == QLatin1String("name") || key == QLatin1String("key") || key == QLatin1String("tag")) {
-            QString value = getVerifiedString(L, func, -1, key == QLatin1String("name") ? "value for name" : key == QLatin1String("key") ? "value for key" : "value for tag");
+        lua_pushnil(L);
+        while (lua_next(L, 1) != 0) {
+            // key at index -2 and value at index -1
+            if (!checkStringArg(L, func, -2, "table keys")) {
+                errorPushed = true;
+                break;
+            }
 
-            if (key == QLatin1String("name") && !value.isEmpty()) {
-                if (QDir::homePath().contains('\\')) {
-                    value.replace('/', R"(\)");
-                } else {
-                    value.replace('\\', "/");
+            // read the key from a copy: lua_tostring() on the slot itself converts a
+            // numeric key in place, which makes the next lua_next() fail
+            lua_pushvalue(L, -2);
+            const QString key = QString{lua_tostring(L, -1)}.toLower();
+            lua_pop(L, 1);
+
+            if (key == QLatin1String("name") || key == QLatin1String("key") || key == QLatin1String("tag")) {
+                if (!checkStringArg(L, func, -1, key == QLatin1String("name") ? "value for name" : key == QLatin1String("key") ? "value for key" : "value for tag")) {
+                    errorPushed = true;
+                    break;
                 }
 
-                mediaData.setMediaFileName(value);
-            } else if (key == QLatin1String("key") && !value.isEmpty()) {
-                mediaData.setMediaKey(value);
-            } else if (key == QLatin1String("tag") && !value.isEmpty()) {
-                mediaData.setMediaTag(value);
+                QString value{lua_tostring(L, -1)};
+
+                if (key == QLatin1String("name") && !value.isEmpty()) {
+                    if (QDir::homePath().contains('\\')) {
+                        value.replace('/', R"(\)");
+                    } else {
+                        value.replace('\\', "/");
+                    }
+
+                    mediaData.setMediaFileName(value);
+                } else if (key == QLatin1String("key") && !value.isEmpty()) {
+                    mediaData.setMediaKey(value);
+                } else if (key == QLatin1String("tag") && !value.isEmpty()) {
+                    mediaData.setMediaTag(value);
+                }
             }
+
+            // removes value, but keeps key for next iteration
+            lua_pop(L, 1);
         }
 
-        // removes value, but keeps key for next iteration
-        lua_pop(L, 1);
+        if (!errorPushed) {
+            mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
+            mediaData.setMediaType(TMediaData::MediaTypeMusic);
+
+            host.mpMedia->pauseMedia(mediaData);
+        }
     }
 
-    mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
-    mediaData.setMediaType(TMediaData::MediaTypeMusic);
+    if (errorPushed) {
+        return lua_error(L);
+    }
 
-    host.mpMedia->pauseMedia(mediaData);
     lua_pushboolean(L, true);
     return 1;
 }
@@ -1897,7 +2594,6 @@ int TLuaInterpreter::pauseMusicAsTableArgument(lua_State* L, const char* func)
 int TLuaInterpreter::pauseMusic(lua_State* L)
 {
     const Host& host = getHostFromLua(L);
-    TMediaData mediaData{};
 
     if (lua_gettop(L)) {
         if (!lua_istable(L, 1)) {
@@ -1908,7 +2604,7 @@ int TLuaInterpreter::pauseMusic(lua_State* L)
         return pauseMusicAsTableArgument(L, __func__);
     }
 
-    // no args
+    TMediaData mediaData{};
     mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
     mediaData.setMediaType(TMediaData::MediaTypeMusic);
 
@@ -1921,40 +2617,64 @@ int TLuaInterpreter::pauseMusic(lua_State* L)
 int TLuaInterpreter::pauseVideosAsTableArgument(lua_State* L, const char* func)
 {
     const Host& host = getHostFromLua(L);
-    TMediaData mediaData{};
 
-    lua_pushnil(L);
-    while (lua_next(L, 1) != 0) {
-        // key at index -2 and value at index -1
-        QString key = getVerifiedString(L, func, -2, "table keys");
-        key = key.toLower();
+    bool errorPushed = false;
+    {
+        TMediaData mediaData{};
 
-        if (key == QLatin1String("name") || key == QLatin1String("key") || key == QLatin1String("tag")) {
-            QString value = getVerifiedString(L, func, -1, key == QLatin1String("name") ? "value for name" : key == QLatin1String("key") ? "value for key" : "value for tag");
+        lua_pushnil(L);
+        while (lua_next(L, 1) != 0) {
+            // key at index -2 and value at index -1
+            if (!checkStringArg(L, func, -2, "table keys")) {
+                errorPushed = true;
+                break;
+            }
 
-            if (key == QLatin1String("name") && !value.isEmpty()) {
-                if (QDir::homePath().contains('\\')) {
-                    value.replace('/', R"(\)");
-                } else {
-                    value.replace('\\', "/");
+            // read the key from a copy: lua_tostring() on the slot itself converts a
+            // numeric key in place, which makes the next lua_next() fail
+            lua_pushvalue(L, -2);
+            const QString key = QString{lua_tostring(L, -1)}.toLower();
+            lua_pop(L, 1);
+
+            if (key == QLatin1String("name") || key == QLatin1String("key") || key == QLatin1String("tag")) {
+                if (!checkStringArg(L, func, -1, key == QLatin1String("name") ? "value for name" : key == QLatin1String("key") ? "value for key" : "value for tag")) {
+                    errorPushed = true;
+                    break;
                 }
 
-                mediaData.setMediaFileName(value);
-            } else if (key == QLatin1String("key") && !value.isEmpty()) {
-                mediaData.setMediaKey(value);
-            } else if (key == QLatin1String("tag") && !value.isEmpty()) {
-                mediaData.setMediaTag(value);
+                QString value{lua_tostring(L, -1)};
+
+                if (key == QLatin1String("name") && !value.isEmpty()) {
+                    if (QDir::homePath().contains('\\')) {
+                        value.replace('/', R"(\)");
+                    } else {
+                        value.replace('\\', "/");
+                    }
+
+                    mediaData.setMediaFileName(value);
+                } else if (key == QLatin1String("key") && !value.isEmpty()) {
+                    mediaData.setMediaKey(value);
+                } else if (key == QLatin1String("tag") && !value.isEmpty()) {
+                    mediaData.setMediaTag(value);
+                }
             }
+
+            // removes value, but keeps key for next iteration
+            lua_pop(L, 1);
         }
 
-        // removes value, but keeps key for next iteration
-        lua_pop(L, 1);
+        if (!errorPushed) {
+            mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
+            mediaData.setMediaType(TMediaData::MediaTypeVideo);
+
+            host.mpMedia->pauseMedia(mediaData);
+        }
     }
 
-    mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
-    mediaData.setMediaType(TMediaData::MediaTypeVideo);
+    if (errorPushed) {
+        return lua_error(L);
+    }
 
-    host.mpMedia->pauseMedia(mediaData);
     lua_pushboolean(L, true);
     return 1;
 }
@@ -1963,7 +2683,6 @@ int TLuaInterpreter::pauseVideosAsTableArgument(lua_State* L, const char* func)
 int TLuaInterpreter::pauseVideos(lua_State* L)
 {
     const Host& host = getHostFromLua(L);
-    TMediaData mediaData{};
 
     if (lua_gettop(L)) {
         if (!lua_istable(L, 1)) {
@@ -1974,7 +2693,7 @@ int TLuaInterpreter::pauseVideos(lua_State* L)
         return pauseVideosAsTableArgument(L, __func__);
     }
 
-    // no args
+    TMediaData mediaData{};
     mediaData.setMediaProtocol(TMediaData::MediaProtocolAPI);
     mediaData.setMediaType(TMediaData::MediaTypeVideo);
 
diff --git a/src/TLuaInterpreterMudletObjects.cpp b/src/TLuaInterpreterMudletObjects.cpp
index 955b9ae31..40baf4021 100644
--- a/src/TLuaInterpreterMudletObjects.cpp
+++ b/src/TLuaInterpreterMudletObjects.cpp
@@ -1112,22 +1112,31 @@ int TLuaInterpreter::killTrigger(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#permAlias
 int TLuaInterpreter::permAlias(lua_State* L)
 {
-    const QString name = getVerifiedString(L, __func__, 1, "alias name");
-    const QString parent = getVerifiedString(L, __func__, 2, "alias group/parent");
-    const QString regex = getVerifiedString(L, __func__, 3, "regexp pattern");
+    if (!checkStringArg(L, __func__, 1, "alias name") || !checkStringArg(L, __func__, 2, "alias group/parent") || !checkStringArg(L, __func__, 3, "regexp pattern")) {
+        return lua_error(L);
+    }
     Host& host = getHostFromLua(L);
     TLuaInterpreter* pLuaInterpreter = host.getLuaInterpreter();
     if (pLuaInterpreter->reportInvalidLuaCodeParam(L, "permAlias", 4)) {
         return lua_error(L);
     }
 
-    const QString script{lua_tostring(L, 4)};
-    auto [aliasId, message] = pLuaInterpreter->startPermAlias(name, parent, regex, script);
-    if (aliasId == -1) {
-        lua_pushfstring(L, "permAlias: cannot create alias (%s)", message.toUtf8().constData());
+    int id = -1;
+    {
+        const QString name{lua_tostring(L, 1)};
+        const QString parent{lua_tostring(L, 2)};
+        const QString regex{lua_tostring(L, 3)};
+        const QString script{lua_tostring(L, 4)};
+        auto [aliasId, message] = pLuaInterpreter->startPermAlias(name, parent, regex, script);
+        id = aliasId;
+        if (aliasId == -1) {
+            lua_pushfstring(L, "permAlias: cannot create alias (%s)", message.toUtf8().constData());
+        }
+    }
+    if (id == -1) {
         return lua_error(L);
     }
-    lua_pushnumber(L, aliasId);
+    lua_pushnumber(L, id);
     return 1;
 }
 
@@ -1136,193 +1145,243 @@ int TLuaInterpreter::permPromptTrigger(lua_State* L)
 {
     Host& host = getHostFromLua(L);
     TLuaInterpreter* pLuaInterpreter = host.getLuaInterpreter();
-    const QString triggerName = getVerifiedString(L, __func__, 1, "trigger name");
-    const QString parentName = getVerifiedString(L, __func__, 2, "parent trigger name");
+    if (!checkStringArg(L, __func__, 1, "trigger name") || !checkStringArg(L, __func__, 2, "parent trigger name")) {
+        return lua_error(L);
+    }
     if (pLuaInterpreter->reportInvalidLuaCodeParam(L, "permPromptTrigger", 3)) {
         return lua_error(L);
     }
-    const QString luaFunction = lua_tostring(L, 3);
 
-    auto [triggerID, message] = pLuaInterpreter->startPermPromptTrigger(triggerName, parentName, luaFunction);
-    if (triggerID == -1) {
-        lua_pushfstring(L, "permPromptTrigger: cannot create trigger (%s)", message.toUtf8().constData());
-        return lua_error(L);
-    }
-    lua_pushnumber(L, triggerID);
-    return 1;
-}
-
-// Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#permRegexTrigger
-int TLuaInterpreter::permRegexTrigger(lua_State* L)
-{
-    const QString name = getVerifiedString(L, __func__, 1, "trigger name");
-    const QString parent = getVerifiedString(L, __func__, 2, "trigger parent");
-
-    QStringList regList;
-    if (!lua_istable(L, 3)) {
-        lua_pushfstring(L, "permRegexTrigger: bad argument #3 type (sub-strings list as table expected, got %s!)", luaL_typename(L, 3));
-        return lua_error(L);
-    }
-    lua_pushnil(L);
-    while (lua_next(L, 3) != 0) {
-        // key at index -2 and value at index -1
-        if (lua_type(L, -1) == LUA_TSTRING) {
-            regList << lua_tostring(L, -1);
+    int id = -1;
+    {
+        const QString triggerName{lua_tostring(L, 1)};
+        const QString parentName{lua_tostring(L, 2)};
+        const QString luaFunction{lua_tostring(L, 3)};
+        auto [triggerID, message] = pLuaInterpreter->startPermPromptTrigger(triggerName, parentName, luaFunction);
+        id = triggerID;
+        if (triggerID == -1) {
+            lua_pushfstring(L, "permPromptTrigger: cannot create trigger (%s)", message.toUtf8().constData());
         }
-        // removes value, but keeps key for next iteration
-        lua_pop(L, 1);
     }
-
-    Host& host = getHostFromLua(L);
-    TLuaInterpreter* pLuaInterpreter = host.getLuaInterpreter();
-    if (pLuaInterpreter->reportInvalidLuaCodeParam(L, "permRegexTrigger", 4)) {
-        return lua_error(L);
-    }
-
-    const QString script{lua_tostring(L, 4)};
-    auto [triggerId, message] = pLuaInterpreter->startPermRegexTrigger(name, parent, regList, script);
-    if (triggerId == -1) {
-        lua_pushfstring(L, "permRegexTrigger: cannot create trigger (%s)", message.toUtf8().constData());
-        return lua_error(L);
-    }
-    lua_pushnumber(L, triggerId);
-    return 1;
-}
-
-// Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#permBeginOfLineStringTrigger
-int TLuaInterpreter::permBeginOfLineStringTrigger(lua_State* L)
-{
-    const QString name = getVerifiedString(L, __func__, 1, "trigger name");
-    const QString parent = getVerifiedString(L, __func__, 2, "trigger parent");
-
-    QStringList regList;
-    if (!lua_istable(L, 3)) {
-        lua_pushfstring(L, "permBeginOfLineStringTrigger: bad argument #3 type (sub-strings list as table expected, got %s!)", luaL_typename(L, 3));
-        return lua_error(L);
-    }
-    lua_pushnil(L);
-    while (lua_next(L, 3) != 0) {
-        // key at index -2 and value at index -1
-        if (lua_type(L, -1) == LUA_TSTRING) {
-            regList << lua_tostring(L, -1);
-        }
-        // removes value, but keeps key for next iteration
-        lua_pop(L, 1);
-    }
-
-    Host& host = getHostFromLua(L);
-    TLuaInterpreter* pLuaInterpreter = host.getLuaInterpreter();
-    if (pLuaInterpreter->reportInvalidLuaCodeParam(L, "permBeginOfLineStringTrigger", 4)) {
-        return lua_error(L);
-    }
-
-    const QString script{lua_tostring(L, 4)};
-    auto [triggerId, message] = pLuaInterpreter->startPermBeginOfLineStringTrigger(name, parent, regList, script);
-    if (triggerId == -1) {
-        lua_pushfstring(L, "permBeginOfLineStringTrigger: cannot create trigger (%s)", message.toUtf8().constData());
-        return lua_error(L);
-    }
-    lua_pushnumber(L, triggerId);
-    return 1;
-}
-
-// Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#permSubstringTrigger
-int TLuaInterpreter::permSubstringTrigger(lua_State* L)
-{
-    const QString name = getVerifiedString(L, __func__, 1, "trigger name");
-    const QString parent = getVerifiedString(L, __func__, 2, "trigger parent");
-    QStringList regList;
-    if (!lua_istable(L, 3)) {
-        lua_pushfstring(L, "permSubstringTrigger: bad argument #3 type (sub-strings list as table expected, got %s!)", luaL_typename(L, 3));
-        return lua_error(L);
-    }
-    lua_pushnil(L);
-    while (lua_next(L, 3) != 0) {
-        // key at index -2 and value at index -1
-        if (lua_type(L, -1) == LUA_TSTRING) {
-            regList << lua_tostring(L, -1);
-        }
-        // removes value, but keeps key for next iteration
-        lua_pop(L, 1);
-    }
-
-    Host& host = getHostFromLua(L);
-    TLuaInterpreter* pLuaInterpreter = host.getLuaInterpreter();
-    if (pLuaInterpreter->reportInvalidLuaCodeParam(L, "permSubstringTrigger", 4)) {
-        return lua_error(L);
-    }
-
-    const QString script{lua_tostring(L, 4)};
-    auto [triggerID, message] = pLuaInterpreter->startPermSubstringTrigger(name, parent, regList, script);
-    if (triggerID == -1) {
-        lua_pushfstring(L, "permSubstringTrigger: cannot create trigger (%s)", message.toUtf8().constData());
-        return lua_error(L);
-    }
-    lua_pushnumber(L, triggerID);
-    return 1;
-}
-
-// Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#permExactMatchTrigger
-int TLuaInterpreter::permExactMatchTrigger(lua_State* L)
-{
-    const QString name = getVerifiedString(L, __func__, 1, "trigger name");
-    const QString parent = getVerifiedString(L, __func__, 2, "trigger parent");
-    QStringList patternList;
-    if (!lua_istable(L, 3)) {
-        lua_pushfstring(L, "permExactMatchTrigger: bad argument #3 type (exact match patterns list as table expected, got %s!)", luaL_typename(L, 3));
-        return lua_error(L);
-    }
-    lua_pushnil(L);
-    while (lua_next(L, 3) != 0) {
-        // key at index -2 and value at index -1
-        if (lua_type(L, -1) == LUA_TSTRING) {
-            patternList << lua_tostring(L, -1);
-        }
-        // removes value, but keeps key for next iteration
-        lua_pop(L, 1);
-    }
-
-    Host& host = getHostFromLua(L);
-    TLuaInterpreter* pLuaInterpreter = host.getLuaInterpreter();
-    if (pLuaInterpreter->reportInvalidLuaCodeParam(L, "permExactMatchTrigger", 4)) {
-        return lua_error(L);
-    }
-
-    const QString script{lua_tostring(L, 4)};
-    auto [triggerID, message] = pLuaInterpreter->startPermExactMatchTrigger(name, parent, patternList, script);
-    if (triggerID == -1) {
-        lua_pushfstring(L, "permExactMatchTrigger: cannot create trigger (%s)", message.toUtf8().constData());
-        return lua_error(L);
-    }
-    lua_pushnumber(L, triggerID);
-    return 1;
-}
-
-// Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#permScript
-int TLuaInterpreter::permScript(lua_State* L)
-{
-    const QString name = getVerifiedString(L, __func__, 1, "script name");
-    const QString parent = getVerifiedString(L, __func__, 2, "script parent name");
-    Host& host = getHostFromLua(L);
-    TLuaInterpreter* pLuaInterpreter = host.getLuaInterpreter();
-    if (pLuaInterpreter->reportInvalidLuaCodeParam(L, "permScript", 3)) {
-        return lua_error(L);
-    }
-    const QString luaCode{lua_tostring(L, 3)};
-    auto [id, message] = pLuaInterpreter->createPermScript(name, parent, luaCode);
     if (id == -1) {
-        lua_pushfstring(L, "permScript: cannot create script (%s)", message.toUtf8().constData());
         return lua_error(L);
     }
     lua_pushnumber(L, id);
     return 1;
 }
 
+// Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#permRegexTrigger
+int TLuaInterpreter::permRegexTrigger(lua_State* L)
+{
+    if (!checkStringArg(L, __func__, 1, "trigger name") || !checkStringArg(L, __func__, 2, "trigger parent")) {
+        return lua_error(L);
+    }
+    if (!lua_istable(L, 3)) {
+        lua_pushfstring(L, "permRegexTrigger: bad argument #3 type (sub-strings list as table expected, got %s!)", luaL_typename(L, 3));
+        return lua_error(L);
+    }
+    Host& host = getHostFromLua(L);
+    TLuaInterpreter* pLuaInterpreter = host.getLuaInterpreter();
+    if (pLuaInterpreter->reportInvalidLuaCodeParam(L, "permRegexTrigger", 4)) {
+        return lua_error(L);
+    }
+
+    int id = -1;
+    {
+        QStringList regList;
+        lua_pushnil(L);
+        while (lua_next(L, 3) != 0) {
+            // key at index -2 and value at index -1
+            if (lua_type(L, -1) == LUA_TSTRING) {
+                regList << lua_tostring(L, -1);
+            }
+            // removes value, but keeps key for next iteration
+            lua_pop(L, 1);
+        }
+        const QString name{lua_tostring(L, 1)};
+        const QString parent{lua_tostring(L, 2)};
+        const QString script{lua_tostring(L, 4)};
+        auto [triggerId, message] = pLuaInterpreter->startPermRegexTrigger(name, parent, regList, script);
+        id = triggerId;
+        if (triggerId == -1) {
+            lua_pushfstring(L, "permRegexTrigger: cannot create trigger (%s)", message.toUtf8().constData());
+        }
+    }
+    if (id == -1) {
+        return lua_error(L);
+    }
+    lua_pushnumber(L, id);
+    return 1;
+}
+
+// Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#permBeginOfLineStringTrigger
+int TLuaInterpreter::permBeginOfLineStringTrigger(lua_State* L)
+{
+    if (!checkStringArg(L, __func__, 1, "trigger name") || !checkStringArg(L, __func__, 2, "trigger parent")) {
+        return lua_error(L);
+    }
+    if (!lua_istable(L, 3)) {
+        lua_pushfstring(L, "permBeginOfLineStringTrigger: bad argument #3 type (sub-strings list as table expected, got %s!)", luaL_typename(L, 3));
+        return lua_error(L);
+    }
+    Host& host = getHostFromLua(L);
+    TLuaInterpreter* pLuaInterpreter = host.getLuaInterpreter();
+    if (pLuaInterpreter->reportInvalidLuaCodeParam(L, "permBeginOfLineStringTrigger", 4)) {
+        return lua_error(L);
+    }
+
+    int id = -1;
+    {
+        QStringList regList;
+        lua_pushnil(L);
+        while (lua_next(L, 3) != 0) {
+            // key at index -2 and value at index -1
+            if (lua_type(L, -1) == LUA_TSTRING) {
+                regList << lua_tostring(L, -1);
+            }
+            // removes value, but keeps key for next iteration
+            lua_pop(L, 1);
+        }
+        const QString name{lua_tostring(L, 1)};
+        const QString parent{lua_tostring(L, 2)};
+        const QString script{lua_tostring(L, 4)};
+        auto [triggerId, message] = pLuaInterpreter->startPermBeginOfLineStringTrigger(name, parent, regList, script);
+        id = triggerId;
+        if (triggerId == -1) {
+            lua_pushfstring(L, "permBeginOfLineStringTrigger: cannot create trigger (%s)", message.toUtf8().constData());
+        }
+    }
+    if (id == -1) {
+        return lua_error(L);
+    }
+    lua_pushnumber(L, id);
+    return 1;
+}
+
+// Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#permSubstringTrigger
+int TLuaInterpreter::permSubstringTrigger(lua_State* L)
+{
+    if (!checkStringArg(L, __func__, 1, "trigger name") || !checkStringArg(L, __func__, 2, "trigger parent")) {
+        return lua_error(L);
+    }
+    if (!lua_istable(L, 3)) {
+        lua_pushfstring(L, "permSubstringTrigger: bad argument #3 type (sub-strings list as table expected, got %s!)", luaL_typename(L, 3));
+        return lua_error(L);
+    }
+    Host& host = getHostFromLua(L);
+    TLuaInterpreter* pLuaInterpreter = host.getLuaInterpreter();
+    if (pLuaInterpreter->reportInvalidLuaCodeParam(L, "permSubstringTrigger", 4)) {
+        return lua_error(L);
+    }
+
+    int id = -1;
+    {
+        QStringList regList;
+        lua_pushnil(L);
+        while (lua_next(L, 3) != 0) {
+            // key at index -2 and value at index -1
+            if (lua_type(L, -1) == LUA_TSTRING) {
+                regList << lua_tostring(L, -1);
+            }
+            // removes value, but keeps key for next iteration
+            lua_pop(L, 1);
+        }
+        const QString name{lua_tostring(L, 1)};
+        const QString parent{lua_tostring(L, 2)};
+        const QString script{lua_tostring(L, 4)};
+        auto [triggerID, message] = pLuaInterpreter->startPermSubstringTrigger(name, parent, regList, script);
+        id = triggerID;
+        if (triggerID == -1) {
+            lua_pushfstring(L, "permSubstringTrigger: cannot create trigger (%s)", message.toUtf8().constData());
+        }
+    }
+    if (id == -1) {
+        return lua_error(L);
+    }
+    lua_pushnumber(L, id);
+    return 1;
+}
+
+// Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#permExactMatchTrigger
+int TLuaInterpreter::permExactMatchTrigger(lua_State* L)
+{
+    if (!checkStringArg(L, __func__, 1, "trigger name") || !checkStringArg(L, __func__, 2, "trigger parent")) {
+        return lua_error(L);
+    }
+    if (!lua_istable(L, 3)) {
+        lua_pushfstring(L, "permExactMatchTrigger: bad argument #3 type (exact match patterns list as table expected, got %s!)", luaL_typename(L, 3));
+        return lua_error(L);
+    }
+    Host& host = getHostFromLua(L);
+    TLuaInterpreter* pLuaInterpreter = host.getLuaInterpreter();
+    if (pLuaInterpreter->reportInvalidLuaCodeParam(L, "permExactMatchTrigger", 4)) {
+        return lua_error(L);
+    }
+
+    int id = -1;
+    {
+        QStringList patternList;
+        lua_pushnil(L);
+        while (lua_next(L, 3) != 0) {
+            // key at index -2 and value at index -1
+            if (lua_type(L, -1) == LUA_TSTRING) {
+                patternList << lua_tostring(L, -1);
+            }
+            // removes value, but keeps key for next iteration
+            lua_pop(L, 1);
+        }
+        const QString name{lua_tostring(L, 1)};
+        const QString parent{lua_tostring(L, 2)};
+        const QString script{lua_tostring(L, 4)};
+        auto [triggerID, message] = pLuaInterpreter->startPermExactMatchTrigger(name, parent, patternList, script);
+        id = triggerID;
+        if (triggerID == -1) {
+            lua_pushfstring(L, "permExactMatchTrigger: cannot create trigger (%s)", message.toUtf8().constData());
+        }
+    }
+    if (id == -1) {
+        return lua_error(L);
+    }
+    lua_pushnumber(L, id);
+    return 1;
+}
+
+// Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#permScript
+int TLuaInterpreter::permScript(lua_State* L)
+{
+    if (!checkStringArg(L, __func__, 1, "script name") || !checkStringArg(L, __func__, 2, "script parent name")) {
+        return lua_error(L);
+    }
+    Host& host = getHostFromLua(L);
+    TLuaInterpreter* pLuaInterpreter = host.getLuaInterpreter();
+    if (pLuaInterpreter->reportInvalidLuaCodeParam(L, "permScript", 3)) {
+        return lua_error(L);
+    }
+
+    int scriptId = -1;
+    {
+        const QString name{lua_tostring(L, 1)};
+        const QString parent{lua_tostring(L, 2)};
+        const QString luaCode{lua_tostring(L, 3)};
+        auto [id, message] = pLuaInterpreter->createPermScript(name, parent, luaCode);
+        scriptId = id;
+        if (id == -1) {
+            lua_pushfstring(L, "permScript: cannot create script (%s)", message.toUtf8().constData());
+        }
+    }
+    if (scriptId == -1) {
+        return lua_error(L);
+    }
+    lua_pushnumber(L, scriptId);
+    return 1;
+}
+
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#permTimer
 int TLuaInterpreter::permTimer(lua_State* L)
 {
-    const QString name = getVerifiedString(L, __func__, 1, "timer name");
-    const QString parent = getVerifiedString(L, __func__, 2, "timer parent name");
+    if (!checkStringArg(L, __func__, 1, "timer name") || !checkStringArg(L, __func__, 2, "timer parent name")) {
+        return lua_error(L);
+    }
     const double time = getVerifiedDouble(L, __func__, 3, "time in seconds");
     if (!timerDelayFits(time)) {
         lua_pushfstring(L, "permTimer: bad argument #3 value (time in seconds must be at least 0 and less than 86400, got %f)", time);
@@ -1333,21 +1392,31 @@ int TLuaInterpreter::permTimer(lua_State* L)
     if (pLuaInterpreter->reportInvalidLuaCodeParam(L, "permTimer", 4)) {
         return lua_error(L);
     }
-    const QString luaCode{lua_tostring(L, 4)};
-    auto [id, message] = pLuaInterpreter->startPermTimer(name, parent, time, luaCode);
-    if (id == -1) {
-        lua_pushfstring(L, "permTimer: cannot create timer (%s)", message.toUtf8().constData());
+
+    int timerId = -1;
+    {
+        const QString name{lua_tostring(L, 1)};
+        const QString parent{lua_tostring(L, 2)};
+        const QString luaCode{lua_tostring(L, 4)};
+        auto [id, message] = pLuaInterpreter->startPermTimer(name, parent, time, luaCode);
+        timerId = id;
+        if (id == -1) {
+            lua_pushfstring(L, "permTimer: cannot create timer (%s)", message.toUtf8().constData());
+        }
+    }
+    if (timerId == -1) {
         return lua_error(L);
     }
-    lua_pushnumber(L, id);
+    lua_pushnumber(L, timerId);
     return 1;
 }
 
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#permKey
 int TLuaInterpreter::permKey(lua_State* L)
 {
-    QString keyName = getVerifiedString(L, __func__, 1, "key name");
-    QString parentGroup = getVerifiedString(L, __func__, 2, "key parent group");
+    if (!checkStringArg(L, __func__, 1, "key name") || !checkStringArg(L, __func__, 2, "key parent group")) {
+        return lua_error(L);
+    }
 
     uint_fast8_t argIndex = 3;
     int keyModifier = Qt::NoModifier;
@@ -1363,13 +1432,21 @@ int TLuaInterpreter::permKey(lua_State* L)
         return lua_error(L);
     }
 
-    QString luaFunction{lua_tostring(L, argIndex)};
-    auto [keyID, message] = pLuaInterpreter->startPermKey(keyName, parentGroup, keyCode, keyModifier, luaFunction);
-    if (keyID == -1) {
-        lua_pushfstring(L, "permKey: cannot create key (%s)", message.toUtf8().constData());
+    int id = -1;
+    {
+        QString keyName{lua_tostring(L, 1)};
+        QString parentGroup{lua_tostring(L, 2)};
+        QString luaFunction{lua_tostring(L, argIndex)};
+        auto [keyID, message] = pLuaInterpreter->startPermKey(keyName, parentGroup, keyCode, keyModifier, luaFunction);
+        id = keyID;
+        if (keyID == -1) {
+            lua_pushfstring(L, "permKey: cannot create key (%s)", message.toUtf8().constData());
+        }
+    }
+    if (id == -1) {
         return lua_error(L);
     }
-    lua_pushnumber(L, keyID);
+    lua_pushnumber(L, id);
     return 1;
 }
 
@@ -1776,23 +1853,39 @@ int TLuaInterpreter::setProfileIcon(lua_State* L)
 int TLuaInterpreter::setScript(lua_State* L)
 {
     const int n = lua_gettop(L);
-    int pos = 1;
-    QString name = getVerifiedString(L, __func__, 1, "script name");
+    // The name and the code stay the Lua-owned strings anchored at stack indexes
+    // 1 and 2 until every check has passed: lua_error() longjmps past C++
+    // destructors, so a QString built from an earlier argument would be stranded
+    // by a later argument's failure - see checkStringArg()
+    if (!checkStringArg(L, __func__, 1, "script name")) {
+        return lua_error(L);
+    }
 
     Host& host = getHostFromLua(L);
     TLuaInterpreter* pLuaInterpreter = host.getLuaInterpreter();
     if (pLuaInterpreter->reportInvalidLuaCodeParam(L, "setScript", 2)) {
         return lua_error(L);
     }
-    const QString luaCode{lua_tostring(L, 2)};
 
+    int pos = 1;
     if (n > 2) {
-        pos = getVerifiedInt(L, __func__, 3, "script position");
+        if (!checkIntArg(L, __func__, 3, "script position")) {
+            return lua_error(L);
+        }
+        pos = static_cast(lua_tointeger(L, 3));
     }
 
-    auto [id, message] = pLuaInterpreter->setScriptCode(name, luaCode, --pos);
+    int id = -1;
+    {
+        // scoped so that this failure message, and the QStrings handed to
+        // setScriptCode(), are all destroyed before the raise below
+        auto [scriptId, message] = pLuaInterpreter->setScriptCode(QString{lua_tostring(L, 1)}, QString{lua_tostring(L, 2)}, --pos);
+        id = scriptId;
+        if (id == -1) {
+            lua_pushfstring(L, "setScript: cannot set script (%s)", message.toUtf8().constData());
+        }
+    }
     if (id == -1) {
-        lua_pushfstring(L, "setScript: cannot set script (%s)", message.toUtf8().constData());
         return lua_error(L);
     }
     lua_pushnumber(L, id);
@@ -1863,14 +1956,14 @@ int TLuaInterpreter::setStopWatchPersistence(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setTriggerStayOpen
 int TLuaInterpreter::setTriggerStayOpen(lua_State* L)
 {
-    QString windowName;
+    const char* windowName = "";
     int s = 1;
     if (lua_gettop(L) > 1) {
         windowName = WINDOW_NAME(L, s++);
     }
     const double b = getVerifiedDouble(L, __func__, s, "number of lines");
     Host& host = getHostFromLua(L);
-    host.getTriggerUnit()->setTriggerStayOpen(windowName, static_cast(b));
+    host.getTriggerUnit()->setTriggerStayOpen(QString{windowName}, static_cast(b));
     return 0;
 }
 
@@ -2072,7 +2165,15 @@ int TLuaInterpreter::tempAnsiColorTrigger(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#tempAlias
 int TLuaInterpreter::tempAlias(lua_State* L)
 {
-    const QString regex = getVerifiedString(L, __func__, 1, "regex-type pattern");
+    if (!checkStringArg(L, __func__, 1, "regex-type pattern")) {
+        return lua_error(L);
+    }
+    if (!lua_isstring(L, 2) && !lua_isfunction(L, 2)) {
+        lua_pushfstring(L, "tempAlias: bad argument #2 type (lua script as string or function expected, got %s!)", luaL_typename(L, 2));
+        return lua_error(L);
+    }
+
+    const QString regex{lua_tostring(L, 1)};
     Host& host = getHostFromLua(L);
     TLuaInterpreter* pLuaInterpreter = host.getLuaInterpreter();
 
@@ -2099,10 +2200,6 @@ int TLuaInterpreter::tempAlias(lua_State* L)
         return 1;
     }
 
-    if (!lua_isstring(L, 2)) {
-        lua_pushfstring(L, "tempAlias: bad argument #2 type (lua script as string or function expected, got %s!)", luaL_typename(L, 2));
-        return lua_error(L);
-    }
     const QString script{lua_tostring(L, 2)};
 
     lua_pushnumber(L, pLuaInterpreter->startTempAlias(regex, script));
@@ -2116,7 +2213,9 @@ int TLuaInterpreter::tempBeginOfLineTrigger(lua_State* L)
     TLuaInterpreter* pLuaInterpreter = host.getLuaInterpreter();
     int triggerID;
     int expiryCount = -1;
-    const QString pattern = getVerifiedString(L, __func__, 1, "pattern");
+    if (!checkStringArg(L, __func__, 1, "pattern")) {
+        return lua_error(L);
+    }
 
     if (lua_isnumber(L, 3)) {
         expiryCount = static_cast(lua_tonumber(L, 3));
@@ -2129,9 +2228,15 @@ int TLuaInterpreter::tempBeginOfLineTrigger(lua_State* L)
         return lua_error(L);
     }
 
+    if (!lua_isstring(L, 2) && !lua_isfunction(L, 2)) {
+        lua_pushfstring(L, "tempBeginOfLineTrigger: bad argument #2 type (code to run as a string or a function expected, got %s!)", luaL_typename(L, 2));
+        return lua_error(L);
+    }
+
+    const QString pattern{lua_tostring(L, 1)};
     if (lua_isstring(L, 2)) {
         triggerID = pLuaInterpreter->startTempBeginOfLineTrigger(pattern, QString(lua_tostring(L, 2)), expiryCount);
-    } else if (lua_isfunction(L, 2)) {
+    } else {
         triggerID = pLuaInterpreter->startTempBeginOfLineTrigger(pattern, QString(), expiryCount);
 
         auto trigger = host.getTriggerUnit()->getTrigger(triggerID);
@@ -2146,9 +2251,6 @@ int TLuaInterpreter::tempBeginOfLineTrigger(lua_State* L)
         lua_pushlightuserdata(L, trigger);
         lua_pushvalue(L, 2);
         lua_settable(L, LUA_REGISTRYINDEX);
-    } else {
-        lua_pushfstring(L, "tempBeginOfLineTrigger: bad argument #2 type (code to run as a string or a function expected, got %s!)", luaL_typename(L, 2));
-        return lua_error(L);
     }
 
     lua_pushnumber(L, triggerID);
@@ -2374,8 +2476,9 @@ int TLuaInterpreter::tempColorTrigger(lua_State* L)
 int TLuaInterpreter::tempComplexRegexTrigger(lua_State* L)
 {
     Host& host = getHostFromLua(L);
-    const QString triggerName = getVerifiedString(L, __func__, 1, "trigger name create or add to");
-    const QString pattern = getVerifiedString(L, __func__, 2, "regex pattern to match");
+    if (!checkStringArg(L, __func__, 1, "trigger name create or add to") || !checkStringArg(L, __func__, 2, "regex pattern to match")) {
+        return lua_error(L);
+    }
 
     if (!lua_isstring(L, 3) && !lua_isfunction(L, 3)) {
         lua_pushfstring(L, "tempComplexRegexTrigger: bad argument #3 type (code to run as a string or a function expected, got %s!)", luaL_typename(L, 3));
@@ -2403,6 +2506,22 @@ int TLuaInterpreter::tempComplexRegexTrigger(lua_State* L)
     const int fireLength = getVerifiedInt(L, __func__, 12, "fire length");
     const int lineDelta = getVerifiedInt(L, __func__, 13, "line delta");
 
+    int expiryCount = -1;
+
+    if (lua_isnumber(L, 14)) {
+        expiryCount = static_cast(lua_tonumber(L, 14));
+
+        if (expiryCount < 1) {
+            return warnArgumentValue(L, __func__, qsl("trigger expiration count must be nil or greater than zero, got %1").arg(expiryCount));
+        }
+    } else if (!lua_isnoneornil(L, 14)) {
+        lua_pushfstring(L, "tempComplexRegexTrigger: bad argument #14 value (trigger expiration count must be nil or a number, got %s!)", luaL_typename(L, 14));
+        return lua_error(L);
+    }
+
+    const QString triggerName{lua_tostring(L, 1)};
+    const QString pattern{lua_tostring(L, 2)};
+
     bool colorTrigger;
     QString fgColor;
     if (lua_isnumber(L, 5)) {
@@ -2452,19 +2571,6 @@ int TLuaInterpreter::tempComplexRegexTrigger(lua_State* L)
         playSound = false;
     }
 
-    int expiryCount = -1;
-
-    if (lua_isnumber(L, 14)) {
-        expiryCount = static_cast(lua_tonumber(L, 14));
-
-        if (expiryCount < 1) {
-            return warnArgumentValue(L, __func__, qsl("trigger expiration count must be nil or greater than zero, got %1").arg(expiryCount));
-        }
-    } else if (!lua_isnoneornil(L, 14)) {
-        lua_pushfstring(L, "tempComplexRegexTrigger: bad argument #14 value (trigger expiration count must be nil or a number, got %s!)", luaL_typename(L, 14));
-        return lua_error(L);
-    }
-
     QStringList patterns;
     QList propertyList;
     TTrigger* pP = host.getTriggerUnit()->findTrigger(triggerName);
@@ -2523,7 +2629,9 @@ int TLuaInterpreter::tempExactMatchTrigger(lua_State* L)
     TLuaInterpreter* pLuaInterpreter = host.getLuaInterpreter();
     int triggerID;
     int expiryCount = -1;
-    const QString exactMatchPattern = getVerifiedString(L, __func__, 1, "exact match pattern");
+    if (!checkStringArg(L, __func__, 1, "exact match pattern")) {
+        return lua_error(L);
+    }
 
     if (lua_isnumber(L, 3)) {
         expiryCount = static_cast(lua_tonumber(L, 3));
@@ -2536,9 +2644,15 @@ int TLuaInterpreter::tempExactMatchTrigger(lua_State* L)
         return lua_error(L);
     }
 
+    if (!lua_isstring(L, 2) && !lua_isfunction(L, 2)) {
+        lua_pushfstring(L, "tempExactMatchTrigger: bad argument #2 type (code to run as a string or a function expected, got %s!)", luaL_typename(L, 2));
+        return lua_error(L);
+    }
+
+    const QString exactMatchPattern{lua_tostring(L, 1)};
     if (lua_isstring(L, 2)) {
         triggerID = pLuaInterpreter->startTempExactMatchTrigger(exactMatchPattern, QString(lua_tostring(L, 2)), expiryCount);
-    } else if (lua_isfunction(L, 2)) {
+    } else {
         triggerID = pLuaInterpreter->startTempExactMatchTrigger(exactMatchPattern, QString(), expiryCount);
 
         auto trigger = host.getTriggerUnit()->getTrigger(triggerID);
@@ -2553,9 +2667,6 @@ int TLuaInterpreter::tempExactMatchTrigger(lua_State* L)
         lua_pushlightuserdata(L, trigger);
         lua_pushvalue(L, 2);
         lua_settable(L, LUA_REGISTRYINDEX);
-    } else {
-        lua_pushfstring(L, "tempExactMatchTrigger: bad argument #2 type (code to run as a string or a function expected, got %s!)", luaL_typename(L, 2));
-        return lua_error(L);
     }
 
     lua_pushnumber(L, triggerID);
@@ -2698,7 +2809,9 @@ int TLuaInterpreter::tempRegexTrigger(lua_State* L)
     TLuaInterpreter* pLuaInterpreter = host.getLuaInterpreter();
     int triggerID;
     int expiryCount = -1;
-    const QString regexPattern = getVerifiedString(L, __func__, 1, "regex pattern");
+    if (!checkStringArg(L, __func__, 1, "regex pattern")) {
+        return lua_error(L);
+    }
 
     if (lua_isnumber(L, 3)) {
         expiryCount = static_cast(lua_tonumber(L, 3));
@@ -2711,9 +2824,15 @@ int TLuaInterpreter::tempRegexTrigger(lua_State* L)
         return lua_error(L);
     }
 
+    if (!lua_isstring(L, 2) && !lua_isfunction(L, 2)) {
+        lua_pushfstring(L, "tempRegexTrigger: bad argument #2 type (code to run as a string or a function expected, got %s!)", luaL_typename(L, 2));
+        return lua_error(L);
+    }
+
+    const QString regexPattern{lua_tostring(L, 1)};
     if (lua_isstring(L, 2)) {
         triggerID = pLuaInterpreter->startTempRegexTrigger(regexPattern, lua_tostring(L, 2), expiryCount);
-    } else if (lua_isfunction(L, 2)) {
+    } else {
         triggerID = pLuaInterpreter->startTempRegexTrigger(regexPattern, QString(), expiryCount);
 
         auto trigger = host.getTriggerUnit()->getTrigger(triggerID);
@@ -2728,9 +2847,6 @@ int TLuaInterpreter::tempRegexTrigger(lua_State* L)
         lua_pushlightuserdata(L, trigger);
         lua_pushvalue(L, 2);
         lua_settable(L, LUA_REGISTRYINDEX);
-    } else {
-        lua_pushfstring(L, "tempRegexTrigger: bad argument #2 type (code to run as a string or a function expected, got %s!)", luaL_typename(L, 2));
-        return lua_error(L);
     }
 
     lua_pushnumber(L, triggerID);
@@ -2798,7 +2914,9 @@ int TLuaInterpreter::tempTrigger(lua_State* L)
     TLuaInterpreter* pLuaInterpreter = host.getLuaInterpreter();
     int triggerID;
     int expiryCount = -1;
-    const QString substringPattern = getVerifiedString(L, __func__, 1, "substring pattern");
+    if (!checkStringArg(L, __func__, 1, "substring pattern")) {
+        return lua_error(L);
+    }
 
     if (lua_isnumber(L, 3)) {
         expiryCount = static_cast(lua_tonumber(L, 3));
@@ -2811,9 +2929,15 @@ int TLuaInterpreter::tempTrigger(lua_State* L)
         return lua_error(L);
     }
 
+    if (!lua_isstring(L, 2) && !lua_isfunction(L, 2)) {
+        lua_pushfstring(L, "tempTrigger: bad argument #2 type (code to run as a string or a function expected, got %s!)", luaL_typename(L, 2));
+        return lua_error(L);
+    }
+
+    const QString substringPattern{lua_tostring(L, 1)};
     if (lua_isstring(L, 2)) {
         triggerID = pLuaInterpreter->startTempTrigger(substringPattern, QString(lua_tostring(L, 2)), expiryCount);
-    } else if (lua_isfunction(L, 2)) {
+    } else {
         triggerID = pLuaInterpreter->startTempTrigger(substringPattern, QString(), expiryCount);
 
         auto trigger = host.getTriggerUnit()->getTrigger(triggerID);
@@ -2828,9 +2952,6 @@ int TLuaInterpreter::tempTrigger(lua_State* L)
         lua_pushlightuserdata(L, trigger);
         lua_pushvalue(L, 2);
         lua_settable(L, LUA_REGISTRYINDEX);
-    } else {
-        lua_pushfstring(L, "tempTrigger: bad argument #2 type (code to run as a string or a function expected, got %s!)", luaL_typename(L, 2));
-        return lua_error(L);
     }
 
     lua_pushnumber(L, triggerID);
diff --git a/src/TLuaInterpreterNetworking.cpp b/src/TLuaInterpreterNetworking.cpp
index 650d329e7..1777913f5 100644
--- a/src/TLuaInterpreterNetworking.cpp
+++ b/src/TLuaInterpreterNetworking.cpp
@@ -76,7 +76,9 @@ int TLuaInterpreter::connectToServer(lua_State* L)
     bool isToSaveToProfile = false;
 
     Host& host = getHostFromLua(L);
-    const QString url = getVerifiedString(L, __func__, 1, "url");
+    if (!checkStringArg(L, __func__, 1, "url")) {
+        return lua_error(L);
+    }
 
     if (!lua_isnoneornil(L, 2)) {
         port = getVerifiedInt(L, __func__, 2, "port number {default = 23}", true);
@@ -90,6 +92,8 @@ int TLuaInterpreter::connectToServer(lua_State* L)
         isToSaveToProfile = getVerifiedBool(L, __func__, 3, "save host name and port number", true);
     }
 
+    const QString url{lua_tostring(L, 1)};
+
     if (isToSaveToProfile) {
         QPair result = host.writeProfileData(QLatin1String("url"), url);
         if (!result.first) {
@@ -120,8 +124,12 @@ int TLuaInterpreter::disconnect(lua_State* L)
 int TLuaInterpreter::downloadFile(lua_State* L)
 {
     Host& host = getHostFromLua(L);
-    const QString localFile = getVerifiedString(L, __func__, 1, "local filename");
-    const QString urlString = getVerifiedString(L, __func__, 2, "remote url");
+    if (!checkStringArg(L, __func__, 1, "local filename") || !checkStringArg(L, __func__, 2, "remote url")) {
+        return lua_error(L);
+    }
+
+    const QString localFile{lua_tostring(L, 1)};
+    const QString urlString{lua_tostring(L, 2)};
     const QUrl url = QUrl::fromUserInput(urlString);
     if (!url.isValid()) {
         return warnArgumentValue(L, __func__, qsl("url is invalid, reason: %1").arg(url.errorString()));
@@ -300,14 +308,16 @@ int TLuaInterpreter::sendATCP(lua_State* L)
         lua_pushfstring(L, "sendATCP: bad argument #1 type (message as string expected, got %s!)", luaL_typename(L, 1));
         return lua_error(L);
     }
+    const bool hasWhat = lua_gettop(L) > 1;
+    if (hasWhat && !lua_isstring(L, 2)) {
+        lua_pushfstring(L, "sendATCP: bad argument #2 type (what as string is optional, got %s!)", luaL_typename(L, 2));
+        return lua_error(L);
+    }
+
     const std::string msg = host.mTelnet.encodeAndCookBytes(lua_tostring(L, 1));
 
     std::string what;
-    if (lua_gettop(L) > 1) {
-        if (!lua_isstring(L, 2)) {
-            lua_pushfstring(L, "sendATCP: bad argument #2 type (what as string is optional, got %s!)", luaL_typename(L, 2));
-            return lua_error(L);
-        }
+    if (hasWhat) {
         what = host.mTelnet.encodeAndCookBytes(lua_tostring(L, 2));
     }
 
@@ -349,14 +359,16 @@ int TLuaInterpreter::sendGMCP(lua_State* L)
         lua_pushfstring(L, "sendGMCP: bad argument #1 type (message as string expected, got %s!)", luaL_typename(L, 1));
         return lua_error(L);
     }
+    const bool hasWhat = lua_gettop(L) > 1;
+    if (hasWhat && !lua_isstring(L, 2)) {
+        lua_pushfstring(L, "sendGMCP: bad argument #2 type (what as string is optional, got %s!)", luaL_typename(L, 2));
+        return lua_error(L);
+    }
+
     const std::string msg = host.mTelnet.encodeAndCookBytes(lua_tostring(L, 1));
 
     std::string what;
-    if (lua_gettop(L) > 1) {
-        if (!lua_isstring(L, 2)) {
-            lua_pushfstring(L, "sendGMCP: bad argument #2 type (what as string is optional, got %s!)", luaL_typename(L, 2));
-            return lua_error(L);
-        }
+    if (hasWhat) {
         what = host.mTelnet.encodeAndCookBytes(lua_tostring(L, 2));
     }
 
@@ -393,8 +405,12 @@ int TLuaInterpreter::sendGMCP(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#sendIrc
 int TLuaInterpreter::sendIrc(lua_State* L)
 {
-    const QString target = getVerifiedString(L, __func__, 1, "target");
-    const QString msg = getVerifiedString(L, __func__, 2, "message");
+    if (!checkStringArg(L, __func__, 1, "target") || !checkStringArg(L, __func__, 2, "message")) {
+        return lua_error(L);
+    }
+
+    const QString target{lua_tostring(L, 1)};
+    const QString msg{lua_tostring(L, 2)};
 
     Host* pHost = &getHostFromLua(L);
     if (!pHost->mpDlgIRC) {
@@ -585,9 +601,11 @@ int TLuaInterpreter::setIrcServer(lua_State* L)
     const int args = lua_gettop(L);
     int secure = false;
     int port = 6667;
-    QString password;
-    const std::string addr = getVerifiedString(L, __func__, 1, "hostname").toStdString();
-    if (addr.empty()) {
+    if (!checkStringArg(L, __func__, 1, "hostname")) {
+        return lua_error(L);
+    }
+    const char* hostName = lua_tostring(L, 1);
+    if (*hostName == '\0') {
         return warnArgumentValue(L, __func__, "hostname must not be empty");
     }
     if (!lua_isnoneornil(L, 2)) {
@@ -599,12 +617,17 @@ int TLuaInterpreter::setIrcServer(lua_State* L)
     if (args > 2) {
         secure = getVerifiedBool(L, __func__, 3, "secure {default = false}", true);
     }
+    if (args > 3 && !checkStringArg(L, __func__, 4, "server password", true)) {
+        return lua_error(L);
+    }
+
+    QString password;
     if (args > 3) {
-        password = getVerifiedString(L, __func__, 4, "server password", true);
+        password = lua_tostring(L, 4);
     }
 
     Host* pHost = &getHostFromLua(L);
-    QPair result = dlgIRC::writeIrcHostName(pHost, QString::fromStdString(addr));
+    QPair result = dlgIRC::writeIrcHostName(pHost, QString::fromUtf8(hostName));
     if (!result.first) {
         return warnArgumentValue(L, __func__, qsl("unable to save hostname, reason: %1").arg(result.second));
     }
@@ -679,10 +702,12 @@ int TLuaInterpreter::setIrcServer(lua_State* L)
 int TLuaInterpreter::getHTTP(lua_State* L)
 {
     auto& host = getHostFromLua(L);
-    const QString urlString = getVerifiedString(L, __func__, 1, "remote url");
+    if (!checkStringArg(L, __func__, 1, "remote url")) {
+        return lua_error(L);
+    }
     validateHttpHeaders(L, 2, __func__);
 
-    const QUrl url = QUrl::fromUserInput(urlString);
+    const QUrl url = QUrl::fromUserInput(QString{lua_tostring(L, 1)});
     if (!url.isValid()) {
         return warnArgumentValue(L, __func__, qsl("url is invalid, reason: %1").arg(url.errorString()));
     }
@@ -706,23 +731,25 @@ int TLuaInterpreter::getHTTP(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#postHTTP
 int TLuaInterpreter::postHTTP(lua_State* L)
 {
-    return performHttpRequest(L, __func__, 0, QNetworkAccessManager::PostOperation, qsl("post"));
+    return performHttpRequest(L, __func__, 0, QNetworkAccessManager::PostOperation, "post");
 }
 
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#putHTTP
 int TLuaInterpreter::putHTTP(lua_State* L)
 {
-    return performHttpRequest(L, __func__, 0, QNetworkAccessManager::PutOperation, qsl("put"));
+    return performHttpRequest(L, __func__, 0, QNetworkAccessManager::PutOperation, "put");
 }
 
 // Documentation: https://wiki.mudlet.org/w/Manual:Networking_Functions#deleteHTTP
 int TLuaInterpreter::deleteHTTP(lua_State* L)
 {
     auto& host = getHostFromLua(L);
-    const QString urlString = getVerifiedString(L, __func__, 1, "remote url");
+    if (!checkStringArg(L, __func__, 1, "remote url")) {
+        return lua_error(L);
+    }
     validateHttpHeaders(L, 2, __func__);
 
-    const QUrl url = QUrl::fromUserInput(urlString);
+    const QUrl url = QUrl::fromUserInput(QString{lua_tostring(L, 1)});
     if (!url.isValid()) {
         return warnArgumentValue(L, __func__, qsl("url is invalid, reason: %1").arg(url.errorString()));
     }
@@ -746,6 +773,9 @@ int TLuaInterpreter::deleteHTTP(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#customHTTP
 int TLuaInterpreter::customHTTP(lua_State* L)
 {
-    auto customMethod = getVerifiedString(L, __func__, 1, "http method");
-    return performHttpRequest(L, __func__, 1, QNetworkAccessManager::CustomOperation, customMethod);
+    if (!checkStringArg(L, __func__, 1, "http method")) {
+        return lua_error(L);
+    }
+
+    return performHttpRequest(L, __func__, 1, QNetworkAccessManager::CustomOperation, lua_tostring(L, 1));
 }
diff --git a/src/TLuaInterpreterUI.cpp b/src/TLuaInterpreterUI.cpp
index 0b71e13e6..4803a7403 100644
--- a/src/TLuaInterpreterUI.cpp
+++ b/src/TLuaInterpreterUI.cpp
@@ -235,7 +235,12 @@ int TLuaInterpreter::calcFontSize(lua_State* L)
 
     // font name and size are passed in as arguments
     if (lua_gettop(L) == 2) {
-        auto font = QFont(getVerifiedString(L, __func__, 2, "font name"), getVerifiedInt(L, __func__, 1, "font size"), QFont::Normal);
+        // hoisted because the order the two QFont arguments were evaluated in is
+        // unspecified, so which failure got reported was up to the compiler
+        if (!checkIntArg(L, __func__, 1, "font size") || !checkStringArg(L, __func__, 2, "font name")) {
+            return lua_error(L);
+        }
+        auto font = QFont(QString{lua_tostring(L, 2)}, static_cast(lua_tointeger(L, 1)), QFont::Normal);
         auto fontMetrics = QFontMetrics(font);
         size = QSize(fontMetrics.averageCharWidth(), fontMetrics.height());
 
@@ -309,29 +314,23 @@ int TLuaInterpreter::createBuffer(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#createCommandLine
 int TLuaInterpreter::createCommandLine(lua_State* L)
 {
-    QString windowName = QLatin1String("main");
     const int n = lua_gettop(L);
     int counter = 1;
+    const bool hasParentWindow = (n > 5);
 
-    if (n > 5) {
+    if (hasParentWindow) {
         if (lua_type(L, 1) != LUA_TSTRING) {
             lua_pushfstring(L, "createCommandLine: bad argument #1 type (parent window name as string expected, got %s!)", luaL_typename(L, 1));
             return lua_error(L);
         }
-        windowName = lua_tostring(L, 1);
         counter++;
-        if (isMain(windowName)) {
-            // createCommandLine only accepts the empty name as the main window
-            windowName.clear();
-        }
     }
 
-    if (lua_type(L, counter) != LUA_TSTRING) {
-        lua_pushfstring(L, "createCommandLine: bad argument #%d type (commandLine name as string expected, got %s!)", counter, luaL_typename(L, counter));
+    const int commandLineNamePos = counter++;
+    if (lua_type(L, commandLineNamePos) != LUA_TSTRING) {
+        lua_pushfstring(L, "createCommandLine: bad argument #%d type (commandLine name as string expected, got %s!)", commandLineNamePos, luaL_typename(L, commandLineNamePos));
         return lua_error(L);
     }
-    const QString commandLineName{lua_tostring(L, counter)};
-    counter++;
     const int x = getVerifiedInt(L, __func__, counter, "commandline x-coordinate");
     counter++;
     const int y = getVerifiedInt(L, __func__, counter, "commandline y-coordinate");
@@ -341,6 +340,16 @@ int TLuaInterpreter::createCommandLine(lua_State* L)
     const int height = getVerifiedInt(L, __func__, counter, "commandline height");
     counter++;
 
+    QString windowName = qsl("main");
+    if (hasParentWindow) {
+        windowName = lua_tostring(L, 1);
+        if (isMain(windowName)) {
+            // createCommandLine only accepts the empty name as the main window
+            windowName.clear();
+        }
+    }
+    const QString commandLineName{lua_tostring(L, commandLineNamePos)};
+
     const Host& host = getHostFromLua(L);
     if (auto [success, message] = host.mpConsole->createCommandLine(windowName, commandLineName, x, y, width, height); !success) {
         return warnArgumentValue(L, __func__, message);
@@ -501,29 +510,23 @@ int TLuaInterpreter::deleteCommandLine(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#createTextEdit
 int TLuaInterpreter::createTextEdit(lua_State* L)
 {
-    QString windowName = QLatin1String("main");
     const int n = lua_gettop(L);
     int counter = 1;
+    const bool hasParentWindow = (n > 5);
 
-    if (n > 5) {
+    if (hasParentWindow) {
         if (lua_type(L, 1) != LUA_TSTRING) {
             lua_pushfstring(L, "createTextEdit: bad argument #1 type (parent window name as string expected, got %s!)", luaL_typename(L, 1));
             return lua_error(L);
         }
-        windowName = lua_tostring(L, 1);
         counter++;
-        if (isMain(windowName)) {
-            // createTextEdit only accepts the empty name as the main window
-            windowName.clear();
-        }
     }
 
-    if (lua_type(L, counter) != LUA_TSTRING) {
-        lua_pushfstring(L, "createTextEdit: bad argument #%d type (text edit name as string expected, got %s!)", counter, luaL_typename(L, counter));
+    const int textEditNamePos = counter++;
+    if (lua_type(L, textEditNamePos) != LUA_TSTRING) {
+        lua_pushfstring(L, "createTextEdit: bad argument #%d type (text edit name as string expected, got %s!)", textEditNamePos, luaL_typename(L, textEditNamePos));
         return lua_error(L);
     }
-    const QString textEditName{lua_tostring(L, counter)};
-    counter++;
     const int x = getVerifiedInt(L, __func__, counter, "text edit x-coordinate");
     counter++;
     const int y = getVerifiedInt(L, __func__, counter, "text edit y-coordinate");
@@ -533,6 +536,16 @@ int TLuaInterpreter::createTextEdit(lua_State* L)
     const int height = getVerifiedInt(L, __func__, counter, "text edit height");
     counter++;
 
+    QString windowName = qsl("main");
+    if (hasParentWindow) {
+        windowName = lua_tostring(L, 1);
+        if (isMain(windowName)) {
+            // createTextEdit only accepts the empty name as the main window
+            windowName.clear();
+        }
+    }
+    const QString textEditName{lua_tostring(L, textEditNamePos)};
+
     const Host& host = getHostFromLua(L);
     if (auto [success, message] = host.mpConsole->createTextBox(windowName, textEditName, x, y, width, height); !success) {
         return warnArgumentValue(L, __func__, message);

From 8d1e061e3580687fd89d7ca2f3eeda01f8bbfde1 Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Mon, 3 Aug 2026 11:39:32 +0200
Subject: [PATCH 061/155] Fix: strand no heap objects across the remaining
 lua_error() raises (#9605)

#### Brief overview of PR changes/additions
- Makes #9602's by-example sweep exhaustive. A static pass over the
**674** functions taking a `lua_State*` - the only frames a
`lua_error()` longjmp can unwind - found **377 sites in 160 functions**
holding a QString, QStringList, QByteArray, std::string or TMediaData
across a raise. **334 are converted, clearing 133 functions.** The **43
sites in 27 functions** left are each verified non-owning: `static`
storage, `qsl()`/QStringLiteral, default-constructed or `""` (Qt's
shared empty buffer), `isEmpty()` being the raise condition itself, a
local declared in the branch that does not raise, and one
`QFileInfo::exists` vs `TLuaInterpreter::exists` name collision. Same
scanner both sides, nothing newly flagged.
- Mechanism is #9602's: the `checkStringArg()` family, extended with
`checkNumberArg`, `checkStringOrIntegerArg`,
`checkCommandOrFunctionArg`, `checkCommandsOrFunctionsTable` and
`checkHintsTable`.
`getVerifiedString`/`Int`/`Bool`/`Float`/`Double`/`StringOrInteger`,
`parseCommandOrFunction` and the two table parsers are reimplemented or
paired on top, so message text and the order errors are reported in
cannot drift.
- Raisers are not only Mudlet's own helpers - lauxlib's `luaL_check*`
and `luaL_opt*` raise too, and `spawn()` was the worst case.
`TForkedProcess`'s constructor raised three times while holding the
program name and the argument list it was still filling, and because a
longjmp out of a constructor skips the rest of it, the `QProcess` that
`startProcess()` had just `new`'d leaked whole. Checking and failure
reporting move to `startProcess()`; the constructor no longer takes a
`lua_State` and cannot raise. `waitForEvent()` swaps `luaL_checkstack`
for the non-raising `lua_checkstack`.
- Two sub-classes a site scan structurally cannot see were caught
separately. Temporaries passed *into* a raising call rather than named
locals: `setLabelCallback()` and `movieFunc()` take a `const char*` now,
as a QByteArray built from their QString name was alive inside every
raising check. And loop-carried accumulation, where a container looks
non-owning at its declaration and only fills up once the loop runs -
`setMergeTables("Char", {})` and `TForkedProcess`'s argument loop both
stranded lists that way. A second detector (container declared outside a
loop, mutated inside it, raise in the same body) reproduces both on the
parent commit and reports nothing here.

#### Motivation for adding to Mudlet
#9602 removed the LSan suppression hiding this class but only fixed what
the suite happened to reach, so the first spec touching any of the rest
would turn CI red. Three things are worth recording for anyone repeating
the audit: `lua_error` only unwinds frames between the raise and the
enclosing `lua_pcall`, so closing the call graph over every function
name gives 1834 "raisers" and thousands of bogus hits - the `lua_State*`
universe is the right scope; `__func__` inside a lambda expands to
`"operator()"`, so wrapping a function body in one silently renames its
error messages; and a constructor that raises strands whatever `new`'d
it.

**Test case:** `Spawn_spec.lua` drives every `spawn()` error path, which
strand 4260 bytes in 20 allocations on the parent commit and nothing
here; `expandAlias`, `findItems` and `setModulePriority` likewise, with
byte-identical error messages either side. Busted 2x 1316 successes / 0
failures / 0 errors / 0 pending, ctest 60/60.

Stacked on #9602 - that one goes in first.

Assisted-by: Claude:claude-opus-5
---
 src/TForkedProcess.cpp               |   79 +-
 src/TForkedProcess.h                 |    2 +-
 src/TLuaInterpreter.cpp              | 1073 +++++++++++++++-----------
 src/TLuaInterpreter.h                |    9 +-
 src/TLuaInterpreterDiscord.cpp       |   18 +-
 src/TLuaInterpreterMMCP.cpp          |   51 +-
 src/TLuaInterpreterMapper.cpp        |  354 ++++++---
 src/TLuaInterpreterMudletObjects.cpp |  161 ++--
 src/TLuaInterpreterTextToSpeech.cpp  |   20 +-
 src/TLuaInterpreterUI.cpp            |  875 ++++++++++++---------
 src/mudlet-lua/tests/Spawn_spec.lua  |   70 ++
 11 files changed, 1656 insertions(+), 1056 deletions(-)
 create mode 100644 src/mudlet-lua/tests/Spawn_spec.lua

diff --git a/src/TForkedProcess.cpp b/src/TForkedProcess.cpp
index 85f30443d..63ccd56d1 100644
--- a/src/TForkedProcess.cpp
+++ b/src/TForkedProcess.cpp
@@ -37,31 +37,14 @@ TForkedProcess::~TForkedProcess()
 }
 
 
-TForkedProcess::TForkedProcess(TLuaInterpreter* pInterpreter, lua_State* L)
+// Raises nothing: a lua_error() here would longjmp out of the constructor and
+// strand both this QProcess and every argument the caller still holds, so
+// checking the arguments and reporting a failed start are startProcess()'s job
+TForkedProcess::TForkedProcess(TLuaInterpreter* pInterpreter, const QString& program, const QStringList& arguments, const int callBackReference)
 : QProcess()
+, callBackFunctionRef(callBackReference)
 , mpInterpreter(pInterpreter)
 {
-    int n = lua_gettop(L);
-    if (n < 2) {
-        lua_pushstring(L, "Need read function and process name as parameters.");
-        lua_error(L);
-    }
-
-    if (!lua_isfunction(L, 1)) {
-        lua_pushstring(L, "Need read function as first parameter.");
-        lua_error(L);
-    }
-
-    lua_pushvalue(L, 1);
-    callBackFunctionRef = luaL_ref(L, LUA_REGISTRYINDEX);
-
-
-    QString prog{luaL_checkstring(L, 2)};
-    QStringList args;
-    for (int i = 3; i <= n; i++) {
-        args << luaL_checkstring(L, i);
-    }
-
     // QProcess::finished is overloaded so we have to say which form we are
     // connecting here
     connect(this, qOverload(&QProcess::finished), mpInterpreter, &TLuaInterpreter::slot_deleteSender);
@@ -69,14 +52,8 @@ TForkedProcess::TForkedProcess(TLuaInterpreter* pInterpreter, lua_State* L)
     connect(this, &QProcess::readyReadStandardOutput, this, &TForkedProcess::slot_receivedData);
 
     setProcessChannelMode(QProcess::MergedChannels);
-    start(prog, args, QIODevice::ReadWrite);
-    if (!waitForStarted()) {
-        const QString errorMessage = qsl("Failed to start process '%1': %2. Working directory: '%3'. PATH: '%4'").arg(prog, errorString(), QDir::currentPath(), qEnvironmentVariable("PATH"));
-        lua_pushstring(L, errorMessage.toUtf8().constData());
-        lua_error(L);
-        return;
-    }
-    running = true;
+    start(program, arguments, QIODevice::ReadWrite);
+    running = waitForStarted();
 }
 
 void TForkedProcess::slot_finished(int exitCode, QProcess::ExitStatus exitStatus)
@@ -156,7 +133,47 @@ static int qPointerGC(lua_State* L)
 
 int TForkedProcess::startProcess(TLuaInterpreter* pInterpreter, lua_State* L)
 {
-    auto process = new TForkedProcess(pInterpreter, L);
+    const int n = lua_gettop(L);
+    if (n < 2) {
+        lua_pushstring(L, "Need read function and process name as parameters.");
+        return lua_error(L);
+    }
+    if (!lua_isfunction(L, 1)) {
+        lua_pushstring(L, "Need read function as first parameter.");
+        return lua_error(L);
+    }
+    for (int i = 2; i <= n; ++i) {
+        // the same raise these used to make from inside the constructor, but
+        // while nothing of ours is alive for the longjmp to strand
+        static_cast(luaL_checkstring(L, i));
+    }
+
+    TForkedProcess* process = nullptr;
+    {
+        const QString program{lua_tostring(L, 2)};
+        QStringList arguments;
+        for (int i = 3; i <= n; ++i) {
+            arguments << lua_tostring(L, i);
+        }
+
+        lua_pushvalue(L, 1);
+        const int callBackReference = luaL_ref(L, LUA_REGISTRYINDEX);
+        process = new TForkedProcess(pInterpreter, program, arguments, callBackReference);
+        if (!process->running) {
+            lua_pushstring(L,
+                           qsl("Failed to start process '%1': %2. Working directory: '%3'. PATH: '%4'")
+                                   .arg(program, process->errorString(), QDir::currentPath(), qEnvironmentVariable("PATH"))
+                                   .toUtf8()
+                                   .constData());
+            // the destructor releases the callback reference
+            delete process;
+            process = nullptr;
+        }
+    }
+    if (!process) {
+        // raised out here so program, arguments and the message are all gone
+        return lua_error(L);
+    }
 
     // The userdata for the closures.
     auto** luaMemory = (QPointer**)lua_newuserdata(L, sizeof(QPointer*));
diff --git a/src/TForkedProcess.h b/src/TForkedProcess.h
index f613eaefd..a8b73b8d0 100644
--- a/src/TForkedProcess.h
+++ b/src/TForkedProcess.h
@@ -43,7 +43,7 @@ private:
     static int isProcessRunning(lua_State* L);
     static int sendMessage(lua_State* L);
 
-    TForkedProcess(TLuaInterpreter*, lua_State*);
+    TForkedProcess(TLuaInterpreter*, const QString& program, const QStringList& arguments, const int callBackReference);
 
     int callBackFunctionRef = -1;
     TLuaInterpreter* mpInterpreter = nullptr;
diff --git a/src/TLuaInterpreter.cpp b/src/TLuaInterpreter.cpp
index 6fa6f83bc..32d973718 100644
--- a/src/TLuaInterpreter.cpp
+++ b/src/TLuaInterpreter.cpp
@@ -203,10 +203,25 @@ bool TLuaInterpreter::checkBoolArg(lua_State* L, const char* functionName, const
     return true;
 }
 
+// No documentation available in wiki - internal function
+// See also: getVerifiedBool
+/*static*/ bool TLuaInterpreter::checkStringOrIntegerArg(lua_State* L, const char* functionName, const int pos, const char* publicName, const bool isOptional)
+{
+    if (lua_type(L, pos) != LUA_TNUMBER && lua_type(L, pos) != LUA_TSTRING) {
+        errorArgumentType(L, functionName, pos, publicName, "string or integer", isOptional);
+        return false;
+    }
+    return true;
+}
+
 // No documentation available in wiki - internal function
 // See also: getVerifiedBool
 /*static*/ std::pair TLuaInterpreter::getVerifiedStringOrInteger(lua_State* L, const char* functionName, const int pos, const char* publicName, const bool isOptional)
 {
+    if (!checkStringOrIntegerArg(L, functionName, pos, publicName, isOptional)) {
+        lua_error(L);
+        Q_UNREACHABLE();
+    }
     if (lua_type(L, pos) == LUA_TNUMBER) {
         // use lua_tonumber(...) and round because lua_tointeger(...) can return
         // oversized values (long long int?) on Windows which do not always fit
@@ -214,13 +229,7 @@ bool TLuaInterpreter::checkBoolArg(lua_State* L, const char* functionName, const
         return {true, QString::number(qRound(lua_tonumber(L, pos)))};
     }
 
-    if (lua_type(L, pos) == LUA_TSTRING) {
-        return {false, lua_tostring(L, pos)};
-    }
-
-    errorArgumentType(L, functionName, pos, publicName, "string or integer", isOptional);
-    lua_error(L);
-    Q_UNREACHABLE();
+    return {false, lua_tostring(L, pos)};
 }
 
 // No documentation available in wiki - internal function
@@ -292,11 +301,21 @@ int TLuaInterpreter::getVerifiedInt(lua_State* L, const char* functionName, cons
 }
 
 // No documentation available in wiki - internal function
-// See also: getVerifiedBool
-float TLuaInterpreter::getVerifiedFloat(lua_State* L, const char* functionName, const int pos, const char* publicName, const bool isOptional)
+// The non-raising counterpart of getVerifiedFloat and getVerifiedDouble - see checkStringArg()
+bool TLuaInterpreter::checkNumberArg(lua_State* L, const char* functionName, const int pos, const char* publicName, const bool isOptional)
 {
     if (!lua_isnumber(L, pos)) {
         errorArgumentType(L, functionName, pos, publicName, "number", isOptional);
+        return false;
+    }
+    return true;
+}
+
+// No documentation available in wiki - internal function
+// See also: getVerifiedBool
+float TLuaInterpreter::getVerifiedFloat(lua_State* L, const char* functionName, const int pos, const char* publicName, const bool isOptional)
+{
+    if (!checkNumberArg(L, functionName, pos, publicName, isOptional)) {
         lua_error(L);
         Q_UNREACHABLE();
     }
@@ -307,8 +326,7 @@ float TLuaInterpreter::getVerifiedFloat(lua_State* L, const char* functionName,
 // See also: getVerifiedBool
 double TLuaInterpreter::getVerifiedDouble(lua_State* L, const char* functionName, const int pos, const char* publicName, const bool isOptional)
 {
-    if (!lua_isnumber(L, pos)) {
-        errorArgumentType(L, functionName, pos, publicName, "number", isOptional);
+    if (!checkNumberArg(L, functionName, pos, publicName, isOptional)) {
         lua_error(L);
         Q_UNREACHABLE();
     }
@@ -1161,11 +1179,11 @@ int TLuaInterpreter::feedTriggers(lua_State* L)
         return lua_error(L);
     }
 
-    const QByteArray data{lua_tostring(L, 1)};
     bool dataIsUtf8Encoded = true;
     if (lua_gettop(L) > 1) {
         dataIsUtf8Encoded = getVerifiedBool(L, __func__, 2, "Utf8Encoded", true);
     }
+    const QByteArray data{lua_tostring(L, 1)};
 
     const QByteArray currentEncoding = host.mTelnet.getEncoding();
     if (dataIsUtf8Encoded) {
@@ -1333,8 +1351,11 @@ int TLuaInterpreter::getModulePriority(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setModulePriority
 int TLuaInterpreter::setModulePriority(lua_State* L)
 {
-    const QString moduleName = getVerifiedString(L, __func__, 1, "module name");
+    if (!checkStringArg(L, __func__, 1, "module name")) {
+        return lua_error(L);
+    }
     const int modulePriority = getVerifiedInt(L, __func__, 2, "module priority");
+    const QString moduleName{lua_tostring(L, 1)};
 
     Host& host = getHostFromLua(L);
     if (!host.mInstalledModules.contains(moduleName)) {
@@ -1357,13 +1378,16 @@ int TLuaInterpreter::saveProfile(lua_State* L)
 {
     Host& host = getHostFromLua(L);
 
+    if (!lua_isnoneornil(L, 2) && !checkStringArg(L, __func__, 2, "file name", true)) {
+        return lua_error(L);
+    }
     QString saveToDir;
     if (lua_isstring(L, 1)) {
         saveToDir = lua_tostring(L, 1);
     }
     QString saveAsFile;
     if (!lua_isnoneornil(L, 2)) {
-        saveAsFile = getVerifiedString(L, __func__, 2, "file name", true);
+        saveAsFile = lua_tostring(L, 2);
         if (!saveAsFile.endsWith(".xml", Qt::CaseInsensitive)) {
             saveAsFile = saveAsFile + ".xml";
         }
@@ -1583,39 +1607,49 @@ int TLuaInterpreter::appendLog(lua_State* L)
 
 
 // No documentation available in wiki - internal function
-int TLuaInterpreter::setLabelCallback(lua_State* L, const QString& funcName)
+// funcName is not a QString because a QByteArray made from one would still be
+// alive inside the raising checks below - see checkStringArg()
+int TLuaInterpreter::setLabelCallback(lua_State* L, const char* funcName)
 {
     Host& host = getHostFromLua(L);
-    const QString labelName = getVerifiedString(L, funcName.toUtf8().constData(), 1, "label name");
-    if (labelName.isEmpty()) {
+    if (!checkStringArg(L, funcName, 1, "label name")) {
+        return lua_error(L);
+    }
+    // the empty-name refusal has to stay ahead of the argument #2 check, as it
+    // did before, or setLabelClickCallback("", ) would raise
+    // instead of returning nil and a message
+    if (*lua_tostring(L, 1) == '\0') {
         return warnArgumentValue(L, __func__, "label name cannot be an empty string");
     }
+    if (!lua_isnil(L, 2) && !lua_isfunction(L, 2)) {
+        lua_pushfstring(L, "%s: bad argument #2 type (function or nil expected, got %s!)", funcName, luaL_typename(L, 2));
+        return lua_error(L);
+    }
+    const QLatin1StringView callbackName{funcName};
+    const QString labelName{lua_tostring(L, 1)};
     lua_remove(L, 1);
 
     int func = 0;
     if (lua_isnil(L, 1)) {
         lua_pop(L, 1);
-    } else if (lua_isfunction(L, 1)) {
-        func = luaL_ref(L, LUA_REGISTRYINDEX);
     } else {
-        lua_pushfstring(L, "%s: bad argument #2 type (function or nil expected, got %s!)", funcName.toUtf8().constData(), luaL_typename(L, 1));
-        return lua_error(L);
+        func = luaL_ref(L, LUA_REGISTRYINDEX);
     }
 
     bool lua_result = false;
-    if (funcName == qsl("setLabelClickCallback")) {
+    if (callbackName == qsl("setLabelClickCallback")) {
         lua_result = host.setLabelClickCallback(labelName, func);
-    } else if (funcName == qsl("setLabelDoubleClickCallback")) {
+    } else if (callbackName == qsl("setLabelDoubleClickCallback")) {
         lua_result = host.setLabelDoubleClickCallback(labelName, func);
-    } else if (funcName == qsl("setLabelReleaseCallback")) {
+    } else if (callbackName == qsl("setLabelReleaseCallback")) {
         lua_result = host.setLabelReleaseCallback(labelName, func);
-    } else if (funcName == qsl("setLabelMoveCallback")) {
+    } else if (callbackName == qsl("setLabelMoveCallback")) {
         lua_result = host.setLabelMoveCallback(labelName, func);
-    } else if (funcName == qsl("setLabelWheelCallback")) {
+    } else if (callbackName == qsl("setLabelWheelCallback")) {
         lua_result = host.setLabelWheelCallback(labelName, func);
-    } else if (funcName == qsl("setLabelOnEnter")) {
+    } else if (callbackName == qsl("setLabelOnEnter")) {
         lua_result = host.setLabelOnEnter(labelName, func);
-    } else if (funcName == qsl("setLabelOnLeave")) {
+    } else if (callbackName == qsl("setLabelOnLeave")) {
         lua_result = host.setLabelOnLeave(labelName, func);
     } else {
         luaL_unref(L, LUA_REGISTRYINDEX, func);
@@ -1717,9 +1751,10 @@ int TLuaInterpreter::debug(lua_State* L)
 int TLuaInterpreter::showHandlerError(lua_State* L)
 {
     Host& host = getHostFromLua(L);
-    const QString event = getVerifiedString(L, __func__, 1, "event name");
-    const QString error = getVerifiedString(L, __func__, 2, "error message");
-    host.mLuaInterpreter.logEventError(event, error);
+    if (!checkStringArg(L, __func__, 1, "event name") || !checkStringArg(L, __func__, 2, "error message")) {
+        return lua_error(L);
+    }
+    host.mLuaInterpreter.logEventError(QString{lua_tostring(L, 1)}, QString{lua_tostring(L, 2)});
     return 0;
 }
 
@@ -1787,10 +1822,9 @@ std::pair TLuaInterpreter::getTActionFromIdOrName(lua_State* L, c
 int TLuaInterpreter::findItems(lua_State* L)
 {
     const int n = lua_gettop(L);
-    const auto name = getVerifiedString(L, __func__, 1, "item name");
-    // Although we only use 6 ASCII strings the user may not enter a purely
-    // ASCII value which we might have to report...
-    const QString type = getVerifiedString(L, __func__, 2, "item type");
+    if (!checkStringArg(L, __func__, 1, "item name") || !checkStringArg(L, __func__, 2, "item type")) {
+        return lua_error(L);
+    }
     bool exactMatch = true;
     bool caseSensitive = true;
     if (n > 2) {
@@ -1799,6 +1833,10 @@ int TLuaInterpreter::findItems(lua_State* L)
     if (n > 3) {
         caseSensitive = getVerifiedBool(L, __func__, 4, "case sensitive", true);
     }
+    const auto name = QString{lua_tostring(L, 1)};
+    // Although we only use 6 ASCII strings the user may not enter a purely
+    // ASCII value which we might have to report...
+    const QString type{lua_tostring(L, 2)};
     Host& host = getHostFromLua(L);
     auto generateList = [](const auto vector, auto l) {
         lua_newtable(l);
@@ -1922,333 +1960,339 @@ int TLuaInterpreter::isAncestorsActive(lua_State* L)
 }
 
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#ancestors
+// returned by the helper lambdas below in place of a Lua return count: the
+// message is already on the stack and the caller is expected to raise it
+static constexpr int csmErrorAlreadyPushed = -1;
+
 int TLuaInterpreter::ancestors(lua_State* L)
 {
-    auto id = getVerifiedInt(L, __func__, 1, "item ID");
-    // Although we only use ASCII strings for the type the user may not enter a
-    // purely ASCII value which we might have to report...
-    QString type = getVerifiedString(L, __func__, 2, "item type");
-    if (id < 0) {
-        // Must be zero or more but doesn't seem to be:
-        return warnArgumentValue(L, __func__, qsl("item ID as %1 does not seem to be parseable as a positive integer").arg(lua_tostring(L, 1)));
-    }
-
-    Host& host = getHostFromLua(L);
-    // Remember, QString::compare(...) returns zero for a match:
-    QString typeCheck{QLatin1String("timer")};
-    if (!type.compare(typeCheck, Qt::CaseInsensitive)) {
-        auto pT = host.getTimerUnit()->getTimer(id);
-        if (!pT) {
-            return warnArgumentValue(L, __func__, qsl("%1 item ID %2 does not exist").arg(typeCheck, QString::number(id)));
+    // the type QStrings must be destroyed before the raise, so the internal
+    // error paths report back instead of raising - see checkStringArg()
+    const int results = [&L, functionName = __func__]() -> int {
+        auto id = getVerifiedInt(L, functionName, 1, "item ID");
+        // Although we only use ASCII strings for the type the user may not enter a
+        // purely ASCII value which we might have to report...
+        QString type = getVerifiedString(L, functionName, 2, "item type");
+        if (id < 0) {
+            // Must be zero or more but doesn't seem to be:
+            return warnArgumentValue(L, functionName, qsl("item ID as %1 does not seem to be parseable as a positive integer").arg(lua_tostring(L, 1)));
         }
-        const auto ancestorsList = pT->getAncestorList();
-        lua_newtable(L);
-        int index = 0;
-        for (const auto pAncestor : ancestorsList) {
-            if (!pAncestor) {
-                // Uh oh! This is not expected, so clear that table off the
-                // stack so we can push an error message there:
-                lua_pop(L, 1);
-                lua_pushfstring(L, "%s: internal error, got a nullptr whilst looking for an ancestor of the %s with ID: %i", __func__, typeCheck.toLatin1().constData(), id);
-                lua_error(L);
-                Q_UNREACHABLE();
+
+        Host& host = getHostFromLua(L);
+        // Remember, QString::compare(...) returns zero for a match:
+        QString typeCheck{QLatin1String("timer")};
+        if (!type.compare(typeCheck, Qt::CaseInsensitive)) {
+            auto pT = host.getTimerUnit()->getTimer(id);
+            if (!pT) {
+                return warnArgumentValue(L, functionName, qsl("%1 item ID %2 does not exist").arg(typeCheck, QString::number(id)));
             }
-            lua_pushnumber(L, ++index);
+            const auto ancestorsList = pT->getAncestorList();
             lua_newtable(L);
-            {
-                // We are confining ourselves to a small set of details here
-                // enough to help to build a table of the items perhaps but
-                // something to provide more details about each of the diffent
-                // item types (once the user knows which IDs/names to use to
-                // get them) would probably be a good idea as well:
-                lua_pushstring(L, "id");
-                lua_pushnumber(L, pAncestor->getID());
-                lua_settable(L, -3);
+            int index = 0;
+            for (const auto pAncestor : ancestorsList) {
+                if (!pAncestor) {
+                    // Uh oh! This is not expected, so clear that table off the
+                    // stack so we can push an error message there:
+                    lua_pop(L, 1);
+                    lua_pushfstring(L, "%s: internal error, got a nullptr whilst looking for an ancestor of the %s with ID: %i", functionName, typeCheck.toLatin1().constData(), id);
+                    return csmErrorAlreadyPushed;
+                }
+                lua_pushnumber(L, ++index);
+                lua_newtable(L);
+                {
+                    // We are confining ourselves to a small set of details here
+                    // enough to help to build a table of the items perhaps but
+                    // something to provide more details about each of the diffent
+                    // item types (once the user knows which IDs/names to use to
+                    // get them) would probably be a good idea as well:
+                    lua_pushstring(L, "id");
+                    lua_pushnumber(L, pAncestor->getID());
+                    lua_settable(L, -3);
 
-                lua_pushstring(L, "name");
-                lua_pushstring(L, pAncestor->getName().toUtf8().constData());
-                lua_settable(L, -3);
+                    lua_pushstring(L, "name");
+                    lua_pushstring(L, pAncestor->getName().toUtf8().constData());
+                    lua_settable(L, -3);
 
-                lua_pushstring(L, "node");
-                if (pAncestor->isFolder()) {
-                    if (!pAncestor->mPackageName.isEmpty() && pAncestor->mPackageName == pAncestor->getName()) {
-                        lua_pushstring(L, "package");
+                    lua_pushstring(L, "node");
+                    if (pAncestor->isFolder()) {
+                        if (!pAncestor->mPackageName.isEmpty() && pAncestor->mPackageName == pAncestor->getName()) {
+                            lua_pushstring(L, "package");
+                        } else {
+                            lua_pushstring(L, "group");
+                        }
                     } else {
-                        lua_pushstring(L, "group");
+                        // offset timers have a parent node that is NOT a group!
+                        lua_pushstring(L, "item");
                     }
-                } else {
-                    // offset timers have a parent node that is NOT a group!
-                    lua_pushstring(L, "item");
+                    lua_settable(L, -3);
+
+                    lua_pushstring(L, "isActive");
+                    // Offset timer have their active state recorded differently
+                    lua_pushboolean(L, pAncestor->isOffsetTimer() ? pAncestor->shouldBeActive() : pAncestor->isActive());
+                    lua_settable(L, -3);
                 }
                 lua_settable(L, -3);
-
-                lua_pushstring(L, "isActive");
-                // Offset timer have their active state recorded differently
-                lua_pushboolean(L, pAncestor->isOffsetTimer() ? pAncestor->shouldBeActive() : pAncestor->isActive());
-                lua_settable(L, -3);
             }
-            lua_settable(L, -3);
+
+            return 1;
         }
 
-        return 1;
-    }
-
-    typeCheck = QLatin1String("trigger");
-    if (!type.compare(typeCheck, Qt::CaseInsensitive)) {
-        auto pT = host.getTriggerUnit()->getTrigger(id);
-        if (!pT) {
-            return warnArgumentValue(L, __func__, qsl("%1 item ID %2 does not exist").arg(typeCheck, QString::number(id)));
-        }
-        const auto ancestorsList = pT->getAncestorList();
-        lua_newtable(L);
-        int index = 0;
-        for (const auto pAncestor : ancestorsList) {
-            if (!pAncestor) {
-                // Uh oh! This is not expected, so clear that table off the
-                // stack so we can push an error message there:
-                lua_pop(L, 1);
-                lua_pushfstring(L, "%s: internal error, got a nullptr whilst looking for an ancestor of the %s with ID: %i", __func__, typeCheck.toLatin1().constData(), id);
-                lua_error(L);
-                Q_UNREACHABLE();
+        typeCheck = QLatin1String("trigger");
+        if (!type.compare(typeCheck, Qt::CaseInsensitive)) {
+            auto pT = host.getTriggerUnit()->getTrigger(id);
+            if (!pT) {
+                return warnArgumentValue(L, functionName, qsl("%1 item ID %2 does not exist").arg(typeCheck, QString::number(id)));
             }
-            lua_pushnumber(L, ++index);
+            const auto ancestorsList = pT->getAncestorList();
             lua_newtable(L);
-            {
-                lua_pushstring(L, "id");
-                lua_pushnumber(L, pAncestor->getID());
-                lua_settable(L, -3);
+            int index = 0;
+            for (const auto pAncestor : ancestorsList) {
+                if (!pAncestor) {
+                    // Uh oh! This is not expected, so clear that table off the
+                    // stack so we can push an error message there:
+                    lua_pop(L, 1);
+                    lua_pushfstring(L, "%s: internal error, got a nullptr whilst looking for an ancestor of the %s with ID: %i", functionName, typeCheck.toLatin1().constData(), id);
+                    return csmErrorAlreadyPushed;
+                }
+                lua_pushnumber(L, ++index);
+                lua_newtable(L);
+                {
+                    lua_pushstring(L, "id");
+                    lua_pushnumber(L, pAncestor->getID());
+                    lua_settable(L, -3);
 
-                lua_pushstring(L, "name");
-                lua_pushstring(L, pAncestor->getName().toUtf8().constData());
-                lua_settable(L, -3);
+                    lua_pushstring(L, "name");
+                    lua_pushstring(L, pAncestor->getName().toUtf8().constData());
+                    lua_settable(L, -3);
 
-                lua_pushstring(L, "node");
-                if (pAncestor->isFolder()) {
-                    if (!pAncestor->mPackageName.isEmpty() && pAncestor->mPackageName == pAncestor->getName()) {
-                        lua_pushstring(L, "package");
+                    lua_pushstring(L, "node");
+                    if (pAncestor->isFolder()) {
+                        if (!pAncestor->mPackageName.isEmpty() && pAncestor->mPackageName == pAncestor->getName()) {
+                            lua_pushstring(L, "package");
+                        } else {
+                            lua_pushstring(L, "group");
+                        }
                     } else {
-                        lua_pushstring(L, "group");
+                        lua_pushstring(L, "item");
                     }
-                } else {
-                    lua_pushstring(L, "item");
+                    lua_settable(L, -3);
+
+                    lua_pushstring(L, "isActive");
+                    lua_pushboolean(L, pAncestor->isActive());
+                    lua_settable(L, -3);
                 }
                 lua_settable(L, -3);
-
-                lua_pushstring(L, "isActive");
-                lua_pushboolean(L, pAncestor->isActive());
-                lua_settable(L, -3);
             }
-            lua_settable(L, -3);
+
+            return 1;
         }
 
-        return 1;
-    }
-
-    typeCheck = QLatin1String("alias");
-    if (!type.compare(typeCheck, Qt::CaseInsensitive)) {
-        auto pT = host.getAliasUnit()->getAlias(id);
-        if (!pT) {
-            return warnArgumentValue(L, __func__, qsl("%1 item ID %2 does not exist").arg(typeCheck, QString::number(id)));
-        }
-        const auto ancestorsList = pT->getAncestorList();
-        lua_newtable(L);
-        int index = 0;
-        for (const auto pAncestor : ancestorsList) {
-            if (!pAncestor) {
-                // Uh oh! This is not expected, so clear that table off the
-                // stack so we can push an error message there:
-                lua_pop(L, 1);
-                lua_pushfstring(L, "%s: internal error, got a nullptr whilst looking for an ancestor of the %s with ID: %i", __func__, typeCheck.toLatin1().constData(), id);
-                lua_error(L);
-                Q_UNREACHABLE();
+        typeCheck = QLatin1String("alias");
+        if (!type.compare(typeCheck, Qt::CaseInsensitive)) {
+            auto pT = host.getAliasUnit()->getAlias(id);
+            if (!pT) {
+                return warnArgumentValue(L, functionName, qsl("%1 item ID %2 does not exist").arg(typeCheck, QString::number(id)));
             }
-            lua_pushnumber(L, ++index);
+            const auto ancestorsList = pT->getAncestorList();
             lua_newtable(L);
-            {
-                lua_pushstring(L, "id");
-                lua_pushnumber(L, pAncestor->getID());
-                lua_settable(L, -3);
+            int index = 0;
+            for (const auto pAncestor : ancestorsList) {
+                if (!pAncestor) {
+                    // Uh oh! This is not expected, so clear that table off the
+                    // stack so we can push an error message there:
+                    lua_pop(L, 1);
+                    lua_pushfstring(L, "%s: internal error, got a nullptr whilst looking for an ancestor of the %s with ID: %i", functionName, typeCheck.toLatin1().constData(), id);
+                    return csmErrorAlreadyPushed;
+                }
+                lua_pushnumber(L, ++index);
+                lua_newtable(L);
+                {
+                    lua_pushstring(L, "id");
+                    lua_pushnumber(L, pAncestor->getID());
+                    lua_settable(L, -3);
 
-                lua_pushstring(L, "name");
-                lua_pushstring(L, pAncestor->getName().toUtf8().constData());
-                lua_settable(L, -3);
+                    lua_pushstring(L, "name");
+                    lua_pushstring(L, pAncestor->getName().toUtf8().constData());
+                    lua_settable(L, -3);
 
-                lua_pushstring(L, "node");
-                if (pAncestor->isFolder()) {
-                    if (!pAncestor->mPackageName.isEmpty() && pAncestor->mPackageName == pAncestor->getName()) {
-                        lua_pushstring(L, "package");
+                    lua_pushstring(L, "node");
+                    if (pAncestor->isFolder()) {
+                        if (!pAncestor->mPackageName.isEmpty() && pAncestor->mPackageName == pAncestor->getName()) {
+                            lua_pushstring(L, "package");
+                        } else {
+                            lua_pushstring(L, "group");
+                        }
                     } else {
-                        lua_pushstring(L, "group");
+                        lua_pushstring(L, "item");
                     }
-                } else {
-                    lua_pushstring(L, "item");
+                    lua_settable(L, -3);
+
+                    lua_pushstring(L, "isActive");
+                    lua_pushboolean(L, pAncestor->isActive());
+                    lua_settable(L, -3);
                 }
                 lua_settable(L, -3);
-
-                lua_pushstring(L, "isActive");
-                lua_pushboolean(L, pAncestor->isActive());
-                lua_settable(L, -3);
             }
-            lua_settable(L, -3);
+
+            return 1;
         }
 
-        return 1;
-    }
-
-    typeCheck = QLatin1String("keybind");
-    if (!type.compare(typeCheck, Qt::CaseInsensitive)) {
-        auto pT = host.getKeyUnit()->getKey(id);
-        if (!pT) {
-            return warnArgumentValue(L, __func__, qsl("%1 item ID %2 does not exist").arg(typeCheck, QString::number(id)));
-        }
-        const auto ancestorsList = pT->getAncestorList();
-        lua_newtable(L);
-        int index = 0;
-        for (const auto pAncestor : ancestorsList) {
-            if (!pAncestor) {
-                // Uh oh! This is not expected, so clear that table off the
-                // stack so we can push an error message there:
-                lua_pop(L, 1);
-                lua_pushfstring(L, "%s: internal error, got a nullptr whilst looking for an ancestor of the %s with ID: %i", __func__, typeCheck.toLatin1().constData(), id);
-                lua_error(L);
-                Q_UNREACHABLE();
+        typeCheck = QLatin1String("keybind");
+        if (!type.compare(typeCheck, Qt::CaseInsensitive)) {
+            auto pT = host.getKeyUnit()->getKey(id);
+            if (!pT) {
+                return warnArgumentValue(L, functionName, qsl("%1 item ID %2 does not exist").arg(typeCheck, QString::number(id)));
             }
-            lua_pushnumber(L, ++index);
+            const auto ancestorsList = pT->getAncestorList();
             lua_newtable(L);
-            {
-                lua_pushstring(L, "id");
-                lua_pushnumber(L, pAncestor->getID());
-                lua_settable(L, -3);
+            int index = 0;
+            for (const auto pAncestor : ancestorsList) {
+                if (!pAncestor) {
+                    // Uh oh! This is not expected, so clear that table off the
+                    // stack so we can push an error message there:
+                    lua_pop(L, 1);
+                    lua_pushfstring(L, "%s: internal error, got a nullptr whilst looking for an ancestor of the %s with ID: %i", functionName, typeCheck.toLatin1().constData(), id);
+                    return csmErrorAlreadyPushed;
+                }
+                lua_pushnumber(L, ++index);
+                lua_newtable(L);
+                {
+                    lua_pushstring(L, "id");
+                    lua_pushnumber(L, pAncestor->getID());
+                    lua_settable(L, -3);
 
-                lua_pushstring(L, "name");
-                lua_pushstring(L, pAncestor->getName().toUtf8().constData());
-                lua_settable(L, -3);
+                    lua_pushstring(L, "name");
+                    lua_pushstring(L, pAncestor->getName().toUtf8().constData());
+                    lua_settable(L, -3);
 
-                lua_pushstring(L, "node");
-                if (pAncestor->isFolder()) {
-                    if (!pAncestor->mPackageName.isEmpty() && pAncestor->mPackageName == pAncestor->getName()) {
-                        lua_pushstring(L, "package");
+                    lua_pushstring(L, "node");
+                    if (pAncestor->isFolder()) {
+                        if (!pAncestor->mPackageName.isEmpty() && pAncestor->mPackageName == pAncestor->getName()) {
+                            lua_pushstring(L, "package");
+                        } else {
+                            lua_pushstring(L, "group");
+                        }
                     } else {
-                        lua_pushstring(L, "group");
+                        lua_pushstring(L, "item");
                     }
-                } else {
-                    lua_pushstring(L, "item");
+                    lua_settable(L, -3);
+
+                    lua_pushstring(L, "isActive");
+                    lua_pushboolean(L, pAncestor->isActive());
+                    lua_settable(L, -3);
                 }
                 lua_settable(L, -3);
-
-                lua_pushstring(L, "isActive");
-                lua_pushboolean(L, pAncestor->isActive());
-                lua_settable(L, -3);
             }
-            lua_settable(L, -3);
+
+            return 1;
         }
 
-        return 1;
-    }
-
-    typeCheck = QLatin1String("button");
-    if (!type.compare(typeCheck, Qt::CaseInsensitive)) {
-        auto pT = host.getActionUnit()->getAction(id);
-        if (!pT) {
-            return warnArgumentValue(L, __func__, qsl("%1 item ID %2 does not exist").arg(typeCheck, QString::number(id)));
-        }
-        const auto ancestorsList = pT->getAncestorList();
-        lua_newtable(L);
-        int index = 0;
-        for (const auto pAncestor : ancestorsList) {
-            if (!pAncestor) {
-                // Uh oh! This is not expected, so clear that table off the
-                // stack so we can push an error message there:
-                lua_pop(L, 1);
-                lua_pushfstring(L, "%s: internal error, got a nullptr whilst looking for an ancestor of the %s with ID: %i", __func__, typeCheck.toLatin1().constData(), id);
-                lua_error(L);
-                Q_UNREACHABLE();
+        typeCheck = QLatin1String("button");
+        if (!type.compare(typeCheck, Qt::CaseInsensitive)) {
+            auto pT = host.getActionUnit()->getAction(id);
+            if (!pT) {
+                return warnArgumentValue(L, functionName, qsl("%1 item ID %2 does not exist").arg(typeCheck, QString::number(id)));
             }
-            lua_pushnumber(L, ++index);
+            const auto ancestorsList = pT->getAncestorList();
             lua_newtable(L);
-            {
-                lua_pushstring(L, "id");
-                lua_pushnumber(L, pAncestor->getID());
-                lua_settable(L, -3);
+            int index = 0;
+            for (const auto pAncestor : ancestorsList) {
+                if (!pAncestor) {
+                    // Uh oh! This is not expected, so clear that table off the
+                    // stack so we can push an error message there:
+                    lua_pop(L, 1);
+                    lua_pushfstring(L, "%s: internal error, got a nullptr whilst looking for an ancestor of the %s with ID: %i", functionName, typeCheck.toLatin1().constData(), id);
+                    return csmErrorAlreadyPushed;
+                }
+                lua_pushnumber(L, ++index);
+                lua_newtable(L);
+                {
+                    lua_pushstring(L, "id");
+                    lua_pushnumber(L, pAncestor->getID());
+                    lua_settable(L, -3);
 
-                lua_pushstring(L, "name");
-                lua_pushstring(L, pAncestor->getName().toUtf8().constData());
-                lua_settable(L, -3);
+                    lua_pushstring(L, "name");
+                    lua_pushstring(L, pAncestor->getName().toUtf8().constData());
+                    lua_settable(L, -3);
 
-                lua_pushstring(L, "node");
-                if (pAncestor->isFolder()) {
-                    if (!pAncestor->mPackageName.isEmpty() && pAncestor->mPackageName == pAncestor->getName()) {
-                        lua_pushstring(L, "package");
+                    lua_pushstring(L, "node");
+                    if (pAncestor->isFolder()) {
+                        if (!pAncestor->mPackageName.isEmpty() && pAncestor->mPackageName == pAncestor->getName()) {
+                            lua_pushstring(L, "package");
+                        } else {
+                            lua_pushstring(L, "group");
+                        }
                     } else {
-                        lua_pushstring(L, "group");
+                        lua_pushstring(L, "item");
                     }
-                } else {
-                    lua_pushstring(L, "item");
+                    lua_settable(L, -3);
+
+                    lua_pushstring(L, "isActive");
+                    lua_pushboolean(L, pAncestor->isActive());
+                    lua_settable(L, -3);
                 }
                 lua_settable(L, -3);
-
-                lua_pushstring(L, "isActive");
-                lua_pushboolean(L, pAncestor->isActive());
-                lua_settable(L, -3);
             }
-            lua_settable(L, -3);
+
+            return 1;
         }
 
-        return 1;
-    }
-
-    typeCheck = QLatin1String("script");
-    if (!type.compare(typeCheck, Qt::CaseInsensitive)) {
-        auto pT = host.getScriptUnit()->getScript(id);
-        if (!pT) {
-            return warnArgumentValue(L, __func__, qsl("%1 item ID %2 does not exist").arg(typeCheck, QString::number(id)));
-        }
-        const auto ancestorsList = pT->getAncestorList();
-        lua_newtable(L);
-        int index = 0;
-        for (const auto pAncestor : ancestorsList) {
-            if (!pAncestor) {
-                // Uh oh! This is not expected, so clear that table off the
-                // stack so we can push an error message there:
-                lua_pop(L, 1);
-                lua_pushfstring(L, "%s: internal error, got a nullptr whilst looking for an ancestor of the %s with ID: %i", __func__, typeCheck.toLatin1().constData(), id);
-                lua_error(L);
-                Q_UNREACHABLE();
+        typeCheck = QLatin1String("script");
+        if (!type.compare(typeCheck, Qt::CaseInsensitive)) {
+            auto pT = host.getScriptUnit()->getScript(id);
+            if (!pT) {
+                return warnArgumentValue(L, functionName, qsl("%1 item ID %2 does not exist").arg(typeCheck, QString::number(id)));
             }
-            lua_pushnumber(L, ++index);
+            const auto ancestorsList = pT->getAncestorList();
             lua_newtable(L);
-            {
-                lua_pushstring(L, "id");
-                lua_pushnumber(L, pAncestor->getID());
-                lua_settable(L, -3);
+            int index = 0;
+            for (const auto pAncestor : ancestorsList) {
+                if (!pAncestor) {
+                    // Uh oh! This is not expected, so clear that table off the
+                    // stack so we can push an error message there:
+                    lua_pop(L, 1);
+                    lua_pushfstring(L, "%s: internal error, got a nullptr whilst looking for an ancestor of the %s with ID: %i", functionName, typeCheck.toLatin1().constData(), id);
+                    return csmErrorAlreadyPushed;
+                }
+                lua_pushnumber(L, ++index);
+                lua_newtable(L);
+                {
+                    lua_pushstring(L, "id");
+                    lua_pushnumber(L, pAncestor->getID());
+                    lua_settable(L, -3);
 
-                lua_pushstring(L, "name");
-                lua_pushstring(L, pAncestor->getName().toUtf8().constData());
-                lua_settable(L, -3);
+                    lua_pushstring(L, "name");
+                    lua_pushstring(L, pAncestor->getName().toUtf8().constData());
+                    lua_settable(L, -3);
 
-                lua_pushstring(L, "node");
-                if (pAncestor->isFolder()) {
-                    if (!pAncestor->mPackageName.isEmpty() && pAncestor->mPackageName == pAncestor->getName()) {
-                        lua_pushstring(L, "package");
+                    lua_pushstring(L, "node");
+                    if (pAncestor->isFolder()) {
+                        if (!pAncestor->mPackageName.isEmpty() && pAncestor->mPackageName == pAncestor->getName()) {
+                            lua_pushstring(L, "package");
+                        } else {
+                            lua_pushstring(L, "group");
+                        }
                     } else {
-                        lua_pushstring(L, "group");
+                        lua_pushstring(L, "item");
                     }
-                } else {
-                    lua_pushstring(L, "item");
+                    lua_settable(L, -3);
+
+                    lua_pushstring(L, "isActive");
+                    lua_pushboolean(L, pAncestor->isActive());
+                    lua_settable(L, -3);
                 }
                 lua_settable(L, -3);
-
-                lua_pushstring(L, "isActive");
-                lua_pushboolean(L, pAncestor->isActive());
-                lua_settable(L, -3);
             }
-            lua_settable(L, -3);
+
+            return 1;
         }
 
-        return 1;
+        return warnArgumentValue(L, functionName, qsl("invalid item type '%1' given, it should be one (case insensitive) of: 'alias', 'button', 'script', 'keybind', 'timer' or 'trigger'").arg(type));
+    }();
+    if (results == csmErrorAlreadyPushed) {
+        return lua_error(L);
     }
-
-    return warnArgumentValue(L, __func__, qsl("invalid item type '%1' given, it should be one (case insensitive) of: 'alias', 'button', 'script', 'keybind', 'timer' or 'trigger'").arg(type));
+    return results;
 }
 
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#getTimestamp
@@ -2256,16 +2300,19 @@ int TLuaInterpreter::getTimestamp(lua_State* L)
 {
     const int n = lua_gettop(L);
     int s = 1;
+    if (n > 1 && !checkStringArg(L, __func__, s++, "mini console, user window or buffer name {may be omitted for the \"main\" console}")) {
+        return lua_error(L);
+    }
+
+    const auto luaLine = getVerifiedInt(L, __func__, s, "line number");
     QString name;
     if (n > 1) {
-        name = getVerifiedString(L, __func__, s++, "mini console, user window or buffer name {may be omitted for the \"main\" console}");
+        name = lua_tostring(L, 1);
         if (name == QLatin1String("main")) {
             // clear it so it is treated as the main console below
             name.clear();
         }
     }
-
-    const auto luaLine = getVerifiedInt(L, __func__, s, "line number");
     if (luaLine < 1) {
         return warnArgumentValue(L, __func__, qsl("line number %1 invalid, it should be greater than zero").arg(luaLine));
     }
@@ -2361,12 +2408,23 @@ void TLuaInterpreter::pushMapLabelPropertiesToLua(lua_State* L, const TMapLabel&
 // room, it would only show one of them at random. Each special exit was listed
 // in its own table (against the key of the exit roomID) and it is a key to a
 // "1" or "0" depending on whether the exit is locked or not. This was not
-// The next three functions are internal helpers for use by
+// The next functions are internal helpers for use by
 // (echo|insert|set)|(Link|Popup) functions
+
+// The non-raising counterpart of the type test in parseCommandOrFunction() - see checkStringArg()
+bool TLuaInterpreter::checkCommandOrFunctionArg(lua_State* L, const char* functionName, const int pos)
+{
+    if (!(lua_isstring(L, pos) || lua_isfunction(L, pos))) {
+        lua_pushfstring(L, "%s: bad argument #%d type (command as string or function expected, got %s!)", functionName, pos, luaL_typename(L, pos));
+        return false;
+    }
+    return true;
+}
+
+// No documentation available in wiki - internal function
 void TLuaInterpreter::parseCommandOrFunction(lua_State* lState, const char* functionName, int& index, QString& command, int& luaFunctionNumber)
 {
-    if (!(lua_isstring(lState, index) || lua_isfunction(lState, index))) {
-        lua_pushfstring(lState, "%s: bad argument #%d type (command as string or function expected, got %s!)", functionName, index, luaL_typename(lState, index));
+    if (!checkCommandOrFunctionArg(lState, functionName, index)) {
         lua_error(lState);
         Q_UNREACHABLE();
     }
@@ -2379,10 +2437,59 @@ void TLuaInterpreter::parseCommandOrFunction(lua_State* lState, const char* func
     command = lua_tostring(lState, index);
 }
 
+// No documentation available in wiki - internal function
+// The non-raising counterpart of parseCommandsOrFunctionsTable() - see
+// checkStringArg(). Validating the whole table up front means the caller's
+// QStringList is not yet populated when a bad item is reported, and no registry
+// reference has been taken that a raise would strand
+bool TLuaInterpreter::checkCommandsOrFunctionsTable(lua_State* L, const char* functionName, const int index)
+{
+    if (!lua_istable(L, index)) {
+        lua_pushfstring(L, "%s: bad argument #%d type (%s as table expected, got %s!)", functionName, index, "commands/functions", luaL_typename(L, index));
+        return false;
+    }
+
+    lua_pushnil(L);
+    int subIndex = 0;
+    while (lua_next(L, index)) {
+        ++subIndex;
+        if (!(lua_isstring(L, -1) || lua_isfunction(L, -1))) {
+            lua_pushfstring(L, "%s: bad item #%d in table argument #%d in type (command as string or function expected, got %s!)", functionName, subIndex, index, luaL_typename(L, -1));
+            return false;
+        }
+        lua_pop(L, 1);
+    }
+    return true;
+}
+
+// No documentation available in wiki - internal function
+// The non-raising counterpart of parseHintsTable() - see checkStringArg()
+bool TLuaInterpreter::checkHintsTable(lua_State* L, const char* functionName, const int index)
+{
+    if (!lua_istable(L, index)) {
+        lua_pushfstring(L, "%s: bad argument #%d type (%s as table expected, got %s!)", functionName, index, "hints", luaL_typename(L, index));
+        return false;
+    }
+
+    lua_pushnil(L);
+    int subIndex = 0;
+    while (lua_next(L, index)) {
+        ++subIndex;
+        if (!lua_isstring(L, -1)) {
+            lua_pushfstring(L, "%s: bad item #%d in table argument #%d in type (hint as string expected, got %s!)", functionName, subIndex, index, luaL_typename(L, -1));
+            return false;
+        }
+        lua_pop(L, 1);
+    }
+    return true;
+}
+
 // No documentation available in wiki - internal function
 void TLuaInterpreter::parseHintsTable(lua_State* lState, const char* functionName, int& index, QStringList& hintList)
 {
     if (!lua_istable(lState, index)) {
+        // dead while every caller gates on checkHintsTable(), which duplicates
+        // this predicate: reaching it would strand the caller's hintList
         lua_pushfstring(lState, "%s: bad argument #%d type (%s as table expected, got %s!)", functionName, index, "hints", luaL_typename(lState, index));
         lua_error(lState);
         Q_UNREACHABLE();
@@ -2395,6 +2502,7 @@ void TLuaInterpreter::parseHintsTable(lua_State* lState, const char* functionNam
         // key at index -2 and value at index -1
         ++subIndex;
         if (!lua_isstring(lState, -1)) {
+            // dead while every caller gates on checkHintsTable() - see above
             lua_pushfstring(lState, "%s: bad item #%d in table argument #%d in type (hint as string expected, got %s!)", functionName, subIndex, index, luaL_typename(lState, -1));
             lua_error(lState);
             Q_UNREACHABLE();
@@ -2412,6 +2520,9 @@ void TLuaInterpreter::parseHintsTable(lua_State* lState, const char* functionNam
 void TLuaInterpreter::parseCommandsOrFunctionsTable(lua_State* lState, const char* functionName, int& index, QStringList& commandsList, QVector& luaFunctionNumbers)
 {
     if (!lua_istable(lState, index)) {
+        // dead while every caller gates on checkCommandsOrFunctionsTable(),
+        // which duplicates this predicate: reaching it would strand the
+        // caller's commandsList and every registry reference taken so far
         lua_pushfstring(lState, "%s: bad argument #%d type (%s as table expected, got %s!)", functionName, index, "commands/functions", luaL_typename(lState, index));
         lua_error(lState);
         Q_UNREACHABLE();
@@ -2424,6 +2535,7 @@ void TLuaInterpreter::parseCommandsOrFunctionsTable(lua_State* lState, const cha
         // key at index -2 and value at index -1
         ++subIndex;
         if (!(lua_isstring(lState, -1) || lua_isfunction(lState, -1))) {
+            // dead while every caller gates on checkCommandsOrFunctionsTable() - see above
             lua_pushfstring(lState, "%s: bad item #%d in table argument #%d in type (command as string or function expected, got %s!)", functionName, subIndex, index, luaL_typename(lState, -1));
             lua_error(lState);
             Q_UNREACHABLE();
@@ -2467,15 +2579,17 @@ int TLuaInterpreter::echo(lua_State* L)
 {
     Host& host = getHostFromLua(L);
 
-    QString consoleName;
     const int n = lua_gettop(L);
     int s = 1;
 
-    if (n > 1) {
-        consoleName = getVerifiedString(L, __func__, s++, "console name", true);
+    if (n > 1 && !checkStringArg(L, __func__, s++, "console name", true)) {
+        return lua_error(L);
     }
-
-    const QString displayText = getVerifiedString(L, __func__, s, "text to display");
+    if (!checkStringArg(L, __func__, s, "text to display")) {
+        return lua_error(L);
+    }
+    const QString consoleName = (n > 1) ? QString{lua_tostring(L, 1)} : QString();
+    const QString displayText{lua_tostring(L, s)};
 
     if (isMain(consoleName)) {
         host.mpConsole->buffer.mEchoingText = true;
@@ -2498,10 +2612,16 @@ int TLuaInterpreter::setMergeTables(lua_State* L)
 {
     Host& host = getHostFromLua(L);
 
-    QStringList modulesList;
     const int n = lua_gettop(L);
-    for (int i = 1; i <= n; i++) {
-        modulesList << getVerifiedString(L, __func__, i, "module");
+    for (int i = 1; i <= n; ++i) {
+        if (!checkStringArg(L, __func__, i, "module")) {
+            return lua_error(L);
+        }
+    }
+
+    QStringList modulesList;
+    for (int i = 1; i <= n; ++i) {
+        modulesList << lua_tostring(L, i);
     }
 
     host.mGMCP_merge_table_keys = host.mGMCP_merge_table_keys + modulesList;
@@ -2513,96 +2633,107 @@ int TLuaInterpreter::setMergeTables(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#getMudletVersion
 int TLuaInterpreter::getMudletVersion(lua_State* L)
 {
-    QByteArray version = QByteArray(APP_VERSION).trimmed();
-    const QByteArray build = mudlet::self()->mAppBuild.trimmed().toLocal8Bit();
+    // the QByteArrays below must be destroyed before the raise, so failures
+    // report back instead of raising - see checkStringArg()
+    const int results = [&L, functionName = __func__]() -> int {
+        QByteArray version = QByteArray(APP_VERSION).trimmed();
+        const QByteArray build = mudlet::self()->mAppBuild.trimmed().toLocal8Bit();
 
-    QList const versionData = version.split('.');
-    if (versionData.size() != 3) {
-        qWarning() << "TLuaInterpreter::getMudletVersion(): ERROR: Version data not correctly set on compilation,\n"
-                   << "   is the VERSION value in the project file present?";
-        lua_pushstring(L, "getMudletVersion: sorry, version information not available.");
-        return lua_error(L);
-    }
-
-    bool ok = true;
-    int major = 0;
-    int minor = 0;
-    int revision = 0;
-    {
-        major = versionData.at(0).toInt(&ok);
-        if (ok) {
-            minor = versionData.at(1).toInt(&ok);
+        QList const versionData = version.split('.');
+        if (versionData.size() != 3) {
+            qWarning() << "TLuaInterpreter::getMudletVersion(): ERROR: Version data not correctly set on compilation,\n"
+                       << "   is the VERSION value in the project file present?";
+            lua_pushstring(L, "getMudletVersion: sorry, version information not available.");
+            return csmErrorAlreadyPushed;
         }
-        if (ok) {
-            revision = versionData.at(2).toInt(&ok);
+
+        bool ok = true;
+        int major = 0;
+        int minor = 0;
+        int revision = 0;
+        {
+            major = versionData.at(0).toInt(&ok);
+            if (ok) {
+                minor = versionData.at(1).toInt(&ok);
+            }
+            if (ok) {
+                revision = versionData.at(2).toInt(&ok);
+            }
+        }
+        if (!ok) {
+            qWarning("TLuaInterpreter::getMudletVersion(): ERROR: Version data not correctly parsed,\n"
+                     "   was the VERSION value in the project file correct at compilation time?");
+            lua_pushstring(L, "getMudletVersion: sorry, version information corrupted.");
+            return csmErrorAlreadyPushed;
         }
-    }
-    if (!ok) {
-        qWarning("TLuaInterpreter::getMudletVersion(): ERROR: Version data not correctly parsed,\n"
-                 "   was the VERSION value in the project file correct at compilation time?");
-        lua_pushstring(L, "getMudletVersion: sorry, version information corrupted.");
-        return lua_error(L);
-    }
 
-    const int n = lua_gettop(L);
+        const int n = lua_gettop(L);
 
-    if (n == 1) {
-        const QString tidiedWhat = getVerifiedString(L, __func__, 1, "style", true).toLower().trimmed();
-        if (tidiedWhat.contains("major")) {
+        if (n == 1) {
+            if (!checkStringArg(L, functionName, 1, "style", true)) {
+                return csmErrorAlreadyPushed;
+            }
+            const QString tidiedWhat = QString{lua_tostring(L, 1)}.toLower().trimmed();
+            if (tidiedWhat.contains("major")) {
+                lua_pushinteger(L, major);
+            } else if (tidiedWhat.contains("minor")) { // NOLINT(readability-else-after-return)
+                lua_pushinteger(L, minor);
+            } else if (tidiedWhat.contains("revision")) { // NOLINT(readability-else-after-return)
+                lua_pushinteger(L, revision);
+            } else if (tidiedWhat.contains("build")) { // NOLINT(readability-else-after-return)
+                if (build.isEmpty()) {
+                    lua_pushnil(L);
+                } else {
+                    lua_pushstring(L, build);
+                }
+            } else if (tidiedWhat.contains("string")) { // NOLINT(readability-else-after-return)
+                if (build.isEmpty()) {
+                    lua_pushstring(L, version.constData());
+                } else {
+                    lua_pushstring(L, version.append(build).constData());
+                }
+            } else if (tidiedWhat.contains("table")) { // NOLINT(readability-else-after-return)
+                lua_pushinteger(L, major);
+                lua_pushinteger(L, minor);
+                lua_pushinteger(L, revision);
+                if (build.isEmpty()) {
+                    lua_pushnil(L);
+                } else {
+                    lua_pushstring(L, build);
+                }
+                return 4;
+            } else { // NOLINT(readability-else-after-return)
+                lua_pushstring(L,
+                               "getMudletVersion: takes one (optional) argument:\n"
+                               "   \"major\", \"minor\", \"revision\", \"build\", \"string\" or \"table\".");
+                return csmErrorAlreadyPushed;
+            }
+        } else if (n == 0) { // NOLINT(readability-else-after-return)
+            lua_newtable(L);
+            lua_pushstring(L, "major");
             lua_pushinteger(L, major);
-        } else if (tidiedWhat.contains("minor")) { // NOLINT(readability-else-after-return)
+            lua_settable(L, -3);
+            lua_pushstring(L, "minor");
             lua_pushinteger(L, minor);
-        } else if (tidiedWhat.contains("revision")) { // NOLINT(readability-else-after-return)
+            lua_settable(L, -3);
+            lua_pushstring(L, "revision");
             lua_pushinteger(L, revision);
-        } else if (tidiedWhat.contains("build")) { // NOLINT(readability-else-after-return)
-            if (build.isEmpty()) {
-                lua_pushnil(L);
-            } else {
-                lua_pushstring(L, build);
-            }
-        } else if (tidiedWhat.contains("string")) { // NOLINT(readability-else-after-return)
-            if (build.isEmpty()) {
-                lua_pushstring(L, version.constData());
-            } else {
-                lua_pushstring(L, version.append(build).constData());
-            }
-        } else if (tidiedWhat.contains("table")) { // NOLINT(readability-else-after-return)
-            lua_pushinteger(L, major);
-            lua_pushinteger(L, minor);
-            lua_pushinteger(L, revision);
-            if (build.isEmpty()) {
-                lua_pushnil(L);
-            } else {
-                lua_pushstring(L, build);
-            }
-            return 4;
+            lua_settable(L, -3);
+            lua_pushstring(L, "build");
+            lua_pushstring(L, mudlet::self()->mAppBuild.trimmed().toUtf8().constData());
+            lua_settable(L, -3);
         } else { // NOLINT(readability-else-after-return)
             lua_pushstring(L,
-                           "getMudletVersion: takes one (optional) argument:\n"
+                           "getMudletVersion: only takes one (optional) argument:\n"
                            "   \"major\", \"minor\", \"revision\", \"build\", \"string\" or \"table\".");
-            return lua_error(L);
+            return csmErrorAlreadyPushed;
         }
-    } else if (n == 0) { // NOLINT(readability-else-after-return)
-        lua_newtable(L);
-        lua_pushstring(L, "major");
-        lua_pushinteger(L, major);
-        lua_settable(L, -3);
-        lua_pushstring(L, "minor");
-        lua_pushinteger(L, minor);
-        lua_settable(L, -3);
-        lua_pushstring(L, "revision");
-        lua_pushinteger(L, revision);
-        lua_settable(L, -3);
-        lua_pushstring(L, "build");
-        lua_pushstring(L, mudlet::self()->mAppBuild.trimmed().toUtf8().constData());
-        lua_settable(L, -3);
-    } else { // NOLINT(readability-else-after-return)
-        lua_pushstring(L,
-                       "getMudletVersion: only takes one (optional) argument:\n"
-                       "   \"major\", \"minor\", \"revision\", \"build\", \"string\" or \"table\".");
+        return 1;
+    }();
+    if (results == csmErrorAlreadyPushed) {
         return lua_error(L);
     }
-    return 1;
+    return results;
 }
 
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#openWebPage
@@ -2618,14 +2749,14 @@ int TLuaInterpreter::getTime(lua_State* L)
 {
     const int n = lua_gettop(L);
     bool return_string = false;
-    QString format = qsl("yyyy.MM.dd hh:mm:ss.zzz");
-    QString tm;
     if (n > 0) {
         return_string = getVerifiedBool(L, __func__, 1, "return as string", true);
-        if (n > 1) {
-            format = getVerifiedString(L, __func__, 2, "custom time format");
+        if (n > 1 && !checkStringArg(L, __func__, 2, "custom time format")) {
+            return lua_error(L);
         }
     }
+    QString format = (n > 1) ? QString{lua_tostring(L, 2)} : qsl("yyyy.MM.dd hh:mm:ss.zzz");
+    QString tm;
     const QDateTime time = QDateTime::currentDateTime();
     if (return_string) {
         tm = time.toString(format);
@@ -2671,13 +2802,15 @@ int TLuaInterpreter::getEpoch(lua_State* L)
 int TLuaInterpreter::addCmdLineBlacklist(lua_State* L)
 {
     const int n = lua_gettop(L);
-    QString name = "main";
+    const char* name = "main";
     if (n > 1) {
         name = CMDLINE_NAME(L, 1);
     }
-    const QString text = getVerifiedString(L, __func__, n, "suggestion text");
-    auto pN = COMMANDLINE(L, name);
-    pN->addBlacklist(text);
+    if (!checkStringArg(L, __func__, n, "suggestion text")) {
+        return lua_error(L);
+    }
+    auto pN = COMMANDLINE(L, QString{name});
+    pN->addBlacklist(QString{lua_tostring(L, n)});
     return 0;
 }
 
@@ -2685,13 +2818,15 @@ int TLuaInterpreter::addCmdLineBlacklist(lua_State* L)
 int TLuaInterpreter::removeCmdLineBlacklist(lua_State* L)
 {
     const int n = lua_gettop(L);
-    QString name = "main";
+    const char* name = "main";
     if (n > 1) {
         name = CMDLINE_NAME(L, 1);
     }
-    const QString text = getVerifiedString(L, __func__, n, "suggestion text");
-    auto pN = COMMANDLINE(L, name);
-    pN->removeBlacklist(text);
+    if (!checkStringArg(L, __func__, n, "suggestion text")) {
+        return lua_error(L);
+    }
+    auto pN = COMMANDLINE(L, QString{name});
+    pN->removeBlacklist(QString{lua_tostring(L, n)});
     return 0;
 }
 
@@ -2699,11 +2834,11 @@ int TLuaInterpreter::removeCmdLineBlacklist(lua_State* L)
 int TLuaInterpreter::clearCmdLineBlacklist(lua_State* L)
 {
     const int n = lua_gettop(L);
-    QString name = "main";
+    const char* name = "main";
     if (n == 1) {
         name = CMDLINE_NAME(L, 1);
     }
-    auto pN = COMMANDLINE(L, name);
+    auto pN = COMMANDLINE(L, QString{name});
     pN->clearBlacklist();
     return 0;
 }
@@ -2871,12 +3006,15 @@ int TLuaInterpreter::getModules(lua_State* L)
 int TLuaInterpreter::getModuleInfo(lua_State* L)
 {
     const Host& host = getHostFromLua(L);
-    auto infoMap = host.mModuleInfo;
     const int n = lua_gettop(L);
-    const QString name = getVerifiedString(L, __func__, 1, "module name");
+    if (!checkStringArg(L, __func__, 1, "module name") || (n > 1 && !checkStringArg(L, __func__, 2, "info", true))) {
+        return lua_error(L);
+    }
+    auto infoMap = host.mModuleInfo;
+    const QString name{lua_tostring(L, 1)};
     QString info;
     if (n > 1) {
-        info = getVerifiedString(L, __func__, 2, "info", true);
+        info = lua_tostring(L, 2);
     }
     if (info.isEmpty()) {
         QMap::const_iterator iter = infoMap.value(name).constBegin();
@@ -2897,12 +3035,15 @@ int TLuaInterpreter::getModuleInfo(lua_State* L)
 int TLuaInterpreter::getPackageInfo(lua_State* L)
 {
     const Host& host = getHostFromLua(L);
-    auto infoMap = host.mPackageInfo;
     const int n = lua_gettop(L);
-    const QString name = getVerifiedString(L, __func__, 1, "package name");
+    if (!checkStringArg(L, __func__, 1, "package name") || (n > 1 && !checkStringArg(L, __func__, 2, "info", true))) {
+        return lua_error(L);
+    }
+    auto infoMap = host.mPackageInfo;
+    const QString name{lua_tostring(L, 1)};
     QString info;
     if (n > 1) {
-        info = getVerifiedString(L, __func__, 2, "info", true);
+        info = lua_tostring(L, 2);
     }
     if (info.isEmpty()) {
         QMap::const_iterator iter = infoMap.value(name).constBegin();
@@ -2923,10 +3064,10 @@ int TLuaInterpreter::getPackageInfo(lua_State* L)
 int TLuaInterpreter::setModuleInfo(lua_State* L)
 {
     Host& host = getHostFromLua(L);
-    const QString moduleName = getVerifiedString(L, __func__, 1, "module name");
-    const QString info = getVerifiedString(L, __func__, 2, "info");
-    const QString value = getVerifiedString(L, __func__, 3, "value");
-    host.mModuleInfo[moduleName][info] = value;
+    if (!checkStringArg(L, __func__, 1, "module name") || !checkStringArg(L, __func__, 2, "info") || !checkStringArg(L, __func__, 3, "value")) {
+        return lua_error(L);
+    }
+    host.mModuleInfo[QString{lua_tostring(L, 1)}][QString{lua_tostring(L, 2)}] = QString{lua_tostring(L, 3)};
     lua_pushboolean(L, true);
     return 1;
 }
@@ -2935,10 +3076,10 @@ int TLuaInterpreter::setModuleInfo(lua_State* L)
 int TLuaInterpreter::setPackageInfo(lua_State* L)
 {
     Host& host = getHostFromLua(L);
-    const QString packageName = getVerifiedString(L, __func__, 1, "package name");
-    const QString info = getVerifiedString(L, __func__, 2, "info");
-    const QString value = getVerifiedString(L, __func__, 3, "value");
-    host.mPackageInfo[packageName][info] = value;
+    if (!checkStringArg(L, __func__, 1, "package name") || !checkStringArg(L, __func__, 2, "info") || !checkStringArg(L, __func__, 3, "value")) {
+        return lua_error(L);
+    }
+    host.mPackageInfo[QString{lua_tostring(L, 1)}][QString{lua_tostring(L, 2)}] = QString{lua_tostring(L, 3)};
     lua_pushboolean(L, true);
     return 1;
 }
@@ -2981,17 +3122,20 @@ int TLuaInterpreter::setDefaultAreaVisible(lua_State* L)
 // this function to get called events.
 int TLuaInterpreter::registerAnonymousEventHandler(lua_State* L)
 {
-    const QString event = getVerifiedString(L, __func__, 1, "event name");
-    const QString func = getVerifiedString(L, __func__, 2, "function name");
+    if (!checkStringArg(L, __func__, 1, "event name") || !checkStringArg(L, __func__, 2, "function name")) {
+        return lua_error(L);
+    }
     Host& host = getHostFromLua(L);
-    host.registerAnonymousEventHandler(event, func);
+    host.registerAnonymousEventHandler(QString{lua_tostring(L, 1)}, QString{lua_tostring(L, 2)});
     return 0;
 }
 
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#expandAlias
 int TLuaInterpreter::expandAlias(lua_State* L)
 {
-    const QString payload = getVerifiedString(L, __func__, 1, "text to parse");
+    if (!checkStringArg(L, __func__, 1, "text to parse")) {
+        return lua_error(L);
+    }
     bool wantPrint = true;
     if (lua_gettop(L) > 1) {
         // check if the 2nd argument is a 'false', but don't match if it is 'nil'
@@ -3002,6 +3146,7 @@ int TLuaInterpreter::expandAlias(lua_State* L)
             wantPrint = getVerifiedBool(L, __func__, 2, "echo", true);
         }
     }
+    const QString payload{lua_tostring(L, 1)};
     Host& host = getHostFromLua(L);
     // Host::send will encode the UTF encoded data here in the wanted Server
     // encoding:
@@ -3026,11 +3171,14 @@ int TLuaInterpreter::sendCmdLine(lua_State* L)
 // encoded in the required Mud Server encoding.
 int TLuaInterpreter::sendRaw(lua_State* L)
 {
-    const QString text = getVerifiedString(L, __func__, 1, "command");
+    if (!checkStringArg(L, __func__, 1, "command")) {
+        return lua_error(L);
+    }
     bool wantPrint = true;
     if (lua_gettop(L) > 1) {
         wantPrint = getVerifiedBool(L, __func__, 2, "showOnScreen", true);
     }
+    const QString text{lua_tostring(L, 1)};
     Host& host = getHostFromLua(L);
     // Host::send will encode the UTF encoded data here in the wanted Server encoding:
     host.send(text, wantPrint, true);
@@ -4944,8 +5092,11 @@ int TLuaInterpreter::performHttpRequest(lua_State* L, const char* functionName,
 // Documentation: https://wiki.mudlet.org/w/Manual:Networking_Functions#unzipAsync
 int TLuaInterpreter::unzipAsync(lua_State* L)
 {
-    const QString zipLocation = getVerifiedString(L, __func__, 1, "zip location");
-    QString extractLocation = getVerifiedString(L, __func__, 2, "extract location");
+    if (!checkStringArg(L, __func__, 1, "zip location") || !checkStringArg(L, __func__, 2, "extract location")) {
+        return lua_error(L);
+    }
+    const QString zipLocation{lua_tostring(L, 1)};
+    QString extractLocation{lua_tostring(L, 2)};
 
     const QTemporaryDir temporaryDir;
     if (!temporaryDir.isValid()) {
@@ -6909,7 +7060,9 @@ int TLuaInterpreter::spellCheckWord(lua_State* L)
     bool hasSharedDictionary = false;
     host.getUserDictionaryOptions(hasUserDictionary, hasSharedDictionary);
 
-    const QString text = getVerifiedString(L, __func__, 1, "word");
+    if (!checkStringArg(L, __func__, 1, "word")) {
+        return lua_error(L);
+    }
 
     bool useUserDictionary = false;
     if (lua_gettop(L) > 1) {
@@ -6918,6 +7071,7 @@ int TLuaInterpreter::spellCheckWord(lua_State* L)
             return warnArgumentValue(L, __func__, "no user dictionary enabled in the preferences for this profile");
         }
     }
+    const QString text{lua_tostring(L, 1)};
 
     Hunhandle* handle = nullptr;
     QByteArray encodedText;
@@ -6945,7 +7099,9 @@ int TLuaInterpreter::spellSuggestWord(lua_State* L)
     bool hasSharedDictionary = false;
     host.getUserDictionaryOptions(hasUserDictionary, hasSharedDictionary);
 
-    const QString text = getVerifiedString(L, __func__, 1, "word");
+    if (!checkStringArg(L, __func__, 1, "word")) {
+        return lua_error(L);
+    }
 
     bool useUserDictionary = false;
     if (lua_gettop(L) > 1) {
@@ -6954,6 +7110,7 @@ int TLuaInterpreter::spellSuggestWord(lua_State* L)
             return warnArgumentValue(L, __func__, "no user dictionary enabled in the preferences for this profile");
         }
     }
+    const QString text{lua_tostring(L, 1)};
 
     char** wordList;
     size_t wordCount = 0;
@@ -7077,20 +7234,23 @@ int TLuaInterpreter::getProfileInformation(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Miscellaneous_Functions#setProfileInformation
 int TLuaInterpreter::setProfileInformation(lua_State* L)
 {
-    QString profileName = getHostFromLua(L).getName();
-    QString text;
     const int params = lua_gettop(L);
 
-    switch (params) {
-    case 1: {
-        text = getVerifiedString(L, __func__, 1, "text");
-        break;
-    }
-    default: {
-        profileName = getVerifiedString(L, __func__, 1, "profile name");
-        text = getVerifiedString(L, __func__, 2, "text");
-        break;
+    if (params == 1) {
+        if (!checkStringArg(L, __func__, 1, "text")) {
+            return lua_error(L);
+        }
+    } else if (!checkStringArg(L, __func__, 1, "profile name") || !checkStringArg(L, __func__, 2, "text")) {
+        return lua_error(L);
     }
+
+    QString profileName = getHostFromLua(L).getName();
+    QString text;
+    if (params == 1) {
+        text = lua_tostring(L, 1);
+    } else {
+        profileName = lua_tostring(L, 1);
+        text = lua_tostring(L, 2);
     }
 
     QPair result = mudlet::self()->writeProfileData(profileName, qsl("description"), text);
@@ -7106,18 +7266,14 @@ int TLuaInterpreter::setProfileInformation(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Miscellaneous_Functions#clearProfileInformation
 int TLuaInterpreter::clearProfileInformation(lua_State* L)
 {
-    QString profileName = getHostFromLua(L).getName();
-    QString desc = "";
     const int params = lua_gettop(L);
-
-    switch (params) {
-    case 0:
-        break;
-    default:
-        profileName = getVerifiedString(L, __func__, 1, "profile name");
-        break;
+    if (params > 0 && !checkStringArg(L, __func__, 1, "profile name")) {
+        return lua_error(L);
     }
 
+    QString profileName = (params > 0) ? QString{lua_tostring(L, 1)} : getHostFromLua(L).getName();
+    QString desc = "";
+
     // if this is a default game, return to the orginal text
     auto itDetails = TGameDetails::findGame(profileName);
     if (itDetails != TGameDetails::scmDefaultGames.constEnd()) {
@@ -7505,15 +7661,15 @@ int TLuaInterpreter::setMapRoomExitsColor(lua_State* L)
 int TLuaInterpreter::showNotification(lua_State* L)
 {
     const int n = lua_gettop(L);
-    const QString title = getVerifiedString(L, __func__, 1, "title");
-    QString text = title;
-    if (n >= 2) {
-        text = getVerifiedString(L, __func__, 2, "message");
+    if (!checkStringArg(L, __func__, 1, "title") || (n >= 2 && !checkStringArg(L, __func__, 2, "message")) || (n >= 3 && !checkNumberArg(L, __func__, 3, "expiration time in seconds"))) {
+        return lua_error(L);
     }
     std::optional notificationExpirationTime;
     if (n >= 3) {
-        notificationExpirationTime = qMax(qRound(getVerifiedDouble(L, __func__, 3, "expiration time in seconds") * 1000), 1000);
+        notificationExpirationTime = qMax(qRound(lua_tonumber(L, 3) * 1000), 1000);
     }
+    const QString title{lua_tostring(L, 1)};
+    const QString text = (n >= 2) ? QString{lua_tostring(L, 2)} : title;
 
     mudlet::self()->mTrayIcon.show();
     if (notificationExpirationTime.has_value()) {
@@ -8030,23 +8186,18 @@ int TLuaInterpreter::setConfig(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#announce
 int TLuaInterpreter::announce(lua_State* L)
 {
-    const QString text = getVerifiedString(L, __func__, 1, "text to announce");
     static const QStringList processingKinds{"importantall", "importantmostrecent", "all", "mostrecent", "currentthenmostrecent"};
-    QString processing;
-
     const int n = lua_gettop(L);
-    if (n > 1) {
-        // while this only has effect on Windows, it should fail silently in order not to spam
-        processing = getVerifiedString(L, __func__, 2, "processing style");
-
-        if (!processingKinds.contains(processing)) {
-            lua_pushfstring(
-                    L, "%s: bad argument #%d type (processing should be one of %s, got %s!)", __func__, 2, processingKinds.join(qsl(", ")).toUtf8().constData(), processing.toUtf8().constData());
-            return lua_error(L);
-        }
+    if (!checkStringArg(L, __func__, 1, "text to announce") || (n > 1 && !checkStringArg(L, __func__, 2, "processing style"))) {
+        return lua_error(L);
+    }
+    // while this only has effect on Windows, it should fail silently in order not to spam
+    if (n > 1 && !processingKinds.contains(QLatin1StringView{lua_tostring(L, 2)})) {
+        lua_pushfstring(L, "%s: bad argument #%d type (processing should be one of %s, got %s!)", __func__, 2, processingKinds.join(qsl(", ")).toUtf8().constData(), lua_tostring(L, 2));
+        return lua_error(L);
     }
 
-    mudlet::self()->announce(text, processing, true);
+    mudlet::self()->announce(QString{lua_tostring(L, 1)}, (n > 1) ? QString{lua_tostring(L, 2)} : QString(), true);
     return 0;
 }
 
@@ -8446,11 +8597,11 @@ int TLuaInterpreter::getSaveCommandHistory(lua_State* L)
         lua_pushstring(L, "disabled by profile global preference");
         return 2;
     }
-    QString name = QLatin1String("main");
+    const char* name = "main";
     if (lua_gettop(L)) {
         name = CMDLINE_NAME(L, 1);
     }
-    auto pCommandline = COMMANDLINE(L, name);
+    auto pCommandline = COMMANDLINE(L, QString{name});
     lua_pushboolean(L, pCommandline->mSaveCommands);
     lua_pushstring(L, (pCommandline->mSaveCommands ? qsl("enabled (%1 lines will be saved)").arg(QString::number(numberOfLines)) : qsl("disabled")).toUtf8().constData());
     return 2;
@@ -8468,7 +8619,7 @@ int TLuaInterpreter::setSaveCommandHistory(lua_State* L)
         // profile:
         return warnArgumentValue(L, __func__, "disabled by profile global preference");
     }
-    QString name = QLatin1String("main");
+    const char* name = "main";
     bool saveCommands = true;
     // if there is no arguments we will set the "save command history" on the
     // main  command line:
@@ -8492,7 +8643,7 @@ int TLuaInterpreter::setSaveCommandHistory(lua_State* L)
         }
     }
 
-    auto pCommandline = COMMANDLINE(L, name);
+    auto pCommandline = COMMANDLINE(L, QString{name});
     pCommandline->mSaveCommands = saveCommands;
     lua_pushboolean(L, true);
     return 1;
diff --git a/src/TLuaInterpreter.h b/src/TLuaInterpreter.h
index 2e8c284c9..c6c23dbdb 100644
--- a/src/TLuaInterpreter.h
+++ b/src/TLuaInterpreter.h
@@ -826,6 +826,11 @@ private:
     static bool checkStringArg(lua_State*, const char* functionName, const int pos, const char* publicName, const bool isOptional = false);
     static bool checkIntArg(lua_State*, const char* functionName, const int pos, const char* publicName, const bool isOptional = false);
     static bool checkBoolArg(lua_State*, const char* functionName, const int pos, const char* publicName, const bool isOptional = false);
+    static bool checkNumberArg(lua_State*, const char* functionName, const int pos, const char* publicName, const bool isOptional = false);
+    static bool checkStringOrIntegerArg(lua_State*, const char* functionName, const int pos, const char* publicName, const bool isOptional = false);
+    static bool checkCommandOrFunctionArg(lua_State*, const char* functionName, const int pos);
+    static bool checkCommandsOrFunctionsTable(lua_State*, const char* functionName, const int index);
+    static bool checkHintsTable(lua_State*, const char* functionName, const int index);
     static int getVerifiedInt(lua_State*, const char* functionName, const int pos, const char* publicName, const bool isOptional = false);
     static float getVerifiedFloat(lua_State*, const char* functionName, const int pos, const char* publicName, const bool isOptional = false);
     static double getVerifiedDouble(lua_State*, const char* functionName, const int pos, const char* publicName, const bool isOptional = false);
@@ -833,8 +838,8 @@ private:
     static void errorArgumentType(lua_State*, const char* functionName, const int pos, const char* publicName, const char* publicType, const bool isOptional = false);
     static int warnArgumentValue(lua_State*, const char* functionName, const QString& message, const bool useFalseInsteadofNil = false);
     static int warnArgumentValue(lua_State*, const char* functionName, const char* message, const bool useFalseInsteadofNil = false);
-    static int setLabelCallback(lua_State*, const QString& funcName);
-    static int movieFunc(lua_State*, const QString& funcName);
+    static int setLabelCallback(lua_State*, const char* funcName);
+    static int movieFunc(lua_State*, const char* funcName);
     static std::pair discordApiEnabled(lua_State*, bool writeAccess = false);
     static void setRequestDefaults(const QUrl& url, QNetworkRequest& request);
     static int performHttpRequest(lua_State*, const char* functionName, const int pos, QNetworkAccessManager::Operation operation, const char* verb);
diff --git a/src/TLuaInterpreterDiscord.cpp b/src/TLuaInterpreterDiscord.cpp
index c1d8d7d7e..e9ad46333 100644
--- a/src/TLuaInterpreterDiscord.cpp
+++ b/src/TLuaInterpreterDiscord.cpp
@@ -371,11 +371,21 @@ int TLuaInterpreter::setDiscordGameUrl(lua_State* L)
         lua_pushboolean(L, true);
         return 1;
     }
-    QString inputText = getVerifiedString(L, __func__, 1, "url").trimmed();
-    host.setDiscordInviteURL(inputText.isEmpty() ? QString() : inputText);
+    // argument 1 is applied before argument 2 is checked, as it was before:
+    // setDiscordInviteURL() persists to the profile, and hoisting the second
+    // check above it would stop a bad game name from saving the URL
+    if (!checkStringArg(L, __func__, 1, "url")) {
+        return lua_error(L);
+    }
+    {
+        const QString inviteUrl = QString{lua_tostring(L, 1)}.trimmed();
+        host.setDiscordInviteURL(inviteUrl.isEmpty() ? QString() : inviteUrl);
+    }
     if (args > 1) {
-        inputText = getVerifiedString(L, __func__, 2, "game name").trimmed();
-        host.setDiscordGameName(inputText);
+        if (!checkStringArg(L, __func__, 2, "game name")) {
+            return lua_error(L);
+        }
+        host.setDiscordGameName(QString{lua_tostring(L, 2)}.trimmed());
     } else {
         host.setDiscordGameName(QString());
     }
diff --git a/src/TLuaInterpreterMMCP.cpp b/src/TLuaInterpreterMMCP.cpp
index 8a409e70c..65310a8f7 100644
--- a/src/TLuaInterpreterMMCP.cpp
+++ b/src/TLuaInterpreterMMCP.cpp
@@ -30,8 +30,11 @@
 int TLuaInterpreter::mmcpChatTo(lua_State* L)
 {
     const char* sFunc = "mmcp.chatTo";
-    const QString target = getVerifiedString(L, sFunc, 1, "target");
-    const QString msg = getVerifiedString(L, sFunc, 2, "message");
+    if (!checkStringArg(L, sFunc, 1, "target") || !checkStringArg(L, sFunc, 2, "message")) {
+        return lua_error(L);
+    }
+    const QString target{lua_tostring(L, 1)};
+    const QString msg{lua_tostring(L, 2)};
 
     Host* pHost = &getHostFromLua(L);
     if (!pHost->mMMCPServer) {
@@ -107,17 +110,23 @@ int TLuaInterpreter::mmcpAllowSnoop(lua_State* L)
 int TLuaInterpreter::mmcpCall(lua_State* L)
 {
     const char* sFunc = "mmcp.call";
-    const QString host = getVerifiedString(L, sFunc, 1, "host");
+    if (!checkStringArg(L, sFunc, 1, "host")) {
+        return lua_error(L);
+    }
     int port = csDefaultMMCPHostPort;
 
     const int n = lua_gettop(L);
     if (n > 1) {
-        port = getVerifiedInt(L, sFunc, 2, qsl("port number {default = %1}").arg(csDefaultMMCPHostPort).toUtf8().constData(), true);
+        // static: a temporary here would be alive inside getVerifiedInt() when
+        // it raises - see checkStringArg()
+        static const QByteArray portName = qsl("port number {default = %1}").arg(csDefaultMMCPHostPort).toUtf8();
+        port = getVerifiedInt(L, sFunc, 2, portName.constData(), true);
         if (port > 65535 || port < 1) {
             return warnArgumentValue(L, sFunc, qsl("invalid port number %1 given, if supplied it must be in range 1 to 65535").arg(port));
         }
     }
 
+    const QString host{lua_tostring(L, 1)};
     Host* pHost = &getHostFromLua(L);
     if (!pHost->mMMCPServer) {
         pHost->initMMCPServer();
@@ -186,8 +195,11 @@ int TLuaInterpreter::mmcpEmoteAll(lua_State* L)
 int TLuaInterpreter::mmcpChatGroup(lua_State* L)
 {
     const char* sFunc = "mmcp.chatGroup";
-    const QString group = getVerifiedString(L, sFunc, 1, "group");
-    const QString msg = getVerifiedString(L, sFunc, 2, "message");
+    if (!checkStringArg(L, sFunc, 1, "group") || !checkStringArg(L, sFunc, 2, "message")) {
+        return lua_error(L);
+    }
+    const QString group{lua_tostring(L, 1)};
+    const QString msg{lua_tostring(L, 2)};
 
     Host* pHost = &getHostFromLua(L);
     if (!pHost->mMMCPServer) {
@@ -363,8 +375,11 @@ int TLuaInterpreter::mmcpServe(lua_State* L)
 int TLuaInterpreter::mmcpSetGroup(lua_State* L)
 {
     const char* sFunc = "mmcp.setGroup";
-    const QString target = getVerifiedString(L, sFunc, 1, "target");
-    const QString group = getVerifiedString(L, sFunc, 2, "group");
+    if (!checkStringArg(L, sFunc, 1, "target") || !checkStringArg(L, sFunc, 2, "group")) {
+        return lua_error(L);
+    }
+    const QString target{lua_tostring(L, 1)};
+    const QString group{lua_tostring(L, 2)};
 
     Host* pHost = &getHostFromLua(L);
     if (!pHost->mMMCPServer) {
@@ -383,8 +398,11 @@ int TLuaInterpreter::mmcpSetGroup(lua_State* L)
 int TLuaInterpreter::mmcpSendSideChannel(lua_State* L)
 {
     const char* sFunc = "mmcp.sendSideChannel";
-    const QString channel = getVerifiedString(L, sFunc, 1, "channel");
-    const QString message = getVerifiedString(L, sFunc, 2, "message");
+    if (!checkStringArg(L, sFunc, 1, "channel") || !checkStringArg(L, sFunc, 2, "message")) {
+        return lua_error(L);
+    }
+    const QString channel{lua_tostring(L, 1)};
+    const QString message{lua_tostring(L, 2)};
 
     Host* pHost = &getHostFromLua(L);
     if (!pHost->mMMCPServer) {
@@ -453,8 +471,8 @@ int TLuaInterpreter::mmcpStopServer(lua_State* L)
         if (!result.first) {
             return warnArgumentValue(L, sFunc, result.second.toUtf8().constData());
         }
-    } 
-    
+    }
+
     lua_pushboolean(L, true);
     return 1;
 }
@@ -478,7 +496,8 @@ int TLuaInterpreter::mmcpDisconnect(lua_State* L)
     return 1;
 }
 
-int TLuaInterpreter::mmcpGetClientList(lua_State* L) {
+int TLuaInterpreter::mmcpGetClientList(lua_State* L)
+{
     Host* pHost = &getHostFromLua(L);
 
     if (!pHost->mMMCPServer) {
@@ -524,10 +543,10 @@ int TLuaInterpreter::mmcpGetClientList(lua_State* L) {
         lua_pushstring(L, pClient->getVersion().toUtf8().constData());
         lua_settable(L, -3);
 
-        
+
         lua_pushnumber(L, ++i); // Push outer table key (index)
-        lua_insert(L, -2);  // Swap the inner table and key so that the table is on top
-        lua_settable(L, -3);   // Set the inner table in the outer table.
+        lua_insert(L, -2);      // Swap the inner table and key so that the table is on top
+        lua_settable(L, -3);    // Set the inner table in the outer table.
     }
 
     return 1;
diff --git a/src/TLuaInterpreterMapper.cpp b/src/TLuaInterpreterMapper.cpp
index f1338606b..dba99ce56 100644
--- a/src/TLuaInterpreterMapper.cpp
+++ b/src/TLuaInterpreterMapper.cpp
@@ -306,10 +306,7 @@ int TLuaInterpreter::addCustomLine(lua_State* L)
     int g = 0;
     int b = 0;
     Qt::PenStyle line_style(Qt::SolidLine);
-    QString direction;
-    QList x;
-    QList y;
-    QList z;
+    TRoom* pR_to = nullptr;
     const int id_from = getVerifiedInt(L, __func__, 1, "roomID");
     TRoom* pR = host.mpMap->mpRoomDB->getRoom(id_from);
     if (!pR) {
@@ -322,7 +319,7 @@ int TLuaInterpreter::addCustomLine(lua_State* L)
     }
     if (lua_isnumber(L, 2)) {
         id_to = static_cast(lua_tointeger(L, 2));
-        TRoom* pR_to = host.mpMap->mpRoomDB->getRoom(id_to);
+        pR_to = host.mpMap->mpRoomDB->getRoom(id_to);
         if (!pR_to) {
             return warnArgumentValue(L, __func__, qsl("number %1 is not a valid target roomID").arg(id_to));
         }
@@ -335,13 +332,12 @@ int TLuaInterpreter::addCustomLine(lua_State* L)
                     qsl("target room is in area '%1' (ID: %2) which is not the one '%3' (ID: %4) in which this custom line is to be drawn")
                             .arg((host.mpMap->mpRoomDB->getAreaNamesMap()).value(area_to), QString::number(area_to), (host.mpMap->mpRoomDB->getAreaNamesMap()).value(area), QString::number(area)));
         }
-
-        x.append(static_cast(pR_to->x()));
-        y.append(static_cast(pR_to->y()));
-        z.append(pR->z());
     } else if (lua_istable(L, 2)) {
         lua_pushnil(L);
         int i = 0; // Indexes groups of coordinates in the table
+        int xCount = 0;
+        int yCount = 0;
+        int zCount = 0;
         while (lua_next(L, 2) != 0) {
             ++i;
             if (lua_type(L, -1) != LUA_TTABLE) {
@@ -382,13 +378,13 @@ int TLuaInterpreter::addCustomLine(lua_State* L)
                     }
                     switch (j) {
                     case 1:
-                        x.append(lua_tonumber(L, -1));
+                        ++xCount;
                         break;
                     case 2:
-                        y.append(lua_tonumber(L, -1));
+                        ++yCount;
                         break;
                     case 3:
-                        z.append(static_cast(lua_tonumber(L, -1)));
+                        ++zCount;
                         break;
                     default:; // No-op
                     }
@@ -397,14 +393,14 @@ int TLuaInterpreter::addCustomLine(lua_State* L)
             }
             lua_pop(L, 1);
         }
-        if (!i || x.isEmpty()) {
+        if (!i || !xCount) {
             // If there is only an empty sub-table inside the table then i is
-            // one but there is nothing in any of the QLists and things will
-            // still blow up as per Issue #5272 - so also check for at least one
+            // one but there is no coordinate at all and things will still blow
+            // up as per Issue #5272 - so also check for at least one
             // x-coordinate value:
             return warnArgumentValue(L, __func__, "missing coordinates to create the line to");
         }
-        if (x.count() != y.count() || x.count() != z.count()) {
+        if (xCount != yCount || xCount != zCount) {
             return warnArgumentValue(L,
                                      __func__,
                                      "mismatch in numbers of coordinates for the points for the custom line given in table as second argument; each must contain three coordinates, i.e. x, y AND z "
@@ -412,28 +408,35 @@ int TLuaInterpreter::addCustomLine(lua_State* L)
         }
     }
 
-    direction = dirToString(L, 3);
-    if (direction.isEmpty()) {
-        lua_pushfstring(L, "addCustomLine: bad argument #3 type (direction as string or number (between 1 and 12 inclusive) expected, got %s!)", luaL_typename(L, 3));
-        return lua_error(L);
-    }
-    if (!pR->hasExitOrSpecialExit(direction)) {
-        return warnArgumentValue(L, __func__, qsl("roomID %1 does not have an exit in a direction that can be identified from '%2'").arg(QString::number(id_from), lua_tostring(L, 3)));
+    {
+        const QString direction = dirToString(L, 3);
+        if (direction.isEmpty()) {
+            lua_pushfstring(L, "addCustomLine: bad argument #3 type (direction as string or number (between 1 and 12 inclusive) expected, got %s!)", luaL_typename(L, 3));
+            return lua_error(L);
+        }
+        if (!pR->hasExitOrSpecialExit(direction)) {
+            return warnArgumentValue(L, __func__, qsl("roomID %1 does not have an exit in a direction that can be identified from '%2'").arg(QString::number(id_from), lua_tostring(L, 3)));
+        }
     }
 
-    const QString lineStyleString = getVerifiedString(L, __func__, 4, "line style");
-    if (!lineStyleString.compare(QLatin1String("solid line"))) {
-        line_style = Qt::SolidLine;
-    } else if (!lineStyleString.compare(QLatin1String("dot line"))) {
-        line_style = Qt::DotLine;
-    } else if (!lineStyleString.compare(QLatin1String("dash line"))) {
-        line_style = Qt::DashLine;
-    } else if (!lineStyleString.compare(QLatin1String("dash dot line"))) {
-        line_style = Qt::DashDotLine;
-    } else if (!lineStyleString.compare(QLatin1String("dash dot dot line"))) {
-        line_style = Qt::DashDotDotLine;
-    } else {
-        return warnArgumentValue(L, __func__, qsl("invalid line style '%1', only use one of: 'solid line', 'dot line', 'dash line', 'dash dot line' or 'dash dot dot line'").arg(lineStyleString));
+    if (!checkStringArg(L, __func__, 4, "line style")) {
+        return lua_error(L);
+    }
+    {
+        const QString lineStyleString{lua_tostring(L, 4)};
+        if (!lineStyleString.compare(QLatin1String("solid line"))) {
+            line_style = Qt::SolidLine;
+        } else if (!lineStyleString.compare(QLatin1String("dot line"))) {
+            line_style = Qt::DotLine;
+        } else if (!lineStyleString.compare(QLatin1String("dash line"))) {
+            line_style = Qt::DashLine;
+        } else if (!lineStyleString.compare(QLatin1String("dash dot line"))) {
+            line_style = Qt::DashDotLine;
+        } else if (!lineStyleString.compare(QLatin1String("dash dot dot line"))) {
+            line_style = Qt::DashDotDotLine;
+        } else {
+            return warnArgumentValue(L, __func__, qsl("invalid line style '%1', only use one of: 'solid line', 'dot line', 'dash line', 'dash dot line' or 'dash dot dot line'").arg(lineStyleString));
+        }
     }
 
     if (!lua_istable(L, 5)) {
@@ -478,6 +481,38 @@ int TLuaInterpreter::addCustomLine(lua_State* L)
     }
 
     const bool arrow = getVerifiedBool(L, __func__, 6, "end with arrow");
+
+    QList x;
+    QList y;
+    QList z;
+    if (pR_to) {
+        x.append(static_cast(pR_to->x()));
+        y.append(static_cast(pR_to->y()));
+        z.append(pR->z());
+    } else {
+        lua_pushnil(L);
+        while (lua_next(L, 2) != 0) {
+            lua_pushnil(L);
+            int j = 0;
+            while (lua_next(L, -2) != 0) {
+                switch (++j) {
+                case 1:
+                    x.append(lua_tonumber(L, -1));
+                    break;
+                case 2:
+                    y.append(lua_tonumber(L, -1));
+                    break;
+                case 3:
+                    z.append(static_cast(lua_tonumber(L, -1)));
+                    break;
+                default:; // No-op
+                }
+                lua_pop(L, 1);
+            }
+            lua_pop(L, 1);
+        }
+    }
+
     const int lz = z.at(0);
     QList points;
     points.append(QPointF(x.at(0), y.at(0)));
@@ -488,6 +523,7 @@ int TLuaInterpreter::addCustomLine(lua_State* L)
         points.append(QPointF(x.at(i), y.at(i)));
     }
 
+    const QString direction = dirToString(L, 3);
     //Heiko: direction/line relationship must be unique
     pR->customLines[direction] = points;
     pR->customLinesArrow[direction] = arrow;
@@ -509,9 +545,12 @@ int TLuaInterpreter::addCustomLine(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#addMapEvent
 int TLuaInterpreter::addMapEvent(lua_State* L)
 {
+    if (!checkStringArg(L, __func__, 1, "uniquename")) {
+        return lua_error(L);
+    }
     QStringList actionInfo;
-    const QString uniqueName = getVerifiedString(L, __func__, 1, "uniquename");
     actionInfo << getVerifiedString(L, __func__, 2, "event name");
+    const QString uniqueName{lua_tostring(L, 1)};
 
     if (!lua_isstring(L, 3)) {
         actionInfo << QString();
@@ -1029,13 +1068,14 @@ int TLuaInterpreter::createMapLabel(lua_State* L)
     bool showOnTop = true;
     bool noScaling = true;
     bool temporary = false;
-    QString fontName;
     int foregroundTransparency = 255;
     int backgroundTransparency = 50;
 
     const int args = lua_gettop(L);
     const int area = getVerifiedInt(L, __func__, 1, "areaID");
-    const QString text = getVerifiedString(L, __func__, 2, "text");
+    if (!checkStringArg(L, __func__, 2, "text")) {
+        return lua_error(L);
+    }
     const float posx = getVerifiedFloat(L, __func__, 3, "posX");
     const float posy = getVerifiedFloat(L, __func__, 4, "posY");
     const float posz = getVerifiedFloat(L, __func__, 5, "posZ");
@@ -1059,8 +1099,8 @@ int TLuaInterpreter::createMapLabel(lua_State* L)
             }
         }
     }
-    if (args > 15) {
-        fontName = getVerifiedString(L, __func__, 16, "fontName", true);
+    if (args > 15 && !checkStringArg(L, __func__, 16, "fontName", true)) {
+        return lua_error(L);
     }
     if (args > 16) {
         foregroundTransparency = getVerifiedInt(L, __func__, 17, "foregroundTransparency", true);
@@ -1078,6 +1118,11 @@ int TLuaInterpreter::createMapLabel(lua_State* L)
     }
 
     const Host& host = getHostFromLua(L);
+    const QString text{lua_tostring(L, 2)};
+    QString fontName;
+    if (args > 15) {
+        fontName = lua_tostring(L, 16);
+    }
     lua_pushinteger(L,
                     host.mpMap->createMapLabel(area,
                                                text,
@@ -1102,7 +1147,9 @@ int TLuaInterpreter::createMapImageLabel(lua_State* L)
 {
     const int args = lua_gettop(L);
     const int area = getVerifiedInt(L, __func__, 1, "areaID");
-    const QString imagePathFileName = getVerifiedString(L, __func__, 2, "imagePathFileName");
+    if (!checkStringArg(L, __func__, 2, "imagePathFileName")) {
+        return lua_error(L);
+    }
     const float posx = getVerifiedFloat(L, __func__, 3, "posX");
     const float posy = getVerifiedFloat(L, __func__, 4, "posY");
     const float posz = getVerifiedFloat(L, __func__, 5, "posZ");
@@ -1116,6 +1163,7 @@ int TLuaInterpreter::createMapImageLabel(lua_State* L)
     }
 
     const Host& host = getHostFromLua(L);
+    const QString imagePathFileName{lua_tostring(L, 2)};
     lua_pushinteger(L, host.mpMap->createMapImageLabel(area, imagePathFileName, posx, posy, posz, width, height, zoom, showOnTop, temporary));
     host.mpMap->updateArea(area);
     return 1;
@@ -1125,20 +1173,15 @@ int TLuaInterpreter::createMapImageLabel(lua_State* L)
 int TLuaInterpreter::createMapper(lua_State* L)
 {
     const int n = lua_gettop(L);
-    QString windowName = "";
+    const bool hasParentWindow = (n > 4);
     int counter = 1;
 
-    if (n > 4) {
+    if (hasParentWindow) {
         if (lua_type(L, 1) != LUA_TSTRING) {
             lua_pushfstring(L, "createMapper: bad argument #1 type (parent window name as string expected, got %s!)", luaL_typename(L, 1));
             return lua_error(L);
         }
-        windowName = lua_tostring(L, 1);
         counter++;
-        if (isMain(windowName)) {
-            // createMapper only accepts the empty name as the main window
-            windowName.clear();
-        }
     }
 
     const int x = getVerifiedInt(L, __func__, counter, "mapper x-coordinate");
@@ -1149,6 +1192,15 @@ int TLuaInterpreter::createMapper(lua_State* L)
     counter++;
     const int height = getVerifiedInt(L, __func__, counter, "mapper height");
 
+    QString windowName = "";
+    if (hasParentWindow) {
+        windowName = lua_tostring(L, 1);
+        if (isMain(windowName)) {
+            // createMapper only accepts the empty name as the main window
+            windowName.clear();
+        }
+    }
+
     const Host& host = getHostFromLua(L);
     if (auto [success, message] = host.mpConsole->createMapper(windowName, x, y, width, height); !success) {
         return warnArgumentValue(L, __func__, message);
@@ -1694,8 +1746,6 @@ int TLuaInterpreter::getExitStubs1(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#getExitStubsNames
 int TLuaInterpreter::getExitStubsNames(lua_State* L)
 {
-    const QStringList stubmap = {"north", "northeast", "northwest", "east", "west", "south", "southeast", "southwest", "up", "down", "in", "out", "other"};
-
     const Host& host = getHostFromLua(L);
     if (!host.mpMap || !host.mpMap->mpRoomDB) {
         return warnArgumentValue(L, __func__, "no map present or loaded");
@@ -1707,6 +1757,7 @@ int TLuaInterpreter::getExitStubsNames(lua_State* L)
     if (!pR) {
         return warnArgumentValue(L, __func__, csmInvalidRoomID.arg(roomId));
     }
+    const QStringList stubmap = {"north", "northeast", "northwest", "east", "west", "south", "southeast", "southwest", "up", "down", "in", "out", "other"};
     QList const stubs = pR->exitStubs;
     lua_newtable(L);
     for (int i = 0, total = stubs.size(); i < total; ++i) {
@@ -2338,11 +2389,14 @@ int TLuaInterpreter::getRoomUserData(lua_State* L)
     }
 
     const int roomId = getVerifiedInt(L, __func__, 1, "roomID");
-    const QString key = getVerifiedString(L, __func__, 2, "key");
+    if (!checkStringArg(L, __func__, 2, "key")) {
+        return lua_error(L);
+    }
     bool isBackwardCompatibilityRequired = true;
     if (lua_gettop(L) > 2) {
         isBackwardCompatibilityRequired = !getVerifiedBool(L, __func__, 3, "enableFullErrorReporting {default = false}", true);
     }
+    const QString key{lua_tostring(L, 2)};
 
     TRoom* pR = host.mpMap->mpRoomDB->getRoom(roomId);
     if (!pR) {
@@ -2739,11 +2793,15 @@ int TLuaInterpreter::lockSpecialExit(lua_State* L)
 {
     const int fromRoomID = getVerifiedInt(L, __func__, 1, "exit roomID");
     // The second argument (was the toRoomID) is now ignored as it is not required/considered in any way
-    const QString dir = getVerifiedString(L, __func__, 3, "special exit name/command");
-    if (dir.isEmpty()) {
+    if (!checkStringArg(L, __func__, 3, "special exit name/command")) {
+        return lua_error(L);
+    }
+    const char* const exitName = lua_tostring(L, 3);
+    if (!exitName[0]) {
         return warnArgumentValue(L, __func__, "the special exit name/command cannot be empty");
     }
     const bool b = getVerifiedBool(L, __func__, 4, "special exit lock state");
+    const QString dir{exitName};
 
     const Host& host = getHostFromLua(L);
     TRoom* pR = host.mpMap->mpRoomDB->getRoom(fromRoomID);
@@ -2796,12 +2854,15 @@ int TLuaInterpreter::openMapWidget(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#registerMapInfo
 int TLuaInterpreter::registerMapInfo(lua_State* L)
 {
-    auto name = getVerifiedString(L, __func__, 1, "label");
-
+    if (!checkStringArg(L, __func__, 1, "label")) {
+        return lua_error(L);
+    }
     if (!lua_isfunction(L, 2)) {
         lua_pushfstring(L, "registerMapInfo: bad argument #2 type (callback as function expected, got %s!)", luaL_typename(L, 2));
         return lua_error(L);
     }
+
+    auto name = QString{lua_tostring(L, 1)};
     const int callback = luaL_ref(L, LUA_REGISTRYINDEX);
 
     auto& host = getHostFromLua(L);
@@ -3056,16 +3117,23 @@ int TLuaInterpreter::saveJsonMap(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#saveMap
 int TLuaInterpreter::saveMap(lua_State* L)
 {
-    QString location;
+    const int args = lua_gettop(L);
     int saveVersion = 0;
 
-    if (lua_gettop(L) > 0) {
-        location = getVerifiedString(L, __func__, 1, "save location path and file name", true);
-        if (lua_gettop(L) > 1) {
+    if (args > 0) {
+        if (!checkStringArg(L, __func__, 1, "save location path and file name", true)) {
+            return lua_error(L);
+        }
+        if (args > 1) {
             saveVersion = getVerifiedInt(L, __func__, 2, "map format version", true);
         }
     }
 
+    QString location;
+    if (args > 0) {
+        location = lua_tostring(L, 1);
+    }
+
     const Host& host = getHostFromLua(L);
     const bool error = host.mpConsole->saveMap(location, saveVersion);
     lua_pushboolean(L, error);
@@ -3080,13 +3148,23 @@ int TLuaInterpreter::searchAreaUserData(lua_State* L)
         return warnArgumentValue(L, __func__, "no map present or loaded");
     }
 
+    const int args = lua_gettop(L);
+    if (args) {
+        if (!checkStringArg(L, __func__, 1, "key", true)) {
+            return lua_error(L);
+        }
+        if (args > 1 && !checkStringArg(L, __func__, 2, "value", true)) {
+            return lua_error(L);
+        }
+    }
+
     QString key = QString();
     QString value = QString(); //both of these assigns a null value which is detectably different from the empty value
 
-    if (lua_gettop(L)) {
-        key = getVerifiedString(L, __func__, 1, "key", true);
-        if (lua_gettop(L) > 1) {
-            value = getVerifiedString(L, __func__, 2, "value", true);
+    if (args) {
+        key = lua_tostring(L, 1);
+        if (args > 1) {
+            value = lua_tostring(L, 2);
         }
     }
 
@@ -3255,13 +3333,23 @@ int TLuaInterpreter::searchRoomUserData(lua_State* L)
         return warnArgumentValue(L, __func__, "no map present or loaded");
     }
 
+    const int args = lua_gettop(L);
+    if (args) {
+        if (!checkStringArg(L, __func__, 1, "key", true)) {
+            return lua_error(L);
+        }
+        if (args > 1 && !checkStringArg(L, __func__, 2, "value", true)) {
+            return lua_error(L);
+        }
+    }
+
     QString key = QString();
     QString value = QString(); //both of these assigns a null value which is detectably different from the empty value
 
-    if (lua_gettop(L)) {
-        key = getVerifiedString(L, __func__, 1, "key", true);
-        if (lua_gettop(L) > 1) {
-            value = getVerifiedString(L, __func__, 2, "value", true);
+    if (args) {
+        key = lua_tostring(L, 1);
+        if (args > 1) {
+            value = lua_tostring(L, 2);
         }
     }
 
@@ -3347,7 +3435,6 @@ int TLuaInterpreter::searchRoomUserData(lua_State* L)
 int TLuaInterpreter::setAreaName(lua_State* L)
 {
     int id = -1;
-    QString existingName;
     const Host& host = getHostFromLua(L);
     if (!host.mpMap || !host.mpMap->mpRoomDB) {
         return warnArgumentValue(L, __func__, "no map present or loaded");
@@ -3366,7 +3453,7 @@ int TLuaInterpreter::setAreaName(lua_State* L)
         //            return warnArgumentValue(L, __func__, csmInvalidAreaID.arg(id));
         //        }
     } else if (lua_isstring(L, 1)) {
-        existingName = lua_tostring(L, 1);
+        const QString existingName{lua_tostring(L, 1)};
         id = host.mpMap->mpRoomDB->getAreaNamesMap().key(existingName, 0);
         if (existingName.isEmpty()) {
             return warnArgumentValue(L, __func__, "area name cannot be empty");
@@ -3432,11 +3519,15 @@ int TLuaInterpreter::setAreaName(lua_State* L)
 int TLuaInterpreter::setAreaUserData(lua_State* L)
 {
     const int areaId = getVerifiedInt(L, __func__, 1, "areaID");
-    const QString key = getVerifiedString(L, __func__, 2, "key");
-    if (key.isEmpty()) {
+    if (!checkStringArg(L, __func__, 2, "key")) {
+        return lua_error(L);
+    }
+    const char* const keyName = lua_tostring(L, 2);
+    if (!keyName[0]) {
         return warnArgumentValue(L, __func__, "key is not allowed to be an empty string");
     }
     const QString value = getVerifiedString(L, __func__, 3, "value");
+    const QString key{keyName};
 
     const Host& host = getHostFromLua(L);
     if (!host.mpMap || !host.mpMap->mpRoomDB) {
@@ -3561,36 +3652,40 @@ int TLuaInterpreter::setDoor(lua_State* L)
     if (!pR) {
         return warnArgumentValue(L, __func__, csmInvalidRoomID.arg(roomId));
     }
-    const QString exitCmd = getVerifiedString(L, __func__, 2, "door command");
-
-    if (exitCmd.compare(qsl("n")) && exitCmd.compare(qsl("e")) && exitCmd.compare(qsl("s")) && exitCmd.compare(qsl("w")) && exitCmd.compare(qsl("ne")) && exitCmd.compare(qsl("se"))
-        && exitCmd.compare(qsl("sw")) && exitCmd.compare(qsl("nw")) && exitCmd.compare(qsl("up")) && exitCmd.compare(qsl("down")) && exitCmd.compare(qsl("in")) && exitCmd.compare(qsl("out"))) {
-        // One of the above WILL BE ZERO if the exitCmd is ONE of the above qsls
-        // So the above will be TRUE if NONE of above strings match - which
-        // means we must treat the exitCmd as a SPECIAL exit
-        if (!(pR->getSpecialExits().contains(exitCmd))) {
-            // And NOT a special one either
-            return warnArgumentValue(L, __func__, qsl("roomID %1 does not have a special exit in direction '%2'").arg(QString::number(roomId), exitCmd));
+    if (!checkStringArg(L, __func__, 2, "door command")) {
+        return lua_error(L);
+    }
+    {
+        const QString exitCmd{lua_tostring(L, 2)};
+        if (exitCmd.compare(qsl("n")) && exitCmd.compare(qsl("e")) && exitCmd.compare(qsl("s")) && exitCmd.compare(qsl("w")) && exitCmd.compare(qsl("ne")) && exitCmd.compare(qsl("se"))
+            && exitCmd.compare(qsl("sw")) && exitCmd.compare(qsl("nw")) && exitCmd.compare(qsl("up")) && exitCmd.compare(qsl("down")) && exitCmd.compare(qsl("in")) && exitCmd.compare(qsl("out"))) {
+            // One of the above WILL BE ZERO if the exitCmd is ONE of the above qsls
+            // So the above will be TRUE if NONE of above strings match - which
+            // means we must treat the exitCmd as a SPECIAL exit
+            if (!(pR->getSpecialExits().contains(exitCmd))) {
+                // And NOT a special one either
+                return warnArgumentValue(L, __func__, qsl("roomID %1 does not have a special exit in direction '%2'").arg(QString::number(roomId), exitCmd));
+            }
+            // else IS a valid special exit - so fall out of if and continue
+        } else {
+            // Is a normal exit so see if it is valid
+            if (!(((!exitCmd.compare(qsl("n"))) && (pR->getExit(DIR_NORTH) > 0 || pR->exitStubs.contains(DIR_NORTH)))
+                  || ((!exitCmd.compare(qsl("e"))) && (pR->getExit(DIR_EAST) > 0 || pR->exitStubs.contains(DIR_EAST)))
+                  || ((!exitCmd.compare(qsl("s"))) && (pR->getExit(DIR_SOUTH) > 0 || pR->exitStubs.contains(DIR_SOUTH)))
+                  || ((!exitCmd.compare(qsl("w"))) && (pR->getExit(DIR_WEST) > 0 || pR->exitStubs.contains(DIR_WEST)))
+                  || ((!exitCmd.compare(qsl("ne"))) && (pR->getExit(DIR_NORTHEAST) > 0 || pR->exitStubs.contains(DIR_NORTHEAST)))
+                  || ((!exitCmd.compare(qsl("se"))) && (pR->getExit(DIR_SOUTHEAST) > 0 || pR->exitStubs.contains(DIR_SOUTHEAST)))
+                  || ((!exitCmd.compare(qsl("sw"))) && (pR->getExit(DIR_SOUTHWEST) > 0 || pR->exitStubs.contains(DIR_SOUTHWEST)))
+                  || ((!exitCmd.compare(qsl("nw"))) && (pR->getExit(DIR_NORTHWEST) > 0 || pR->exitStubs.contains(DIR_NORTHWEST)))
+                  || ((!exitCmd.compare(qsl("up"))) && (pR->getExit(DIR_UP) > 0 || pR->exitStubs.contains(DIR_UP)))
+                  || ((!exitCmd.compare(qsl("down"))) && (pR->getExit(DIR_DOWN) > 0 || pR->exitStubs.contains(DIR_DOWN)))
+                  || ((!exitCmd.compare(qsl("in"))) && (pR->getExit(DIR_IN) > 0 || pR->exitStubs.contains(DIR_IN)))
+                  || ((!exitCmd.compare(qsl("out"))) && (pR->getExit(DIR_OUT) > 0 || pR->exitStubs.contains(DIR_OUT))))) {
+                // No there IS NOT a stub or real exit in the exitCmd direction
+                return warnArgumentValue(L, __func__, qsl("roomID %1 does not have a normal exit or a stub exit in direction '%2'").arg(QString::number(roomId), exitCmd));
+            }
+            // else IS a valid stub or real normal exit -fall through to continue
         }
-        // else IS a valid special exit - so fall out of if and continue
-    } else {
-        // Is a normal exit so see if it is valid
-        if (!(((!exitCmd.compare(qsl("n"))) && (pR->getExit(DIR_NORTH) > 0 || pR->exitStubs.contains(DIR_NORTH)))
-              || ((!exitCmd.compare(qsl("e"))) && (pR->getExit(DIR_EAST) > 0 || pR->exitStubs.contains(DIR_EAST)))
-              || ((!exitCmd.compare(qsl("s"))) && (pR->getExit(DIR_SOUTH) > 0 || pR->exitStubs.contains(DIR_SOUTH)))
-              || ((!exitCmd.compare(qsl("w"))) && (pR->getExit(DIR_WEST) > 0 || pR->exitStubs.contains(DIR_WEST)))
-              || ((!exitCmd.compare(qsl("ne"))) && (pR->getExit(DIR_NORTHEAST) > 0 || pR->exitStubs.contains(DIR_NORTHEAST)))
-              || ((!exitCmd.compare(qsl("se"))) && (pR->getExit(DIR_SOUTHEAST) > 0 || pR->exitStubs.contains(DIR_SOUTHEAST)))
-              || ((!exitCmd.compare(qsl("sw"))) && (pR->getExit(DIR_SOUTHWEST) > 0 || pR->exitStubs.contains(DIR_SOUTHWEST)))
-              || ((!exitCmd.compare(qsl("nw"))) && (pR->getExit(DIR_NORTHWEST) > 0 || pR->exitStubs.contains(DIR_NORTHWEST)))
-              || ((!exitCmd.compare(qsl("up"))) && (pR->getExit(DIR_UP) > 0 || pR->exitStubs.contains(DIR_UP)))
-              || ((!exitCmd.compare(qsl("down"))) && (pR->getExit(DIR_DOWN) > 0 || pR->exitStubs.contains(DIR_DOWN)))
-              || ((!exitCmd.compare(qsl("in"))) && (pR->getExit(DIR_IN) > 0 || pR->exitStubs.contains(DIR_IN)))
-              || ((!exitCmd.compare(qsl("out"))) && (pR->getExit(DIR_OUT) > 0 || pR->exitStubs.contains(DIR_OUT))))) {
-            // No there IS NOT a stub or real exit in the exitCmd direction
-            return warnArgumentValue(L, __func__, qsl("roomID %1 does not have a normal exit or a stub exit in direction '%2'").arg(QString::number(roomId), exitCmd));
-        }
-        // else IS a valid stub or real normal exit -fall through to continue
     }
 
     const int doorStatus = getVerifiedInt(L, __func__, 3, "door type  {0='none', 1='open', 2='closed' or 3='locked'}");
@@ -3598,6 +3693,7 @@ int TLuaInterpreter::setDoor(lua_State* L)
         return warnArgumentValue(L, __func__, qsl("door type %1 is not one of 0='none', 1='open', 2='closed' or 3='locked'").arg(doorStatus));
     }
 
+    const QString exitCmd{lua_tostring(L, 2)};
     const bool result = pR->setDoor(exitCmd, doorStatus);
     if (result) {
         host.mpMap->setUnsaved(__func__);
@@ -3789,13 +3885,15 @@ int TLuaInterpreter::setExitWeight(lua_State* L)
         return warnArgumentValue(L, __func__, csmInvalidRoomID.arg(roomID));
     }
 
-    const QString direction(dirToString(L, 2));
-    if (direction.isEmpty()) {
-        lua_pushfstring(L, "setExitWeight: bad argument #2 type (direction as string or number {between 1 and 12 inclusive} expected, got %s!)", luaL_typename(L, 2));
-        return lua_error(L);
-    }
-    if (!pR->hasExitOrSpecialExit(direction)) {
-        return warnArgumentValue(L, __func__, qsl("roomID %1 does not have an exit that can be identified from '%2'").arg(QString::number(roomID), lua_tostring(L, 2)));
+    {
+        const QString direction(dirToString(L, 2));
+        if (direction.isEmpty()) {
+            lua_pushfstring(L, "setExitWeight: bad argument #2 type (direction as string or number {between 1 and 12 inclusive} expected, got %s!)", luaL_typename(L, 2));
+            return lua_error(L);
+        }
+        if (!pR->hasExitOrSpecialExit(direction)) {
+            return warnArgumentValue(L, __func__, qsl("roomID %1 does not have an exit that can be identified from '%2'").arg(QString::number(roomID), lua_tostring(L, 2)));
+        }
     }
 
     const int weight = getVerifiedInt(L, __func__, 3, "exit weight");
@@ -3806,7 +3904,7 @@ int TLuaInterpreter::setExitWeight(lua_State* L)
                                          .arg(QString::number(weight), QString::number(std::numeric_limits::max())));
     }
 
-    pR->setExitWeight(direction, weight);
+    pR->setExitWeight(dirToString(L, 2), weight);
     lua_pushboolean(L, true);
     host.mpMap->updateArea(pR->getArea());
     return 1;
@@ -3839,11 +3937,15 @@ int TLuaInterpreter::setMapUserData(lua_State* L)
         return warnArgumentValue(L, __func__, "no map present or loaded");
     }
 
-    const QString key = getVerifiedString(L, __func__, 1, "key");
-    if (key.isEmpty()) {
+    if (!checkStringArg(L, __func__, 1, "key")) {
+        return lua_error(L);
+    }
+    const char* const keyName = lua_tostring(L, 1);
+    if (!keyName[0]) {
         return warnArgumentValue(L, __func__, "key is not allowed to be an empty string");
     }
     const QString value = getVerifiedString(L, __func__, 2, "value");
+    const QString key{keyName};
 
     host.mpMap->mUserData[key] = value;
     host.mpMap->setUnsaved(__func__);
@@ -3914,13 +4016,11 @@ int TLuaInterpreter::setRoomArea(lua_State* L)
         return warnArgumentValue(L, __func__, "no map present or loaded");
     }
 
-    QVector roomIds;
     if (lua_isnumber(L, 1)) {
         const int id = getVerifiedInt(L, __func__, 1, "roomID");
         if (!host.mpMap->mpRoomDB->getRoomIDList().contains(id)) {
             return warnArgumentValue(L, __func__, csmInvalidRoomID.arg(id));
         }
-        roomIds.append(id);
     } else if (lua_istable(L, 1)) {
         lua_pushnil(L);
         while (lua_next(L, 1) != 0) {
@@ -3928,7 +4028,6 @@ int TLuaInterpreter::setRoomArea(lua_State* L)
             if (!host.mpMap->mpRoomDB->getRoomIDList().contains(id)) {
                 return warnArgumentValue(L, __func__, csmInvalidRoomID.arg(id));
             }
-            roomIds.append(id);
             lua_pop(L, 1);
         }
     } else {
@@ -3940,7 +4039,6 @@ int TLuaInterpreter::setRoomArea(lua_State* L)
     }
 
     int areaId = -1;
-    QString areaName;
     if (lua_isnumber(L, 2)) {
         areaId = static_cast(lua_tonumber(L, 2));
         if (areaId < 1) {
@@ -3954,7 +4052,7 @@ int TLuaInterpreter::setRoomArea(lua_State* L)
             return warnArgumentValue(L, __func__, csmInvalidAreaID.arg(areaId));
         }
     } else if (lua_isstring(L, 2)) {
-        areaName = lua_tostring(L, 2);
+        const QString areaName{lua_tostring(L, 2)};
         // areaId will be zero if not found!
         if (areaName.isEmpty()) {
             return warnArgumentValue(L, __func__, "area name cannot be empty");
@@ -3971,6 +4069,17 @@ int TLuaInterpreter::setRoomArea(lua_State* L)
         return lua_error(L);
     }
 
+    QVector roomIds;
+    if (lua_isnumber(L, 1)) {
+        roomIds.append(static_cast(lua_tointeger(L, 1)));
+    } else {
+        lua_pushnil(L);
+        while (lua_next(L, 1) != 0) {
+            roomIds.append(static_cast(lua_tointeger(L, -1)));
+            lua_pop(L, 1);
+        }
+    }
+
     const bool result = std::all_of(roomIds.begin(), roomIds.end(), [&](int id) {
         // defer area recalculation on all rooms until the last room (.back())
         return host.mpMap->setRoomArea(id, areaId, id != roomIds.back());
@@ -4122,9 +4231,12 @@ int TLuaInterpreter::setRoomUserData(lua_State* L)
     }
 
     const int roomId = getVerifiedInt(L, __func__, 1, "roomID");
-    const QString key = getVerifiedString(L, __func__, 2, "key");
-    // Ideally should reject empty keys but this could break existing scripts so we can't
+    if (!checkStringArg(L, __func__, 2, "key")) {
+        return lua_error(L);
+    }
     const QString value = getVerifiedString(L, __func__, 3, "value");
+    // Ideally should reject empty keys but this could break existing scripts so we can't
+    const QString key{lua_tostring(L, 2)};
 
     TRoom* pR = host.mpMap->mpRoomDB->getRoom(roomId);
     if (!pR) {
@@ -4485,7 +4597,9 @@ int TLuaInterpreter::exportAreaImage(lua_State* L)
     }
 
     // filePath parameter is required
-    const QString filePath = getVerifiedString(L, __func__, 2, "file path");
+    if (!checkStringArg(L, __func__, 2, "file path")) {
+        return lua_error(L);
+    }
 
     std::optional zLevel = std::nullopt;
     bool exportAllZLevels = false;
@@ -4503,6 +4617,8 @@ int TLuaInterpreter::exportAreaImage(lua_State* L)
         }
     }
 
+    const QString filePath{lua_tostring(L, 2)};
+
     // NOTE: Zoom parameter temporarily disabled due to blurry room symbol rendering at zoom > 2.0
     qreal zoom = 2.0;
 
diff --git a/src/TLuaInterpreterMudletObjects.cpp b/src/TLuaInterpreterMudletObjects.cpp
index 40baf4021..c5db03b67 100644
--- a/src/TLuaInterpreterMudletObjects.cpp
+++ b/src/TLuaInterpreterMudletObjects.cpp
@@ -203,12 +203,12 @@ static bool timerDelayFits(const double time)
 int TLuaInterpreter::addCmdLineSuggestion(lua_State* L)
 {
     const int n = lua_gettop(L);
-    QString name = "main";
+    const char* name = "main";
     if (n > 1) {
         name = CMDLINE_NAME(L, 1);
     }
     const QString text = getVerifiedString(L, __func__, n, "suggestion text");
-    auto pN = COMMANDLINE(L, name);
+    auto pN = COMMANDLINE(L, QString{name});
     pN->addSuggestion(text);
     return 0;
 }
@@ -242,13 +242,13 @@ int TLuaInterpreter::adjustStopWatch(lua_State* L)
 int TLuaInterpreter::appendCmdLine(lua_State* L)
 {
     const int n = lua_gettop(L);
-    QString name = "main";
+    const char* name = "main";
 
     if (n > 1) {
         name = CMDLINE_NAME(L, 1);
     }
     const QString text = getVerifiedString(L, __func__, n, "text to set on command line");
-    auto pN = COMMANDLINE(L, name);
+    auto pN = COMMANDLINE(L, QString{name});
 
     const QString curText = pN->toPlainText();
     pN->setPlainText(curText + text);
@@ -264,11 +264,11 @@ int TLuaInterpreter::appendCmdLine(lua_State* L)
 int TLuaInterpreter::clearCmdLine(lua_State* L)
 {
     const int n = lua_gettop(L);
-    QString name = "main";
+    const char* name = "main";
     if (n >= 1) {
         name = CMDLINE_NAME(L, 1);
     }
-    auto pN = COMMANDLINE(L, name);
+    auto pN = COMMANDLINE(L, QString{name});
     pN->clear();
     pN->adjustHeight();
     return 0;
@@ -278,11 +278,11 @@ int TLuaInterpreter::clearCmdLine(lua_State* L)
 int TLuaInterpreter::clearCmdLineSuggestions(lua_State* L)
 {
     const int n = lua_gettop(L);
-    QString name = "main";
+    const char* name = "main";
     if (n == 1) {
         name = CMDLINE_NAME(L, 1);
     }
-    auto pN = COMMANDLINE(L, name);
+    auto pN = COMMANDLINE(L, QString{name});
     pN->clearSuggestions();
     return 0;
 }
@@ -290,7 +290,7 @@ int TLuaInterpreter::clearCmdLineSuggestions(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#createStopWatch
 int TLuaInterpreter::createStopWatch(lua_State* L)
 {
-    QString name;
+    bool hasName = false;
     bool autoStart = true;
     const int n = lua_gettop(L);
     int s = 1;
@@ -299,7 +299,7 @@ int TLuaInterpreter::createStopWatch(lua_State* L)
             autoStart = lua_toboolean(L, s);
         } else if (lua_type(L, s) == LUA_TSTRING) {
             autoStart = false;
-            name = lua_tostring(L, 1);
+            hasName = true;
         } else if (lua_type(L, s) == LUA_TNIL) {
             ; // fallthrough for compatibility with old-style stopwatches in case createStopWatch(nil) is passed
             // note that 'nil' will still count towards the stack's gettop amount
@@ -313,6 +313,7 @@ int TLuaInterpreter::createStopWatch(lua_State* L)
         }
     }
 
+    const QString name = hasName ? QString{lua_tostring(L, 1)} : QString();
 
     Host& host = getHostFromLua(L);
     QPair const result = host.createStopWatch(name);
@@ -356,12 +357,12 @@ int TLuaInterpreter::deleteStopWatch(lua_State* L)
 int TLuaInterpreter::removeCmdLineSuggestion(lua_State* L)
 {
     const int n = lua_gettop(L);
-    QString name = "main";
+    const char* name = "main";
     if (n > 1) {
         name = CMDLINE_NAME(L, 1);
     }
     const QString text = getVerifiedString(L, __func__, n, "suggestion text");
-    auto pN = COMMANDLINE(L, name);
+    auto pN = COMMANDLINE(L, QString{name});
     pN->removeSuggestion(text);
     return 0;
 }
@@ -493,10 +494,14 @@ int TLuaInterpreter::enableTrigger(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#exists
 int TLuaInterpreter::exists(lua_State* L)
 {
+    if (!checkStringOrIntegerArg(L, __func__, 1, "itemID or item name") || !checkStringArg(L, __func__, 2, "item type")) {
+        return lua_error(L);
+    }
+
     auto [isId, nameOrId] = getVerifiedStringOrInteger(L, __func__, 1, "itemID or item name");
     // Although we only use 6 ASCII strings the user may not enter a purely
     // ASCII value which we might have to report...
-    QString type = getVerifiedString(L, __func__, 2, "item type").toLower();
+    QString type = QString{lua_tostring(L, 2)}.toLower();
     bool isOk = false;
     const int id = nameOrId.toInt(&isOk);
     if (isId && (!isOk || id < 0)) {
@@ -625,11 +630,11 @@ int TLuaInterpreter::getButtonState(lua_State* L)
 int TLuaInterpreter::getCmdLine(lua_State* L)
 {
     const int n = lua_gettop(L);
-    QString name = "main";
+    const char* name = "main";
     if (n >= 1) {
         name = CMDLINE_NAME(L, 1);
     }
-    auto commandline = COMMANDLINE(L, name);
+    auto commandline = COMMANDLINE(L, QString{name});
     const QString text = commandline->toPlainText();
     lua_pushstring(L, text.toUtf8().constData());
     return 1;
@@ -889,11 +894,14 @@ int TLuaInterpreter::getStopWatchBrokenDownTime(lua_State* L)
 int TLuaInterpreter::getScript(lua_State* L)
 {
     const int n = lua_gettop(L);
+    if (!checkStringArg(L, __func__, 1, "script name")) {
+        return lua_error(L);
+    }
     int pos = 1;
-    const QString name = getVerifiedString(L, __func__, 1, "script name");
     if (n > 1) {
         pos = getVerifiedInt(L, __func__, 2, "script position");
     }
+    const QString name{lua_tostring(L, 1)};
     Host& host = getHostFromLua(L);
 
     auto ids = host.getScriptUnit()->findItems(name);
@@ -915,14 +923,18 @@ int TLuaInterpreter::getScript(lua_State* L)
 int TLuaInterpreter::invokeFileDialog(lua_State* L)
 {
     const int n = lua_gettop(L);
+    if (!checkBoolArg(L, __func__, 1, "fileOrFolder") || !checkStringArg(L, __func__, 2, "dialogTitle") || (n > 2 && !checkStringArg(L, __func__, 3, "dialogLocation"))) {
+        return lua_error(L);
+    }
+
     Host& host = getHostFromLua(L);
     QString location = mudlet::getMudletPath(enums::profileHomePath, host.getName());
-    const bool luaDir = getVerifiedBool(L, __func__, 1, "fileOrFolder");
-    const QString title = getVerifiedString(L, __func__, 2, "dialogTitle");
+    const bool luaDir = lua_toboolean(L, 1);
+    const QString title{lua_tostring(L, 2)};
 
     if (n > 2) {
-        QString target = getVerifiedString(L, __func__, 3, "dialogLocation");
-        QDir dir(target);
+        const QString target{lua_tostring(L, 3)};
+        const QDir dir(target);
 
         if (dir.exists()) {
             location = target;
@@ -942,23 +954,30 @@ int TLuaInterpreter::invokeFileDialog(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#isActive
 int TLuaInterpreter::isActive(lua_State* L)
 {
+    if (!checkStringOrIntegerArg(L, __func__, 1, "item name or ID") || !checkStringArg(L, __func__, 2, "item type")) {
+        return lua_error(L);
+    }
+    if (lua_type(L, 1) == LUA_TNUMBER) {
+        bool isOk = false;
+        const int id = getVerifiedStringOrInteger(L, __func__, 1, "item name or ID").second.toInt(&isOk);
+        if (!isOk || id < 0) {
+            // Must be zero or more but doesn't seem to be, must return the
+            // original supplied argument as a string (rather than the nameOrId
+            // "number" as the latter will have been rounded to an integer) to
+            // show what was entered:
+            return warnArgumentValue(L, __func__, csmInvalidItemID.arg(lua_tostring(L, 1)));
+        }
+    }
+    if (lua_gettop(L) > 2 && !checkBoolArg(L, __func__, 3, "also check ancestors", true)) {
+        return lua_error(L);
+    }
+
     auto [isId, nameOrId] = getVerifiedStringOrInteger(L, __func__, 1, "item name or ID");
     // Although we only use 4 ASCII strings the user may not enter a purely
     // ASCII value which we might have to report...
-    const QString type = getVerifiedString(L, __func__, 2, "item type");
-    bool isOk = false;
-    const int id = nameOrId.toInt(&isOk);
-    if (isId && (!isOk || id < 0)) {
-        // Must be zero or more but doesn't seem to be, must return the
-        // original supplied argument as a string (rather than the nameOrId
-        // "number" as the latter will have been rounded to an integer) to
-        // show what was entered:
-        return warnArgumentValue(L, __func__, csmInvalidItemID.arg(lua_tostring(L, 1)));
-    }
-    bool checkAncestors = false;
-    if (lua_gettop(L) > 2) {
-        checkAncestors = getVerifiedBool(L, __func__, 3, "also check ancestors", true);
-    }
+    const QString type{lua_tostring(L, 2)};
+    const bool checkAncestors = (lua_gettop(L) > 2) && lua_toboolean(L, 3);
+    const int id = nameOrId.toInt();
 
     Host& host = getHostFromLua(L);
     int cnt = 0;
@@ -1454,13 +1473,13 @@ int TLuaInterpreter::permKey(lua_State* L)
 int TLuaInterpreter::printCmdLine(lua_State* L)
 {
     const int n = lua_gettop(L);
-    QString name = "main";
+    const char* name = "main";
     if (n > 1) {
         name = CMDLINE_NAME(L, 1);
     }
     const QString text = getVerifiedString(L, __func__, n, "text to set on command line");
 
-    auto pN = COMMANDLINE(L, name);
+    auto pN = COMMANDLINE(L, QString{name});
     pN->setPlainText(text);
     QTextCursor cur = pN->textCursor();
     cur.clearSelection();
@@ -1546,8 +1565,11 @@ int TLuaInterpreter::waitForEvent(lua_State* L)
         return 2;
     }
 
-    const QString eventName = getVerifiedString(L, __func__, 1, "event name");
-    if (eventName.isEmpty()) {
+    if (!checkStringArg(L, __func__, 1, "event name")) {
+        return lua_error(L);
+    }
+    const char* eventNameArg = lua_tostring(L, 1);
+    if (*eventNameArg == '\0') {
         return warnArgumentValue(L, __func__, "event name cannot be empty");
     }
 
@@ -1560,6 +1582,7 @@ int TLuaInterpreter::waitForEvent(lua_State* L)
         timeoutMs = getVerifiedInt(L, __func__, 2, "timeout in milliseconds", true);
     }
     timeoutMs = std::clamp(timeoutMs, 0, maximumTimeoutMs);
+    const QString eventName{eventNameArg};
 
     Host& host = getHostFromLua(L);
     TLuaInterpreter* pLuaInterpreter = host.getLuaInterpreter();
@@ -1604,7 +1627,15 @@ int TLuaInterpreter::waitForEvent(lua_State* L)
     const int argsTableIndex = lua_gettop(L);
     // A lua_CFunction is only guaranteed LUA_MINSTACK slots; an event can carry
     // up to LUA_FUNCTION_MAX_ARGS arguments, so grow the stack before pushing.
-    luaL_checkstack(L, argCount + 1, "waitForEvent: too many event arguments to return");
+    // luaL_checkstack() would raise here, stranding eventName, wait.mName and
+    // the registry reference below, so report it the way a timeout is reported
+    if (!lua_checkstack(L, argCount + 1)) {
+        lua_remove(L, argsTableIndex);
+        luaL_unref(L, LUA_REGISTRYINDEX, wait.mArgsRef);
+        lua_pushnil(L);
+        lua_pushstring(L, "waitForEvent: too many event arguments to return");
+        return 2;
+    }
     for (int i = 1; i <= argCount; ++i) {
         lua_rawgeti(L, argsTableIndex, i);
     }
@@ -1781,7 +1812,7 @@ int TLuaInterpreter::setConsoleBufferSize(lua_State* L)
 {
     int s = 1;
     const int n = lua_gettop(L);
-    QString windowName;
+    const char* windowName = "";
     if (n > 2) {
         windowName = WINDOW_NAME(L, s++);
     }
@@ -1797,7 +1828,7 @@ int TLuaInterpreter::setConsoleBufferSize(lua_State* L)
 
     // The macro will have returned with a nil + error message if the windowName
     // was not found:
-    auto console = CONSOLE(L, windowName);
+    auto console = CONSOLE(L, QString{windowName});
     Host& host = getHostFromLua(L);
 
     if (useMaximum) {
@@ -1900,6 +1931,10 @@ int TLuaInterpreter::setStopWatchName(lua_State* L)
         return lua_error(L);
     }
 
+    if (!checkStringArg(L, __func__, 2, "stopwatch new name")) {
+        return lua_error(L);
+    }
+
     int watchId = 0;
     Host& host = getHostFromLua(L);
     QString currentName;
@@ -1910,7 +1945,7 @@ int TLuaInterpreter::setStopWatchName(lua_State* L)
         currentName = lua_tostring(L, 1);
     }
 
-    const QString newName = getVerifiedString(L, __func__, 2, "stopwatch new name");
+    const QString newName{lua_tostring(L, 2)};
 
     QPair result;
     if (currentName.isNull()) {
@@ -2054,7 +2089,6 @@ int TLuaInterpreter::tempAnsiColorTrigger(lua_State* L)
     Host& host = getHostFromLua(L);
     TLuaInterpreter* pLuaInterpreter = host.getLuaInterpreter();
 
-    QString code;
     int ansiFgColor = TTrigger::scmIgnored;
     int ansiBgColor = TTrigger::scmIgnored;
     int s = 0;
@@ -2121,11 +2155,7 @@ int TLuaInterpreter::tempAnsiColorTrigger(lua_State* L)
     }
 
     const int codeIndex = ++s;
-    if (lua_isstring(L, codeIndex)) {
-        code = QString::fromUtf8(lua_tostring(L, codeIndex));
-    } else if (lua_isfunction(L, codeIndex)) {
-        // leave code as a null QString(), see below
-    } else {
+    if (!lua_isstring(L, codeIndex) && !lua_isfunction(L, codeIndex)) {
         lua_pushfstring(L, "tempAnsiColorTrigger: bad argument #%d type (code to run as a string or a function expected, got %s!)", codeIndex, luaL_typename(L, codeIndex));
         return lua_error(L);
     }
@@ -2142,6 +2172,9 @@ int TLuaInterpreter::tempAnsiColorTrigger(lua_State* L)
         return lua_error(L);
     }
 
+    // a function argument leaves this a null QString(), see below
+    const QString code = lua_isstring(L, codeIndex) ? QString::fromUtf8(lua_tostring(L, codeIndex)) : QString();
+
     const int triggerID = pLuaInterpreter->startTempColorTrigger(ansiFgColor, ansiBgColor, code, expiryCount);
     if (code.isNull()) {
         auto trigger = host.getTriggerUnit()->getTrigger(triggerID);
@@ -2264,14 +2297,15 @@ int TLuaInterpreter::tempButton(lua_State* L)
     const QString cmdButtonUp = "";
     const QString cmdButtonDown = "";
     const QString script = "";
-    QString toolbar;
-    QStringList nameL;
-    nameL << toolbar;
 
-    toolbar = getVerifiedString(L, __func__, 1, "toolbar name");
-    const QString name = getVerifiedString(L, __func__, 2, "button text");
+    if (!checkStringArg(L, __func__, 1, "toolbar name") || !checkStringArg(L, __func__, 2, "button text")) {
+        return lua_error(L);
+    }
     const int orientation = getVerifiedInt(L, __func__, 3, "orientation");
 
+    const QString toolbar{lua_tostring(L, 1)};
+    const QString name{lua_tostring(L, 2)};
+
     Host& host = getHostFromLua(L);
     TAction* pP = host.getActionUnit()->findAction(toolbar);
     if (!pP) {
@@ -2318,17 +2352,18 @@ int TLuaInterpreter::tempButton(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#tempButtonToolbar
 int TLuaInterpreter::tempButtonToolbar(lua_State* L)
 {
-    QString name;
     const QString cmdButtonUp = "";
     const QString cmdButtonDown = "";
     const QString script = "";
-    QStringList nameL;
-    nameL << name;
 
-    name = getVerifiedString(L, __func__, 1, "name");
+    if (!checkStringArg(L, __func__, 1, "name")) {
+        return lua_error(L);
+    }
     int location = getVerifiedInt(L, __func__, 2, "location");
     const int orientation = getVerifiedInt(L, __func__, 3, "orientation");
 
+    const QString name{lua_tostring(L, 1)};
+
     if (location > 0) {
         location++;
     }
@@ -2343,8 +2378,6 @@ int TLuaInterpreter::tempButtonToolbar(lua_State* L)
 
     pT = new TAction(name, &host);
     pT->setCommandButtonUp(cmdButtonUp);
-    QStringList nl;
-    nl << name;
 
     pT->setName(name);
     pT->setCommandButtonUp(cmdButtonUp);
@@ -2893,10 +2926,13 @@ int TLuaInterpreter::tempTimer(lua_State* L)
         return 1;
     }
 
-    const QString luaCode = getVerifiedString(L, __func__, 2, "script or function name");
+    if (!checkStringArg(L, __func__, 2, "script or function name")) {
+        return lua_error(L);
+    }
     if (n > 2) {
         repeating = getVerifiedBool(L, __func__, 3, "repeating", true);
     }
+    const QString luaCode{lua_tostring(L, 2)};
     QPair const result = pLuaInterpreter->startTempTimer(time, luaCode, repeating);
     lua_pushnumber(L, result.first);
     if (result.first == -1) {
@@ -3029,13 +3065,16 @@ int TLuaInterpreter::getProfiles(lua_State* L)
 int TLuaInterpreter::loadProfile(lua_State* L)
 {
     auto& hostManager = mudlet::self()->getHostManager();
-    const QString requestedName = getVerifiedString(L, __func__, 1, "profile name");
+    if (!checkStringArg(L, __func__, 1, "profile name")) {
+        return lua_error(L);
+    }
     bool offline = false;
 
     if (lua_gettop(L) > 1) {
         offline = getVerifiedBool(L, __func__, 2, "offline mode", true);
     }
 
+    const QString requestedName{lua_tostring(L, 1)};
     if (requestedName.isEmpty()) {
         lua_pushnil(L);
         lua_pushstring(L, "loadProfile: profile name cannot be empty");
diff --git a/src/TLuaInterpreterTextToSpeech.cpp b/src/TLuaInterpreterTextToSpeech.cpp
index 7f763d00a..d2999f04d 100644
--- a/src/TLuaInterpreterTextToSpeech.cpp
+++ b/src/TLuaInterpreterTextToSpeech.cpp
@@ -323,10 +323,22 @@ int TLuaInterpreter::ttsPause(lua_State* L)
 int TLuaInterpreter::ttsQueue(lua_State* L)
 {
     TLuaInterpreter::ttsBuild();
-    QString inputText = getVerifiedString(L, __func__, 1, "input").trimmed();
-    if (inputText.isEmpty()) { // there's nothing more to say. discussion: https://github.com/Mudlet/Mudlet/issues/4688
-        return warnArgumentValue(L, __func__, qsl("skipped empty text to speak (TTS)"));
+    if (!checkStringArg(L, __func__, 1, "input")) {
+        return lua_error(L);
     }
+    // the empty-input refusal has to stay ahead of the argument #2 check, as it
+    // did before, or ttsQueue("", ) would raise instead of returning
+    // nil and a message
+    {
+        const QString trimmedText = QString{lua_tostring(L, 1)}.trimmed();
+        if (trimmedText.isEmpty()) { // there's nothing more to say. discussion: https://github.com/Mudlet/Mudlet/issues/4688
+            return warnArgumentValue(L, __func__, qsl("skipped empty text to speak (TTS)"));
+        }
+    }
+    if (lua_gettop(L) > 1 && !checkIntArg(L, __func__, 2, "index")) {
+        return lua_error(L);
+    }
+    QString inputText = QString{lua_tostring(L, 1)}.trimmed();
 
     std::vector const dontSpeak = {"<", ">", "<", ">"}; // discussion: https://github.com/Mudlet/Mudlet/issues/4689
     for (const QString& dropThis : dontSpeak) {
@@ -341,7 +353,7 @@ int TLuaInterpreter::ttsQueue(lua_State* L)
 
     int index;
     if (lua_gettop(L) > 1) {
-        index = getVerifiedInt(L, __func__, 2, "index");
+        index = static_cast(lua_tointeger(L, 2));
         index--;
         if (index < 0) {
             index = 0;
diff --git a/src/TLuaInterpreterUI.cpp b/src/TLuaInterpreterUI.cpp
index 4803a7403..78bf7c312 100644
--- a/src/TLuaInterpreterUI.cpp
+++ b/src/TLuaInterpreterUI.cpp
@@ -165,17 +165,20 @@ static bool isMain(const QString& name)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#addCommandLineMenuEvent
 int TLuaInterpreter::addCommandLineMenuEvent(lua_State* L)
 {
-    int args = 1;
     const int argsCount = lua_gettop(L);
+    const bool hasCommandLineName = (argsCount >= 3);
+    const int menuLabelPos = hasCommandLineName ? 2 : 1;
 
-    QString commandLineName;
-    if (argsCount >= 3) {
-        commandLineName = getVerifiedString(L, __func__, args++, "command line name");
-    } else {
-        commandLineName = qsl("main");
+    if (hasCommandLineName && !checkStringArg(L, __func__, 1, "command line name")) {
+        return lua_error(L);
     }
-    auto menuLabel = getVerifiedString(L, __func__, args++, "menu label");
-    auto eventName = getVerifiedString(L, __func__, args++, "event name");
+    if (!checkStringArg(L, __func__, menuLabelPos, "menu label") || !checkStringArg(L, __func__, menuLabelPos + 1, "event name")) {
+        return lua_error(L);
+    }
+
+    const QString commandLineName = hasCommandLineName ? QString{lua_tostring(L, 1)} : qsl("main");
+    const QString menuLabel{lua_tostring(L, menuLabelPos)};
+    const QString eventName{lua_tostring(L, menuLabelPos + 1)};
 
     const auto& commandline = COMMANDLINE(L, commandLineName);
     commandline->contextMenuItems.insert(menuLabel, eventName);
@@ -188,13 +191,19 @@ int TLuaInterpreter::addCommandLineMenuEvent(lua_State* L)
 int TLuaInterpreter::addMouseEvent(lua_State* L)
 {
     Host& host = getHostFromLua(L);
-    QStringList actionInfo;
-    const QString uniqueName = getVerifiedString(L, __func__, 1, "uniquename");
-    if (host.mConsoleActions.contains(uniqueName)) {
+    if (!checkStringArg(L, __func__, 1, "uniquename")) {
+        return lua_error(L);
+    }
+    if (const QString uniqueName{lua_tostring(L, 1)}; host.mConsoleActions.contains(uniqueName)) {
         return warnArgumentValue(L, __func__, qsl("mouse event '%1' already exists").arg(uniqueName));
     }
+    if (!checkStringArg(L, __func__, 2, "event name", false)) {
+        return lua_error(L);
+    }
 
-    actionInfo << getVerifiedString(L, __func__, 2, "event name", false);
+    const QString uniqueName{lua_tostring(L, 1)};
+    QStringList actionInfo;
+    actionInfo << QString{lua_tostring(L, 2)};
 
     // Display name
     if (!lua_isstring(L, 3)) {
@@ -380,21 +389,19 @@ int TLuaInterpreter::createLabel(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#createMiniConsole
 int TLuaInterpreter::createMiniConsole(lua_State* L)
 {
-    QString name = "";
     int counter = 3;
     //make the windowname optional by using counter. If windowname "main" add to main console
 
-    QString windowName = getVerifiedString(L, __func__, 1, "miniconsole name");
-    if (isMain(windowName)) {
-        // createMiniConsole only accepts the empty name as the main window
-        windowName.clear();
+    if (!checkStringArg(L, __func__, 1, "miniconsole name")) {
+        return lua_error(L);
     }
 
-    if (!lua_isnumber(L, 2) && lua_gettop(L) >= 2) {
-        name = getVerifiedString(L, __func__, 2, "miniconsole name");
+    const bool hasParentWindow = (!lua_isnumber(L, 2) && lua_gettop(L) >= 2);
+    if (hasParentWindow) {
+        if (!checkStringArg(L, __func__, 2, "miniconsole name")) {
+            return lua_error(L);
+        }
     } else {
-        name = windowName;
-        windowName.clear();
         counter = 2;
     }
 
@@ -406,6 +413,22 @@ int TLuaInterpreter::createMiniConsole(lua_State* L)
     counter++;
     const int height = getVerifiedInt(L, __func__, counter, "miniconsole height");
 
+    QString windowName;
+    QString name;
+    if (hasParentWindow) {
+        windowName = lua_tostring(L, 1);
+        if (isMain(windowName)) {
+            // createMiniConsole only accepts the empty name as the main window
+            windowName.clear();
+        }
+        name = lua_tostring(L, 2);
+    } else {
+        name = lua_tostring(L, 1);
+        if (isMain(name)) {
+            name.clear();
+        }
+    }
+
     Host& host = getHostFromLua(L);
     if (auto [success, message] = host.createMiniConsole(windowName, name, x, y, width, height); !success) {
         return warnArgumentValue(L, __func__, message, true);
@@ -418,21 +441,19 @@ int TLuaInterpreter::createMiniConsole(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#createScrollBox
 int TLuaInterpreter::createScrollBox(lua_State* L)
 {
-    QString name = "";
     int counter = 3;
     // make the windowname optional by using counter. If windowname "main" - add to main console
 
-    QString windowName = getVerifiedString(L, __func__, 1, "scrollBox name");
-    if (isMain(windowName)) {
-        // createScrollBox only accepts the empty name as the main window
-        windowName.clear();
+    if (!checkStringArg(L, __func__, 1, "scrollBox name")) {
+        return lua_error(L);
     }
 
-    if (!lua_isnumber(L, 2) && lua_gettop(L) >= 2) {
-        name = getVerifiedString(L, __func__, 2, "scrollBox name");
+    const bool hasParentWindow = (!lua_isnumber(L, 2) && lua_gettop(L) >= 2);
+    if (hasParentWindow) {
+        if (!checkStringArg(L, __func__, 2, "scrollBox name")) {
+            return lua_error(L);
+        }
     } else {
-        name = windowName;
-        windowName.clear();
         counter = 2;
     }
 
@@ -444,6 +465,22 @@ int TLuaInterpreter::createScrollBox(lua_State* L)
     counter++;
     const int height = getVerifiedInt(L, __func__, counter, "scrollBox height");
 
+    QString windowName;
+    QString name;
+    if (hasParentWindow) {
+        windowName = lua_tostring(L, 1);
+        if (isMain(windowName)) {
+            // createScrollBox only accepts the empty name as the main window
+            windowName.clear();
+        }
+        name = lua_tostring(L, 2);
+    } else {
+        name = lua_tostring(L, 1);
+        if (isMain(name)) {
+            name.clear();
+        }
+    }
+
     const Host& host = getHostFromLua(L);
     if (auto [success, message] = host.createScrollBox(windowName, name, x, y, width, height); !success) {
         return warnArgumentValue(L, __func__, message, true);
@@ -590,8 +627,11 @@ int TLuaInterpreter::getTextEditText(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setTextEditText
 int TLuaInterpreter::setTextEditText(lua_State* L)
 {
-    const QString textEditName = getVerifiedString(L, __func__, 1, "text edit name");
+    if (!checkStringArg(L, __func__, 1, "text edit name")) {
+        return lua_error(L);
+    }
     const QString text = getVerifiedString(L, __func__, 2, "text");
+    const QString textEditName{lua_tostring(L, 1)};
 
     const Host& host = getHostFromLua(L);
     auto pT = host.mpConsole->mTextBoxMap.value(textEditName);
@@ -623,8 +663,11 @@ int TLuaInterpreter::clearTextEdit(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setTextEditReadOnly
 int TLuaInterpreter::setTextEditReadOnly(lua_State* L)
 {
-    const QString textEditName = getVerifiedString(L, __func__, 1, "text edit name");
+    if (!checkStringArg(L, __func__, 1, "text edit name")) {
+        return lua_error(L);
+    }
     const bool readOnly = getVerifiedBool(L, __func__, 2, "read only state");
+    const QString textEditName{lua_tostring(L, 1)};
 
     const Host& host = getHostFromLua(L);
     auto pT = host.mpConsole->mTextBoxMap.value(textEditName);
@@ -640,8 +683,11 @@ int TLuaInterpreter::setTextEditReadOnly(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setTextEditPlaceholder
 int TLuaInterpreter::setTextEditPlaceholder(lua_State* L)
 {
-    const QString textEditName = getVerifiedString(L, __func__, 1, "text edit name");
+    if (!checkStringArg(L, __func__, 1, "text edit name")) {
+        return lua_error(L);
+    }
     const QString placeholder = getVerifiedString(L, __func__, 2, "placeholder text");
+    const QString textEditName{lua_tostring(L, 1)};
 
     const Host& host = getHostFromLua(L);
     auto pT = host.mpConsole->mTextBoxMap.value(textEditName);
@@ -657,8 +703,11 @@ int TLuaInterpreter::setTextEditPlaceholder(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setTextEditStyleSheet
 int TLuaInterpreter::setTextEditStyleSheet(lua_State* L)
 {
-    const QString textEditName = getVerifiedString(L, __func__, 1, "text edit name");
+    if (!checkStringArg(L, __func__, 1, "text edit name")) {
+        return lua_error(L);
+    }
     const QString css = getVerifiedString(L, __func__, 2, "stylesheet");
+    const QString textEditName{lua_tostring(L, 1)};
 
     const Host& host = getHostFromLua(L);
     auto pT = host.mpConsole->mTextBoxMap.value(textEditName);
@@ -674,8 +723,11 @@ int TLuaInterpreter::setTextEditStyleSheet(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setTextEditFont
 int TLuaInterpreter::setTextEditFont(lua_State* L)
 {
-    const QString textEditName = getVerifiedString(L, __func__, 1, "text edit name");
+    if (!checkStringArg(L, __func__, 1, "text edit name")) {
+        return lua_error(L);
+    }
     const QString fontName = getVerifiedString(L, __func__, 2, "font name");
+    const QString textEditName{lua_tostring(L, 1)};
 
     const Host& host = getHostFromLua(L);
     auto pT = host.mpConsole->mTextBoxMap.value(textEditName);
@@ -693,8 +745,11 @@ int TLuaInterpreter::setTextEditFont(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setTextEditFontSize
 int TLuaInterpreter::setTextEditFontSize(lua_State* L)
 {
-    const QString textEditName = getVerifiedString(L, __func__, 1, "text edit name");
+    if (!checkStringArg(L, __func__, 1, "text edit name")) {
+        return lua_error(L);
+    }
     const int size = getVerifiedInt(L, __func__, 2, "font size");
+    const QString textEditName{lua_tostring(L, 1)};
 
     const Host& host = getHostFromLua(L);
     auto pT = host.mpConsole->mTextBoxMap.value(textEditName);
@@ -712,8 +767,11 @@ int TLuaInterpreter::setTextEditFontSize(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setTextEditTabMovesFocus
 int TLuaInterpreter::setTextEditTabMovesFocus(lua_State* L)
 {
-    const QString textEditName = getVerifiedString(L, __func__, 1, "text edit name");
+    if (!checkStringArg(L, __func__, 1, "text edit name")) {
+        return lua_error(L);
+    }
     const bool tabMovesFocus = getVerifiedBool(L, __func__, 2, "tab moves focus state");
+    const QString textEditName{lua_tostring(L, 1)};
 
     const Host& host = getHostFromLua(L);
     auto pT = host.mpConsole->mTextBoxMap.value(textEditName);
@@ -840,54 +898,50 @@ int TLuaInterpreter::disableTimeStamps(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#echoLink
 int TLuaInterpreter::echoLink(lua_State* L)
 {
+    const int n = lua_gettop(L);
+    // with exactly four arguments the last one is either the format flag - and
+    // then there is no window name - or the hint
+    const bool hasWindowName = (n > 4) || (n == 4 && !lua_isboolean(L, 4));
+    const bool hasFormatFlag = (n > 4) || (n == 4 && lua_isboolean(L, 4));
+
+    int s = 0;
+    const int windowNamePos = hasWindowName ? ++s : 0;
+    if (hasWindowName && !checkStringArg(L, __func__, windowNamePos, "window name")) {
+        return lua_error(L);
+    }
+    const int textPos = ++s;
+    if (!checkStringArg(L, __func__, textPos, "text")) {
+        return lua_error(L);
+    }
+    int commandPos = ++s;
+    if (!checkCommandOrFunctionArg(L, __func__, commandPos)) {
+        return lua_error(L);
+    }
+    const int hintPos = ++s;
+    if (!checkStringArg(L, __func__, hintPos, "hint")) {
+        return lua_error(L);
+    }
+    const int formatPos = hasFormatFlag ? ++s : 0;
+    if (hasFormatFlag && !checkBoolArg(L, __func__, formatPos, "useCurrentFormat")) {
+        return lua_error(L);
+    }
+
+    QString command;
+    int luaReference = 0;
+    parseCommandOrFunction(L, __func__, commandPos, command, luaReference);
+
     QStringList commandList;
     QStringList hintList;
     QVector luaReferences;
-    const int n = lua_gettop(L);
-    int s = 0;
-    int luaReference = 0;
-    bool useCurrentFormat = false;
-    QString windowName = qsl("main");
-    QString hint;
-    QString command;
-    QString text;
-
-    if (n < 4) {
-        // (string) text, (string) command/function, (string) hint
-        text = getVerifiedString(L, __func__, ++s, "text");
-        parseCommandOrFunction(L, __func__, ++s, command, luaReference);
-        hint = getVerifiedString(L, __func__, ++s, "hint");
-
-    } else {
-        if (n == 4) {
-            // EITHER: (string) text, (string) command/function, (string) hint, (bool) standard/NotDefaultFormat
-            //     OR: (string) windowName, (string) text, (string) command/function, (string) hint
-            if (!lua_isboolean(L, 4)) {
-                windowName = getVerifiedString(L, __func__, ++s, "window name");
-            }
-            text = getVerifiedString(L, __func__, ++s, "text");
-            parseCommandOrFunction(L, __func__, ++s, command, luaReference);
-            hint = getVerifiedString(L, __func__, ++s, "hint");
-            if (lua_isboolean(L, 4)) {
-                useCurrentFormat = getVerifiedBool(L, __func__, ++s, "useCurrentFormat");
-            }
-        } else {
-            // n > 4:
-            // (string) windowName, (string) text, (string) command/function, (string) hint, (bool) standard/NotDefaultFormat
-            windowName = getVerifiedString(L, __func__, ++s, "window name");
-            text = getVerifiedString(L, __func__, ++s, "text");
-            parseCommandOrFunction(L, __func__, ++s, command, luaReference);
-            hint = getVerifiedString(L, __func__, ++s, "hint");
-            useCurrentFormat = getVerifiedBool(L, __func__, ++s, "useCurrentFormat");
-        }
-    }
-
     commandList << command;
     luaReferences << luaReference;
-    hintList << hint;
+    hintList << QString{lua_tostring(L, hintPos)};
+
+    const QString windowName = hasWindowName ? QString{lua_tostring(L, windowNamePos)} : qsl("main");
+    const bool useCurrentFormat = hasFormatFlag && lua_toboolean(L, formatPos);
 
     auto console = CONSOLE(L, windowName);
-    console->echoLink(text, commandList, hintList, useCurrentFormat, luaReferences);
+    console->echoLink(QString{lua_tostring(L, textPos)}, commandList, hintList, useCurrentFormat, luaReferences);
     lua_pushboolean(L, true);
     return 1;
 }
@@ -895,54 +949,44 @@ int TLuaInterpreter::echoLink(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#echoUserWindow
 int TLuaInterpreter::echoUserWindow(lua_State* L)
 {
-    const QString windowName{WINDOW_NAME(L, 1)};
+    const char* windowName = WINDOW_NAME(L, 1);
     const QString text = getVerifiedString(L, __func__, 2, "text");
     Host& host = getHostFromLua(L);
-    host.echoWindow(windowName, text);
+    host.echoWindow(QString{windowName}, text);
     return 0;
 }
 
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#echoPopup
 int TLuaInterpreter::echoPopup(lua_State* L)
 {
+    const int n = lua_gettop(L);
+    // with exactly four arguments the last one is either the format flag - and
+    // then there is no window name - or the hints table
+    const bool hasWindowName = (n > 4) || (n == 4 && !lua_isboolean(L, 4));
+    const bool hasFormatFlag = (n > 4) || (n == 4 && lua_isboolean(L, 4));
+
+    int s = 0;
+    const int windowNamePos = hasWindowName ? ++s : 0;
+    if (hasWindowName && !checkStringArg(L, __func__, windowNamePos, "window name")) {
+        return lua_error(L);
+    }
+    const int textPos = ++s;
+    if (!checkStringArg(L, __func__, textPos, "text")) {
+        return lua_error(L);
+    }
+    int commandPos = ++s;
+    int hintPos = ++s;
+    const int formatPos = hasFormatFlag ? ++s : 0;
+
+    if (!checkCommandsOrFunctionsTable(L, __func__, commandPos) || !checkHintsTable(L, __func__, hintPos) || (hasFormatFlag && !checkBoolArg(L, __func__, formatPos, "useCurrentFormat"))) {
+        return lua_error(L);
+    }
+
     QStringList commandList;
     QStringList hintList;
     QVector luaReferences;
-    const int n = lua_gettop(L);
-    int s = 0;
-    bool useCurrentFormat = false;
-    QString windowName = qsl("main");
-    QString text;
-
-    if (n < 4) {
-        // (string) text, {table of (string) / (functions) commands}, {table of (strings) hints}
-        text = getVerifiedString(L, __func__, ++s, "text");
-        parseCommandsOrFunctionsTable(L, __func__, ++s, commandList, luaReferences);
-        parseHintsTable(L, __func__, ++s, hintList);
-
-    } else {
-        if (n == 4) {
-            // EITHER: (string) text, {table of (string) / (functions) commands}, {table of (strings) hints}, (bool) standard/NotDefaultFormat
-            //     OR: (string) windowName, (string) text, {table of (string) / (functions) commands}, {table of (strings) hints}
-            if (!lua_isboolean(L, 4)) {
-                windowName = getVerifiedString(L, __func__, ++s, "window name");
-            }
-            text = getVerifiedString(L, __func__, ++s, "text");
-            parseCommandsOrFunctionsTable(L, __func__, ++s, commandList, luaReferences);
-            parseHintsTable(L, __func__, ++s, hintList);
-            if (lua_isboolean(L, 4)) {
-                useCurrentFormat = getVerifiedBool(L, __func__, ++s, "useCurrentFormat");
-            }
-        } else {
-            // n > 4:
-            // (string) windowName, (string) text, {table of (string) / (functions) commands}, {table of (strings) hints}, (bool) standard/NotDefaultFormat
-            windowName = getVerifiedString(L, __func__, ++s, "window name");
-            text = getVerifiedString(L, __func__, ++s, "text");
-            parseCommandsOrFunctionsTable(L, __func__, ++s, commandList, luaReferences);
-            parseHintsTable(L, __func__, ++s, hintList);
-            useCurrentFormat = getVerifiedBool(L, __func__, ++s, "useCurrentFormat");
-        }
-    }
+    parseCommandsOrFunctionsTable(L, __func__, commandPos, commandList, luaReferences);
+    parseHintsTable(L, __func__, hintPos, hintList);
 
     if ((hintList.size() - commandList.size()) < 0 || (hintList.size() - commandList.size()) > 1) {
         lua_pushnil(L);
@@ -953,8 +997,11 @@ int TLuaInterpreter::echoPopup(lua_State* L)
         return 2;
     }
 
+    const QString windowName = hasWindowName ? QString{lua_tostring(L, windowNamePos)} : qsl("main");
+    const bool useCurrentFormat = hasFormatFlag && lua_toboolean(L, formatPos);
+
     auto console = CONSOLE(L, windowName);
-    console->echoLink(text, commandList, hintList, useCurrentFormat, luaReferences);
+    console->echoLink(QString{lua_tostring(L, textPos)}, commandList, hintList, useCurrentFormat, luaReferences);
     lua_pushboolean(L, true);
     return 1;
 }
@@ -973,10 +1020,18 @@ int TLuaInterpreter::enableClickthrough(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setLinkStyle
 int TLuaInterpreter::setLinkStyle(lua_State* L)
 {
-    const QString labelName = getVerifiedString(L, __func__, 1, "label name");
-    const QString linkColor = getVerifiedString(L, __func__, 2, "link color", true);
-    const QString linkVisitedColor = getVerifiedString(L, __func__, 3, "link visited color", true);
-    const bool underline = (lua_gettop(L) >= 4) ? getVerifiedBool(L, __func__, 4, "underline", true) : true;
+    const bool hasUnderline = (lua_gettop(L) >= 4);
+    if (!checkStringArg(L, __func__, 1, "label name") || !checkStringArg(L, __func__, 2, "link color", true) || !checkStringArg(L, __func__, 3, "link visited color", true)) {
+        return lua_error(L);
+    }
+    if (hasUnderline && !checkBoolArg(L, __func__, 4, "underline", true)) {
+        return lua_error(L);
+    }
+
+    const QString labelName{lua_tostring(L, 1)};
+    const QString linkColor{lua_tostring(L, 2)};
+    const QString linkVisitedColor{lua_tostring(L, 3)};
+    const bool underline = hasUnderline ? static_cast(lua_toboolean(L, 4)) : true;
 
     Host& host = getHostFromLua(L);
 
@@ -1385,13 +1440,18 @@ int TLuaInterpreter::getLines(lua_State* L)
 {
     const int n = lua_gettop(L);
     int s = 1;
-    QString windowName;
-    if (n > 2) {
-        windowName = getVerifiedString(L, __func__, s++, "mini console, user window or buffer name {may be omitted for the \"main\" console}", true);
+    const int windowNamePos = (n > 2) ? s++ : 0;
+    if (windowNamePos && !checkStringArg(L, __func__, windowNamePos, "mini console, user window or buffer name {may be omitted for the \"main\" console}", true)) {
+        return lua_error(L);
     }
     const int lineFrom = getVerifiedInt(L, __func__, s++, "start line");
     const int lineTo = getVerifiedInt(L, __func__, s, "end line");
 
+    QString windowName;
+    if (windowNamePos) {
+        windowName = lua_tostring(L, windowNamePos);
+    }
+
     Host& host = getHostFromLua(L);
     QPair const result = host.getLines(windowName, lineFrom, lineTo);
     if (!result.first) {
@@ -1768,54 +1828,50 @@ int TLuaInterpreter::hideWindow(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#insertLink
 int TLuaInterpreter::insertLink(lua_State* L)
 {
+    const int n = lua_gettop(L);
+    // with exactly four arguments the last one is either the format flag - and
+    // then there is no window name - or the hint
+    const bool hasWindowName = (n > 4) || (n == 4 && !lua_isboolean(L, 4));
+    const bool hasFormatFlag = (n > 4) || (n == 4 && lua_isboolean(L, 4));
+
+    int s = 0;
+    const int windowNamePos = hasWindowName ? ++s : 0;
+    if (hasWindowName && !checkStringArg(L, __func__, windowNamePos, "window name")) {
+        return lua_error(L);
+    }
+    const int textPos = ++s;
+    if (!checkStringArg(L, __func__, textPos, "text")) {
+        return lua_error(L);
+    }
+    int commandPos = ++s;
+    if (!checkCommandOrFunctionArg(L, __func__, commandPos)) {
+        return lua_error(L);
+    }
+    const int hintPos = ++s;
+    if (!checkStringArg(L, __func__, hintPos, "hint")) {
+        return lua_error(L);
+    }
+    const int formatPos = hasFormatFlag ? ++s : 0;
+    if (hasFormatFlag && !checkBoolArg(L, __func__, formatPos, "useCurrentFormat")) {
+        return lua_error(L);
+    }
+
+    QString command;
+    int luaReference = 0;
+    parseCommandOrFunction(L, __func__, commandPos, command, luaReference);
+
     QStringList commandList;
     QStringList hintList;
     QVector luaReferences;
-    const int n = lua_gettop(L);
-    int s = 0;
-    int luaReference = 0;
-    bool useCurrentFormat = false;
-    QString windowName = qsl("main");
-    QString hint;
-    QString command;
-    QString text;
-
-    if (n < 4) {
-        // (string) text, (string) command/function, (string) hint
-        text = getVerifiedString(L, __func__, ++s, "text");
-        parseCommandOrFunction(L, __func__, ++s, command, luaReference);
-        hint = getVerifiedString(L, __func__, ++s, "hint");
-
-    } else {
-        if (n == 4) {
-            // EITHER: (string) text, (string) command/function, (string) hint, (bool) standard/NotDefaultFormat
-            //     OR: (string) windowName, (string) text, (string) command/function, (string) hint
-            if (!lua_isboolean(L, 4)) {
-                windowName = getVerifiedString(L, __func__, ++s, "window name");
-            }
-            text = getVerifiedString(L, __func__, ++s, "text");
-            parseCommandOrFunction(L, __func__, ++s, command, luaReference);
-            hint = getVerifiedString(L, __func__, ++s, "hint");
-            if (lua_isboolean(L, 4)) {
-                useCurrentFormat = getVerifiedBool(L, __func__, ++s, "useCurrentFormat");
-            }
-        } else {
-            // n > 4:
-            // (string) windowName, (string) text, (string) command/function, (string) hint, (bool) standard/NotDefaultFormat
-            windowName = getVerifiedString(L, __func__, ++s, "window name");
-            text = getVerifiedString(L, __func__, ++s, "text");
-            parseCommandOrFunction(L, __func__, ++s, command, luaReference);
-            hint = getVerifiedString(L, __func__, ++s, "hint");
-            useCurrentFormat = getVerifiedBool(L, __func__, ++s, "useCurrentFormat");
-        }
-    }
-
     commandList << command;
     luaReferences << luaReference;
-    hintList << hint;
+    hintList << QString{lua_tostring(L, hintPos)};
+
+    const QString windowName = hasWindowName ? QString{lua_tostring(L, windowNamePos)} : qsl("main");
+    const bool useCurrentFormat = hasFormatFlag && lua_toboolean(L, formatPos);
 
     auto console = CONSOLE(L, windowName);
-    console->insertLink(text, commandList, hintList, useCurrentFormat, luaReferences);
+    console->insertLink(QString{lua_tostring(L, textPos)}, commandList, hintList, useCurrentFormat, luaReferences);
     lua_pushboolean(L, true);
     return 1;
 }
@@ -1823,44 +1879,34 @@ int TLuaInterpreter::insertLink(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#insertPopup
 int TLuaInterpreter::insertPopup(lua_State* L)
 {
+    const int n = lua_gettop(L);
+    // with exactly four arguments the last one is either the format flag - and
+    // then there is no window name - or the hints table
+    const bool hasWindowName = (n > 4) || (n == 4 && !lua_isboolean(L, 4));
+    const bool hasFormatFlag = (n > 4) || (n == 4 && lua_isboolean(L, 4));
+
+    int s = 0;
+    const int windowNamePos = hasWindowName ? ++s : 0;
+    if (hasWindowName && !checkStringArg(L, __func__, windowNamePos, "window name")) {
+        return lua_error(L);
+    }
+    const int textPos = ++s;
+    if (!checkStringArg(L, __func__, textPos, "text")) {
+        return lua_error(L);
+    }
+    int commandPos = ++s;
+    int hintPos = ++s;
+    const int formatPos = hasFormatFlag ? ++s : 0;
+
+    if (!checkCommandsOrFunctionsTable(L, __func__, commandPos) || !checkHintsTable(L, __func__, hintPos) || (hasFormatFlag && !checkBoolArg(L, __func__, formatPos, "useCurrentFormat"))) {
+        return lua_error(L);
+    }
+
     QStringList commandList;
     QStringList hintList;
     QVector luaReferences;
-    const int n = lua_gettop(L);
-    int s = 0;
-    bool useCurrentFormat = false;
-    QString windowName = qsl("main");
-    QString text;
-
-    if (n < 4) {
-        // (string) text, {table of (string) / (functions) commands}, {table of (strings) hints}
-        text = getVerifiedString(L, __func__, ++s, "text");
-        parseCommandsOrFunctionsTable(L, __func__, ++s, commandList, luaReferences);
-        parseHintsTable(L, __func__, ++s, hintList);
-
-    } else {
-        if (n == 4) {
-            // EITHER: (string) text, {table of (string) / (functions) commands}, {table of (strings) hints}, (bool) standard/NotDefaultFormat
-            //     OR: (string) windowName, (string) text, {table of (string) / (functions) commands}, {table of (strings) hints}
-            if (!lua_isboolean(L, 4)) {
-                windowName = getVerifiedString(L, __func__, ++s, "window name");
-            }
-            text = getVerifiedString(L, __func__, ++s, "text");
-            parseCommandsOrFunctionsTable(L, __func__, ++s, commandList, luaReferences);
-            parseHintsTable(L, __func__, ++s, hintList);
-            if (lua_isboolean(L, 4)) {
-                useCurrentFormat = getVerifiedBool(L, __func__, ++s, "useCurrentFormat");
-            }
-        } else {
-            // n > 4:
-            // (string) windowName, (string) text, {table of (string) / (functions) commands}, {table of (strings) hints}, (bool) standard/NotDefaultFormat
-            windowName = getVerifiedString(L, __func__, ++s, "window name");
-            text = getVerifiedString(L, __func__, ++s, "text");
-            parseCommandsOrFunctionsTable(L, __func__, ++s, commandList, luaReferences);
-            parseHintsTable(L, __func__, ++s, hintList);
-            useCurrentFormat = getVerifiedBool(L, __func__, ++s, "useCurrentFormat");
-        }
-    }
+    parseCommandsOrFunctionsTable(L, __func__, commandPos, commandList, luaReferences);
+    parseHintsTable(L, __func__, hintPos, hintList);
 
     if ((hintList.size() - commandList.size()) < 0 || (hintList.size() - commandList.size()) > 1) {
         lua_pushnil(L);
@@ -1871,8 +1917,11 @@ int TLuaInterpreter::insertPopup(lua_State* L)
         return 2;
     }
 
+    const QString windowName = hasWindowName ? QString{lua_tostring(L, windowNamePos)} : qsl("main");
+    const bool useCurrentFormat = hasFormatFlag && lua_toboolean(L, formatPos);
+
     auto console = CONSOLE(L, windowName);
-    console->insertLink(text, commandList, hintList, useCurrentFormat, luaReferences);
+    console->insertLink(QString{lua_tostring(L, textPos)}, commandList, hintList, useCurrentFormat, luaReferences);
     lua_pushboolean(L, true);
     return 1;
 }
@@ -1880,7 +1929,7 @@ int TLuaInterpreter::insertPopup(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#insertText
 int TLuaInterpreter::insertText(lua_State* L)
 {
-    QString windowName;
+    const char* windowName = "";
     int s = 0;
 
     if (lua_gettop(L) > 1) { // Have more than one argument so first must be a console name
@@ -1888,7 +1937,7 @@ int TLuaInterpreter::insertText(lua_State* L)
     }
     const QString text = getVerifiedString(L, __func__, ++s, "text");
 
-    auto console = CONSOLE(L, windowName);
+    auto console = CONSOLE(L, QString{windowName});
     console->insertText(text);
     lua_pushboolean(L, true);
     return 1;
@@ -1988,7 +2037,7 @@ int TLuaInterpreter::isAnsiBgColor(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#isAnsiFgColor
 int TLuaInterpreter::isAnsiFgColor(lua_State* L)
 {
-    QString windowName = "main";
+    QString windowName = qsl("main");
     const int ansiFg = getVerifiedInt(L, __func__, 1, "ANSI color");
 
     std::list result;
@@ -2097,7 +2146,7 @@ int TLuaInterpreter::moveCursor(lua_State* L)
 {
     int s = 1;
     const int n = lua_gettop(L);
-    QString windowName;
+    const char* windowName = "";
     if (n > 2) {
         windowName = WINDOW_NAME(L, s++);
     }
@@ -2105,7 +2154,7 @@ int TLuaInterpreter::moveCursor(lua_State* L)
     const int luaFrom = getVerifiedInt(L, __func__, s++, "x");
     const int luaTo = getVerifiedInt(L, __func__, s, "y");
 
-    auto console = CONSOLE(L, windowName);
+    auto console = CONSOLE(L, QString{windowName});
     lua_pushboolean(L, console->moveCursor(luaFrom, luaTo));
     return 1;
 }
@@ -2122,9 +2171,12 @@ int TLuaInterpreter::moveCursorEnd(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#moveWindow
 int TLuaInterpreter::moveWindow(lua_State* L)
 {
-    const QString text = getVerifiedString(L, __func__, 1, "name");
+    if (!checkStringArg(L, __func__, 1, "name")) {
+        return lua_error(L);
+    }
     const double x1 = getVerifiedDouble(L, __func__, 2, "x");
     const double y1 = getVerifiedDouble(L, __func__, 3, "y");
+    const QString text{lua_tostring(L, 1)};
     Host& host = getHostFromLua(L);
     host.moveWindow(text, static_cast(x1), static_cast(y1));
     return 0;
@@ -2138,22 +2190,22 @@ int TLuaInterpreter::openUserWindow(lua_State* L)
         lua_pushfstring(L, "openUserWindow:  bad argument #1 type (name as string expected, got %s!)", luaL_typename(L, 1));
         return lua_error(L);
     }
-    const QString name{lua_tostring(L, 1)};
+    if (n > 1 && !checkBoolArg(L, __func__, 2, "loadLayout", true)) {
+        return lua_error(L);
+    }
+    if (n > 2 && !checkBoolArg(L, __func__, 3, "autoDock", true)) {
+        return lua_error(L);
+    }
+    if (n > 3 && lua_type(L, 4) != LUA_TSTRING) {
+        lua_pushfstring(L, "openUserWindow: bad argument #4 type (area as string expected, got %s!)", luaL_typename(L, 4));
+        return lua_error(L);
+    }
 
-    bool loadLayout = true;
-    if (n > 1) {
-        loadLayout = getVerifiedBool(L, __func__, 2, "loadLayout", true);
-    }
-    bool autoDock = true;
-    if (n > 2) {
-        autoDock = getVerifiedBool(L, __func__, 3, "autoDock", true);
-    }
-    QString area = QString();
+    const QString name{lua_tostring(L, 1)};
+    const bool loadLayout = (n > 1) ? static_cast(lua_toboolean(L, 2)) : true;
+    const bool autoDock = (n > 2) ? static_cast(lua_toboolean(L, 3)) : true;
+    QString area;
     if (n > 3) {
-        if (lua_type(L, 4) != LUA_TSTRING) {
-            lua_pushfstring(L, "openUserWindow: bad argument #4 type (area as string expected, got %s!)", luaL_typename(L, 4));
-            return lua_error(L);
-        }
         area = lua_tostring(L, 4);
     }
 
@@ -2183,7 +2235,7 @@ int TLuaInterpreter::paste(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#pauseMovie
 int TLuaInterpreter::pauseMovie(lua_State* L)
 {
-    return movieFunc(L, qsl("pauseMovie"));
+    return movieFunc(L, "pauseMovie");
 }
 
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#raiseWindow
@@ -2198,16 +2250,19 @@ int TLuaInterpreter::raiseWindow(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#removeCommandLineMenuEvent
 int TLuaInterpreter::removeCommandLineMenuEvent(lua_State* L)
 {
-    int args = 1;
     const int argsCount = lua_gettop(L);
+    const bool hasCommandLineName = (argsCount >= 2);
+    const int menuLabelPos = hasCommandLineName ? 2 : 1;
 
-    QString commandLineName;
-    if (argsCount >= 2) {
-        commandLineName = getVerifiedString(L, __func__, args++, "command line name");
-    } else {
-        commandLineName = qsl("main");
+    if (hasCommandLineName && !checkStringArg(L, __func__, 1, "command line name")) {
+        return lua_error(L);
     }
-    auto menuLabel = getVerifiedString(L, __func__, args++, "menu label");
+    if (!checkStringArg(L, __func__, menuLabelPos, "menu label")) {
+        return lua_error(L);
+    }
+
+    const QString commandLineName = hasCommandLineName ? QString{lua_tostring(L, 1)} : qsl("main");
+    const QString menuLabel{lua_tostring(L, menuLabelPos)};
 
     const auto& commandline = COMMANDLINE(L, commandLineName);
 
@@ -2238,14 +2293,14 @@ int TLuaInterpreter::replace(lua_State* L)
 {
     const int n = lua_gettop(L);
     int s = 1;
-    QString windowName;
+    const char* windowName = "";
 
     if (n > 1) {
         windowName = WINDOW_NAME(L, s++);
     }
     const QString text = getVerifiedString(L, __func__, s, "with");
 
-    auto console = CONSOLE(L, windowName);
+    auto console = CONSOLE(L, QString{windowName});
     console->replace(text);
     return 0;
 }
@@ -2275,8 +2330,8 @@ int TLuaInterpreter::resetBackgroundImage(lua_State* L)
     bool fullWindow = false;
     const int n = lua_gettop(L);
     int counter = 1;
-    if (n > 0 && lua_type(L, 1) == LUA_TSTRING) {
-        windowName = getVerifiedString(L, __func__, 1, "console name");
+    const bool hasWindowName = (n > 0 && lua_type(L, 1) == LUA_TSTRING);
+    if (hasWindowName) {
         counter++;
     }
 
@@ -2285,6 +2340,10 @@ int TLuaInterpreter::resetBackgroundImage(lua_State* L)
         counter++;
     }
 
+    if (hasWindowName) {
+        windowName = lua_tostring(L, 1);
+    }
+
     if (fullWindow && !(windowName.isEmpty() || windowName.compare(qsl("main"), Qt::CaseSensitive) == 0)) {
         return warnArgumentValue(L, __func__, qsl("the full window background can only be reset on the main console"));
     }
@@ -2310,9 +2369,12 @@ int TLuaInterpreter::resetFormat(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#resizeWindow
 int TLuaInterpreter::resizeWindow(lua_State* L)
 {
-    const QString text = getVerifiedString(L, __func__, 1, "windowName");
+    if (!checkStringArg(L, __func__, 1, "windowName")) {
+        return lua_error(L);
+    }
     const double x1 = getVerifiedDouble(L, __func__, 2, "width");
     const double y1 = getVerifiedDouble(L, __func__, 3, "height");
+    const QString text{lua_tostring(L, 1)};
     Host& host = getHostFromLua(L);
     host.resizeWindow(text, static_cast(x1), static_cast(y1));
     return 0;
@@ -2329,7 +2391,7 @@ int TLuaInterpreter::saveWindowLayout(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#scaleMovie
 int TLuaInterpreter::scaleMovie(lua_State* L)
 {
-    return movieFunc(L, qsl("scaleMovie"));
+    return movieFunc(L, "scaleMovie");
 }
 
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#selectCaptureGroup
@@ -2400,7 +2462,7 @@ int TLuaInterpreter::selectCaptureGroup(lua_State* L)
 int TLuaInterpreter::selectCmdLineText(lua_State* L)
 {
     const int n = lua_gettop(L);
-    QString name = "main";
+    QString name = qsl("main");
     if (n >= 1) {
         name = CMDLINE_NAME(L, 1);
     }
@@ -2426,7 +2488,7 @@ int TLuaInterpreter::selectCurrentLine(lua_State* L)
 int TLuaInterpreter::selectSection(lua_State* L)
 {
     int s = 1;
-    QString windowName;
+    const char* windowName = "";
 
     if (lua_gettop(L) > 2) {
         windowName = WINDOW_NAME(L, s++);
@@ -2434,7 +2496,7 @@ int TLuaInterpreter::selectSection(lua_State* L)
     const int from = getVerifiedInt(L, __func__, s++, "from position");
     const int to = getVerifiedInt(L, __func__, s, "length");
 
-    auto console = CONSOLE(L, windowName);
+    auto console = CONSOLE(L, QString{windowName});
     lua_pushboolean(L, console->selectSection(from, to));
     return 1;
 }
@@ -2443,17 +2505,21 @@ int TLuaInterpreter::selectSection(lua_State* L)
 int TLuaInterpreter::selectString(lua_State* L)
 {
     int s = 1;
-    QString windowName;
+    const char* windowName = "";
     if (lua_gettop(L) > 2) {
         windowName = WINDOW_NAME(L, s++);
     }
 
-    const QString searchText = getVerifiedString(L, __func__, s++, "text to select");
+    const int searchTextPos = s++;
+    if (!checkStringArg(L, __func__, searchTextPos, "text to select")) {
+        return lua_error(L);
+    }
     // CHECK: Do we need to qualify this for a non-blank string?
 
     const auto numOfMatch = getVerifiedInt(L, __func__, s, "match count {1 for first}");
+    const QString searchText{lua_tostring(L, searchTextPos)};
 
-    auto console = CONSOLE(L, windowName);
+    auto console = CONSOLE(L, QString{windowName});
     lua_pushnumber(L, console->select(searchText, numOfMatch));
     return 1;
 }
@@ -2490,12 +2556,18 @@ int TLuaInterpreter::setActiveProfile(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setAppStyleSheet
 int TLuaInterpreter::setAppStyleSheet(lua_State* L)
 {
-    QString styleSheet;
-    QString tag;
     const int n = lua_gettop(L);
-    styleSheet = getVerifiedString(L, __func__, 1, "style sheet");
+    if (!checkStringArg(L, __func__, 1, "style sheet")) {
+        return lua_error(L);
+    }
+    if (n > 1 && !checkStringArg(L, __func__, 2, "tag")) {
+        return lua_error(L);
+    }
+
+    const QString styleSheet{lua_tostring(L, 1)};
+    QString tag;
     if (n > 1) {
-        tag = getVerifiedString(L, __func__, 2, "tag");
+        tag = lua_tostring(L, 2);
     }
 
     Host& host = getHostFromLua(L);
@@ -2516,7 +2588,7 @@ int TLuaInterpreter::setAppStyleSheet(lua_State* L)
 int TLuaInterpreter::setBackgroundColor(lua_State* L)
 {
     Host& host = getHostFromLua(L);
-    QString windowName;
+    const char* windowNameArg = "";
     int r, alpha;
     int s = 1;
 
@@ -2525,7 +2597,7 @@ int TLuaInterpreter::setBackgroundColor(lua_State* L)
     };
 
     if (lua_type(L, s) == LUA_TSTRING) {
-        windowName = WINDOW_NAME(L, s++);
+        windowNameArg = WINDOW_NAME(L, s++);
         r = getVerifiedInt(L, __func__, s, "red value 0-255");
         if (!validRange(r)) {
             return warnArgumentValue(L, __func__, csmInvalidRedValue.arg(r));
@@ -2559,6 +2631,7 @@ int TLuaInterpreter::setBackgroundColor(lua_State* L)
         }
     }
 
+    const QString windowName{windowNameArg};
     if (isMain(windowName)) {
         host.mBgColor.setRgb(r, g, b, alpha);
         host.mpConsole->setConsoleBgColor(r, g, b, alpha);
@@ -2573,18 +2646,22 @@ int TLuaInterpreter::setBackgroundColor(lua_State* L)
 int TLuaInterpreter::setBackgroundImage(lua_State* L)
 {
     QString windowName = qsl("main");
-    QString imgPath;
     int mode = 1;
     bool fullWindow = false;
     int counter = 1;
     const int n = lua_gettop(L);
-    if (n > 1 && lua_type(L, 2) == LUA_TSTRING) {
-        windowName = getVerifiedString(L, __func__, 1, "console or label name");
+    const bool hasWindowName = (n > 1 && lua_type(L, 2) == LUA_TSTRING);
+    if (hasWindowName) {
+        if (!checkStringArg(L, __func__, 1, "console or label name")) {
+            return lua_error(L);
+        }
         counter++;
     }
 
-    imgPath = getVerifiedString(L, __func__, counter, "image path");
-    counter++;
+    const int imgPathPos = counter++;
+    if (!checkStringArg(L, __func__, imgPathPos, "image path")) {
+        return lua_error(L);
+    }
 
     if (counter <= n) {
         mode = getVerifiedInt(L, __func__, counter, "mode");
@@ -2596,6 +2673,11 @@ int TLuaInterpreter::setBackgroundImage(lua_State* L)
         counter++;
     }
 
+    if (hasWindowName) {
+        windowName = lua_tostring(L, 1);
+    }
+    QString imgPath{lua_tostring(L, imgPathPos)};
+
     if (mode < 1 || mode > 5) {
         return warnArgumentValue(L, __func__, qsl("%1 is not a valid mode! Valid modes are 1 'border', 2 'center', 3 'tile', 4 'style', 5 'cover'").arg(mode));
     }
@@ -2620,7 +2702,7 @@ int TLuaInterpreter::setBackgroundImage(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setBgColor
 int TLuaInterpreter::setBgColor(lua_State* L)
 {
-    QString windowName;
+    const char* windowName = "";
     int r, g, b, alpha;
 
     auto validRange = [](int number) {
@@ -2670,7 +2752,7 @@ int TLuaInterpreter::setBgColor(lua_State* L)
         }
     }
 
-    auto console = CONSOLE(L, windowName);
+    auto console = CONSOLE(L, QString{windowName});
     console->setBgColor(r, g, b, alpha);
     lua_pushboolean(L, true);
     return 1;
@@ -2679,13 +2761,13 @@ int TLuaInterpreter::setBgColor(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setBold
 int TLuaInterpreter::setBold(lua_State* L)
 {
-    QString windowName;
+    const char* windowName = "";
     int s = 1;
     if (lua_gettop(L) > 1) { // Have more than one argument so first must be a console name
         windowName = WINDOW_NAME(L, s++);
     }
     const bool isAttributeEnabled = getVerifiedBool(L, __func__, s, "enable bold attribute");
-    auto console = CONSOLE(L, windowName);
+    auto console = CONSOLE(L, QString{windowName});
     console->setDisplayAttributes(TChar::Bold, isAttributeEnabled);
     lua_pushboolean(L, true);
     return 1;
@@ -2792,7 +2874,7 @@ int TLuaInterpreter::setFgColor(lua_State* L)
     auto validRange = [](int number) {
         return number >= 0 && number <= 255;
     };
-    QString windowName;
+    const char* windowName = "";
     if (n > 3) {
         windowName = WINDOW_NAME(L, ++s);
     }
@@ -2809,7 +2891,7 @@ int TLuaInterpreter::setFgColor(lua_State* L)
         return warnArgumentValue(L, __func__, csmInvalidBlueValue.arg(luaBlue));
     }
 
-    auto console = CONSOLE(L, windowName);
+    auto console = CONSOLE(L, QString{windowName});
     console->setFgColor(luaRed, luaGreen, luaBlue);
     return 0;
 }
@@ -2818,8 +2900,11 @@ int TLuaInterpreter::setFgColor(lua_State* L)
 int TLuaInterpreter::setButtonStyleSheet(lua_State* L)
 {
     //args: name, css text
-    const QString name = getVerifiedString(L, __func__, 1, "name");
-    const QString css = getVerifiedString(L, __func__, 2, "css");
+    if (!checkStringArg(L, __func__, 1, "name") || !checkStringArg(L, __func__, 2, "css")) {
+        return lua_error(L);
+    }
+    const QString name{lua_tostring(L, 1)};
+    const QString css{lua_tostring(L, 2)};
     Host& host = getHostFromLua(L);
     auto actionIds = host.getActionUnit()->findItems(name);
     if (actionIds.empty()) {
@@ -2850,16 +2935,19 @@ int TLuaInterpreter::setClipboardText(lua_State* L)
 int TLuaInterpreter::setCmdLineAction(lua_State* L)
 {
     Host& host = getHostFromLua(L);
-    const QString name = getVerifiedString(L, __func__, 1, "command line name");
-    if (name.isEmpty()) {
-        return warnArgumentValue(L, __func__, "command line name cannot be an empty string");
-    }
-    lua_remove(L, 1);
-
-    if (!lua_isfunction(L, 1)) {
-        lua_pushfstring(L, "setCmdLineAction: bad argument #2 type (function expected, got %s!)", luaL_typename(L, 1));
+    if (!checkStringArg(L, __func__, 1, "command line name")) {
         return lua_error(L);
     }
+    if (const QString name{lua_tostring(L, 1)}; name.isEmpty()) {
+        return warnArgumentValue(L, __func__, "command line name cannot be an empty string");
+    }
+    if (!lua_isfunction(L, 2)) {
+        lua_pushfstring(L, "setCmdLineAction: bad argument #2 type (function expected, got %s!)", luaL_typename(L, 2));
+        return lua_error(L);
+    }
+
+    const QString name{lua_tostring(L, 1)};
+    lua_remove(L, 1);
     const int func = luaL_ref(L, LUA_REGISTRYINDEX);
 
     if (!host.setCmdLineAction(name, func)) {
@@ -2875,11 +2963,15 @@ int TLuaInterpreter::setCmdLineAction(lua_State* L)
 int TLuaInterpreter::setCmdLineStyleSheet(lua_State* L)
 {
     const int n = lua_gettop(L);
-    QString name = "main";
-    if (n > 1) {
-        name = getVerifiedString(L, __func__, 1, "command line name", true);
+    if (n > 1 && !checkStringArg(L, __func__, 1, "command line name", true)) {
+        return lua_error(L);
     }
-    const QString styleSheet = getVerifiedString(L, __func__, n, "StyleSheet");
+    if (!checkStringArg(L, __func__, n, "StyleSheet")) {
+        return lua_error(L);
+    }
+
+    const QString name = (n > 1) ? QString{lua_tostring(L, 1)} : qsl("main");
+    const QString styleSheet{lua_tostring(L, n)};
     const Host& host = getHostFromLua(L);
 
     if (auto [success, message] = host.mpConsole->setCmdLineStyleSheet(name, styleSheet); !success) {
@@ -2895,7 +2987,7 @@ int TLuaInterpreter::setFont(lua_State* L)
 {
     Host& host = getHostFromLua(L);
 
-    QString windowName;
+    const char* windowName = "";
     int s = 1;
 
     if (lua_gettop(L) > 1) { // Have more than one argument so first must be a console name
@@ -2936,7 +3028,7 @@ int TLuaInterpreter::setFont(lua_State* L)
     // For Qt 6.9+, emoji font support is handled globally in FontManager::addEmojiFont()
 #endif
 
-    auto console = CONSOLE(L, windowName);
+    auto console = CONSOLE(L, QString{windowName});
     if (console == host.mpConsole) {
         // apply changes to main console and its while-scrolling component too.
         QFont newFont = host.createFontWithSettings(effectiveFontName, host.getDisplayFont().pointSize());
@@ -2971,7 +3063,7 @@ int TLuaInterpreter::setFontSize(lua_State* L)
 {
     Host& host = getHostFromLua(L);
 
-    QString windowName;
+    const char* windowName = "";
     int s = 1;
     if (lua_gettop(L) > 1) { // Have more than one argument so first must be a console name
         windowName = WINDOW_NAME(L, s++);
@@ -2983,7 +3075,7 @@ int TLuaInterpreter::setFontSize(lua_State* L)
         return warnArgumentValue(L, __func__, "size cannot be 0 or negative");
     }
 
-    auto console = CONSOLE(L, windowName);
+    auto console = CONSOLE(L, QString{windowName});
     if (console == host.mpConsole) {
         // get host profile display font and alter it, since that is how it's done in Settings.
         host.setDisplayFontSize(size);
@@ -2997,13 +3089,13 @@ int TLuaInterpreter::setFontSize(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setItalics
 int TLuaInterpreter::setItalics(lua_State* L)
 {
-    QString windowName;
+    const char* windowName = "";
     int s = 1;
     if (lua_gettop(L) > 1) { // Have more than one argument so first must be a console name
         windowName = WINDOW_NAME(L, s++);
     }
     const bool isAttributeEnabled = getVerifiedBool(L, __func__, s, "enable italic attribute");
-    auto console = CONSOLE(L, windowName);
+    auto console = CONSOLE(L, QString{windowName});
     console->setDisplayAttributes(TChar::Italic, isAttributeEnabled);
     lua_pushboolean(L, true);
     return 1;
@@ -3012,12 +3104,15 @@ int TLuaInterpreter::setItalics(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setLabelToolTip
 int TLuaInterpreter::setLabelToolTip(lua_State* L)
 {
-    const QString labelName = getVerifiedString(L, __func__, 1, "label name");
-    const QString labelToolTip = getVerifiedString(L, __func__, 2, "text");
+    if (!checkStringArg(L, __func__, 1, "label name") || !checkStringArg(L, __func__, 2, "text")) {
+        return lua_error(L);
+    }
     double duration = 0;
     if (lua_gettop(L) > 2) {
         duration = getVerifiedDouble(L, __func__, 3, "duration");
     }
+    const QString labelName{lua_tostring(L, 1)};
+    const QString labelToolTip{lua_tostring(L, 2)};
 
     const Host& host = getHostFromLua(L);
 
@@ -3032,44 +3127,47 @@ int TLuaInterpreter::setLabelToolTip(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setLabelClickCallback
 int TLuaInterpreter::setLabelClickCallback(lua_State* L)
 {
-    return setLabelCallback(L, qsl("setLabelClickCallback"));
+    return setLabelCallback(L, "setLabelClickCallback");
 }
 
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setLabelDoubleClickCallback
 int TLuaInterpreter::setLabelDoubleClickCallback(lua_State* L)
 {
-    return setLabelCallback(L, qsl("setLabelDoubleClickCallback"));
+    return setLabelCallback(L, "setLabelDoubleClickCallback");
 }
 
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setLabelMoveCallback
 int TLuaInterpreter::setLabelMoveCallback(lua_State* L)
 {
-    return setLabelCallback(L, qsl("setLabelMoveCallback"));
+    return setLabelCallback(L, "setLabelMoveCallback");
 }
 
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setLabelOnEnter
 int TLuaInterpreter::setLabelOnEnter(lua_State* L)
 {
-    return setLabelCallback(L, qsl("setLabelOnEnter"));
+    return setLabelCallback(L, "setLabelOnEnter");
 }
 
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setLabelOnLeave
 int TLuaInterpreter::setLabelOnLeave(lua_State* L)
 {
-    return setLabelCallback(L, qsl("setLabelOnLeave"));
+    return setLabelCallback(L, "setLabelOnLeave");
 }
 
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setLabelReleaseCallback
 int TLuaInterpreter::setLabelReleaseCallback(lua_State* L)
 {
-    return setLabelCallback(L, qsl("setLabelReleaseCallback"));
+    return setLabelCallback(L, "setLabelReleaseCallback");
 }
 
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setLabelStyleSheet
 int TLuaInterpreter::setLabelStyleSheet(lua_State* L)
 {
-    const QString labelName = getVerifiedString(L, __func__, 1, "label name");
-    const QString stylesheet = getVerifiedString(L, __func__, 2, "stylesheet");
+    if (!checkStringArg(L, __func__, 1, "label name") || !checkStringArg(L, __func__, 2, "stylesheet")) {
+        return lua_error(L);
+    }
+    const QString labelName{lua_tostring(L, 1)};
+    const QString stylesheet{lua_tostring(L, 2)};
     const Host& host = getHostFromLua(L);
 
     if (auto [success, message] = host.mpConsole->setLabelStyleSheet(labelName, stylesheet); !success) {
@@ -3083,8 +3181,11 @@ int TLuaInterpreter::setLabelStyleSheet(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setLabelCursor
 int TLuaInterpreter::setLabelCursor(lua_State* L)
 {
-    const QString labelName = getVerifiedString(L, __func__, 1, "label name");
+    if (!checkStringArg(L, __func__, 1, "label name")) {
+        return lua_error(L);
+    }
     const int labelCursor = getVerifiedInt(L, __func__, 2, "cursortype");
+    const QString labelName{lua_tostring(L, 1)};
     const Host& host = getHostFromLua(L);
 
     if (auto [success, message] = host.mpConsole->setLabelCursor(labelName, labelCursor); !success) {
@@ -3100,14 +3201,18 @@ int TLuaInterpreter::setLabelCustomCursor(lua_State* L)
 {
     const int n = lua_gettop(L);
     int hotX = -1, hotY = -1;
-    const QString labelName = getVerifiedString(L, __func__, 1, "label name");
-    const QString pixmapLocation = getVerifiedString(L, __func__, 2, "custom cursor location");
+    if (!checkStringArg(L, __func__, 1, "label name") || !checkStringArg(L, __func__, 2, "custom cursor location")) {
+        return lua_error(L);
+    }
 
     if (n > 2) {
         hotX = getVerifiedInt(L, __func__, 3, "hot spot x-coordinate");
         hotY = getVerifiedInt(L, __func__, 4, "hot spot y-coordinate");
     }
 
+    const QString labelName{lua_tostring(L, 1)};
+    const QString pixmapLocation{lua_tostring(L, 2)};
+
     const Host& host = getHostFromLua(L);
 
     if (auto [success, message] = host.mpConsole->setLabelCustomCursor(labelName, pixmapLocation, hotX, hotY); !success) {
@@ -3121,32 +3226,40 @@ int TLuaInterpreter::setLabelCustomCursor(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setLabelWheelCallback
 int TLuaInterpreter::setLabelWheelCallback(lua_State* L)
 {
-    return setLabelCallback(L, qsl("setLabelWheelCallback"));
+    return setLabelCallback(L, "setLabelWheelCallback");
 }
 
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setLink
 int TLuaInterpreter::setLink(lua_State* L)
 {
-    QString windowName = qsl("main");
+    const char* windowName = "main";
     int s = 0;
     if (lua_gettop(L) > 2) {
         windowName = WINDOW_NAME(L, ++s);
     }
 
+    int commandPos = ++s;
+    if (!checkCommandOrFunctionArg(L, __func__, commandPos)) {
+        return lua_error(L);
+    }
+    const int hintPos = ++s;
+    if (!checkStringArg(L, __func__, hintPos, "tooltip")) {
+        return lua_error(L);
+    }
+
     QString command;
     int luaReference = 0;
-    parseCommandOrFunction(L, __func__, ++s, command, luaReference);
-    const QString hint = getVerifiedString(L, __func__, ++s, "tooltip");
+    parseCommandOrFunction(L, __func__, commandPos, command, luaReference);
 
     const Host& host = getHostFromLua(L);
     QStringList commandList;
     QStringList hintList;
     QVector luaReferences;
     commandList << command;
-    hintList << hint;
+    hintList << QString{lua_tostring(L, hintPos)};
     luaReferences << luaReference;
 
-    auto console = CONSOLE(L, windowName);
+    auto console = CONSOLE(L, QString{windowName});
     console->setLink(commandList, hintList, luaReferences);
     if (console != host.mpConsole) {
         console->mUpperPane->forceUpdate();
@@ -3186,11 +3299,17 @@ int TLuaInterpreter::setMapWindowTitle(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setMovie
 int TLuaInterpreter::setMovie(lua_State* L)
 {
-    const QString labelName = getVerifiedString(L, __func__, 1, "label name");
-    if (labelName.isEmpty()) {
+    if (!checkStringArg(L, __func__, 1, "label name")) {
+        return lua_error(L);
+    }
+    if (const QString labelName{lua_tostring(L, 1)}; labelName.isEmpty()) {
         return warnArgumentValue(L, __func__, "label name cannot be an empty string");
     }
-    const QString moviePath = getVerifiedString(L, __func__, 2, "movie (gif) path");
+    if (!checkStringArg(L, __func__, 2, "movie (gif) path")) {
+        return lua_error(L);
+    }
+    const QString labelName{lua_tostring(L, 1)};
+    const QString moviePath{lua_tostring(L, 2)};
 
     Host& host = getHostFromLua(L);
     if (auto [success, message] = host.setMovie(labelName, moviePath); !success) {
@@ -3203,25 +3322,25 @@ int TLuaInterpreter::setMovie(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setMovieFrame
 int TLuaInterpreter::setMovieFrame(lua_State* L)
 {
-    return movieFunc(L, qsl("setMovieFrame"));
+    return movieFunc(L, "setMovieFrame");
 }
 
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setMovieSpeed
 int TLuaInterpreter::setMovieSpeed(lua_State* L)
 {
-    return movieFunc(L, qsl("setMovieSpeed"));
+    return movieFunc(L, "setMovieSpeed");
 }
 
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setOverline
 int TLuaInterpreter::setOverline(lua_State* L)
 {
-    QString windowName;
+    const char* windowName = "";
     int s = 1;
     if (lua_gettop(L) > 1) { // Have more than one argument so first must be a console name
         windowName = WINDOW_NAME(L, s++);
     }
     const bool isAttributeEnabled = getVerifiedBool(L, __func__, s, "enable overline attribute");
-    auto console = CONSOLE(L, windowName);
+    auto console = CONSOLE(L, QString{windowName});
     console->setDisplayAttributes(TChar::Overline, isAttributeEnabled);
     lua_pushboolean(L, true);
     return 1;
@@ -3230,18 +3349,24 @@ int TLuaInterpreter::setOverline(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setPopup
 int TLuaInterpreter::setPopup(lua_State* L)
 {
-    QString windowName = qsl("main");
+    const char* windowName = "main";
     int s = 0;
     if (lua_gettop(L) > 2) {
         windowName = WINDOW_NAME(L, ++s);
     }
 
+    int commandPos = ++s;
+    int hintPos = ++s;
+    if (!checkCommandsOrFunctionsTable(L, __func__, commandPos) || !checkHintsTable(L, __func__, hintPos)) {
+        return lua_error(L);
+    }
+
     QStringList commandList;
     QVector luaReferences;
-    parseCommandsOrFunctionsTable(L, __func__, ++s, commandList, luaReferences);
+    parseCommandsOrFunctionsTable(L, __func__, commandPos, commandList, luaReferences);
 
     QStringList hintList;
-    parseHintsTable(L, __func__, ++s, hintList);
+    parseHintsTable(L, __func__, hintPos, hintList);
 
     if ((hintList.size() - commandList.size()) < 0 || (hintList.size() - commandList.size()) > 1) {
         lua_pushnil(L);
@@ -3253,7 +3378,7 @@ int TLuaInterpreter::setPopup(lua_State* L)
     }
 
     const Host& host = getHostFromLua(L);
-    auto console = CONSOLE(L, windowName);
+    auto console = CONSOLE(L, QString{windowName});
     console->setLink(commandList, hintList, luaReferences);
     if (console != host.mpConsole) {
         console->mUpperPane->forceUpdate();
@@ -3276,13 +3401,13 @@ int TLuaInterpreter::setProfileStyleSheet(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setReverse
 int TLuaInterpreter::setReverse(lua_State* L)
 {
-    QString windowName;
+    const char* windowName = "";
     int s = 1;
     if (lua_gettop(L) > 1) { // Have more than one argument so first must be a console name
         windowName = WINDOW_NAME(L, s++);
     }
     const bool isAttributeEnabled = getVerifiedBool(L, __func__, s, "enable reverse attribute");
-    auto console = CONSOLE(L, windowName);
+    auto console = CONSOLE(L, QString{windowName});
     console->setDisplayAttributes(TChar::Reverse, isAttributeEnabled);
     lua_pushboolean(L, true);
     return 1;
@@ -3291,13 +3416,13 @@ int TLuaInterpreter::setReverse(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setStrikeOut
 int TLuaInterpreter::setStrikeOut(lua_State* L)
 {
-    QString windowName;
+    const char* windowName = "";
     int s = 1;
     if (lua_gettop(L) > 1) { // Have more than one argument so first must be a console name
         windowName = WINDOW_NAME(L, s++);
     }
     const bool isAttributeEnabled = getVerifiedBool(L, __func__, s, "enable strikeout attribute");
-    auto console = CONSOLE(L, windowName);
+    auto console = CONSOLE(L, QString{windowName});
     console->setDisplayAttributes(TChar::StrikeOut, isAttributeEnabled);
     lua_pushboolean(L, true);
     return 1;
@@ -3432,13 +3557,13 @@ int TLuaInterpreter::setTextFormat(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setUnderline
 int TLuaInterpreter::setUnderline(lua_State* L)
 {
-    QString windowName;
+    const char* windowName = "";
     int s = 1;
     if (lua_gettop(L) > 1) { // Have more than one argument so first must be a console name
         windowName = WINDOW_NAME(L, s++);
     }
     const bool isAttributeEnabled = getVerifiedBool(L, __func__, s, "enable underline attribute");
-    auto console = CONSOLE(L, windowName);
+    auto console = CONSOLE(L, QString{windowName});
     console->setDisplayAttributes(TChar::Underline, isAttributeEnabled);
     lua_pushboolean(L, true);
     return 1;
@@ -3447,10 +3572,18 @@ int TLuaInterpreter::setUnderline(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setUserWindowTitle
 int TLuaInterpreter::setUserWindowTitle(lua_State* L)
 {
-    const QString name = getVerifiedString(L, __func__, 1, "name");
+    const int n = lua_gettop(L);
+    if (!checkStringArg(L, __func__, 1, "name")) {
+        return lua_error(L);
+    }
+    if (n > 1 && !checkStringArg(L, __func__, 2, "title", true)) {
+        return lua_error(L);
+    }
+
+    const QString name{lua_tostring(L, 1)};
     QString title;
-    if (lua_gettop(L) > 1) {
-        title = getVerifiedString(L, __func__, 2, "title", true);
+    if (n > 1) {
+        title = lua_tostring(L, 2);
     }
 
     const Host& host = getHostFromLua(L);
@@ -3465,8 +3598,11 @@ int TLuaInterpreter::setUserWindowTitle(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setUserWindowStyleSheet
 int TLuaInterpreter::setUserWindowStyleSheet(lua_State* L)
 {
-    const QString userWindowName = getVerifiedString(L, __func__, 1, "userwindow name");
-    const QString userWindowStyleSheet = getVerifiedString(L, __func__, 2, "StyleSheet");
+    if (!checkStringArg(L, __func__, 1, "userwindow name") || !checkStringArg(L, __func__, 2, "StyleSheet")) {
+        return lua_error(L);
+    }
+    const QString userWindowName{lua_tostring(L, 1)};
+    const QString userWindowStyleSheet{lua_tostring(L, 2)};
     const Host& host = getHostFromLua(L);
 
     if (auto [success, message] = host.mpConsole->setUserWindowStyleSheet(userWindowName, userWindowStyleSheet); !success) {
@@ -3484,13 +3620,12 @@ int TLuaInterpreter::setWindow(lua_State* L)
     int x = 0, y = 0;
     bool show = true;
 
-    const QString windowname{WINDOW_NAME(L, 1)};
+    const char* windownameArg = WINDOW_NAME(L, 1);
 
     if (lua_type(L, 2) != LUA_TSTRING) {
         lua_pushfstring(L, "setWindow: bad argument #2 type (element name as string expected, got %s!)", luaL_typename(L, 2));
         return lua_error(L);
     }
-    const QString name{lua_tostring(L, 2)};
 
     if (n > 2) {
         x = getVerifiedInt(L, __func__, 3, "x-coordinate");
@@ -3498,6 +3633,9 @@ int TLuaInterpreter::setWindow(lua_State* L)
         show = getVerifiedBool(L, __func__, 5, "show element");
     }
 
+    const QString windowname{windownameArg};
+    const QString name{lua_tostring(L, 2)};
+
     Host& host = getHostFromLua(L);
     if (auto [success, message] = host.setWindow(windowname, name, x, y, show); !success) {
         return warnArgumentValue(L, __func__, message);
@@ -3510,12 +3648,12 @@ int TLuaInterpreter::setWindow(lua_State* L)
 int TLuaInterpreter::setWindowWrap(lua_State* L)
 {
     int s = 1;
-    QString windowName;
+    const char* windowName = "";
     if (lua_gettop(L) > 1) {
         windowName = WINDOW_NAME(L, s++);
     }
     const int luaFrom = getVerifiedInt(L, __func__, s, "wrapAt");
-    auto console = CONSOLE(L, windowName);
+    auto console = CONSOLE(L, QString{windowName});
     console->setWrapAt(luaFrom);
     // only mirror values the preferences dialog itself accepts into the
     // profile, otherwise an invalid width would reach NAWS and get saved
@@ -3534,9 +3672,9 @@ int TLuaInterpreter::setWindowWrap(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setWindowWrapIndent
 int TLuaInterpreter::setWindowWrapIndent(lua_State* L)
 {
-    const QString windowName{WINDOW_NAME(L, 1)};
+    const char* windowName = WINDOW_NAME(L, 1);
     const int luaFrom = getVerifiedInt(L, __func__, 2, "wrapTo");
-    auto console = CONSOLE(L, windowName);
+    auto console = CONSOLE(L, QString{windowName});
     console->setIndentCount(luaFrom);
     if (luaFrom >= 0 && console->getType() == TConsole::MainConsole) {
         Host& host = getHostFromLua(L);
@@ -3548,9 +3686,9 @@ int TLuaInterpreter::setWindowWrapIndent(lua_State* L)
 //Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setWindowWrapHangingIndent
 int TLuaInterpreter::setWindowWrapHangingIndent(lua_State* L)
 {
-    const QString windowName{WINDOW_NAME(L, 1)};
+    const char* windowName = WINDOW_NAME(L, 1);
     const int luaFrom = getVerifiedInt(L, __func__, 2, "wrapTo");
-    auto console = CONSOLE(L, windowName);
+    auto console = CONSOLE(L, QString{windowName});
     console->setHangingIndentCount(luaFrom);
     if (luaFrom >= 0 && console->getType() == TConsole::MainConsole) {
         Host& host = getHostFromLua(L);
@@ -3571,7 +3709,7 @@ int TLuaInterpreter::showWindow(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#startMovie
 int TLuaInterpreter::startMovie(lua_State* L)
 {
-    return movieFunc(L, qsl("startMovie"));
+    return movieFunc(L, "startMovie");
 }
 
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#showToolBar
@@ -3588,7 +3726,7 @@ int TLuaInterpreter::showToolBar(lua_State* L)
 int TLuaInterpreter::setCommandBackgroundColor(lua_State* L)
 {
     Host& host = getHostFromLua(L);
-    QString windowName;
+    const char* windowNameArg = "";
     int r, alpha;
     int s = 1;
 
@@ -3597,7 +3735,7 @@ int TLuaInterpreter::setCommandBackgroundColor(lua_State* L)
     };
 
     if (lua_type(L, s) == LUA_TSTRING) {
-        windowName = WINDOW_NAME(L, s++);
+        windowNameArg = WINDOW_NAME(L, s++);
         r = getVerifiedInt(L, __func__, s, "red value 0-255");
         if (!validRange(r)) {
             return warnArgumentValue(L, __func__, csmInvalidRedValue.arg(r));
@@ -3631,6 +3769,7 @@ int TLuaInterpreter::setCommandBackgroundColor(lua_State* L)
         }
     }
 
+    const QString windowName{windowNameArg};
     if (isMain(windowName)) {
         host.mCommandBgColor.setRgb(r, g, b, alpha);
         host.mpConsole->setCommandBgColor(r, g, b, alpha);
@@ -3645,7 +3784,7 @@ int TLuaInterpreter::setCommandBackgroundColor(lua_State* L)
 int TLuaInterpreter::setCommandForegroundColor(lua_State* L)
 {
     Host& host = getHostFromLua(L);
-    QString windowName;
+    const char* windowNameArg = "";
     int r, alpha;
     int s = 1;
 
@@ -3654,7 +3793,7 @@ int TLuaInterpreter::setCommandForegroundColor(lua_State* L)
     };
 
     if (lua_type(L, s) == LUA_TSTRING) {
-        windowName = WINDOW_NAME(L, s++);
+        windowNameArg = WINDOW_NAME(L, s++);
         r = getVerifiedInt(L, __func__, s, "red value 0-255");
         if (!validRange(r)) {
             return warnArgumentValue(L, __func__, csmInvalidRedValue.arg(r));
@@ -3688,6 +3827,7 @@ int TLuaInterpreter::setCommandForegroundColor(lua_State* L)
         }
     }
 
+    const QString windowName{windowNameArg};
     if (isMain(windowName)) {
         host.mCommandFgColor.setRgb(r, g, b, alpha);
         host.mpConsole->setCommandFgColor(r, g, b, alpha);
@@ -3707,18 +3847,21 @@ int TLuaInterpreter::scrollTo(lua_State* L)
 
     const int n = lua_gettop(L);
     if (n == 2) {
-        windowName = getVerifiedString(L, __func__, 1, "window name", true);
+        if (!checkStringArg(L, __func__, 1, "window name", true)) {
+            return lua_error(L);
+        }
         targetLine = getVerifiedInt(L, __func__, 2, "line to scroll to");
+        windowName = lua_tostring(L, 1);
     } else if (n == 1) {
         if (lua_isnumber(L, 1)) {
-            windowName = QLatin1String("main");
             targetLine = getVerifiedInt(L, __func__, 1, "line to scroll to");
+            windowName = qsl("main");
         } else {
             windowName = getVerifiedString(L, __func__, 1, "window name", true);
             stopScrolling = true;
         }
     } else if (n == 0) {
-        windowName = QLatin1String("main");
+        windowName = qsl("main");
         stopScrolling = true;
     }
 
@@ -3773,12 +3916,12 @@ int TLuaInterpreter::windowType(lua_State* L)
 // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#wrapLine
 int TLuaInterpreter::wrapLine(lua_State* L)
 {
-    int s = 1;
-    QString windowName = qsl("main");
-    if (lua_gettop(L)) {
-        windowName = getVerifiedString(L, __func__, s++, "window name");
+    const bool hasWindowName = (lua_gettop(L) != 0);
+    if (hasWindowName && !checkStringArg(L, __func__, 1, "window name")) {
+        return lua_error(L);
     }
-    const int lineNumber = getVerifiedInt(L, __func__, s, "line");
+    const int lineNumber = getVerifiedInt(L, __func__, hasWindowName ? 2 : 1, "line");
+    QString windowName = hasWindowName ? QString{lua_tostring(L, 1)} : qsl("main");
 
     const Host& host = getHostFromLua(L);
     host.mpConsole->luaWrapLine(windowName, lineNumber);
@@ -3842,34 +3985,52 @@ int TLuaInterpreter::scrollingActive(lua_State* L)
 }
 
 // No documentation available in wiki - internal function
-int TLuaInterpreter::movieFunc(lua_State* L, const QString& funcName)
+// funcName is not a QString because a QByteArray made from one would still be
+// alive inside the raising checks below - see checkStringArg()
+int TLuaInterpreter::movieFunc(lua_State* L, const char* funcName)
 {
-    const QString labelName = getVerifiedString(L, funcName.toUtf8().constData(), 1, "label name");
-    if (labelName.isEmpty()) {
-        return warnArgumentValue(L, __func__, "label name cannot be an empty string");
+    if (!checkStringArg(L, funcName, 1, "label name")) {
+        return lua_error(L);
     }
-    auto pN = LABEL(L, labelName);
-    auto movie = pN->movie();
-    if (!movie) {
-        return warnArgumentValue(L, __func__, qsl("no movie found at label '%1'").arg(labelName));
+    const QLatin1StringView func{funcName};
+
+    TLabel* pN = nullptr;
+    QMovie* movie = nullptr;
+    {
+        const QString labelName{lua_tostring(L, 1)};
+        if (labelName.isEmpty()) {
+            return warnArgumentValue(L, __func__, "label name cannot be an empty string");
+        }
+        pN = LABEL(L, labelName);
+        movie = pN->movie();
+        if (!movie) {
+            return warnArgumentValue(L, __func__, qsl("no movie found at label '%1'").arg(labelName));
+        }
     }
 
-    if (funcName == qsl("startMovie")) {
+    if (func == qsl("startMovie")) {
         movie->start();
-    } else if (funcName == qsl("pauseMovie")) {
+    } else if (func == qsl("pauseMovie")) {
         movie->setPaused(true);
-    } else if (funcName == qsl("setMovieFrame")) {
-        const int frame = getVerifiedInt(L, funcName.toUtf8().constData(), 2, "movie frame number");
-        lua_pushboolean(L, movie->jumpToFrame(frame));
+    } else if (func == qsl("setMovieFrame")) {
+        if (!checkIntArg(L, funcName, 2, "movie frame number")) {
+            return lua_error(L);
+        }
+        lua_pushboolean(L, movie->jumpToFrame(static_cast(lua_tointeger(L, 2))));
         return 1;
-    } else if (funcName == qsl("setMovieSpeed")) {
-        const int speed = getVerifiedInt(L, funcName.toUtf8().constData(), 2, "movie playback speed in %");
-        movie->setSpeed(speed);
-    } else if (funcName == qsl("scaleMovie")) {
+    } else if (func == qsl("setMovieSpeed")) {
+        if (!checkIntArg(L, funcName, 2, "movie playback speed in %")) {
+            return lua_error(L);
+        }
+        movie->setSpeed(static_cast(lua_tointeger(L, 2)));
+    } else if (func == qsl("scaleMovie")) {
         bool autoScale{true};
         const int n = lua_gettop(L);
         if (n > 1) {
-            autoScale = getVerifiedBool(L, funcName.toUtf8().constData(), 2, "activate/deactivate scaling movie", true);
+            if (!checkBoolArg(L, funcName, 2, "activate/deactivate scaling movie", true)) {
+                return lua_error(L);
+            }
+            autoScale = lua_toboolean(L, 2);
         }
         movie->setScaledSize(pN->size());
         if (autoScale) {
diff --git a/src/mudlet-lua/tests/Spawn_spec.lua b/src/mudlet-lua/tests/Spawn_spec.lua
new file mode 100644
index 000000000..684e7871f
--- /dev/null
+++ b/src/mudlet-lua/tests/Spawn_spec.lua
@@ -0,0 +1,70 @@
+-- Every spawn() error path longjmps out of C++ code that owns heap: the
+-- program name, the accumulated argument list and the failure message. These
+-- drive each path so LeakSanitizer fails the build if one starts stranding
+-- again, and pin the messages while doing it.
+--
+-- Only the failing paths are exercised - a successful spawn would leave a real
+-- child process behind for the rest of the suite.
+
+describe("spawn", function()
+
+  describe("argument checking", function()
+
+    it("should reject a call with no process name", function()
+      local ok, err = pcall(spawn, function() end)
+      assert.is_false(ok)
+      assert.are.equal("Need read function and process name as parameters.", err)
+    end)
+
+    it("should reject a first argument that is not a function", function()
+      local ok, err = pcall(spawn, "not a function", "echo")
+      assert.is_false(ok)
+      assert.are.equal("Need read function as first parameter.", err)
+    end)
+
+    it("should reject a non-string process name", function()
+      local ok, err = pcall(spawn, function() end, {})
+      assert.is_false(ok)
+      assert.is_truthy(tostring(err):find("bad argument #2", 1, true))
+      assert.is_truthy(tostring(err):find("string expected, got table", 1, true))
+    end)
+
+    -- the process name is already built and held when a later argument is
+    -- rejected, and every argument before the bad one is in the list too
+    it("should reject a non-string argument after valid ones", function()
+      local ok, err = pcall(spawn, function() end, "echo", "first", "second", {})
+      assert.is_false(ok)
+      assert.is_truthy(tostring(err):find("bad argument #5", 1, true))
+      assert.is_truthy(tostring(err):find("string expected, got table", 1, true))
+    end)
+
+    it("should accept numbers where strings are expected, as Lua does", function()
+      -- coercible, so this gets past argument checking and fails on the binary
+      local ok, err = pcall(spawn, function() end, "/nonexistent/mudlet-spawn-test", 42)
+      assert.is_false(ok)
+      assert.is_truthy(tostring(err):find("Failed to start process", 1, true))
+    end)
+
+  end)
+
+  describe("start failure", function()
+
+    -- the failure message embeds the program name, working directory and PATH,
+    -- so it is the largest thing this function ever holds at a raise
+    it("should report a binary that does not exist", function()
+      local ok, err = pcall(spawn, function() end, "/nonexistent/mudlet-spawn-test")
+      assert.is_false(ok)
+      assert.is_truthy(tostring(err):find("Failed to start process '/nonexistent/mudlet-spawn-test'", 1, true))
+      assert.is_truthy(tostring(err):find("Working directory:", 1, true))
+      assert.is_truthy(tostring(err):find("PATH:", 1, true))
+    end)
+
+    it("should report a binary that does not exist when given arguments too", function()
+      local ok, err = pcall(spawn, function() end, "/nonexistent/mudlet-spawn-test", "one", "two", "three")
+      assert.is_false(ok)
+      assert.is_truthy(tostring(err):find("Failed to start process", 1, true))
+    end)
+
+  end)
+
+end)

From 6c991a1708b00986284450c530523d16f309810d Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Mon, 3 Aug 2026 11:40:11 +0200
Subject: [PATCH 062/155] infrastructure: make windows safe to destroy while a
 field has the text cursor (#9596)

#### Brief overview of PR changes/additions
- New `utils::disconnectChildSignals()`, called by the destructors of
the connection dialog, the preferences and the editor: a window stops
listening to its own widgets before it goes away.
- Covers the reported case (connection dialog `Profile name` field) plus
the same exposure found in the preferences (MMCP chat name, shortcut
editors) and the editor (item name, command, pattern and sound file
fields). The preferences and the editor had no destructor at all before
this.
- New `DialogTeardownTest` covering all three windows, plus a canary
that fails if a future Qt stops emitting the focus-out signals the whole
thing rests on.

#### Motivation for adding to Mudlet
Destroying one of these windows while the text cursor sits in one of its
fields aborts the run - which is how #9574 turned up, in a functional
test - and the windows should simply be safe to destroy, rather than
safe only along the `close()` paths that happen to hide them first.

#### Other info (issues closed, discussion etc)
Closes #9574.

The mechanism: a visible window is taken off the screen while its
base-class destructors unwind (`~QDialog` hides it, `~QWidget` closes
any other window class). That moves the keyboard focus off the field
holding it, the field reports `editingFinished()`, and Qt delivers that
to a slot of an object whose derived part is already gone:

```
ASSERT failure in dlgConnectionProfiles: "Called object is not of the correct type (class destructor may have already run)"
```

**How much of this can a player hit today: as far as I can trace, none
of it**, which is why there are no crash reports behind this:

- Every production teardown goes through `close()` / `accept()` /
`reject()` first, and that hide happens while the object is still whole
- so the field's `editingFinished()` is delivered normally and the edit
is saved, exactly as before. `Host::closeChildren()` closes the editor
that way, `mudlet::closeEvent()` closes the connection dialog that way.
- Nothing `delete`s or `deleteLater()`s these three windows directly.
- At exit `main()` deletes the QApplication, which destroys platform
windows without running widget destructors, so the preferences dialog -
the one window nothing explicitly closes - is never destructed either.
- The assert is a `Q_ASSERT_X`, and since we never set
`CMAKE_BUILD_TYPE`, Qt defines `QT_NO_DEBUG` for our builds and compiles
it out. A shipped build would not abort at that point; it would run the
slot against destroyed members instead, which is undefined behaviour
that can quietly rename a profile or a trigger.

So this is a latent trap rather than a live player crash: it fires today
in the test suite, and it fires the moment any future code destroys one
of these windows while it is on screen. The fix is small enough to be
worth taking on those terms.

Verified with standalone Qt probes: `QLineEdit` emits once anything has
written to it (`setText()` is enough, even with an empty string),
`QAbstractSpinBox` and `QKeySequenceEdit` emit unconditionally, and
plain child widgets such as the editor's `dlg*MainArea` panels are not
exposed - their slots still run while they are alive.

`test/functional_tests/DialogTeardownTest.cpp` is formatted with the
repo's clang-format, which the older tests next to it predate.

**Test case:** `ctest -R DialogTeardownTest`. All three cases abort on
`development` with the assert above and pass here. There is no manual
GUI reproduction - see the tracing above.
---
 src/dlgConnectionProfiles.cpp                |   6 +
 src/dlgProfilePreferences.cpp                |  10 +
 src/dlgProfilePreferences.h                  |   1 +
 src/dlgTriggerEditor.cpp                     |   9 +
 src/dlgTriggerEditor.h                       |   1 +
 src/utils.h                                  |  29 ++
 test/functional_tests/CMakeLists.txt         |   1 +
 test/functional_tests/DialogTeardownTest.cpp | 297 +++++++++++++++++++
 8 files changed, 354 insertions(+)
 create mode 100644 test/functional_tests/DialogTeardownTest.cpp

diff --git a/src/dlgConnectionProfiles.cpp b/src/dlgConnectionProfiles.cpp
index 4a35b10c9..19cf3d2ce 100644
--- a/src/dlgConnectionProfiles.cpp
+++ b/src/dlgConnectionProfiles.cpp
@@ -34,6 +34,7 @@
 #include "mudlet.h"
 #include "CredentialManager.h"
 #include "SecureStringUtils.h"
+#include "utils.h"
 
 #include 
 #include 
@@ -356,6 +357,11 @@ dlgConnectionProfiles::dlgConnectionProfiles(QWidget* parent)
 
 dlgConnectionProfiles::~dlgConnectionProfiles()
 {
+    // ~QDialog hides the dialog once this destructor is done, and the profile
+    // name field reacts to losing the focus by emitting editingFinished() into
+    // slot_saveName() when this object is no longer a valid receiver (#9574)
+    utils::disconnectChildSignals(this);
+
     if (mPasswordSaveTimer) {
         mPasswordSaveTimer->stop();
     }
diff --git a/src/dlgProfilePreferences.cpp b/src/dlgProfilePreferences.cpp
index 9a6d9e278..e3910ae89 100644
--- a/src/dlgProfilePreferences.cpp
+++ b/src/dlgProfilePreferences.cpp
@@ -47,6 +47,7 @@
 #include "dlgTriggerEditor.h"
 #include "edbee/views/texteditorscrollarea.h"
 #include "MMCP.h"
+#include "utils.h"
 
 #include 
 #include 
@@ -379,6 +380,15 @@ dlgProfilePreferences::dlgProfilePreferences(QWidget* pParentWidget, Host* pHost
     setupPasswordsMigration();
 }
 
+dlgProfilePreferences::~dlgProfilePreferences()
+{
+    // ~QDialog hides the dialog once this destructor is done, and the widget
+    // that has the keyboard focus then emits its editingFinished() - the chat
+    // name field and the shortcut editors both act on that one - when this
+    // object is no longer a valid receiver (#9574)
+    utils::disconnectChildSignals(this);
+}
+
 void dlgProfilePreferences::setupPasswordsMigration()
 {
     hidePasswordMigrationLabelTimer = std::make_unique(this);
diff --git a/src/dlgProfilePreferences.h b/src/dlgProfilePreferences.h
index 5236e1dab..3420f2597 100644
--- a/src/dlgProfilePreferences.h
+++ b/src/dlgProfilePreferences.h
@@ -48,6 +48,7 @@ class dlgProfilePreferences : public QDialog, public Ui::profile_preferences
 public:
     Q_DISABLE_COPY(dlgProfilePreferences)
     explicit dlgProfilePreferences(QWidget*, Host* pHost = nullptr);
+    ~dlgProfilePreferences();
     void setTab(QString tab);
 
 public slots:
diff --git a/src/dlgTriggerEditor.cpp b/src/dlgTriggerEditor.cpp
index b9a5ca924..166dcdbba 100644
--- a/src/dlgTriggerEditor.cpp
+++ b/src/dlgTriggerEditor.cpp
@@ -1414,6 +1414,15 @@ dlgTriggerEditor::dlgTriggerEditor(Host* pH)
     }
 }
 
+dlgTriggerEditor::~dlgTriggerEditor()
+{
+    // ~QWidget closes the editor once this destructor is done, and whichever
+    // of the item fields has the keyboard focus then emits editingFinished()
+    // into one of the slot_saveProperty_...() slots when this object is no
+    // longer a valid receiver (#9574)
+    utils::disconnectChildSignals(this);
+}
+
 void dlgTriggerEditor::slot_searchSplitterMoved(const int pos, const int index)
 {
     Q_UNUSED(pos)
diff --git a/src/dlgTriggerEditor.h b/src/dlgTriggerEditor.h
index 4291b0df4..50da1bc1a 100644
--- a/src/dlgTriggerEditor.h
+++ b/src/dlgTriggerEditor.h
@@ -173,6 +173,7 @@ public:
 
     Q_DISABLE_COPY(dlgTriggerEditor)
     dlgTriggerEditor(Host*);
+    ~dlgTriggerEditor();
 
     Q_DECLARE_FLAGS(SearchOptions, SearchOption)
 
diff --git a/src/utils.h b/src/utils.h
index 8157326b2..6105e0df2 100644
--- a/src/utils.h
+++ b/src/utils.h
@@ -79,6 +79,35 @@ public:
     // qsl all over the place:
     static QString richText(const QString& text) { return qsl("
%1
").arg(text); }
 
+    // Call this in the destructor of a window class that connects any of its
+    // own widgets to its own slots - keep it first, so that nothing else the
+    // destructor does can deliver a child's signal either.
+    //
+    // A visible window is taken off the screen while the base-class
+    // destructors unwind: ~QDialog hides it explicitly, and any other window
+    // class gets closed by ~QWidget. That moves the keyboard focus away from
+    // whichever child widget holds it, and an editing widget reacts to the
+    // focus-out by emitting - QLineEdit (once its text has been touched, which
+    // includes any setText()), QAbstractSpinBox and QKeySequenceEdit all emit
+    // editingFinished() there. Qt then tries to deliver that to a slot of a
+    // window whose derived part has already been destroyed, which aborts with
+    // "Called object is not of the correct type (class destructor may have
+    // already run)" (#9574). In a release build the assert is compiled out and
+    // the slot runs against destroyed members instead.
+    //
+    // A window that is being destroyed cannot do anything useful with a
+    // signal from its own widgets, so every one of them is severed rather
+    // than just the widget types that emit during teardown today. Note that
+    // this only reaches connections whose receiver is the window: a
+    // connect(child, &Signal, [this]{...}) written without a context object
+    // survives it and brings the crash back, so always pass the context:
+    static void disconnectChildSignals(QWidget* window)
+    {
+        for (QObject* child : window->findChildren()) {
+            QObject::disconnect(child, nullptr, window, nullptr);
+        }
+    }
+
     // Qt 6.9 deprecated QDateTime::setOffsetFromUtc(int) and made it hard to
     // replicate the exact strings that we had before:
     static QString dateStamp() {
diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt
index 374c46930..43db39dd2 100644
--- a/test/functional_tests/CMakeLists.txt
+++ b/test/functional_tests/CMakeLists.txt
@@ -35,6 +35,7 @@ set(FUNCTIONAL_TEST_SOURCES
     UndoServerWrapTest.cpp
     HostWidgetDecouplingTest.cpp
     ActionSelfUninstallTest.cpp
+    DialogTeardownTest.cpp
     TMediaLoopTest.cpp
 )
 
diff --git a/test/functional_tests/DialogTeardownTest.cpp b/test/functional_tests/DialogTeardownTest.cpp
new file mode 100644
index 000000000..1c7f652eb
--- /dev/null
+++ b/test/functional_tests/DialogTeardownTest.cpp
@@ -0,0 +1,297 @@
+/***************************************************************************
+ *   Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org    *
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the GNU General Public License as published by  *
+ *   the Free Software Foundation; either version 2 of the License, or     *
+ *   (at your option) any later version.                                   *
+ *                                                                         *
+ *   This program is distributed in the hope that it will be useful,       *
+ *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
+ *   GNU General Public License for more details.                          *
+ *                                                                         *
+ *   You should have received a copy of the GNU General Public License     *
+ *   along with this program; if not, write to the                         *
+ *   Free Software Foundation, Inc.,                                       *
+ *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
+ ***************************************************************************/
+
+/*
+ * Functional tests for windows that are destroyed while one of their own
+ * editing widgets still has the keyboard focus (#9574).
+ *
+ * A visible window is taken off the screen while its base-class destructors
+ * unwind (~QDialog hides it, ~QWidget closes any other window class), which
+ * moves the focus off the widget that holds it; a QLineEdit (QAbstractSpinBox
+ * and QKeySequenceEdit behave the same) answers that by emitting
+ * editingFinished() into a slot of a window whose derived part has already
+ * been destroyed.
+ *
+ * A debug build ends the whole run there, on Qt's "Called object is not of the
+ * correct type (class destructor may have already run)". A release build has
+ * that assert compiled out and runs the slot against the destroyed object
+ * instead, so each test also checks that the edit in the focused field was not
+ * acted on - the same assertion holds whichever way the build was configured.
+ *
+ * Run with: ctest -R DialogTeardownTest -V
+ */
+
+#include 
+#include 
+
+#include 
+#include 
+
+#include "Host.h"
+#include "MudletInstanceCoordinator.h"
+#include "TelnetServerStub.h"
+#include "TriggerUnit.h"
+#include "dlgConnectionProfiles.h"
+#include "dlgProfilePreferences.h"
+#include "dlgTriggerEditor.h"
+#include "mudlet.h"
+
+using namespace std::chrono_literals;
+
+extern void qInitResources_mudlet();
+extern void qInitResources_qm();
+extern void qInitResources_additional_splash_screens();
+extern void qInitResources_mudlet_fonts_common();
+extern void qInitResources_mudlet_fonts_posix();
+void initializeQRCResourcesForDialogTeardownTest();
+
+class DialogTeardownTest : public QObject
+{
+    Q_OBJECT
+
+private:
+    TelnetServerStub* mpServer = nullptr;
+    Host* mpHost = nullptr;
+    const QString mProfileName = qsl("DialogTeardown-Test");
+    QString mPort; // assigned the stub's actual ephemeral port in initTestCase()
+    const QString mLocalhost = qsl("localhost");
+
+    void deleteProfileDirectory(const QString& profileName)
+    {
+        const QString path = mudlet::getMudletPath(enums::profileHomePath, profileName);
+        QDir dir(path);
+        if (dir.exists()) {
+            dir.removeRecursively();
+        }
+    }
+
+    void startProfile(const QString& profileName, const QString& address, const QString& port)
+    {
+        QTimer::singleShot(0ms, qApp, [profileName, address, port]() {
+            mudlet::self()->startAutoLogin({});
+            QTest::qWait(100ms);
+            QTest::mouseClick(mudlet::self()->mpConnectionDialog->new_profile_button, Qt::LeftButton);
+            QTest::qWait(100ms);
+            QTest::keyClicks(QApplication::focusWidget(), profileName);
+            QTest::qWait(100ms);
+            QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab);
+            QTest::qWait(100ms);
+            QTest::keyClicks(QApplication::focusWidget(), address);
+            QTest::qWait(100ms);
+            QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab);
+            QTest::qWait(100ms);
+            QTest::keyClicks(QApplication::focusWidget(), port);
+            QTest::qWait(100ms);
+            QTest::keyClick(QApplication::focusWidget(), Qt::Key_Return);
+        });
+
+        QSignalSpy spy(mudlet::self(), &mudlet::signal_profileLoaded);
+        if (!spy.wait(5000)) {
+            QFAIL("Profile took too long to load.");
+        }
+
+        mpHost = mudlet::self()->getActiveHost();
+        if (!mpHost) {
+            QFAIL("No active host available for the test.");
+        }
+    }
+
+    // Gives the widget the keyboard focus and something to report: a QLineEdit
+    // only emits editingFinished() on focus-out once its text has been touched,
+    // and the setText() here is what arms that - a field nothing has written to
+    // stays quiet and would make this test prove nothing.
+    void focusWithText(QLineEdit* lineEdit, const QString& text)
+    {
+        QVERIFY2(lineEdit->isVisible(), "Field has to be on screen to be able to take the focus");
+        lineEdit->setText(text);
+        lineEdit->setFocus();
+        QCoreApplication::processEvents();
+        QCOMPARE(QApplication::focusWidget(), lineEdit);
+    }
+
+private slots:
+    void initTestCase()
+    {
+        initializeQRCResourcesForDialogTeardownTest();
+
+        mpServer = new TelnetServerStub(qApp);
+        mpServer->start(mLocalhost, 0); // ephemeral OS-assigned port avoids collisions across concurrent test runs
+        mPort = QString::number(mpServer->serverPort());
+        mudlet::start();
+        mudlet::self()->setupConfig();
+        mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique(qsl("MudletInstanceCoordinator")));
+        mudlet::self()->init();
+        mudlet::self()->setStorePasswordsSecurely(false);
+        deleteProfileDirectory(mProfileName);
+
+        startProfile(mProfileName, mLocalhost, mPort);
+        QVERIFY2(mpHost, "No active host after profile creation");
+    }
+
+    void cleanupTestCase()
+    {
+        mpHost = nullptr;
+        delete mpServer;
+        mpServer = nullptr;
+        deleteProfileDirectory(mProfileName);
+        delete mudlet::self();
+    }
+
+    // Everything below rests on Qt still emitting the focus-out signals while a
+    // window is being destroyed. If a future Qt stops doing that the other tests
+    // would keep passing while testing nothing, so pin the mechanism itself on
+    // widgets of our own - the receiver here outlives them, which is exactly what
+    // the windows under test cannot manage.
+    void test_teardownEmitsTheSignalsThisIsAllAbout()
+    {
+        auto* dialog = new QDialog(mudlet::self());
+        auto* layout = new QVBoxLayout(dialog);
+        auto* lineEdit = new QLineEdit(dialog);
+        layout->addWidget(lineEdit);
+        dialog->show();
+        lineEdit->setText(qsl("some text"));
+        lineEdit->setFocus();
+        QCoreApplication::processEvents();
+        QCOMPARE(QApplication::focusWidget(), lineEdit);
+
+        QSignalSpy lineEditSpy(lineEdit, &QLineEdit::editingFinished);
+        delete dialog;
+
+        QVERIFY2(lineEditSpy.count() == 1,
+                 "A focused QLineEdit no longer reports editingFinished() when its "
+                 "window is destroyed - the rest of this file now proves nothing");
+
+        // the same for the shortcut editors the preferences are full of
+        auto* keySequenceDialog = new QDialog(mudlet::self());
+        auto* keySequenceLayout = new QVBoxLayout(keySequenceDialog);
+        auto* secondKeySequenceEdit = new QKeySequenceEdit(keySequenceDialog);
+        keySequenceLayout->addWidget(secondKeySequenceEdit);
+        keySequenceDialog->show();
+        secondKeySequenceEdit->setKeySequence(QKeySequence(qsl("Ctrl+K")));
+        secondKeySequenceEdit->setFocus();
+        QCoreApplication::processEvents();
+        // it focus-proxies to an inner line edit, so ask the wrapper itself
+        QVERIFY2(secondKeySequenceEdit->hasFocus(), "Shortcut editor did not take the focus");
+
+        QSignalSpy secondSpy(secondKeySequenceEdit, &QKeySequenceEdit::editingFinished);
+        delete keySequenceDialog;
+        QVERIFY2(secondSpy.count() == 1,
+                 "A focused QKeySequenceEdit no longer reports editingFinished() "
+                 "when its window is destroyed");
+    }
+
+    // #9574: the reported crash - the profile name field is connected to
+    // slot_saveName() and the dialog is torn down while that field has the focus
+    void test_connectionDialogDestroyedWithFocusedNameField()
+    {
+        // built directly rather than through mudlet::slot_showConnectionDialog()
+        // so that the profile this test suite loaded does not have the dialog
+        // connect it straight back and close it
+        QPointer dialog = new dlgConnectionProfiles(mudlet::self());
+        dialog->fillout_form();
+        dialog->show();
+        QTest::qWait(100ms);
+        QVERIFY2(dialog, "Connection dialog closed itself");
+
+        // pick our own profile, so that the name field is editing something whose
+        // renaming can be checked for afterwards
+        const auto items = dialog->findData(*dialog->listWidget_profiles, mProfileName, dlgConnectionProfiles::csmNameRole);
+        QVERIFY2(!items.isEmpty(), "Test profile is not listed in the dialog");
+        dialog->listWidget_profiles->setCurrentItem(items.first());
+        QTest::qWait(100ms);
+
+        const QString renamedTo = qsl("DialogTeardown-Renamed");
+        focusWithText(dialog->profile_name_entry, renamedTo);
+
+        delete dialog;
+        QVERIFY2(dialog.isNull(), "Connection dialog should have been destroyed");
+        // slot_saveName() renames the profile's directory, so it running on the way
+        // down leaves a trace even in a build where the assert is compiled out
+        QVERIFY2(!QDir(mudlet::getMudletPath(enums::profileHomePath, renamedTo)).exists(), "Being destroyed made the dialog rename the profile");
+        QVERIFY2(QDir(mudlet::getMudletPath(enums::profileHomePath, mProfileName)).exists(), "The profile lost its directory while the dialog was destroyed");
+    }
+
+    // The same exposure through the preferences' chat name field, which is
+    // connected to slot_mmcpChatNameChanged()
+    void test_preferencesDestroyedWithFocusedChatNameField()
+    {
+        mudlet::self()->showOptionsDialog(qsl("tab_chat"), mpHost);
+        QTest::qWait(100ms);
+        auto* preferences = mpHost->mpDlgProfilePreferences.data();
+        QVERIFY2(preferences, "Preferences dialog was not created");
+
+        const QString chatNameBefore = mpHost->getMMCPChatName();
+        const QString typedChatName = qsl("DialogTeardownChatName");
+        QVERIFY2(chatNameBefore != typedChatName, "Test needs to type a chat name that is not the current one");
+        focusWithText(preferences->lineEdit_mmcpChatName, typedChatName);
+
+        delete preferences;
+        QVERIFY2(mpHost->mpDlgProfilePreferences.isNull(), "Preferences dialog should have been destroyed");
+        QCOMPARE(mpHost->getMMCPChatName(), chatNameBefore);
+    }
+
+    // ...and through the editor, where the item name field is connected to
+    // slot_saveProperty_TriggerName(). The editor is a QMainWindow rather than a
+    // QDialog, which makes no difference: it hides itself on the way down too
+    void test_triggerEditorDestroyedWithFocusedNameField()
+    {
+        mudlet::self()->slot_showScriptDialog();
+        QTest::qWait(100ms);
+        auto* editor = mpHost->mpEditorDialog.data();
+        QVERIFY2(editor, "Editor was not created");
+
+        // the item fields only appear once an item is being edited
+        editor->slot_showTriggers();
+        editor->slot_addNewItem();
+        QTest::qWait(100ms);
+
+        auto* nameField = editor->findChild(qsl("lineEdit_trigger_name"));
+        QVERIFY2(nameField, "Trigger name field not found in the editor");
+        const QString nameBefore = nameField->text();
+        QVERIFY2(mpHost->getTriggerUnit()->findTrigger(nameBefore), "The new trigger is not registered under the name in the field");
+
+        const QString typedName = qsl("DialogTeardown trigger");
+        focusWithText(nameField, typedName);
+
+        delete editor;
+        QVERIFY2(mpHost->mpEditorDialog.isNull(), "Editor should have been destroyed");
+        // slot_saveProperty_TriggerName() renames the trigger itself, so the item
+        // shows whether it ran while the editor was being destroyed
+        QVERIFY2(!mpHost->getTriggerUnit()->findTrigger(typedName), "Being destroyed made the editor rename the trigger");
+        QVERIFY2(mpHost->getTriggerUnit()->findTrigger(nameBefore), "The trigger lost its name while the editor was destroyed");
+    }
+};
+
+void initializeQRCResourcesForDialogTeardownTest()
+{
+#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN
+    qInitResources_additional_splash_screens();
+#endif
+#ifdef INCLUDE_FONTS
+    qInitResources_mudlet_fonts_common();
+#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD)
+    qInitResources_mudlet_fonts_posix();
+#endif
+#endif
+    qInitResources_mudlet();
+    qInitResources_qm();
+}
+
+#include "DialogTeardownTest.moc"
+QTEST_MAIN(DialogTeardownTest)

From 9634c394b8bc7d5c7ab2d2840ffb897eedc53c05 Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Mon, 3 Aug 2026 12:30:14 +0200
Subject: [PATCH 063/155] fix: Windows auto-update failing on a release binary
 with no checksum (#9617)

#### Brief overview of PR changes/additions

- Never publish a release binary without a matching `SHA256SUMS.txt`
entry: merge over the already-published file instead of overwriting it,
set aside assets belonging to a different build than the release tag,
and gate the upload on every binary having an entry that matches its
bytes.
- Say which check failed in the updater - missing checksums,
undownloadable checksums, no entry for this platform, unreadable
checksum file - instead of one message for all of them.
- Add `UpdaterChecksumTest` and `ReleaseChecksumsTest`; both fail if the
fix is reverted.

#### Motivation for adding to Mudlet

Windows auto-update failed with "Could not verify the integrity of the
download", so PTB users could not update at all.
`create-github-release.yml` runs once per platform build workflow and
uploads with `--clobber`, so the 2026-08-02 run regenerated
`SHA256SUMS.txt` from its own subset of sidecars and overwrote the
complete file while the earlier `.exe` stayed published. The updater was
right to refuse it.

#### Other info (issues closed, discussion etc)

Test case: `ctest -R 'UpdaterChecksumTest|ReleaseChecksumsTest'`.

Verified on a Windows 11 VM against a scratch release reproducing the
exact layout: before, the Download Error dialog; after replacing only
`SHA256SUMS.txt` with what the new script produces, the installer
downloaded, verified and staged.

`requireChecksums` is unchanged - nothing accepts an unverified download
that did not before.

Not fixed here: PTBs ship Windows-only when the scheduled Linux/macOS
build is still queued, which is why the 2026-08-03 PTB has one asset.

Assisted-by: Claude:claude-opus-5
---
 .github/workflows/create-github-release.yml | 151 +++++---
 CI/assemble-release-checksums.sh            | 127 ++++++
 CI/prepare-release-assets.sh                | 105 +++++
 CI/verify-release-checksums.sh              | 113 ++++++
 src/updater/Feed.cpp                        |  95 +++--
 src/updater/Feed.h                          |   7 +
 test/CMakeLists.txt                         |  25 +-
 test/UpdaterChecksumTest.cpp                | 230 +++++++++++
 test/ci/release-checksums-test.sh           | 406 ++++++++++++++++++++
 9 files changed, 1183 insertions(+), 76 deletions(-)
 create mode 100755 CI/assemble-release-checksums.sh
 create mode 100755 CI/prepare-release-assets.sh
 create mode 100755 CI/verify-release-checksums.sh
 create mode 100644 test/UpdaterChecksumTest.cpp
 create mode 100755 test/ci/release-checksums-test.sh

diff --git a/.github/workflows/create-github-release.yml b/.github/workflows/create-github-release.yml
index a607f1972..e6a7046b2 100644
--- a/.github/workflows/create-github-release.yml
+++ b/.github/workflows/create-github-release.yml
@@ -80,6 +80,16 @@ jobs:
           ref: ${{ github.event.workflow_run.head_sha }}
           fetch-depth: 0
 
+      # workflow_run always runs this file from the default branch, while the
+      # checkout above is the commit that was built - which may predate the release
+      # scripts below. Take them from the same ref as this workflow file.
+      - uses: actions/checkout@v7
+        if: steps.check.outputs.ready == 'true'
+        with:
+          ref: ${{ github.workflow_sha }}
+          path: release-scripts
+          fetch-depth: 1
+
       - uses: leafo/gh-actions-lua@v13
         if: steps.check.outputs.ready == 'true'
         with:
@@ -191,55 +201,57 @@ jobs:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           path: assets/
 
-      - name: Verify release assets
+      # A download that fails leaves the release short of a platform, so surface it
+      # rather than letting continue-on-error hide it
+      - name: Report asset download failures
         if: steps.release-type.outputs.type == 'release' || steps.release-type.outputs.type == 'ptb'
         env:
-          RELEASE_TYPE: ${{ steps.release-type.outputs.type }}
+          LINUX_MACOS_OUTCOME: ${{ steps.download-linux-macos.outcome }}
+          WINDOWS_OUTCOME: ${{ steps.download-windows.outcome }}
         run: |
-          mkdir -p assets/
-          echo "Downloaded assets:"
-          find assets/ -type f | sort
-
-          MISSING=()
-          if ! find assets/ -name '*.AppImage.tar' -type f | grep -q .; then
-            MISSING+=("Linux (.AppImage.tar)")
+          if [[ "${LINUX_MACOS_OUTCOME}" == "failure" ]]; then
+            echo "::warning::Downloading the Linux/macOS release assets failed - they will be missing from this release"
           fi
-          if ! find assets/ -name '*.dmg' -type f | grep -q .; then
-            MISSING+=("macOS (.dmg)")
-          fi
-          if ! find assets/ -name '*.exe' -type f | grep -q .; then
-            MISSING+=("Windows (.exe)")
+          if [[ "${WINDOWS_OUTCOME}" == "failure" ]]; then
+            echo "::warning::Downloading the Windows release assets failed - it will be missing from this release"
           fi
 
-          if [[ ${#MISSING[@]} -gt 0 ]]; then
-            echo "::warning::Missing release assets for: ${MISSING[*]}"
-          fi
+      - name: Prepare release assets
+        if: steps.release-type.outputs.type == 'release' || steps.release-type.outputs.type == 'ptb'
+        env:
+          RELEASE_TAG: ${{ steps.release-type.outputs.tag }}
+          RELEASE_TYPE: ${{ steps.release-type.outputs.type }}
+        run: bash release-scripts/CI/prepare-release-assets.sh assets/ "${RELEASE_TAG}" "${RELEASE_TYPE}"
 
-          # Stable releases must have all platforms; PTB tolerates partial
-          if [[ "${RELEASE_TYPE}" == "release" && ${#MISSING[@]} -gt 0 ]]; then
-            echo "::error::Stable release is missing assets for: ${MISSING[*]}"
+      # The release may already carry assets from the other build workflow's run of
+      # this job, so its SHA256SUMS.txt has to be merged rather than overwritten
+      - name: Fetch published SHA256SUMS.txt
+        if: steps.release-type.outputs.type == 'release' || steps.release-type.outputs.type == 'ptb'
+        env:
+          RELEASE_TAG: ${{ steps.release-type.outputs.tag }}
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          mkdir -p published/
+          if ! gh release view "${RELEASE_TAG}" 2> view-error.txt; then
+            if grep -qi 'release not found' view-error.txt; then
+              echo "Release ${RELEASE_TAG} does not exist yet - no checksums to merge"
+              exit 0
+            fi
+            cat view-error.txt
+            echo "::error::Could not read release ${RELEASE_TAG} - refusing to rebuild its checksums from a partial view"
             exit 1
           fi
-
-          if [[ ${#MISSING[@]} -eq 3 ]]; then
-            echo "::error::No release assets found for any platform"
-            exit 1
+          if gh release download "${RELEASE_TAG}" --pattern SHA256SUMS.txt --dir published/; then
+            echo "Already published on ${RELEASE_TAG}:"
+            cat published/SHA256SUMS.txt
+          else
+            echo "::warning::${RELEASE_TAG} exists but its SHA256SUMS.txt could not be downloaded - any entry only it covers will be lost"
           fi
 
       # Assemble SHA256SUMS.txt from per-platform .sha256 sidecar files
       - name: Assemble SHA256SUMS.txt
         if: steps.release-type.outputs.type == 'release' || steps.release-type.outputs.type == 'ptb'
-        run: |
-          mapfile -t SHA_FILES < <(find assets/ -name '*.sha256' -type f)
-
-          if [[ ${#SHA_FILES[@]} -eq 0 ]]; then
-            echo "::error::No .sha256 checksum files found in assets/"
-            exit 1
-          fi
-
-          cat "${SHA_FILES[@]}" > assets/SHA256SUMS.txt
-          echo "Generated SHA256SUMS.txt (${#SHA_FILES[@]} entries):"
-          cat assets/SHA256SUMS.txt
+        run: bash release-scripts/CI/assemble-release-checksums.sh assets/ published/SHA256SUMS.txt
 
       - name: Generate changelog
         if: steps.release-type.outputs.type == 'release' || steps.release-type.outputs.type == 'ptb'
@@ -352,21 +364,43 @@ jobs:
           TARGET_SHA: ${{ github.event.workflow_run.head_sha }}
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
-          # Collect release files and combined checksums (exclude per-platform .sha256 sidecars)
-          mapfile -t FILES < <(find assets/ -type f \
-            \( -name '*.AppImage.tar' -o -name '*.exe' -o -name '*.dmg' -o -name 'SHA256SUMS.txt' \))
+          # Everything in assets/ except the per-platform sidecars, which only feed
+          # SHA256SUMS.txt. Not a list of binary suffixes: a new asset type must not
+          # be able to reach the release without the checksum gate below seeing it.
+          mapfile -t BINARIES < <(find assets/ -type f ! -name '*.sha256' ! -name 'SHA256SUMS.txt')
 
-          if [[ ${#FILES[@]} -eq 0 ]]; then
+          if [[ ${#BINARIES[@]} -eq 0 ]]; then
             echo "::error::No release files found to upload"
             exit 1
           fi
 
           echo "Files to upload:"
-          printf '%s\n' "${FILES[@]}"
+          printf '%s\n' assets/SHA256SUMS.txt "${BINARIES[@]}"
 
-          if gh release view "${RELEASE_TAG}" &>/dev/null; then
+          # Guard against publishing a binary SHA256SUMS.txt does not cover: the
+          # release ends up holding what is already on it plus what we upload now
+          : > final-assets.txt
+          if gh release view "${RELEASE_TAG}" --json assets --jq '.assets[].name' >> final-assets.txt 2> view-error.txt; then
+            RELEASE_EXISTS=yes
+          elif grep -qi 'release not found' view-error.txt; then
+            RELEASE_EXISTS=no
+          else
+            cat view-error.txt
+            echo "::error::Could not list the assets already published on ${RELEASE_TAG} - refusing to publish without checking checksum coverage"
+            exit 1
+          fi
+          basename -a -- "${BINARIES[@]}" >> final-assets.txt
+
+          echo "Assets the release will hold afterwards:"
+          sort -u final-assets.txt
+          bash release-scripts/CI/verify-release-checksums.sh assets/SHA256SUMS.txt final-assets.txt assets/
+
+          # SHA256SUMS.txt first: it is a superset of the old and new binaries, so if
+          # the upload dies partway the release is never left holding an uncovered one
+          if [[ "${RELEASE_EXISTS}" == "yes" ]]; then
             echo "Release ${RELEASE_TAG} already exists - uploading any missing assets"
-            gh release upload "${RELEASE_TAG}" "${FILES[@]}" --clobber
+            gh release upload "${RELEASE_TAG}" assets/SHA256SUMS.txt --clobber
+            gh release upload "${RELEASE_TAG}" "${BINARIES[@]}" --clobber
           else
             ARGS=(
               "${RELEASE_TAG}"
@@ -378,10 +412,39 @@ jobs:
               ARGS+=(--prerelease --target "${TARGET_SHA}")
             fi
 
-            gh release create "${ARGS[@]}" "${FILES[@]}" \
-              || gh release upload "${RELEASE_TAG}" "${FILES[@]}" --clobber
+            gh release create "${ARGS[@]}" assets/SHA256SUMS.txt \
+              || gh release upload "${RELEASE_TAG}" assets/SHA256SUMS.txt --clobber
+            gh release upload "${RELEASE_TAG}" "${BINARIES[@]}" --clobber
           fi
 
+      # Confirm against the live release, not just the files we meant to upload
+      - name: Verify published release checksums
+        if: steps.release-type.outputs.type == 'release' || steps.release-type.outputs.type == 'ptb'
+        env:
+          RELEASE_TAG: ${{ steps.release-type.outputs.tag }}
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          # A freshly uploaded asset is not always immediately readable, so retry
+          # rather than declaring a good release broken
+          for attempt in 1 2 3 4 5; do
+            rm -rf published-final/
+            mkdir -p published-final/
+            if gh release download "${RELEASE_TAG}" --pattern SHA256SUMS.txt --dir published-final/ \
+              && gh release view "${RELEASE_TAG}" --json assets --jq '.assets[].name' > published-final/assets.txt; then
+              break
+            fi
+            if [[ "${attempt}" -eq 5 ]]; then
+              echo "::error::Could not read back the published ${RELEASE_TAG} assets to verify them"
+              exit 1
+            fi
+            echo "Attempt ${attempt} could not read the published release yet - retrying"
+            sleep 10
+          done
+
+          echo "Published assets:"
+          cat published-final/assets.txt
+          bash release-scripts/CI/verify-release-checksums.sh published-final/SHA256SUMS.txt published-final/assets.txt
+
       # Generate and upload Sparkle appcast XML for macOS updates
       - name: Add SSH agent for appcast upload
         if: steps.release-type.outputs.type == 'release' || steps.release-type.outputs.type == 'ptb'
diff --git a/CI/assemble-release-checksums.sh b/CI/assemble-release-checksums.sh
new file mode 100755
index 000000000..8d6746667
--- /dev/null
+++ b/CI/assemble-release-checksums.sh
@@ -0,0 +1,127 @@
+#!/bin/bash
+# Assembles SHA256SUMS.txt for a GitHub Release from the per-platform .sha256
+# sidecar files, merged over the SHA256SUMS.txt already published on the release.
+#
+# Merging matters because create-github-release.yml runs once per platform build
+# workflow and uploads with --clobber. A run that sees fewer platforms than an
+# earlier run - or a re-run of one platform whose binary is named differently -
+# used to regenerate SHA256SUMS.txt from its own subset of sidecars and overwrite
+# the complete file, while the binaries from the earlier run stayed published. That
+# left release binaries with no checksum line, which the updater's download path
+# refuses to install (see Feed::findChecksum and UpdateDialog::startDownload).
+# Entries are keyed by filename and the freshly built sidecars win, so the
+# published file only ever gains coverage.
+#
+# This is a read-modify-write of a file shared by both platform triggers; it is
+# only safe because create-github-release.yml serialises them with a `concurrency`
+# group keyed on the build's head_sha.
+#
+# Usage: assemble-release-checksums.sh  [published-sums-file]
+
+set -euo pipefail
+
+ASSETS_DIR="${1:?assets directory required}"
+PUBLISHED_SUMS="${2:-}"
+
+OUTPUT="${ASSETS_DIR%/}/SHA256SUMS.txt"
+
+# no mapfile: macOS ships bash 3.2, and test/ci/release-checksums-test.sh runs
+# these scripts under ctest there
+SHA_FILES=()
+while IFS= read -r sha_file; do
+  SHA_FILES+=("${sha_file}")
+done < <(find "${ASSETS_DIR}" -name '*.sha256' -type f | sort)
+
+if [[ ${#SHA_FILES[@]} -eq 0 ]]; then
+  echo "::error::No .sha256 checksum files found in ${ASSETS_DIR}"
+  exit 1
+fi
+
+RECORDS="$(mktemp)"
+trap 'rm -f "${RECORDS}"' EXIT
+
+# Appends "\t\t\t" to ${RECORDS} for
+# every checksum line on stdin, so the lines can be deduplicated by filename with
+# the lowest priority number winning. The output line is rebuilt from these fields
+# rather than carried through verbatim, because a checksum line may itself contain
+# a tab and would then be truncated by the tab-delimited dedupe.
+collect() {
+  local priority="$1"
+  local source_label="$2"
+  local line
+  while IFS= read -r line || [[ -n "${line}" ]]; do
+    line="${line%$'\r'}"
+    if [[ -z "${line}" ]]; then
+      continue
+    fi
+    # sha256sum writes "  " in text mode and " *" in
+    # binary mode; MSYS2's defaults to binary, so the Windows entry uses " *"
+    if [[ ! "${line}" =~ ^([0-9a-fA-F]{64})[[:space:]]+(\*?)(.+)$ ]]; then
+      echo "::warning::Ignoring unparseable checksum line from ${source_label}: ${line}"
+      continue
+    fi
+    printf '%s\t%s\t%s\t%s\n' "${BASH_REMATCH[3]}" "${priority}" "${BASH_REMATCH[1]}" "${BASH_REMATCH[2]}" >> "${RECORDS}"
+  done
+}
+
+record_count() {
+  wc -l < "${RECORDS}" | tr -d ' '
+}
+
+if [[ -n "${PUBLISHED_SUMS}" && -f "${PUBLISHED_SUMS}" ]]; then
+  echo "Merging over the SHA256SUMS.txt already published on the release"
+  collect 2 "the published SHA256SUMS.txt" < "${PUBLISHED_SUMS}"
+fi
+
+# one sidecar at a time: concatenating them would join two records whenever a
+# sidecar lacks a trailing newline
+for sha_file in "${SHA_FILES[@]}"; do
+  before="$(record_count)"
+  sidecar_name="$(basename "${sha_file}")"
+  collect 1 "${sidecar_name}" < "${sha_file}"
+  if [[ "$(record_count)" -eq "${before}" ]]; then
+    echo "::error::${sha_file} contributed no checksum entry, so the binary it describes would be published uncovered"
+    exit 1
+  fi
+done
+
+if [[ ! -s "${RECORDS}" ]]; then
+  echo "::error::No valid checksum lines found in ${SHA_FILES[*]} ${PUBLISHED_SUMS}"
+  exit 1
+fi
+
+# First record per filename wins after sorting by filename then priority, so a
+# freshly built sidecar (1) beats an already published entry (2). Two different
+# hashes for one filename at the winning priority mean the inputs disagree, which
+# must not be resolved by picking one arbitrarily.
+if ! sort -t $'\t' -k1,1 -k2,2n "${RECORDS}" | awk -F '\t' '
+{
+  filename = $1; priority = $2 + 0; hash = $3; marker = $4
+  if (!(filename in winningPriority)) {
+    winningPriority[filename] = priority
+    winningHash[filename] = hash
+    winningMarker[filename] = marker
+    order[++count] = filename
+  } else if (priority == winningPriority[filename] && hash != winningHash[filename]) {
+    conflicting[filename] = 1
+  }
+}
+END {
+  failed = 0
+  for (i = 1; i <= count; i++) {
+    filename = order[i]
+    if (filename in conflicting) {
+      printf "::error::Conflicting checksums for %s - refusing to guess which is current\n", filename > "/dev/stderr"
+      failed = 1
+      continue
+    }
+    separator = (winningMarker[filename] == "*") ? " *" : "  "
+    printf "%s%s%s\n", winningHash[filename], separator, filename
+  }
+  exit failed
+}' > "${OUTPUT}"; then
+  exit 1
+fi
+
+echo "Generated SHA256SUMS.txt ($(wc -l < "${OUTPUT}" | tr -d ' ') entries):"
+cat "${OUTPUT}"
diff --git a/CI/prepare-release-assets.sh b/CI/prepare-release-assets.sh
new file mode 100755
index 000000000..3fb24055f
--- /dev/null
+++ b/CI/prepare-release-assets.sh
@@ -0,0 +1,105 @@
+#!/bin/bash
+# Validates the assets downloaded from the platform build runs before they are
+# published to a GitHub Release, and sets aside any that do not belong.
+#
+# A PTB tag is "Mudlet-<-ptb-DATE>-" and its asset filenames are
+# built from the same values, so they share that prefix; a stable release tag is
+# the pushed git tag, which spells "Mudlet-" and so shares the prefix
+# too. Anything else came from a different build: the two platform build workflows
+# can be re-run independently, a re-run recomputes the PTB date and so carries a
+# newer prefix than the tag, and create-github-release.yml always pairs the newest
+# successful run of each platform. Publishing such a file would put a binary from
+# build B into the release for build A, whose in-app version does not match the
+# release tag - and would leave the release holding a binary that no SHA256SUMS.txt
+# line can cover, because its checksum sidecar belongs to the other build.
+#
+# Setting an asset aside does not remove anything already published: a binary from
+# another build that an earlier run uploaded stays on the release, and stays
+# covered because assemble-release-checksums.sh merges its published entry
+# forward.
+#
+# Usage: prepare-release-assets.sh   
+
+set -euo pipefail
+
+ASSETS_DIR="${1:?assets directory required}"
+RELEASE_TAG="${2:?release tag required}"
+RELEASE_TYPE="${3:?release type required}"
+
+mkdir -p "${ASSETS_DIR}"
+
+echo "Downloaded assets:"
+find "${ASSETS_DIR}" -type f | sort
+
+# Everything published alongside the binaries, rather than a list of binary
+# suffixes: an unrecognised suffix has to be treated as a binary that needs
+# checking, or adding an asset type would silently exempt it
+is_release_binary() {
+  local name="$1"
+  [[ "${name}" != "SHA256SUMS.txt" && "${name}" != *.sha256 ]]
+}
+
+# Whether any file matching the pattern exists. `find | grep -q .` would be
+# simpler but exits non-zero under `set -o pipefail` when find is still writing as
+# grep leaves, which would report a present asset as missing.
+have_asset() {
+  [[ -n "$(find "${ASSETS_DIR}" -name "$1" -type f -print -quit)" ]]
+}
+
+# Set aside assets belonging to a different build. A .sha256 sidecar is judged by
+# the binary it describes, so a rejected binary takes its sidecar with it.
+# CI/set-build-info.sh lowercases VERSION while a git tag keeps its case, so the
+# prefix has to be compared case-insensitively.
+REJECTED_DIR="${ASSETS_DIR%/}-rejected"
+REJECTED=()
+shopt -s nocasematch
+while IFS= read -r asset_path; do
+  asset_name="$(basename "${asset_path}")"
+  binary_name="${asset_name%.sha256}"
+  if ! is_release_binary "${binary_name}"; then
+    continue
+  fi
+  if [[ "${binary_name}" == "${RELEASE_TAG}"* ]]; then
+    continue
+  fi
+  mkdir -p "${REJECTED_DIR}"
+  mv "${asset_path}" "${REJECTED_DIR}/"
+  REJECTED+=("${asset_name}")
+done < <(find "${ASSETS_DIR}" -type f | sort)
+shopt -u nocasematch
+
+if [[ ${#REJECTED[@]} -gt 0 ]]; then
+  echo "::warning::Ignoring ${#REJECTED[@]} asset(s) from a different build than ${RELEASE_TAG}: ${REJECTED[*]}"
+fi
+
+MISSING=()
+if ! have_asset '*.AppImage.tar'; then
+  MISSING+=("Linux (.AppImage.tar)")
+fi
+if ! have_asset '*-arm64.dmg'; then
+  MISSING+=("macOS (arm64 .dmg)")
+fi
+if ! have_asset '*-x86_64.dmg'; then
+  MISSING+=("macOS (x86_64 .dmg)")
+fi
+if ! have_asset '*.exe'; then
+  MISSING+=("Windows (.exe)")
+fi
+
+if [[ ${#MISSING[@]} -gt 0 ]]; then
+  echo "::warning::Missing release assets for: ${MISSING[*]}"
+fi
+
+# Stable releases must have all platforms; PTB tolerates partial
+if [[ "${RELEASE_TYPE}" == "release" && ${#MISSING[@]} -gt 0 ]]; then
+  echo "::error::Stable release is missing assets for: ${MISSING[*]}"
+  exit 1
+fi
+
+if ! have_asset '*.AppImage.tar' && ! have_asset '*.dmg' && ! have_asset '*.exe'; then
+  echo "::error::No release assets found for any platform"
+  exit 1
+fi
+
+echo "Assets to publish for ${RELEASE_TAG}:"
+find "${ASSETS_DIR}" -type f | sort
diff --git a/CI/verify-release-checksums.sh b/CI/verify-release-checksums.sh
new file mode 100755
index 000000000..fcc6cf21f
--- /dev/null
+++ b/CI/verify-release-checksums.sh
@@ -0,0 +1,113 @@
+#!/bin/bash
+# Fails if any release binary lacks a SHA256SUMS.txt entry, or if a binary we still
+# have on disk does not hash to the value listed for it.
+#
+# The updater's download path refuses a download it cannot verify (see
+# UpdateDialog::startDownload, which passes requireChecksums), so a release binary
+# without a checksum line cannot be installed through the update dialog - see
+# assemble-release-checksums.sh for how that used to happen. This is the gate that
+# keeps it from being published.
+#
+# The check covers assets already on the release, not just the ones being uploaded,
+# because those are what a user's updater will see. A release that is *already*
+# missing a checksum therefore fails every later run of the publishing job and
+# cannot be repaired by re-running it: the sidecar for an older run's binary is no
+# longer downloadable, so the stale asset has to be deleted from the release (or
+# its platform build re-run) by hand.
+#
+# Usage: verify-release-checksums.sh   [assets-dir]
+#   asset-names-file lists one asset filename per line: every release binary among
+#     them must have an entry in sums-file.
+#   assets-dir, when given, is searched for each of those binaries, and any that is
+#     found has its actual SHA256 compared against the listed one.
+
+set -euo pipefail
+
+SUMS_FILE="${1:?SHA256SUMS.txt path required}"
+ASSET_NAMES_FILE="${2:?asset names file required}"
+ASSETS_DIR="${3:-}"
+
+if [[ ! -f "${SUMS_FILE}" ]]; then
+  echo "::error::${SUMS_FILE} does not exist - cannot verify release checksum coverage"
+  exit 1
+fi
+
+# Everything published alongside the binaries, rather than a list of binary
+# suffixes: an unrecognised suffix has to be treated as a binary that needs
+# checking, or adding an asset type would silently exempt it
+is_release_binary() {
+  local name="$1"
+  [[ "${name}" != "SHA256SUMS.txt" && "${name}" != *.sha256 ]]
+}
+
+sha256_of() {
+  if command -v sha256sum > /dev/null 2>&1; then
+    sha256sum "$1" | cut -d ' ' -f 1
+  else
+    shasum -a 256 "$1" | cut -d ' ' -f 1
+  fi
+}
+
+# "\t" for every entry in the checksum file
+COVERED="$(mktemp)"
+trap 'rm -f "${COVERED}"' EXIT
+while IFS= read -r line || [[ -n "${line}" ]]; do
+  line="${line%$'\r'}"
+  if [[ "${line}" =~ ^([0-9a-fA-F]{64})[[:space:]]+\*?(.+)$ ]]; then
+    printf '%s\t%s\n' "${BASH_REMATCH[2]}" "${BASH_REMATCH[1]}" >> "${COVERED}"
+  fi
+done < "${SUMS_FILE}"
+
+if [[ ! -s "${COVERED}" ]]; then
+  echo "::error::${SUMS_FILE} contains no usable checksum entries - it is empty or was not downloaded correctly"
+  exit 1
+fi
+
+UNCOVERED=()
+MISMATCHED=()
+CHECKED=0
+while IFS= read -r asset_name || [[ -n "${asset_name}" ]]; do
+  asset_name="${asset_name%$'\r'}"
+  if [[ -z "${asset_name}" ]] || ! is_release_binary "${asset_name}"; then
+    continue
+  fi
+  CHECKED=$((CHECKED + 1))
+
+  expected="$(awk -F '\t' -v name="${asset_name}" '$1 == name { print $2; exit }' "${COVERED}")"
+  if [[ -z "${expected}" ]]; then
+    UNCOVERED+=("${asset_name}")
+    continue
+  fi
+
+  if [[ -z "${ASSETS_DIR}" ]]; then
+    continue
+  fi
+  asset_path="$(find "${ASSETS_DIR}" -name "${asset_name}" -type f -print -quit 2> /dev/null || true)"
+  if [[ -z "${asset_path}" ]]; then
+    continue
+  fi
+  actual="$(sha256_of "${asset_path}")"
+  if [[ "${actual}" != "${expected}" ]]; then
+    MISMATCHED+=("${asset_name} (listed ${expected}, actual ${actual})")
+  fi
+done < "${ASSET_NAMES_FILE}"
+
+if [[ ${#UNCOVERED[@]} -gt 0 ]]; then
+  echo "::error::${#UNCOVERED[@]} release binary/binaries have no SHA256SUMS.txt entry, so Mudlet's updater cannot install them: ${UNCOVERED[*]}"
+  echo "Delete the stale asset from the release, or re-run the platform build that produced it, then re-run this job."
+  echo "SHA256SUMS.txt covers:"
+  cut -f 1 "${COVERED}" | sort
+  exit 1
+fi
+
+if [[ ${#MISMATCHED[@]} -gt 0 ]]; then
+  echo "::error::${#MISMATCHED[@]} release binary/binaries do not match their SHA256SUMS.txt entry, so Mudlet's updater would reject the download: ${MISMATCHED[*]}"
+  exit 1
+fi
+
+if [[ ${CHECKED} -eq 0 ]]; then
+  echo "::error::No release binaries found to verify - expected at least one"
+  exit 1
+fi
+
+echo "All ${CHECKED} release binary/binaries have a SHA256SUMS.txt entry"
diff --git a/src/updater/Feed.cpp b/src/updater/Feed.cpp
index e564cc6a9..a826e8deb 100644
--- a/src/updater/Feed.cpp
+++ b/src/updater/Feed.cpp
@@ -159,13 +159,55 @@ void Feed::downloadRelease(const Release& release, bool requireChecksums)
     if (checksumsUrl.isValid() && !checksumsUrl.isEmpty()) {
         fetchChecksums(checksumsUrl);
     } else if (requireChecksums) {
-        //: Error shown when a manual update cannot be verified as safe to install
-        emit downloadError(tr("Could not verify the integrity of the download. Please try again later."));
+        qWarning() << "Release" << release.getVersion() << "publishes no checksums - refusing to install an unverifiable download";
+        //: Error shown when the release publishes no checksums at all, so the download cannot be verified as safe to install
+        emit downloadError(tr("This update does not publish the checksums needed to verify it. Please try again later, or download it from https://www.mudlet.org/download/"));
     } else {
+        qCritical() << "Release" << release.getVersion() << "publishes no checksums - download will proceed without integrity verification";
         makeDownloadRequest(downloadUrl);
     }
 }
 
+QString Feed::findChecksum(const QString& checksumData, const QString& downloadFilename, int* entriesParsed)
+{
+    if (entriesParsed) {
+        *entriesParsed = 0;
+    }
+    if (downloadFilename.isEmpty()) {
+        return QString();
+    }
+
+    // SHA256 hex digest is 64 characters; search for separator after that
+    static const QRegularExpression separatorRx(qsl("[\\s*]+"));
+    static const QRegularExpression hexRx(qsl("^[0-9a-fA-F]{64}$"));
+
+    QString match;
+    const QStringList lines = checksumData.split(QLatin1Char('\n'), Qt::SkipEmptyParts);
+    for (const auto& line : lines) {
+        // Format: "hash  filename" or "hash *filename"
+        const int separatorPos = line.indexOf(separatorRx, 64);
+        if (separatorPos <= 0) {
+            continue;
+        }
+        const QString hash = line.left(separatorPos).trimmed();
+        if (!hexRx.match(hash).hasMatch()) {
+            continue;
+        }
+        if (entriesParsed) {
+            ++*entriesParsed;
+        }
+        // Compare the whole name, not a substring of it: SHA256SUMS.txt accumulates
+        // entries across builds, so a longer name that happens to contain this one
+        // would otherwise hand back the wrong hash. The generators write bare
+        // basenames, but tolerate a path in case one ever stops.
+        const QString filename = line.mid(separatorPos).trimmed().remove(QLatin1Char('*'));
+        if (match.isEmpty() && filename.section(QLatin1Char('/'), -1).compare(downloadFilename, Qt::CaseInsensitive) == 0) {
+            match = hash;
+        }
+    }
+    return match;
+}
+
 void Feed::fetchChecksums(const QUrl& checksumsUrl)
 {
     QNetworkRequest request(checksumsUrl);
@@ -177,45 +219,36 @@ void Feed::fetchChecksums(const QUrl& checksumsUrl)
     connect(reply, &QNetworkReply::finished, this, [this, reply]() {
         if (reply->error() != QNetworkReply::NoError) {
             if (mRequireChecksums) {
+                qWarning() << "Failed to fetch checksums:" << reply->errorString() << "- refusing to install an unverifiable download";
                 reply->deleteLater();
-                //: Error shown when a manual update cannot be verified as safe to install
-                emit downloadError(tr("Could not verify the integrity of the download. Please try again later."));
+                //: Error shown when the checksums needed to verify the update could not be downloaded
+                emit downloadError(tr("Could not download the checksums needed to verify this update. Please try again later."));
                 return;
             }
             qWarning() << "Failed to fetch checksums:" << reply->errorString() << "- download will proceed without integrity verification";
         } else {
-            const QString checksumData = QString::fromUtf8(reply->readAll());
-            const QStringList lines = checksumData.split(QLatin1Char('\n'), Qt::SkipEmptyParts);
-            // SHA256 hex digest is 64 characters; search for separator after that
-            static const QRegularExpression separatorRx(qsl("[\\s*]+"));
-            static const QRegularExpression hexRx(qsl("^[0-9a-fA-F]{64}$"));
-            for (const auto& line : lines) {
-                // Format: "hash  filename" or "hash *filename"
-                const int separatorPos = line.indexOf(separatorRx, 64);
-                if (separatorPos <= 0) {
-                    continue;
-                }
-                const QString hash = line.left(separatorPos).trimmed();
-                if (!hexRx.match(hash).hasMatch()) {
-                    continue;
-                }
-                const QString filename = line.mid(separatorPos).trimmed().remove(QLatin1Char('*'));
-
-                // Match against the download URL filename
-                const QString downloadFilename = mCurrentDownload.getDownloadUrl().fileName();
-                if (!downloadFilename.isEmpty() && filename.contains(downloadFilename, Qt::CaseInsensitive)) {
-                    mCurrentDownload.setDownloadSHA256(hash);
-                    break;
-                }
-            }
+            const QString downloadFilename = mCurrentDownload.getDownloadUrl().fileName();
+            const QByteArray checksumData = reply->readAll();
+            int entriesParsed = 0;
+            mCurrentDownload.setDownloadSHA256(findChecksum(QString::fromUtf8(checksumData), downloadFilename, &entriesParsed));
             if (mCurrentDownload.getDownloadSHA256().isEmpty()) {
+                qWarning() << "Checksum file has no entry for" << downloadFilename << "- parsed" << entriesParsed << "entries from" << checksumData.size() << "bytes";
                 if (mRequireChecksums) {
                     reply->deleteLater();
-                    //: Error shown when a manual update cannot be verified as safe to install
-                    emit downloadError(tr("Could not verify the integrity of the download. Please try again later."));
+                    if (entriesParsed == 0) {
+                        // Nothing parsed means the payload was not a checksum file at
+                        // all - a truncated transfer, or an error page served as 200 -
+                        // rather than a release that forgot one platform
+                        //: Error shown when the checksum file for the update was downloaded but could not be read
+                        emit downloadError(tr("The checksums for this update could not be read, so it cannot be verified. Please try again later."));
+                    } else {
+                        //: Error shown when the release publishes checksums but none of them cover this platform's download
+                        emit downloadError(
+                                tr("This update is missing a checksum for your platform, so it cannot be verified. Please try again later, or download it from https://www.mudlet.org/download/"));
+                    }
                     return;
                 }
-                qCritical() << "Checksum file downloaded but no matching hash found for" << mCurrentDownload.getDownloadUrl().fileName() << "- download will proceed without integrity verification";
+                qCritical() << "Proceeding without integrity verification for" << downloadFilename;
             }
         }
         reply->deleteLater();
diff --git a/src/updater/Feed.h b/src/updater/Feed.h
index d805d0cbb..facab300e 100644
--- a/src/updater/Feed.h
+++ b/src/updater/Feed.h
@@ -48,6 +48,13 @@ public:
     void load();
     void downloadRelease(const Release& release, bool requireChecksums = false);
 
+    // Returns the SHA256 that sha256sum-style output lists for downloadFilename,
+    // comparing the whole filename case-insensitively, or an empty string when no
+    // line covers it. entriesParsed, when given, receives the number of well-formed
+    // lines seen, which tells "this release forgot my platform" apart from "that was
+    // not a checksum file".
+    static QString findChecksum(const QString& checksumData, const QString& downloadFilename, int* entriesParsed = nullptr);
+
     QList getUpdates(const Release& currentRelease) const;
     QList getReleases() const;
     QString getDownloadFilePath() const;
diff --git a/test/CMakeLists.txt b/test/CMakeLists.txt
index b2d4d0881..ec0fe44c9 100644
--- a/test/CMakeLists.txt
+++ b/test/CMakeLists.txt
@@ -7,7 +7,7 @@ if(NOT WIN32)
     include(${CMAKE_SOURCE_DIR}/src/cmake/EnableSanitizers.cmake)
 endif()
 
-find_package(Qt6 6.8.2 REQUIRED COMPONENTS Test)
+find_package(Qt6 6.8.2 REQUIRED COMPONENTS Test Network Widgets)
 
 set(UNIT_TESTS
     TEntityResolverTest
@@ -62,4 +62,27 @@ set_tests_properties(CMakeListsConsistencyTest PROPERTIES
     ENVIRONMENT "ASAN_OPTIONS=detect_leaks=0"
 )
 
+# Pairing of a release's assets with its SHA256SUMS.txt. Built from the updater
+# sources rather than linked against the Mudlet library, because the library only
+# contains them when configured with USE_UPDATER.
+add_executable(UpdaterChecksumTest
+    UpdaterChecksumTest.cpp
+    ${CMAKE_SOURCE_DIR}/src/updater/Feed.cpp
+    ${CMAKE_SOURCE_DIR}/src/updater/Release.cpp
+    ${CMAKE_SOURCE_DIR}/src/updater/SemVer.cpp
+)
+target_link_libraries(UpdaterChecksumTest PRIVATE Qt6::Test Qt6::Network Qt6::Widgets)
+add_test(NAME UpdaterChecksumTest COMMAND $)
+set_tests_properties(UpdaterChecksumTest PROPERTIES
+    ENVIRONMENT "ASAN_OPTIONS=detect_leaks=0"
+)
+
+# Checks the release-publishing scripts that keep SHA256SUMS.txt covering every
+# release binary - a binary without an entry is one the updater refuses to install
+if(NOT WIN32)
+    add_test(NAME ReleaseChecksumsTest
+        COMMAND bash ${CMAKE_CURRENT_SOURCE_DIR}/ci/release-checksums-test.sh
+    )
+endif()
+
 add_subdirectory(functional_tests)
diff --git a/test/UpdaterChecksumTest.cpp b/test/UpdaterChecksumTest.cpp
new file mode 100644
index 000000000..f1fd72c17
--- /dev/null
+++ b/test/UpdaterChecksumTest.cpp
@@ -0,0 +1,230 @@
+/***************************************************************************
+ *   Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org     *
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the GNU General Public License as published by  *
+ *   the Free Software Foundation; either version 2 of the License, or     *
+ *   (at your option) any later version.                                   *
+ *                                                                         *
+ *   This program is distributed in the hope that it will be useful,       *
+ *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
+ *   GNU General Public License for more details.                          *
+ *                                                                         *
+ *   You should have received a copy of the GNU General Public License     *
+ *   along with this program; if not, write to the                         *
+ *   Free Software Foundation, Inc.,                                       *
+ *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
+ ***************************************************************************/
+
+#include "../src/updater/Feed.h"
+#include "../src/updater/Release.h"
+
+#include 
+
+#include 
+#include 
+
+/*
+ * Covers the pairing of a release's assets with its SHA256SUMS.txt, which is what
+ * decides whether an update can be installed at all.
+ *
+ * Windows auto-update broke on the 2026-08-01 PTB: the release carried five
+ * binaries but a SHA256SUMS.txt covering only four, and the uncovered one was the
+ * .exe the Windows updater picks. Feed refuses to install a download it cannot
+ * verify, so users got "Could not verify the integrity of the download" and no
+ * update. The data below is that release's real asset list and checksum file.
+ *
+ * The publishing side of the fix - never overwriting SHA256SUMS.txt with a file
+ * that covers fewer binaries - is covered by test/ci/release-checksums-test.sh.
+ */
+
+namespace {
+const auto tag = QStringLiteral("Mudlet-4.22.0-ptb-2026-08-01-dfdcb137");
+const auto windowsAsset = QStringLiteral("Mudlet-4.22.0-ptb-2026-08-01-dfdcb137-windows-64.exe");
+const auto linuxAsset = QStringLiteral("Mudlet-4.22.0-ptb-2026-08-01-dfdcb137-linux-x64.AppImage.tar");
+const auto arm64Asset = QStringLiteral("Mudlet-4.22.0-ptb-2026-08-01-dfdcb137-arm64.dmg");
+const auto intelMacAsset = QStringLiteral("Mudlet-4.22.0-ptb-2026-08-01-dfdcb137-x86_64.dmg");
+// A re-run of the Windows build restamped the date and appended a rebuild counter
+const auto rebuiltWindowsAsset = QStringLiteral("Mudlet-4.22.0-ptb-2026-08-02-dfdcb137rebuild2-windows-64.exe");
+
+const auto windowsHash = QStringLiteral("72dba076741a245a994b553b1cf88dba5d7f5bb07f0d6887ecd58361402764e1");
+const auto linuxHash = QStringLiteral("72a239146b07fc3b94f9e96955d2d6d52a6f0f40c8a5b7ee314b0bf875a55611");
+const auto arm64Hash = QStringLiteral("7a7a75723e15a3443c4e8937fe2a85cee90b9dc8938e1e0580887e5c5e1fabbb");
+const auto intelMacHash = QStringLiteral("d2426d7f799b619b0bfcb1e51e373f776288f77584bc9f08a79cc288cc58278c");
+const auto rebuiltWindowsHash = QStringLiteral("9b3895247937d37f645dd31e7ded739e3126ccad6bfa4188cdd3b78f735c2f6f");
+
+// Exactly what the 2026-08-01 PTB shipped: the .exe on the release is absent and a
+// different build's .exe is listed in its place
+QString publishedChecksums()
+{
+    return QStringLiteral("%1  %2\n%3  %4\n%5 *%6\n%7  %8\n").arg(linuxHash, linuxAsset, intelMacHash, intelMacAsset, rebuiltWindowsHash, rebuiltWindowsAsset, arm64Hash, arm64Asset);
+}
+
+// What the release should have shipped, and does once the publishing scripts merge
+// instead of overwrite
+QString mergedChecksums()
+{
+    return publishedChecksums() + QStringLiteral("%1 *%2\n").arg(windowsHash, windowsAsset);
+}
+
+// The 2026-08-01 PTB's assets, in the order the GitHub releases API returns them -
+// which is what decided the bug: had the API listed the rebuilt .exe first, the
+// updater would have chosen the one that *was* covered. published_at and size are
+// filler, only the tag and the asset names and order are the release's real values.
+QJsonObject releaseJson()
+{
+    const QStringList assetNames{arm64Asset, linuxAsset, windowsAsset, intelMacAsset, rebuiltWindowsAsset, QStringLiteral("SHA256SUMS.txt")};
+
+    QJsonArray assets;
+    for (const auto& name : assetNames) {
+        QJsonObject asset;
+        asset.insert(QStringLiteral("name"), name);
+        asset.insert(QStringLiteral("browser_download_url"), QStringLiteral("https://github.com/Mudlet/Mudlet/releases/download/%1/%2").arg(tag, name));
+        asset.insert(QStringLiteral("size"), 137252032);
+        assets.append(asset);
+    }
+
+    QJsonObject release;
+    release.insert(QStringLiteral("tag_name"), tag);
+    release.insert(QStringLiteral("published_at"), QStringLiteral("2026-07-31T18:22:33Z"));
+    release.insert(QStringLiteral("prerelease"), true);
+    release.insert(QStringLiteral("draft"), false);
+    release.insert(QStringLiteral("assets"), assets);
+    return release;
+}
+} // namespace
+
+class UpdaterChecksumTest : public QObject
+{
+    Q_OBJECT
+
+private slots:
+    void windowsDownloadIsThePlatformExe();
+    void publishedChecksumsDoNotCoverTheWindowsDownload();
+    void mergedChecksumsCoverTheWindowsDownload();
+    void everyOtherPlatformWasAlreadyCovered();
+    void binaryAndTextModeLinesBothParse();
+    void anotherBuildsEntryDoesNotCoverThisDownload();
+    void aLongerNameContainingThisOneDoesNotCoverIt();
+    void aPathPrefixedEntryStillCoversTheDownload();
+    void malformedLinesAreIgnored();
+    void emptyInputsYieldNoChecksum();
+    void entriesParsedTellsAnUnreadableFileFromAMissingEntry();
+};
+
+// The updater picks the first asset matching its platform, so this is the file
+// whose checksum has to be present
+void UpdaterChecksumTest::windowsDownloadIsThePlatformExe()
+{
+    const dblsqd::Release release(releaseJson(), QStringLiteral("win"), QStringLiteral("x86_64"));
+
+    QCOMPARE(release.getDownloadUrl().fileName(), windowsAsset);
+    QCOMPARE(release.getChecksumsUrl().fileName(), QStringLiteral("SHA256SUMS.txt"));
+}
+
+// The regression: this is why Windows auto-update failed
+void UpdaterChecksumTest::publishedChecksumsDoNotCoverTheWindowsDownload()
+{
+    const dblsqd::Release release(releaseJson(), QStringLiteral("win"), QStringLiteral("x86_64"));
+
+    QVERIFY(dblsqd::Feed::findChecksum(publishedChecksums(), release.getDownloadUrl().fileName()).isEmpty());
+}
+
+void UpdaterChecksumTest::mergedChecksumsCoverTheWindowsDownload()
+{
+    const dblsqd::Release release(releaseJson(), QStringLiteral("win"), QStringLiteral("x86_64"));
+
+    QCOMPARE(dblsqd::Feed::findChecksum(mergedChecksums(), release.getDownloadUrl().fileName()), windowsHash);
+}
+
+void UpdaterChecksumTest::everyOtherPlatformWasAlreadyCovered()
+{
+    const dblsqd::Release linuxRelease(releaseJson(), QStringLiteral("linux"), QStringLiteral("x86_64"));
+    QCOMPARE(linuxRelease.getDownloadUrl().fileName(), linuxAsset);
+    QCOMPARE(dblsqd::Feed::findChecksum(publishedChecksums(), linuxRelease.getDownloadUrl().fileName()), linuxHash);
+
+    const dblsqd::Release intelMacRelease(releaseJson(), QStringLiteral("mac"), QStringLiteral("x86_64"));
+    QCOMPARE(intelMacRelease.getDownloadUrl().fileName(), intelMacAsset);
+    QCOMPARE(dblsqd::Feed::findChecksum(publishedChecksums(), intelMacRelease.getDownloadUrl().fileName()), intelMacHash);
+
+    const dblsqd::Release appleSiliconRelease(releaseJson(), QStringLiteral("mac"), QStringLiteral("arm64"));
+    QCOMPARE(appleSiliconRelease.getDownloadUrl().fileName(), arm64Asset);
+    QCOMPARE(dblsqd::Feed::findChecksum(publishedChecksums(), appleSiliconRelease.getDownloadUrl().fileName()), arm64Hash);
+}
+
+// sha256sum writes two spaces in text mode and " *" in binary mode; the Windows
+// build produces the latter
+void UpdaterChecksumTest::binaryAndTextModeLinesBothParse()
+{
+    QCOMPARE(dblsqd::Feed::findChecksum(QStringLiteral("%1 *%2").arg(windowsHash, windowsAsset), windowsAsset), windowsHash);
+    QCOMPARE(dblsqd::Feed::findChecksum(QStringLiteral("%1  %2").arg(windowsHash, windowsAsset), windowsAsset), windowsHash);
+    QCOMPARE(dblsqd::Feed::findChecksum(QStringLiteral("%1\t%2").arg(windowsHash, windowsAsset), windowsAsset), windowsHash);
+    // trailing CR from a file written on Windows must not become part of the name
+    QCOMPARE(dblsqd::Feed::findChecksum(QStringLiteral("%1 *%2\r\n").arg(windowsHash, windowsAsset), windowsAsset), windowsHash);
+}
+
+// The rebuilt installer's entry must not be accepted for a different file, or the
+// updater would check the download against the wrong hash
+void UpdaterChecksumTest::anotherBuildsEntryDoesNotCoverThisDownload()
+{
+    const QString rebuiltOnly = QStringLiteral("%1 *%2\n").arg(rebuiltWindowsHash, rebuiltWindowsAsset);
+
+    QVERIFY(dblsqd::Feed::findChecksum(rebuiltOnly, windowsAsset).isEmpty());
+    QCOMPARE(dblsqd::Feed::findChecksum(rebuiltOnly, rebuiltWindowsAsset), rebuiltWindowsHash);
+}
+
+// SHA256SUMS.txt accumulates entries across builds, so a name that merely contains
+// the download's name must not hand back its hash - the updater would then reject a
+// perfectly good download as corrupt
+void UpdaterChecksumTest::aLongerNameContainingThisOneDoesNotCoverIt()
+{
+    const QString longerName = QStringLiteral("old-%1").arg(windowsAsset);
+
+    QVERIFY(dblsqd::Feed::findChecksum(QStringLiteral("%1 *%2\n").arg(rebuiltWindowsHash, longerName), windowsAsset).isEmpty());
+    QVERIFY(dblsqd::Feed::findChecksum(QStringLiteral("%1  %2.sha256\n").arg(rebuiltWindowsHash, windowsAsset), windowsAsset).isEmpty());
+    QVERIFY(dblsqd::Feed::findChecksum(QStringLiteral("%1  %2.tar\n").arg(rebuiltWindowsHash, linuxAsset), linuxAsset).isEmpty());
+}
+
+void UpdaterChecksumTest::aPathPrefixedEntryStillCoversTheDownload()
+{
+    QCOMPARE(dblsqd::Feed::findChecksum(QStringLiteral("%1 *upload/%2\n").arg(windowsHash, windowsAsset), windowsAsset), windowsHash);
+}
+
+void UpdaterChecksumTest::malformedLinesAreIgnored()
+{
+    // too short, non-hex, and no separator respectively, then the real entry
+    const QString data = QStringLiteral("abc123  %1\n"
+                                        "zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz  %1\n"
+                                        "%2\n"
+                                        "%3 *%1\n")
+                                 .arg(windowsAsset, windowsHash, windowsHash);
+
+    QCOMPARE(dblsqd::Feed::findChecksum(data, windowsAsset), windowsHash);
+}
+
+void UpdaterChecksumTest::emptyInputsYieldNoChecksum()
+{
+    QVERIFY(dblsqd::Feed::findChecksum(QString(), windowsAsset).isEmpty());
+    QVERIFY(dblsqd::Feed::findChecksum(mergedChecksums(), QString()).isEmpty());
+}
+
+// A release that forgot one platform and a payload that was never a checksum file
+// both yield no hash, but they need different messages
+void UpdaterChecksumTest::entriesParsedTellsAnUnreadableFileFromAMissingEntry()
+{
+    int entriesParsed = -1;
+    QVERIFY(dblsqd::Feed::findChecksum(publishedChecksums(), windowsAsset, &entriesParsed).isEmpty());
+    QCOMPARE(entriesParsed, 4);
+
+    entriesParsed = -1;
+    QVERIFY(dblsqd::Feed::findChecksum(QStringLiteral("503 Service Unavailable"), windowsAsset, &entriesParsed).isEmpty());
+    QCOMPARE(entriesParsed, 0);
+
+    entriesParsed = -1;
+    QCOMPARE(dblsqd::Feed::findChecksum(mergedChecksums(), windowsAsset, &entriesParsed), windowsHash);
+    QCOMPARE(entriesParsed, 5);
+}
+
+#include "UpdaterChecksumTest.moc"
+QTEST_MAIN(UpdaterChecksumTest)
diff --git a/test/ci/release-checksums-test.sh b/test/ci/release-checksums-test.sh
new file mode 100755
index 000000000..85c0c638a
--- /dev/null
+++ b/test/ci/release-checksums-test.sh
@@ -0,0 +1,406 @@
+#!/bin/bash
+# Tests the release checksum scripts against the asset sets that made Windows
+# auto-update fail with "Could not verify the integrity of the download".
+#
+# The failure: the 2026-08-01 PTB ended up with five binaries but a
+# SHA256SUMS.txt covering only four. The uncovered one was
+# Mudlet-4.22.0-ptb-2026-08-01-dfdcb137-windows-64.exe - the very file the
+# updater downloads on Windows - so it refused to install anything.
+#
+# The 2026-08-01 and 2026-08-03 filenames and hashes below are the real published
+# ones; the stable-release and rebuild-counter cases further down are synthetic.
+
+set -uo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+CI_DIR="$(cd "${SCRIPT_DIR}/../../CI" && pwd)"
+
+WORK_DIR="$(mktemp -d)"
+trap 'rm -rf "${WORK_DIR}"' EXIT
+
+FAILURES=0
+CURRENT_TEST=""
+
+readonly TAG='Mudlet-4.22.0-ptb-2026-08-01-dfdcb137'
+readonly LINUX_ASSET="${TAG}-linux-x64.AppImage.tar"
+readonly ARM64_ASSET="${TAG}-arm64.dmg"
+readonly INTEL_MAC_ASSET="${TAG}-x86_64.dmg"
+readonly WINDOWS_ASSET="${TAG}-windows-64.exe"
+# Only the Windows build appends a rebuild counter (CI/deploy-mudlet-for-windows.sh);
+# a re-run also restamps the PTB date, which is what changes the tag prefix
+readonly REBUILD_WINDOWS_ASSET='Mudlet-4.22.0-ptb-2026-08-02-dfdcb137rebuild2-windows-64.exe'
+
+readonly LINUX_HASH='72a239146b07fc3b94f9e96955d2d6d52a6f0f40c8a5b7ee314b0bf875a55611'
+readonly ARM64_HASH='7a7a75723e15a3443c4e8937fe2a85cee90b9dc8938e1e0580887e5c5e1fabbb'
+readonly INTEL_MAC_HASH='d2426d7f799b619b0bfcb1e51e373f776288f77584bc9f08a79cc288cc58278c'
+readonly WINDOWS_HASH='72dba076741a245a994b553b1cf88dba5d7f5bb07f0d6887ecd58361402764e1'
+readonly REBUILD_WINDOWS_HASH='9b3895247937d37f645dd31e7ded739e3126ccad6bfa4188cdd3b78f735c2f6f'
+
+start_test() {
+  CURRENT_TEST="$1"
+  echo "=== ${CURRENT_TEST}"
+}
+
+fail() {
+  echo "    FAIL: $*" >&2
+  FAILURES=$((FAILURES + 1))
+}
+
+pass() {
+  echo "    ok: $*"
+}
+
+assert_contains() {
+  local file="$1" needle="$2"
+  if grep -qF -- "${needle}" "${file}"; then
+    pass "${file##*/} contains ${needle}"
+  else
+    fail "${file##*/} is missing ${needle}"
+    echo "--- ${file} ---" >&2
+    cat "${file}" >&2
+  fi
+}
+
+assert_absent() {
+  local file="$1" needle="$2"
+  if [[ ! -s "${file}" ]]; then
+    fail "${file##*/} is empty or missing, so 'does not contain' proves nothing"
+    return
+  fi
+  if grep -qF -- "${needle}" "${file}"; then
+    fail "${file##*/} unexpectedly contains ${needle}"
+  else
+    pass "${file##*/} does not contain ${needle}"
+  fi
+}
+
+assert_line_count() {
+  local file="$1" expected="$2" actual
+  actual="$(wc -l < "${file}" | tr -d ' ')"
+  if [[ "${actual}" == "${expected}" ]]; then
+    pass "${file##*/} has ${expected} entries"
+  else
+    fail "${file##*/} has ${actual} entries, expected ${expected}"
+    cat "${file}" >&2
+  fi
+}
+
+run_prepare() {
+  local case_dir="$1" tag="$2" type="$3"
+  bash "${CI_DIR}/prepare-release-assets.sh" "${case_dir}/assets" "${tag}" "${type}" > "${case_dir}/prepare.log" 2>&1
+}
+
+run_assemble() {
+  local case_dir="$1" published="$2"
+  bash "${CI_DIR}/assemble-release-checksums.sh" "${case_dir}/assets" "${published}" > "${case_dir}/assemble.log" 2>&1
+}
+
+run_verify() {
+  local case_dir="$1"
+  shift
+  bash "${CI_DIR}/verify-release-checksums.sh" "$@" > "${case_dir}/verify.log" 2>&1
+}
+
+expect_ok() {
+  local what="$1" case_dir="$2" log="$3"
+  if [[ "$4" -eq 0 ]]; then
+    pass "${what} succeeded"
+  else
+    fail "${what} exited non-zero"
+    cat "${case_dir}/${log}" >&2
+  fi
+}
+
+expect_failure() {
+  local what="$1" status="$2"
+  if [[ "${status}" -ne 0 ]]; then
+    pass "${what} rejected it"
+  else
+    fail "${what} accepted it"
+  fi
+}
+
+# macOS has shasum rather than coreutils' sha256sum
+sha256_of() {
+  if command -v sha256sum > /dev/null 2>&1; then
+    sha256sum "$1" | cut -d ' ' -f 1
+  else
+    shasum -a 256 "$1" | cut -d ' ' -f 1
+  fi
+}
+
+# Creates a case directory with an assets/ subdirectory holding placeholder
+# binaries and their .sha256 sidecars. Arguments are "name:hash" pairs; a hash of
+# "real" is computed from the placeholder's actual bytes.
+make_assets() {
+  local case_dir="$1"
+  shift
+  mkdir -p "${case_dir}/assets"
+  local pair name hash
+  for pair in "$@"; do
+    name="${pair%%:*}"
+    hash="${pair##*:}"
+    echo "placeholder for ${name}" > "${case_dir}/assets/${name}"
+    if [[ "${hash}" == "real" ]]; then
+      hash="$(sha256_of "${case_dir}/assets/${name}")"
+    fi
+    printf '%s *%s\n' "${hash}" "${name}" > "${case_dir}/assets/${name}.sha256"
+  done
+}
+
+published_sums_from_the_complete_run() {
+  # What run 30687252829 published: all four platforms of ${TAG}
+  cat < "${CASE}/published-SHA256SUMS.txt"
+
+run_prepare "${CASE}" "${TAG}" ptb
+expect_ok "prepare-release-assets.sh" "${CASE}" prepare.log $?
+assert_contains "${CASE}/prepare.log" "::warning::Ignoring 2 asset(s) from a different build"
+if [[ -e "${CASE}/assets/${REBUILD_WINDOWS_ASSET}" ]]; then
+  fail "the other build's installer was left in assets/"
+else
+  pass "the other build's installer was set aside"
+fi
+
+run_assemble "${CASE}" "${CASE}/published-SHA256SUMS.txt"
+expect_ok "assemble-release-checksums.sh" "${CASE}" assemble.log $?
+SUMS="${CASE}/assets/SHA256SUMS.txt"
+# The regression: without merging, this file lost the ${WINDOWS_ASSET} entry
+assert_contains "${SUMS}" "${WINDOWS_HASH}"
+assert_contains "${SUMS}" "${WINDOWS_ASSET}"
+assert_contains "${SUMS}" "${LINUX_ASSET}"
+assert_contains "${SUMS}" "${ARM64_ASSET}"
+assert_contains "${SUMS}" "${INTEL_MAC_ASSET}"
+assert_absent "${SUMS}" "${REBUILD_WINDOWS_ASSET}"
+assert_line_count "${SUMS}" 4
+
+# The release afterwards holds what was already published plus what we upload
+cat > "${CASE}/final-assets.txt" < "${CASE}/SHA256SUMS.txt" < "${CASE}/assets.txt" < "${CASE}/assets.txt"
+
+run_verify "${CASE}" "${CASE}/assets/SHA256SUMS.txt" "${CASE}/assets.txt" "${CASE}/assets"
+expect_ok "verify-release-checksums.sh on matching bytes" "${CASE}" verify.log $?
+
+echo "tampered" > "${CASE}/assets/${WINDOWS_ASSET}"
+run_verify "${CASE}" "${CASE}/assets/SHA256SUMS.txt" "${CASE}/assets.txt" "${CASE}/assets"
+expect_failure "verify-release-checksums.sh on altered bytes" $?
+assert_contains "${CASE}/verify.log" "do not match their SHA256SUMS.txt entry"
+
+#-----------------------------------------------------------------------------
+start_test "a Windows-only PTB is published with its one checksum"
+# The 2026-08-03 PTB: the Linux/macOS build had not succeeded, so only the
+# Windows installer was available. Partial PTBs are allowed, but the installer
+# still has to be covered.
+CASE="${WORK_DIR}/windows-only"
+WINDOWS_ONLY_TAG='Mudlet-4.22.0-ptb-2026-08-03-3474cb58'
+WINDOWS_ONLY_ASSET="${WINDOWS_ONLY_TAG}-windows-64.exe"
+make_assets "${CASE}" \
+  "${WINDOWS_ONLY_ASSET}:c22435c7ff0d36a5dbe5936bcfbbc173f656c2c33583dccbf17a7ad4ade3e350"
+run_prepare "${CASE}" "${WINDOWS_ONLY_TAG}" ptb
+expect_ok "prepare-release-assets.sh on a partial PTB" "${CASE}" prepare.log $?
+assert_contains "${CASE}/prepare.log" "::warning::Missing release assets for: Linux (.AppImage.tar) macOS (arm64 .dmg) macOS (x86_64 .dmg)"
+# the workflow always passes published/SHA256SUMS.txt, which does not exist on a
+# release's first run
+run_assemble "${CASE}" "${CASE}/does-not-exist-SHA256SUMS.txt"
+expect_ok "assemble-release-checksums.sh with no published file" "${CASE}" assemble.log $?
+assert_line_count "${CASE}/assets/SHA256SUMS.txt" 1
+printf '%s\nSHA256SUMS.txt\n' "${WINDOWS_ONLY_ASSET}" > "${CASE}/assets.txt"
+run_verify "${CASE}" "${CASE}/assets/SHA256SUMS.txt" "${CASE}/assets.txt"
+expect_ok "verify-release-checksums.sh on the Windows-only PTB" "${CASE}" verify.log $?
+
+#-----------------------------------------------------------------------------
+start_test "a stable release missing a platform is rejected"
+CASE="${WORK_DIR}/partial-stable"
+STABLE_TAG='Mudlet-4.22.0'
+make_assets "${CASE}" \
+  "${STABLE_TAG}-windows-64-installer.exe:c22435c7ff0d36a5dbe5936bcfbbc173f656c2c33583dccbf17a7ad4ade3e350"
+run_prepare "${CASE}" "${STABLE_TAG}" release
+expect_failure "prepare-release-assets.sh on an incomplete stable release" $?
+assert_contains "${CASE}/prepare.log" "::error::Stable release is missing assets for:"
+
+#-----------------------------------------------------------------------------
+start_test "a rebuild counter on this build's own installer is kept"
+# When the tag comes from the Windows re-run itself, the counter is part of that
+# build's own filename and must not make the installer look foreign
+CASE="${WORK_DIR}/own-rebuild"
+REBUILD_TAG='Mudlet-4.22.0-ptb-2026-08-02-dfdcb137'
+make_assets "${CASE}" \
+  "${REBUILD_TAG}rebuild2-windows-64.exe:${REBUILD_WINDOWS_HASH}" \
+  "${REBUILD_TAG}-linux-x64.AppImage.tar:${LINUX_HASH}" \
+  "${REBUILD_TAG}-arm64.dmg:${ARM64_HASH}" \
+  "${REBUILD_TAG}-x86_64.dmg:${INTEL_MAC_HASH}"
+run_prepare "${CASE}" "${REBUILD_TAG}" ptb
+expect_ok "prepare-release-assets.sh" "${CASE}" prepare.log $?
+assert_absent "${CASE}/prepare.log" "::warning::Ignoring"
+if [[ -e "${CASE}/assets/${REBUILD_TAG}rebuild2-windows-64.exe" ]]; then
+  pass "this build's own rebuilt installer was kept"
+else
+  fail "this build's own rebuilt installer was set aside"
+fi
+
+#-----------------------------------------------------------------------------
+start_test "assets are matched to the tag case-insensitively"
+# CI/set-build-info.sh lowercases VERSION, while a pushed git tag keeps its case
+CASE="${WORK_DIR}/tag-case"
+MIXED_CASE_TAG='Mudlet-4.23.0-RC1'
+make_assets "${CASE}" \
+  "mudlet-4.23.0-rc1-windows-64-installer.exe:${WINDOWS_HASH}" \
+  "mudlet-4.23.0-rc1-linux-x64.AppImage.tar:${LINUX_HASH}" \
+  "mudlet-4.23.0-rc1-arm64.dmg:${ARM64_HASH}" \
+  "mudlet-4.23.0-rc1-x86_64.dmg:${INTEL_MAC_HASH}"
+run_prepare "${CASE}" "${MIXED_CASE_TAG}" release
+expect_ok "prepare-release-assets.sh on a mixed-case tag" "${CASE}" prepare.log $?
+assert_absent "${CASE}/prepare.log" "::warning::Ignoring"
+
+#-----------------------------------------------------------------------------
+start_test "merging keeps the freshly built hash when a filename repeats"
+CASE="${WORK_DIR}/rebuilt-same-name"
+make_assets "${CASE}" "${WINDOWS_ASSET}:${REBUILD_WINDOWS_HASH}"
+printf '%s *%s\n' "${WINDOWS_HASH}" "${WINDOWS_ASSET}" > "${CASE}/published-SHA256SUMS.txt"
+run_assemble "${CASE}" "${CASE}/published-SHA256SUMS.txt"
+expect_ok "assemble-release-checksums.sh" "${CASE}" assemble.log $?
+assert_line_count "${CASE}/assets/SHA256SUMS.txt" 1
+assert_contains "${CASE}/assets/SHA256SUMS.txt" "${REBUILD_WINDOWS_HASH}"
+assert_absent "${CASE}/assets/SHA256SUMS.txt" "${WINDOWS_HASH}"
+
+#-----------------------------------------------------------------------------
+start_test "two different hashes for one filename are not resolved by guessing"
+CASE="${WORK_DIR}/conflict"
+mkdir -p "${CASE}/assets"
+printf '%s *%s\n%s *%s\n' "${WINDOWS_HASH}" "${WINDOWS_ASSET}" "${REBUILD_WINDOWS_HASH}" "${WINDOWS_ASSET}" \
+  > "${CASE}/published-SHA256SUMS.txt"
+make_assets "${CASE}" "${LINUX_ASSET}:${LINUX_HASH}"
+run_assemble "${CASE}" "${CASE}/published-SHA256SUMS.txt"
+expect_failure "assemble-release-checksums.sh on conflicting entries" $?
+assert_contains "${CASE}/assemble.log" "::error::Conflicting checksums for ${WINDOWS_ASSET}"
+
+#-----------------------------------------------------------------------------
+start_test "checksum lines survive tabs, CRLF and a missing trailing newline"
+# None of our generators produce these, but each used to turn a cosmetic quirk into
+# a release that could not be published
+CASE="${WORK_DIR}/odd-formatting"
+mkdir -p "${CASE}/assets"
+printf '%s\t%s' "${WINDOWS_HASH}" "${WINDOWS_ASSET}" > "${CASE}/assets/${WINDOWS_ASSET}.sha256"
+printf '%s *%s\r\n' "${LINUX_HASH}" "${LINUX_ASSET}" > "${CASE}/assets/${LINUX_ASSET}.sha256"
+printf '%s  %s' "${ARM64_HASH}" "${ARM64_ASSET}" > "${CASE}/assets/${ARM64_ASSET}.sha256"
+run_assemble "${CASE}" ""
+expect_ok "assemble-release-checksums.sh on oddly formatted sidecars" "${CASE}" assemble.log $?
+assert_line_count "${CASE}/assets/SHA256SUMS.txt" 3
+assert_contains "${CASE}/assets/SHA256SUMS.txt" "${WINDOWS_HASH}  ${WINDOWS_ASSET}"
+assert_contains "${CASE}/assets/SHA256SUMS.txt" "${LINUX_HASH} *${LINUX_ASSET}"
+assert_contains "${CASE}/assets/SHA256SUMS.txt" "${ARM64_HASH}  ${ARM64_ASSET}"
+printf '%s\n%s\n%s\nSHA256SUMS.txt\n' "${WINDOWS_ASSET}" "${LINUX_ASSET}" "${ARM64_ASSET}" > "${CASE}/assets.txt"
+run_verify "${CASE}" "${CASE}/assets/SHA256SUMS.txt" "${CASE}/assets.txt"
+expect_ok "verify-release-checksums.sh on the merged file" "${CASE}" verify.log $?
+
+#-----------------------------------------------------------------------------
+start_test "a sidecar that contributes nothing is an error"
+CASE="${WORK_DIR}/empty-sidecar"
+mkdir -p "${CASE}/assets"
+echo "placeholder" > "${CASE}/assets/${WINDOWS_ASSET}"
+: > "${CASE}/assets/${WINDOWS_ASSET}.sha256"
+run_assemble "${CASE}" ""
+expect_failure "assemble-release-checksums.sh on an empty sidecar" $?
+assert_contains "${CASE}/assemble.log" "contributed no checksum entry"
+
+#-----------------------------------------------------------------------------
+start_test "an unreadable checksum file is reported as such, not as missing entries"
+CASE="${WORK_DIR}/unreadable-sums"
+mkdir -p "${CASE}"
+echo "503 Service Unavailable" > "${CASE}/SHA256SUMS.txt"
+printf '%s\nSHA256SUMS.txt\n' "${WINDOWS_ASSET}" > "${CASE}/assets.txt"
+run_verify "${CASE}" "${CASE}/SHA256SUMS.txt" "${CASE}/assets.txt"
+expect_failure "verify-release-checksums.sh on an unreadable checksum file" $?
+assert_contains "${CASE}/verify.log" "contains no usable checksum entries"
+
+#-----------------------------------------------------------------------------
+start_test "an unrecognised asset type still has to be covered"
+# The gate must not exempt a file just because its suffix is new
+CASE="${WORK_DIR}/new-asset-type"
+mkdir -p "${CASE}"
+printf '%s *%s\n' "${WINDOWS_HASH}" "${WINDOWS_ASSET}" > "${CASE}/SHA256SUMS.txt"
+printf '%s\nMudlet-4.22.0-linux-x64-portable.tar.gz\nSHA256SUMS.txt\n' "${WINDOWS_ASSET}" > "${CASE}/assets.txt"
+run_verify "${CASE}" "${CASE}/SHA256SUMS.txt" "${CASE}/assets.txt"
+expect_failure "verify-release-checksums.sh on an uncovered new asset type" $?
+assert_contains "${CASE}/verify.log" "Mudlet-4.22.0-linux-x64-portable.tar.gz"
+
+#-----------------------------------------------------------------------------
+start_test "no sidecars at all is an error"
+CASE="${WORK_DIR}/no-sidecars"
+mkdir -p "${CASE}/assets"
+run_assemble "${CASE}" ""
+expect_failure "assemble-release-checksums.sh on an empty assets directory" $?
+assert_contains "${CASE}/assemble.log" "::error::No .sha256 checksum files found"
+
+#-----------------------------------------------------------------------------
+echo
+if [[ ${FAILURES} -gt 0 ]]; then
+  echo "${FAILURES} check(s) FAILED"
+  exit 1
+fi
+echo "All checks passed"

From 7bb4d14e8b8fbe851faf49fc73d1f4374816370a Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Mon, 3 Aug 2026 12:30:41 +0200
Subject: [PATCH 064/155] infrastructure: cut PR CI matrix in half and fix
 build flakes (#9618)

#### Brief overview of PR changes/additions
- Drop the two compile-only Ubuntu builds (`ubuntu (x86_64)`, `ubuntu /
clang`) from PR CI. Neither produces an artifact, and across the last
200 PRs neither was ever the sole failing job. Both still run on every
push to development and nightly.
- Build on the `xcb-util-cursor` mirror fallback already on development:
keep its sha256 check, add a third mirror, per-mirror retries, and cache
the built result so the network is not touched at all after the first
run.
- Fix the macOS bundle copy race: globbing directories alongside their
contents made CMake emit a `copy_directory` rule that raced the per-file
bundling rules under Ninja.
- Skip the duplicate functional `ctest` run, and skip builds entirely
for docs-only PRs.

#### Motivation for adding to Mudlet
PR builds were queueing for hours - macOS p90 queue was 148 minutes and
22% of commits took over 2h end to end - because 6 jobs per commit
saturated the ~30-slot concurrency ceiling.

#### Other info (issues closed, discussion etc)
PR CI drops from 6 jobs to 4, roughly halving runner time per commit.
All four outputs are unchanged: 64-bit Linux, Intel macOS, ARM macOS,
64-bit Windows.

`ubuntu / clang` has already been removed from the required status
checks on development; the other four required checks are still produced
by this matrix.

Docs-only skipping is deliberately implemented as a `changes` job plus a
job-level `if:` rather than workflow-level `paths-ignore`, because a
skipped workflow leaves required checks pending forever. It costs a ~20s
hop before builds start on every PR.

**Test case:** CI on this PR shows 4 build jobs instead of 6 (`ubuntu /
gcc / lua tests + leak detection`, both macOS, `windows64`) with no `Run
QTest` step on any of them - confirm they go green and the macOS jobs
still upload artifacts to make.mudlet.org. For the docs-only path, push
a commit touching only a `.md` file and confirm the build jobs report
skipped and the PR stays mergeable.

---------

Signed-off-by: Vadim Peretokin 
Co-authored-by: Vadim Peretokin 
---
 .github/workflows/build-mudlet-pr.yml     | 87 +++++++++++++++++------
 .github/workflows/build-mudlet-win-pr.yml | 31 +++++++-
 .github/workflows/build-mudlet.yml        | 43 ++++++++---
 src/CMakeLists.txt                        |  7 +-
 4 files changed, 137 insertions(+), 31 deletions(-)

diff --git a/.github/workflows/build-mudlet-pr.yml b/.github/workflows/build-mudlet-pr.yml
index 221d3bb7b..7abd33c8b 100644
--- a/.github/workflows/build-mudlet-pr.yml
+++ b/.github/workflows/build-mudlet-pr.yml
@@ -5,10 +5,38 @@ on:
   pull_request:
 
 jobs:
+  changes:
+    name: detect buildable changes
+    runs-on: ubuntu-latest
+    if: ${{ github.repository_owner == 'Mudlet' }}
+    outputs:
+      build: ${{steps.filter.outputs.build}}
+    steps:
+    - name: Check whether anything affecting the build changed
+      id: filter
+      env:
+        GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      run: |
+        # Only genuinely inert paths are listed - CI, CMake and packaging scripts
+        # all affect the build. Anything unexpected falls through to building.
+        files=$(gh api --paginate \
+          "/repos/${{github.repository}}/pulls/${{github.event.pull_request.number}}/files" \
+          -q '.[].filename')
+        echo "Changed files:"
+        printf '%s\n' "$files"
+
+        if printf '%s\n' "$files" | grep -qvE '(^docs/|^\.github/ISSUE_TEMPLATE/|\.md$)'; then
+          echo "build=true" >> "$GITHUB_OUTPUT"
+        else
+          echo "build=false" >> "$GITHUB_OUTPUT"
+          echo "::notice::Documentation-only change - skipping the build matrix"
+        fi
+
   compile-mudlet:
     name: ${{matrix.buildname}}
     runs-on: ${{matrix.os}}
-    if: ${{ github.repository_owner == 'Mudlet' }}
+    needs: changes
+    if: ${{ github.repository_owner == 'Mudlet' && needs.changes.outputs.build == 'true' }}
     concurrency:
       group: ${{github.workflow}}-${{matrix.buildname}}-${{ github.event.pull_request.number || github.ref }}
       cancel-in-progress: ${{ github.event_name == 'pull_request' }}
@@ -22,6 +50,9 @@ jobs:
           # Note: using / in the "buildname" has significance - replacing the
           # ',' in some of the following with a '/' seemed to cause extra
           # spurious steps in the build and broke things! - SlySven
+          # Smaller than build-mudlet.yml's on purpose - only builds that produce
+          # an artifact. 'ubuntu (x86_64)' and 'ubuntu / clang' still run there on
+          # every push to development and nightly.
           # oldest OS supported for maximum compatibility of built AppImage
           - os: ubuntu-22.04
             buildname: 'ubuntu / gcc / lua tests + leak detection'
@@ -33,17 +64,6 @@ jobs:
             # Enable AddressSanitizer for PTB and testing builds, but not release
             # builds (tagged Mudlet-*) - ASAN adds significant runtime overhead
             enable_asan: 'true'
-          - os: ubuntu-22.04
-            # Another try to use GCC12
-            buildname: 'ubuntu (x86_64)'
-            compiler: gcc_64
-            gcc_compiler_version: 12
-            qt: '6.9.0'
-          - os: ubuntu-latest
-            buildname: 'ubuntu / clang'
-            compiler: clang_64
-            gcc_compiler_version: 10
-            qt: '6.9.0'
           - os: macos-15-intel
             buildname: 'macos (x86_64) / c++, lua tests'
             compiler: clang_64
@@ -215,21 +235,37 @@ jobs:
         echo "LUA_PATH=$LUA_PATH" >> $GITHUB_ENV
         echo "LUA_CPATH=$LUA_CPATH" >> $GITHUB_ENV
 
+    - name: (Linux) Cache xcb-util-cursor 0.1.5
+      id: cache-xcb-cursor
+      if: runner.os == 'Linux'
+      uses: actions/cache@v6
+      with:
+        path: ${{runner.workspace}}/xcb-util-cursor-stage
+        key: xcb-util-cursor-0.1.5-${{matrix.os}}-${{runner.arch}}
+
     - name: (Linux) Build xcb-util-cursor 0.1.5
       timeout-minutes: 5
-      if: runner.os == 'Linux'
+      if: runner.os == 'Linux' && steps.cache-xcb-cursor.outputs.cache-hit != 'true'
       run: |
-        # Download and extract xcb-util-cursor 0.1.5
         # This version fixes the off-by-one heap buffer overflow in _XcursorThemeInherits
         # that causes PTB builds to crash with AddressSanitizer
-        # Fall back to the xcb project's dist host: xorg.freedesktop.org served an
-        # expired TLS certificate on 2026-07-28, breaking every CI run
+        # Several mirrors, each retried: xorg.freedesktop.org served an expired
+        # TLS certificate on 2026-07-28, breaking every CI run
         for url in \
           https://xorg.freedesktop.org/archive/individual/lib/xcb-util-cursor-0.1.5.tar.xz \
-          https://xcb.freedesktop.org/dist/xcb-util-cursor-0.1.5.tar.xz; do
-          wget -q --connect-timeout=10 --read-timeout=30 --tries=3 --waitretry=5 -O xcb-util-cursor-0.1.5.tar.xz "$url" && break
-        done || echo "all xcb-util-cursor mirrors failed" >&2
+          https://www.x.org/releases/individual/lib/xcb-util-cursor-0.1.5.tar.xz \
+          https://xcb.freedesktop.org/dist/xcb-util-cursor-0.1.5.tar.xz
+        do
+          for attempt in 1 2 3; do
+            if wget -q --connect-timeout=10 --read-timeout=30 --tries=3 --waitretry=5 -O xcb-util-cursor-0.1.5.tar.xz "$url"; then
+              break 2
+            fi
+            echo "::warning::download attempt $attempt from $url failed, retrying..."
+            sleep $((attempt * 5))
+          done
+        done
         # Checksum from https://lists.x.org/archives/xorg-announce/2023-October/003428.html
+        # also fails the step if every mirror was unreachable
         echo "0caf99b0d60970f81ce41c7ba694e5eaaf833227bb2cbcdb2f6dc9666a663c57  xcb-util-cursor-0.1.5.tar.xz" | sha256sum -c
         tar xf xcb-util-cursor-0.1.5.tar.xz
         cd xcb-util-cursor-0.1.5
@@ -238,8 +274,14 @@ jobs:
         ./configure --prefix=/usr --libdir=/usr/lib/x86_64-linux-gnu
         make -j$(nproc)
 
+        # staged rather than installed directly so the result can be cached
+        make DESTDIR="${{runner.workspace}}/xcb-util-cursor-stage" install
+
+    - name: (Linux) Install xcb-util-cursor 0.1.5
+      if: runner.os == 'Linux'
+      run: |
         # Install system-wide (replaces Ubuntu 22.04's buggy 0.1.1)
-        sudo make install
+        sudo cp -a "${{runner.workspace}}/xcb-util-cursor-stage/." /
 
         # Update library cache so linker finds new version
         sudo ldconfig
@@ -368,13 +410,18 @@ jobs:
       run: ctest --output-on-failure
       env:
         QT_QPA_PLATFORM: offscreen
+        QT_FORCE_STDERR_LOGGING: 1
 
     - name: (macOS) Run C++ tests
       if: runner.os == 'macOS'
       working-directory: '${{runner.workspace}}/b/ninja'
       run: ctest --output-on-failure
+      env:
+        QT_FORCE_STDERR_LOGGING: 1
 
+    # the full ctest run above already covers every functional-labelled test
     - name: Run QTest
+      if: matrix.run_tests != 'true'
       run: ctest --test-dir ${{runner.workspace}}/b/ninja -L functional --output-on-failure
       env:
         QT_FORCE_STDERR_LOGGING: 1
diff --git a/.github/workflows/build-mudlet-win-pr.yml b/.github/workflows/build-mudlet-win-pr.yml
index ea76d448b..b0b6c3fee 100644
--- a/.github/workflows/build-mudlet-win-pr.yml
+++ b/.github/workflows/build-mudlet-win-pr.yml
@@ -9,12 +9,41 @@ permissions:
   id-token: write
   contents: read
   actions: read
+  pull-requests: read
 
 jobs:
+  changes:
+    name: detect buildable changes
+    runs-on: ubuntu-latest
+    if: ${{ github.repository_owner == 'Mudlet' }}
+    outputs:
+      build: ${{steps.filter.outputs.build}}
+    steps:
+    - name: Check whether anything affecting the build changed
+      id: filter
+      env:
+        GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      run: |
+        # Only genuinely inert paths are listed - CI, CMake and packaging scripts
+        # all affect the build. Anything unexpected falls through to building.
+        files=$(gh api --paginate \
+          "/repos/${{github.repository}}/pulls/${{github.event.pull_request.number}}/files" \
+          -q '.[].filename')
+        echo "Changed files:"
+        printf '%s\n' "$files"
+
+        if printf '%s\n' "$files" | grep -qvE '(^docs/|^\.github/ISSUE_TEMPLATE/|\.md$)'; then
+          echo "build=true" >> "$GITHUB_OUTPUT"
+        else
+          echo "build=false" >> "$GITHUB_OUTPUT"
+          echo "::notice::Documentation-only change - skipping the build matrix"
+        fi
+
   compile-mudlet:
     name: ${{matrix.buildname}}
     runs-on: ${{matrix.os}}
-    if: ${{ github.repository_owner == 'Mudlet' }}
+    needs: changes
+    if: ${{ github.repository_owner == 'Mudlet' && needs.changes.outputs.build == 'true' }}
     concurrency:
       group: ${{github.workflow}}-${{matrix.buildname}}-${{ github.event.pull_request.number || github.ref }}
       cancel-in-progress: ${{ github.event_name == 'pull_request' }}
diff --git a/.github/workflows/build-mudlet.yml b/.github/workflows/build-mudlet.yml
index b77b2fc0f..57ca2e868 100644
--- a/.github/workflows/build-mudlet.yml
+++ b/.github/workflows/build-mudlet.yml
@@ -221,21 +221,37 @@ jobs:
         echo "LUA_PATH=$LUA_PATH" >> $GITHUB_ENV
         echo "LUA_CPATH=$LUA_CPATH" >> $GITHUB_ENV
 
+    - name: (Linux) Cache xcb-util-cursor 0.1.5
+      id: cache-xcb-cursor
+      if: runner.os == 'Linux'
+      uses: actions/cache@v6
+      with:
+        path: ${{runner.workspace}}/xcb-util-cursor-stage
+        key: xcb-util-cursor-0.1.5-${{matrix.os}}-${{runner.arch}}
+
     - name: (Linux) Build xcb-util-cursor 0.1.5
       timeout-minutes: 5
-      if: runner.os == 'Linux'
+      if: runner.os == 'Linux' && steps.cache-xcb-cursor.outputs.cache-hit != 'true'
       run: |
-        # Download and extract xcb-util-cursor 0.1.5
         # This version fixes the off-by-one heap buffer overflow in _XcursorThemeInherits
         # that causes PTB builds to crash with AddressSanitizer
-        # Fall back to the xcb project's dist host: xorg.freedesktop.org served an
-        # expired TLS certificate on 2026-07-28, breaking every CI run
+        # Several mirrors, each retried: xorg.freedesktop.org served an expired
+        # TLS certificate on 2026-07-28, breaking every CI run
         for url in \
           https://xorg.freedesktop.org/archive/individual/lib/xcb-util-cursor-0.1.5.tar.xz \
-          https://xcb.freedesktop.org/dist/xcb-util-cursor-0.1.5.tar.xz; do
-          wget -q --connect-timeout=10 --read-timeout=30 --tries=3 --waitretry=5 -O xcb-util-cursor-0.1.5.tar.xz "$url" && break
-        done || echo "all xcb-util-cursor mirrors failed" >&2
+          https://www.x.org/releases/individual/lib/xcb-util-cursor-0.1.5.tar.xz \
+          https://xcb.freedesktop.org/dist/xcb-util-cursor-0.1.5.tar.xz
+        do
+          for attempt in 1 2 3; do
+            if wget -q --connect-timeout=10 --read-timeout=30 --tries=3 --waitretry=5 -O xcb-util-cursor-0.1.5.tar.xz "$url"; then
+              break 2
+            fi
+            echo "::warning::download attempt $attempt from $url failed, retrying..."
+            sleep $((attempt * 5))
+          done
+        done
         # Checksum from https://lists.x.org/archives/xorg-announce/2023-October/003428.html
+        # also fails the step if every mirror was unreachable
         echo "0caf99b0d60970f81ce41c7ba694e5eaaf833227bb2cbcdb2f6dc9666a663c57  xcb-util-cursor-0.1.5.tar.xz" | sha256sum -c
         tar xf xcb-util-cursor-0.1.5.tar.xz
         cd xcb-util-cursor-0.1.5
@@ -244,8 +260,14 @@ jobs:
         ./configure --prefix=/usr --libdir=/usr/lib/x86_64-linux-gnu
         make -j$(nproc)
 
+        # staged rather than installed directly so the result can be cached
+        make DESTDIR="${{runner.workspace}}/xcb-util-cursor-stage" install
+
+    - name: (Linux) Install xcb-util-cursor 0.1.5
+      if: runner.os == 'Linux'
+      run: |
         # Install system-wide (replaces Ubuntu 22.04's buggy 0.1.1)
-        sudo make install
+        sudo cp -a "${{runner.workspace}}/xcb-util-cursor-stage/." /
 
         # Update library cache so linker finds new version
         sudo ldconfig
@@ -374,13 +396,18 @@ jobs:
       run: ctest --output-on-failure
       env:
         QT_QPA_PLATFORM: offscreen
+        QT_FORCE_STDERR_LOGGING: 1
 
     - name: (macOS) Run C++ tests
       if: runner.os == 'macOS'
       working-directory: '${{runner.workspace}}/b/ninja'
       run: ctest --output-on-failure
+      env:
+        QT_FORCE_STDERR_LOGGING: 1
 
+    # the full ctest run above already covers every functional-labelled test
     - name: Run QTest
+      if: matrix.run_tests != 'true'
       run: ctest --test-dir ${{runner.workspace}}/b/ninja -L functional --output-on-failure
       env:
         QT_FORCE_STDERR_LOGGING: 1
diff --git a/src/CMakeLists.txt b/src/CMakeLists.txt
index 0abf192b6..a82ea4244 100644
--- a/src/CMakeLists.txt
+++ b/src/CMakeLists.txt
@@ -887,8 +887,11 @@ if(APPLE)
     endif()
   endif()
 
-  file(GLOB_RECURSE MUDLET_LUA_FILES LIST_DIRECTORIES true "mudlet-lua/*")
-  file(GLOB_RECURSE LUA_TRANSLATIONS LIST_DIRECTORIES true "../translations/lua/*")
+  # LIST_DIRECTORIES must stay false: globbing directories too makes CMake emit a
+  # copy_directory rule that races the per-file bundling rules under Ninja,
+  # failing with "Error copying ...: No such file or directory"
+  file(GLOB_RECURSE MUDLET_LUA_FILES LIST_DIRECTORIES false "mudlet-lua/*")
+  file(GLOB_RECURSE LUA_TRANSLATIONS LIST_DIRECTORIES false "../translations/lua/*")
   file(GLOB DIC_FILES "*.dic")
   file(GLOB AFF_FILES "*.aff")
   target_sources(${EXE_MUDLET_TARGET} PUBLIC ${MUDLET_LUA_FILES} ${LUA_TRANSLATIONS} ${DIC_FILES} ${AFF_FILES} ${ICON_FILE})

From b17c4c37d3cb0e600746765c2ffd1a80e66934e7 Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Mon, 3 Aug 2026 13:39:35 +0200
Subject: [PATCH 065/155] fix: help banners no longer show up in the wrong
 editor section (#9609)

#### Brief overview of PR changes/additions
- Switching editor sections now clears the previous section's help
banner instead of leaving it over the new section
- Clicking X on the "Banner hidden. Undo" toast now just closes the
toast instead of suppressing every banner for that view
- Error/warning messages survive a section switch and are no longer
hidden by a leftover toast expiry timer
- Adds EditorBannerViewSwitchTest covering the repro and undo behaviour

#### Motivation for adding to Mudlet
Dismissing a banner then switching sections could show e.g. timer help
in the scripts section, confusing users.

#### Other info (issues closed, discussion etc)
Assisted-by: Claude:claude-fable-5

**Test case:** Open editor, Scripts, click X on the banner twice, open
Timers, back to Scripts - no stale Timers banner appears.

#### Demo


https://github.com/user-attachments/assets/2b06fc8d-f5cc-4b03-ace1-e157af28ec6d
---
 src/dlgTriggerEditor.cpp                      |  48 ++-
 src/dlgTriggerEditor.h                        |   2 +
 test/functional_tests/CMakeLists.txt          |   1 +
 .../EditorBannerViewSwitchTest.cpp            | 371 ++++++++++++++++++
 4 files changed, 412 insertions(+), 10 deletions(-)
 create mode 100644 test/functional_tests/EditorBannerViewSwitchTest.cpp

diff --git a/src/dlgTriggerEditor.cpp b/src/dlgTriggerEditor.cpp
index 166dcdbba..305c175f3 100644
--- a/src/dlgTriggerEditor.cpp
+++ b/src/dlgTriggerEditor.cpp
@@ -9795,10 +9795,20 @@ void dlgTriggerEditor::changeView(EditorViewType view)
     }
     mCurrentView = view;
 
-    if (mpBannerUndoTimer && mpBannerUndoTimer->isActive()) {
-        mpBannerUndoTimer->stop();
-        mpBannerUndoTimer->deleteLater();
-        mpBannerUndoTimer = nullptr;
+    const bool bannerUndoToastShowing = mpBannerUndoTimer && mpBannerUndoTimer->isActive();
+    cancelBannerUndoTimer();
+
+    // A banner (or the dismissal undo toast) belongs to the view it was shown
+    // in, so hide it on a view change - otherwise it lingers over the new view
+    // when that view's own banner is suppressed. showIntro() will put up the
+    // right banner for the new view if one is allowed. Errors and warnings
+    // (which clear mCurrentBannerKey) are not hidden by this block, though the
+    // pre-existing permanently-hidden check below still can hide them. Using
+    // clearEditorNotification() rather than hideSystemMessageArea() as the
+    // latter would also discard the current script's unacknowledged loading
+    // error.
+    if (bannerUndoToastShowing || !mCurrentBannerKey.isEmpty()) {
+        clearEditorNotification();
     }
 
     if (bannerPermanentlyHidden(mCurrentView)) {
@@ -10127,6 +10137,9 @@ void dlgTriggerEditor::slot_showAliases()
 
 void dlgTriggerEditor::showError(const QString& text)
 {
+    // A still-running undo-toast expiry timer would hide this message when it
+    // fires, so cancel it - the toast's content is gone from the screen anyway
+    cancelBannerUndoTimer();
     mpSystemMessageArea->notificationAreaIconLabelInformation->hide();
     mpSystemMessageArea->notificationAreaIconLabelError->show();
     mpSystemMessageArea->notificationAreaIconLabelWarning->hide();
@@ -10145,6 +10158,9 @@ void dlgTriggerEditor::showError(const QString& text)
 
 void dlgTriggerEditor::showWarning(const QString& text, bool announce)
 {
+    // A still-running undo-toast expiry timer would hide this message when it
+    // fires, so cancel it - the toast's content is gone from the screen anyway
+    cancelBannerUndoTimer();
     mpSystemMessageArea->notificationAreaIconLabelInformation->hide();
     mpSystemMessageArea->notificationAreaIconLabelError->hide();
     mpSystemMessageArea->notificationAreaIconLabelWarning->show();
@@ -14321,6 +14337,16 @@ void dlgTriggerEditor::slot_itemsChanged(EditorViewType viewType, QList aff
 
 void dlgTriggerEditor::handleBannerDismiss()
 {
+    // With no banner on display the close button was pressed on the "Banner
+    // hidden" undo toast itself - just close it instead of treating it as
+    // another banner dismissal (which would suppress the whole view's banners
+    // and stash the toast text as restorable banner content)
+    if (mCurrentBannerKey.isEmpty()) {
+        cancelBannerUndoTimer();
+        hideSystemMessageArea();
+        return;
+    }
+
     mLastDismissedBannerView = mCurrentView;
     mLastDismissedBannerContent = mpSystemMessageArea->notificationAreaMessageBox->text();
     mLastDismissedBannerKey = mCurrentBannerKey;
@@ -14335,12 +14361,18 @@ void dlgTriggerEditor::handleBannerDismiss()
     showBannerUndoToast();
 }
 
-void dlgTriggerEditor::showBannerUndoToast()
+void dlgTriggerEditor::cancelBannerUndoTimer()
 {
     if (mpBannerUndoTimer) {
         mpBannerUndoTimer->stop();
         mpBannerUndoTimer->deleteLater();
+        mpBannerUndoTimer = nullptr;
     }
+}
+
+void dlgTriggerEditor::showBannerUndoToast()
+{
+    cancelBannerUndoTimer();
 
     mCurrentBannerKey.clear();
 
@@ -14402,11 +14434,7 @@ void dlgTriggerEditor::slot_refreshBannerLinkColors()
 
 void dlgTriggerEditor::undoBannerDismiss()
 {
-    if (mpBannerUndoTimer) {
-        mpBannerUndoTimer->stop();
-        mpBannerUndoTimer->deleteLater();
-        mpBannerUndoTimer = nullptr;
-    }
+    cancelBannerUndoTimer();
 
     const QString settingsKey = bannerSettingsKey(mLastDismissedBannerView, mLastDismissedBannerKey);
     if (!settingsKey.isEmpty()) {
diff --git a/src/dlgTriggerEditor.h b/src/dlgTriggerEditor.h
index 50da1bc1a..b1bdad8ec 100644
--- a/src/dlgTriggerEditor.h
+++ b/src/dlgTriggerEditor.h
@@ -107,6 +107,7 @@ class dlgTriggerEditor : public QMainWindow, private Ui::trigger_editor
 
     // Allow QTest-based test class to access private members
     friend class dlgTriggerEditorUndoRedoTest;
+    friend class EditorBannerViewSwitchTest;
 
     enum SearchDataRole {
         // Value is the ID of the item found MUST BE Qt::UserRole to avoid
@@ -795,6 +796,7 @@ private:
 
     // Banner methods
     void handleBannerDismiss();
+    void cancelBannerUndoTimer();
     void showBannerUndoToast();
     void undoBannerDismiss();
     void handlePermanentBannerDismiss();
diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt
index 43db39dd2..1928c2497 100644
--- a/test/functional_tests/CMakeLists.txt
+++ b/test/functional_tests/CMakeLists.txt
@@ -16,6 +16,7 @@ set(FUNCTIONAL_TEST_SOURCES
     TFeedTriggersRecursionTest.cpp
     TriggerSameLineMatchTest.cpp
     dlgTriggerEditorUndoRedoTest.cpp
+    EditorBannerViewSwitchTest.cpp
     TDiscordModeTest.cpp
     MainConsoleSelectionTest.cpp
     EnableDisableByNameTest.cpp
diff --git a/test/functional_tests/EditorBannerViewSwitchTest.cpp b/test/functional_tests/EditorBannerViewSwitchTest.cpp
new file mode 100644
index 000000000..44cea5399
--- /dev/null
+++ b/test/functional_tests/EditorBannerViewSwitchTest.cpp
@@ -0,0 +1,371 @@
+/***************************************************************************
+ *   Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org    *
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the GNU General Public License as published by  *
+ *   the Free Software Foundation; either version 2 of the License, or     *
+ *   (at your option) any later version.                                   *
+ *                                                                         *
+ *   This program is distributed in the hope that it will be useful,       *
+ *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
+ *   GNU General Public License for more details.                          *
+ *                                                                         *
+ *   You should have received a copy of the GNU General Public License     *
+ *   along with this program; if not, write to the                         *
+ *   Free Software Foundation, Inc.,                                       *
+ *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
+ ***************************************************************************/
+
+/*
+ * Regression tests for the editor's dismissible help banners when switching
+ * between editor sections: a dismissed section's suppression must not leave
+ * another section's banner (or the dismissal undo toast) lingering on screen,
+ * the undo toast's close button must only close the toast, undo must restore
+ * the dismissed banner, and error messages must survive a section switch.
+ *
+ * Run with: ctest -R EditorBannerViewSwitchTest -V
+ */
+
+#include 
+#include 
+#include 
+
+#include "Host.h"
+#include "MudletInstanceCoordinator.h"
+#include "TelnetServerStub.h"
+#include "ctelnet.h"
+#include "dlgConnectionProfiles.h"
+#include "dlgSystemMessageArea.h"
+#include "dlgTriggerEditor.h"
+#include "mudlet.h"
+
+using namespace std::chrono_literals;
+
+extern void qInitResources_mudlet();
+extern void qInitResources_qm();
+extern void qInitResources_additional_splash_screens();
+extern void qInitResources_mudlet_fonts_common();
+extern void qInitResources_mudlet_fonts_posix();
+
+static void initializeQRCResources()
+{
+#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN
+    qInitResources_additional_splash_screens();
+#endif
+#ifdef INCLUDE_FONTS
+    qInitResources_mudlet_fonts_common();
+#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD)
+    qInitResources_mudlet_fonts_posix();
+#endif
+#endif
+    qInitResources_mudlet();
+    qInitResources_qm();
+}
+
+class EditorBannerViewSwitchTest : public QObject
+{
+    Q_OBJECT
+
+private:
+    TelnetServerStub* mpServer = nullptr;
+    dlgTriggerEditor* mpEditor = nullptr;
+    Host* mpHost = nullptr;
+    const QString mProfileName = qsl("BannerViewSwitch-Test-Profile");
+    QString mPort;
+    const QString mLocalhost = qsl("localhost");
+
+    void deleteProfileDirectory(const QString& profileName)
+    {
+        const QString path = mudlet::getMudletPath(enums::profileHomePath, profileName);
+        QDir dir(path);
+        if (dir.exists() && !dir.removeRecursively()) {
+            qWarning() << "deleteProfileDirectory: could not remove" << path << "- later failures may stem from this stale state";
+        }
+    }
+
+    // The permanently-hidden banner preferences are stored in QSettings under a
+    // per-profile prefix; wipe this profile's slice so earlier runs cannot bleed
+    // into the assertions (the profile name is unique to this test, so nothing
+    // belonging to a real profile is touched)
+    void clearBannerSettings()
+    {
+        QSettings* settings = mudlet::getQSettings();
+        settings->remove(qsl("Editor/banner_permanently_hidden/profiles/%1").arg(mProfileName));
+    }
+
+    void startProfile(const QString& profileName, const QString& address, const QString& port)
+    {
+        QTimer::singleShot(0ms, qApp, [profileName, address, port]() {
+            mudlet::self()->startAutoLogin({});
+            QTest::qWait(100ms);
+
+            // Guard every UI step so a setup flake names the failing step in
+            // the log instead of surfacing as a generic profile-load timeout
+            dlgConnectionProfiles* connectionDialog = mudlet::self()->mpConnectionDialog;
+            if (!connectionDialog || !connectionDialog->new_profile_button) {
+                qWarning() << "startProfile: connection dialog did not appear";
+                return;
+            }
+            QTest::mouseClick(connectionDialog->new_profile_button, Qt::LeftButton);
+            QTest::qWait(100ms);
+
+            const auto focusedWidget = [](const char* step) -> QWidget* {
+                QWidget* widget = QApplication::focusWidget();
+                if (!widget) {
+                    qWarning() << "startProfile: no focused widget at step" << step;
+                }
+                return widget;
+            };
+
+            QWidget* nameField = focusedWidget("profile name");
+            if (!nameField) {
+                return;
+            }
+            QTest::keyClicks(nameField, profileName);
+            QTest::qWait(100ms);
+            QTest::keyClick(nameField, Qt::Key_Tab);
+            QTest::qWait(100ms);
+
+            QWidget* addressField = focusedWidget("address");
+            if (!addressField) {
+                return;
+            }
+            QTest::keyClicks(addressField, address);
+            QTest::qWait(100ms);
+            QTest::keyClick(addressField, Qt::Key_Tab);
+            QTest::qWait(100ms);
+
+            QWidget* portField = focusedWidget("port");
+            if (!portField) {
+                return;
+            }
+            QTest::keyClicks(portField, port);
+            QTest::qWait(100ms);
+            QTest::keyClick(portField, Qt::Key_Return);
+        });
+
+        QSignalSpy spy(mudlet::self(), &mudlet::signal_profileLoaded);
+        if (!spy.wait(2000)) {
+            QFAIL("Profile took too long to load.");
+        }
+
+        mpHost = mudlet::self()->getActiveHost();
+        if (!mpHost) {
+            QFAIL("No active host available for the test.");
+        }
+
+        QSignalSpy spy2(&(mpHost->mTelnet), &cTelnet::signal_connected);
+        if (!spy2.wait(2000)) {
+            QFAIL("Could not connect with the host.");
+        }
+    }
+
+    QString bannerText() const { return mpEditor->mpSystemMessageArea->notificationAreaMessageBox->text(); }
+
+    void clickBannerCloseButton()
+    {
+        QTest::mouseClick(mpEditor->mpSystemMessageArea->messageAreaCloseButton, Qt::LeftButton);
+        QTest::qWait(50ms);
+    }
+
+private slots:
+    void initTestCase()
+    {
+        initializeQRCResources();
+
+        mpServer = new TelnetServerStub(qApp);
+        mpServer->start(mLocalhost, 0);
+        QVERIFY2(mpServer->isListening(), qPrintable(qsl("TelnetServerStub failed to start: %1").arg(mpServer->errorString())));
+        mPort = QString::number(mpServer->serverPort());
+        mudlet::start();
+        mudlet::self()->setupConfig();
+        mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique("MudletInstanceCoordinator"));
+        mudlet::self()->init();
+        mudlet::self()->setStorePasswordsSecurely(false);
+        clearBannerSettings();
+        deleteProfileDirectory(mProfileName);
+        startProfile(mProfileName, mLocalhost, mPort);
+        // QFAIL inside startProfile() only returns from that helper - bail out
+        // here too or the mpHost dereference below crashes and buries the
+        // recorded diagnostic under a segfault
+        if (QTest::currentTestFailed()) {
+            return;
+        }
+
+        mudlet::self()->slot_showScriptDialog();
+        QTest::qWait(100ms);
+
+        mpEditor = mpHost->mpEditorDialog;
+        QVERIFY2(mpEditor != nullptr, "Editor dialog should be created");
+    }
+
+    void cleanupTestCase()
+    {
+        clearBannerSettings();
+        mpEditor = nullptr;
+        mpHost = nullptr;
+        delete mpServer;
+        mpServer = nullptr;
+        deleteProfileDirectory(mProfileName);
+        delete mudlet::self();
+    }
+
+    // Reset the banner state - in-memory and this profile's persisted
+    // preferences - so each test starts from "nothing dismissed yet"
+    void init()
+    {
+        mpEditor->cancelBannerUndoTimer();
+        mpEditor->mTemporarilyHiddenBanners.clear();
+        mpEditor->mLastDismissedBannerView = EditorViewType::cmUnknownView;
+        mpEditor->mLastDismissedBannerContent.clear();
+        mpEditor->mLastDismissedBannerKey.clear();
+        mpEditor->mCurrentBannerKey.clear();
+        mpEditor->mpSystemMessageArea->hide();
+        clearBannerSettings();
+    }
+
+    // The reported repro: dismiss the Scripts banner (X on the banner, then X
+    // on the "Banner hidden" undo toast), visit Timers, come back to Scripts -
+    // the Timers banner must not linger over the Scripts section
+    void testDismissedBannerDoesNotLeakAcrossViews()
+    {
+        mpEditor->slot_showScripts();
+        QTest::qWait(50ms);
+        QVERIFY2(mpEditor->mpSystemMessageArea->isVisible(), "Scripts banner should show initially");
+        const QString scriptsBanner = bannerText();
+
+        clickBannerCloseButton(); // dismisses the banner, shows the undo toast
+        clickBannerCloseButton(); // closes the undo toast
+
+        mpEditor->slot_showTimers();
+        QTest::qWait(50ms);
+        QVERIFY2(mpEditor->mpSystemMessageArea->isVisible(), "Timers banner should show after switching to Timers");
+        const QString timersBanner = bannerText();
+        QVERIFY2(timersBanner != scriptsBanner, "Timers banner content should differ from the Scripts one");
+
+        mpEditor->slot_showScripts();
+        QTest::qWait(50ms);
+        QVERIFY2(!mpEditor->mpSystemMessageArea->isVisible(),
+                 "The dismissed Scripts banner must stay hidden - and the Timers "
+                 "banner must not linger over the Scripts section");
+    }
+
+    // Same leak, without touching the toast: a single dismissal then switching
+    // views back and forth must not leave the other view's banner behind
+    void testSingleDismissDoesNotLeakAcrossViews()
+    {
+        mpEditor->slot_showScripts();
+        QTest::qWait(50ms);
+        QVERIFY(mpEditor->mpSystemMessageArea->isVisible());
+
+        clickBannerCloseButton();
+
+        mpEditor->slot_showTimers();
+        QTest::qWait(50ms);
+        QVERIFY2(mpEditor->mpSystemMessageArea->isVisible(), "Timers banner should show after switching to Timers");
+        QCOMPARE(mpEditor->mCurrentBannerKey, qsl("intro"));
+
+        mpEditor->slot_showScripts();
+        QTest::qWait(50ms);
+        QVERIFY2(!mpEditor->mpSystemMessageArea->isVisible(), "No banner should show in Scripts after its banner was dismissed");
+    }
+
+    // The X on the undo toast must only close the toast - not register another
+    // dismissal that suppresses the whole view's banners and stashes the toast
+    // text as restorable banner content
+    void testToastCloseButtonJustClosesToast()
+    {
+        mpEditor->slot_showScripts();
+        QTest::qWait(50ms);
+        QVERIFY2(mpEditor->mpSystemMessageArea->isVisible(), "Scripts banner should show initially");
+        const QString scriptsBanner = bannerText();
+
+        clickBannerCloseButton();
+        QVERIFY2(mpEditor->mpSystemMessageArea->isVisible(), "Undo toast should show after dismissing the banner");
+        QVERIFY(bannerText() != scriptsBanner);
+
+        clickBannerCloseButton();
+        QVERIFY2(!mpEditor->mpSystemMessageArea->isVisible(), "Closing the undo toast should hide the message area");
+        QCOMPARE(mpEditor->mLastDismissedBannerKey, qsl("intro"));
+        QCOMPARE(mpEditor->mLastDismissedBannerContent, scriptsBanner);
+        const QString baseKey = mpEditor->bannerSettingsKey(EditorViewType::cmScriptView, QString());
+        QVERIFY2(!mpEditor->mTemporarilyHiddenBanners.contains(baseKey), "Closing the toast must not suppress all banners for the view");
+    }
+
+    // A pending undo toast belongs to the view it was shown in - switching
+    // views must clear it and show the new view's banner instead
+    void testToastHiddenOnViewSwitch()
+    {
+        mpEditor->slot_showScripts();
+        QTest::qWait(50ms);
+        QVERIFY2(mpEditor->mpSystemMessageArea->isVisible(), "Scripts banner should show initially");
+        const QString scriptsBanner = bannerText();
+
+        clickBannerCloseButton();
+        QVERIFY(mpEditor->mpSystemMessageArea->isVisible());
+
+        mpEditor->slot_showTimers();
+        QTest::qWait(50ms);
+        QVERIFY2(mpEditor->mpSystemMessageArea->isVisible(), "Timers banner should show after switching to Timers");
+        QCOMPARE(mpEditor->mCurrentBannerKey, qsl("intro"));
+        QVERIFY2(bannerText() != scriptsBanner, "The Timers banner, not stale Scripts content, should show");
+        QVERIFY2(!bannerText().contains(qsl("href='undo'")), "The undo toast must not linger after a view switch");
+    }
+
+    // Undo after a single dismissal still restores the banner - driven through
+    // the toast's link wiring, not by calling undoBannerDismiss() directly, so
+    // a broken linkActivated connection is caught too
+    void testUndoRestoresBanner()
+    {
+        mpEditor->slot_showScripts();
+        QTest::qWait(50ms);
+        QVERIFY2(mpEditor->mpSystemMessageArea->isVisible(), "Scripts banner should show initially");
+        const QString scriptsBanner = bannerText();
+
+        clickBannerCloseButton();
+        QVERIFY(mpEditor->mpSystemMessageArea->isVisible());
+
+        QMetaObject::invokeMethod(mpEditor->mpSystemMessageArea->notificationAreaMessageBox, "linkActivated", Q_ARG(QString, qsl("undo")));
+        QTest::qWait(50ms);
+        QVERIFY2(mpEditor->mpSystemMessageArea->isVisible(), "Undo should restore the dismissed banner");
+        QCOMPARE(bannerText(), scriptsBanner);
+    }
+
+    // Errors are not banners: they must survive a section switch instead of
+    // being cleared by the new-view banner handling
+    void testErrorSurvivesViewSwitch()
+    {
+        mpEditor->slot_showScripts();
+        QTest::qWait(50ms);
+        const QString errorText = qsl("test error message");
+        mpEditor->showError(errorText);
+        QVERIFY(mpEditor->mpSystemMessageArea->isVisible());
+
+        mpEditor->slot_showTimers();
+        QTest::qWait(50ms);
+        QVERIFY2(mpEditor->mpSystemMessageArea->isVisible(), "An error message must survive a view switch");
+        QCOMPARE(bannerText(), errorText);
+    }
+
+    // An error raised while the undo toast's 5s expiry timer is still running
+    // must survive both the timer and a view switch
+    void testErrorShownDuringToastWindowSurvivesViewSwitch()
+    {
+        mpEditor->slot_showScripts();
+        QTest::qWait(50ms);
+        QVERIFY2(mpEditor->mpSystemMessageArea->isVisible(), "Scripts banner should show initially");
+
+        clickBannerCloseButton(); // toast up, expiry timer running
+        const QString errorText = qsl("error raised during toast");
+        mpEditor->showError(errorText);
+
+        mpEditor->slot_showTimers();
+        QTest::qWait(50ms);
+        QVERIFY2(mpEditor->mpSystemMessageArea->isVisible(), "An error shown while the undo toast timer was live must survive a view switch");
+        QCOMPARE(bannerText(), errorText);
+    }
+};
+
+#include "EditorBannerViewSwitchTest.moc"
+QTEST_MAIN(EditorBannerViewSwitchTest)

From 8c4caeceb54da11104ada8d14b50ff694867ef1e Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Mon, 3 Aug 2026 13:39:57 +0200
Subject: [PATCH 066/155] fix: script error messages are readable in dark mode
 again (#9606)

#### Brief overview of PR changes/additions
- Script error banners in the editor now use the theme's text colour
instead of hardcoded blue, making them readable in dark mode
- Error text returned to scripts via getError() no longer contains HTML
font markup

#### Motivation for adding to Mudlet
Blue-on-dark error text in the editor banner was nearly impossible to
read in dark mode.

#### Other info (issues closed, discussion etc)
Assisted-by: Claude:claude-fable-5

**Test case:** In dark mode, create a trigger with script `+` and save -
the Lua syntax error in the banner is clearly readable (light text on
the dark banner).

#### Demo


https://github.com/user-attachments/assets/ec917ad4-afdf-4dac-a11b-4231e285c007
---
 src/TAlias.cpp          | 2 +-
 src/TLuaInterpreter.cpp | 4 +---
 src/TTrigger.cpp        | 6 +++---
 3 files changed, 5 insertions(+), 7 deletions(-)

diff --git a/src/TAlias.cpp b/src/TAlias.cpp
index 9fc4a3590..708f81267 100644
--- a/src/TAlias.cpp
+++ b/src/TAlias.cpp
@@ -282,7 +282,7 @@ void TAlias::compileRegex()
             TDebug(Qt::white, Qt::red) << "REGEX ERROR: failed to compile, reason:\n" << error << "\n" >> mpHost;
             TDebug(Qt::red, Qt::gray) << TDebug::csmContinue << R"(in: ")" << mRegexCode << "\"\n" >> mpHost;
         }
-        setError(qsl("%1").arg(tr(R"(Error: in "Pattern:", faulty regular expression, reason: "%1".)").arg(error)));
+        setError(qsl("%1").arg(tr(R"(Error: in "Pattern:", faulty regular expression, reason: "%1".)").arg(error)));
     } else {
         pcre2_jit_compile(re.data(), PCRE2_JIT_COMPLETE);
         mOK_init = true;
diff --git a/src/TLuaInterpreter.cpp b/src/TLuaInterpreter.cpp
index 32d973718..ff6ab77b5 100644
--- a/src/TLuaInterpreter.cpp
+++ b/src/TLuaInterpreter.cpp
@@ -3486,9 +3486,7 @@ bool TLuaInterpreter::compile(const QString& code, QString& errorMsg, const QStr
         } else {
             e.append("error object is a ").append(luaL_typename(L, -1)).append(" value");
         }
-        errorMsg = "";
-        errorMsg.append(QString::fromStdString(e).toHtmlEscaped().toUtf8());
-        errorMsg.append("");
+        errorMsg = qsl("%1").arg(QString::fromStdString(e).toHtmlEscaped());
         if (mudlet::smDebugMode) {
             auto& host = getHostFromLua(L);
             TDebug(Qt::white, Qt::red) << "\n " << e.c_str() << "\n" >> &host;
diff --git a/src/TTrigger.cpp b/src/TTrigger.cpp
index 8ffe630fd..87d8a4a43 100644
--- a/src/TTrigger.cpp
+++ b/src/TTrigger.cpp
@@ -146,7 +146,7 @@ bool TTrigger::setRegexCodeList(QStringList patterns, QList patternKinds, b
                         TDebug(Qt::white, Qt::red) << "REGEX ERROR: failed to compile, reason:\n" << error << "\n" >> mpHost;
                         TDebug(Qt::red, Qt::gray) << TDebug::csmContinue << R"(in: ")" << regexp.constData() << "\"\n" >> mpHost;
                     }
-                    setError(qsl("%1")
+                    setError(qsl("%1")
                                      .arg(tr(R"(Error: in item %1, perl regex "%2" failed to compile, reason: "%3".)")
                                                   .arg(QString::number(i + 1), QString(regexp.constData()).toHtmlEscaped(), QString(error).toHtmlEscaped())));
                     state = false;
@@ -168,7 +168,7 @@ bool TTrigger::setRegexCodeList(QStringList patterns, QList patternKinds, b
                 const QString code = qsl("function %1() %2\nend").arg(funcName.c_str(), patterns[i]);
                 QString error;
                 if (!mpLua->compile(code, error, QString::fromStdString(funcName))) {
-                    setError(qsl("%1")
+                    setError(qsl("%1")
                                      .arg(tr(R"(Error: in item %1, lua function "%2" failed to compile, reason: "%3".)").arg(QString::number(i + 1), patterns.at(i).toHtmlEscaped(), QString(error))));
                     state = false;
                     if (mudlet::smDebugMode) {
@@ -187,7 +187,7 @@ bool TTrigger::setRegexCodeList(QStringList patterns, QList patternKinds, b
                 TTrigger::decodeColorPatternText(patterns.at(i), textAnsiFg, textAnsiBg);
 
                 if (textAnsiBg == scmIgnored && textAnsiFg == scmIgnored) {
-                    setError(qsl("%1")
+                    setError(qsl("%1")
                                      .arg(tr("Error: in item %1, no colors to match were set - at least one of the foreground or background must not be ignored.")
                                                   .arg(QString::number(i + 1))));
                     state = false;

From dcfc181f3a82a1660e676bd002934aea9a395415 Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Mon, 3 Aug 2026 13:42:14 +0200
Subject: [PATCH 067/155] fix: crash when closing Mudlet while an update is
 available (#9604)

#### Brief overview of PR changes/additions
- The updater's dialog is now destroyed when the application quits (on
`aboutToQuit`), instead of in `~Updater`, which only runs deep inside
the application's own destructor - too late to delete a QWidget
- That late deletion is what crashed Windows PTBs with
`STATUS_HEAP_CORRUPTION` at close whenever an update dialog existed
(Sentry MUDLET-4D, escalating since the 2026-07-30 PTB)
- New `UpdaterTeardownTest` pins the timing from both sides: the dialog
must still be alive when the last window closes (preserving #9388's
offer-update-on-exit behaviour) and gone before the application object
is destroyed (verified to fail without the fix)

#### Motivation for adding to Mudlet
Stops a crash-on-exit that every Windows PTB user with a pending update
currently hits.

#### Other info (issues closed, discussion etc)
Fixes #9122

**Test case:** run `UpdaterTeardownTest` via ctest; or on Windows, run a
PTB with a pending update and close Mudlet - no crash dialog appears.

Assisted-by: Claude:claude-fable-5
Signed-off-by: Vadim Peretokin 
---
 src/updater.cpp                               |  22 ++--
 src/updater.h                                 |   7 +-
 test/functional_tests/CMakeLists.txt          |   6 +
 test/functional_tests/UpdaterTeardownTest.cpp | 122 ++++++++++++++++++
 4 files changed, 146 insertions(+), 11 deletions(-)
 create mode 100644 test/functional_tests/UpdaterTeardownTest.cpp

diff --git a/src/updater.cpp b/src/updater.cpp
index cc741ea26..48e2f7969 100644
--- a/src/updater.cpp
+++ b/src/updater.cpp
@@ -22,6 +22,7 @@
 #include "updater/Feed.h"
 #include "updater/UpdateDialog.h"
 
+#include 
 #include 
 #include 
 #include 
@@ -89,19 +90,24 @@ Updater::Updater(QObject* parent, QSettings* settings, bool testVersion)
     feed.reset(new dblsqd::Feed(this));
     feed->setRepo(qsl("Mudlet"), qsl("Mudlet"), testVersion);
     mPeriodicCheck = std::make_unique();
-}
 
-Updater::~Updater()
-{
 #if !defined(Q_OS_MACOS)
-    // QPointer::data() returns null if Qt already deleted the dialog; only
-    // delete if it hasn't been cleaned up yet.
-    if (updateDialog) {
-        delete updateDialog;
-    }
+    // The update dialog must not be deleted in ~Updater: this Updater is
+    // parented to the application object (so it can offer an update after the
+    // last window closes, #9388), which means ~Updater only runs inside the
+    // application's own destructor - after ~QApplication has torn down all
+    // widget infrastructure. Deleting a QWidget that late corrupts the heap on
+    // Windows (#9122). aboutToQuit fires as the event loop exits, after the
+    // dialog's last-window-closed flow has finished but while the application
+    // is still fully alive, so destroy it there instead.
+    connect(QCoreApplication::instance(), &QCoreApplication::aboutToQuit, this, [this]() {
+        delete updateDialog.data();
+    });
 #endif
 }
 
+Updater::~Updater() = default;
+
 void Updater::checkUpdatesOnStart()
 {
 #if defined(Q_OS_MACOS)
diff --git a/src/updater.h b/src/updater.h
index 285d4a148..815bb4aff 100644
--- a/src/updater.h
+++ b/src/updater.h
@@ -61,9 +61,10 @@ public:
 
 private:
     std::unique_ptr feed;
-    // Non-owning: Qt parent-child system or explicit deletion in ~Updater handles lifetime.
-    // QPointer is used so that if Qt deletes the dialog (e.g. on last window closed),
-    // the pointer automatically becomes null and ~Updater's delete becomes a no-op.
+    // Owned, but deleted on QCoreApplication::aboutToQuit rather than in
+    // ~Updater: the Updater is parented to the application object, so its
+    // destructor runs during application teardown - too late to destroy a
+    // QWidget (#9122). QPointer nulls itself once the dialog is destroyed.
     QPointer updateDialog;
 #if !defined(Q_OS_MACOS)
     QPushButton* mpInstallOrRestart;
diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt
index 1928c2497..346d29851 100644
--- a/test/functional_tests/CMakeLists.txt
+++ b/test/functional_tests/CMakeLists.txt
@@ -40,6 +40,12 @@ set(FUNCTIONAL_TEST_SOURCES
     TMediaLoopTest.cpp
 )
 
+# The updater sources are only built with USE_UPDATER, and on macOS the
+# Updater wraps Sparkle instead of creating an UpdateDialog
+if(USE_UPDATER AND NOT APPLE)
+    list(APPEND FUNCTIONAL_TEST_SOURCES UpdaterTeardownTest.cpp)
+endif()
+
 set(FUNCTIONAL_TEST_UTILS
     TelnetServerStub.cpp
     DiscordIpcServerStub.cpp
diff --git a/test/functional_tests/UpdaterTeardownTest.cpp b/test/functional_tests/UpdaterTeardownTest.cpp
new file mode 100644
index 000000000..55d779be0
--- /dev/null
+++ b/test/functional_tests/UpdaterTeardownTest.cpp
@@ -0,0 +1,122 @@
+/***************************************************************************
+ *   Copyright (C) 2026 by Vadim Peretokin - vperetokin@mudlet.org         *
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the GNU General Public License as published by  *
+ *   the Free Software Foundation; either version 2 of the License, or     *
+ *   (at your option) any later version.                                   *
+ *                                                                         *
+ *   This program is distributed in the hope that it will be useful,       *
+ *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
+ *   GNU General Public License for more details.                          *
+ *                                                                         *
+ *   You should have received a copy of the GNU General Public License     *
+ *   along with this program; if not, write to the                         *
+ *   Free Software Foundation, Inc.,                                       *
+ *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
+ ***************************************************************************/
+
+#include "updater.h"
+#include "updater/UpdateDialog.h"
+#include "utils.h"
+
+#include 
+
+#include 
+#include 
+#include 
+#include 
+#include 
+#include 
+#include 
+
+#include 
+
+/*
+ * Regression test for https://github.com/Mudlet/Mudlet/issues/9122:
+ * STATUS_HEAP_CORRUPTION at application close on Windows.
+ *
+ * The Updater is parented to the application object (#9388) and used to delete
+ * its unparented top-level UpdateDialog in ~Updater. That destructor only runs
+ * inside the application's own destructor - after ~QApplication has torn down
+ * all widget infrastructure - and deleting a QWidget that late corrupts the
+ * heap. The dialog must instead be destroyed on aboutToQuit, while the
+ * application is still fully alive.
+ *
+ * The timing is pinned from both sides: the dialog must still be alive when
+ * the last window closes (its purpose is to offer an update at exactly that
+ * point, #9388), and must be gone once the event loop has exited. Note that
+ * with no update to offer the dialog's own last-window-closed handler calls
+ * quit(), which in Qt 6 emits aboutToQuit synchronously - so the dialog is
+ * destroyed inside that cascade, before close() even returns.
+ *
+ * QTEST_APPLESS_MAIN is used because the test itself must own the
+ * QApplication lifetime to walk it through quit and destruction.
+ */
+class UpdaterTeardownTest : public QObject
+{
+    Q_OBJECT
+
+private slots:
+    void updateDialogDestroyedBeforeApplicationTeardown();
+};
+
+void UpdaterTeardownTest::updateDialogDestroyedBeforeApplicationTeardown()
+{
+    // Keeps checkUpdatesOnStart() away from real user data - on Windows it
+    // deletes stale installer files from the genuine GenericDataLocation
+    QStandardPaths::setTestModeEnabled(true);
+
+    QTemporaryDir settingsDir;
+    QVERIFY(settingsDir.isValid());
+    QSettings settings(settingsDir.filePath(qsl("updater-test.ini")), QSettings::IniFormat);
+
+    int argc = 1;
+    char appName[] = "UpdaterTeardownTest";
+    char* argv[] = {appName, nullptr};
+    const auto app = std::make_unique(argc, argv);
+
+    auto* updater = new Updater(app.get(), &settings);
+
+    // Connected before checkUpdatesOnStart() creates the dialog, so with
+    // direct connections firing in connection order this probe runs before
+    // the dialog's own last-window-closed handler - the last moment the
+    // dialog is guaranteed to exist, as that handler quits when there is no
+    // update to offer and the quit destroys the dialog
+    QPointer dialog;
+    bool dialogAliveAtLastWindowClosed = false;
+    connect(app.get(), &QGuiApplication::lastWindowClosed, this, [&dialog, &dialogAliveAtLastWindowClosed]() {
+        dialogAliveAtLastWindowClosed = !dialog.isNull();
+    });
+
+    // Also fires the feed's update check; the request is torn down with the
+    // application before any response arrives and nothing below depends on it
+    updater->checkUpdatesOnStart();
+
+    const auto topLevels = QApplication::topLevelWidgets();
+    for (auto* widget : topLevels) {
+        if ((dialog = qobject_cast(widget))) {
+            break;
+        }
+    }
+    QVERIFY2(dialog, "expected the Updater to have created its UpdateDialog");
+
+    auto* window = new QWidget;
+    window->show();
+    QTimer::singleShot(0, app.get(), [&window]() {
+        window->close();
+        delete window;
+        // The dialog's own last-window-closed handler quits when no update is
+        // available; quit explicitly so the test cannot hang if an update is
+        // available (the dialog then shows itself and waits for the user)
+        QCoreApplication::quit();
+    });
+    app->exec();
+
+    QVERIFY2(dialogAliveAtLastWindowClosed, "the UpdateDialog must still be alive when the last window closes so it can offer an update at that point - see #9388");
+    QVERIFY2(dialog.isNull(), "UpdateDialog must be destroyed when the application quits: deleting it any later (from ~Updater, inside the application's destructor) corrupts the heap - see #9122");
+}
+
+QTEST_APPLESS_MAIN(UpdaterTeardownTest)
+#include "UpdaterTeardownTest.moc"

From 295b0002316917ea54ce23737558ac0935cba1ad Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Mon, 3 Aug 2026 14:10:57 +0200
Subject: [PATCH 068/155] improve: make the New profile button show what it did
 (#9607)

#### Brief overview of PR changes/additions
- Clicking New now shows the new profile at the top of the list with an
icon, selected and scrolled into view
- The profile selection window no longer grows a little every time it
switches views
- Skipping the tutorial invitation no longer triggers a needless window
resize

#### Motivation for adding to Mudlet
New users clicking New saw the window resize and nothing else happen,
leaving them unable to add a game manually.

#### Other info (issues closed, discussion etc)
Assisted-by: Claude:claude-fable-5

**Test case:** Open the profile selector, click New - a highlighted "new
profile name" entry appears at the top with the name field focused, and
the window size does not change.

#### Demo


https://github.com/user-attachments/assets/5789738a-52fb-492d-89d4-b68cb0f36aff
---
 src/dlgConnectionProfiles.cpp | 22 +++++++++++++++-------
 1 file changed, 15 insertions(+), 7 deletions(-)

diff --git a/src/dlgConnectionProfiles.cpp b/src/dlgConnectionProfiles.cpp
index 19cf3d2ce..ee42406e2 100644
--- a/src/dlgConnectionProfiles.cpp
+++ b/src/dlgConnectionProfiles.cpp
@@ -383,6 +383,11 @@ dlgConnectionProfiles::~dlgConnectionProfiles()
 void dlgConnectionProfiles::dismissTutorialInvitation()
 {
     mTutorialDismissed = true;
+    if (!widget_topLeft->isHidden()) {
+        // the invitation is not up, so there is nothing to restore - and the
+        // resize below would make the dialog jump in size for no reason
+        return;
+    }
     widget_topLeft->show();
     welcome_message->hide();
     tabWidget_connectionInfo->show();
@@ -932,15 +937,16 @@ void dlgConnectionProfiles::slot_addProfile()
         return;
     }
     setItemName(pItem, newname);
+    // without an icon the item is an invisible blank in the list
+    pItem->setIcon(customIcon(newname, std::nullopt));
 
-    listWidget_profiles->addItem(pItem);
-
-    // insert newest entry on top of the list as the general sorting
-    // is always newest item first -> fillout->form() filters
-    // this is more practical for the user as they use the same profile most of the time
+    // insert the new entry at the top of the list - appending would bury it
+    // at the bottom, below all the predefined games
+    listWidget_profiles->insertItem(0, pItem);
 
     // As we are using QAbstractItemView::SingleSelection this will
-    // automatically unselect the previous item:
+    // automatically unselect the previous item, and auto-scroll brings the
+    // new item into view:
     listWidget_profiles->setCurrentItem(pItem);
 
     profile_name_entry->setText(newname);
@@ -1374,9 +1380,11 @@ void dlgConnectionProfiles::fillout_form()
         if (!mDialogHeightBeforeShrink || welcome_message->isHidden()) {
             mDialogHeightBeforeShrink = height();
         }
-        welcome_message->show();
+        // hide before show: with both visible for a moment the layout grows
+        // the dialog to fit them together and it never shrinks back
         tabWidget_connectionInfo->hide();
         informationArea->hide();
+        welcome_message->show();
     } else {
         welcome_message->hide();
 

From 37d32f849bc400a13bcfe016d9b57b474f7188b4 Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Tue, 4 Aug 2026 10:08:20 +0200
Subject: [PATCH 069/155] fix: crash when opening settings on macOS (#9625)

#### Brief overview of PR changes/additions
- On macOS the `Updater` only creates its Sparkle wrapper in
`checkUpdatesOnStart()`, but the preferences dialog asks it about
automatic updates in its constructor - null dereference. All three
Sparkle-backed accessors are now guarded by a new `Updater::ready()`.
- The preferences hide the updates group box while the platform updater
isn't set up, rather than showing a checkbox that stores nothing.
- `DialogTeardownTest` gains a case that opens the preferences with
`DEV_UPDATER` set, which is what puts a development build on the
release-build update path where the crash lives.

#### Motivation for adding to Mudlet
Development builds skip the branch entirely, so the crash only appears
in PTB and release builds - where opening settings is a normal thing to
do.

#### Other info (issues closed, discussion etc)
It took out today's PTB: both macOS jobs segfaulted in
`DialogTeardownTest`, which failed the Linux/macOS build workflow, so
`create-github-release` never ran for it and [the
release](https://github.com/Mudlet/Mudlet/releases/tag/Mudlet-4.22.0-ptb-2026-08-04-295b0002)
got only the Windows installer - the Linux AppImage had built fine.

**Test case:** the macOS CI jobs here are the proof - they crash without
this change. Locally: `ctest -R DialogTeardownTest`.

Assisted-by: Claude:claude-opus-5
---
 src/dlgProfilePreferences.cpp                |  4 ++
 src/updater.cpp                              | 22 ++++++++++
 src/updater.h                                |  5 ++-
 test/functional_tests/DialogTeardownTest.cpp | 46 ++++++++++++++++++++
 4 files changed, 76 insertions(+), 1 deletion(-)

diff --git a/src/dlgProfilePreferences.cpp b/src/dlgProfilePreferences.cpp
index e3910ae89..235c7fa49 100644
--- a/src/dlgProfilePreferences.cpp
+++ b/src/dlgProfilePreferences.cpp
@@ -217,6 +217,10 @@ dlgProfilePreferences::dlgProfilePreferences(QWidget* pParentWidget, Host* pHost
         checkbox_noAutomaticUpdates->setChecked(true);
         checkbox_noAutomaticUpdates->setDisabled(true);
         checkbox_noAutomaticUpdates->setToolTip(utils::richText(tr("Automatic updates are disabled in development builds to prevent an update from overwriting your Mudlet.")));
+    } else if (!pMudlet->pUpdater->ready()) {
+        // Nothing to show a setting for until the platform updater is set up,
+        // and a checkbox that silently does nothing is worse than no checkbox
+        groupBox_updates->hide();
     } else {
         checkbox_noAutomaticUpdates->setChecked(!pMudlet->pUpdater->updateAutomatically());
         // This is the extra connect(...) relating to settings' changes saved by
diff --git a/src/updater.cpp b/src/updater.cpp
index 48e2f7969..0fc36ab01 100644
--- a/src/updater.cpp
+++ b/src/updater.cpp
@@ -144,9 +144,25 @@ void Updater::checkUpdatesOnStart()
     mPeriodicCheck->start();
 }
 
+// Whether the platform updater is set up and can answer for itself. On macOS
+// that only happens in checkUpdatesOnStart(), so anything reaching the Updater
+// before then - the preferences dialog above all - has to ask first. Elsewhere
+// the automatic-update flag lives in QSettings and is readable straight away.
+bool Updater::ready() const
+{
+#if defined(Q_OS_MACOS)
+    return msparkleUpdater != nullptr;
+#else
+    return true;
+#endif
+}
+
 void Updater::setAutomaticUpdates(const bool state)
 {
 #if defined(Q_OS_MACOS)
+    if (!ready()) {
+        return;
+    }
     msparkleUpdater->setAutomaticallyDownloadsUpdates(state);
 #else
     dblsqd::UpdateDialog::enableAutoDownload(state, mSettings);
@@ -159,6 +175,9 @@ void Updater::setAutomaticUpdates(const bool state)
 bool Updater::updateAutomatically() const
 {
 #if defined(Q_OS_MACOS)
+    if (!ready()) {
+        return false;
+    }
     return msparkleUpdater->automaticallyDownloadsUpdates();
 #else
     return dblsqd::UpdateDialog::autoDownloadEnabled(true, mSettings);
@@ -168,6 +187,9 @@ bool Updater::updateAutomatically() const
 void Updater::manuallyCheckUpdates()
 {
 #if defined(Q_OS_MACOS)
+    if (!ready()) {
+        return;
+    }
     msparkleUpdater->checkForUpdates();
 #else
     if (mManualCheckInProgress) {
diff --git a/src/updater.h b/src/updater.h
index 815bb4aff..37dfb4631 100644
--- a/src/updater.h
+++ b/src/updater.h
@@ -58,6 +58,7 @@ public:
     void setAutomaticUpdates(bool state);
     bool updateAutomatically() const;
     bool shouldShowChangelog();
+    bool ready() const;
 
 private:
     std::unique_ptr feed;
@@ -101,7 +102,9 @@ private:
 #elif defined(Q_OS_WINDOWS)
     QString mDownloadedInstallerPath;
 #elif defined(Q_OS_MACOS)
-    SparkleUpdater* msparkleUpdater;
+    // Only exists once checkUpdatesOnStart() has run - every use must cope with
+    // it still being null, see ready()
+    SparkleUpdater* msparkleUpdater = nullptr;
 #endif
 
 
diff --git a/test/functional_tests/DialogTeardownTest.cpp b/test/functional_tests/DialogTeardownTest.cpp
index 1c7f652eb..7d56607f5 100644
--- a/test/functional_tests/DialogTeardownTest.cpp
+++ b/test/functional_tests/DialogTeardownTest.cpp
@@ -42,6 +42,7 @@
 
 #include 
 #include 
+#include 
 
 #include "Host.h"
 #include "MudletInstanceCoordinator.h"
@@ -51,6 +52,9 @@
 #include "dlgProfilePreferences.h"
 #include "dlgTriggerEditor.h"
 #include "mudlet.h"
+#if defined(INCLUDE_UPDATER)
+#include "updater.h"
+#endif
 
 using namespace std::chrono_literals;
 
@@ -246,6 +250,48 @@ private slots:
         QCOMPARE(mpHost->getMMCPChatName(), chatNameBefore);
     }
 
+    // Opening the preferences at all used to be enough to end the run: the
+    // dialog asks the updater whether it downloads updates by itself, which on
+    // macOS reaches into Sparkle - and Sparkle is only created by
+    // checkUpdatesOnStart(), which no test calls. Development builds skip that
+    // whole branch, so only PTB and release builds ever crashed and CI stayed
+    // green until the nightly PTB. DEV_UPDATER puts this build on the same path.
+    void test_preferencesOpensBeforeTheUpdaterIsSetUp()
+    {
+        qputenv("DEV_UPDATER", "1");
+        auto restoreEnvironment = qScopeGuard([]() {
+            qunsetenv("DEV_UPDATER");
+        });
+
+        mudlet::self()->showOptionsDialog(qsl("tab_specialOptions"), mpHost);
+        QTest::qWait(100ms);
+        auto* preferences = mpHost->mpDlgProfilePreferences.data();
+        QVERIFY2(preferences, "Preferences dialog was not created");
+
+#if defined(INCLUDE_UPDATER)
+        auto* updater = mudlet::self()->pUpdater;
+        QVERIFY2(updater, "An updater-enabled build has no updater");
+        // the dev-build branch disables the checkbox and touches no updater, so
+        // this is what says the test is on the crashing path at all
+        QVERIFY2(preferences->checkbox_noAutomaticUpdates->isEnabled(), "DEV_UPDATER no longer moves a development build onto the release update path - this test covers nothing now");
+        // isHidden() rather than isVisible(): the group box sits on a tab page,
+        // and only an explicit hide() should count here
+        QCOMPARE(preferences->groupBox_updates->isHidden(), !updater->ready());
+
+        if (!updater->ready()) {
+            // the accessors the dialog and the Help menu reach for have to be
+            // safe to call in this state, not merely avoidable
+            QVERIFY2(!updater->updateAutomatically(), "An updater with no platform updater claimed it auto-updates");
+            updater->setAutomaticUpdates(true);
+            updater->manuallyCheckUpdates();
+            QVERIFY2(!updater->updateAutomatically(), "An updater with no platform updater took a setting it cannot store");
+        }
+#endif
+
+        delete preferences;
+        QVERIFY2(mpHost->mpDlgProfilePreferences.isNull(), "Preferences dialog should have been destroyed");
+    }
+
     // ...and through the editor, where the item name field is connected to
     // slot_saveProperty_TriggerName(). The editor is a QMainWindow rather than a
     // QDialog, which makes no difference: it hides itself on the way down too

From f70414eee224bf1b6ec2eeba5c8bb39e74404fd9 Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Tue, 4 Aug 2026 10:09:45 +0200
Subject: [PATCH 070/155] fix: killTrigger and killAlias report failure when
 the item is already dead (#9620)

#### Brief overview of PR changes/additions
- `killTrigger()`, `killAlias()` and `killKey()` return `false` for an
already dead item, using the same cleanup-set membership predicate
`killTimer()` does (answers the same way at cleanup depth 0 and from
inside a script). `killKey()` was not named in the original review but
had the identical defect. As with timers, a temporary trigger that has
used up its last firing is dead and reports so.
- `killTrigger()` now deactivates the trigger it kills, as `killAlias()`
and `killKey()` already did - until cleanup runs, the corpse is still in
the list the current line's pass is walking, so a trigger killed by an
earlier trigger on the same line went on to fire. Its lookup walk also
moves to `equal_range()` (as `enableTrigger()` did in #9366) and skips a
corpse instead of giving up on the name.
- Specs added to the existing kill coverage in `Trigger_spec`,
`Alias_spec` and `KeyBinds_spec`, including the in-callback double kill
the `killTimer` specs pinned. (A key press cannot be synthesised
headlessly, so keys have no in-callback counterpart.)

#### Motivation for adding to Mudlet
`killTimer()` learned to report an already dead timer in #9597 (fixing
#9581), and review flagged that its siblings share the defect: a killed
temporary item is only unlinked once the deferred `doCleanup()` frees
it, which cannot happen while a script of that unit is on the call
stack, so the corpse stayed findable and a second kill claimed success.

#### Other info (issues closed, discussion etc)
Follows the contract and predicate established in #9597/#9581; the
`equal_range()` walk mirrors #9366.
**Test case:** busted suite 1827 successes / 0 failures / 0 errors / 17
pending (HTTP fixture), twice; the 7 new specs all fail against the
unfixed binary (1820/7) - the second kill returning `true`, a killed
trigger still reported active and still firing.

Assisted-by: Claude:claude-opus-5
---
 src/AliasUnit.cpp                      |  8 +++
 src/KeyUnit.cpp                        |  8 +++
 src/TriggerUnit.cpp                    | 31 ++++++++---
 src/mudlet-lua/lua/CoreMudlet.lua      | 11 +++-
 src/mudlet-lua/tests/Alias_spec.lua    | 31 +++++++++++
 src/mudlet-lua/tests/KeyBinds_spec.lua | 18 +++++++
 src/mudlet-lua/tests/Trigger_spec.lua  | 71 ++++++++++++++++++++++++++
 7 files changed, 169 insertions(+), 9 deletions(-)

diff --git a/src/AliasUnit.cpp b/src/AliasUnit.cpp
index 4fc960117..5e3879e9c 100644
--- a/src/AliasUnit.cpp
+++ b/src/AliasUnit.cpp
@@ -385,6 +385,14 @@ bool AliasUnit::killAlias(const QString& name)
             if (!alias->isTemporary()) {
                 return false;
             }
+            // An already killed alias is only unlinked from this list once
+            // doCleanup() gets to free it, which cannot happen while an alias
+            // script is on the call stack - so until then it is still findable by
+            // name. Killing it a second time achieves nothing and must be reported
+            // as the failure it is:
+            if (mCleanupSet.contains(alias)) {
+                return false;
+            }
             alias->setIsActive(false);
             markCleanup(alias);
             return true;
diff --git a/src/KeyUnit.cpp b/src/KeyUnit.cpp
index cabcf81ae..86c940fd4 100644
--- a/src/KeyUnit.cpp
+++ b/src/KeyUnit.cpp
@@ -233,6 +233,14 @@ bool KeyUnit::killKey(QString& name)
             if (!pChild->isTemporary()) {
                 return false;
             }
+            // An already killed key is only unlinked from this list once
+            // doCleanup() gets to free it, which cannot happen while a key script
+            // is on the call stack - so until then it is still findable by name.
+            // Killing it a second time achieves nothing and must be reported as
+            // the failure it is:
+            if (mCleanupSet.contains(pChild)) {
+                return false;
+            }
             pChild->setIsActive(false);
             markCleanup(pChild);
             return true;
diff --git a/src/TriggerUnit.cpp b/src/TriggerUnit.cpp
index 599dd2f68..be75654f7 100644
--- a/src/TriggerUnit.cpp
+++ b/src/TriggerUnit.cpp
@@ -458,16 +458,31 @@ void TriggerUnit::setTriggerStayOpen(const QString& name, int lines)
 
 bool TriggerUnit::killTrigger(const QString& name)
 {
-    auto it = mLookupTable.constFind(name);
-    while (it != mLookupTable.cend() && it.key() == name) {
+    // equal_range visits every same-named trigger; constFind() + (++it) can
+    // start mid-run and skip duplicates on some QMultiMap implementations
+    const auto [begin, end] = mLookupTable.equal_range(name);
+    for (auto it = begin; it != end; ++it) {
         TTrigger* pT = it.value();
-        if (pT->isTemporary()) //this function is only defined for tempTriggers, permanent objects cannot be removed
-        {
-            // there can only be a single tempTrigger by this name and this function ignores non-tempTriggers by definition
-            markCleanup(pT);
-            return true;
+        if (!pT->isTemporary()) {
+            // this function is only defined for tempTriggers, permanent objects cannot be removed
+            continue;
         }
-        it++;
+        // An already killed trigger is only unlinked from the lookup table once
+        // doCleanup() gets to free it, which cannot happen while a trigger script
+        // is on the call stack - so until then it is still findable by name.
+        // tempComplexRegexTrigger() replaces a temporary trigger under the name it
+        // was given, so a corpse and a live trigger can share one: keep looking
+        // rather than report a kill that would achieve nothing.
+        if (mCleanupSet.contains(pT)) {
+            continue;
+        }
+        // Deactivating matters as much as queueing the delete: the trigger stays
+        // in the list processDataStream() is walking until that deferred cleanup,
+        // and a killed trigger must no more fire on the rest of the line than a
+        // disabled one does
+        pT->setIsActive(false);
+        markCleanup(pT);
+        return true;
     }
     return false;
 }
diff --git a/src/mudlet-lua/lua/CoreMudlet.lua b/src/mudlet-lua/lua/CoreMudlet.lua
index a5bbaacaa..0cbe1c854 100644
--- a/src/mudlet-lua/lua/CoreMudlet.lua
+++ b/src/mudlet-lua/lua/CoreMudlet.lua
@@ -539,10 +539,15 @@ if false then
 
 
 
-  --- Deletes an alias with the given name. If several aliases have this name, they'll all be deleted.
+  --- Deletes a tempAlias. Use the alias ID returned by tempAlias() as the name parameter.
+  --- This function returns true on success and false if the alias has already been killed
+  --- or is not a temporary alias. Note that non-temporary aliases that you have set up in
+  --- the GUI cannot be deleted with this function. Use disableAlias() to turn them on or off.
   ---
   --- @see killTimer
   --- @see killTrigger
+  ---
+  --- @return true or false
   function killAlias(name)
   end
 
@@ -563,6 +568,10 @@ if false then
 
 
   --- Deletes a tempTrigger according to trigger ID. ID is a string value, not a number.
+  --- This function returns true on success and false if the trigger has already been killed
+  --- (or has used up its last firing) or is not a temporary trigger. Note that non-temporary
+  --- triggers that you have set up in the GUI cannot be deleted with this function.
+  --- Use disableTrigger() to turn them on or off.
   ---
   --- @see killAlias
   --- @see killTimer
diff --git a/src/mudlet-lua/tests/Alias_spec.lua b/src/mudlet-lua/tests/Alias_spec.lua
index 99f8769ab..b093e7de1 100644
--- a/src/mudlet-lua/tests/Alias_spec.lua
+++ b/src/mudlet-lua/tests/Alias_spec.lua
@@ -270,6 +270,37 @@ describe("Alias processing", function()
             assert.is_false(killAlias("no_such_alias_name"), "killing a missing alias should return false")
         end)
 
+        it("killAlias returns false the second time, as the alias is already dead", function()
+            local id = tempAlias("^spec_double_kill_alias$", [[]])
+            assert.is_true(killAlias(id), "killing a live temporary alias should report success")
+            -- the alias is still present here: only the deferred cleanup frees it, so
+            -- the second kill really is being told about a corpse it can find
+            assert.are.equal(1, exists(id, "alias"), "the killed alias is still present until cleanup runs")
+            assert.are.equal(0, isActive(id, "alias"), "a killed alias is no longer active")
+            assert.is_false(killAlias(id),
+                "killing an already killed alias achieves nothing and has to say so")
+            -- an incoming line runs every unit's deferred cleanup, which is what
+            -- finally frees the alias; the answer has to be the same after it
+            feedTriggers("\nspec_alias_kill_flush\n")
+            assert.are.equal(0, exists(id, "alias"), "the alias should be gone after kill and cleanup")
+            assert.is_false(killAlias(id), "a freed alias cannot be killed either")
+        end)
+
+        it("killAlias returns false the second time inside the alias's own script", function()
+            _G.AliasSpec = {}
+            local id
+            id = tempAlias("^spec_self_kill_alias$", function()
+                _G.AliasSpec.killed = killAlias(id)
+                _G.AliasSpec.killedAgain = killAlias(id)
+            end)
+            expandAlias("spec_self_kill_alias")
+            assert.is_not_nil(_G.AliasSpec.killed, "the alias should have matched and run")
+            assert.is_true(_G.AliasSpec.killed,
+                "killAlias should report success from inside the alias's own script")
+            assert.is_false(_G.AliasSpec.killedAgain,
+                "killing the same alias twice from its own script must fail the second time")
+        end)
+
         it("killAlias returns false for a permanent alias (they cannot be killed)", function()
             local id = permAlias("SpecPermAliasKill", "", "^spec_perm_kill$", [[]])
             assert.is_true(id > 0)
diff --git a/src/mudlet-lua/tests/KeyBinds_spec.lua b/src/mudlet-lua/tests/KeyBinds_spec.lua
index a48683448..00f6e64d4 100644
--- a/src/mudlet-lua/tests/KeyBinds_spec.lua
+++ b/src/mudlet-lua/tests/KeyBinds_spec.lua
@@ -186,6 +186,24 @@ describe("Tests keybind-related functions", function()
       assert.is_false(killKey("no_such_key_name"), "killing a missing key should return false")
     end)
 
+    it("killKey returns false the second time, as the key is already dead", function()
+      local id = tempKey(mudlet.key.F11, [[echo("x")]])
+      assert.is_true(killKey(id), "killing a live temporary key should report success")
+      -- the key is still present here: only the deferred cleanup frees it, so the
+      -- second kill really is being told about a corpse it can find
+      assert.are.equal(1, exists(id, "keybind"), "the killed key is still present until cleanup runs")
+      assert.are.equal(0, isActive(id, "keybind"), "a killed key is no longer active")
+      assert.is_false(killKey(id),
+        "killing an already killed key achieves nothing and has to say so")
+      -- an incoming line runs every unit's deferred cleanup, which is what finally
+      -- frees the key; the answer has to be the same after it. A key press cannot be
+      -- synthesised headlessly, so there is no in-callback double kill to pin here -
+      -- KeyUnit's depth and cleanup machinery matches AliasUnit's, whose spec has one
+      feedTriggers("\nspec_key_kill_flush\n")
+      assert.are.equal(0, exists(id, "keybind"), "the key should be gone after kill and cleanup")
+      assert.is_false(killKey(id), "a freed key cannot be killed either")
+    end)
+
     it("killKey returns false for a permanent key (they cannot be killed)", function()
       local id = permKey("SpecPermKeyKill", "", mudlet.key.F12, [[echo("x")]])
       assert.is_true(id > 0)
diff --git a/src/mudlet-lua/tests/Trigger_spec.lua b/src/mudlet-lua/tests/Trigger_spec.lua
index d5e11a6a8..4217da6c6 100644
--- a/src/mudlet-lua/tests/Trigger_spec.lua
+++ b/src/mudlet-lua/tests/Trigger_spec.lua
@@ -713,6 +713,77 @@ describe("Trigger processing", function()
             assert.is_false(killTrigger("no_such_trigger_name"))
         end)
 
+        it("killTrigger returns false the second time, as the trigger is already dead", function()
+            local id = tempRegexTrigger("^double_kill_probe$", [[]])
+            assert.is_true(killTrigger(id), "killing a live temporary trigger should report success")
+            -- the trigger is still present here: only the deferred cleanup frees it,
+            -- so the second kill really is being told about a corpse it can find
+            assert.is_equal(1, exists(id, "trigger"), "the killed trigger is still present until cleanup runs")
+            assert.is_equal(0, isActive(id, "trigger"), "a killed trigger is no longer active")
+            assert.is_false(killTrigger(id),
+                "killing an already killed trigger achieves nothing and has to say so")
+            -- a fed line runs that cleanup, and the answer has to be the same after it
+            feedTriggers("\ndouble_kill_flush\n")
+            assert.is_equal(0, exists(id, "trigger"), "the trigger should be gone after kill and cleanup")
+            assert.is_false(killTrigger(id), "a freed trigger cannot be killed either")
+        end)
+
+        it("a trigger killed earlier in a line's pass does not fire on that line", function()
+            _G.TrigSpec = {count = 0, witness = 0}
+            -- the killer is created first, so the trigger unit reaches it first and
+            -- its victim is still in the list this pass is walking; only the cleanup
+            -- at the end of the line frees the victim. The witness is created last so
+            -- that it proves the pass really did carry on past the killer
+            local victimId
+            local killerId = tempRegexTrigger("^kill_stops_firing$", function()
+                _G.TrigSpec.killed = killTrigger(victimId)
+            end)
+            victimId = tempRegexTrigger("^kill_stops_firing$", function()
+                _G.TrigSpec.count = _G.TrigSpec.count + 1
+            end)
+            local witnessId = tempRegexTrigger("^kill_stops_firing$", function()
+                _G.TrigSpec.witness = _G.TrigSpec.witness + 1
+            end)
+            feedTriggers("\nkill_stops_firing\n")
+            killTrigger(killerId)
+            killTrigger(witnessId)
+            assert.is_true(_G.TrigSpec.killed, "the first trigger should have killed the second")
+            assert.is_equal(1, _G.TrigSpec.witness, "the line should still reach triggers behind the killer")
+            assert.is_equal(0, _G.TrigSpec.count,
+                "a killed trigger must no more fire on the rest of the line than a disabled one does")
+        end)
+
+        it("killTrigger returns false for a trigger that has used up its last firing", function()
+            -- an expiring trigger queues itself for the same deferred cleanup a killed
+            -- one does, so it is just as dead - as killTimer reports for a one-shot
+            -- timer that has already fired
+            _G.TrigSpec = {}
+            local expiringId = tempRegexTrigger("^expiry_kill_probe$", [[]], 1)
+            local killerId = tempRegexTrigger("^expiry_kill_probe$", function()
+                _G.TrigSpec.killedExpired = killTrigger(expiringId)
+            end)
+            feedTriggers("\nexpiry_kill_probe\n")
+            killTrigger(killerId)
+            assert.is_not_nil(_G.TrigSpec.killedExpired, "the killing trigger should have fired")
+            assert.is_false(_G.TrigSpec.killedExpired,
+                "a trigger that just used up its last firing cannot be killed again")
+        end)
+
+        it("killTrigger returns false the second time inside the trigger's own script", function()
+            _G.TrigSpec = {}
+            local id
+            id = tempRegexTrigger("^self_kill_probe$", function()
+                _G.TrigSpec.killed = killTrigger(id)
+                _G.TrigSpec.killedAgain = killTrigger(id)
+            end)
+            feedTriggers("\nself_kill_probe\n")
+            assert.is_not_nil(_G.TrigSpec.killed, "the trigger should have fired")
+            assert.is_true(_G.TrigSpec.killed,
+                "killTrigger should report success from inside the trigger's own script")
+            assert.is_false(_G.TrigSpec.killedAgain,
+                "killing the same trigger twice from its own script must fail the second time")
+        end)
+
         it("exists rejects an invalid item type", function()
             local ok, err = exists(1, "notarealtype")
             assert.is_nil(ok)

From fba66d283d6b4d7b9a947153e502fc9ac7e00998 Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Tue, 4 Aug 2026 10:10:18 +0200
Subject: [PATCH 071/155] fix: event handlers no longer wipe the caller's Lua
 stack (#9621)

#### Brief overview of PR changes/additions
- Each Lua-glue function that runs user code (event handlers,
trigger/alias/script bodies, callbacks, the GMCP/MSSP/MXP table
builders) now records its entry stack level and `lua_settop()`s back to
it, and reads its result and error object relative to its own frame
instead of at absolute index 1 (where, mid-dispatch, the caller's
arguments live).
- 17 sites converted across `TLuaInterpreter.cpp` /
`TLuaInterpreterMapper.cpp`; three inferred entry levels
(`callReference`, `parseJSON`, `parseMSSP`, whose callers pre-push for
them) carry a `Q_ASSERT_X`. Left alone: `formatLuaCode` (separate
indenter state) and `initLuaGlobals`/`setupLanguageData` (run while the
state is being built).
- Called from the event loop, entry gettop is 0, so `settop(entry)` is
the old wipe exactly. One deliberate exception: a script that returned
nothing used to be read with `lua_isboolean(L, 0)` - a stale-slot read
in Lua 5.1 - and is now deterministically false.

#### Motivation for adding to Mudlet
These functions finished with `lua_pop(L, lua_gettop(L))`, clearing the
whole shared per-profile Lua stack rather than their own frame. Because
they run synchronously from inside other Lua API C functions, the wipe
destroyed the caller's arguments and pending return values - #9590
shipped as an instance (`ttsSetVoiceByName` returning stack garbage).
This removes the class rather than patching call sites one by one.

#### Other info (issues closed, discussion etc)
Root cause of #9590 (already patched at its call site in #9595); this
makes that ordering safe everywhere.
**Test case:** with neither fix the suite reproduces #9590 verbatim (2
failures, `Passed in: function: 0x...`); with only the class fix and
`ttsSetVoiceByName` still pushing before it raises, the suite is green.
A new `Trigger_spec` case pins the frame-relative reads generically (a
1-fire trigger fires 3 times without them). Busted 1821/0/0 twice (17
pendings are the HTTP fixture), ctest 65/66 (`TKeySequenceEditTest` is
the known bare-Xvfb flake).

Assisted-by: Claude:claude-opus-5
---
 src/Host.cpp                          |   4 +-
 src/TLuaInterpreter.cpp               | 295 ++++++++++++++------------
 src/TLuaInterpreterMapper.cpp         |  19 +-
 src/TLuaInterpreterTextToSpeech.cpp   |   2 -
 src/mudlet-lua/tests/Media_spec.lua   |   9 +-
 src/mudlet-lua/tests/Trigger_spec.lua |  19 ++
 6 files changed, 190 insertions(+), 158 deletions(-)

diff --git a/src/Host.cpp b/src/Host.cpp
index 99d806cf1..e6de6a0d8 100644
--- a/src/Host.cpp
+++ b/src/Host.cpp
@@ -1878,7 +1878,9 @@ void Host::unregisterEventHandler(const QString& name, TScript* pScript)
     }
 }
 
-// If a handler matches the event, the Lua stack will be cleared after this function
+// Handlers run on this profile's shared lua_State, but each unwinds it back to
+// the level it found, so a C function raising an event mid-flight keeps its own
+// arguments and any return values it has already pushed
 void Host::raiseEvent(const TEvent& pE)
 {
     if (Q_UNLIKELY(mEmergencyStop)) {
diff --git a/src/TLuaInterpreter.cpp b/src/TLuaInterpreter.cpp
index ff6ab77b5..60f750f85 100644
--- a/src/TLuaInterpreter.cpp
+++ b/src/TLuaInterpreter.cpp
@@ -3394,13 +3394,14 @@ bool TLuaInterpreter::compileAndExecuteScript(const QString& code)
         return false;
     }
     lua_State* L = pGlobalLua;
+    const int callerStackTop = lua_gettop(L);
 
     const int error = luaL_dostring(L, code.toUtf8().constData());
     if (error) {
         std::string e = "no error message available from Lua";
-        if (lua_isstring(L, 1)) {
+        if (lua_isstring(L, -1)) {
             e = "Lua error:";
-            e += lua_tostring(L, 1);
+            e += lua_tostring(L, -1);
         }
         if (mudlet::smDebugMode) {
             qDebug() << "LUA ERROR: code did not compile: ERROR:" << e.c_str();
@@ -3410,7 +3411,7 @@ bool TLuaInterpreter::compileAndExecuteScript(const QString& code)
         logError(e, _n, _n2);
     }
 
-    lua_pop(L, lua_gettop(L));
+    lua_settop(L, callerStackTop);
 
     return !error;
 }
@@ -3608,12 +3609,13 @@ void TLuaInterpreter::clearCaptureGroups()
     mMultiCaptureNameGroups.clear();
 
     lua_State* L = pGlobalLua;
+    const int callerStackTop = lua_gettop(L);
     lua_newtable(L);
     lua_setglobal(L, "matches");
     lua_newtable(L);
     lua_setglobal(L, "multimatches");
 
-    lua_pop(L, lua_gettop(L));
+    lua_settop(L, callerStackTop);
 }
 
 // No documentation available in wiki - internal function
@@ -3656,13 +3658,16 @@ void TLuaInterpreter::setAtcpTable(const QString& var, const QString& arg)
 void TLuaInterpreter::signalMXPEvent(const QString& type, const QMap& attrs, const QStringList& actions, const QString& caption)
 {
     lua_State* L = pGlobalLua;
+    const int callerStackTop = lua_gettop(L);
     lua_getglobal(L, "mxp");
     if (!lua_istable(L, -1)) {
+        lua_pop(L, 1);
         lua_newtable(L);
         lua_setglobal(L, "mxp");
         lua_getglobal(L, "mxp");
         if (!lua_istable(L, -1)) {
             qDebug() << "ERROR: mxp table not defined";
+            lua_settop(L, callerStackTop);
             return;
         }
     }
@@ -3672,6 +3677,7 @@ void TLuaInterpreter::signalMXPEvent(const QString& type, const QMap= 0, "TLuaInterpreter::parseJSON()", "the protocol's global table must already be on the stack");
     QStringList tokenList = key.split(QLatin1Char('.'));
     if (!lua_checkstack(L, tokenList.size() + 5)) {
         qCritical() << "ERROR: could not grow Lua stack by" << tokenList.size() + 5 << "elements, parsing GMCP/MSDP failed. Current stack size is" << lua_gettop(L);
+        lua_settop(L, callerStackTop);
         return;
     }
     int i = 0;
@@ -3806,7 +3825,7 @@ void TLuaInterpreter::parseJSON(QString& key, const QString& string_data, const
     lua_getglobal(L, "json_to_value");
 
     if (!lua_isfunction(L, -1)) {
-        lua_settop(L, 0);
+        lua_settop(L, callerStackTop);
         qDebug() << "CRITICAL ERROR: json_to_value not defined";
         return;
     }
@@ -3817,10 +3836,10 @@ void TLuaInterpreter::parseJSON(QString& key, const QString& string_data, const
         // Top of stack should now contain the lua representation of json.
         lua_rawset(L, -3);
         if (__needMerge) {
-            lua_settop(L, 0);
+            lua_settop(L, callerStackTop);
             lua_getglobal(L, "__gmcp_merge_gmcp_sub_tables");
             if (!lua_isfunction(L, -1)) {
-                lua_settop(L, 0);
+                lua_settop(L, callerStackTop);
                 qDebug() << "CRITICAL ERROR: __gmcp_merge_gmcp_sub_tables is not defined in lua_LuaGlobal.lua";
                 return;
             }
@@ -3854,7 +3873,7 @@ void TLuaInterpreter::parseJSON(QString& key, const QString& string_data, const
             logError(e, _n, _f);
         }
     }
-    lua_settop(L, 0);
+    lua_settop(L, callerStackTop);
 
     // events: for key "foo.bar.top" we raise: gmcp.foo, gmcp.foo.bar and gmcp.foo.bar.top
     // with the actual key given as parameter e.g. event=gmcp.foo, param="gmcp.foo.bar"
@@ -3884,7 +3903,7 @@ void TLuaInterpreter::parseJSON(QString& key, const QString& string_data, const
     if (tokenList.size() == 3 && tokenList.at(0).toLower() == "ire" && tokenList.at(1).toLower() == "composer" && tokenList.at(2).toLower() == "edit") {
         handleIreComposerEdit(string_data);
     }
-    lua_pop(L, lua_gettop(L));
+    lua_settop(L, callerStackTop);
 }
 
 void TLuaInterpreter::handleIreComposerEdit(const QString& jsonData)
@@ -3928,6 +3947,11 @@ void TLuaInterpreter::handleIreComposerEdit(const QString& jsonData)
 void TLuaInterpreter::parseMSSP(const QString& string_data)
 {
     lua_State* L = pGlobalLua;
+    // setMSSPTable() pushes exactly the mssp global table for us and we consume
+    // it, so everything below that belongs to whichever C function this arrived
+    // in the middle of. A negative level would make lua_settop() pop relatively:
+    const int callerStackTop = lua_gettop(L) - 1;
+    Q_ASSERT_X(callerStackTop >= 0, "TLuaInterpreter::parseMSSP()", "the mssp global table must already be on the stack");
 
     // string_data is in the format of MSSP_VAR "PLAYERS" MSSP_VAL "52" MSSP_VAR "UPTIME" MSSP_VAL "1234567890"
     // The quote characters mean that the encased word is a string, the quotes themselves are not sent.
@@ -3938,7 +3962,7 @@ void TLuaInterpreter::parseMSSP(const QString& string_data)
 
         for (int i = 1; i < packageList.size(); i++) {
             // clear the stack to avoid it getting to big
-            lua_settop(L, 0);
+            lua_settop(L, callerStackTop);
 
             QStringList payloadList = packageList[i].split(MSSP_VAL);
 
@@ -3980,9 +4004,9 @@ void TLuaInterpreter::parseMSSP(const QString& string_data)
                 host.mMSSPTlsPort = (msspVAL != "-1" && msspVAL != "1") ? msspVAL.toInt() : 0;
             }
         }
-
-        lua_pop(L, lua_gettop(L));
     }
+
+    lua_settop(L, callerStackTop);
 }
 
 // No documentation available in wiki - internal function
@@ -4163,25 +4187,23 @@ bool TLuaInterpreter::call_luafunction(void* pT)
     }
 
     lua_State* L = pGlobalLua;
+    const int callerStackTop = lua_gettop(L);
     lua_pushlightuserdata(L, pT);
     lua_gettable(L, LUA_REGISTRYINDEX);
     if (lua_isfunction(L, -1)) {
         setMatches(L);
         const int error = lua_pcall(L, 0, LUA_MULTRET, 0);
         if (error) {
-            const int nbpossible_errors = lua_gettop(L);
-            for (int i = 1; i <= nbpossible_errors; i++) {
-                std::string e = "";
-                if (lua_isstring(L, i)) {
-                    e = "Lua error:";
-                    e += lua_tostring(L, i);
-                    const QString _n = "error in anonymous Lua function";
-                    const QString _n2 = "no debug data available";
-                    logError(e, _n, _n2);
-                    if (mudlet::smDebugMode) {
-                        auto& host = getHostFromLua(L);
-                        TDebug(Qt::white, Qt::red) << "LUA: ERROR running anonymous Lua function ERROR:" << e.c_str() >> &host;
-                    }
+            std::string e = "";
+            if (lua_isstring(L, -1)) {
+                e = "Lua error:";
+                e += lua_tostring(L, -1);
+                const QString _n = "error in anonymous Lua function";
+                const QString _n2 = "no debug data available";
+                logError(e, _n, _n2);
+                if (mudlet::smDebugMode) {
+                    auto& host = getHostFromLua(L);
+                    TDebug(Qt::white, Qt::red) << "LUA: ERROR running anonymous Lua function ERROR:" << e.c_str() >> &host;
                 }
             }
         } else {
@@ -4192,11 +4214,11 @@ bool TLuaInterpreter::call_luafunction(void* pT)
                         >> &host;
             }
         }
-        lua_pop(L, lua_gettop(L));
-        //lua_settop(L, 0);
+        lua_settop(L, callerStackTop);
         return !error;
     }
 
+    lua_settop(L, callerStackTop);
     const QString _n = "error in anonymous Lua function";
     const QString _n2 = "func reference not found by Lua, func cannot be called";
     std::string e = "Lua error:";
@@ -4217,14 +4239,15 @@ void TLuaInterpreter::delete_luafunction(void* pT)
 void TLuaInterpreter::delete_luafunction(const QString& name)
 {
     lua_State* L = pGlobalLua;
+    const int callerStackTop = lua_gettop(L);
     lua_getglobal(L, name.toUtf8().constData());
     if (lua_isfunction(L, -1)) {
         lua_pushnil(L);
         lua_setglobal(L, name.toUtf8().constData());
-        lua_pop(L, lua_gettop(L));
     } else if (mudlet::smDebugMode) {
         qWarning() << "LUA: ERROR deleting " << name << ", it is not a function as expected";
     }
+    lua_settop(L, callerStackTop);
 }
 
 // No documentation available in wiki - internal function
@@ -4239,6 +4262,7 @@ std::pair TLuaInterpreter::callLuaFunctionReturnBool(void* pT)
     }
 
     lua_State* L = pGlobalLua;
+    const int callerStackTop = lua_gettop(L);
 
     lua_pushlightuserdata(L, pT);
     lua_gettable(L, LUA_REGISTRYINDEX);
@@ -4248,25 +4272,21 @@ std::pair TLuaInterpreter::callLuaFunctionReturnBool(void* pT)
         setMatches(L);
         const int error = lua_pcall(L, 0, LUA_MULTRET, 0);
         if (error) {
-            const int nbpossible_errors = lua_gettop(L);
-            for (int i = 1; i <= nbpossible_errors; i++) {
-                std::string e = "";
-                if (lua_isstring(L, i)) {
-                    e = "Lua error:";
-                    e += lua_tostring(L, i);
-                    const QString _n = "error in anonymous Lua function";
-                    const QString _n2 = "no debug data available";
-                    logError(e, _n, _n2);
-                    if (mudlet::smDebugMode) {
-                        auto& host = getHostFromLua(L);
-                        TDebug(Qt::white, Qt::red) << "LUA: ERROR running anonymous Lua function ERROR:" << e.c_str() >> &host;
-                    }
+            std::string e = "";
+            if (lua_isstring(L, -1)) {
+                e = "Lua error:";
+                e += lua_tostring(L, -1);
+                const QString _n = "error in anonymous Lua function";
+                const QString _n2 = "no debug data available";
+                logError(e, _n, _n2);
+                if (mudlet::smDebugMode) {
+                    auto& host = getHostFromLua(L);
+                    TDebug(Qt::white, Qt::red) << "LUA: ERROR running anonymous Lua function ERROR:" << e.c_str() >> &host;
                 }
             }
         } else {
-            auto index = lua_gettop(L);
-            if (lua_isboolean(L, index)) {
-                returnValue = lua_toboolean(L, index);
+            if (lua_gettop(L) > callerStackTop && lua_isboolean(L, -1)) {
+                returnValue = lua_toboolean(L, -1);
             }
 
             if (mudlet::smDebugMode) {
@@ -4276,10 +4296,11 @@ std::pair TLuaInterpreter::callLuaFunctionReturnBool(void* pT)
                         >> &host;
             }
         }
-        lua_pop(L, lua_gettop(L));
+        lua_settop(L, callerStackTop);
         return {!error, returnValue};
     }
 
+    lua_settop(L, callerStackTop);
     const QString _n = "error in anonymous Lua function";
     const QString _n2 = "func reference not found by Lua, func cannot be called";
     std::string e = "Lua error:";
@@ -4300,21 +4321,19 @@ bool TLuaInterpreter::call(const QString& function, const QString& mName, const
     }
 
     lua_State* L = pGlobalLua;
+    const int callerStackTop = lua_gettop(L);
     setMatches(L);
 
     lua_getglobal(L, function.toUtf8().constData());
     const int error = lua_pcall(L, 0, LUA_MULTRET, 0);
     if (error) {
-        const int nbpossible_errors = lua_gettop(L);
-        for (int i = 1; i <= nbpossible_errors; i++) {
-            std::string e = "";
-            if (lua_isstring(L, i)) {
-                e += lua_tostring(L, i);
-                logError(e, mName, function);
-                if (mudlet::smDebugMode) {
-                    auto& host = getHostFromLua(L);
-                    TDebug(Qt::white, Qt::red) << "LUA ERROR: when running script " << mName << " (" << function << "),\nreason: " << e.c_str() << "\n" >> &host;
-                }
+        std::string e = "";
+        if (lua_isstring(L, -1)) {
+            e += lua_tostring(L, -1);
+            logError(e, mName, function);
+            if (mudlet::smDebugMode) {
+                auto& host = getHostFromLua(L);
+                TDebug(Qt::white, Qt::red) << "LUA ERROR: when running script " << mName << " (" << function << "),\nreason: " << e.c_str() << "\n" >> &host;
             }
         }
     } else {
@@ -4325,7 +4344,7 @@ bool TLuaInterpreter::call(const QString& function, const QString& mName, const
                     >> &host;
         }
     }
-    lua_pop(L, lua_gettop(L));
+    lua_settop(L, callerStackTop);
 
     return !error;
 }
@@ -4340,6 +4359,7 @@ std::pair TLuaInterpreter::callReturnBool(const QString& function, c
     }
 
     lua_State* L = pGlobalLua;
+    const int callerStackTop = lua_gettop(L);
     bool returnValue = false;
 
     setMatches(L);
@@ -4347,22 +4367,18 @@ std::pair TLuaInterpreter::callReturnBool(const QString& function, c
     lua_getglobal(L, function.toUtf8().constData());
     const int error = lua_pcall(L, 0, LUA_MULTRET, 0);
     if (error) {
-        const int nbpossible_errors = lua_gettop(L);
-        for (int i = 1; i <= nbpossible_errors; i++) {
-            std::string e = "";
-            if (lua_isstring(L, i)) {
-                e += lua_tostring(L, i);
-                logError(e, mName, function);
-                if (mudlet::smDebugMode) {
-                    auto& host = getHostFromLua(L);
-                    TDebug(Qt::white, Qt::red) << "LUA: ERROR running script " << mName << " (" << function << ") ERROR:" << e.c_str() << "\n" >> &host;
-                }
+        std::string e = "";
+        if (lua_isstring(L, -1)) {
+            e += lua_tostring(L, -1);
+            logError(e, mName, function);
+            if (mudlet::smDebugMode) {
+                auto& host = getHostFromLua(L);
+                TDebug(Qt::white, Qt::red) << "LUA: ERROR running script " << mName << " (" << function << ") ERROR:" << e.c_str() << "\n" >> &host;
             }
         }
     } else {
-        auto index = lua_gettop(L);
-        if (lua_isboolean(L, index)) {
-            returnValue = lua_toboolean(L, index);
+        if (lua_gettop(L) > callerStackTop && lua_isboolean(L, -1)) {
+            returnValue = lua_toboolean(L, -1);
         }
 
         if (mudlet::smDebugMode) {
@@ -4372,7 +4388,7 @@ std::pair TLuaInterpreter::callReturnBool(const QString& function, c
                     >> &host;
         }
     }
-    lua_pop(L, lua_gettop(L));
+    lua_settop(L, callerStackTop);
     return {!error, returnValue};
 }
 
@@ -4448,21 +4464,19 @@ bool TLuaInterpreter::callConditionFunction(std::string& function, const QString
     }
 
     lua_State* L = pGlobalLua;
+    const int callerStackTop = lua_gettop(L);
 
     lua_getfield(L, LUA_GLOBALSINDEX, function.c_str());
     const int error = lua_pcall(L, 0, 1, 0);
     if (error) {
-        const int nbpossible_errors = lua_gettop(L);
-        for (int i = 1; i <= nbpossible_errors; i++) {
-            std::string e = "";
-            if (lua_isstring(L, i)) {
-                e += lua_tostring(L, i);
-                const QString _f = function.c_str();
-                logError(e, mName, _f);
-                if (mudlet::smDebugMode) {
-                    auto& host = getHostFromLua(L);
-                    TDebug(Qt::white, Qt::red) << "LUA: ERROR running script " << mName << " (" << function.c_str() << ") ERROR:" << e.c_str() << "\n" >> &host;
-                }
+        std::string e = "";
+        if (lua_isstring(L, -1)) {
+            e += lua_tostring(L, -1);
+            const QString _f = function.c_str();
+            logError(e, mName, _f);
+            if (mudlet::smDebugMode) {
+                auto& host = getHostFromLua(L);
+                TDebug(Qt::white, Qt::red) << "LUA: ERROR running script " << mName << " (" << function.c_str() << ") ERROR:" << e.c_str() << "\n" >> &host;
             }
         }
     } else {
@@ -4475,13 +4489,12 @@ bool TLuaInterpreter::callConditionFunction(std::string& function, const QString
     }
 
     bool ret = false;
-    const int returnValues = lua_gettop(L);
-    if (returnValues > 0) {
+    if (!error && lua_gettop(L) > callerStackTop) {
         // Lua docs: Like all tests in Lua, lua_toboolean returns 1 for any Lua value different from false and nil; otherwise it returns 0
         // This means trigger patterns don't have to strictly return true or false, as it is accepted in Lua
-        ret = lua_toboolean(L, 1);
+        ret = lua_toboolean(L, -1);
     }
-    lua_pop(L, returnValues);
+    lua_settop(L, callerStackTop);
     return ((!error) && (ret > 0));
 }
 
@@ -4495,6 +4508,7 @@ bool TLuaInterpreter::callMulti(const QString& function, const QString& mName)
     }
 
     lua_State* L = pGlobalLua;
+    const int callerStackTop = lua_gettop(L);
 
     if (!mMultiCaptureGroupList.empty()) {
         int k = 1;       // Lua indexes start with 1 as a general convention
@@ -4522,16 +4536,13 @@ bool TLuaInterpreter::callMulti(const QString& function, const QString& mName)
     lua_getglobal(L, function.toUtf8().constData());
     const int error = lua_pcall(L, 0, LUA_MULTRET, 0);
     if (error) {
-        const int nbpossible_errors = lua_gettop(L);
-        for (int i = 1; i <= nbpossible_errors; i++) {
-            std::string e = "";
-            if (lua_isstring(L, i)) {
-                e += lua_tostring(L, i);
-                logError(e, mName, function);
-                if (mudlet::smDebugMode) {
-                    auto& host = getHostFromLua(L);
-                    TDebug(Qt::white, Qt::red) << "LUA: ERROR running script " << mName << " (" << function << ") ERROR:" << e.c_str() << "\n" >> &host;
-                }
+        std::string e = "";
+        if (lua_isstring(L, -1)) {
+            e += lua_tostring(L, -1);
+            logError(e, mName, function);
+            if (mudlet::smDebugMode) {
+                auto& host = getHostFromLua(L);
+                TDebug(Qt::white, Qt::red) << "LUA: ERROR running script " << mName << " (" << function << ") ERROR:" << e.c_str() << "\n" >> &host;
             }
         }
     } else {
@@ -4542,7 +4553,7 @@ bool TLuaInterpreter::callMulti(const QString& function, const QString& mName)
                     >> &host;
         }
     }
-    lua_pop(L, lua_gettop(L));
+    lua_settop(L, callerStackTop);
     return !error;
 }
 
@@ -4556,6 +4567,7 @@ std::pair TLuaInterpreter::callMultiReturnBool(const QString& functi
     }
 
     lua_State* L = pGlobalLua;
+    const int callerStackTop = lua_gettop(L);
 
     bool returnValue = false;
 
@@ -4580,22 +4592,18 @@ std::pair TLuaInterpreter::callMultiReturnBool(const QString& functi
     lua_getglobal(L, function.toUtf8().constData());
     const int error = lua_pcall(L, 0, LUA_MULTRET, 0);
     if (error) {
-        const int nbpossible_errors = lua_gettop(L);
-        for (int i = 1; i <= nbpossible_errors; i++) {
-            std::string e = "";
-            if (lua_isstring(L, i)) {
-                e += lua_tostring(L, i);
-                logError(e, mName, function);
-                if (mudlet::smDebugMode) {
-                    auto& host = getHostFromLua(L);
-                    TDebug(Qt::white, Qt::red) << "LUA: ERROR running script " << mName << " (" << function << ") ERROR:" << e.c_str() << "\n" >> &host;
-                }
+        std::string e = "";
+        if (lua_isstring(L, -1)) {
+            e += lua_tostring(L, -1);
+            logError(e, mName, function);
+            if (mudlet::smDebugMode) {
+                auto& host = getHostFromLua(L);
+                TDebug(Qt::white, Qt::red) << "LUA: ERROR running script " << mName << " (" << function << ") ERROR:" << e.c_str() << "\n" >> &host;
             }
         }
     } else {
-        auto index = lua_gettop(L);
-        if (lua_isboolean(L, index)) {
-            returnValue = lua_toboolean(L, index);
+        if (lua_gettop(L) > callerStackTop && lua_isboolean(L, -1)) {
+            returnValue = lua_toboolean(L, -1);
         }
 
         if (mudlet::smDebugMode) {
@@ -4605,13 +4613,19 @@ std::pair TLuaInterpreter::callMultiReturnBool(const QString& functi
                     >> &host;
         }
     }
-    lua_pop(L, lua_gettop(L));
+    lua_settop(L, callerStackTop);
     return {!error, returnValue};
 }
 
 // No documentation available in wiki - internal function
 bool TLuaInterpreter::callReference(lua_State* L, QString name, int parameters)
 {
+    // Our callers have already pushed the function and its arguments for us, so
+    // anything below those belongs to whichever C function we are nested in.
+    // A negative level would make lua_settop() pop relatively instead:
+    const int callerStackTop = lua_gettop(L) - parameters - 1;
+    Q_ASSERT_X(callerStackTop >= 0, "TLuaInterpreter::callReference()", "the function to call and its arguments must already be on the stack");
+
     int error = 0;
     error = lua_pcall(L, parameters, LUA_MULTRET, 0);
     if (error) {
@@ -4625,7 +4639,7 @@ bool TLuaInterpreter::callReference(lua_State* L, QString name, int parameters)
             TDebug(Qt::white, Qt::red) << "LUA: ERROR running anonymous Lua function (" << name << ")\nError: " << err.c_str() << "\n" >> &host;
         }
     }
-    lua_pop(L, lua_gettop(L));
+    lua_settop(L, callerStackTop);
     return !error;
 }
 
@@ -4657,6 +4671,7 @@ bool TLuaInterpreter::callCmdLineAction(const int func, QString text)
 bool TLuaInterpreter::callLabelCallbackEvent(const int func, const QEvent* qE)
 {
     lua_State* L = pGlobalLua;
+    const int callerStackTop = lua_gettop(L);
     lua_rawgeti(L, LUA_REGISTRYINDEX, func);
     const QString name = qsl("label callback event");
 
@@ -4795,7 +4810,7 @@ bool TLuaInterpreter::callLabelCallbackEvent(const int func, const QEvent* qE)
     } else {
         return callReference(L, name, 0);
     }
-    lua_pop(L, lua_gettop(L));
+    lua_settop(L, callerStackTop);
     return true;
 }
 
@@ -4819,7 +4834,9 @@ bool TLuaInterpreter::callEventHandler(const QString& function, const TEvent& pE
         return false;
     }
 
-    // Record initial stack size for cleanup
+    // Events are often raised from inside another Lua API C function, which is
+    // still holding its arguments and any already-pushed return values on this
+    // same stack, so only ever unwind back down to what we found:
     const int initialStackSize = lua_gettop(L);
 
     int error = luaL_dostring(L, qsl("return %1").arg(function).toUtf8().constData());
@@ -4844,6 +4861,15 @@ bool TLuaInterpreter::callEventHandler(const QString& function, const TEvent& pE
         qWarning() << "TLuaInterpreter::callEventHandler() WARNING: argument list size" << pE.mArgumentList.size() << "does not match type list size" << pE.mArgumentTypeList.size()
                    << "for function:" << function;
     }
+    // A lua_CFunction is only guaranteed LUA_MINSTACK slots, and whatever C
+    // function we are nested inside is already using some of them:
+    if (!lua_checkstack(L, static_cast(maxArguments) + 1)) {
+        std::string err = "could not grow the Lua stack to pass this event's arguments to the handler";
+        const QString name = "event handler function";
+        logError(err, name, function);
+        lua_settop(L, initialStackSize);
+        return false;
+    }
     for (int i = 0; i < maxArguments; i++) {
         switch (pE.mArgumentTypeList.at(i)) {
         case ARGUMENT_TYPE_NUMBER:
@@ -4892,13 +4918,7 @@ bool TLuaInterpreter::callEventHandler(const QString& function, const TEvent& pE
         }
     }
 
-    // Ensure stack is properly cleaned up and validate before cleanup
-    const int finalStackSize = lua_gettop(L);
-    if (finalStackSize > initialStackSize) {
-        qWarning() << "TLuaInterpreter::callEventHandler() - Stack grew during execution. Initial:" << initialStackSize << "Final:" << finalStackSize;
-    }
-
-    lua_pop(L, lua_gettop(L));
+    lua_settop(L, initialStackSize);
     return !error;
 }
 
@@ -4981,21 +5001,19 @@ double TLuaInterpreter::condenseMapLoad()
     double loadTime = -1.0;
 
     lua_State* L = pGlobalLua;
+    const int callerStackTop = lua_gettop(L);
 
     lua_getfield(L, LUA_GLOBALSINDEX, "condenseMapLoad");
     const int error = lua_pcall(L, 0, 1, 0);
     if (error) {
-        const int nbpossible_errors = lua_gettop(L);
-        for (int i = 1; i <= nbpossible_errors; i++) {
-            std::string e = "";
-            if (lua_isstring(L, i)) {
-                e += lua_tostring(L, i);
-                const QString _f = luaFunction.toUtf8().constData();
-                logError(e, luaFunction, _f);
-                if (mudlet::smDebugMode) {
-                    auto& host = getHostFromLua(L);
-                    TDebug(Qt::white, Qt::red) << "LUA: ERROR running " << luaFunction << " ERROR:" << e.c_str() << "\n" >> &host;
-                }
+        std::string e = "";
+        if (lua_isstring(L, -1)) {
+            e += lua_tostring(L, -1);
+            const QString _f = luaFunction.toUtf8().constData();
+            logError(e, luaFunction, _f);
+            if (mudlet::smDebugMode) {
+                auto& host = getHostFromLua(L);
+                TDebug(Qt::white, Qt::red) << "LUA: ERROR running " << luaFunction << " ERROR:" << e.c_str() << "\n" >> &host;
             }
         }
     } else {
@@ -5006,11 +5024,10 @@ double TLuaInterpreter::condenseMapLoad()
         }
     }
 
-    const int returnValues = lua_gettop(L);
-    if (returnValues > 0 && !lua_isnoneornil(L, 1)) {
-        loadTime = lua_tonumber(L, 1);
+    if (lua_gettop(L) > callerStackTop && !lua_isnoneornil(L, -1)) {
+        loadTime = lua_tonumber(L, -1);
     }
-    lua_pop(L, returnValues);
+    lua_settop(L, callerStackTop);
     return loadTime;
 }
 
@@ -5142,6 +5159,7 @@ int TLuaInterpreter::unzipAsync(lua_State* L)
 void TLuaInterpreter::set_lua_table(const QString& tableName, QStringList& variableList)
 {
     lua_State* L = pGlobalLua;
+    const int callerStackTop = lua_gettop(L);
     lua_newtable(L);
     for (int i = 0; i < variableList.size(); i++) {
         lua_pushnumber(L, i + 1); // Lua indexes start with 1
@@ -5149,17 +5167,18 @@ void TLuaInterpreter::set_lua_table(const QString& tableName, QStringList& varia
         lua_settable(L, -3);
     }
     lua_setglobal(L, tableName.toUtf8().constData());
-    lua_pop(pGlobalLua, lua_gettop(pGlobalLua));
+    lua_settop(L, callerStackTop);
 }
 
 // No documentation available in wiki - internal function
 void TLuaInterpreter::set_lua_string(const QString& varName, const QString& varValue)
 {
     lua_State* L = pGlobalLua;
+    const int callerStackTop = lua_gettop(L);
 
     lua_pushstring(L, varValue.toUtf8().constData());
     lua_setglobal(L, varName.toUtf8().constData());
-    lua_pop(pGlobalLua, lua_gettop(pGlobalLua));
+    lua_settop(L, callerStackTop);
 }
 
 // No documentation available in wiki - internal function
diff --git a/src/TLuaInterpreterMapper.cpp b/src/TLuaInterpreterMapper.cpp
index dba99ce56..caba64e28 100644
--- a/src/TLuaInterpreterMapper.cpp
+++ b/src/TLuaInterpreterMapper.cpp
@@ -2870,6 +2870,7 @@ int TLuaInterpreter::registerMapInfo(lua_State* L)
             name,
             [=](int roomID, int selectionSize, int areaId, int displayAreaId, QColor& infoColor) {
                 Q_UNUSED(infoColor)
+                const int callerStackTop = lua_gettop(L);
                 lua_rawgeti(L, LUA_REGISTRYINDEX, callback);
                 if (roomID > 0) {
                     lua_pushinteger(L, roomID);
@@ -2882,21 +2883,15 @@ int TLuaInterpreter::registerMapInfo(lua_State* L)
 
                 const int error = lua_pcall(L, 4, 6, 0);
                 if (error) {
-                    const int errorCount = lua_gettop(L);
-                    if (mudlet::smDebugMode) {
-                        for (int i = 1; i <= errorCount; i++) {
-                            if (lua_isstring(L, i)) {
-                                auto errorMessage = lua_tostring(L, i);
-                                TDebug(QColor(Qt::white), QColor(Qt::red)) << "LUA ERROR: when running map info callback for '" << name << "\nreason: " << errorMessage << "\n" >> 0;
-                            }
-                        }
+                    if (mudlet::smDebugMode && lua_isstring(L, -1)) {
+                        auto errorMessage = lua_tostring(L, -1);
+                        TDebug(QColor(Qt::white), QColor(Qt::red)) << "LUA ERROR: when running map info callback for '" << name << "\nreason: " << errorMessage << "\n" >> 0;
                     }
-                    lua_pop(L, errorCount);
+                    lua_settop(L, callerStackTop);
                     return MapInfoProperties{};
                 }
 
-                auto nResult = lua_gettop(L);
-                auto index = -nResult;
+                auto index = -6; // the lua_pcall() above always leaves exactly this many results
                 const QString text = lua_tostring(L, index);
                 const bool isBold = lua_toboolean(L, ++index);
                 const bool isItalic = lua_toboolean(L, ++index);
@@ -2916,7 +2911,7 @@ int TLuaInterpreter::registerMapInfo(lua_State* L)
                 if (r >= 0 && r <= 255 && g >= 0 && g <= 255 && b >= 0 && b <= 255) {
                     color = QColor(r, g, b);
                 }
-                lua_pop(L, nResult);
+                lua_settop(L, callerStackTop);
                 return MapInfoProperties{isBold, isItalic, text, color};
             },
             L,
diff --git a/src/TLuaInterpreterTextToSpeech.cpp b/src/TLuaInterpreterTextToSpeech.cpp
index d2999f04d..ff6ae650b 100644
--- a/src/TLuaInterpreterTextToSpeech.cpp
+++ b/src/TLuaInterpreterTextToSpeech.cpp
@@ -545,8 +545,6 @@ int TLuaInterpreter::ttsSetVoiceByName(lua_State* L)
             event.mArgumentTypeList.append(ARGUMENT_TYPE_STRING);
             mudlet::self()->getHostManager().postInterHostEvent(NULL, event, true);
 
-            // pushed only after the event: dispatching it runs Lua event
-            // handlers, which clear this lua_State's stack
             lua_pushboolean(L, true);
             return 1;
         }
diff --git a/src/mudlet-lua/tests/Media_spec.lua b/src/mudlet-lua/tests/Media_spec.lua
index 3ca8fd684..922259933 100644
--- a/src/mudlet-lua/tests/Media_spec.lua
+++ b/src/mudlet-lua/tests/Media_spec.lua
@@ -998,11 +998,10 @@ describe("Tests the text-to-speech Lua API", function()
           pending("the mock engine offers only one voice in this environment")
           return
         end
-        -- Regression #9590: the result used to be pushed onto the Lua stack
-        -- before ttsVoiceChanged was raised, and dispatching that event clears
-        -- the stack underneath it, so the caller was handed stack garbage. A
-        -- handler must be listening for the event to reach Lua at all, which is
-        -- what collect() arranges here.
+        -- Regression #9590: dispatching ttsVoiceChanged used to wipe this
+        -- lua_State's whole stack, taking the already-pushed result with it and
+        -- handing the caller stack garbage. A handler must be listening for the
+        -- event to reach Lua at all, which is what collect() arranges here.
         local changes = {}
         collect("ttsVoiceChanged", changes)
         local originalVoice = ttsGetCurrentVoice()
diff --git a/src/mudlet-lua/tests/Trigger_spec.lua b/src/mudlet-lua/tests/Trigger_spec.lua
index 4217da6c6..b01dfd728 100644
--- a/src/mudlet-lua/tests/Trigger_spec.lua
+++ b/src/mudlet-lua/tests/Trigger_spec.lua
@@ -476,6 +476,25 @@ describe("Trigger processing", function()
             assert.is_equal(2, count, "a trigger set to expire after 2 fires should fire exactly twice")
         end)
 
+        -- Regression: the C++ helpers that run trigger/alias/script code used to
+        -- read the script's return value from an absolute stack slot and then
+        -- wipe the whole shared Lua stack. Running inside feedTriggers() those
+        -- slots hold feedTriggers' own arguments, so the Utf8Encoded boolean
+        -- below was mistaken for "the script returned true" and kept renewing
+        -- the expiry count, and the wipe took the caller's arguments with it.
+        it("expires on schedule when fed by a call that has arguments on the Lua stack", function()
+            _G.TrigSpecExpire = {count = 0}
+            local id = tempTrigger("expire_me_utf8", [[_G.TrigSpecExpire.count = _G.TrigSpecExpire.count + 1]], 1)
+            assert.is_number(id)
+            feedTriggers("\nexpire_me_utf8\n", true)
+            feedTriggers("\nexpire_me_utf8\n", true)
+            feedTriggers("\nexpire_me_utf8\n", true)
+            local count = _G.TrigSpecExpire.count
+            _G.TrigSpecExpire = nil
+            if type(id) == "number" and id > 0 then killTrigger(id) end
+            assert.is_equal(1, count, "a trigger set to expire after 1 fire must not be renewed by the caller's stack")
+        end)
+
     end)
 
     describe("tempColorTrigger legacy colour remap", function()

From 0b2e2548b26ad95bc553a9a73ec47edfc9fdf9f3 Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Tue, 4 Aug 2026 10:18:47 +0200
Subject: [PATCH 072/155] infra: check mpackage archives match their sources
 (#9624)

#### Brief overview of PR changes/additions

- Mudlet installs the `.mpackage` archive, not the loose
`config.lua`/`.xml` next to it, so editing a source without re-zipping
silently does nothing. `CI/check-mpackage-sync.py` compares every
archive member against its sibling source file.
- Packages the [package
repository](https://github.com/Mudlet/mudlet-package-repository) syncs
weekly need a version bump for `mpkg` to offer the update, so a content
change that keeps the old version number is now an error too.
- Enforced for base-ui, generic-mapper and gui-drop; `echo`,
`run-lua-code` and `deleteOldProfiles` have loose `.xml` copies that
already drifted from their archives, so those report as warnings rather
than blocking this PR.

#### Test case

`python3 CI/check-mpackage-sync.py --base-ref origin/development` passes
on development; it fails as intended when the base-ui `.xml` is edited
without rebuilding the archive, and when the rebuilt archive keeps
version `1.0.0`.

Assisted-by: Claude:claude-opus-5
---
 .github/workflows/check-mpackages.yml |  42 ++++++
 CI/check-mpackage-sync.lua            | 204 ++++++++++++++++++++++++++
 2 files changed, 246 insertions(+)
 create mode 100644 .github/workflows/check-mpackages.yml
 create mode 100755 CI/check-mpackage-sync.lua

diff --git a/.github/workflows/check-mpackages.yml b/.github/workflows/check-mpackages.yml
new file mode 100644
index 000000000..279c45aca
--- /dev/null
+++ b/.github/workflows/check-mpackages.yml
@@ -0,0 +1,42 @@
+# Mudlet installs the .mpackage archives, not the loose sources next to them,
+# so an edit that isn't re-zipped silently does nothing. See CI/check-mpackage-sync.lua.
+name: Check mpackages
+
+on:
+  pull_request:
+    paths:
+      - '**.mpackage'
+      - 'src/mudlet-lua/lua/base-ui/**'
+      - 'src/mudlet-lua/lua/generic-mapper/**'
+      - 'src/mudlet-lua/lua/gui-drop/**'
+      - 'CI/check-mpackage-sync.lua'
+      - '.github/workflows/check-mpackages.yml'
+  workflow_dispatch:
+
+concurrency:
+  group: ${{github.workflow}}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  check-mpackage-sync:
+    # Skip release PRs (base main): a package that changed during the cycle was
+    # already version-checked when it landed on development.
+    if: github.event.pull_request.base.ref != 'main'
+    name: Check archives match their sources
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+
+      - name: Install Lua 5.1.5
+        uses: leafo/gh-actions-lua@v13
+        with:
+          luaVersion: "5.1.5"
+
+      - name: Fetch base branch
+        if: github.event_name == 'pull_request'
+        run: git fetch --no-tags origin ${{ github.base_ref }}
+
+      - name: Check mpackage archives
+        run: lua CI/check-mpackage-sync.lua ${{ github.event_name == 'pull_request' && format('--base-ref origin/{0}', github.base_ref) || '' }}
diff --git a/CI/check-mpackage-sync.lua b/CI/check-mpackage-sync.lua
new file mode 100755
index 000000000..864e4294d
--- /dev/null
+++ b/CI/check-mpackage-sync.lua
@@ -0,0 +1,204 @@
+#!/usr/bin/env lua
+--[[
+Check packaged .mpackage archives against their checked-in sources.
+
+Mudlet installs the .mpackage archive, not the loose config.lua/.xml files
+sitting next to it, so editing a source file without rebuilding the archive
+silently changes nothing at all.
+
+Some of these packages are also published to the package repository
+(Mudlet/mudlet-package-repository), which offers updates by comparing the
+version in config.lua. A content change that keeps the old version number
+never reaches players who installed the package with mpkg.
+
+Run with no arguments to check archive contents. Pass --base-ref to also
+require a version bump for any package whose contents changed:
+
+  lua CI/check-mpackage-sync.lua --base-ref origin/development
+]]
+
+-- packages built from the loose sources next to them - the two must agree
+local sourcedPackages = {
+  "src/mudlet-lua/lua/base-ui/mudlet-base-ui.mpackage",
+  "src/mudlet-lua/lua/generic-mapper/generic_mapper.mpackage",
+  "src/mudlet-lua/lua/gui-drop/gui-drop.mpackage",
+}
+
+-- packages the repository syncs weekly, where mpkg needs a version bump to
+-- offer the update - see update-core-packages.yml in the package repository
+local publishedPackages = {
+  "src/deleteOldProfiles.mpackage",
+  "src/echo.mpackage",
+  "src/enable-accessibility.mpackage",
+  "src/mudlet-lua/lua/base-ui/mudlet-base-ui.mpackage",
+  "src/mudlet-lua/lua/generic-mapper/generic_mapper.mpackage",
+  "src/run-lua-code.mpackage",
+}
+
+local errors = {}
+local warnings = {}
+
+local function contains(list, wanted)
+  for _, item in ipairs(list) do
+    if item == wanted then return true end
+  end
+  return false
+end
+
+local function quote(argument)
+  return "'" .. argument:gsub("'", "'\\''") .. "'"
+end
+
+local function capture(command)
+  local pipe = assert(io.popen(command, "r"))
+  local output = pipe:read("*a")
+  pipe:close()
+  return output
+end
+
+local function readFile(path)
+  local file = io.open(path, "rb")
+  if not file then return nil end
+  local contents = file:read("*a")
+  file:close()
+  return contents
+end
+
+-- Every entry in the archive, mapped to its bytes. Directory entries, which
+-- zipinfo lists with a trailing slash, are not files and are skipped.
+local function contentsOf(archive)
+  local members = {}
+  for name in capture("unzip -Z1 " .. quote(archive)):gmatch("[^\n]+") do
+    if not name:match("/$") then
+      members[name] = capture(string.format("unzip -p %s %s", quote(archive), quote(name)))
+    end
+  end
+  return members
+end
+
+local function sameContents(one, other)
+  for name, bytes in pairs(one) do
+    if other[name] ~= bytes then return false end
+  end
+  for name in pairs(other) do
+    if one[name] == nil then return false end
+  end
+  return true
+end
+
+local function versionOf(members)
+  for line in (members["config.lua"] or ""):gmatch("[^\n]+") do
+    local version = line:match("^version%s*=%s*(.-)%s*$")
+    if version then
+      return (version:gsub("^[%[\"']+", ""):gsub("[%]\"']+$", ""))
+    end
+  end
+  return nil
+end
+
+-- Sortable form of a version, tolerating parts like "2" or "1.0.0rc1"
+local function versionParts(version)
+  local parts = {}
+  for part in version:gmatch("[^.]+") do
+    parts[#parts + 1] = {tonumber(part:match("%d+")) or 0, part}
+  end
+  return parts
+end
+
+local function isNewer(candidate, existing)
+  local new, old = versionParts(candidate), versionParts(existing)
+  for index = 1, math.max(#new, #old) do
+    local newPart = new[index] or {0, ""}
+    local oldPart = old[index] or {0, ""}
+    if newPart[1] ~= oldPart[1] then return newPart[1] > oldPart[1] end
+    if newPart[2] ~= oldPart[2] then return newPart[2] > oldPart[2] end
+  end
+  return false
+end
+
+-- Archive contents at baseRef, or nil if the package is new there
+local function contentsAtBaseRef(path, baseRef)
+  local temporary = os.tmpname()
+  local archive = capture(string.format("git show %s 2>/dev/null", quote(baseRef .. ":" .. path)))
+  if archive == "" then
+    os.remove(temporary)
+    return nil
+  end
+
+  local file = assert(io.open(temporary, "wb"))
+  file:write(archive)
+  file:close()
+  local members = contentsOf(temporary)
+  os.remove(temporary)
+  return members
+end
+
+-- Every member with a file of the same name beside the archive must match it
+local function checkSourcesMatch(path, members, enforced)
+  local directory = path:match("^(.*)/[^/]+$")
+  for name, packaged in pairs(members) do
+    local source = directory .. "/" .. name
+    local onDisk = readFile(source)
+    if onDisk and onDisk ~= packaged then
+      local complaint = string.format("%s does not match %s - rebuild the archive after editing the source", path, source)
+      table.insert(enforced and errors or warnings, complaint)
+    end
+  end
+end
+
+local function checkVersionBumped(path, members, baseRef)
+  local was = contentsAtBaseRef(path, baseRef)
+  if not was or sameContents(was, members) then return end
+
+  local old, new = versionOf(was), versionOf(members)
+  if not new then
+    table.insert(errors, string.format("%s has no version in its config.lua", path))
+  elseif old and not isNewer(new, old) then
+    table.insert(errors, string.format("%s changed but is still version %s - bump it so mpkg offers the update", path, new))
+  end
+end
+
+local baseRef
+for index = 1, #arg do
+  if arg[index] == "--base-ref" then
+    baseRef = arg[index + 1]
+  elseif arg[index]:match("^%-%-base%-ref=") then
+    baseRef = arg[index]:match("=(.*)$")
+  end
+end
+
+local checked = {}
+for _, path in ipairs(sourcedPackages) do
+  table.insert(checked, path)
+end
+for _, path in ipairs(publishedPackages) do
+  if not contains(checked, path) then table.insert(checked, path) end
+end
+table.sort(checked)
+
+for _, path in ipairs(checked) do
+  if not readFile(path) then
+    table.insert(errors, string.format("%s is listed in this script but does not exist", path))
+  else
+    local members = contentsOf(path)
+    checkSourcesMatch(path, members, contains(sourcedPackages, path))
+    if baseRef and contains(publishedPackages, path) then
+      checkVersionBumped(path, members, baseRef)
+    end
+  end
+end
+
+for _, warning in ipairs(warnings) do
+  print("warning: " .. warning)
+end
+for _, message in ipairs(errors) do
+  print("error: " .. message)
+end
+
+if #errors > 0 then
+  print(string.format("\n%d problem(s) found. Rebuild an archive with:", #errors))
+  print("  cd  && zip .mpackage config.lua .xml")
+  os.exit(1)
+end
+
+print("mpackage archives match their sources.")

From f7da6ca3daa0931f02513a365935fcc7843c02f6 Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Tue, 4 Aug 2026 10:18:48 +0200
Subject: [PATCH 073/155] improve: ship every default package as an mpackage
 (#9626)

#### Brief overview of PR changes/additions

- Every package Mudlet preinstalls now lives in `src/packages//`,
holding its `config.lua`, `.xml` and the `.mpackage` built from them -
previously they were scattered across `src/` and `src/mudlet-lua/lua/`,
and four had no metadata at all.
- The game loaders (Carrion Fields, Icesus, MorgenGrauen, Medievia) and
the two `mudlet.org` dev packages shipped as bare xml, so the Package
Manager showed them with no version, author or description. They are
packaged now, keeping their existing package names so nothing renames on
upgrade.
- New `DefaultPackagesTest` walks the preinstall table for seven games,
checks every queued path is really compiled in, and installs all 15
archives.

#### Motivation for adding to Mudlet

An mpackage carries Mudlet's metadata and a bare xml cannot. Keeping
each package's sources next to its archive also makes the Lua reviewable
in diffs, which a committed zip on its own is not.

#### Other info

Stacked on #9624, whose check now covers all 15 packages. The IRE mapper
stays an xml because upstream publishes it that way and
`update-3rdparty.yml` overwrites it weekly. Package repository PR
Mudlet/mudlet-package-repository#746 updates the sync paths and must
merge right after this.

#### Test case

`ctest` 66/67 locally (`TKeySequenceEditTest` is the known headless
flake - passes under openbox); `DefaultPackagesTest` 28/28; `python3
CI/check-mpackage-sync.py --base-ref origin/development` clean.

Assisted-by: Claude:claude-opus-5

---------

Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>
---
 .gitattributes                                |    4 +
 .github/workflows/check-mpackages.yml         |    5 +-
 .github/workflows/update-3rdparty.yml         |    2 +-
 CI/check-mpackage-sync.lua                    |   70 +-
 docs/libmudlet-perf-baseline.md               |    2 +-
 src/deleteOldProfiles.xml                     |   97 --
 .../lua/enable-accessibility/config.lua       |   12 -
 .../StressinatorDisplayBench.mpackage         |  Bin 1065814 -> 0 bytes
 src/mudlet.cpp                                |   50 +-
 src/mudlet.qrc                                |   30 +-
 src/packages/CF-loader/CF-loader.mpackage     |  Bin 0 -> 111207 bytes
 src/{ => packages/CF-loader}/CF-loader.xml    |    0
 src/packages/CF-loader/config.lua             |   16 +
 .../MedBootstrap/MedBootstrap.mpackage        |  Bin 0 -> 110951 bytes
 .../MedBootstrap}/MedBootstrap.xml            |    0
 src/packages/MedBootstrap/config.lua          |   16 +
 src/packages/README.md                        |   35 +
 .../StressinatorDisplayBench.mpackage         |  Bin 0 -> 1071483 bytes
 .../StressinatorDisplayBench.xml              |    0
 .../StressinatorDisplayBench/config.lua       |    9 +
 src/packages/deleteOldProfiles/config.lua     |   34 +
 .../deleteOldProfiles.mpackage                |  Bin
 .../deleteOldProfiles/deleteOldProfiles.xml   |  100 ++
 src/packages/echo/config.lua                  |   57 +
 src/{ => packages/echo}/echo.mpackage         |  Bin
 src/{ => packages/echo}/echo.xml              |    6 +-
 src/packages/enable-accessibility/config.lua  |   32 +
 .../enable-accessibility.mpackage             |  Bin
 .../enable-accessibility.xml                  |    3 -
 src/packages/generic_mapper/config.lua        |   28 +
 .../generic_mapper}/generic_mapper.mpackage   |  Bin
 .../generic_mapper}/generic_mapper.xml        |    0
 .../generic_mapper}/versions.lua              |    0
 src/packages/gui-drop/config.lua              |   18 +
 .../gui-drop/gui-drop.mpackage                |  Bin
 .../lua => packages}/gui-drop/gui-drop.xml    |    0
 src/packages/icesus-loader/config.lua         |   15 +
 .../icesus-loader/icesus-loader.mpackage      |  Bin 0 -> 111191 bytes
 .../icesus-loader}/icesus-loader.xml          |    0
 src/packages/mg-loader/config.lua             |   16 +
 src/packages/mg-loader/mg-loader.mpackage     |  Bin 0 -> 111245 bytes
 src/{ => packages/mg-loader}/mg-loader.xml    |    0
 src/{ => packages/mpkg}/mpkg.mpackage         |  Bin
 .../mudlet-base-ui}/config.lua                |    0
 .../mudlet-base-ui}/mudlet-base-ui.mpackage   |  Bin
 .../mudlet-base-ui}/mudlet-base-ui.xml        |    0
 .../mudlet-tutorial/Mudlet Tutorial.xml       | 1186 +++++++++++++++++
 src/packages/mudlet-tutorial/config.lua       |   21 +
 .../mudlet-tutorial}/mudlet-tutorial.mpackage |  Bin
 src/packages/run-lua-code/config.lua          |   18 +
 .../run-lua-code}/run-lua-code.mpackage       |  Bin
 src/packages/run-lua-code/run-lua-code.xml    |   32 +
 src/packages/run-tests/config.lua             |   17 +
 .../run-tests}/run-tests.mpackage             |  Bin 115814 -> 117308 bytes
 src/{ => packages/run-tests}/run-tests.xml    |    0
 src/run-lua-code.xml                          |   32 -
 test/functional_tests/CMakeLists.txt          |    1 +
 test/functional_tests/DefaultPackagesTest.cpp |  231 ++++
 58 files changed, 1963 insertions(+), 232 deletions(-)
 delete mode 100644 src/deleteOldProfiles.xml
 delete mode 100644 src/mudlet-lua/lua/enable-accessibility/config.lua
 delete mode 100644 src/mudlet-lua/lua/stressinator/StressinatorDisplayBench.mpackage
 create mode 100644 src/packages/CF-loader/CF-loader.mpackage
 rename src/{ => packages/CF-loader}/CF-loader.xml (100%)
 create mode 100644 src/packages/CF-loader/config.lua
 create mode 100644 src/packages/MedBootstrap/MedBootstrap.mpackage
 rename src/{ => packages/MedBootstrap}/MedBootstrap.xml (100%)
 create mode 100644 src/packages/MedBootstrap/config.lua
 create mode 100644 src/packages/README.md
 create mode 100644 src/packages/StressinatorDisplayBench/StressinatorDisplayBench.mpackage
 rename src/{mudlet-lua/lua/stressinator => packages/StressinatorDisplayBench}/StressinatorDisplayBench.xml (100%)
 create mode 100644 src/packages/StressinatorDisplayBench/config.lua
 create mode 100644 src/packages/deleteOldProfiles/config.lua
 rename src/{ => packages/deleteOldProfiles}/deleteOldProfiles.mpackage (100%)
 create mode 100644 src/packages/deleteOldProfiles/deleteOldProfiles.xml
 create mode 100644 src/packages/echo/config.lua
 rename src/{ => packages/echo}/echo.mpackage (100%)
 rename src/{ => packages/echo}/echo.xml (95%)
 create mode 100644 src/packages/enable-accessibility/config.lua
 rename src/{ => packages/enable-accessibility}/enable-accessibility.mpackage (100%)
 rename src/{mudlet-lua/lua => packages}/enable-accessibility/enable-accessibility.xml (96%)
 create mode 100644 src/packages/generic_mapper/config.lua
 rename src/{mudlet-lua/lua/generic-mapper => packages/generic_mapper}/generic_mapper.mpackage (100%)
 rename src/{mudlet-lua/lua/generic-mapper => packages/generic_mapper}/generic_mapper.xml (100%)
 rename src/{mudlet-lua/lua/generic-mapper => packages/generic_mapper}/versions.lua (100%)
 create mode 100644 src/packages/gui-drop/config.lua
 rename src/{mudlet-lua/lua => packages}/gui-drop/gui-drop.mpackage (100%)
 rename src/{mudlet-lua/lua => packages}/gui-drop/gui-drop.xml (100%)
 create mode 100644 src/packages/icesus-loader/config.lua
 create mode 100644 src/packages/icesus-loader/icesus-loader.mpackage
 rename src/{ => packages/icesus-loader}/icesus-loader.xml (100%)
 create mode 100644 src/packages/mg-loader/config.lua
 create mode 100644 src/packages/mg-loader/mg-loader.mpackage
 rename src/{ => packages/mg-loader}/mg-loader.xml (100%)
 rename src/{ => packages/mpkg}/mpkg.mpackage (100%)
 rename src/{mudlet-lua/lua/base-ui => packages/mudlet-base-ui}/config.lua (100%)
 rename src/{mudlet-lua/lua/base-ui => packages/mudlet-base-ui}/mudlet-base-ui.mpackage (100%)
 rename src/{mudlet-lua/lua/base-ui => packages/mudlet-base-ui}/mudlet-base-ui.xml (100%)
 create mode 100644 src/packages/mudlet-tutorial/Mudlet Tutorial.xml
 create mode 100644 src/packages/mudlet-tutorial/config.lua
 rename src/{ => packages/mudlet-tutorial}/mudlet-tutorial.mpackage (100%)
 create mode 100644 src/packages/run-lua-code/config.lua
 rename src/{ => packages/run-lua-code}/run-lua-code.mpackage (100%)
 create mode 100644 src/packages/run-lua-code/run-lua-code.xml
 create mode 100644 src/packages/run-tests/config.lua
 rename src/{ => packages/run-tests}/run-tests.mpackage (93%)
 rename src/{ => packages/run-tests}/run-tests.xml (100%)
 delete mode 100644 src/run-lua-code.xml
 create mode 100644 test/functional_tests/DefaultPackagesTest.cpp

diff --git a/.gitattributes b/.gitattributes
index 80df9c528..e7aae23ec 100644
--- a/.gitattributes
+++ b/.gitattributes
@@ -2,3 +2,7 @@
 # assert the exact bodies that come back, so a Windows checkout must not turn
 # its newlines into CRLF.
 CI/http-fixtures/** -text
+
+# Each .mpackage archive stores a copy of the sources beside it, byte for byte,
+# so a Windows checkout must not rewrite the newlines of one and not the other.
+src/packages/** -text
diff --git a/.github/workflows/check-mpackages.yml b/.github/workflows/check-mpackages.yml
index 279c45aca..2d1642c66 100644
--- a/.github/workflows/check-mpackages.yml
+++ b/.github/workflows/check-mpackages.yml
@@ -5,10 +5,7 @@ name: Check mpackages
 on:
   pull_request:
     paths:
-      - '**.mpackage'
-      - 'src/mudlet-lua/lua/base-ui/**'
-      - 'src/mudlet-lua/lua/generic-mapper/**'
-      - 'src/mudlet-lua/lua/gui-drop/**'
+      - 'src/packages/**'
       - 'CI/check-mpackage-sync.lua'
       - '.github/workflows/check-mpackages.yml'
   workflow_dispatch:
diff --git a/.github/workflows/update-3rdparty.yml b/.github/workflows/update-3rdparty.yml
index 5c26c5adc..8a6cf374d 100644
--- a/.github/workflows/update-3rdparty.yml
+++ b/.github/workflows/update-3rdparty.yml
@@ -18,7 +18,7 @@ jobs:
             type: download
             url: https://raw.githubusercontent.com/Mudlet/mudlet-package-repository/refs/heads/main/packages/mpkg.mpackage
             file: mpkg.mpackage
-            path: src/
+            path: src/packages/mpkg/
             branch: update-mpkg-mpackage
             title: "Infrastructure: Update bundled mpkg.mpackage to latest upstream"
             body: |
diff --git a/CI/check-mpackage-sync.lua b/CI/check-mpackage-sync.lua
index 864e4294d..d3cdc26d6 100755
--- a/CI/check-mpackage-sync.lua
+++ b/CI/check-mpackage-sync.lua
@@ -17,26 +17,18 @@ require a version bump for any package whose contents changed:
   lua CI/check-mpackage-sync.lua --base-ref origin/development
 ]]
 
--- packages built from the loose sources next to them - the two must agree
-local sourcedPackages = {
-  "src/mudlet-lua/lua/base-ui/mudlet-base-ui.mpackage",
-  "src/mudlet-lua/lua/generic-mapper/generic_mapper.mpackage",
-  "src/mudlet-lua/lua/gui-drop/gui-drop.mpackage",
-}
-
--- packages the repository syncs weekly, where mpkg needs a version bump to
--- offer the update - see update-core-packages.yml in the package repository
+-- packages the package repository syncs weekly, where mpkg needs a version bump
+-- to offer the update - see update-core-packages.yml over there
 local publishedPackages = {
-  "src/deleteOldProfiles.mpackage",
-  "src/echo.mpackage",
-  "src/enable-accessibility.mpackage",
-  "src/mudlet-lua/lua/base-ui/mudlet-base-ui.mpackage",
-  "src/mudlet-lua/lua/generic-mapper/generic_mapper.mpackage",
-  "src/run-lua-code.mpackage",
+  "src/packages/deleteOldProfiles/deleteOldProfiles.mpackage",
+  "src/packages/echo/echo.mpackage",
+  "src/packages/enable-accessibility/enable-accessibility.mpackage",
+  "src/packages/generic_mapper/generic_mapper.mpackage",
+  "src/packages/mudlet-base-ui/mudlet-base-ui.mpackage",
+  "src/packages/run-lua-code/run-lua-code.mpackage",
 }
 
 local errors = {}
-local warnings = {}
 
 local function contains(list, wanted)
   for _, item in ipairs(list) do
@@ -134,14 +126,13 @@ local function contentsAtBaseRef(path, baseRef)
 end
 
 -- Every member with a file of the same name beside the archive must match it
-local function checkSourcesMatch(path, members, enforced)
+local function checkSourcesMatch(path, members)
   local directory = path:match("^(.*)/[^/]+$")
   for name, packaged in pairs(members) do
     local source = directory .. "/" .. name
     local onDisk = readFile(source)
     if onDisk and onDisk ~= packaged then
-      local complaint = string.format("%s does not match %s - rebuild the archive after editing the source", path, source)
-      table.insert(enforced and errors or warnings, complaint)
+      table.insert(errors, string.format("%s does not match %s - rebuild the archive after editing the source", path, source))
     end
   end
 end
@@ -167,38 +158,37 @@ for index = 1, #arg do
   end
 end
 
-local checked = {}
-for _, path in ipairs(sourcedPackages) do
-  table.insert(checked, path)
+-- every default package lives in its own directory under src/packages, named
+-- after the package, holding the archive and the sources it was built from
+local packages = {}
+for name in capture("ls -1 src/packages"):gmatch("[^\n]+") do
+  local archive = string.format("src/packages/%s/%s.mpackage", name, name)
+  if readFile(archive) then table.insert(packages, archive) end
 end
-for _, path in ipairs(publishedPackages) do
-  if not contains(checked, path) then table.insert(checked, path) end
-end
-table.sort(checked)
+table.sort(packages)
 
-for _, path in ipairs(checked) do
-  if not readFile(path) then
-    table.insert(errors, string.format("%s is listed in this script but does not exist", path))
-  else
-    local members = contentsOf(path)
-    checkSourcesMatch(path, members, contains(sourcedPackages, path))
-    if baseRef and contains(publishedPackages, path) then
-      checkVersionBumped(path, members, baseRef)
-    end
+for _, path in ipairs(publishedPackages) do
+  if not contains(packages, path) then
+    table.insert(errors, string.format("%s is listed as published but is not in src/packages", path))
   end
 end
 
-for _, warning in ipairs(warnings) do
-  print("warning: " .. warning)
+for _, path in ipairs(packages) do
+  local members = contentsOf(path)
+  checkSourcesMatch(path, members)
+  if baseRef and contains(publishedPackages, path) then
+    checkVersionBumped(path, members, baseRef)
+  end
 end
+
 for _, message in ipairs(errors) do
   print("error: " .. message)
 end
 
 if #errors > 0 then
-  print(string.format("\n%d problem(s) found. Rebuild an archive with:", #errors))
-  print("  cd  && zip .mpackage config.lua .xml")
+  print(string.format("\n%d problem(s) found. Rebuild an archive from its sources with:", #errors))
+  print("  cd src/packages/ && zip .mpackage config.lua .xml")
   os.exit(1)
 end
 
-print("mpackage archives match their sources.")
+print(string.format("%d mpackage archives match their sources.", #packages))
diff --git a/docs/libmudlet-perf-baseline.md b/docs/libmudlet-perf-baseline.md
index 5082c34be..cff2c99fa 100644
--- a/docs/libmudlet-perf-baseline.md
+++ b/docs/libmudlet-perf-baseline.md
@@ -153,7 +153,7 @@ ideally over a couple of runs or with a slightly relaxed threshold.
 `PipelineBenchmark` deliberately stops at the core pipeline: it runs offscreen
 and never paints a widget, so it does not measure the on-screen rendering and
 echo path. That path needs a live window and is covered by the **Stressinator
-display benchmark** (`src/mudlet-lua/lua/stressinator/StressinatorDisplayBench.xml`),
+display benchmark** (`src/packages/StressinatorDisplayBench/`),
 pre-installed into the `mudlet.org` self-test profile.
 
 - Interactively, in a running profile, type `stresstest 100000` to feed that many
diff --git a/src/deleteOldProfiles.xml b/src/deleteOldProfiles.xml
deleted file mode 100644
index dd1e91639..000000000
--- a/src/deleteOldProfiles.xml
+++ /dev/null
@@ -1,97 +0,0 @@
-
-
-
-    
-    
-    
-        
-            delete old profiles
-            
-            
-            
-            ^delete old (profiles|maps|modules)(?: (\d+))?$
-        
-    
-    
-    
-        
-            
-        
-    
-    
-
diff --git a/src/mudlet-lua/lua/enable-accessibility/config.lua b/src/mudlet-lua/lua/enable-accessibility/config.lua
deleted file mode 100644
index f92effcf8..000000000
--- a/src/mudlet-lua/lua/enable-accessibility/config.lua
+++ /dev/null
@@ -1,12 +0,0 @@
-mpackage = [[enable-accessibility]]
-author = [[Mudlet]]
-title = [[Enables better accessibility on demand]]
-description = [[`mudlet accessibility on` will toggle a few settings for a better visually impaired experience:
-
-* auto clear input line after sent text
-* disable showing sent text
-* hide blank lines (on windows)
-* offer workaround VoiceOver announce issue (on macOS)
-* set Ctrl+Tab as a shortcut to enable caret mode]]
-version = [[1.0]]
-created = "2022-07-31T19:25:07+02:00"
diff --git a/src/mudlet-lua/lua/stressinator/StressinatorDisplayBench.mpackage b/src/mudlet-lua/lua/stressinator/StressinatorDisplayBench.mpackage
deleted file mode 100644
index 7847f2faaecb083c2b9fc352815bcd387faef311..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 1065814
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
lnKvI~1!b%O
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
$#RnF@`jO
zU|BES%*<;N`q8B|i_?Axj&JMwyk5ZOmBs>y+-#fhoEtTC5lX7M6g~)Bwb%J!w4!=g
zL0O2+>U^G(0!9euigMmO?lWpStv0tK+%R@>Hr#ZjV3QmA=`XBpmcJq0vN2^<+x6iW
z2WRbHMT9T~U9785XL?o@oqBh$IbdXPjXz6w_FUn$rJ6b90T=dWR42{Alk`x}lWSE1
z^0&6ZMI}d>x!agWkbQ-dNPV@md5!ej8WA>p7Scr@iu0R0CYF%Y<%%DkP5{^sb^UAY
zW}LUVi+f*&R-^fupf{+0PbnXqRSgUTN*(7Gh4NmOY_Q#CO^{=HUVV3Ueba{F1A~mZ
zcKMf`ECqinoKN3Lzvaf=XPrA|!dXK`01X^0K6oL$cxQBhwO2v$&pw6qF(eYG5A&G4
zS?OvF3ofc{iWs&o9+3(9wf($vOdtKoNpFt1bT(M=2QV1kQB5=VW@l;neGh_@p3x5S
zG`3$R=%rG+n8O~C*?FjuR^D3^-{nJwwPe_(+Fma;p~W-El7r#K>FBz`V~o>T8|>6@
zEuJ#uB>l?vX)S!?dDLI?KOdd&=CyFC6RQ`JHy`EFx=b}@D?{cKb(^9FfnaET)zUK0
zNW8q+?Z@k|sD_Tyc;k|zZn|8QsleC_>%xgoTlhwQP?3ZRhgpc+?j&9CSE=$ACL9;S
zB9i(dvGq_$*Hh%ytLin|yP+q^--g!@e|5v&?$P|P71H8a5_d;dlMzerLJfAS0=SjA
z0$48~)k1vwiOB0h-4P^&N0WiHW|NW1xQ#&*G8s!DL%KcDgT>d^Ogn;>L{oT~|Bg$b
z0;kPGT)L9*`jdBDoY&?)-n?xuB}@VhCyaC5y;}7C{UU{hBA_Z)W937tVvHgCq_(h4
zsCIsxop@qiq4UAY(7>dR)V^{LUX{3UL7e6@Pa95x%W4A$-R0cZqcguuQ!72@bgXvP
zx3+v63V8jq^~Q7-T52YM%n_zdX8Fr&`RO=ZQTKe+)_uwzhHAa~0re_oW$S2^0Jl^O
z1p!$|k+|wcgTjXO=?MhAoi{EjNfZv1H(sjMS4YHS=m8Poc^7tn-(FAWxwLfa$v|i8
zf1mQ7L76K5HSJ4ZFaB@rLs^-*z7t1#u0h(GMw`-8Qn5%O$J%rm!0&|%fa(3JcaDb;
zFx_k|=+I9S0T4f9@g8pcp0^BqeIek--dzp2q2Rf
zgQB(Z{WDO)uSnjP=4I%Fp79&oBdwPuK0NFma~B6!L>?5wEMJqp%EXJ?o%L8`L^!Ey
za~P^o(x5i}H@J%>eN~81XCMVR>g=`V#bWw+CX>8v8Q^o+a_F4G7Pas+JR<7XvJtIB
z9aiZ{OHa&Ou~?0DdAs}GMnR7HKme&Y%PmeG7o&EN&rbumCqb4bUIs(tv((xqPL{(I
zaNp8w3yyrFDuQNPM{2^3w{$Ao>bc4-$t?54F|E)2ZYDO~;x>w?2C4I5&CTFu5dAQi
zW@mo>#H#u`tk-_JQDY80MweAJu`3(2fsBr4nz3rOnT|F|W;e%{*=yb$gleIaCIr08
zH=`-^d^7Hzkqqc{_&W%1w_-IJu^N{|K0l#2YnN(K%7n5M!&P~S`+)GJCfWPKKD}d2YAIVcEc}R)dz$2wzj{3Z5}W
z3|>bN-*)_Pbk`@wSFvW7@)Mq>awkx5I1*~UM#mQ~m7UwG_0pBqr`yIO;bm{c<;1Y@
zSeqZGy*(R(K#aWsN7o=09tQ|mj6JVBzGQ!d%!JHmlnKRH0}8q8?6H|nAgRPTA1RnLaaFl(<|a21*keBMjihWR_Mh!5Jyl
z_^uAqiL5uz$Edt`?Me^%(#+n$m#G*4nM1O#Y*~m}BJJzCvYc&I{YqrX(^XF%MV9e%bJU>3B?z2iZQGkaOKb1Zha%FdU)ZnnW8_J&#`!fx{pS3{tkwi92Jg*Z
z42f7X+am^U={dn0*AB65&7qZF2JgT}7c}P4DDqURcKW5i+M7`6qRQQ=q9Ta-dLCRB
zp(XGn&+K>AcwCgf{_Pu$bcC*}vCbn{x|=YLLTRAy`|7k1pBDKjgqfFDpQ#1=Rz8{{
z0V-nnF=Jf;CJT9<+;kb)z?UdE5~hFkw&8r&6=wHPIR}BuVU|2|({tX*)?UEZCYA2q
zJ(;;=goqhAUOw?Z&iaNPe~c(I)Tq|nBtd@+;a%uG_>RzrkCD++qD+E^7xXfy%$okU
zQK{;fWkZ!rR8e~qQmD1gmz0wN)|S1B+}E&r(Orgm?g+6aFugYKY?}^+bD9L#3+#*|
zZ*r=%#;l-zmIFi{Z!sY5Z9R}6VJb7#6zE6zW1%%fI89rfakL98pNFXSX7MW$b?1Yp
zM!lnIAAdIBQPduKW5k+>25JZzf
zOkdEeD8s~>hl|Tf5A1%V#awLiru42_*jRh;w;G`maoHAxqHj@dgvwGnZhr4Br|XQw
zUoz*|kIPCy?6s!7hoFI@$zn9gDslE?jRAZhikS$HVcjc*skVe)?`oiuB+MQyTWrPc
z+)g&HBH};5bA%l>c6khHVN9ZOHbrIxaN9i3km+yDmzwA|oPQT#)vurlo+B&uw?e;b
zTA86eDd}~ds_Y{hI{x&SCDAIZ7y1bH&ip$S<`p<*7UET6s3Ax?lT3nSW9IQ@e;_0A
z5a&0p)FrP!aYY-_>j2g1Q16mIx1kDM`-B5W(l#V4(HYu2+<{ZlIm-OnILK7i4pk2>
z?ktbENui5@3sFeLZTb?4@`dMD@8k-%M}0}MOOo3Dn-$$Wm>M`1gwV$^3kdMpnPnD2
zqV`A#bFbATH0I06W~J$MUMq?3b$a^Q;gJBLcRFd=mT~UIclpalU$E^pte52V$ti>q
zMe=WGuaq0^>?@{q#nD||?aJ|$9&~`_OqSk%@G>hpETBx6lPt%V@B;95!hO7_h&9s?
zcg$gC=kpJlNYFyCi~QQiqjJoXV-n#3bWmK_RHF7m<4xHjT9^_;bTUu1`$hGK1iMpV
zvhB~VYR9j3Qc?a;St7>e`t0O{p;-#SAoER@71!3_ESlmrLo?S2_zVy;c4j18S`I~5
znv0@W)r#Zn`kF7p4+@kD*;#86aKz>GEFtg1=;fK0VIwpf=Y$-ejI>@aT(+#x5So<)
z2s>!1T~p5wccm3WRf{(3hNj^mroZ@94I~0#A*rgaYDc$_s!qR|nzr(80+Gm>2b+FXN}&mY9*F>nWd@6AFW#TLk8
zc17GYyPYW@+rx9^fGn00`h%%f+%%op*YK5QKn5?goK?_>c2`%KdD8X3EN^|NZ?|Er
z6r1lxf06iMdv}Tu`QXG7%!ba@P~RQ^!Y&gdxP-RY1CZx(SM*v;Ye-M@q^W;e7Iy>v
zcOuPjm)wat_^Bpg#jxC~ahS6v>=z@V!gE5VZ$e0iR>b|WCd)`O@;+G{d@O}9AdTc|
zj=Y1grcCFg!1vPNmfE375b`}a`o-2;sSPgaqiC`#H#<^G5nxO@*4FNBS*q}h_mi%9
zKBw^1^r?pK8h_08jBgMyrW{7>QwD(Nr@&X@A4S0?v@EQ%=*kcnFnGR`2Vje|-D~CO
z5T?-J%fspgw+@_K48q*i++Yb+M&!fR!m##5Ha{}es$#5dMvl1;ifY6IKHnJ+^_X_m
zpBSlO8#{RVpQm7I*Ho8`1TmQ<+6VLM*q)0ZwRR;oMPeHrol2&qzi9iwY~sV@#;*Ti
z^^Z!T9E;?91_~Csd?@NURIC^E@TeHAR+FLP_cMCTF2cvD<}@_h^#5#!Ii-fz$MQQ!
zrB7Q+IywFq?o|?bZCmX^0rWU)6imY$b;XRJUzOfab{-cqgyO!s@Nta#7}9lP-i}lXIZ;N<1xchINK{5GwUMix+U-_PoR|Rs1bplz?1*6p(nT^UFhSWm0p;J
zDQTl)l#v3v(tvPU0Kd~I!bSM-h2P4eGvHeYOIbFyZfj%K%2@Qrv>w_2!8~WZM2h%B
zhH59U&ARwF@%H@%)9cp+Kv+!%+
z%in>`g?^7c%M7c{ua8RLJ3SV*tPbQs{}66R!sFx20ptvy&AM|zx+V0=gCbt|0}8>d
zElo#TDSCw?wF$IrT+b(c4M74$6JV+eu+GO1?uvx}|M%&)%u!`A`Dg~s>}X4GQ{)@(
zd5gpxZ8AQZ9-qEupK1W}oZy;b!r{A=CkIwkkzAH!CYlu&&YcogFYl;)!ERAljHQS
zrh9HC-`Kr%%oga2Lb;96Nn~RWOLg`7z$RQ5z1FqET$u2~i>o!~NWDC-y_8H|vq%9T
zZffCrDegLbd?6>BH7$D-xN{jjL}~9L=#492AM2vWnoCLOv!pD(fBkd4P1Q)BX}MiW
zW+$T_O0#?^#9Abs@3OVEnu3lYU~yYAMX+eH2>$?m{9Pz~e;C{uK^Ggh)Y`f@Nq3Y|
z%NcI{Q}~UH{USAvtjZE;eX5%l?n#R3YMFz4+arh!t~26p)TO>;rP_i=-!OOPoSOnB
z%0U+yR+oq}5RwL2h{snhp9>l!ux|lS7JotCwbi
zXW~vcEpkD17dZskX6Vn?n?}z=c6YBx^^sA#4!3H0>FI`fsT3Qbt}*aA6&Lx2siI&l
zI#W(!oN0nGP(~%4oa4+JeYL`t@U^~_4FqX|w;D@Z>v-h^gYMUJW
z@dU>#5*ySEZn`=eK1W}yJrjsa3=*SDT8;GOxUS_buj9x1q?nmBYGv$!(cf9anQ`ik
znccq7#m)8VQa!)WXcL6Xi>L6-Qva|oyZ#Wr8uNnjNy2C#I0(g#bZyW!P5Ys>`wBIb
zde=nJ676;$P2rn}(#1e>XwurQ4-|793wVK@js;v3r8xz=Po_s}SJ1xOH|`c2ypHzwOY3B`2NxW4S_OBl$=E<+8{
zZ44YL8LhdIZUtWzn_S>q{*dm1lM)&MyKjVrs`nV7;w5+@L^_|Xke}FE*kP%xzV7Er
z{$+w{Htp*zfNp73cMFp57|dHS;G?YyQ5AObl^hqK4b0rU0V|~g$>&;}`>8_V-8B~C
zrn*(XXkj-q_R`@(T{BINxmK$)#q()&JSN70PH&arqOJmu$xNX|`9cvc0}c(sZ5+5K
z4{to0l#S2aWqKuR7pahFp+up?&o|XrcV{YpF`qS8sZ#wWdTZJP&k)Z34nj76BojO(
zNays(3}2ZcKHt<9pWjaptDkB@2;SaUb-D$r4k{pRN~K9RBi$igO>cF=5wo
zq-4fXv{vIadJ2jlo6?`la()(rsb~Z)&#@$jT9u3WBJT7bP)(cLV9%GE(>6k?4vXSV
z{p71xI}{m6gl#78LWB!KJ<#UYZfUA>;x(NLKFn4gJhoXML#WE3|U!?!iHE4)yYpr!&edx@7vtX;#w#
zDh=EY+pPex!JSoKSq3ZW6A0QhMVBe*yqF0vPPtng1Ok})yMX;X1p~C9uXX;Q9Eo}!-0ffpg>!n*yDav9R2t`szfF2|
zyN0sgZn7N*t6vR`J$`dFL)Q19fZ@NxX;<1pZPlFU)rob>!uu;qrb{^eZr`U^@(V}3
zkISc&A4NbEn&I;r=9gMSsGV?*D8gnV{+R*W*46EM$qxyIz~6pH(d9xP=dE|E^sp{0
z7B9CXcJP)xge;`W$D>!bB8)&7-kx3~-1|+Y`tY7~*D_OtK&URs4R%
zG@b_*{`5Vhr>>)AOO;H=kO=MU{C(+<=y~I0LB1@KoB{H^7K)I%-OgLi*+hcgD%F0#
z_L9D_BwN`*2)?H@U-T@IHTs*sUr$a3xoXv&nS>9fzXpMf2NMRXyzzIzk7IL~O@RwC
z*^7d`0@KstYb+t`diw(N7UB_?RmqjnEDbm~sg?)enJR}_?@n)f7Wq~T~1NQtp!B1g!dYymY?&n$v`Li@P?FLRQhN-CXrsC$)VkC-6kBf+{
z&DaAP;l9EnI@fr-XCbp577>RHMDuxf5j5U}(uTYr->Ge9#J-wz64qG-TO$={Ea+$i
z9vV>sbZVh(Q^t@2aJ_Rb`0i4Bhqs!1K55kqCA-NNHv{T-93|6!M(^4*1`enu@pJRgTXGI}z3M3f3=HdCnn(YCK!
z)}8|GZ0I?~SFj6EItJxyQL+JsN(W=MU8ii6v$raab8%}NvaztEsDw&26%j;aF_YG<
zq2RFn&2+5naQFZNKpp1s&N#B;AIYlCk84=Bd=Ol#+gbZevTPJxB^8s)`g4h|;SL`1
z8Y+Msiw3?Y2hggVPv>KiiuionTMg0ZSy2km)&i4jZn?c0Ro5EB6@r6J1|&N-8P!R!
z5F4(R5{W+ZgB+cTjJV>&Yz!M}b;e_k}Y6rA}x)a*r+vtPc-
zrbEwELmWeSN*U;3Vep_Q72+c6oA>-E&=o#6{o03Pib=Z|8<_&nn2jlj|F4(L5|**N
zv^ZsJ(IzfX^#`tSb?j7Wy}Q3QWm%4OBhmHdfLPSDRMk8?*q<
zPqPzVNx0B{6XUcIR79O0%((;suKn-b$$yKJM}J5^yvIav=74o6zgQT!KP-2r&VAMDc0BM|@1Ah3r}hw_x`24)7SK`CRWs
zEYHFI#v8I|A*A2fWvOMYNQ+>bEN^5lW!Jy4^f%I*qFIRx`?*GV$tr+Sj4`x9zj5F4
zL!aJID|Vbd8}VG?P`;;^`>ocf6t!WY$z5!=cONbU{r!kwiX`mJc%Vs@sccb{z
z3$4ARl!~03K0WlXD~1b;1laP}QRxKIv2%kEP?uXx)jg*e%=498oPdq$yR@I>|3dG@G4;Z+bs?l*M>Ivv*O(TT6)sH8azA|5|1yWclO}#+HnP5
z0AtQ_gg`wem=sbh96!LL4^$TDc`nGd;E9H<)#Ciu*YrM3`5!j
zAJ=ALmLb6sqT{HANgd;XLcu!|lU}@7Npkt)6BU-P_-$_8r01NWgEwnfmT`UCAFk_i
zz;;Tf`RLO%Nr4P5CJ^fD+54L{%5GO`S)5A1BEB-+$juJCT|M?&esk7B-n~3mEB`|G
z&34NN9a)Xc1Lzy2!EDS>8vRbTH|g`cQ(8z^s*uX|X~;!mCKD4XtfLX^xGxJXs>x#=rSK7YaS}MThWMTf2Vs
z9=bQ0pR;LOv}AdLmbX)IdNDH-BKj8&64ZL`0cs-VE70KI-lEE?y-%9>p
zuL-_IuJRyxsZuK>X48*l(6dh_^(nNGFlN>zY-$^XqNKsqiK8b34Q?DgMSGZwXOD5<
zsqdu{u`ZZ=_zQNR?j8!9(d`+exAe!DuV9kqiGY;wcpM)KNC?r(Y8gt@H7i&T7#UIq
zL7!)=4WbS&y*2FV>HSP?ik$R`#cc7UHhU|5zpMU$s*Ap8`mZxxu*Rpxo`eY(gb>Y8
zzh+};`M2-W_d7M|QGlC5kTLBVGmt7CtQYQ%Rn*qZ{QHq05e;M&8=aMD}n8u$S3HX+PAo--S;RWVxEoa2MY|{Dwkh9{7H4a9`V@
zGQG7Cy<>BUO;_BZ(SFwit#(;c$y}ez4)`(XD)#T`+G~-4gf_qDxzzSOrJiBXv4i>*
zr>K*vPOk7cm{BZ0<1AaglFI=SI*mJ9n;l@^PYb7`9vAIyLwn=fG~8Lp4}cATY;E
zpGH9>hrH=&+iw&r)Fag$d*dS5?<$Lj>hmzSnfl6l2wEWdl+xVrC
zq`JewBVnS~H3lh^#&rs;8bW>U8`yTNt~SE7!2myaM;CPh_1o)h=a%gouMSNh9j)BI
zp5LR3$-g{94N>m1@xlkreF_WQBJI8$uL>w?LEahyFZt(k?2P20!
zO1d-5SjR$yl?ivd%O)fd-KbcwZ9W++J`NT&Gj?I|`8o?Ad~eIVq+0
zIMX^?bQ$k~8*^#bbagbl*WM1NwsWU`KmjPHgt+ifDfhUEzyfqr{DqCQiuhY;%0*>V
zKQ}u;q_d9HNf0gLwQdS*rN4EB9LYF-cUi|~tM
zF=~;Pc-qtxs%k?^7?CGECiL;&A%r6s70p!M+nXhE`!PpI&y5)5au#g~(W*}uw8aw7
zu7PFeEc=PVWn2os%2#kgPaZ5MHul-kEh51mtm*49MpSuiZt4^4XeLpvcX7zJ*I)}u{PlKkSJ(rKr5_i9x
z7S$4FRJ6T0X{182$uaSdqkSj}JhpTtin4?l@Hi0o!dN4YrgD_|${Q$A#H7S}x%x~K
z9s3o{h;ohT$6>fDNIaaF!o{9qJ}=-JtVd^rl(m`fDP3_l%GKAfq`?(O)cv-Cf_mS%
zQ_TtgXM1egR33-L!;fmFrf;!>=_P~DY+ayBa8V!ULTB_5;&blp-kq$LGG*kEK^eq0
z!;qb>r8ewd^w%wwdR!1MtsM`(GOQbbr2FUJqlF}hCBv!X^8RdA4hI+)NlE4=C`a`M
z@}b{8)?!vj6{*>jn3M|efXU#<4AI-^*FlVEMcH`o+DzbRVBVEiiER91M=+iy2CgkS1cuL*1cAM2K*N=yl
zfT^G>(|SPB#mX8yHv?p2)!HpD0{T1g@Zy*(o}a>679CII`6F7T=PSu}
zKfidiv7*u%Zuu=Dp0a*%ruD}(IL-O~X
zi+FWtsW*mDn}%5jb~&Wxw||AK;6JFwj`P4uQGdpKG(A4a4D$BJ8z*DoWY7&9a>^Rz
z+UR+Od>#XxXi40HMzm;J~BJ3>(59wYF}eMRW6
zFEc~Sqqn0+{NOx+wBo2g;d4$1SF9E(v#4F503xB>XoRDQa|2Q^z*hZ*wr
zWuj&7z^1l0=i$7m@4@x)QrqAGhaDxG4Rf##Q5F$fPA(R7>|1H=X}6qh(wLU!=oCK{
zU8wk}IVy*HBY!^z8XOr7rMaGNNBz#<5C}ww!;CDr0YZdvf)5tr@l35>CjC&2DQ83U
z0eRvaL#=4^>8^VMZTQSshkuopabsP)?|PW;g1eS}%YCTa0eA5A+zd`v=L-5`isoY!
z#yA8-@1Um4_E^8b98ljLBMi4)CVC^ZLzj3_ch3!W`+2ZdNf9*Myv#sn+5mrTm638$Lj5$=ITtlxv751js5c(%UwIqHAK|YTl6tYL?2adrAe@I
zne?J-hMP8SdNKPB1q+2AK$MBK2K)`hnQK{VVWp+Zd-*yR`E4@n64oS?$@X_J6gV2k
zGEJqKwSk|V%fTc9_vHZC^-@3fOwY@RaW9uL6v~C3^dsC$$zCnI>T(3T!Gd$`yX@7`{{X|?$
z9XP$<@)R}Y#>g-LX(c(pE8GE8dM
zqGtk4_AyE>#H;B|*5bkkdk3u3?
zorHs-;0{cb)}ER@XapCD)T+lF3t?z>z@nP1T&nb+c;LgZ()GmwJZq`TWo@~VMRV@w
zp|DleP)@R->3To5)pod^!ms9Ip~N*dpa@_=u&{fkK-Gy@Q7X6LR_6{sO9A}A^MqZf
z0$u-~DC=S>Y-|%IV%C|dC!YyLqmVkDNEcErNRdwb9ZwRG6X^>x$!OhyPYh>e+X)<$
zBh`rvjVRr@uHO*TmKOhS0)+rr(gKS9+eFI4poZ<6)z@}vhW4Hc3=xY2=RDQ6xKf;f
zwB*+DbN?M}$M>7w{8+!QSm>#Pm347}l_>g1S;?z9pS5yQFj4h4Q3ln{^QMEjlF|7J
zeR0lYjRycYU44;kjs<8Hnd}p}MuLXy*1SRbD!hR!w2o^lv{@B=16Wo%?s~y$tMtCn
z!s7Q$b4L=To2&9J+g75vzB3`vaH6Dtz2<##gM?&$+HSpJOt=RrwBcDMu|aaCpw2sm
zvnH3@OW9)O(!EFIEIJ(W{Lbv%Jweo;-kj(6&3u~Q@!rMm+K`);EyKSY{_<~!8Pf_F
zZF`1;)}N!1a3nx^ZLg*ykT+@d&A=_sF6Ub*8)Qzm?a|j$4fS2^{$OR-=Rt5*Fiiwz
zy+LMJQIwUseVsJZqgTgtLuRoeB;&DA-jgj@-1MbNk8=xQ6H$wVCbtMixM{lC|GNIW
zzx%uNH)#iqH&6WNS`7AD?&1T&S(b+!G7smp6A;NZ$Scin
zudZ%JK*5z~aMK^_KduEyruL&Me%W6SWG#L$cAW%uZZR=0KwWp=>)nER%(On3BOm$FOd!NB1
zd0Qk-huRH9KZm=`+;yH<)*30gM<3GR^HdP=ITmR!oxdx=
zOnoiwEB@uTJ>7p_N=oh?AV9t{k5hPOV#+8S?b=4pKf=vP6VB7Bu}|S=x~k_b>SCYy
z2H%B6n57@DH~m$0$uZ-|_V9mk2&vD}-dEl0Z{P%~?(AI26HA1tpCF@&d#Yj@^gXJM
z^mpG@o1qEIi%m*#HS0Q^({B&ey()7)b*%rg*v4eCUrE63VfC$votQX;jE#M9ds^-(
z91;N|!Hs<@lT=#sJZHh?3!KdS>eD-TDihMa4K<+$f!DMzB5^6CC>48l&1jB5mHN%3
z+7noW8WGdvp1!XX8qMU)qpQZFlMpw$E-_4eO7mc%LHXI2f-M#`DuJN-m8=tNZW4f#
z;G0ElowGdxGx&J%z_N4)aR>JG;x@EDhkzLQ1Pz&RFVv}Ft-jA!3>9t$_YhFy+;YIJldjo}3GbM9K4q%Y1
zbcltfa9I~I0+lo~o4<*hK?)LD<>(7}w`-H(qg*c-P}kJf{-wWC@Bd--yLgPcC-)}e
ztyd1EkMip25?kRPX<8=B?W
zuBom-%w+71z4EAUB7@Vj^#(!yBB4W}3|kG?d$b=g?L^`R#uNaP&Ygf$i7pi)N6JZo
zL+3JI3ngLkCmdf7Y1isS*llV!ihpOoSDqD+HTF()5mkFWRw>|(>9g550=Zs}LOg%M
zs{;SRQ1fWUvN8*?1SXc0J-}n#p3S!KSPf^=&xe_bP;5uZ1quX#l55m^7*SmmVs0
f
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
!%x0aRks*}g3Km~8Y*&W2yaAppTUc-^Z?iU
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
OOP{cJOBvJHbWC9UR7(TuU(s=0Rv
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

diff --git a/src/mudlet.cpp b/src/mudlet.cpp
index 2a22b9a99..54a074245 100644
--- a/src/mudlet.cpp
+++ b/src/mudlet.cpp
@@ -7372,27 +7372,29 @@ void mudlet::setupPreInstallPackages(const QString& gameUrl, const QString& prof
     const QHash defaultScripts = {
             // clang-format off
         // scripts to pre-install for a profile      games this applies to, * means all games
-        {qsl(":/run-lua-code.mpackage"),             {qsl("*")}},
-        {qsl(":/echo.mpackage"),                     {qsl("*")}},
-        {qsl(":/deleteOldProfiles.mpackage"),        {qsl("*")}},
-        {qsl(":/enable-accessibility.mpackage"),     {qsl("*")}},
-        {qsl(":/mpkg.mpackage"),                     {qsl("*")}},
-        {qsl(":/mudlet-lua/lua/gui-drop/gui-drop.mpackage"), {qsl("*")}},
-        {qsl(":/CF-loader.xml"),                     {qsl("carrionfields.net")}},
-        {qsl(":/icesus-loader.xml"),                 {qsl("icesus.org")}},
-        {qsl(":/mg-loader.xml"),                     {qsl("mg.mud.de"),
-                                                      qsl("mud.morgengrauen.info"),
-                                                      qsl("mg.morgengrauen.info"),
-                                                      qsl("morgengrauen.info")}},
-        {qsl(":/run-tests.xml"),                     {qsl("mudlet.org")}},
-        {qsl(":/mudlet-lua/lua/stressinator/StressinatorDisplayBench.xml"), {qsl("mudlet.org")}},
-        {qsl(":/mudlet-mapper.xml"),                 {qsl("aetolia.com"),
-                                                      qsl("achaea.com"),
-                                                      qsl("lusternia.com"),
-                                                      qsl("imperian.com"),
-                                                      qsl("starmourn.com"),
-                                                      qsl("stickmud.com")}},
-        {qsl(":/MedBootstrap.xml"),                  {qsl("medievia.com")}}
+        {qsl(":/packages/run-lua-code/run-lua-code.mpackage"), {qsl("*")}},
+        {qsl(":/packages/echo/echo.mpackage"), {qsl("*")}},
+        {qsl(":/packages/deleteOldProfiles/deleteOldProfiles.mpackage"), {qsl("*")}},
+        {qsl(":/packages/enable-accessibility/enable-accessibility.mpackage"), {qsl("*")}},
+        {qsl(":/packages/mpkg/mpkg.mpackage"), {qsl("*")}},
+        {qsl(":/packages/gui-drop/gui-drop.mpackage"), {qsl("*")}},
+        {qsl(":/packages/CF-loader/CF-loader.mpackage"), {qsl("carrionfields.net")}},
+        {qsl(":/packages/icesus-loader/icesus-loader.mpackage"), {qsl("icesus.org")}},
+        {qsl(":/packages/mg-loader/mg-loader.mpackage"), {qsl("mg.mud.de"),
+                                                          qsl("mud.morgengrauen.info"),
+                                                          qsl("mg.morgengrauen.info"),
+                                                          qsl("morgengrauen.info")}},
+        {qsl(":/packages/run-tests/run-tests.mpackage"), {qsl("mudlet.org")}},
+        {qsl(":/packages/StressinatorDisplayBench/StressinatorDisplayBench.mpackage"), {qsl("mudlet.org")}},
+        // the IRE mapper is maintained upstream and published as an xml, so it
+        // is the one preinstall that is not packaged - see update-3rdparty.yml
+        {qsl(":/mudlet-mapper.xml"), {qsl("aetolia.com"),
+                                      qsl("achaea.com"),
+                                      qsl("lusternia.com"),
+                                      qsl("imperian.com"),
+                                      qsl("starmourn.com"),
+                                      qsl("stickmud.com")}},
+        {qsl(":/packages/MedBootstrap/MedBootstrap.mpackage"), {qsl("medievia.com")}}
             // clang-format on
     };
 
@@ -7405,7 +7407,7 @@ void mudlet::setupPreInstallPackages(const QString& gameUrl, const QString& prof
     }
 
     if (!mudlet::self()->mPackagesToInstallList.contains(qsl(":/mudlet-mapper.xml"))) {
-        mudlet::self()->mPackagesToInstallList.append(qsl(":/mudlet-lua/lua/generic-mapper/generic_mapper.mpackage"));
+        mudlet::self()->mPackagesToInstallList.append(qsl(":/packages/generic_mapper/generic_mapper.mpackage"));
     }
 
     // A modest starter UI that adapts to whatever any game provides, only for
@@ -7416,12 +7418,12 @@ void mudlet::setupPreInstallPackages(const QString& gameUrl, const QString& prof
     // connect time are handled at runtime instead - the starter UI stands
     // aside when one installs.
     if (!mudlet::self()->experiencedMudletPlayer() && !TGameDetails::gameProvidesOwnUi(gameUrl)) {
-        mudlet::self()->mPackagesToInstallList.append(qsl(":/mudlet-lua/lua/base-ui/mudlet-base-ui.mpackage"));
+        mudlet::self()->mPackagesToInstallList.append(qsl(":/packages/mudlet-base-ui/mudlet-base-ui.mpackage"));
     }
 
     // Don't play tutorial for every connection to localhost. There are legit other reasons to connect there.
     if (profileName == qsl("Mudlet Tutorial") && gameUrl == qsl("localhost")) {
-        mudlet::self()->mPackagesToInstallList.append(qsl(":/mudlet-tutorial.mpackage"));
+        mudlet::self()->mPackagesToInstallList.append(qsl(":/packages/mudlet-tutorial/mudlet-tutorial.mpackage"));
     }
 }
 
diff --git a/src/mudlet.qrc b/src/mudlet.qrc
index c6af22231..dba4841aa 100644
--- a/src/mudlet.qrc
+++ b/src/mudlet.qrc
@@ -3,11 +3,11 @@
         icons/logo_mm-120x30px-verticalBlackBgd.png
         ../translations/translated/translation-stats.json
         app-build.txt
-        CF-loader.xml
-        deleteOldProfiles.mpackage
-        echo.mpackage
-        mpkg.mpackage
-        MedBootstrap.xml
+        packages/CF-loader/CF-loader.mpackage
+        packages/deleteOldProfiles/deleteOldProfiles.mpackage
+        packages/echo/echo.mpackage
+        packages/mpkg/mpkg.mpackage
+        packages/MedBootstrap/MedBootstrap.mpackage
         edbee_defaults/Lua.tmLanguage
         edbee_defaults/Mudlet.tmTheme
         icons/120x30RoDLogo.png
@@ -220,22 +220,22 @@
         icons/window-close.png
         icons/wotmudicon.png
         icons/zombiemud.png
-        icesus-loader.xml
+        packages/icesus-loader/icesus-loader.mpackage
         lua-function-list.json
-        mg-loader.xml
-        mudlet-lua/lua/base-ui/mudlet-base-ui.mpackage
-        mudlet-lua/lua/generic-mapper/generic_mapper.mpackage
-        mudlet-lua/lua/gui-drop/gui-drop.mpackage
-        enable-accessibility.mpackage
-        mudlet-lua/lua/stressinator/StressinatorDisplayBench.xml
+        packages/mg-loader/mg-loader.mpackage
+        packages/mudlet-base-ui/mudlet-base-ui.mpackage
+        packages/generic_mapper/generic_mapper.mpackage
+        packages/gui-drop/gui-drop.mpackage
+        packages/enable-accessibility/enable-accessibility.mpackage
+        packages/StressinatorDisplayBench/StressinatorDisplayBench.mpackage
         mudlet-lua/lua/utf8_filenames.lua
         mudlet-mapper.xml
         splash/Mudlet_splashscreen_main.png
-        run-lua-code.mpackage
-        run-tests.xml
+        packages/run-lua-code/run-lua-code.mpackage
+        packages/run-tests/run-tests.mpackage
         shaders/vertex.glsl
         shaders/fragment.glsl
-        mudlet-tutorial.mpackage
+        packages/mudlet-tutorial/mudlet-tutorial.mpackage
         ui/custom_lines.ui
         ui/custom_lines_properties.ui
         ui/delete_profile_confirmation.ui
diff --git a/src/packages/CF-loader/CF-loader.mpackage b/src/packages/CF-loader/CF-loader.mpackage
new file mode 100644
index 0000000000000000000000000000000000000000..8ed1a5f904a314565cef9fd76d21838213f42d57
GIT binary patch
literal 111207
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
cO;If_LrBiSp~ZN07gV(Q?I8
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
HbjD~Km>a?@rc3+jr|-$0}qJH
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
z
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
mV%>>C&ahZ-Hc&8CcOUsI6R@Vey&-F%`l25bTIm
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
lnKvI~1!b%O
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%0Abtq@K|UkSW|
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%0A2vb7By!9nCJI7KPo2^aLPR!|R;B2vC
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
z
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
dH(s{{Pdt|K5i+aI_JJgF)7F13l
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
Y|7U+;VE;2&n15I4zp&;0{?C&9HzdHbSpWb4

literal 0
HcmV?d00001

diff --git a/src/icesus-loader.xml b/src/packages/icesus-loader/icesus-loader.xml
similarity index 100%
rename from src/icesus-loader.xml
rename to src/packages/icesus-loader/icesus-loader.xml
diff --git a/src/packages/mg-loader/config.lua b/src/packages/mg-loader/config.lua
new file mode 100644
index 000000000..1087dcec3
--- /dev/null
+++ b/src/packages/mg-loader/config.lua
@@ -0,0 +1,16 @@
+mpackage = [[mg-loader]]
+author = [[Mudlet Default Package]]
+icon = [[mudlet.png]]
+title = [[Laedt das MorgenGrauen-Interface beim ersten Verbinden herunter.]]
+description = [[### Beschreibung
+
+Wird auf neuen MorgenGrauen-Profilen vorinstalliert. Beim ersten Verbinden laedt es
+das vom MorgenGrauen-Team gepflegte Mudlet-Paket herunter, installiert es und
+entfernt sich selbst.
+
+### Siehe auch
+
+* [MorgenGrauen-Mudlet-Paket auf GitHub](https://github.com/MorgenGrauen/mg-mudlet)
+]]
+version = [[1]]
+created = "2026-08-04T00:00:00+00:00"
diff --git a/src/packages/mg-loader/mg-loader.mpackage b/src/packages/mg-loader/mg-loader.mpackage
new file mode 100644
index 0000000000000000000000000000000000000000..bad59182a06acd1f54b0c169c5602f3fe76e27fb
GIT binary patch
literal 111245
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
a>@5Dz_Ci4ZXRr|ej)H$KTdDic>-cX&F}+>@

literal 0
HcmV?d00001

diff --git a/src/mg-loader.xml b/src/packages/mg-loader/mg-loader.xml
similarity index 100%
rename from src/mg-loader.xml
rename to src/packages/mg-loader/mg-loader.xml
diff --git a/src/mpkg.mpackage b/src/packages/mpkg/mpkg.mpackage
similarity index 100%
rename from src/mpkg.mpackage
rename to src/packages/mpkg/mpkg.mpackage
diff --git a/src/mudlet-lua/lua/base-ui/config.lua b/src/packages/mudlet-base-ui/config.lua
similarity index 100%
rename from src/mudlet-lua/lua/base-ui/config.lua
rename to src/packages/mudlet-base-ui/config.lua
diff --git a/src/mudlet-lua/lua/base-ui/mudlet-base-ui.mpackage b/src/packages/mudlet-base-ui/mudlet-base-ui.mpackage
similarity index 100%
rename from src/mudlet-lua/lua/base-ui/mudlet-base-ui.mpackage
rename to src/packages/mudlet-base-ui/mudlet-base-ui.mpackage
diff --git a/src/mudlet-lua/lua/base-ui/mudlet-base-ui.xml b/src/packages/mudlet-base-ui/mudlet-base-ui.xml
similarity index 100%
rename from src/mudlet-lua/lua/base-ui/mudlet-base-ui.xml
rename to src/packages/mudlet-base-ui/mudlet-base-ui.xml
diff --git a/src/packages/mudlet-tutorial/Mudlet Tutorial.xml b/src/packages/mudlet-tutorial/Mudlet Tutorial.xml
new file mode 100644
index 000000000..6db413e99
--- /dev/null
+++ b/src/packages/mudlet-tutorial/Mudlet Tutorial.xml	
@@ -0,0 +1,1186 @@
+
+
+
+	
+	
+	
+		
+			Mini Quest
+			
+			
+			
+			
+			
+				Directions
+				
+				
+				
+				^(n|north|s|south|e|east|w|west|u|up|d|down)$
+			
+			
+				Say
+				
+				
+				
+				^say (.+)$
+			
+			
+				Open
+				
+				
+				
+				^open (.+)$
+			
+			
+				Close
+				
+				
+				
+				^close (.+)$
+			
+			
+				Look Objects
+				
+				
+				
+				^(l|look|examine) (.+)$
+			
+			
+				Look
+				
+				
+				
+				^(l|look)$
+			
+			
+				Buy at Fruit Vendor
+				
+				
+				
+				^buy(?: (.+))?$
+			
+			
+				Inventory
+				
+				
+				
+				^(i|inv|inventory)$
+			
+			
+				Give
+				
+				
+				
+				^give (?:the |some |an? )?(apple|apples|banana|bananas|ring|wedding|fruit|food|lunch)(?: (.+))?$
+			
+			
+				Get
+				
+				
+				
+				^(?:get|take|grab|pick up|pickup|collect) (?:the |a |an )?(?:wedding )?ring(?: .+)?$
+			
+			
+				Quit
+				
+				
+				
+				^quit$
+			
+		
+	
+	
+	
+		
+			Mini Quest
+			
+			
+			
+			
+				
+			
+			
+				
+			
+			
+				
+			
+			
+				
+			
+			
+				
+			
+			
+				
+			
+		
+	
+	
+		
+			Reset Profile
+			
+			
+			
+			16777275
+			0
+		
+	
+	
+		
+	
+
diff --git a/src/packages/mudlet-tutorial/config.lua b/src/packages/mudlet-tutorial/config.lua
new file mode 100644
index 000000000..2c48fe778
--- /dev/null
+++ b/src/packages/mudlet-tutorial/config.lua
@@ -0,0 +1,21 @@
+mpackage = [[Mudlet Tutorial]]
+author = [[Zooka]]
+icon = [[mudlet.png]]
+title = [[An offline tutorial and mini-game for Mudlet.]]
+description = [[
+### Description
+
+Mudlet provides a simple tutorial to help you get familiar with playing MUDs using Mudlet.
+
+You play a young adventurer who has recently graduated from the adventuring school.  You must aid the Sheriff in a series of tasks for the townfolk and become a local hero.
+
+### Usage
+
+After installing, just following along with the onscreen commands.
+
+### See Also
+
+* https://mudlet.org
+* https://wiki.mudlet.org]]
+version = [[3]]
+created = "2025-09-07T10:32:00+07:00"
diff --git a/src/mudlet-tutorial.mpackage b/src/packages/mudlet-tutorial/mudlet-tutorial.mpackage
similarity index 100%
rename from src/mudlet-tutorial.mpackage
rename to src/packages/mudlet-tutorial/mudlet-tutorial.mpackage
diff --git a/src/packages/run-lua-code/config.lua b/src/packages/run-lua-code/config.lua
new file mode 100644
index 000000000..de9dbf495
--- /dev/null
+++ b/src/packages/run-lua-code/config.lua
@@ -0,0 +1,18 @@
+mpackage = [[run-lua-code]]
+author = [[Mudlet Default Package]]
+icon = [[mudlet.png]]
+title = [[Run Lua code directly from the command line.]]
+description = [[# run-lua-code
+
+A simple package that provides a `lua` alias that allows the user to
+run Lua code from the command line.
+
+```
+-- examples
+> lua echo("Lua from the command line")  -- runs the Lua echo function displaying text on the main screen
+> lua send("look")                       -- send the command 'look' to the game server
+> lua showColors()                       -- display a color palette
+```
+]]
+version = [[5]]
+created = "2024-08-27T05:32:00+02:00"
diff --git a/src/run-lua-code.mpackage b/src/packages/run-lua-code/run-lua-code.mpackage
similarity index 100%
rename from src/run-lua-code.mpackage
rename to src/packages/run-lua-code/run-lua-code.mpackage
diff --git a/src/packages/run-lua-code/run-lua-code.xml b/src/packages/run-lua-code/run-lua-code.xml
new file mode 100644
index 000000000..6c225e9c3
--- /dev/null
+++ b/src/packages/run-lua-code/run-lua-code.xml
@@ -0,0 +1,32 @@
+
+
+
+	
+	
+	
+		
+			run lua code
+			
+			
+			
+			^lua (.*)$
+		
+	
+	
+	
+	
+	
+		
+	
+
diff --git a/src/packages/run-tests/config.lua b/src/packages/run-tests/config.lua
new file mode 100644
index 000000000..7da1a869e
--- /dev/null
+++ b/src/packages/run-tests/config.lua
@@ -0,0 +1,17 @@
+mpackage = [[run-tests]]
+author = [[Mudlet Default Package]]
+icon = [[mudlet.png]]
+title = [[A unit test framework for Mudlet, using Busted.]]
+description = [[### Description
+
+A unit test framework for Mudlet, using Busted.  All spec files can be found in the Mudlet source.
+
+### Usage
+
+See the README in the package.
+
+### See Also
+
+* [Busted homepage](https://lunarmodules.github.io/busted/)]]
+version = [[1]]
+created = "2025-01-19T14:05:54+04:00"
diff --git a/src/run-tests.mpackage b/src/packages/run-tests/run-tests.mpackage
similarity index 93%
rename from src/run-tests.mpackage
rename to src/packages/run-tests/run-tests.mpackage
index e594273a1202395c13cfd6c8a20518a10f4078c5..6857101458caa1458b7f12d22a9decae693f97bf 100644
GIT binary patch
delta 7004
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

delta 5499
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

diff --git a/src/run-tests.xml b/src/packages/run-tests/run-tests.xml
similarity index 100%
rename from src/run-tests.xml
rename to src/packages/run-tests/run-tests.xml
diff --git a/src/run-lua-code.xml b/src/run-lua-code.xml
deleted file mode 100644
index 4a4d58684..000000000
--- a/src/run-lua-code.xml
+++ /dev/null
@@ -1,32 +0,0 @@
-
-
-
-    
-    
-    
-        
-            run lua code
-            
-            
-            
-            ^lua (.*)$
-        
-    
-    
-    
-    
-    
-        
-    
-
diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt
index 346d29851..5cdf9098a 100644
--- a/test/functional_tests/CMakeLists.txt
+++ b/test/functional_tests/CMakeLists.txt
@@ -38,6 +38,7 @@ set(FUNCTIONAL_TEST_SOURCES
     ActionSelfUninstallTest.cpp
     DialogTeardownTest.cpp
     TMediaLoopTest.cpp
+    DefaultPackagesTest.cpp
 )
 
 # The updater sources are only built with USE_UPDATER, and on macOS the
diff --git a/test/functional_tests/DefaultPackagesTest.cpp b/test/functional_tests/DefaultPackagesTest.cpp
new file mode 100644
index 000000000..8abe45915
--- /dev/null
+++ b/test/functional_tests/DefaultPackagesTest.cpp
@@ -0,0 +1,231 @@
+/***************************************************************************
+ *   Copyright (C) 2026 by Mudlet Developers                               *
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the GNU General Public License as published by  *
+ *   the Free Software Foundation; either version 2 of the License, or     *
+ *   (at your option) any later version.                                   *
+ *                                                                         *
+ *   This program is distributed in the hope that it will be useful,       *
+ *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
+ *   GNU General Public License for more details.                          *
+ *                                                                         *
+ *   You should have received a copy of the GNU General Public License     *
+ *   along with this program; if not, write to the                         *
+ *   Free Software Foundation, Inc.,                                       *
+ *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
+ ***************************************************************************/
+
+/*
+ * Covers the packages Mudlet preinstalls into new profiles, which live in
+ * src/packages and are compiled in through mudlet.qrc.
+ *
+ * Nothing else notices when one of these breaks: a path in
+ * setupPreInstallPackages() that no longer names a compiled-in resource, or an
+ * archive rebuilt without config.lua, just means the profile quietly comes up
+ * without the package. The build stays green either way, so this test walks
+ * both the preinstall table and every archive in the resource tree.
+ *
+ * Run with: ctest -R DefaultPackagesTest -V
+ */
+
+#include 
+
+#include 
+#include 
+
+#include "Host.h"
+#include "HostManager.h"
+#include "MudletInstanceCoordinator.h"
+#include "mudlet.h"
+
+extern void qInitResources_mudlet();
+extern void qInitResources_qm();
+extern void qInitResources_additional_splash_screens();
+extern void qInitResources_mudlet_fonts_common();
+extern void qInitResources_mudlet_fonts_posix();
+void initializeQRCResourcesForDefaultPackagesTest();
+
+class DefaultPackagesTest : public QObject
+{
+    Q_OBJECT
+
+private:
+    // A package installs under the name its config.lua declares, which is
+    // normally the directory it lives in. These two are deliberately not: the
+    // tutorial uses a display name, and the Carrion Fields loader has to match
+    // the name its own script passes to uninstallPackage() when it is done.
+    inline static const QHash scmInstallsAs = {{qsl("mudlet-tutorial"), qsl("Mudlet Tutorial")}, {qsl("CF-loader"), qsl("CF_Loader")}};
+
+    const QString mProfileName = qsl("DefaultPackages-Test");
+    QTemporaryDir mConfigDir;
+    QByteArray mSavedXdg;
+    Host* mpHost = nullptr;
+
+    QStringList preinstallsFor(const QString& gameUrl, const QString& profileName = qsl("test"))
+    {
+        mudlet::self()->mPackagesToInstallList.clear();
+        mudlet::self()->setupPreInstallPackages(gameUrl, profileName);
+        return mudlet::self()->mPackagesToInstallList;
+    }
+
+private slots:
+    void initTestCase()
+    {
+        initializeQRCResourcesForDefaultPackagesTest();
+
+        // Keep the test hermetic: point the config dir resolution at a
+        // temporary directory instead of the user's real profiles.
+        QVERIFY(mConfigDir.isValid());
+        mSavedXdg = qgetenv("XDG_CONFIG_HOME");
+        QVERIFY(QDir().mkpath(qsl("%1/mudlet/profiles").arg(mConfigDir.path())));
+        qputenv("XDG_CONFIG_HOME", mConfigDir.path().toUtf8());
+
+        mudlet::start();
+        mudlet::self()->setupConfig();
+        mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique("MudletInstanceCoordinator"));
+        mudlet::self()->init();
+        mudlet::self()->setStorePasswordsSecurely(false);
+
+        QVERIFY2(mudlet::self()->getHostManager().addHost(mProfileName, QString(), QString(), QString()), "failed to create the Host");
+        mpHost = mudlet::self()->getHostManager().getHost(mProfileName);
+        QVERIFY(mpHost);
+    }
+
+    void cleanupTestCase()
+    {
+        mpHost = nullptr;
+        delete mudlet::self();
+        mSavedXdg.isNull() ? qunsetenv("XDG_CONFIG_HOME") : qputenv("XDG_CONFIG_HOME", mSavedXdg);
+    }
+
+    // Every path the preinstall table hands out has to name something that was
+    // actually compiled into the binary, or the profile silently misses it.
+    void test_preinstalledPathsResolve_data()
+    {
+        QTest::addColumn("gameUrl");
+
+        QTest::newRow("any game") << qsl("example.com");
+        QTest::newRow("carrion fields") << qsl("carrionfields.net");
+        QTest::newRow("icesus") << qsl("icesus.org");
+        QTest::newRow("morgengrauen") << qsl("mg.mud.de");
+        QTest::newRow("medievia") << qsl("medievia.com");
+        QTest::newRow("an IRE game") << qsl("achaea.com");
+        QTest::newRow("mudlet's own") << qsl("mudlet.org");
+    }
+
+    void test_preinstalledPathsResolve()
+    {
+        QFETCH(QString, gameUrl);
+
+        const QStringList paths = preinstallsFor(gameUrl);
+        QVERIFY2(!paths.isEmpty(), qPrintable(qsl("no packages queued for %1").arg(gameUrl)));
+        for (const QString& path : paths) {
+            QVERIFY2(path.startsWith(qsl(":/")), qPrintable(qsl("%1 is not a resource path").arg(path)));
+            QVERIFY2(QFile::exists(path), qPrintable(qsl("%1 is queued for %2 but is not compiled in").arg(path, gameUrl)));
+        }
+    }
+
+    void test_tutorialProfileGetsTheTutorial()
+    {
+        QVERIFY(preinstallsFor(qsl("localhost"), qsl("Mudlet Tutorial")).contains(qsl(":/packages/mudlet-tutorial/mudlet-tutorial.mpackage")));
+        QVERIFY(!preinstallsFor(qsl("localhost"), qsl("some other profile")).contains(qsl(":/packages/mudlet-tutorial/mudlet-tutorial.mpackage")));
+    }
+
+    // Games that install an interface of their own get a loader instead of the
+    // starter UI, which would otherwise fight it for the same screen space.
+    void test_gamesWithTheirOwnUiSkipTheStarterUi()
+    {
+        QVERIFY(!preinstallsFor(qsl("mg.mud.de")).contains(qsl(":/packages/mudlet-base-ui/mudlet-base-ui.mpackage")));
+        QVERIFY(preinstallsFor(qsl("mg.mud.de")).contains(qsl(":/packages/mg-loader/mg-loader.mpackage")));
+    }
+
+    // The generic mapper is for games that have no mapper script of their own.
+    void test_ireGamesGetTheirOwnMapper()
+    {
+        QVERIFY(preinstallsFor(qsl("achaea.com")).contains(qsl(":/mudlet-mapper.xml")));
+        QVERIFY(!preinstallsFor(qsl("achaea.com")).contains(qsl(":/packages/generic_mapper/generic_mapper.mpackage")));
+        QVERIFY(preinstallsFor(qsl("example.com")).contains(qsl(":/packages/generic_mapper/generic_mapper.mpackage")));
+    }
+
+    // Installing is what the preinstall table ultimately does, and a package
+    // that unpacks but does not import leaves the profile just as empty.
+    void test_packagesInstall_data()
+    {
+        QTest::addColumn("package");
+
+        for (const QString& package : QDir(qsl(":/packages")).entryList(QDir::Dirs | QDir::NoDotAndDotDot)) {
+            QTest::newRow(qPrintable(package)) << package;
+        }
+    }
+
+    void test_packagesInstall()
+    {
+        QFETCH(QString, package);
+
+        mpHost->mBlockScriptCompile = false;
+        auto [installed, message] = mpHost->installPackage(qsl(":/packages/%1/%1.mpackage").arg(package), enums::PackageModuleType::Package, true);
+        QVERIFY2(installed, qPrintable(qsl("%1 failed to install: %2").arg(package, message)));
+
+        const QString installedAs = scmInstallsAs.value(package, package);
+        QVERIFY2(mpHost->mInstalledPackages.contains(installedAs), qPrintable(qsl("%1 installed but is not registered as %2").arg(package, installedAs)));
+    }
+
+    // Each package directory carries the archive Mudlet installs. Unpack every
+    // one the way Host::installPackage() does and check it is shaped the way
+    // the installer requires: metadata in config.lua, exactly one xml.
+    void test_everyArchiveIsWellFormed()
+    {
+        const QStringList packages = QDir(qsl(":/packages")).entryList(QDir::Dirs | QDir::NoDotAndDotDot);
+        QVERIFY2(!packages.isEmpty(), "no packages found in the resource tree");
+
+        for (const QString& package : packages) {
+            const QString archive = qsl(":/packages/%1/%1.mpackage").arg(package);
+            QVERIFY2(QFile::exists(archive), qPrintable(qsl("%1 holds no archive named after it").arg(package)));
+
+            QTemporaryFile onDisk;
+            QVERIFY(onDisk.open());
+            QFile resource(archive);
+            QVERIFY(resource.open(QIODevice::ReadOnly));
+            QVERIFY(onDisk.write(resource.readAll()) != -1);
+            onDisk.close();
+
+            QTemporaryDir unpacked;
+            QVERIFY(unpacked.isValid());
+            // mudlet::unzip() joins the destination and the entry name as-is,
+            // so the trailing slash is what keeps the files inside the folder:
+            const QString destination = qsl("%1/").arg(unpacked.path());
+            QVERIFY2(mudlet::unzip(onDisk.fileName(), destination, QDir(unpacked.path())), qPrintable(qsl("%1 could not be unzipped").arg(archive)));
+
+            const QDir contents(unpacked.path());
+            QVERIFY2(contents.exists(qsl("config.lua")), qPrintable(qsl("%1 carries no config.lua, so it would install without any metadata").arg(archive)));
+            const QStringList xmls = contents.entryList(QStringList{qsl("*.xml")}, QDir::Files);
+            QCOMPARE(xmls.count(), 1);
+
+            // Mudlet names the installed package after config.lua, so keeping
+            // the directory named the same is what makes the paths guessable.
+            const QString declaredName = mpHost->getPackageConfig(contents.absoluteFilePath(qsl("config.lua")));
+            QVERIFY2(!declaredName.isEmpty(), qPrintable(qsl("%1 declares no package name in its config.lua").arg(archive)));
+            QCOMPARE(declaredName, scmInstallsAs.value(package, package));
+        }
+    }
+};
+
+void initializeQRCResourcesForDefaultPackagesTest()
+{
+#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN
+    qInitResources_additional_splash_screens();
+#endif
+#ifdef INCLUDE_FONTS
+    qInitResources_mudlet_fonts_common();
+#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD)
+    qInitResources_mudlet_fonts_posix();
+#endif
+#endif
+    qInitResources_mudlet();
+    qInitResources_qm();
+}
+
+#include "DefaultPackagesTest.moc"
+QTEST_MAIN(DefaultPackagesTest)

From 0bd0bad04e8b1ea1c166c3179720caf286542b2e Mon Sep 17 00:00:00 2001
From: EazyHood 
Date: Tue, 4 Aug 2026 03:40:00 -0500
Subject: [PATCH 074/155] fix: compare() no longer rejects tables that hold
 false (#9614)

`compare()` reports two identical tables as different when they hold
`false`.

```lua
compare({ key = false }, { key = false })   --> false    should be true
compare({ key = true },  { key = true })    --> true
compare({ key = 0 },     { key = 0 })       --> true     (0 is truthy in Lua)
```

Only `false` is affected, which is what makes it easy to miss.

## Cause

`_comp` checks whether a key exists in `b` with a truthiness test:

```lua
if not b[k] then
  return false
end
```

`b[k]` is `false` for a key that is present and holds `false`, so the
comparison bails out
as though the key were missing.

`compare` is this function (`compare = _comp`), and `_comp` is also the
engine behind
`table.intersection`, `table.n_intersection`, `table.complement` and
`table.n_complement`. All of them return wrong results for nested tables
holding `false`:

```lua
table.complement({ k = { x = false } }, { k = { x = false } })
--> { k = { x = false } }    should be {} -- the tables are equal
```

## Fix

The three lines are removed rather than rewritten, because they were
redundant as well as
wrong:

- **A key missing from `b`** is caught by the `_comp(v, b[k])` call
immediately after.
  Its first check is `type(a) ~= type(b)`, which fails against `nil`.
- **`b` having extra keys** is caught by `a_size ~= table.size(b)` at
the end of the loop,
  which is what #3423 added for exactly that case.

So no check is lost by deleting them. I have added a comment in their
place recording why,
so the test does not get reintroduced later as a "missing" guard.

## Testing

I ran the patched `_comp` in a Lua interpreter:

```
{a=false} vs {a=false}   -> true    (was false)
{a=false} vs {a=true}    -> false
{a=false} vs {}          -> false   (missing key still rejected)
{a=1}     vs {a=1,b=2}   -> false   (extra key still rejected)
nested {k={x=false}}     -> true
{a=1}     vs {a="1"}     -> false   (type mismatch still rejected)
```

The existing `_comp` specs pass unchanged. One spec is added covering
`false` at the top
level and nested, plus the missing-key case so the removed guard stays
covered.

Written with AI assistance, declared in the commit trailer per
`AGENTS.md`. I ran the
tests and reviewed the change before signing off.

Signed-off-by: EazyHood <209367218+EazyHood@users.noreply.github.com>
Co-authored-by: EazyHood <209367218+EazyHood@users.noreply.github.com>
Co-authored-by: Vadim Peretokin 
---
 src/mudlet-lua/lua/Other.lua        | 6 +++---
 src/mudlet-lua/tests/Other_spec.lua | 7 +++++++
 2 files changed, 10 insertions(+), 3 deletions(-)

diff --git a/src/mudlet-lua/lua/Other.lua b/src/mudlet-lua/lua/Other.lua
index cf7beba1e..4f2a2b688 100644
--- a/src/mudlet-lua/lua/Other.lua
+++ b/src/mudlet-lua/lua/Other.lua
@@ -575,9 +575,9 @@ function _comp(a, b)
     local a_size = 0
     for k, v in pairs(a) do
       a_size = a_size + 1
-      if not b[k] then
-        return false
-      end
+      -- A key missing from b is already caught by the _comp call below, whose
+      -- first check is a type comparison and so fails against nil. Testing
+      -- `not b[k]` here as well rejected a legitimate `false` value.
       if not _comp(v, b[k]) then
         return false
       end
diff --git a/src/mudlet-lua/tests/Other_spec.lua b/src/mudlet-lua/tests/Other_spec.lua
index 1e363a321..d9e416cd4 100644
--- a/src/mudlet-lua/tests/Other_spec.lua
+++ b/src/mudlet-lua/tests/Other_spec.lua
@@ -441,6 +441,13 @@ describe("Tests Other.lua functions", function()
       assert.is_false(_comp(true,false))
     end)
 
+    it("compares tables holding false like tables holding any other value", function()
+      assert.is_true(_comp({ key = false }, { key = false }))
+      assert.is_false(_comp({ key = false }, { key = true }))
+      assert.is_false(_comp({ key = false }, {}))
+      assert.is_true(_comp({ outer = { inner = false } }, { outer = { inner = false } }))
+    end)
+
     it("returns true if table B has the same value for every key which table A contains.", function()
       local tableA = { "One", "Two" }
       local tableB = { "One", "Two" }

From e52432fe5fb43413f4ed4ca7547a4c42bbb6e2bc Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Tue, 4 Aug 2026 12:00:37 +0200
Subject: [PATCH 075/155] fix: removing a game's profile no longer hides it
 from the All Games list (#9608)

#### Brief overview of PR changes/additions
- Deleting a profile of a pre-installed game now only removes the
profile - the game stays available in All Games
- Games hidden by this bug in the past reappear automatically
- Adds DefaultGameDeleteTest covering both cases

#### Motivation for adding to Mudlet
Removing a game from My Games unexpectedly removed it from the All Games
catalog permanently.

#### Other info (issues closed, discussion etc)
Assisted-by: Claude:claude-fable-5
Assisted-by: Claude:claude-opus-5
Signed-off-by: Vadim Peretokin 

**Test case:** Play a game from All Games, close and reopen Mudlet,
remove it from My Games - it still appears under All Games.

#### Demo


https://github.com/user-attachments/assets/6df6f2bd-d0d4-446f-80de-8c4c190dbf45
---
 src/dlgConnectionProfiles.cpp                 |  52 ++--
 test/functional_tests/CMakeLists.txt          |   1 +
 .../DefaultGameDeleteTest.cpp                 | 225 ++++++++++++++++++
 3 files changed, 258 insertions(+), 20 deletions(-)
 create mode 100644 test/functional_tests/DefaultGameDeleteTest.cpp

diff --git a/src/dlgConnectionProfiles.cpp b/src/dlgConnectionProfiles.cpp
index ee42406e2..3811606db 100644
--- a/src/dlgConnectionProfiles.cpp
+++ b/src/dlgConnectionProfiles.cpp
@@ -1024,7 +1024,9 @@ void dlgConnectionProfiles::reallyDeleteProfile(const QString& profile)
         });
     }
 
-    // record the deleted default profile so it does not get re-created in the future
+    // record the deletion; the games catalog deliberately ignores this list
+    // now - only the self-test entry in fillout_form() still honours it, and
+    // continueProfileSave() clears the entry on profile re-creation
     auto& settings = *mudlet::self()->mpSettings;
     auto deletedDefaultMuds = settings.value(qsl("deletedDefaultMuds"), QStringList()).toStringList();
     if (!deletedDefaultMuds.contains(profile)) {
@@ -1396,35 +1398,45 @@ void dlgConnectionProfiles::fillout_form()
     QString description;
     QListWidgetItem* pItem;
 
-    auto& settings = *mudlet::self()->mpSettings;
-    auto deletedDefaultMuds = settings.value(qsl("deletedDefaultMuds"), QStringList()).toStringList();
     const QStringList& onlyShownPredefinedProfiles{mudlet::self()->mOnlyShownPredefinedProfiles};
     const bool showOnlyMyProfiles = showingOnlyMyProfiles();
+    const QString selfTestProfile = qsl("Mudlet self-test");
+    const auto deletedDefaultMuds = mudlet::self()->mpSettings->value(qsl("deletedDefaultMuds"), QStringList()).toStringList();
     if (onlyShownPredefinedProfiles.isEmpty()) {
         const auto defaultGames = TGameDetails::keys();
+        // "My games" only lists games with profile data on disk; "All games"
+        // must keep offering every pre-installed game, even ones whose
+        // profile was deleted (recorded in deletedDefaultMuds). The self-test
+        // entry is the exception: it is a testing aid rather than a game, and
+        // is offered even without profile data on disk, so dismissing it has
+        // to keep it out of both tabs
         for (auto& game : defaultGames) {
-            if (!deletedDefaultMuds.contains(game)) {
-                if (showOnlyMyProfiles && !mProfileList.contains(game, Qt::CaseInsensitive)) {
-                    continue;
-                }
-                pItem = new QListWidgetItem();
-                auto details = TGameDetails::findGame(game);
-                setupMudProfile(pItem, game, (*details).description, (*details).icon);
+            if (game == selfTestProfile && deletedDefaultMuds.contains(game)) {
+                continue;
             }
+            if (showOnlyMyProfiles && !mProfileList.contains(game, Qt::CaseInsensitive)) {
+                continue;
+            }
+            pItem = new QListWidgetItem();
+            auto details = TGameDetails::findGame(game);
+            setupMudProfile(pItem, game, (*details).description, (*details).icon);
         }
 
 #if defined(QT_DEBUG)
-        const QString mudServer = qsl("Mudlet self-test");
-        if (!deletedDefaultMuds.contains(mudServer) && !mProfileList.contains(mudServer)) {
-            mProfileList.append(mudServer);
-            pItem = new QListWidgetItem();
-            // Can't use setupMudProfile(...) here as we do not set the icon in the same way:
-            setItemName(pItem, mudServer);
+        if (!deletedDefaultMuds.contains(selfTestProfile) && !mProfileList.contains(selfTestProfile)) {
+            mProfileList.append(selfTestProfile);
+            // "All games" already listed it from TGameDetails above, only
+            // "My games" is still missing an entry:
+            if (findData(*listWidget_profiles, selfTestProfile, csmNameRole).isEmpty()) {
+                pItem = new QListWidgetItem();
+                // Can't use setupMudProfile(...) here as we do not set the icon in the same way:
+                setItemName(pItem, selfTestProfile);
 
-            listWidget_profiles->addItem(pItem);
-            description = getDescription(qsl("mudlet.org"));
-            if (!description.isEmpty()) {
-                pItem->setToolTip(utils::richText(description));
+                listWidget_profiles->addItem(pItem);
+                description = getDescription(qsl("mudlet.org"));
+                if (!description.isEmpty()) {
+                    pItem->setToolTip(utils::richText(description));
+                }
             }
         }
 #endif
diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt
index 5cdf9098a..4e4310c18 100644
--- a/test/functional_tests/CMakeLists.txt
+++ b/test/functional_tests/CMakeLists.txt
@@ -9,6 +9,7 @@ set(FUNCTIONAL_TEST_SOURCES
     TelnetSgrDefaultColorTest.cpp
     TelnetTlsPromptTest.cpp
     TelnetBenchmark.cpp
+    DefaultGameDeleteTest.cpp
     ResetProfileTest.cpp
     TOscTest.cpp
     TUserWindowTest.cpp
diff --git a/test/functional_tests/DefaultGameDeleteTest.cpp b/test/functional_tests/DefaultGameDeleteTest.cpp
new file mode 100644
index 000000000..a83231984
--- /dev/null
+++ b/test/functional_tests/DefaultGameDeleteTest.cpp
@@ -0,0 +1,225 @@
+/***************************************************************************
+ *   Copyright (C) 2026 by Mudlet Developers                               *
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the GNU General Public License as published by  *
+ *   the Free Software Foundation; either version 2 of the License, or     *
+ *   (at your option) any later version.                                   *
+ *                                                                         *
+ *   This program is distributed in the hope that it will be useful,       *
+ *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
+ *   GNU General Public License for more details.                          *
+ *                                                                         *
+ *   You should have received a copy of the GNU General Public License     *
+ *   along with this program; if not, write to the                         *
+ *   Free Software Foundation, Inc.,                                       *
+ *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
+ ***************************************************************************/
+
+/*
+ * Deleting a pre-installed game's profile from the "My games" tab of the
+ * connection dialog must only remove that profile's local data - the game has
+ * to remain available in the "All games" catalog afterwards. It used to also
+ * vanish from "All games" because the deletion recorded the game in the
+ * deletedDefaultMuds blocklist which fillout_form() applied to both tabs.
+ *
+ * Run with: ctest -R DefaultGameDeleteTest -V
+ */
+
+#include 
+
+#include 
+#include 
+
+#include "MudletInstanceCoordinator.h"
+#include "TGameDetails.h"
+#include "dlgConnectionProfiles.h"
+#include "mudlet.h"
+
+extern void qInitResources_mudlet();
+extern void qInitResources_qm();
+extern void qInitResources_additional_splash_screens();
+extern void qInitResources_mudlet_fonts_common();
+extern void qInitResources_mudlet_fonts_posix();
+void initializeQRCResourcesForDefaultGameDeleteTest();
+
+class DefaultGameDeleteTest : public QObject
+{
+    Q_OBJECT
+
+private:
+    QTemporaryDir mConfigDir;
+    QByteArray mSavedXdg;
+    const QString mGame = qsl("Mudlet Tutorial");
+    const QString mSelfTest = qsl("Mudlet self-test");
+
+    // the dialog holds two QTabBars: the games-list one, created directly on
+    // the dialog, and QTabWidget's internal one - the parent check tells them
+    // apart without matching translated tab text
+    QTabBar* gamesTabBar(dlgConnectionProfiles* dlg) const
+    {
+        const auto tabBars = dlg->findChildren();
+        for (auto* tabBar : tabBars) {
+            if (!qobject_cast(tabBar->parentWidget())) {
+                return tabBar;
+            }
+        }
+        return nullptr;
+    }
+
+    bool gameListed(dlgConnectionProfiles* dlg, const QString& game) const { return !dlg->findData(*dlg->listWidget_profiles, game, dlgConnectionProfiles::csmNameRole).isEmpty(); }
+
+private slots:
+    void initTestCase()
+    {
+        initializeQRCResourcesForDefaultGameDeleteTest();
+
+        QVERIFY(mConfigDir.isValid());
+        // pre-create $XDG_CONFIG_HOME/mudlet so setupConfig() adopts it and the
+        // test never touches the real profiles or settings
+        QVERIFY(QDir().mkpath(qsl("%1/mudlet").arg(mConfigDir.path())));
+        mSavedXdg = qgetenv("XDG_CONFIG_HOME");
+        qputenv("XDG_CONFIG_HOME", mConfigDir.path().toUtf8());
+
+        mudlet::start();
+        mudlet::self()->setupConfig();
+        QCOMPARE(mudlet::getMudletPath(enums::mainPath), qsl("%1/mudlet").arg(mConfigDir.path()));
+        mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique("MudletInstanceCoordinator"));
+        mudlet::self()->init();
+        mudlet::self()->setStorePasswordsSecurely(false);
+
+        QVERIFY2(TGameDetails::keys().contains(mGame), "expected pre-installed game missing from TGameDetails");
+    }
+
+    void cleanupTestCase()
+    {
+        delete mudlet::self();
+        mSavedXdg.isNull() ? qunsetenv("XDG_CONFIG_HOME") : qputenv("XDG_CONFIG_HOME", mSavedXdg);
+    }
+
+    void test_deletedDefaultGameStaysInAllGames()
+    {
+        // an on-disk profile dir makes the game appear under "My games"; no
+        // saved XMLs inside means slot_deleteProfile() deletes without raising
+        // the confirmation dialog
+        QVERIFY(QDir().mkpath(mudlet::getMudletPath(enums::profileHomePath, mGame)));
+
+        auto* dlg = new dlgConnectionProfiles();
+        dlg->show();
+        dlg->fillout_form();
+        auto* tabBar = gamesTabBar(dlg);
+        QVERIFY(tabBar);
+
+        tabBar->setCurrentIndex(0); // "My games"
+        dlg->fillout_form();
+        QVERIFY2(gameListed(dlg, mGame), "game with an on-disk profile should show under 'My games'");
+
+        // no saved XMLs is what makes slot_deleteProfile() skip the
+        // confirmation dialog; assert it so a change there fails loudly
+        QVERIFY(!QDir(mudlet::getMudletPath(enums::profileXmlFilesPath, mGame)).exists());
+        const auto items = dlg->findData(*dlg->listWidget_profiles, mGame, dlgConnectionProfiles::csmNameRole);
+        dlg->listWidget_profiles->setCurrentItem(items.first());
+        dlg->slot_deleteProfile();
+
+        QVERIFY2(!gameListed(dlg, mGame), "deleted game should no longer show under 'My games'");
+        QVERIFY2(!QDir(mudlet::getMudletPath(enums::profileHomePath, mGame)).exists(), "profile data should be removed from disk");
+
+        tabBar->setCurrentIndex(1); // "All games", refills the list
+        QVERIFY2(gameListed(dlg, mGame), "a deleted pre-installed game must still be offered under 'All games'");
+
+        dlg->deleteLater();
+        QCoreApplication::sendPostedEvents(nullptr, QEvent::DeferredDelete);
+    }
+
+    // users who deleted a pre-installed game before this fix have it recorded
+    // in the deletedDefaultMuds blocklist; it must not keep the game out of
+    // the catalog
+    void test_legacyBlocklistedGameStillShownInAllGames()
+    {
+        mudlet::self()->mpSettings->setValue(qsl("deletedDefaultMuds"), QStringList{mGame});
+
+        auto* dlg = new dlgConnectionProfiles();
+        dlg->show();
+        auto* tabBar = gamesTabBar(dlg);
+        QVERIFY(tabBar);
+        // the dialog already opens on "All games" (tab choice persisted by the
+        // previous test), so setCurrentIndex() fires no currentChanged and the
+        // explicit refill is load-bearing
+        tabBar->setCurrentIndex(1); // "All games"
+        dlg->fillout_form();
+
+        QVERIFY2(gameListed(dlg, mGame), "a game on the legacy deletedDefaultMuds blocklist must still be offered under 'All games'");
+
+        dlg->deleteLater();
+        QCoreApplication::sendPostedEvents(nullptr, QEvent::DeferredDelete);
+    }
+
+    // the self-test entry is not a game: debug builds offer it without any
+    // profile data on disk, so unlike a real pre-installed game it has to
+    // stay dismissed once deleted
+    void test_deletedSelfTestStaysHidden()
+    {
+        mudlet::self()->mpSettings->setValue(qsl("deletedDefaultMuds"), QStringList{mSelfTest});
+
+        auto* dlg = new dlgConnectionProfiles();
+        dlg->show();
+        auto* tabBar = gamesTabBar(dlg);
+        QVERIFY(tabBar);
+        tabBar->setCurrentIndex(1); // "All games"
+        dlg->fillout_form();
+
+        QVERIFY2(!gameListed(dlg, mSelfTest), "a deleted self-test entry must not come back under 'All games'");
+
+        tabBar->setCurrentIndex(0); // "My games"
+        dlg->fillout_form();
+        QVERIFY2(!gameListed(dlg, mSelfTest), "a deleted self-test entry must not come back under 'My games'");
+
+        dlg->deleteLater();
+        QCoreApplication::sendPostedEvents(nullptr, QEvent::DeferredDelete);
+    }
+
+    // debug builds add the self-test entry to "My games" themselves; "All
+    // games" already gets it from TGameDetails, so it must not be listed twice
+    void test_selfTestListedOnce()
+    {
+        mudlet::self()->mpSettings->setValue(qsl("deletedDefaultMuds"), QStringList{});
+
+        auto* dlg = new dlgConnectionProfiles();
+        dlg->show();
+        auto* tabBar = gamesTabBar(dlg);
+        QVERIFY(tabBar);
+
+        for (const int tab : {1, 0}) { // "All games", then "My games"
+            tabBar->setCurrentIndex(tab);
+            dlg->fillout_form();
+            const auto items = dlg->findData(*dlg->listWidget_profiles, mSelfTest, dlgConnectionProfiles::csmNameRole);
+#if defined(QT_DEBUG)
+            QCOMPARE(items.size(), 1);
+#else
+            QVERIFY2(items.size() <= 1, "the self-test entry must never be listed twice");
+#endif
+        }
+
+        dlg->deleteLater();
+        QCoreApplication::sendPostedEvents(nullptr, QEvent::DeferredDelete);
+    }
+};
+
+void initializeQRCResourcesForDefaultGameDeleteTest()
+{
+#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN
+    qInitResources_additional_splash_screens();
+#endif
+#ifdef INCLUDE_FONTS
+    qInitResources_mudlet_fonts_common();
+#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD)
+    qInitResources_mudlet_fonts_posix();
+#endif
+#endif
+    qInitResources_mudlet();
+    qInitResources_qm();
+}
+
+#include "DefaultGameDeleteTest.moc"
+QTEST_MAIN(DefaultGameDeleteTest)

From bb2ead764c6b46ea3bf5a920ce3dac487e130d17 Mon Sep 17 00:00:00 2001
From: Vadim Peretokin 
Date: Tue, 4 Aug 2026 16:09:42 +0200
Subject: [PATCH 076/155] fix: profiles with parentheses in their name can be
 opened again (#9610)

#### Brief overview of PR changes/additions
- Parentheses are now allowed in profile names, matching the "name (2)"
folders file managers create when copying
- Selecting a profile folder made outside Mudlet no longer silently
mangles its name and renames the folder on disk
- Adds ProfileNameValidationTest for the name validation rules and
ProfileFolderNameTest, which drives the real connection dialog against
externally-created folders (fails without the fix)

#### Motivation for adding to Mudlet
Merely selecting a profile folder like "test (2)" mangled its name to
"test 2" and silently renamed the folder on disk, and the reporter could
not launch the profile at all.

#### Other info (issues closed, discussion etc)
Assisted-by: Claude:claude-fable-5
Assisted-by: Claude:claude-opus-5
Signed-off-by: Vadim Peretokin 

**Test case:** Copy a profile folder to "test (2)" while Mudlet is
closed, reopen - the profile keeps its name, Connect/Offline are
enabled, and it opens.

#### Demo


https://github.com/user-attachments/assets/25b1bb4c-eaa7-4079-8b8e-a12de3ebb215
---
 src/dlgConnectionProfiles.cpp                 |  73 ++++--
 src/dlgConnectionProfiles.h                   |   5 +
 test/CMakeLists.txt                           |   1 +
 test/ProfileNameValidationTest.cpp            | 118 ++++++++++
 test/functional_tests/CMakeLists.txt          |   1 +
 .../ProfileFolderNameTest.cpp                 | 221 ++++++++++++++++++
 6 files changed, 402 insertions(+), 17 deletions(-)
 create mode 100644 test/ProfileNameValidationTest.cpp
 create mode 100644 test/functional_tests/ProfileFolderNameTest.cpp

diff --git a/src/dlgConnectionProfiles.cpp b/src/dlgConnectionProfiles.cpp
index 3811606db..9ddc0a6b2 100644
--- a/src/dlgConnectionProfiles.cpp
+++ b/src/dlgConnectionProfiles.cpp
@@ -52,6 +52,39 @@
 
 using namespace std::chrono_literals;
 
+// Kept to a sub-set of ASCII because the profile name is also used as a
+// directory name on all supported OSes; parentheses are included so that
+// folders duplicated by a file manager (e.g. "profile (2)") work as-is:
+const QString dlgConnectionProfiles::scmAllowedProfileNameChars = qsl(". _()0123456789-#&aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ");
+
+// Returns the first character not permitted in a (new) profile name, or a
+// null QChar if all of them are acceptable. An embedded U+0000 is
+// indistinguishable from the all-clear sentinel, but a QLineEdit never lets
+// one through:
+QChar dlgConnectionProfiles::firstInvalidProfileNameChar(const QString& name)
+{
+    for (const QChar& c : name) {
+        if (!scmAllowedProfileNameChars.contains(c)) {
+            return c;
+        }
+    }
+    return {};
+}
+
+// Characters that make a name unusable no matter where it came from:
+// utils::sanitizeForPath() silently rewrites them out of any path built from
+// the profile name, and CredentialManager::generateFilePath() refuses to
+// produce a path at all - so a profile named this way could never store or
+// retrieve its password. Mirrors the pattern used there:
+const QRegularExpression dlgConnectionProfiles::scmUnusableProfileNameChars{qsl(R"REGEX(\.\.|[/\\<>:"|?*\x00-\x1f])REGEX")};
+
+// Whether an existing profile folder can be taken as-is instead of being put
+// through the stricter rules that apply to names typed into the dialog:
+bool dlgConnectionProfiles::profileNameUsableAsIs(const QString& name)
+{
+    return !name.isEmpty() && !name.contains(scmUnusableProfileNameChars);
+}
+
 dlgConnectionProfiles::dlgConnectionProfiles(QWidget* parent)
 : QDialog(parent)
 {
@@ -2114,19 +2147,26 @@ bool dlgConnectionProfiles::validateProfile()
 
     if (pItem) {
         QString name = profile_name_entry->text().trimmed();
-        const QString allowedChars = qsl(". _0123456789-#&aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ");
 
-        for (int i = 0; i < name.size(); ++i) {
-            if (!allowedChars.contains(name.at(i))) {
-                notificationAreaIconLabelWarning->show();
-                notificationAreaMessageBox->setText(
-                        qsl("%1\n%2\n%3\n").arg(notificationAreaMessageBox->text(), tr("The %1 character is not permitted. Use one of the following:").arg(name.at(i)), allowedChars));
-                name.replace(name.at(i--), QString());
-                profile_name_entry->setText(name);
-                validName = false;
-                valid = false;
-                break;
-            }
+        // Only check the characters of a new or edited name: a profile folder
+        // already on disk may have been created outside of Mudlet (e.g. by a
+        // file manager copying a folder) with characters we would not permit
+        // for a new name - such a profile must still be loadable. Comparing
+        // against the trimmed item name covers folders with leading/trailing
+        // whitespace too, as the entered name always arrives trimmed. Names
+        // the rest of Mudlet cannot work with get no exemption: renaming them
+        // is worse for the user than a profile whose password never saves.
+        const QString selectedName = pItem->data(csmNameRole).toString();
+        const bool nameUnchangedAndOnDisk = (name == selectedName.trimmed()) && profileNameUsableAsIs(name) && QDir(mudlet::getMudletPath(enums::profileHomePath, selectedName)).exists();
+        const QChar invalidChar = nameUnchangedAndOnDisk ? QChar() : firstInvalidProfileNameChar(name);
+        if (!invalidChar.isNull()) {
+            notificationAreaIconLabelWarning->show();
+            notificationAreaMessageBox->setText(
+                    qsl("%1\n%2\n%3\n").arg(notificationAreaMessageBox->text(), tr("The %1 character is not permitted. Use one of the following:").arg(invalidChar), scmAllowedProfileNameChars));
+            name.remove(invalidChar);
+            profile_name_entry->setText(name);
+            validName = false;
+            valid = false;
         }
 
         // see if there is an edit that already uses a similar name
@@ -2430,11 +2470,8 @@ bool dlgConnectionProfiles::eventFilter(QObject* obj, QEvent* event)
     if (obj == listWidget_profiles && event->type() == QEvent::KeyPress) {
         QKeyEvent* keyEvent = static_cast(event);
         switch (keyEvent->key()) {
-            // Process all the keys that could be used in a profile name
-            // fortunately we limit this to a sub-set of ASCII because we also use
-            // it for a directory name - based on "allowedChars" list in
-            // validateProfile() i.e.:
-            // ". _0123456789-#&aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ"
+            // Process all the keys that could be used in a profile name,
+            // i.e. the "scmAllowedProfileNameChars" list
         default:
             // For other keys handle them as normal:
             return QObject::eventFilter(obj, event);
@@ -2462,6 +2499,8 @@ bool dlgConnectionProfiles::eventFilter(QObject* obj, QEvent* event)
         case Qt::Key_Minus:
         case Qt::Key_NumberSign:
         case Qt::Key_Ampersand:
+        case Qt::Key_ParenLeft:
+        case Qt::Key_ParenRight:
         case Qt::Key_A:
         case Qt::Key_B:
         case Qt::Key_C:
diff --git a/src/dlgConnectionProfiles.h b/src/dlgConnectionProfiles.h
index 3df953509..13ce66eab 100644
--- a/src/dlgConnectionProfiles.h
+++ b/src/dlgConnectionProfiles.h
@@ -25,6 +25,7 @@
 
 #include "ui_connection_profiles.h"
 #include 
+#include 
 #include 
 #include 
 
@@ -51,6 +52,10 @@ public:
     QList findData(const QListWidget& listWidget, const QVariant& what, const int role = Qt::UserRole) const;
     QList findProfilesBeginningWith(const QString&) const;
     static const int csmNameRole{Qt::UserRole};
+    static QChar firstInvalidProfileNameChar(const QString& name);
+    static bool profileNameUsableAsIs(const QString& name);
+    static const QString scmAllowedProfileNameChars;
+    static const QRegularExpression scmUnusableProfileNameChars;
 
     QString btn_connect_enabled_accessDesc;
     QString btn_load_enabled_accessDesc;
diff --git a/test/CMakeLists.txt b/test/CMakeLists.txt
index ec0fe44c9..7f3e95178 100644
--- a/test/CMakeLists.txt
+++ b/test/CMakeLists.txt
@@ -37,6 +37,7 @@ set(UNIT_TESTS
     TEncodingHelperTest
     PasswordMigrationTest
     TMediaPathTraversalTest
+    ProfileNameValidationTest
 )
 
 foreach(test_name ${UNIT_TESTS})
diff --git a/test/ProfileNameValidationTest.cpp b/test/ProfileNameValidationTest.cpp
new file mode 100644
index 000000000..0910a9867
--- /dev/null
+++ b/test/ProfileNameValidationTest.cpp
@@ -0,0 +1,118 @@
+/***************************************************************************
+ *   Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org    *
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the GNU General Public License as published by  *
+ *   the Free Software Foundation; either version 2 of the License, or     *
+ *   (at your option) any later version.                                   *
+ *                                                                         *
+ *   This program is distributed in the hope that it will be useful,       *
+ *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
+ *   GNU General Public License for more details.                          *
+ *                                                                         *
+ *   You should have received a copy of the GNU General Public License     *
+ *   along with this program; if not, write to the                         *
+ *   Free Software Foundation, Inc.,                                       *
+ *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
+ ***************************************************************************/
+
+#include "dlgConnectionProfiles.h"
+#include "utils.h"
+
+#include 
+
+/*
+ * Tests for the profile name character validation used by the connection
+ * dialog. Guards the character-set half of the fix for profile folders
+ * duplicated outside of Mudlet (e.g. a file manager appending " (2)" to a
+ * copied folder) which used to be rejected, greying out the Connect/Offline
+ * buttons. The on-disk exemption half is covered by
+ * test/functional_tests/ProfileFolderNameTest.cpp.
+ */
+class ProfileNameValidationTest : public QObject
+{
+    Q_OBJECT
+
+private slots:
+    void acceptableNames_data()
+    {
+        QTest::addColumn("name");
+
+        QTest::newRow("plain") << qsl("Achaea");
+        QTest::newRow("leading digit") << qsl("3Scapes");
+        QTest::newRow("default new name") << qsl("new profile name");
+        QTest::newRow("parenthesised copy suffix") << qsl("test (2)");
+        QTest::newRow("parenthesised word") << qsl("StickMUD (backup)");
+        QTest::newRow("windows copy suffix") << qsl("test - Copy");
+        QTest::newRow("all punctuation") << qsl("a.b_c-d#e&f (g)");
+        QTest::newRow("empty") << QString();
+    }
+
+    void acceptableNames()
+    {
+        QFETCH(QString, name);
+        QVERIFY(dlgConnectionProfiles::firstInvalidProfileNameChar(name).isNull());
+    }
+
+    void rejectedNames_data()
+    {
+        QTest::addColumn("name");
+        QTest::addColumn("badChar");
+
+        QTest::newRow("path separator") << qsl("test/2") << QChar('/');
+        QTest::newRow("windows path separator") << qsl("test\\2") << QChar('\\');
+        QTest::newRow("first of several invalid") << qsl("a/b:c") << QChar('/');
+        QTest::newRow("windows drive colon") << qsl("test:2") << QChar(':');
+        QTest::newRow("double quote") << qsl("test\"2") << QChar('"');
+        QTest::newRow("tab") << qsl("test\t2") << QChar('\t');
+        QTest::newRow("non-ascii") << qsl("café") << QChar(0x00e9);
+    }
+
+    void rejectedNames()
+    {
+        QFETCH(QString, name);
+        QFETCH(QChar, badChar);
+        QCOMPARE(dlgConnectionProfiles::firstInvalidProfileNameChar(name), badChar);
+    }
+
+    // Folders created outside of Mudlet keep their name only if the rest of
+    // Mudlet can work with it - notably CredentialManager, which returns an
+    // empty path rather than a sanitised one for these, leaving the profile
+    // unable to store or retrieve its password.
+    void usableAsIs_data()
+    {
+        QTest::addColumn("name");
+        QTest::addColumn("usable");
+
+        QTest::newRow("plain") << qsl("Achaea") << true;
+        QTest::newRow("parenthesised copy suffix") << qsl("test (2)") << true;
+        // not permitted for a new name, but harmless on disk and in a
+        // credential path, so an existing folder keeps it
+        QTest::newRow("non-ascii") << qsl("café") << true;
+        QTest::newRow("exclamation mark") << qsl("test!") << true;
+        QTest::newRow("single dot") << qsl("my.profile") << true;
+
+        QTest::newRow("empty") << QString() << false;
+        QTest::newRow("parent directory") << qsl("test..2") << false;
+        QTest::newRow("path separator") << qsl("test/2") << false;
+        QTest::newRow("windows path separator") << qsl("test\\2") << false;
+        QTest::newRow("colon") << qsl("test:2") << false;
+        QTest::newRow("pipe") << qsl("test|2") << false;
+        QTest::newRow("asterisk") << qsl("test*2") << false;
+        QTest::newRow("question mark") << qsl("test?2") << false;
+        QTest::newRow("angle brackets") << qsl("") << false;
+        QTest::newRow("double quote") << qsl("test\"2") << false;
+        QTest::newRow("control character") << qsl("test\x01 2") << false;
+    }
+
+    void usableAsIs()
+    {
+        QFETCH(QString, name);
+        QFETCH(bool, usable);
+        QCOMPARE(dlgConnectionProfiles::profileNameUsableAsIs(name), usable);
+    }
+};
+
+QTEST_GUILESS_MAIN(ProfileNameValidationTest)
+#include "ProfileNameValidationTest.moc"
diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt
index 4e4310c18..53b1751ac 100644
--- a/test/functional_tests/CMakeLists.txt
+++ b/test/functional_tests/CMakeLists.txt
@@ -37,6 +37,7 @@ set(FUNCTIONAL_TEST_SOURCES
     UndoServerWrapTest.cpp
     HostWidgetDecouplingTest.cpp
     ActionSelfUninstallTest.cpp
+    ProfileFolderNameTest.cpp
     DialogTeardownTest.cpp
     TMediaLoopTest.cpp
     DefaultPackagesTest.cpp
diff --git a/test/functional_tests/ProfileFolderNameTest.cpp b/test/functional_tests/ProfileFolderNameTest.cpp
new file mode 100644
index 000000000..0d040162b
--- /dev/null
+++ b/test/functional_tests/ProfileFolderNameTest.cpp
@@ -0,0 +1,221 @@
+/***************************************************************************
+ *   Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org    *
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the GNU General Public License as published by  *
+ *   the Free Software Foundation; either version 2 of the License, or     *
+ *   (at your option) any later version.                                   *
+ *                                                                         *
+ *   This program is distributed in the hope that it will be useful,       *
+ *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
+ *   GNU General Public License for more details.                          *
+ *                                                                         *
+ *   You should have received a copy of the GNU General Public License     *
+ *   along with this program; if not, write to the                         *
+ *   Free Software Foundation, Inc.,                                       *
+ *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
+ ***************************************************************************/
+
+/*
+ * Drives the real connection dialog against profile folders created outside
+ * of Mudlet, the way a file manager makes them (e.g. copying a profile to
+ * "test (2)"). Guards the on-disk exemption in
+ * dlgConnectionProfiles::validateProfile(): selecting such a folder must keep
+ * its name intact (no silent character stripping, which used to rename the
+ * folder on disk and lose its stored password) and must leave the
+ * Connect/Offline buttons enabled - while a freshly typed name must still
+ * have disallowed characters filtered out.
+ *
+ * Run with: ctest -R ProfileFolderNameTest -V
+ */
+
+#include "MudletInstanceCoordinator.h"
+#include "dlgConnectionProfiles.h"
+#include "mudlet.h"
+
+#include 
+
+extern void qInitResources_mudlet();
+extern void qInitResources_qm();
+extern void qInitResources_additional_splash_screens();
+extern void qInitResources_mudlet_fonts_common();
+extern void qInitResources_mudlet_fonts_posix();
+
+static void initializeQRCResources()
+{
+#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN
+    qInitResources_additional_splash_screens();
+#endif
+#ifdef INCLUDE_FONTS
+    qInitResources_mudlet_fonts_common();
+#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD)
+    qInitResources_mudlet_fonts_posix();
+#endif
+#endif
+    qInitResources_mudlet();
+    qInitResources_qm();
+}
+
+class ProfileFolderNameTest : public QObject
+{
+    Q_OBJECT
+
+private:
+    QTemporaryDir mXdgDir;
+    QByteArray mSavedXdg;
+
+    // The name a file manager typically produces when copying a folder; every
+    // character is in the allowed set now that parentheses are permitted:
+    const QString mCopiedName = qsl("test (2)");
+    // Contains a character that is NOT in the allowed set, so only the
+    // on-disk exemption lets it through unmangled:
+    const QString mForeignName = qsl("café");
+    // Trailing whitespace: the entered name arrives trimmed, so the exemption
+    // has to match against the trimmed folder name to cover this one:
+    const QString mPaddedName = qsl("padded café ");
+
+    // setupConfig() consults portable.txt before the XDG logic; skip rather
+    // than run against an unexpected config dir (see ConfigDirOverrideTest).
+    bool portableMarkerPresent() const
+    {
+        return QFileInfo::exists(qsl("%1/portable.txt").arg(QCoreApplication::applicationDirPath())) || QFileInfo::exists(qsl("%1/.config/mudlet/portable.txt").arg(QDir::homePath()));
+    }
+
+    void makeExternalProfileFolder(const QString& name) const
+    {
+        QVERIFY(QDir().mkpath(mudlet::getMudletPath(enums::profileHomePath, name)));
+        // A folder copied by a file manager carries the original's connection
+        // data files with it:
+        QVERIFY(mudlet::self()->writeProfileData(name, qsl("url"), qsl("mudlet.org")).first);
+        QVERIFY(mudlet::self()->writeProfileData(name, qsl("port"), qsl("23")).first);
+    }
+
+    // The Connect and Offline buttons are the only AcceptRole buttons in the
+    // dialog's button box (they are private members of the dialog itself):
+    QList acceptButtons(dlgConnectionProfiles* dialog) const
+    {
+        QList buttons;
+        for (auto* button : dialog->dialog_buttonbox->buttons()) {
+            if (dialog->dialog_buttonbox->buttonRole(button) == QDialogButtonBox::AcceptRole) {
+                buttons << button;
+            }
+        }
+        return buttons;
+    }
+
+    dlgConnectionProfiles* selectProfile(const QString& name)
+    {
+        auto* dialog = mudlet::self()->mpConnectionDialog.data();
+        if (!dialog) {
+            return nullptr;
+        }
+        const auto items = dialog->findData(*dialog->listWidget_profiles, name, dlgConnectionProfiles::csmNameRole);
+        if (items.isEmpty()) {
+            return nullptr;
+        }
+        dialog->listWidget_profiles->setCurrentItem(items.first());
+        dialog->slot_itemClicked(items.first());
+        return dialog;
+    }
+
+private slots:
+    void initTestCase()
+    {
+        if (portableMarkerPresent()) {
+            QSKIP("portable.txt present - cannot redirect the config dir for this test");
+        }
+        initializeQRCResources();
+
+        mSavedXdg = qgetenv("XDG_CONFIG_HOME");
+        QVERIFY(mXdgDir.isValid());
+        QVERIFY(QDir().mkpath(qsl("%1/mudlet").arg(mXdgDir.path()))); // empty dir = XDG opt-in
+        qputenv("XDG_CONFIG_HOME", mXdgDir.path().toUtf8());
+
+        mudlet::start();
+        mudlet::self()->setupConfig();
+        // never touch the user's real profiles:
+        QVERIFY(mudlet::getMudletPath(enums::profilesPath).startsWith(mXdgDir.path()));
+        mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique("MudletInstanceCoordinator"));
+        mudlet::self()->init();
+        mudlet::self()->setStorePasswordsSecurely(false);
+
+        makeExternalProfileFolder(mCopiedName);
+        makeExternalProfileFolder(mForeignName);
+        makeExternalProfileFolder(mPaddedName);
+
+        mudlet::self()->startAutoLogin({});
+        QVERIFY(QTest::qWaitFor(
+                []() {
+                    return mudlet::self()->mpConnectionDialog != nullptr;
+                },
+                5000));
+    }
+
+    void cleanupTestCase()
+    {
+        mSavedXdg.isNull() ? qunsetenv("XDG_CONFIG_HOME") : qputenv("XDG_CONFIG_HOME", mSavedXdg);
+        delete mudlet::self();
+    }
+
+    void test_copiedFolderWithParenthesesIsUsable()
+    {
+        auto* dialog = selectProfile(mCopiedName);
+        QVERIFY2(dialog, "profile folder with parentheses was not listed in the dialog");
+
+        QCOMPARE(dialog->profile_name_entry->text(), mCopiedName);
+        const auto buttons = acceptButtons(dialog);
+        QCOMPARE(buttons.size(), 2);
+        for (auto* button : buttons) {
+            QVERIFY2(button->isEnabled(), qPrintable(qsl("'%1' button is disabled for profile '%2'").arg(button->text(), mCopiedName)));
+        }
+        // the folder must not have been renamed behind the user's back:
+        QVERIFY(QDir(mudlet::getMudletPath(enums::profileHomePath, mCopiedName)).exists());
+    }
+
+    void test_folderWithDisallowedCharacterIsNotMangled()
+    {
+        auto* dialog = selectProfile(mForeignName);
+        QVERIFY2(dialog, "profile folder with a disallowed character was not listed in the dialog");
+
+        QCOMPARE(dialog->profile_name_entry->text(), mForeignName);
+        const auto buttons = acceptButtons(dialog);
+        QCOMPARE(buttons.size(), 2);
+        for (auto* button : buttons) {
+            QVERIFY2(button->isEnabled(), qPrintable(qsl("'%1' button is disabled for profile '%2'").arg(button->text(), mForeignName)));
+        }
+        QVERIFY(QDir(mudlet::getMudletPath(enums::profileHomePath, mForeignName)).exists());
+    }
+
+    void test_folderWithTrailingWhitespaceIsNotMangled()
+    {
+        auto* dialog = selectProfile(mPaddedName);
+        QVERIFY2(dialog, "profile folder with trailing whitespace was not listed in the dialog");
+
+        QCOMPARE(dialog->profile_name_entry->text(), mPaddedName);
+        const auto buttons = acceptButtons(dialog);
+        QCOMPARE(buttons.size(), 2);
+        for (auto* button : buttons) {
+            QVERIFY2(button->isEnabled(), qPrintable(qsl("'%1' button is disabled for profile '%2'").arg(button->text(), mPaddedName)));
+        }
+        QVERIFY(QDir(mudlet::getMudletPath(enums::profileHomePath, mPaddedName)).exists());
+    }
+
+    // The exemption must not disable validation of names the user types:
+    void test_editedNameIsStillValidated()
+    {
+        auto* dialog = selectProfile(mCopiedName);
+        QVERIFY(dialog);
+
+        // setText() drives the same textChanged path as typing does
+        dialog->profile_name_entry->setText(qsl("test |2"));
+        QVERIFY(!dialog->profile_name_entry->text().contains(QLatin1Char('|')));
+
+        // restore the on-disk selection so no rename can be left pending
+        dialog->profile_name_entry->setText(mCopiedName);
+        QCOMPARE(dialog->profile_name_entry->text(), mCopiedName);
+    }
+};
+
+QTEST_MAIN(ProfileFolderNameTest)
+#include "ProfileFolderNameTest.moc"

From bc1117aeca4ebd79d17f2e28603fa611f127b1c4 Mon Sep 17 00:00:00 2001
From: EazyHood 
Date: Tue, 4 Aug 2026 12:45:03 -0500
Subject: [PATCH 077/155] fix: table.n_collect drops values that match an index
 (#9615)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

`table.n_collect` silently drops values that passed the filter.

```lua
table.n_collect({ "a", 1 }, function() return true end)
--> { "a" }              should be { "a", 1 }

table.n_collect({ { "z" }, "z" }, function() return true end)
--> { { "z" } }          should be { { "z" }, "z" }
```

The predicate returns `true` for every element, so nothing should be
filtered out. The
values disappear during deduplication.

## Cause

`n_collect` deduplicates with `table.contains`:

```lua
if func(value) == true and not table.contains(matches, value) then
```

`table.contains` matches a value against **keys** as well as values, and
recurses into
nested tables. That is deliberate — `table._contains` has an explicit
`elseif k == value`
branch — but it is the wrong predicate here.

`matches` is a list indexed `1..n`. Once `"a"` occupies index 1,
`table.contains(matches, 1)`
is true because `1` is a key, so the value `1` looks like a duplicate
and is discarded. The
nested case fails through the recursive branch instead.

## Fix

Use `table.index_of`, which walks with `ipairs` and compares by value —
the semantics a
list of unique values needs.

Two things support this beyond it being correct:

- The sibling function `table.n_matches` already uses `table.index_of`
for the same
  purpose, so this makes the pair consistent.
- In #6675 the key matching in `table.contains` was confirmed as
intended, and
`table.index_of` was named as the better route for callers that want
value matching.
  This applies that decision rather than proposing a new one.

## Testing

I ran the patched file in a Lua interpreter:

```
n_collect({"a", 1})        -> 2 items    (was 1)
n_collect({{"z"}, "z"})    -> 2 items    (was 1)
n_collect({"a","a","b"})   -> 2 items    (dedup still works)
```

The five existing `n_collect` specs pass unchanged — none of them relies
on key matching or
on the recursive branch. Two specs are added for the cases above.

Written with AI assistance, declared in the commit trailer per
`AGENTS.md`. I ran the
tests and reviewed the change before signing off.

---------

Signed-off-by: EazyHood <209367218+EazyHood@users.noreply.github.com>
Co-authored-by: EazyHood <209367218+EazyHood@users.noreply.github.com>
Co-authored-by: Vadim Peretokin 
---
 src/mudlet-lua/lua/TableUtils.lua        |  6 +++++-
 src/mudlet-lua/tests/TableUtils_spec.lua | 26 +++++++++++++++++++++++-
 2 files changed, 30 insertions(+), 2 deletions(-)

diff --git a/src/mudlet-lua/lua/TableUtils.lua b/src/mudlet-lua/lua/TableUtils.lua
index 761274159..049a8e53c 100644
--- a/src/mudlet-lua/lua/TableUtils.lua
+++ b/src/mudlet-lua/lua/TableUtils.lua
@@ -245,7 +245,11 @@ function table.n_collect(tbl, func)
   assert(func_type == "function", string.format("table.n_collect: bad argument #2 type (function to run against each item in tbl as function expected, got %s)", func_type))
   local matches = {}
   for key,value in pairs(tbl) do
-    if func(value) == true and not table.contains(matches, value) then
+    -- table.contains matches keys and nested values too, so a value equal to
+    -- an index already in `matches` looked like a duplicate. table.index_of
+    -- compares by value over ipairs, which is the semantics a list of unique
+    -- values needs, and is what the sibling table.n_matches already uses.
+    if func(value) == true and not table.index_of(matches, value) then
       table.insert(matches, value)
     end
   end
diff --git a/src/mudlet-lua/tests/TableUtils_spec.lua b/src/mudlet-lua/tests/TableUtils_spec.lua
index 163f6df0f..988c0741a 100644
--- a/src/mudlet-lua/tests/TableUtils_spec.lua
+++ b/src/mudlet-lua/tests/TableUtils_spec.lua
@@ -264,7 +264,31 @@ describe("Tests TableUtils.lua functions", function()
       local errfn = function()
         table.n_collect(tbl, func)
       end
-      assert.has_error(errfn, "table.n_collect: bad argument #2 type (function to run against each item in tbl as function expected, got string)") 
+      assert.has_error(errfn, "table.n_collect: bad argument #2 type (function to run against each item in tbl as function expected, got string)")
+    end)
+
+    it("should keep a value that is equal to an index already collected", function()
+      local actual = table.n_collect({ "a", 1 }, function() return true end)
+      table.sort(actual, function(a, b) return tostring(a) < tostring(b) end)
+      assert.are.same({ 1, "a" }, actual)
+    end)
+
+    it("should keep a value that also appears inside a nested table", function()
+      local actual = table.n_collect({ { "z" }, "z" }, function() return true end)
+      assert.are.equal(2, #actual)
+      local nested, plain
+      for _, value in ipairs(actual) do
+        if type(value) == "table" then nested = value else plain = value end
+      end
+      assert.are.same({ "z" }, nested)
+      assert.are.equal("z", plain)
+    end)
+
+    it("should still drop real duplicates", function()
+      local actual = table.n_collect({ 5, "x", 5, "x" }, function() return true end)
+      assert.are.equal(2, #actual)
+      table.sort(actual, function(a, b) return tostring(a) < tostring(b) end)
+      assert.are.same({ 5, "x" }, actual)
     end)
   end)
 

From a94e2360f69e8015e55d04419b655a63be5914b1 Mon Sep 17 00:00:00 2001
From: EazyHood 
Date: Tue, 4 Aug 2026 12:51:36 -0500
Subject: [PATCH 078/155] fix: stop table.union modifying a table it was given
 (#9613)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

`table.union` modifies a table it was given, and returns that same table
aliased into its
result.

```lua
local a = { x = { 1, 2 } }
local u = table.union(a, { x = 5 })

display(u.x)              --> {1, 2, 5}     documented: {{1, 2}, 5}
display(a.x)              --> {1, 2, 5}     my table was changed
rawequal(u.x, a.x)        --> true          the "result" is my table
```

The documented behaviour is in the function's own docblock:

> If two or more tables contain different values associated with the
same key, that key in
> the returned table will contain a subtable containing all relevant
values.

## Cause

Two conditions in the collision branch test the wrong thing.

```lua
if union[key] and union[key] ~= val then
  if type(union[key]) == 'table' then
    table.insert(union[key], val)
```

`type(union[key]) == 'table'` is used as a proxy for *"this is the
accumulator I created
on a previous collision"*. That holds only when the first value was not
itself a table.
When it was — which is normal for nested data — `table.insert` appends
into the caller's
table instead, so the result is flattened and the input is mutated.

`if union[key]` is a truthiness test where a presence test is meant, so
a legitimate
`false` is treated as an absent key:

```lua
table.union({ y = false }, { y = 7 }).y   --> 7    documented: {false, 7}
```

## Fix

Track presence and accumulator ownership explicitly rather than
inferring them from the
value:

```lua
local seen = {}    -- keys that already hold a value, so `false` is not "absent"
local merged = {}  -- keys whose value is a subtable we created ourselves
```

Nothing is inferred from `type()` or from truthiness any more, so a
caller's table is
never appended to and `false` behaves like any other value.

## Testing

I ran the patched file in a Lua interpreter against the reproductions
above and against
the existing behaviour:

```
subtable is {{1,2},5}                     ok
the input table is unchanged              ok
the result does not alias the input       ok
a colliding false collects to {false,7}   ok
regression: non-colliding keys            ok
regression: simple collision              ok
regression: three tables                  ok
```

The three existing `table.union` specs pass unchanged. Two specs are
added for the cases
above.

Written with AI assistance, declared in the commit trailer per
`AGENTS.md`. I ran the
tests and reviewed the change before signing off.

---------

Signed-off-by: EazyHood <209367218+EazyHood@users.noreply.github.com>
Co-authored-by: EazyHood <209367218+EazyHood@users.noreply.github.com>
Co-authored-by: Vadim Peretokin 
---
 src/mudlet-lua/lua/TableUtils.lua        | 19 +++++++++++++++----
 src/mudlet-lua/tests/TableUtils_spec.lua | 18 ++++++++++++++++++
 2 files changed, 33 insertions(+), 4 deletions(-)

diff --git a/src/mudlet-lua/lua/TableUtils.lua b/src/mudlet-lua/lua/TableUtils.lua
index 049a8e53c..fd1e271b3 100644
--- a/src/mudlet-lua/lua/TableUtils.lua
+++ b/src/mudlet-lua/lua/TableUtils.lua
@@ -354,20 +354,31 @@ end
 ---      ["test2"] = function() return true end,
 ---   }
 ---   
%jC4?y&Il=j=$rBtEPegRYl#WvZ>sLN^!k
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
z
zx#n{3{m)*|#alWv_Pk^Isalxb!b@AOmKSUR^@n;rF&wmqjKpGjTmJIt8JTHamWX^OZ8SNtJ)tVH4xZ5u;z1ojP>MX+6MSVmYON)T@clceUQ~PM~n1=W*it@>iyQ&WC}9nu_Zi6-#7E7y+TM2$J8Ii^3n^ZE>(m
z!Nunmz-QZXGs15^IB#xYrNh6N$^~x=3@`J2Aax1US>U{F@=5JP1!qDgOSi!>
z6}2NPlDG6=Pe~Wu9${9ahzqBS-ODGiz4;W-&5GwGcB|M_h&qSI!S36=x7=g#4Z5Jr
zBX0xISXA$?FsxtqBMfDlWDYK_6jN(@`Mj3cW1C!TUDQ
z|IuI5+QaX@ONjET9xtv|QYK)a9CwbHHR+4NuzPD-WK##QQ3{bhLFf|C%*$8k)8I
ztgnCUiq-(z}
zQ!UvTKnKGd2)tRK#8o{Z(k&|OAuQHAEpo2@aR|44#p-oDV0aPUlWOHhrzIYZ=X*;K
z2}UCORxQ&SJlh7zX4JuK=R|L;tkrE}&a&FTo@EA|d}Le`@`jib6Q?-^J_LN0p`{#$
zdNjh5z@BB!@q%X{v%DI4(moPQRkDw0aN>@}vKhu-@PHdu}oflOV{QT57yq)ohqybW%dAn#etk=B?887;Rzf|pkg>K
zCVJ?`rc_e1K5yR>0!j&)LGBzY7?P%Z(|MCH%K|DB88JL(8Kld(3mU9JX+FI04|Gs&
zBCnjF@@Q=PE*ikTtR+T}aWCpT4)v&{ChB#Z!;DjteIr&ofa_?iSTSQk2C9a^-&X7H
z)P*xwYFh>Mum>3+^o!j#s1E6>oriL-$x*ygl?(c(X}G~78LZ#(VXb(t3z$}}SqTtf
z=kS-azjDXT=uDAjmNgWCP3E1Xy6+W`(*y(%W$*zsmiQ*AHov(nU?ocQ?5yt=)80<&
zb(OtU=SjY^VZJ7dO>g+SdY8U%^e*bOgNCL~=hnAflj3aH8_fERn|V-^*BZt@KokiA
zN(u-Rz7{HqLc%5`RuNFy7m-jA5JUJ#B3U4d#*8Fm8Lv=`$fj-4Tym=yS)-Q-B1lly
z6lf`Hfe}P@S>lyIA;jcV^0jmykMC6rR_KShT-B-k#k`
z7QA8b$Vd3{{>SY%$LL?(QL8c~MR)
z{Z)vcC)*h5woWI#?KjPg(iI=ybt7^~=)UXjn#pr4u~AaDryhIytKgJ^%Ch_^LN6uj
zr}|Pm|0Te(x&P(V_dZFd^{pzg;XZuF+(V=l^8g{Ii2Ifj7kS+v`kB8yJG|y2-nGn{
zUe&&e?WdHPPCw3bQH-pA)$PgndF6fY=jzL=5>qH_snzXr?Sl%!$xmOkM-2S?{-Z_^
z_4m4Bs$J0H)5${Q&Z;Xa1ivz>U$GlQVAm%SD0^7C^77Q_+e@P1t_Me3Eq5;mMjvDy
z8J25ZemC=~5`nIs#;NS7+rxm?$1mLL9rD{``39Y&vDYT12!Wp}=)+s-oq2}q!v^`K
z&&i7|_!x~mYO3hKj&VH7il1lcA@|uOBfFkEKf-cV*MlP+`+rfejE)8qHT1XB{OXr^(@E3M#;T)395&XfdC
zy!(>8OT9dHZ~I!I{0EdYP{o>nkF2*i
zZ-_+~SFWwq36v8?X$z|9xy*6jhH-}dSiKgj1I?4O*&E-Sm4(U_2WxjrEb45B9Js7=
z*5tK#)oQ%g`sD4wro|ZbN`C}5ou>XlU1*)q>|3uaZV{;lyVP>2JxYBoj8~CO8$|fc
zov)qrL`8M146n&4n1qeBrecXeZ5iMFsvy2r5v1sm^xb}qSmvd<-oGj^n^kWM57N^1
z(m?{7qlW5wMzi^K+3}}B?Y&tzQCNv&h=~fo)2OK5q}qU$!m-HA-w2u(68tn6@Q<0VbEy({{WNKQNaKJ

literal 0
HcmV?d00001

diff --git a/src/mudlet-lua/lua/stressinator/StressinatorDisplayBench.xml b/src/packages/StressinatorDisplayBench/StressinatorDisplayBench.xml
similarity index 100%
rename from src/mudlet-lua/lua/stressinator/StressinatorDisplayBench.xml
rename to src/packages/StressinatorDisplayBench/StressinatorDisplayBench.xml
diff --git a/src/packages/StressinatorDisplayBench/config.lua b/src/packages/StressinatorDisplayBench/config.lua
new file mode 100644
index 000000000..a71454c1c
--- /dev/null
+++ b/src/packages/StressinatorDisplayBench/config.lua
@@ -0,0 +1,9 @@
+mpackage = [[StressinatorDisplayBench]]
+author = [[Mudlet Default Package]]
+icon = [[mudlet.png]]
+title = [[A benchmark test for triggers in Mudlet.]]
+description = [[### Description
+
+A benchmark test for triggers in Mudlet by reading text from The Count of Monte Cristo, by Alexandre Dumas.]]
+version = [[1]]
+created = "2025-01-19T13:53:46+04:00"
diff --git a/src/packages/deleteOldProfiles/config.lua b/src/packages/deleteOldProfiles/config.lua
new file mode 100644
index 000000000..31b626c22
--- /dev/null
+++ b/src/packages/deleteOldProfiles/config.lua
@@ -0,0 +1,34 @@
+mpackage = [[deleteOldProfiles]]
+author = [[Mudlet Default Package]]
+icon = [[mudlet.png]]
+title = [[Remove excess backup files.]]
+description = [[# deleteOldProfiles Package
+
+Mudlet continuiously creates backups of important data.  This can result in a lot
+of files.  This package deletes old profiles, maps and modules in the 
+"current", "map" and "moduleBackups" folders of the Mudlet home directory that are
+no longer required.
+
+The commands are;
+
+```
+> delete old profiles [days]
+> delete old maps [days]
+> delete old modules[days]
+```
+
+Days is optional, the default is 31 days.
+
+The following files are NOT deleted:
+
+- Files newer than the amount of days specified, or 31 days if not specified.
+- One file for every month before that. Specifically: The first available file of every month prior to this.
+
+```
+-- Examples: 
+> delete old profiles   -- deletes profiles older than 31 days  
+> delete old maps 10    -- deletes maps older than 10 days
+```
+]]
+version = [[1]]
+created = "2024-08-24T08:26:45+02:00"
diff --git a/src/deleteOldProfiles.mpackage b/src/packages/deleteOldProfiles/deleteOldProfiles.mpackage
similarity index 100%
rename from src/deleteOldProfiles.mpackage
rename to src/packages/deleteOldProfiles/deleteOldProfiles.mpackage
diff --git a/src/packages/deleteOldProfiles/deleteOldProfiles.xml b/src/packages/deleteOldProfiles/deleteOldProfiles.xml
new file mode 100644
index 000000000..0ee21a7e7
--- /dev/null
+++ b/src/packages/deleteOldProfiles/deleteOldProfiles.xml
@@ -0,0 +1,100 @@
+
+
+
+	
+	
+	
+		
+			delete old profiles
+			
+			
+			
+			^delete old (profiles|maps|modules)(?: (\d+))?$
+		
+	
+	
+	
+		
+			
+		
+	
+	
+	
+		
+	
+
diff --git a/src/packages/echo/config.lua b/src/packages/echo/config.lua
new file mode 100644
index 000000000..bb5f3222d
--- /dev/null
+++ b/src/packages/echo/config.lua
@@ -0,0 +1,57 @@
+mpackage = [[echo]]
+author = [[Mudlet Default Package]]
+icon = [[mudlet.png]]
+title = [[A set of aliases to test triggers on the command line.]]
+description = [[# Echo Package
+
+The echo package provides a means of testing triggers via the command line with four command aliases;
+`` `echo, `cecho, `decho, `hecho``.  
+
+All act as if the given text came from the game itself and will fire any matching triggers.  
+
+See [Triggers](https://wiki.mudlet.org/w/Manual:Introduction#Triggers) for further information on matching text.
+  
+## `echo Alias
+
+Displays text on the screen and tells all matching triggers to fire.  For coloring use one
+of the other functions mentioned below.
+
+```
+-- examples
+> `echo text - displays text on the main screen and tells all matching triggers to fire
+> `echo This is a sample line from the game$$And this is a new line.
+```
+See [echo](https://wiki.mudlet.org/w/Manual:Lua_Functions#echo), [feedTriggers](https://wiki.mudlet.org/w/Manual:Lua_Functions#feedTriggers), 
+  
+## `cecho Alias
+
+Like echo, but you can add color information using color names and ANSI values.
+
+```
+-- example: color format is 
+> `cecho green on red reset$$<124:100>foreground of ANSI124 and background of ANSI100
+```
+See [cecho](https://wiki.mudlet.org/w/Manual:Lua_Functions#cecho), [cfeedTriggers](https://wiki.mudlet.org/w/Manual:Lua_Functions#cfeedTriggers).
+
+## `decho Alias
+
+Like cecho, but you can add color information using  format.
+
+```
+-- example
+> `decho <0,128,0:128,0,0>green on red reset
+```
+See [decho](https://wiki.mudlet.org/w/Manual:Lua_Functions#decho), [dfeedTriggers](https://wiki.mudlet.org/w/Manual:Lua_Functions#dfeedTriggers).
+
+## `hecho Alias
+
+Like cecho, but you can add color information using hex #RRGGBB format.
+
+```
+-- example
+> `hecho #008000,800000green on red#r reset
+```
+See [hecho](https://wiki.mudlet.org/w/Manual:Lua_Functions#hecho), [hfeedTriggers](https://wiki.mudlet.org/w/Manual:Lua_Functions#hfeedTriggers).
+]]
+version = [[1]]
+created = "2024-08-24T08:27:19+02:00"
diff --git a/src/echo.mpackage b/src/packages/echo/echo.mpackage
similarity index 100%
rename from src/echo.mpackage
rename to src/packages/echo/echo.mpackage
diff --git a/src/echo.xml b/src/packages/echo/echo.xml
similarity index 95%
rename from src/echo.xml
rename to src/packages/echo/echo.xml
index 030ec11e2..5eaeb9512 100644
--- a/src/echo.xml
+++ b/src/packages/echo/echo.xml
@@ -52,7 +52,7 @@ echo("\n")
 	
 	
 	
-	
-		
-	
+	
+		
+	
 
diff --git a/src/packages/enable-accessibility/config.lua b/src/packages/enable-accessibility/config.lua
new file mode 100644
index 000000000..5a58919a3
--- /dev/null
+++ b/src/packages/enable-accessibility/config.lua
@@ -0,0 +1,32 @@
+mpackage = [[enable-accessibility]]
+author = [[Mudlet Default Package]]
+icon = [[mudlet.png]]
+title = [[Configuration for visually impaired users.]]
+description = [[# enable-accessibility Package
+
+This package provides two aliases for visually impaired users.
+
+```
+> mudlet access on
+> mudlet access reader
+```
+
+## mudlet access on
+
+Configures the following settings;
+
+- clears the command line after sending the command to the game
+- does not echo the commands sent on the main screen
+- adds a shortcut to switch between input line and main window, default Ctrl+Tab
+- removes blank lines on Windows OS
+
+## mudlet access reader
+
+VoiceOver is text-to-speech (TTS) for Mac OS, but will skip reading text when there's lots of it coming on.
+
+This command configures a third-party TTS plugin called [mudlet-reader](https://github.com/tspivey/mudlet-reader) to alleviate this issue.
+
+See [Accessibility on OSX](https://wiki.mudlet.org/w/Accessibility_on_OSX) for more information.
+]]
+version = [[2]]
+created = "2025-06-07T20:44:12-04:00"
diff --git a/src/enable-accessibility.mpackage b/src/packages/enable-accessibility/enable-accessibility.mpackage
similarity index 100%
rename from src/enable-accessibility.mpackage
rename to src/packages/enable-accessibility/enable-accessibility.mpackage
diff --git a/src/mudlet-lua/lua/enable-accessibility/enable-accessibility.xml b/src/packages/enable-accessibility/enable-accessibility.xml
similarity index 96%
rename from src/mudlet-lua/lua/enable-accessibility/enable-accessibility.xml
rename to src/packages/enable-accessibility/enable-accessibility.xml
index 002739c32..effd33bba 100644
--- a/src/mudlet-lua/lua/enable-accessibility/enable-accessibility.xml
+++ b/src/packages/enable-accessibility/enable-accessibility.xml
@@ -21,9 +21,6 @@ echo("Disabling visual auto complete in the code editor ✓\n")
 setConfig("caretShortcut", "ctrltab")
 echo("Shortcut to switch between input line and main window set to Ctrl+Tab. You can also change it to either Tab or F6 in settings.\n")
 
-setConfig("enableBlinkText", false)
-echo("Blinking text disabled ✓\n")
-
 if not getConfig("f3SearchEnabled") then
 	setConfig("f3SearchEnabled", true)
 end
diff --git a/src/packages/generic_mapper/config.lua b/src/packages/generic_mapper/config.lua
new file mode 100644
index 000000000..361038792
--- /dev/null
+++ b/src/packages/generic_mapper/config.lua
@@ -0,0 +1,28 @@
+mpackage = [[generic_mapper]]
+author = [[Mudlet Default Package]]
+icon = [[mudlet.png]]
+title = [[Semi-automatic mapping, designed to work with many MUDs.]]
+description = [[# generic_mapper Package
+
+This script allows for semi-automatic mapping using the included triggers.
+While different games can have dramatically different ways of displaying
+information, some effort has been put into giving the script a wide range of
+potential patterns to look for, so that it can work with minimal effort in
+many cases.
+
+generic_mapper looks at a combination of room titles, descriptions and exits
+to locate and follow your character around maps you can make yourself, share
+and download for your MUD.
+
+Two commands to get started are;
+```
+> map basics
+> map help
+```
+
+See [this forum thread](https://forums.mudlet.org/viewtopic.php?f=13&t=6105) for further assistance.
+
+See [this forum thread](https://forums.mudlet.org/search.php?keywords=mapping+script&terms=all&author=&sc=1&sf=titleonly&sr=topics&sk=t&sd=d&st=0&ch=400&t=0&submit=Search&pk_vid=08fcc4383ef3530916874145245184da) for more mapping scripts.
+]]
+version = [[2.1.9]]
+created = "2026-07-18T12:00:00+00:00"
diff --git a/src/mudlet-lua/lua/generic-mapper/generic_mapper.mpackage b/src/packages/generic_mapper/generic_mapper.mpackage
similarity index 100%
rename from src/mudlet-lua/lua/generic-mapper/generic_mapper.mpackage
rename to src/packages/generic_mapper/generic_mapper.mpackage
diff --git a/src/mudlet-lua/lua/generic-mapper/generic_mapper.xml b/src/packages/generic_mapper/generic_mapper.xml
similarity index 100%
rename from src/mudlet-lua/lua/generic-mapper/generic_mapper.xml
rename to src/packages/generic_mapper/generic_mapper.xml
diff --git a/src/mudlet-lua/lua/generic-mapper/versions.lua b/src/packages/generic_mapper/versions.lua
similarity index 100%
rename from src/mudlet-lua/lua/generic-mapper/versions.lua
rename to src/packages/generic_mapper/versions.lua
diff --git a/src/packages/gui-drop/config.lua b/src/packages/gui-drop/config.lua
new file mode 100644
index 000000000..203e00cb9
--- /dev/null
+++ b/src/packages/gui-drop/config.lua
@@ -0,0 +1,18 @@
+mpackage = [[gui-drop]]
+author = [[Mudlet Default Package]]
+icon = [[mudlet.png]]
+title = [[Drag and drop images onto the main window to turn into a label and container.]]
+description = [[Allow a user to drag and drop an image on the main screen which will turn it into a label and AdjustableContainer.
+
+### Description
+
+This packages allows a user to drag and drop an image on the main screen which will turn it into a label and AdjustableContainer.
+The resultant script can be found in GUIDropManager which can then be tailored further as per normal scripting rules.  The images
+are copied to %user-profile/GUIDropImages/
+
+### Usage
+
+Just drop an image file into the main window.  It will be converted into a label inside an AdjustableContainer.
+]]
+version = [[1.1]]
+created = "2025-01-19T13:10:54+04:00"
diff --git a/src/mudlet-lua/lua/gui-drop/gui-drop.mpackage b/src/packages/gui-drop/gui-drop.mpackage
similarity index 100%
rename from src/mudlet-lua/lua/gui-drop/gui-drop.mpackage
rename to src/packages/gui-drop/gui-drop.mpackage
diff --git a/src/mudlet-lua/lua/gui-drop/gui-drop.xml b/src/packages/gui-drop/gui-drop.xml
similarity index 100%
rename from src/mudlet-lua/lua/gui-drop/gui-drop.xml
rename to src/packages/gui-drop/gui-drop.xml
diff --git a/src/packages/icesus-loader/config.lua b/src/packages/icesus-loader/config.lua
new file mode 100644
index 000000000..7d0d5dd1a
--- /dev/null
+++ b/src/packages/icesus-loader/config.lua
@@ -0,0 +1,15 @@
+mpackage = [[icesus-loader]]
+author = [[Mudlet Default Package]]
+icon = [[mudlet.png]]
+title = [[Downloads the Icesus interface when you first connect.]]
+description = [[### Description
+
+Preinstalled on new Icesus profiles. On your first connection it downloads the
+Icesus Mudlet package, maintained by the Icesus team, installs it and removes itself.
+
+### See Also
+
+* [Icesus Mudlet package on GitHub](https://github.com/Icesus-mud/mudlet-package)
+]]
+version = [[1]]
+created = "2026-08-04T00:00:00+00:00"
diff --git a/src/packages/icesus-loader/icesus-loader.mpackage b/src/packages/icesus-loader/icesus-loader.mpackage
new file mode 100644
index 0000000000000000000000000000000000000000..9bcba74bc3c9e0d0a78cfa028ed19cc68f313eb6
GIT binary patch
literal 111191
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
+--- +--- When several tables hold different values for the same key, those values are +--- collected into a new subtable, and any further collision on that key is +--- appended to it. The tables you pass in are never modified. function table.union(...) local sets = { ... } local union = {} + -- `pairs()` never yields a nil value, so `union[key] == nil` is an exact + -- presence test and stays correct for a legitimate `false`. `merged` tracks + -- which keys hold a subtable that we created, so a table that came from a + -- caller is never appended to -- doing that both flattened the result and + -- modified the caller's table in place. + local merged = {} for _, set in ipairs(sets) do for key, val in pairs(set) do - if union[key] and union[key] ~= val then - if type(union[key]) == 'table' then + if union[key] == nil then + union[key] = val + elseif union[key] ~= val then + if merged[key] then table.insert(union[key], val) else union[key] = { union[key], val } + merged[key] = true end - else - union[key] = val end end end diff --git a/src/mudlet-lua/tests/TableUtils_spec.lua b/src/mudlet-lua/tests/TableUtils_spec.lua index 988c0741a..2118d8e1b 100644 --- a/src/mudlet-lua/tests/TableUtils_spec.lua +++ b/src/mudlet-lua/tests/TableUtils_spec.lua @@ -669,6 +669,24 @@ describe("Tests TableUtils.lua functions", function() local actual = table.union(tblA, tblB, tblC) assert.same(expected,actual) end) + + it("should not modify a table it was given", function() + local first = { key = { 1, 2 } } + local actual = table.union(first, { key = 5 }) + assert.same({ { 1, 2 }, 5 }, actual.key) + assert.same({ 1, 2 }, first.key) + assert.is_false(rawequal(actual.key, first.key)) + end) + + it("should collect a colliding false into a subtable", function() + local actual = table.union({ key = false }, { key = 7 }) + assert.same({ false, 7 }, actual.key) + end) + + it("should append a third colliding value to the same subtable", function() + local actual = table.union({ key = 1 }, { key = 2 }, { key = 3 }) + assert.same({ 1, 2, 3 }, actual.key) + end) end) describe("Tests the functionality of table.n_union", function() From 9f783e48c091c511e2ec9d1ee1455b93cf64ea49 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Tue, 4 Aug 2026 21:53:27 +0200 Subject: [PATCH 079/155] infrastructure: cover the untested lua-lib surface (#9630) #### Brief overview of PR changes/additions - Test-only sweep of the lua-lib domain, the largest uncovered pool in the Lua API audit: 213 new busted specs across 12 existing spec files, covering 74 functions that had no coverage at all (GUIUtils gauge/colour/echo/link/scroll/cursor helpers, IDManager's private-manager trigger family, DebugTools, GMCP, LuaGlobal, TableUtils, DB, Other.lua, and the Geyser MiniConsole/Button/Gauge/Label wrappers). - Every spec asserts real observable behaviour - geometry and visibility via the #9528 getters, console readback, colour via `getTextFormat`, room user data, command-line contents - rather than "did not error"; where no getter exists, `spy.on` keeps the real function and pins which widget the call reaches. - 9 specs are `pending` instead of freezing behaviour, each naming a defect found while writing it (`PadHexNum`/`RGB2Hex` padding on the wrong side, `setGaugeWindow`'s `show = show or true`, `scrollUp`/`scrollDown` raising on an unknown window, `getRoomNameOffset` dropping minus signs, `selectCmdLineText` returning a stack leftover, and `IDMgr:stopAllTriggers`/`emergencyStop`/`stopAllNamedTriggers` skipping the regex store). Issues to follow. #### Motivation for adding to Mudlet These are shipped, user-facing Lua functions that nothing exercised, so regressions in them reach users first. No Mudlet source is changed here. #### Other info (issues closed, discussion etc) **Test case:** full busted suite 2033 passed / 0 failed / 0 errors / 26 pending (baseline 1829/0/0/17), green twice on the same isolated profile and once fresh; 47 of the new specs verified by breaking the function under test in `src/mudlet-lua/lua/` and watching them fail. Assisted-by: Claude:claude-opus-5 --- src/mudlet-lua/tests/DB_spec.lua | 33 + src/mudlet-lua/tests/DebugTools_spec.lua | 113 +- src/mudlet-lua/tests/GMCP_spec.lua | 113 ++ src/mudlet-lua/tests/GUIUtils_spec.lua | 1181 ++++++++++++++++- src/mudlet-lua/tests/GeyserButton_spec.lua | 72 + src/mudlet-lua/tests/GeyserGauge_spec.lua | 30 + src/mudlet-lua/tests/GeyserLabel_spec.lua | 61 + .../tests/GeyserMiniConsole_spec.lua | 289 ++++ src/mudlet-lua/tests/IDManager_spec.lua | 236 ++++ src/mudlet-lua/tests/Mapper_spec.lua | 53 + src/mudlet-lua/tests/Other_spec.lua | 151 +++ src/mudlet-lua/tests/TableUtils_spec.lua | 29 + 12 files changed, 2355 insertions(+), 6 deletions(-) diff --git a/src/mudlet-lua/tests/DB_spec.lua b/src/mudlet-lua/tests/DB_spec.lua index 7238ff602..f9e95f841 100644 --- a/src/mudlet-lua/tests/DB_spec.lua +++ b/src/mudlet-lua/tests/DB_spec.lua @@ -2142,3 +2142,36 @@ describe("Tests DB.lua functions", function() end) end) + +describe("Tests db:echo_sql", function() + local saved + + before_each(function() + saved = db.debug_sql + end) + + after_each(function() + db.debug_sql = saved + end) + + it("prints the statement it is handed when SQL debugging is on", function() + db.debug_sql = true + local printSpy = spy.on(_G, "print") + finally(function() print:revert() end) + db:echo_sql("SELECT 1;") + assert.spy(printSpy).was.called(1) + assert.spy(printSpy).was.called_with("SELECT 1;") + end) + + it("stays silent while SQL debugging is off", function() + db.debug_sql = false + local printSpy = spy.on(_G, "print") + finally(function() print:revert() end) + db:echo_sql("SELECT 1;") + assert.spy(printSpy).was_not_called() + end) + + it("is silent by default", function() + assert.is_falsy(saved) + end) +end) diff --git a/src/mudlet-lua/tests/DebugTools_spec.lua b/src/mudlet-lua/tests/DebugTools_spec.lua index a0351fb7d..fda996edf 100644 --- a/src/mudlet-lua/tests/DebugTools_spec.lua +++ b/src/mudlet-lua/tests/DebugTools_spec.lua @@ -80,4 +80,115 @@ describe("Tests DebugTools.lua functions", function() end) end) -end) \ No newline at end of file + + describe("Tests the functionality of display", function() + local function mainConsoleText() + return table.concat(getLines("main", 0, getLastLineNumber("main") + 1), "\n") + end + + before_each(function() + clearWindow() + end) + + it("Should write an inspected table to the main console", function() + display({alpha = 1, beta = "two"}) + local text = mainConsoleText() + assert.is_truthy(text:find("alpha", 1, true)) + assert.is_truthy(text:find("beta", 1, true)) + assert.is_truthy(text:find("two", 1, true)) + end) + + it("Should write scalars the way inspect renders them", function() + display("hello") + assert.is_truthy(mainConsoleText():find('"hello"', 1, true)) + end) + + it("Should render nil rather than printing nothing", function() + display(nil) + assert.is_truthy(mainConsoleText():find("nil", 1, true)) + end) + + it("Should display each argument in the order it was given", function() + display("first", "second") + local text = mainConsoleText() + local first, second = text:find('"first"', 1, true), text:find('"second"', 1, true) + assert.is_truthy(first) + assert.is_truthy(second) + assert.is_true(first < second, "the arguments should be rendered in order") + end) + + it("Should keep the position of a nil in the middle of its arguments", function() + display("before", nil, "after") + local text = mainConsoleText() + local before = text:find('"before"', 1, true) + local nilAt = text:find("nil", 1, true) + local after = text:find('"after"', 1, true) + assert.is_truthy(before) + assert.is_truthy(nilAt) + assert.is_truthy(after) + assert.is_true(before < nilAt and nilAt < after, "the nil should keep its place between the two strings") + end) + end) + + describe("Tests the functionality of showMultimatches", function() + local savedMultimatches + + before_each(function() + clearWindow() + savedMultimatches = _G.multimatches + end) + + after_each(function() + _G.multimatches = savedMultimatches + end) + + it("Should list every regex and its captures", function() + _G.multimatches = { + {"first whole match", "first capture"}, + {"second whole match"}, + } + showMultimatches() + local text = table.concat(getLines("main", 0, getLastLineNumber("main") + 1), "\n") + assert.is_truthy(text:find("multimatches[n][m]", 1, true)) + assert.is_truthy(text:find("regex 1 captured", 1, true)) + assert.is_truthy(text:find("regex 2 captured", 1, true)) + assert.is_truthy(text:find("key=1 value=first whole match", 1, true)) + assert.is_truthy(text:find("key=2 value=first capture", 1, true)) + assert.is_truthy(text:find("key=1 value=second whole match", 1, true)) + end) + + it("Should still print its banner when there is nothing to show", function() + _G.multimatches = {} + showMultimatches() + local text = table.concat(getLines("main", 0, getLastLineNumber("main") + 1), "\n") + assert.is_truthy(text:find("multimatches[n][m]", 1, true)) + assert.is_falsy(text:find("captured", 1, true)) + end) + end) + + describe("Tests the functionality of showCaptureGroups", function() + it("Should recolour every capture group of the match", function() + local selectSpy, captured, defaultFormat, groupFormat + local id = tempRegexTrigger("^You wave (goodbye) to (everyone)\\.$", function() + captured = table.size(matches) + selectString("You wave", 1) + defaultFormat = getTextFormat().foreground + selectSpy = spy.on(_G, "selectCaptureGroup") + -- Mudlet swallows errors raised inside a trigger, so revert through + -- pcall rather than leaving the spy installed for the whole process + pcall(showCaptureGroups) + selectCaptureGroup:revert() + selectString("goodbye", 1) + groupFormat = getTextFormat().foreground + end) + feedTriggers("You wave goodbye to everyone.\n") + killTrigger(id) + + assert.is_equal(3, captured, "the whole match plus two capture groups should be present") + assert.spy(selectSpy).was.called(3) + -- the colours it picks are random, so the assertion is that the capture + -- group no longer wears the colour the rest of the line does + assert.are_not.same(defaultFormat, groupFormat) + end) + end) +end) diff --git a/src/mudlet-lua/tests/GMCP_spec.lua b/src/mudlet-lua/tests/GMCP_spec.lua index 451f3ff26..476eb67ac 100644 --- a/src/mudlet-lua/tests/GMCP_spec.lua +++ b/src/mudlet-lua/tests/GMCP_spec.lua @@ -191,3 +191,116 @@ describe("Tests the argument and disconnected contract of sendGMCP", function() assert.is_true(contains(err, "not connected to game server")) end) end) + +describe("Tests the functionality of gmod.print", function() + it("Should write the tracker prefixed message to the main console", function() + clearWindow() + gmod.print("a tracker message") + local text = table.concat(getLines("main", 0, getLastLineNumber("main") + 1), "\n") + assert.is_truthy(text:find("[GMCP Tracker]", 1, true)) + assert.is_truthy(text:find("a tracker message", 1, true)) + end) + + it("Should colour the prefix yellow and the message white", function() + clearWindow() + gmod.print("coloured message") + -- the message is wrapped in newlines, so park the cursor on its line + -- before selecting: selectString only searches the current line + local lines = getLines("main", 0, getLastLineNumber("main") + 1) + local index + for i, line in ipairs(lines) do + if line:find("[GMCP Tracker]", 1, true) then + index = i - 1 + end + end + assert.is_not_nil(index, "gmod.print should have written a tracker line") + moveCursor(0, index) + selectString("[GMCP Tracker]", 1) + assert.are.same(color_table["yellow"], getTextFormat().foreground) + selectString("coloured message", 1) + assert.are.same(color_table["white"], getTextFormat().foreground) + end) +end) + +describe("Tests the functionality of gmod.reenableModules", function() + local user = "reenableUser" + local module = "OogaBoogaReenableModule" + + after_each(function() + gmod.disableModule(user, module) + gmcp.BustedReenableProbe = nil + end) + + it("Should send nothing while the gmcp table is still empty", function() + -- reenableModules is driven by sysProtocolEnabled, which can fire before + -- the server has sent any GMCP at all + if next(gmcp) then + -- the profile or an earlier spec left GMCP data behind, so the guard + -- this test is about cannot be reached + pending("the gmcp table is not empty in this profile") + end + gmod.enableModule(user, module) + local sg = spy.on(_G, "sendGMCP") + finally(function() sendGMCP:revert() end) + gmod.reenableModules() + assert.spy(sg).was_not_called() + end) + + it("Should re-announce every registered module once GMCP data has arrived", function() + gmod.enableModule(user, module) + gmcp.BustedReenableProbe = {} + local sg = spy.on(_G, "sendGMCP") + finally(function() sendGMCP:revert() end) + gmod.reenableModules() + assert.spy(sg).was_called_with(match.has_match("Core.Supports.Add .*" .. module .. " 1")) + end) + + it("Should send nothing when no module is registered", function() + gmcp.BustedReenableProbe = {} + local sg = spy.on(_G, "sendGMCP") + finally(function() sendGMCP:revert() end) + -- a module registered by an earlier spec would be re-announced too, so + -- measure the difference this test's own module makes + gmod.reenableModules() + local withoutOurs = #sg.calls + gmod.enableModule(user, module) + sendGMCP:clear() + gmod.reenableModules() + assert.is_true(#sg.calls > 0, "a registered module should be re-announced") + assert.are.equal(0, withoutOurs, "nothing should be announced while no module is registered") + end) +end) + +describe("Tests the functionality of __gmcp_merge_gmcp_sub_tables", function() + it("Should fold the staged table into the named sub table", function() + local a = {Char = {name = "old", level = 1}, __needMerge = {name = "new", hp = 50}} + __gmcp_merge_gmcp_sub_tables(a, "Char") + assert.are.same({name = "new", level = 1, hp = 50}, a.Char) + end) + + it("Should clear the staging table afterwards", function() + local a = {Room = {}, __needMerge = {num = 7}} + __gmcp_merge_gmcp_sub_tables(a, "Room") + assert.is_nil(a.__needMerge) + end) + + it("Should leave the sub table alone when nothing is staged", function() + local a = {Room = {num = 7}, __needMerge = {}} + __gmcp_merge_gmcp_sub_tables(a, "Room") + assert.are.same({num = 7}, a.Room) + assert.is_nil(a.__needMerge) + end) + + it("Should raise rather than silently drop data when the sub table is missing", function() + -- the C++ side stages into __needMerge and calls this immediately, so a + -- module arriving before its sub table exists is a real ordering case + assert.has_error(function() __gmcp_merge_gmcp_sub_tables({__needMerge = {a = 1}}, "Char") end) + assert.has_error(function() __gmcp_merge_gmcp_sub_tables({Char = {}}, "Char") end) + end) + + it("Should merge nested tables by replacing them wholesale", function() + local a = {Char = {Vitals = {hp = 1}}, __needMerge = {Vitals = {mp = 2}}} + __gmcp_merge_gmcp_sub_tables(a, "Char") + assert.are.same({Vitals = {mp = 2}}, a.Char) + end) +end) diff --git a/src/mudlet-lua/tests/GUIUtils_spec.lua b/src/mudlet-lua/tests/GUIUtils_spec.lua index 1b3f8838f..255cf7ead 100644 --- a/src/mudlet-lua/tests/GUIUtils_spec.lua +++ b/src/mudlet-lua/tests/GUIUtils_spec.lua @@ -1067,9 +1067,1180 @@ describe("Tests the GUI utilities as far as possible without mudlet", function() assert.equals(3, funcCalls) end) end) -end) ---[[ - TODO: - replaceLine and variants ---]] + describe("Tests the functionality of PadHexNum", function() + it("Should zero-pad a single hex digit below ten", function() + assert.equals("00", PadHexNum("0")) + assert.equals("05", PadHexNum("5")) + assert.equals("09", PadHexNum("9")) + end) + + it("Should leave an already two digit number alone", function() + assert.equals("FF", PadHexNum("FF")) + assert.equals("0A", PadHexNum("0A")) + assert.equals("10", PadHexNum("10")) + end) + + it("Should error when not given a string", function() + assert.has_error(function() PadHexNum(15) end) + end) + + it("Should zero-pad single hex digits above nine as well", function() + -- BUG: for values 11..15 the zero is appended instead of prepended, so + -- PadHexNum("B") is "B0" (176) rather than "0B" (11); the value 10 hits + -- neither branch and comes back as the unpadded, single character "A" + pending("PadHexNum pads on the wrong side above nine - see the Wave 3d report") + assert.equals("0A", PadHexNum("A")) + assert.equals("0B", PadHexNum("B")) + assert.equals("0F", PadHexNum("F")) + end) + end) + + describe("Tests the functionality of RGB2Hex", function() + it("Should convert an r, g, b triple to a six digit hex string", function() + assert.equals("FFFFFF", RGB2Hex(255, 255, 255)) + assert.equals("000000", RGB2Hex(0, 0, 0)) + assert.equals("80C020", RGB2Hex(128, 192, 32)) + end) + + it("Should accept a colour name in place of the triple", function() + assert.equals("FFFFFF", RGB2Hex("white")) + assert.equals("000000", RGB2Hex("black")) + assert.equals(RGB2Hex(getRGB("blue")), RGB2Hex("blue")) + end) + + it("Should error when given no arguments at all", function() + assert.has_error(function() RGB2Hex() end) + end) + + it("Should produce six hex digits for every component below sixteen", function() + -- BUG: RGB2Hex inherits PadHexNum's wrong-side padding, so a component + -- of 11 becomes "B0" (176) and one of 10 contributes a single "A", + -- yielding the malformed five character string "AB00C" here + pending("RGB2Hex mis-encodes components below sixteen - see the Wave 3d report") + assert.equals("0A0B0C", RGB2Hex(10, 11, 12)) + end) + end) + + describe("Tests the functionality of getRGB", function() + it("Should return the three components of a named colour", function() + local r, g, b = getRGB("red") + assert.are.same({255, 0, 0}, {r, g, b}) + assert.are.same(color_table["green"], {getRGB("green")}) + end) + + it("Should honour a colour the user has redefined", function() + local original = color_table["ansi_000"] + color_table["ansi_000"] = {1, 2, 3} + local r, g, b = getRGB("ansi_000") + color_table["ansi_000"] = original + assert.are.same({1, 2, 3}, {r, g, b}) + end) + + it("Should error when not given a string", function() + assert.has_error(function() getRGB(42) end) + end) + + it("Should error for a colour name that does not exist", function() + assert.has_error(function() getRGB("definitelyNotAColour") end) + end) + end) + + describe("Tests the functionality of unpack_w_nil", function() + it("Should return every value up to n, including embedded nils", function() + local packed = {1, nil, 3, n = 3} + local a, b, c = unpack_w_nil(packed) + assert.are.same({1, nil, 3}, {a, b, c}) + assert.is_nil(b) + end) + + it("Should start at the counter it is given", function() + local packed = {"a", "b", "c", n = 3} + assert.are.same({"b", "c"}, {unpack_w_nil(packed, 2)}) + end) + + it("Should return a trailing nil rather than stopping short of n", function() + local packed = {"only", nil, n = 2} + -- a plain assignment cannot tell "returned nil" from "returned nothing", + -- so count the results + assert.equals(2, select("#", unpack_w_nil(packed))) + local first, second = unpack_w_nil(packed) + assert.equals("only", first) + assert.is_nil(second) + end) + end) + + describe("Tests the functionality of the custom gauge family", function() + local gaugeName = "guiUtilsTestGauge" + + local function geometry(name) + local x, y, width, height = getWindowGeometry(name) + return {x = x, y = y, width = width, height = height} + end + + before_each(function() + createGauge("main", gaugeName, 300, 20, 30, 300, "start", 0, 255, 0, "horizontal") + end) + + after_each(function() + for _, suffixName in ipairs({"_back", "_front", "_text"}) do + pcall(deleteLabel, gaugeName .. suffixName) + end + gaugesTable[gaugeName] = nil + end) + + describe("Tests the functionality of createGauge", function() + it("Should create the back, front and text labels at the requested geometry", function() + for _, suffixName in ipairs({"_back", "_front", "_text"}) do + assert.equals("label", windowType(gaugeName .. suffixName)) + end + assert.are.same({x = 30, y = 300, width = 300, height = 20}, geometry(gaugeName .. "_back")) + assert.are.same({x = 30, y = 300, width = 300, height = 20}, geometry(gaugeName .. "_text")) + -- a fresh gauge is full, so the front label covers the whole back one + assert.are.same({x = 30, y = 300, width = 300, height = 20}, geometry(gaugeName .. "_front")) + end) + + it("Should record the gauge in gaugesTable and show it", function() + local info = gaugesTable[gaugeName] + assert.equals(300, info.width) + assert.equals(20, info.height) + assert.equals(30, info.x) + assert.equals(300, info.y) + assert.equals("horizontal", info.orientation) + assert.equals(1, info.value) + assert.is_true(windowVisible(gaugeName .. "_back")) + assert.is_true(windowVisible(gaugeName .. "_front")) + end) + + it("Should accept a colour name in place of the r, g, b triple", function() + finally(function() + for _, suffixName in ipairs({"_back", "_front", "_text"}) do + pcall(deleteLabel, "colourNameGauge" .. suffixName) + end + gaugesTable.colourNameGauge = nil + end) + createGauge("colourNameGauge", 100, 10, 0, 0, nil, "green") + assert.are.same({0, 255, 0}, {gaugesTable.colourNameGauge.r, gaugesTable.colourNameGauge.g, gaugesTable.colourNameGauge.b}) + assert.equals("horizontal", gaugesTable.colourNameGauge.orientation) + end) + + it("Should reject an unknown orientation", function() + assert.has_error(function() + createGauge("main", "badOrientationGauge", 10, 10, 0, 0, "", 0, 0, 0, "sideways") + end) + end) + end) + + describe("Tests the functionality of setGauge", function() + it("Should shrink the front label to the fraction given, horizontally", function() + setGauge(gaugeName, 50, 100) + assert.equals(0.5, gaugesTable[gaugeName].value) + assert.are.same({x = 30, y = 300, width = 150, height = 20}, geometry(gaugeName .. "_front")) + -- the backdrop keeps its full size + assert.are.same({x = 30, y = 300, width = 300, height = 20}, geometry(gaugeName .. "_back")) + end) + + it("Should grow a vertical gauge upwards from its bottom edge", function() + gaugesTable[gaugeName].orientation = "vertical" + setGauge(gaugeName, 1, 4) + assert.are.same({x = 30, y = 315, width = 300, height = 5}, geometry(gaugeName .. "_front")) + end) + + it("Should shrink a goofy gauge towards its right edge", function() + gaugesTable[gaugeName].orientation = "goofy" + setGauge(gaugeName, 1, 4) + assert.are.same({x = 255, y = 300, width = 75, height = 20}, geometry(gaugeName .. "_front")) + end) + + it("Should shrink a batty gauge downwards from its top edge", function() + gaugesTable[gaugeName].orientation = "batty" + setGauge(gaugeName, 1, 2) + assert.are.same({x = 30, y = 300, width = 300, height = 10}, geometry(gaugeName .. "_front")) + end) + + it("Should update the caption when one is passed", function() + setGauge(gaugeName, 1, 2, "half") + assert.is_truthy(getLabelText(gaugeName .. "_text"):find("half", 1, true)) + end) + + it("Should let the fill run past the backdrop when the value exceeds the maximum", function() + setGauge(gaugeName, 3, 2) + assert.equals(1.5, gaugesTable[gaugeName].value) + assert.equals(450, select(3, getWindowGeometry(gaugeName .. "_front"))) + end) + + it("Should error for an unknown gauge or a non numeric value", function() + assert.has_error(function() setGauge("noSuchGauge", 1, 1) end) + assert.has_error(function() setGauge(gaugeName, "lots", 1) end) + assert.has_error(function() setGauge(gaugeName, 1, "lots") end) + end) + end) + + describe("Tests the functionality of moveGauge", function() + it("Should move every label of the gauge and remember the new position", function() + moveGauge(gaugeName, 11, 22) + assert.are.same({x = 11, y = 22, width = 300, height = 20}, geometry(gaugeName .. "_back")) + assert.are.same({x = 11, y = 22, width = 300, height = 20}, geometry(gaugeName .. "_text")) + assert.are.same({x = 11, y = 22, width = 300, height = 20}, geometry(gaugeName .. "_front")) + assert.equals(11, gaugesTable[gaugeName].x) + assert.equals(22, gaugesTable[gaugeName].y) + end) + + it("Should keep the current fill when it moves", function() + setGauge(gaugeName, 1, 4) + moveGauge(gaugeName, 5, 6) + assert.are.same({x = 5, y = 6, width = 75, height = 20}, geometry(gaugeName .. "_front")) + end) + + it("Should error for an unknown gauge or non numeric coordinates", function() + assert.has_error(function() moveGauge("noSuchGauge", 1, 1) end) + assert.has_error(function() moveGauge(gaugeName, "1", 1) end) + assert.has_error(function() moveGauge(gaugeName, 1, "1") end) + end) + end) + + describe("Tests the functionality of resizeGauge", function() + it("Should resize every label of the gauge and remember the new size", function() + resizeGauge(gaugeName, 120, 40) + assert.are.same({x = 30, y = 300, width = 120, height = 40}, geometry(gaugeName .. "_back")) + assert.are.same({x = 30, y = 300, width = 120, height = 40}, geometry(gaugeName .. "_text")) + assert.are.same({x = 30, y = 300, width = 120, height = 40}, geometry(gaugeName .. "_front")) + assert.equals(120, gaugesTable[gaugeName].width) + assert.equals(40, gaugesTable[gaugeName].height) + end) + + it("Should rescale the fill to the new width", function() + setGauge(gaugeName, 1, 2) + resizeGauge(gaugeName, 200, 20) + assert.equals(100, select(3, getWindowGeometry(gaugeName .. "_front"))) + end) + + it("Should error for an unknown gauge or non numeric sizes", function() + assert.has_error(function() resizeGauge("noSuchGauge", 1, 1) end) + assert.has_error(function() resizeGauge(gaugeName, "1", 1) end) + assert.has_error(function() resizeGauge(gaugeName, 1, "1") end) + end) + end) + + describe("Tests the functionality of hideGauge and showGauge", function() + it("Should hide and show all three labels", function() + hideGauge(gaugeName) + assert.is_false(windowVisible(gaugeName .. "_back")) + assert.is_false(windowVisible(gaugeName .. "_front")) + assert.is_false(windowVisible(gaugeName .. "_text")) + showGauge(gaugeName) + assert.is_true(windowVisible(gaugeName .. "_back")) + assert.is_true(windowVisible(gaugeName .. "_front")) + assert.is_true(windowVisible(gaugeName .. "_text")) + end) + + it("Should error for an unknown gauge", function() + assert.has_error(function() hideGauge("noSuchGauge") end) + assert.has_error(function() showGauge("noSuchGauge") end) + end) + end) + + describe("Tests the functionality of setGaugeText", function() + it("Should wrap the text in a font tag coloured black by default", function() + setGaugeText(gaugeName, "HP: 100%") + assert.equals([[HP: 100%]], gaugesTable[gaugeName].text) + assert.is_truthy(getLabelText(gaugeName .. "_text"):find("HP: 100%", 1, true)) + end) + + it("Should accept a colour name", function() + setGaugeText(gaugeName, "hurt", "red") + assert.equals([[hurt]], gaugesTable[gaugeName].text) + end) + + it("Should accept an r, g, b triple", function() + setGaugeText(gaugeName, "hurt", 0, 128, 255) + assert.equals([[hurt]], gaugesTable[gaugeName].text) + end) + + it("Should clear the caption when no text is given", function() + setGaugeText(gaugeName, "something") + setGaugeText(gaugeName) + assert.equals([[]], gaugesTable[gaugeName].text) + end) + + it("Should error for an unknown gauge", function() + assert.has_error(function() setGaugeText("noSuchGauge", "x") end) + end) + end) + + describe("Tests the functionality of setGaugeStyleSheet", function() + it("Should apply the stylesheet to the front label and default the others", function() + setGaugeStyleSheet(gaugeName, "background-color: blue;") + assert.equals("background-color: blue;", getLabelStyleSheet(gaugeName .. "_front")) + assert.equals("background-color: blue;", getLabelStyleSheet(gaugeName .. "_back")) + assert.equals("", getLabelStyleSheet(gaugeName .. "_text")) + end) + + it("Should use the separate back and text stylesheets when given", function() + setGaugeStyleSheet(gaugeName, "border: 1px;", "background-color: grey;", "color: white;") + assert.equals("border: 1px;", getLabelStyleSheet(gaugeName .. "_front")) + assert.equals("background-color: grey;", getLabelStyleSheet(gaugeName .. "_back")) + assert.equals("color: white;", getLabelStyleSheet(gaugeName .. "_text")) + end) + + it("Should error for an unknown gauge or a non string stylesheet", function() + assert.has_error(function() setGaugeStyleSheet("noSuchGauge", "a") end) + assert.has_error(function() setGaugeStyleSheet(gaugeName, 5) end) + end) + end) + + describe("Tests the functionality of the gauge tooltip and clickthrough helpers", function() + -- neither a label tooltip nor the clickthrough flag has a getter, so the + -- observable part is which of the gauge's three labels each helper + -- reaches; spy.on keeps the real function underneath + it("Should put the tooltip on the text label and clear it again", function() + local toolTip = spy.on(_G, "setLabelToolTip") + finally(function() toolTip:revert() end) + setGaugeToolTip(gaugeName, "some hint", 3) + assert.spy(toolTip).was.called_with(gaugeName .. "_text", "some hint", 3) + resetGaugeToolTip(gaugeName) + assert.spy(toolTip).was.called_with(gaugeName .. "_text", "") + end) + + it("Should enable and disable clickthrough on all three labels", function() + local enable = spy.on(_G, "enableClickthrough") + finally(function() enable:revert() end) + enableGaugeClickthrough(gaugeName) + assert.spy(enable).was.called(3) + for _, suffixName in ipairs({"_back", "_front", "_text"}) do + assert.spy(enable).was.called_with(gaugeName .. suffixName) + end + + local disable = spy.on(_G, "disableClickthrough") + finally(function() disable:revert() end) + disableGaugeClickthrough(gaugeName) + assert.spy(disable).was.called(3) + for _, suffixName in ipairs({"_back", "_front", "_text"}) do + assert.spy(disable).was.called_with(gaugeName .. suffixName) + end + end) + + it("Should error for an unknown gauge", function() + assert.has_error(function() setGaugeToolTip("noSuchGauge", "hint") end) + assert.has_error(function() resetGaugeToolTip("noSuchGauge") end) + assert.has_error(function() enableGaugeClickthrough("noSuchGauge") end) + assert.has_error(function() disableGaugeClickthrough("noSuchGauge") end) + end) + end) + + describe("Tests the functionality of setGaugeWindow", function() + local userWindow = "guiUtilsGaugeUserWindow" + + setup(function() + openUserWindow(userWindow) + end) + + teardown(function() + closeUserWindow(userWindow) + end) + + it("Should reparent every label of the gauge and record the new position", function() + -- getWindowGeometry is parent relative, so it cannot tell a reparent + -- from a plain move; setWindow is where the reparenting happens + local setWindowSpy = spy.on(_G, "setWindow") + finally(function() setWindowSpy:revert() end) + setGaugeWindow(userWindow, gaugeName, 7, 8) + assert.spy(setWindowSpy).was.called(3) + for _, suffixName in ipairs({"_back", "_front", "_text"}) do + assert.spy(setWindowSpy).was.called_with(userWindow, gaugeName .. suffixName, 7, 8, true) + end + assert.equals(7, gaugesTable[gaugeName].x) + assert.equals(8, gaugesTable[gaugeName].y) + assert.are.same({x = 7, y = 8, width = 300, height = 20}, geometry(gaugeName .. "_back")) + assert.are.same({x = 7, y = 8, width = 300, height = 20}, geometry(gaugeName .. "_front")) + end) + + it("Should error for an unknown gauge", function() + assert.has_error(function() setGaugeWindow(userWindow, "noSuchGauge") end) + end) + + it("Should keep the gauge hidden when show is passed as false", function() + -- BUG: setGaugeWindow does `show = show or true`, so an explicit false + -- is turned into true and the gauge is shown anyway + pending("setGaugeWindow cannot be told not to show the gauge - see the Wave 3d report") + setGaugeWindow(userWindow, gaugeName, 0, 0, false) + assert.is_false(windowVisible(gaugeName .. "_back")) + end) + end) + end) + + describe("Tests the functionality of createConsole", function() + local consoleName = "guiUtilsTestConsole" + + after_each(function() + deleteMiniConsole(consoleName) + end) + + it("Should create a miniconsole wrapped to the requested number of characters", function() + createConsole("main", consoleName, 8, 40, 10, 200, 400) + assert.equals("miniconsole", windowType(consoleName)) + assert.equals(40, getWindowWrap(consoleName)) + assert.equals(8, getFontSize(consoleName)) + end) + + it("Should size the console from the font metrics and place it where asked", function() + createConsole("main", consoleName, 8, 40, 10, 200, 400) + local charWidth, charHeight = calcFontSize(8) + local x, y, width, height = getWindowGeometry(consoleName) + assert.are.same({200, 400}, {x, y}) + assert.are.same({charWidth * 40, charHeight * 10}, {width, height}) + end) + + it("Should start out with a white foreground on a transparent background", function() + createConsole("main", consoleName, 8, 40, 10, 0, 0) + echo(consoleName, "default colours\n") + selectString(consoleName, "default colours", 1) + assert.are.same({255, 255, 255}, {getFgColor(consoleName)}) + end) + + it("Should default the window name to main when it is left out", function() + createConsole(consoleName, 8, 40, 10, 5, 6) + assert.equals("miniconsole", windowType(consoleName)) + local x, y = getWindowGeometry(consoleName) + assert.are.same({5, 6}, {x, y}) + end) + + it("Should error when a size argument is not a number", function() + assert.has_error(function() createConsole("main", consoleName, "8", 40, 10, 0, 0) end) + assert.has_error(function() createConsole("main", consoleName, 8, 40, 10, 0, "0") end) + end) + end) + + describe("Tests the functionality of bg and fg", function() + local windowName = "guiUtilsColourBuffer" + + teardown(function() + deleteMiniConsole(windowName) + end) + + before_each(function() + createBuffer(windowName) + clearWindow(windowName) + moveCursor(windowName, 0, 0) + resetFormat(windowName) + end) + + -- getBgColor/getFgColor report the colour of the character the selection + -- starts on, so the colour has to be laid down on real text to read it back + it("Should set the background colour of a named window from a colour name", function() + bg(windowName, "blue") + echo(windowName, "coloured\n") + selectString(windowName, "coloured", 1) + assert.are.same(color_table["blue"], {getBgColor(windowName)}) + end) + + it("Should set the foreground colour of a named window from a colour name", function() + fg(windowName, "red") + echo(windowName, "coloured\n") + selectString(windowName, "coloured", 1) + assert.are.same(color_table["red"], {getFgColor(windowName)}) + end) + + it("Should colour the main console when given only a colour name", function() + finally(function() resetFormat() end) + clearWindow() + bg("green") + fg("yellow") + echo("mainColouredSample\n") + selectString("mainColouredSample", 1) + assert.are.same(color_table["green"], {getBgColor("main")}) + assert.are.same(color_table["yellow"], {getFgColor("main")}) + end) + + it("Should error for a colour that does not exist", function() + assert.error_matches(function() bg("notAColour") end, "doesn't exist") + assert.error_matches(function() fg("notAColour") end, "doesn't exist") + end) + + it("Should error when given nothing at all", function() + assert.has_error(function() bg() end) + assert.has_error(function() fg() end) + end) + end) + + describe("Tests the functionality of gagLine", function() + it("Should delete the line the cursor is on", function() + -- gagLine is deprecated and forwards to deleteLine with no arguments, so + -- it always acts on the main console: prove the forwarding, then that a + -- gagged line really leaves the buffer + local deleteLineSpy = spy.on(_G, "deleteLine") + finally(function() deleteLineSpy:revert() end) + clearWindow() + echo("keep me\ngag me\n") + moveCursor(0, 1) + gagLine() + assert.spy(deleteLineSpy).was.called(1) + local text = table.concat(getLines("main", 0, getLastLineNumber("main") + 1), "\n") + assert.is_falsy(text:find("gag me", 1, true)) + assert.is_truthy(text:find("keep me", 1, true)) + end) + end) + + describe("Tests the functionality of replaceLine", function() + local windowName = "guiUtilsReplaceLineBuffer" + + teardown(function() + deleteMiniConsole(windowName) + end) + + before_each(function() + createBuffer(windowName) + clearWindow(windowName) + moveCursor(windowName, 0, 0) + end) + + it("Should replace the whole current line of a named window", function() + echo(windowName, "the original line\n") + moveCursor(windowName, 0, 0) + replaceLine(windowName, "a brand new line") + moveCursor(windowName, 0, 0) + selectCurrentLine(windowName) + assert.equals("a brand new line", getSelection(windowName)) + end) + + it("Should replace the current line of the main console when given only text", function() + clearWindow() + echo("the original main line\n") + moveCursor(0, 0) + replaceLine("a brand new main line") + moveCursor(0, 0) + selectCurrentLine() + assert.equals("a brand new main line", getSelection()) + end) + + it("Should error when the window name is not a string", function() + assert.has_error(function() replaceLine(5, "x") end) + end) + end) + + describe("Tests the functionality of handleWindowResizeEvent", function() + it("Should exist as a do nothing default users can override", function() + assert.equals("function", type(handleWindowResizeEvent)) + assert.are.same({}, {handleWindowResizeEvent()}) + end) + end) + + describe("Tests the functionality of replaceWildcard", function() + local fired + + before_each(function() + fired = nil + end) + + it("Should replace the text a capture group matched", function() + local id = tempRegexTrigger("^You wave (goodbye)\\.$", function() + replaceWildcard(2, "hello") + selectCurrentLine() + fired = getSelection() + end) + feedTriggers("You wave goodbye.\n") + killTrigger(id) + assert.equals("You wave hello.", fired) + end) + + it("Should do nothing when either argument is missing", function() + local id = tempRegexTrigger("^You nod (once)\\.$", function() + replaceWildcard(2) + replaceWildcard(nil, "hello") + selectCurrentLine() + fired = getSelection() + end) + feedTriggers("You nod once.\n") + killTrigger(id) + assert.equals("You nod once.", fired) + end) + end) + + describe("Tests the functionality of showColors", function() + -- showColors writes a clickable swatch per colour to the main console; the + -- text of those swatches is what can be read back + local function mainConsoleText() + return getLines("main", 0, getLastLineNumber("main") + 1) + end + + before_each(function() + clearWindow() + end) + + it("Should list only the colours matching the search string", function() + showColors(1, "cornflower") + local text = table.concat(mainConsoleText(), "\n") + assert.is_truthy(text:find("cornflower_blue", 1, true)) + assert.is_truthy(text:find("CornflowerBlue", 1, true)) + assert.is_falsy(text:find("firebrick", 1, true)) + end) + + it("Should never list the ansi_### colours", function() + showColors(1, "ansi_128") + local text = table.concat(mainConsoleText(), "\n") + assert.is_falsy(text:find("ansi_128", 1, true)) + end) + + it("Should honour the requested number of columns", function() + local function lineHolding(needle) + for index, line in ipairs(mainConsoleText()) do + if line:find(needle, 1, true) then + return index + end + end + end + + showColors(2, "cornflower") + local shared = lineHolding("cornflower_blue") + assert.is_truthy(shared, "showColors should have listed the matching colours") + assert.are.equal(shared, lineHolding("CornflowerBlue"), "two colours should share a line when asked for 2 columns") + + clearWindow() + showColors(1, "cornflower") + local first = lineHolding("cornflower_blue") + assert.is_truthy(first) + assert.are_not.equal(first, lineHolding("CornflowerBlue"), "one column per line means one colour per line") + end) + end) + + describe("Tests the functionality of showAnsiColors", function() + it("Should list the ansi_### colours and nothing else", function() + clearWindow() + showAnsiColors(1) + local text = table.concat(getLines("main", 0, getLastLineNumber("main") + 1), "\n") + assert.is_truthy(text:find("ansi_000", 1, true)) + assert.is_truthy(text:find("ansi_255", 1, true)) + assert.is_falsy(text:find("cornflower_blue", 1, true)) + end) + end) + + describe("Tests the functionality of hinsertText and dinsertText", function() + local windowName = "guiUtilsInsertConsole" + + setup(function() + createMiniConsole(windowName, 0, 0, 400, 200) + setWindowWrap(windowName, 60) + end) + + teardown(function() + deleteMiniConsole(windowName) + end) + + before_each(function() + clearWindow(windowName) + end) + + local function firstLine() + moveCursor(windowName, 0, 0) + selectCurrentLine(windowName) + return getSelection(windowName) + end + + it("Should insert hecho formatted text at the cursor", function() + echo(windowName, "AB\n") + moveCursor(windowName, 1, 0) + hinsertText(windowName, "#ff0000X") + assert.equals("AXB", firstLine()) + end) + + it("Should insert decho formatted text at the cursor", function() + echo(windowName, "AB\n") + moveCursor(windowName, 1, 0) + dinsertText(windowName, "<255,0,0>X") + assert.equals("AXB", firstLine()) + end) + + it("Should apply the colour it was given to the inserted text", function() + echo(windowName, "AB\n") + moveCursor(windowName, 1, 0) + dinsertText(windowName, "<0,255,0>X") + selectSection(windowName, 1, 1) + assert.are.same({0, 255, 0}, getTextFormat(windowName).foreground) + end) + end) + + describe("Tests the functionality of the coloured link and popup echoes", function() + local windowName = "guiUtilsLinkConsole" + + setup(function() + createMiniConsole(windowName, 0, 0, 400, 200) + setWindowWrap(windowName, 60) + end) + + teardown(function() + deleteMiniConsole(windowName) + end) + + before_each(function() + clearWindow(windowName) + moveCursor(windowName, 0, 0) + end) + + local function currentLine() + selectCurrentLine(windowName) + return getSelection(windowName) + end + + local function firstLine() + moveCursor(windowName, 0, 0) + selectCurrentLine(windowName) + return getSelection(windowName) + end + + -- there is no getter for a link's command or hint, so these cover the text + -- and colour each variant lays down plus the fact that the call succeeds + it("Should echo links with each of the three colour syntaxes", function() + cechoLink(windowName, "click me", "send('x')", "a hint", true) + assert.equals("click me", currentLine()) + selectSection(windowName, 0, 5) + assert.are.same(color_table["red"], getTextFormat(windowName).foreground) + + clearWindow(windowName) + dechoLink(windowName, "<0,255,0>green link", "send('x')", "a hint", true) + assert.equals("green link", currentLine()) + + clearWindow(windowName) + hechoLink(windowName, "#0000ffblue link", "send('x')", "a hint", true) + assert.equals("blue link", currentLine()) + end) + + it("Should insert links with each of the three colour syntaxes", function() + echo(windowName, "AB\n") + moveCursor(windowName, 1, 0) + cinsertLink(windowName, "C", "send('x')", "a hint", true) + assert.equals("ACB", firstLine()) + + clearWindow(windowName) + echo(windowName, "AB\n") + moveCursor(windowName, 1, 0) + dinsertLink(windowName, "<0,255,0>D", "send('x')", "a hint", true) + assert.equals("ADB", firstLine()) + + clearWindow(windowName) + echo(windowName, "AB\n") + moveCursor(windowName, 1, 0) + hinsertLink(windowName, "#0000ffE", "send('x')", "a hint", true) + assert.equals("AEB", firstLine()) + end) + + it("Should echo popups with each of the three colour syntaxes", function() + local commands = {"send('one')", "send('two')"} + local hints = {"first", "second"} + cechoPopup(windowName, "menu", commands, hints, true) + assert.equals("menu", currentLine()) + + clearWindow(windowName) + dechoPopup(windowName, "<0,255,0>dmenu", commands, hints, true) + assert.equals("dmenu", currentLine()) + + clearWindow(windowName) + hechoPopup(windowName, "#0000ffhmenu", commands, hints, true) + assert.equals("hmenu", currentLine()) + end) + + it("Should insert popups with each of the three colour syntaxes", function() + local commands = {"send('one')", "send('two')"} + local hints = {"first", "second"} + echo(windowName, "AB\n") + moveCursor(windowName, 1, 0) + cinsertPopup(windowName, "C", commands, hints, true) + assert.equals("ACB", firstLine()) + + clearWindow(windowName) + echo(windowName, "AB\n") + moveCursor(windowName, 1, 0) + dinsertPopup(windowName, "<0,255,0>D", commands, hints, true) + assert.equals("ADB", firstLine()) + + clearWindow(windowName) + echo(windowName, "AB\n") + moveCursor(windowName, 1, 0) + hinsertPopup(windowName, "#0000ffE", commands, hints, true) + assert.equals("AEB", firstLine()) + end) + end) + + describe("Tests the functionality of cfeedTriggers, dfeedTriggers and hfeedTriggers", function() + local seen + + before_each(function() + seen = {} + end) + + -- each variant has to strip its own colour syntax before feeding, so the + -- line the trigger sees must be the bare marker and must carry the colour + local function feedAndInspect(feeder, text, marker) + local result = {} + local id = tempTrigger(marker, function() + selectCurrentLine() + result.line = getSelection() + selectString(marker, 1) + result.foreground = getTextFormat().foreground + seen[#seen + 1] = marker + end) + feeder(text) + killTrigger(id) + return result + end + + it("Should feed cecho coloured text through the trigger engine", function() + local result = feedAndInspect(cfeedTriggers, "cfeedMarker", "cfeedMarker") + assert.equals(1, #seen) + assert.equals("cfeedMarker", result.line) + -- the text goes out as ANSI, so a cecho colour name arrives as its ANSI + -- equivalent: "red" is ANSI 1, not the brighter color_table["red"] + assert.are.same(color_table["ansi_001"], result.foreground) + end) + + it("Should feed decho coloured text through the trigger engine", function() + local result = feedAndInspect(dfeedTriggers, "<0,255,0>dfeedMarker", "dfeedMarker") + assert.equals(1, #seen) + assert.equals("dfeedMarker", result.line) + assert.are.same({0, 255, 0}, result.foreground) + end) + + it("Should feed hecho coloured text through the trigger engine", function() + local result = feedAndInspect(hfeedTriggers, "#0000ffhfeedMarker", "hfeedMarker") + assert.equals(1, #seen) + assert.equals("hfeedMarker", result.line) + assert.are.same({0, 0, 255}, result.foreground) + end) + + it("Should error when not given a string", function() + assert.has_error(function() cfeedTriggers(5) end) + assert.has_error(function() dfeedTriggers(5) end) + assert.has_error(function() hfeedTriggers(5) end) + end) + end) + + describe("Tests the functionality of prefix and suffix", function() + local windowName = "guiUtilsAffixBuffer" + + teardown(function() + deleteMiniConsole(windowName) + end) + + before_each(function() + createBuffer(windowName) + clearWindow(windowName) + moveCursor(windowName, 0, 0) + echo(windowName, "middle") + moveCursor(windowName, 0, 0) + end) + + local function currentLine() + selectCurrentLine(windowName) + return getSelection(windowName) + end + + it("Should put text at the start of the line", function() + prefix("[", nil, nil, nil, windowName) + assert.equals("[middle", currentLine()) + end) + + it("Should put text at the end of the line", function() + suffix("]", nil, nil, nil, windowName) + assert.equals("middle]", currentLine()) + end) + + it("Should colour what it adds", function() + prefix("[", nil, "red", nil, windowName) + assert.equals("[middle", currentLine()) + selectSection(windowName, 0, 1) + assert.are.same(color_table["red"], getTextFormat(windowName).foreground) + end) + + it("Should accept a colour aware echo function to add the text with", function() + prefix("[", cecho, nil, nil, windowName) + assert.equals("[middle", currentLine()) + selectSection(windowName, 0, 1) + assert.are.same(color_table["red"], getTextFormat(windowName).foreground) + end) + + it("Should error when the text is not a string", function() + assert.has_error(function() prefix(5) end) + assert.has_error(function() suffix(5) end) + end) + end) + + describe("Tests the functionality of moveCursorDown", function() + local windowName = "guiUtilsCursorBuffer" + + teardown(function() + deleteMiniConsole(windowName) + end) + + before_each(function() + createBuffer(windowName) + clearWindow(windowName) + echo(windowName, "one\ntwo\nthree\nfour\n") + moveCursor(windowName, 0, 0) + end) + + it("Should move the cursor down one line by default", function() + moveCursorDown(windowName) + assert.equals(1, getLineNumber(windowName)) + end) + + it("Should move the cursor down the number of lines given", function() + moveCursorDown(windowName, 2) + assert.equals(2, getLineNumber(windowName)) + end) + + it("Should stop at the last line of the buffer", function() + moveCursorDown(windowName, 500) + assert.equals(getLastLineNumber(windowName), getLineNumber(windowName)) + end) + + it("Should reset the column unless asked to keep it", function() + moveCursor(windowName, 2, 0) + moveCursorDown(windowName, 1) + assert.equals(0, getColumnNumber(windowName)) + moveCursor(windowName, 2, 0) + moveCursorDown(windowName, 1, true) + assert.equals(2, getColumnNumber(windowName)) + end) + + it("Should report an unknown window rather than raising", function() + local ok, err = moveCursorDown("guiUtilsNoSuchWindow", 1) + assert.is_nil(ok) + assert.equals("window does not exist", err) + end) + end) + + describe("Tests the functionality of creplace, dreplace and hreplace", function() + local windowName = "guiUtilsColourReplaceBuffer" + + teardown(function() + deleteMiniConsole(windowName) + end) + + before_each(function() + createBuffer(windowName) + clearWindow(windowName) + moveCursor(windowName, 0, 0) + echo(windowName, "hello world") + moveCursor(windowName, 0, 0) + end) + + local function currentLine() + selectCurrentLine(windowName) + return getSelection(windowName) + end + + it("Should replace the selection with cecho formatted text", function() + selectString(windowName, "world", 1) + creplace(windowName, "earth") + assert.equals("hello earth", currentLine()) + end) + + it("Should replace the selection with decho formatted text", function() + selectString(windowName, "world", 1) + dreplace(windowName, "<0,255,0>earth") + assert.equals("hello earth", currentLine()) + end) + + it("Should replace the selection with hecho formatted text", function() + selectString(windowName, "world", 1) + hreplace(windowName, "#0000ffearth") + assert.equals("hello earth", currentLine()) + end) + + it("Should colour what it puts down", function() + selectString(windowName, "world", 1) + dreplace(windowName, "<0,255,0>earth") + selectString(windowName, "earth", 1) + assert.are.same({0, 255, 0}, getTextFormat(windowName).foreground) + end) + + it("Should replace a whole line with dreplaceLine and hreplaceLine", function() + dreplaceLine(windowName, "<0,255,0>brand new") + assert.equals("brand new", currentLine()) + hreplaceLine(windowName, "#0000ffnewer still") + assert.equals("newer still", currentLine()) + end) + + it("Should error when the window name is not a string", function() + assert.has_error(function() creplace(5, "x") end) + assert.has_error(function() dreplace(5, "x") end) + assert.has_error(function() hreplace(5, "x") end) + assert.has_error(function() dreplaceLine(5, "x") end) + assert.has_error(function() hreplaceLine(5, "x") end) + end) + end) + + describe("Tests the functionality of scrollUp and scrollDown", function() + local windowName = "guiUtilsScrollConsole" + + -- The scroll position getScroll reports is copied out of the buffer while + -- the pane repaints, and the very first scroll of a console is deferred to + -- the next event loop turn so its split screen lower pane can appear. Both + -- need one turn of the event loop before the new position can be read. + local function pumpEventLoop() + tempTimer(0, function() raiseEvent("guiUtilsScrollPump") end) + waitForEvent("guiUtilsScrollPump", 2000) + end + + -- the repaint that publishes the new position is only posted, so poll for + -- it rather than trusting a single turn of the event loop + local function scrollSettlesAt(expected) + for _ = 1, 20 do + if getScroll(windowName) == expected then + return getScroll(windowName) + end + pumpEventLoop() + end + return getScroll(windowName) + end + + -- BUG: scrollTo does not move to the line it is given, it subtracts a + -- delta from the cursor the pane last copied out of the buffer while + -- painting, and the first scroll out of tail mode is deferred a turn and + -- padded by the lower pane's row count. So the first scrollTo of a console + -- lands short by a font-metric-dependent amount, and a second one issued + -- before the pane has repainted lands short again. Re-issue it until it + -- sticks: once the pane's copy has caught up the delta is exact. + local function parkAt(line) + for _ = 1, 10 do + scrollTo(windowName, line) + if scrollSettlesAt(line) == line then + return line + end + end + return getScroll(windowName) + end + + setup(function() + createMiniConsole(windowName, 0, 0, 200, 100) + enableScrolling(windowName) + end) + + teardown(function() + deleteMiniConsole(windowName) + end) + + before_each(function() + clearWindow(windowName) + for i = 1, 200 do + echo(windowName, "scroll line " .. i .. "\n") + end + assert.equals(150, parkAt(150), "the console should be parked mid buffer before each scroll test") + end) + + it("Should move the view up by the number of lines given", function() + scrollUp(windowName, 5) + assert.equals(145, scrollSettlesAt(145)) + end) + + it("Should move the view back down again", function() + scrollDown(windowName, 4) + assert.equals(154, scrollSettlesAt(154)) + end) + + it("Should never scroll above the first line", function() + scrollUp(windowName, 10000) + assert.equals(0, scrollSettlesAt(0)) + end) + + it("Should never scroll past the last line", function() + scrollDown(windowName, 10000) + local lastLine = getLastLineNumber(windowName) + assert.equals(lastLine, scrollSettlesAt(lastLine)) + end) + + it("Should default to a single line when no count is given", function() + scrollUp(windowName) + assert.equals(149, scrollSettlesAt(149)) + end) + + it("Should report an unknown window rather than raising", function() + -- BUG: the guard reads getLastLineNumber, which answers -1 rather than + -- nil for a window it does not know, so the documented nil + message + -- never happens and getScroll's nil blows up in the arithmetic below it + pending("scrollUp/scrollDown raise on an unknown window - see the Wave 3d report") + local ok, err = scrollUp("guiUtilsNoSuchWindow", 1) + assert.is_nil(ok) + assert.equals("window does not exist", err) + ok, err = scrollDown("guiUtilsNoSuchWindow", 1) + assert.is_nil(ok) + assert.equals("window does not exist", err) + end) + end) + + describe("Tests the functionality of setLabelCursor and resetLabelCursor", function() + local labelName = "guiUtilsCursorLabel" + + before_each(function() + createLabel(labelName, 0, 0, 50, 50, 1) + hideWindow(labelName) + end) + + after_each(function() + pcall(deleteLabel, labelName) + end) + + it("Should map a cursor name to the id the C++ layer wants", function() + -- the name to id mapping is the Lua half of this function; the C++ half + -- only accepts a number, so a name that is not in mudlet.cursor has to + -- reach it as nil and be refused + assert.is_true(setLabelCursor(labelName, "OpenHand")) + assert.is_true(setLabelCursor(labelName, mudlet.cursor.OpenHand)) + assert.is_nil(mudlet.cursor.definitelyNotACursor) + assert.has_error(function() setLabelCursor(labelName, "definitelyNotACursor") end) + end) + + it("Should reset the cursor by asking for shape -1", function() + setLabelCursor(labelName, "OpenHand") + assert.is_true(resetLabelCursor(labelName)) + end) + + it("Should report an unknown label", function() + local ok, err = setLabelCursor("guiUtilsNoSuchLabel", "OpenHand") + assert.is_nil(ok) + assert.is_string(err) + end) + + it("Should error when resetLabelCursor is not given a string", function() + assert.has_error(function() resetLabelCursor(5) end) + end) + end) + + describe("Tests the functionality of setBackgroundImage", function() + local consoleName = "guiUtilsBackgroundConsole" + -- a Qt resource that ships with every Mudlet, so no fixture file is needed + local imagePath = ":/icons/mudlet.png" + + before_each(function() + createMiniConsole(consoleName, 0, 0, 100, 100) + end) + + after_each(function() + deleteMiniConsole(consoleName) + end) + + it("Should accept each mode name a console supports", function() + for _, name in ipairs({"border", "center", "tile", "style"}) do + assert.is_true(setBackgroundImage(consoleName, imagePath, name), "mode " .. name .. " should be accepted") + end + end) + + it("Should accept the numeric mode the names map onto", function() + assert.is_true(setBackgroundImage(consoleName, imagePath, mudlet.BgImageMode.center)) + assert.equals(2, mudlet.BgImageMode.center) + end) + + it("Should map the cover mode name, which only the full window accepts", function() + assert.equals(5, mudlet.BgImageMode.cover) + assert.is_true(setBackgroundImage("main", imagePath, "cover", true)) + -- the same name on a console reaches the C++ check for mode 5 + local ok, err = setBackgroundImage(consoleName, imagePath, "cover") + assert.is_nil(ok) + assert.is_truthy(err:find("cover", 1, true)) + resetBackgroundImage("main") + end) + + it("Should pass an unknown mode name through so the C++ side rejects it", function() + assert.has_error(function() setBackgroundImage(consoleName, imagePath, "notAMode") end) + end) + end) +end) diff --git a/src/mudlet-lua/tests/GeyserButton_spec.lua b/src/mudlet-lua/tests/GeyserButton_spec.lua index 195442b97..c6eb993c0 100644 --- a/src/mudlet-lua/tests/GeyserButton_spec.lua +++ b/src/mudlet-lua/tests/GeyserButton_spec.lua @@ -355,5 +355,77 @@ describe("Tests functionality of Geyser.Button", function() assert.is_nil(getWindowGeometry("gbsDelete")) assert.is_nil(Geyser.windowList.gbsDelete) end) + + describe('Geyser.Button command, function and style setters', function() + local button + + before_each(function() + button = track(Geyser.Button:new({name = "gbsSetters", x = 0, y = 0, width = 60, height = 20, msg = "up", downMsg = "down"})) + button:enableTwoState() + end) + + it("setClickCommand and setDownCommand store the alias to expand per state", function() + button:setClickCommand("say up") + button:setDownCommand("say down") + assert.are.equal("say up", button.clickCommand) + assert.are.equal("say down", button.downCommand) + + local expand = spy.on(_G, "expandAlias") + finally(function() expand:revert() end) + button:press() + assert.spy(expand).was.called_with("say up") + button:press() + assert.spy(expand).was.called_with("say down") + end) + + it("setClickCommand and setDownCommand reject a non string", function() + assert.has_error(function() button:setClickCommand(5) end) + assert.has_error(function() button:setDownCommand(5) end) + end) + + it("setDownColor and setColor apply the colour used for each state", function() + -- a label's background colour has no getter, so watch what reaches + -- setBackgroundColor; spy.on leaves the real call in place + local backgroundColor = spy.on(_G, "setBackgroundColor") + finally(function() backgroundColor:revert() end) + + local function lastColour() + local calls = backgroundColor.calls + local vals = calls[#calls].vals + return {vals[1], vals[2], vals[3], vals[4]} + end + + button:setColor("green") + assert.are.equal("green", button.color) + assert.are.same({"gbsSetters", 0, 255, 0}, lastColour()) + + button:setDownColor("red") + assert.are.equal("red", button.downColor) + button:setState("down") + assert.are.same({"gbsSetters", 255, 0, 0}, lastColour()) + + button:setState("up") + assert.are.same({"gbsSetters", 0, 255, 0}, lastColour()) + end) + + it("setStyle and setDownStyle put the right sheet on the widget per state", function() + button:setStyle("background-color: green;") + button:setDownStyle("background-color: red;") + assert.are.equal("background-color: green;", button.style) + assert.are.equal("background-color: red;", button.downStyle) + + button:setState("up") + assert.are.equal("background-color: green;", getLabelStyleSheet("gbsSetters")) + button:setState("down") + assert.are.equal("background-color: red;", getLabelStyleSheet("gbsSetters")) + end) + + it("setStyle accepts a Geyser.StyleSheet object", function() + local sheet = Geyser.StyleSheet:new("background-color: blue;") + button:setStyle(sheet) + button:setState("up") + assert.are.equal(sheet:getCSS(), getLabelStyleSheet("gbsSetters")) + end) + end) end) end) diff --git a/src/mudlet-lua/tests/GeyserGauge_spec.lua b/src/mudlet-lua/tests/GeyserGauge_spec.lua index b9deb6991..c1a54a2c7 100644 --- a/src/mudlet-lua/tests/GeyserGauge_spec.lua +++ b/src/mudlet-lua/tests/GeyserGauge_spec.lua @@ -347,4 +347,34 @@ describe("Tests functionality of Geyser.Gauge", function() assert.is_nil(Geyser.windowList.ggsDelete) end) end) + + describe("Geyser.Gauge clickthrough and tooltip", function() + it("enableClickthrough and disableClickthrough reach all three labels", function() + local gauge = track(Geyser.Gauge:new({name = "ggsClick", x = 0, y = 0, width = 100, height = 20})) + -- there is no getter for the clickthrough flag, so the delegation to the + -- three labels is what can be checked + local enable = spy.on(_G, "enableClickthrough") + finally(function() enable:revert() end) + gauge:enableClickthrough() + assert.spy(enable).was.called(3) + assert.spy(enable).was.called_with("ggsClick_front") + assert.spy(enable).was.called_with("ggsClick_back") + assert.spy(enable).was.called_with("ggsClick_text") + + local disable = spy.on(_G, "disableClickthrough") + finally(function() disable:revert() end) + gauge:disableClickthrough() + assert.spy(disable).was.called(3) + assert.spy(disable).was.called_with("ggsClick_text") + end) + + it("setToolTip and resetToolTip go to the text label and are remembered", function() + local gauge = track(Geyser.Gauge:new({name = "ggsToolTip", x = 0, y = 0, width = 100, height = 20})) + gauge:setToolTip("how much is left", 5) + assert.are.equal("how much is left", gauge.text.toolTip) + assert.are.equal(5, gauge.text.toolTipDuration) + gauge:resetToolTip() + assert.is_nil(gauge.text.toolTip) + end) + end) end) diff --git a/src/mudlet-lua/tests/GeyserLabel_spec.lua b/src/mudlet-lua/tests/GeyserLabel_spec.lua index d2de28fa8..2b81484e6 100644 --- a/src/mudlet-lua/tests/GeyserLabel_spec.lua +++ b/src/mudlet-lua/tests/GeyserLabel_spec.lua @@ -459,4 +459,65 @@ describe("Tests functionality of Geyser.Label widget state", function() assert.are.same({}, label.nestedLabels) end) end) + + describe("Geyser.Label clickthrough and cursor", function() + it("enableClickthrough and disableClickthrough track the flag on the object", function() + local label = track(Geyser.Label:new({name = "glsClick", x = 0, y = 0, width = 40, height = 20})) + label:enableClickthrough() + assert.is_true(label.clickthrough) + label:disableClickthrough() + assert.is_false(label.clickthrough) + end) + + it("setCursor stores the shape as a name whichever form it was given", function() + local label = track(Geyser.Label:new({name = "glsCursor", x = 0, y = 0, width = 40, height = 20})) + label:setCursor("OpenHand") + assert.are.equal("OpenHand", label.cursorShape) + label:setCursor(mudlet.cursor.ClosedHand) + assert.are.equal("ClosedHand", label.cursorShape) + end) + + it("resetCursor puts the shape back to the default", function() + local label = track(Geyser.Label:new({name = "glsResetCursor", x = 0, y = 0, width = 40, height = 20})) + label:setCursor("OpenHand") + label:setCustomCursor(":/icons/mudlet.png") + label:resetCursor() + assert.are.equal(0, label.cursorShape) + assert.are.equal("", label.customCursor) + end) + + it("setCustomCursor passes the image and hotspot on and remembers it", function() + -- there is no getter for a label cursor, so spy on the global to see + -- the hotspot defaults the wrapper fills in; spy.on keeps the real call + local customCursor = spy.on(_G, "setLabelCustomCursor") + finally(function() customCursor:revert() end) + local label = track(Geyser.Label:new({name = "glsCustomCursor", x = 0, y = 0, width = 40, height = 20})) + label:setCustomCursor(":/icons/mudlet.png", 1, 2) + assert.spy(customCursor).was.called_with("glsCustomCursor", ":/icons/mudlet.png", 1, 2) + assert.are.equal(":/icons/mudlet.png", label.customCursor) + label:setCustomCursor(":/icons/mudlet.png") + assert.spy(customCursor).was.called_with("glsCustomCursor", ":/icons/mudlet.png", -1, -1) + end) + end) + + describe("Geyser.Label:setBackgroundImage", function() + it("puts the image on the label without touching its stylesheet", function() + -- there is no getter for a label's background image, so spy on the + -- global; the stylesheet assertion is what separates this from the + -- tiled variant below, which works through the stylesheet instead + local background = spy.on(_G, "setBackgroundImage") + finally(function() background:revert() end) + local label = track(Geyser.Label:new({name = "glsBackground", x = 0, y = 0, width = 40, height = 20})) + label:setStyleSheet("border: 1px solid red;") + label:setBackgroundImage(":/icons/mudlet.png") + assert.spy(background).was.called_with("glsBackground", ":/icons/mudlet.png") + assert.are.equal("border: 1px solid red;", getLabelStyleSheet("glsBackground")) + end) + + it("setTiledBackgroundImage goes through the stylesheet instead", function() + local label = track(Geyser.Label:new({name = "glsTiled", x = 0, y = 0, width = 40, height = 20})) + label:setTiledBackgroundImage("/tmp/whatever.png") + assert.are.equal("background-image: url(/tmp/whatever.png);", getLabelStyleSheet("glsTiled")) + end) + end) end) diff --git a/src/mudlet-lua/tests/GeyserMiniConsole_spec.lua b/src/mudlet-lua/tests/GeyserMiniConsole_spec.lua index 1857b4620..4d4ad80a4 100644 --- a/src/mudlet-lua/tests/GeyserMiniConsole_spec.lua +++ b/src/mudlet-lua/tests/GeyserMiniConsole_spec.lua @@ -187,4 +187,293 @@ describe("Tests functionality of Geyser.MiniConsole", function() assert.is_nil(Geyser.windowList.gmcDelete) end) end) + + describe("Geyser.MiniConsole command line", function() + local console + + before_each(function() + console = track(Geyser.MiniConsole:new({name = "gmcCmd", x = 0, y = 0, width = 300, height = 100})) + console:enableCommandLine() + end) + + it("enableCommandLine creates a command line the console can read back", function() + assert.are.equal("", console:getCmdLine()) + end) + + it("printCmd replaces the command line contents", function() + console:printCmd("first") + assert.are.equal("first", console:getCmdLine()) + console:printCmd("second") + assert.are.equal("second", console:getCmdLine()) + end) + + it("appendCmd adds to what is already there", function() + console:printCmd("hello") + console:appendCmd(" world") + assert.are.equal("hello world", console:getCmdLine()) + end) + + it("clearCmd empties the command line", function() + console:printCmd("something") + console:clearCmd() + assert.are.equal("", console:getCmdLine()) + end) + + it("selectCmdLinetext reports success after selecting the typed text", function() + -- BUG: the C++ selectCmdLineText declares one return value but pushes + -- nothing, so Lua hands back whatever was left on the stack - here the + -- window name that was passed in + pending("selectCmdLineText returns a stack leftover, not a result - see the Wave 3d report") + console:printCmd("select me") + assert.is_true(console:selectCmdLinetext()) + end) + + it("selectCmdLinetext accepts the console's own command line", function() + console:printCmd("select me") + assert.has_no.errors(function() console:selectCmdLinetext() end) + -- selecting must not disturb what is typed + assert.are.equal("select me", console:getCmdLine()) + end) + + it("setCmdLineStyleSheet applies the sheet and remembers it", function() + -- the command line has no stylesheet getter, so spy on the global to + -- see what actually reached it; spy.on keeps the real function + local styleSheet = spy.on(_G, "setCmdLineStyleSheet") + finally(function() styleSheet:revert() end) + console:setCmdLineStyleSheet("color: red;") + assert.spy(styleSheet).was.called_with("gmcCmd", "color: red;") + assert.are.equal("color: red;", console.cmdLineStylesheet) + -- called with no argument it re-applies the remembered sheet + console:setCmdLineStyleSheet() + assert.spy(styleSheet).was.called(2) + assert.spy(styleSheet).was.called_with("gmcCmd", "color: red;") + end) + + it("disableCommandLine hides the command line without discarding what is typed", function() + local disable = spy.on(_G, "disableCommandLine") + finally(function() disable:revert() end) + console:printCmd("still here") + console:disableCommandLine() + assert.spy(disable).was.called_with("gmcCmd") + -- disabling only hides the widget, so the text is still readable and + -- comes back when the command line is enabled again + assert.are.equal("still here", console:getCmdLine()) + console:enableCommandLine() + assert.are.equal("still here", console:getCmdLine()) + end) + end) + + describe("Geyser.MiniConsole:setBufferSize", function() + it("caps how many lines the console keeps", function() + local console = track(Geyser.MiniConsole:new({name = "gmcBuffer", x = 0, y = 0, width = 300, height = 100})) + console:setBufferSize(100, 20) + for i = 1, 600 do + console:echo("buffered line " .. i .. "\n") + end + -- trimming happens in batches once the limit is passed, so the line + -- count settles between the limit and limit + batch rather than at 600 + local kept = getLineCount("gmcBuffer") + assert.is_true(kept < 600, "a capped console must not keep every line, kept " .. kept) + assert.is_true(kept <= 121, "a capped console should settle near its limit, kept " .. kept) + end) + end) + + describe("Geyser.MiniConsole replace family", function() + local console + + local function firstLine() + console:moveCursor(0, 0) + console:selectCurrentLine() + return console:getCurrentLine() + end + + before_each(function() + console = track(Geyser.MiniConsole:new({name = "gmcReplace", x = 0, y = 0, width = 400, height = 200})) + console:setWrap(60) + console:echo("hello world\n") + console:moveCursor(0, 0) + end) + + it("replace swaps the current selection", function() + console:selectString("world", 1) + console:replace("earth") + assert.are.equal("hello earth", firstLine()) + end) + + it("replaceLine swaps the whole line", function() + console:replaceLine("a new line") + assert.are.equal("a new line", firstLine()) + end) + + it("dreplaceLine and hreplaceLine swap the line with colour", function() + console:dreplaceLine("<0,255,0>green line") + assert.are.equal("green line", firstLine()) + console:hreplaceLine("#0000ffblue line") + assert.are.equal("blue line", firstLine()) + end) + + it("fg and bg colour what is echoed next", function() + console:clear() + console:fg("red") + console:bg("blue") + console:echo("coloured\n") + console:selectString("coloured", 1) + assert.are.same(color_table["red"], {getFgColor("gmcReplace")}) + assert.are.same(color_table["blue"], {getBgColor("gmcReplace")}) + end) + + it("display renders a table into the console", function() + console:clear() + console:display({alpha = 1}) + local text = table.concat(getLines("gmcReplace", 0, getLineCount("gmcReplace")), "\n") + assert.is_truthy(text:find("alpha", 1, true)) + end) + + it("appendBuffer copies the main console selection in", function() + clearWindow() + echo("copy this line\n") + moveCursorEnd() + moveCursorUp() + selectCurrentLine() + copy() + console:clear() + console:appendBuffer() + assert.is_truthy(table.concat(getLines("gmcReplace", 0, getLineCount("gmcReplace") + 1), "\n"):find("copy this line", 1, true)) + end) + end) + + describe("Geyser.MiniConsole cursor movement", function() + local console + + before_each(function() + console = track(Geyser.MiniConsole:new({name = "gmcCursor", x = 0, y = 0, width = 400, height = 200})) + console:echo("one\ntwo\nthree\nfour\n") + console:moveCursor(0, 0) + end) + + it("moveCursorDown walks down the buffer and stops at the end", function() + console:moveCursorDown(2) + assert.are.equal(2, getLineNumber("gmcCursor")) + console:moveCursorDown(500) + assert.are.equal(getLastLineNumber("gmcCursor"), getLineNumber("gmcCursor")) + end) + + it("moveCursorUp walks back up and stops at the top", function() + console:moveCursorEnd() + console:moveCursorUp(1) + local afterOne = getLineNumber("gmcCursor") + console:moveCursorUp(500) + assert.are.equal(0, getLineNumber("gmcCursor")) + assert.is_true(afterOne > 0) + end) + end) + + describe("Geyser.MiniConsole link and popup echoes", function() + local console + + local function currentLine() + console:selectCurrentLine() + return console:getCurrentLine() + end + + before_each(function() + console = track(Geyser.MiniConsole:new({name = "gmcLinks", x = 0, y = 0, width = 400, height = 200})) + console:setWrap(60) + end) + + -- there is no getter for a link's command or hint, so the text each + -- variant lays down is the observable part + it("echoes plain, colour, decimal and hex links", function() + console:echoLink("plain link", "send('x')", "hint", true) + assert.are.equal("plain link", currentLine()) + + console:clear() + console:cechoLink("colour link", "send('x')", "hint", true) + assert.are.equal("colour link", currentLine()) + + console:clear() + console:dechoLink("<0,255,0>decimal link", "send('x')", "hint", true) + assert.are.equal("decimal link", currentLine()) + + console:clear() + console:hechoLink("#0000ffhex link", "send('x')", "hint", true) + assert.are.equal("hex link", currentLine()) + end) + + it("inserts colour, decimal and hex links at the cursor", function() + console:echo("AB\n") + console:moveCursor(1, 0) + console:cinsertLink("C", "send('x')", "hint", true) + console:moveCursor(0, 0) + assert.are.equal("ACB", currentLine()) + + console:clear() + console:echo("AB\n") + console:moveCursor(1, 0) + console:dinsertLink("<0,255,0>D", "send('x')", "hint", true) + console:moveCursor(0, 0) + assert.are.equal("ADB", currentLine()) + + console:clear() + console:echo("AB\n") + console:moveCursor(1, 0) + console:hinsertLink("#0000ffE", "send('x')", "hint", true) + console:moveCursor(0, 0) + assert.are.equal("AEB", currentLine()) + end) + + it("echoes and inserts popups in every colour syntax", function() + local commands = {"send('one')", "send('two')"} + local hints = {"first", "second"} + + console:echoPopup("plain popup", commands, hints, true) + assert.are.equal("plain popup", currentLine()) + + console:clear() + console:cechoPopup("colour popup", commands, hints, true) + assert.are.equal("colour popup", currentLine()) + + console:clear() + console:dechoPopup("<0,255,0>decimal popup", commands, hints, true) + assert.are.equal("decimal popup", currentLine()) + + console:clear() + console:hechoPopup("#0000ffhex popup", commands, hints, true) + assert.are.equal("hex popup", currentLine()) + + console:clear() + console:echo("AB\n") + console:moveCursor(1, 0) + console:cinsertPopup("C", commands, hints, true) + console:moveCursor(0, 0) + assert.are.equal("ACB", currentLine()) + end) + + it("setLink turns the current selection into a link", function() + -- a link's command and hint have no getter, so the observable part is + -- that the call is routed at this console and leaves the text alone + local setLinkSpy = spy.on(_G, "setLink") + finally(function() setLinkSpy:revert() end) + console:echo("clickable\n") + console:moveCursor(0, 0) + console:selectString("clickable", 1) + console:setLink("send('x')", "hint") + assert.spy(setLinkSpy).was.called_with("gmcLinks", "send('x')", "hint") + console:moveCursor(0, 0) + assert.are.equal("clickable", currentLine()) + end) + end) + + describe("Geyser.MiniConsole background image", function() + -- a Qt resource that ships with every Mudlet, so no fixture file is needed + local imagePath = ":/icons/mudlet.png" + + it("remembers the image it was given and forgets it on reset", function() + local console = track(Geyser.MiniConsole:new({name = "gmcBackground", x = 0, y = 0, width = 200, height = 100})) + assert.is_true(console:setBackgroundImage(imagePath, 2)) + assert.are.equal(imagePath, console.imgPath) + assert.is_true(console:resetBackgroundImage()) + assert.is_nil(console.imgPath) + end) + end) end) diff --git a/src/mudlet-lua/tests/IDManager_spec.lua b/src/mudlet-lua/tests/IDManager_spec.lua index ad13989bd..e3cfef6aa 100644 --- a/src/mudlet-lua/tests/IDManager_spec.lua +++ b/src/mudlet-lua/tests/IDManager_spec.lua @@ -491,4 +491,240 @@ describe("Tests the functionality of IDMgr", function() assert.are.same({}, getNamedTriggers(user)) end) end) + + describe("Tests the functionality of stopAllNamedTriggers", function() + local user = "stop all trig user" + + after_each(function() + deleteAllNamedTriggers(user) + _G.StopAllTrigFire = nil + end) + + it("Should stop a substring named trigger while leaving it registered", function() + _G.StopAllTrigFire = 0 + registerNamedTrigger(user, "sub", "stop_all_sub", function() _G.StopAllTrigFire = _G.StopAllTrigFire + 1 end) + feedTriggers("\nstop_all_sub\n") + assert.is_true(_G.StopAllTrigFire >= 1, "the trigger should fire before being stopped") + + assert.is_true(stopAllNamedTriggers(user)) + -- killTrigger defers the deletion to the end of the next feed + feedTriggers("\nstop_all_sub\n") + local afterFlush = _G.StopAllTrigFire + feedTriggers("\nstop_all_sub\n") + assert.is_equal(afterFlush, _G.StopAllTrigFire, "a stopped named trigger must not keep firing") + -- stopped, not deleted + assert.are.same({"sub"}, getNamedTriggers(user)) + end) + + it("Should stop regex named triggers too", function() + -- BUG: stopAllNamedTriggers reaches IDMgr:stopAllTriggers, which only + -- walks the substring store; regex named triggers keep firing. Compare + -- deleteAllNamedTriggers, which clears both stores. + pending("stopAllNamedTriggers ignores regex named triggers - see the Wave 3d report") + _G.StopAllTrigFire = 0 + registerNamedRegexTrigger(user, "re", "^stop_all_re$", function() _G.StopAllTrigFire = _G.StopAllTrigFire + 1 end) + feedTriggers("\nstop_all_re\n") + assert.is_true(_G.StopAllTrigFire >= 1) + + stopAllNamedTriggers(user) + feedTriggers("\nstop_all_re\n") + local afterFlush = _G.StopAllTrigFire + feedTriggers("\nstop_all_re\n") + assert.is_equal(afterFlush, _G.StopAllTrigFire, "a stopped regex named trigger must not keep firing") + end) + + it("Should raise an error if the userName is missing or wrong type", function() + assert.has_error(function() stopAllNamedTriggers() end) + assert.has_error(function() stopAllNamedTriggers(5) end) + end) + end) + + describe("Tests the functionality of a private manager from getNewIDManager", function() + local mgr + + before_each(function() + mgr = getNewIDManager() + _G.PrivateMgrFire = nil + end) + + after_each(function() + mgr:deleteAllTimers() + mgr:deleteAllTriggers() + mgr:deleteAllEvents() + _G.PrivateMgrFire = nil + end) + + it("Should hand out managers with independent stores", function() + local other = getNewIDManager() + finally(function() other:deleteAllTimers() end) + mgr:registerTimer("shared name", 100, function() end) + assert.are.same({"shared name"}, mgr:getTimers()) + assert.are.same({}, other:getTimers()) + end) + + describe("Tests the functionality of IDMgr:registerTrigger and IDMgr:registerRegexTrigger", function() + it("Should register a substring trigger that fires", function() + _G.PrivateMgrFire = 0 + assert.is_true(mgr:registerTrigger("sub", "private_mgr_sub", function() _G.PrivateMgrFire = _G.PrivateMgrFire + 1 end)) + feedTriggers("\nprivate_mgr_sub\n") + assert.is_true(_G.PrivateMgrFire >= 1) + end) + + it("Should register a regex trigger that fires", function() + _G.PrivateMgrFire = 0 + assert.is_true(mgr:registerRegexTrigger("re", "^private_mgr_re$", function() _G.PrivateMgrFire = _G.PrivateMgrFire + 1 end)) + feedTriggers("\nprivate_mgr_re\n") + assert.is_true(_G.PrivateMgrFire >= 1) + end) + + it("Should keep substring and regex triggers in separate stores", function() + mgr:registerTrigger("same", "private_mgr_both_sub", function() end) + mgr:registerRegexTrigger("same", "^private_mgr_both_re$", function() end) + assert.is_not_nil(mgr.triggers["same"]) + assert.is_not_nil(mgr.regexTriggers["same"]) + end) + + it("Should report the upstream failure instead of raising", function() + local ok, err = mgr:registerTrigger("bad", {}, function() end) + assert.is_nil(ok) + assert.is_string(err) + assert.is_nil(mgr.triggers["bad"]) + end) + end) + + describe("Tests the functionality of IDMgr:getTriggers", function() + it("Should list substring and regex names once each, sorted", function() + mgr:registerTrigger("bravo", "private_mgr_list_a", function() end) + mgr:registerRegexTrigger("alpha", "^private_mgr_list_b$", function() end) + mgr:registerRegexTrigger("bravo", "^private_mgr_list_c$", function() end) + assert.are.same({"alpha", "bravo"}, mgr:getTriggers()) + end) + + it("Should return an empty list for a fresh manager", function() + assert.are.same({}, mgr:getTriggers()) + end) + end) + + describe("Tests the functionality of IDMgr:stopTrigger and IDMgr:resumeTrigger", function() + it("Should stop a substring trigger and resume it again", function() + _G.PrivateMgrFire = 0 + mgr:registerTrigger("sub", "private_mgr_stop", function() _G.PrivateMgrFire = _G.PrivateMgrFire + 1 end) + assert.is_true(mgr:stopTrigger("sub")) + assert.is_equal(-1, mgr.triggers["sub"].handlerID) + feedTriggers("\nprivate_mgr_stop\n") -- flush the deferred cleanup + local afterFlush = _G.PrivateMgrFire + feedTriggers("\nprivate_mgr_stop\n") + assert.is_equal(afterFlush, _G.PrivateMgrFire) + + assert.is_true(mgr:resumeTrigger("sub")) + local before = _G.PrivateMgrFire + feedTriggers("\nprivate_mgr_stop\n") + assert.is_true(_G.PrivateMgrFire > before, "a resumed trigger should fire again") + end) + + it("Should reach the regex store as well", function() + mgr:registerRegexTrigger("re", "^private_mgr_stop_re$", function() end) + assert.is_true(mgr:stopTrigger("re")) + assert.is_equal(-1, mgr.regexTriggers["re"].handlerID) + assert.is_true(mgr:resumeTrigger("re")) + assert.is_true(mgr.regexTriggers["re"].handlerID > 0) + end) + + it("Should return false for a name it does not know", function() + assert.is_false(mgr:stopTrigger("nope")) + assert.is_false(mgr:resumeTrigger("nope")) + end) + end) + + describe("Tests the functionality of IDMgr:deleteTrigger and IDMgr:deleteAllTriggers", function() + it("Should delete a substring trigger and forget its name", function() + mgr:registerTrigger("sub", "private_mgr_del", function() end) + assert.is_true(mgr:deleteTrigger("sub")) + assert.are.same({}, mgr:getTriggers()) + assert.is_nil(mgr.triggers["sub"]) + end) + + it("Should delete a regex trigger too", function() + mgr:registerRegexTrigger("re", "^private_mgr_del_re$", function() end) + assert.is_true(mgr:deleteTrigger("re")) + assert.are.same({}, mgr:getTriggers()) + end) + + it("Should return false for a name it does not know", function() + assert.is_false(mgr:deleteTrigger("nope")) + end) + + it("Should clear both stores at once", function() + mgr:registerTrigger("sub", "private_mgr_all_a", function() end) + mgr:registerRegexTrigger("re", "^private_mgr_all_b$", function() end) + assert.is_equal(2, #mgr:getTriggers()) + assert.is_true(mgr:deleteAllTriggers()) + assert.are.same({}, mgr:getTriggers()) + end) + end) + + describe("Tests the functionality of IDMgr:stopAllTimers and IDMgr:deleteAllTimers", function() + it("Should stop every timer while leaving them registered", function() + mgr:registerTimer("one", 100, function() end) + mgr:registerTimer("two", 100, function() end) + assert.is_true(mgr:stopAllTimers()) + assert.is_equal(-1, mgr.timers["one"].handlerID) + assert.is_equal(-1, mgr.timers["two"].handlerID) + assert.are.same({"one", "two"}, mgr:getTimers()) + end) + + it("Should delete every timer", function() + mgr:registerTimer("one", 100, function() end) + mgr:registerTimer("two", 100, function() end) + assert.is_true(mgr:deleteAllTimers()) + assert.are.same({}, mgr:getTimers()) + end) + end) + + describe("Tests the functionality of IDMgr:stopAllTriggers", function() + it("Should stop every substring trigger while leaving it registered", function() + mgr:registerTrigger("one", "private_mgr_stopall_a", function() end) + mgr:registerTrigger("two", "private_mgr_stopall_b", function() end) + assert.is_true(mgr:stopAllTriggers()) + assert.is_equal(-1, mgr.triggers["one"].handlerID) + assert.is_equal(-1, mgr.triggers["two"].handlerID) + assert.are.same({"one", "two"}, mgr:getTriggers()) + end) + + it("Should stop regex triggers as well", function() + -- BUG: stopAllTriggers only calls stopAll("triggers"), so entries in + -- the regexTriggers store keep their live handlerID and keep firing + pending("IDMgr:stopAllTriggers ignores the regex store - see the Wave 3d report") + mgr:registerRegexTrigger("re", "^private_mgr_stopall_re$", function() end) + mgr:stopAllTriggers() + assert.is_equal(-1, mgr.regexTriggers["re"].handlerID) + end) + end) + + describe("Tests the functionality of IDMgr:emergencyStop", function() + it("Should stop timers, events and substring triggers in one call", function() + mgr:registerTimer("timer", 100, function() end) + mgr:registerEvent("event", "someEventNameNobodyRaises", function() end) + mgr:registerTrigger("trigger", "private_mgr_emergency", function() end) + + assert.is_true(mgr:emergencyStop()) + + assert.is_equal(-1, mgr.timers["timer"].handlerID) + assert.is_equal(-1, mgr.events["event"].handlerID) + assert.is_equal(-1, mgr.triggers["trigger"].handlerID) + -- everything stays registered so it can be resumed + assert.are.same({"timer"}, mgr:getTimers()) + assert.are.same({"trigger"}, mgr:getTriggers()) + end) + + it("Should stop regex triggers too", function() + -- BUG: emergencyStop shares IDMgr:stopAllTriggers' blind spot and never + -- touches the regexTriggers store, so those triggers survive it + pending("IDMgr:emergencyStop leaves regex triggers running - see the Wave 3d report") + mgr:registerRegexTrigger("re", "^private_mgr_emergency_re$", function() end) + mgr:emergencyStop() + assert.is_equal(-1, mgr.regexTriggers["re"].handlerID) + end) + end) + end) end) diff --git a/src/mudlet-lua/tests/Mapper_spec.lua b/src/mudlet-lua/tests/Mapper_spec.lua index 28a8d59bd..572e8af8b 100644 --- a/src/mudlet-lua/tests/Mapper_spec.lua +++ b/src/mudlet-lua/tests/Mapper_spec.lua @@ -1395,6 +1395,59 @@ describe("Tests mapper functions against a shared fixture", function() end) end) + describe("Tests room name offset and visibility", function() + -- these three wrap the room.ui_nameOffset / room.ui_showName user data + -- keys the map renderer reads, so the round trip is the observable effect + after_each(function() + clearRoomUserDataItem(rSandA, "room.ui_nameOffset") + clearRoomUserDataItem(rSandA, "room.ui_showName") + end) + + it("getRoomNameOffset returns zeroes for a room that has never been offset", function() + assert.are.same({0, 0}, {getRoomNameOffset(rSandA)}) + end) + + it("setRoomNameOffset round-trips an x and y shift", function() + setRoomNameOffset(rSandA, 3, 4) + assert.are.same({3, 4}, {getRoomNameOffset(rSandA)}) + assert.are.equal("3 4", getRoomUserData(rSandA, "room.ui_nameOffset")) + end) + + it("setRoomNameOffset stores only the y shift when x is zero", function() + setRoomNameOffset(rSandA, 0, 5) + assert.are.equal("5", getRoomUserData(rSandA, "room.ui_nameOffset")) + assert.are.same({0, 5}, {getRoomNameOffset(rSandA)}) + end) + + it("getRoomNameOffset reads a legacy single value as the y shift", function() + setRoomUserData(rSandA, "room.ui_nameOffset", "7") + assert.are.same({0, 7}, {getRoomNameOffset(rSandA)}) + end) + + it("setRoomNameVisible writes the flag the renderer looks for", function() + setRoomNameVisible(rSandA, true) + assert.are.equal("1", getRoomUserData(rSandA, "room.ui_showName")) + setRoomNameVisible(rSandA, false) + assert.are.equal("0", getRoomUserData(rSandA, "room.ui_showName")) + end) + + it("all three reject arguments of the wrong type", function() + assert.has_error(function() getRoomNameOffset("1") end) + assert.has_error(function() setRoomNameOffset(rSandA, "1", 1) end) + assert.has_error(function() setRoomNameOffset(rSandA, 1, "1") end) + assert.has_error(function() setRoomNameVisible(rSandA, "yes") end) + end) + + it("getRoomNameOffset keeps the sign of a negative shift", function() + -- BUG: setRoomNameOffset stores the offset as "x y", but + -- getRoomNameOffset reads it back with the pattern '[%.%d]+', which + -- cannot match a minus sign, so every negative shift comes back positive + pending("getRoomNameOffset drops the sign of a stored offset - see the Wave 3d report") + setRoomNameOffset(rSandA, -3, -4) + assert.are.same({-3, -4}, {getRoomNameOffset(rSandA)}) + end) + end) + describe("Tests area user data", function() it("setAreaUserData is read back by getAreaUserData", function() assert.is_true(setAreaUserData(areaAlpha, "climate", "temperate")) diff --git a/src/mudlet-lua/tests/Other_spec.lua b/src/mudlet-lua/tests/Other_spec.lua index d9e416cd4..5faa50256 100644 --- a/src/mudlet-lua/tests/Other_spec.lua +++ b/src/mudlet-lua/tests/Other_spec.lua @@ -1800,4 +1800,155 @@ describe("Tests the script API", function() assert.equals(0, isActive("W2aScriptSwitched", "script")) end) end) + + describe("Tests the functionality of speedwalktimer", function() + -- resume first so a paused walk is re-armed and stopSpeedwalk can then + -- clear its walklist; both are shared upvalues of Other.lua + after_each(function() + pcall(resumeSpeedwalk) + pcall(stopSpeedwalk) + end) + + it("Should send the head of the walklist and shorten it", function() + local list = {"n", "e"} + local send = spy.on(_G, "send") + finally(function() send:revert() end) + speedwalktimer(list, 100, false) + assert.spy(send).was.called(1) + assert.spy(send).was.called_with("n", false) + assert.are.same({"e"}, list) + end) + + it("Should arm a timer for the rest of the walklist", function() + local list = {"n", "e"} + local send = spy.on(_G, "send") + finally(function() send:revert() end) + speedwalktimer(list, 100, false) + -- pauseSpeedwalk only succeeds while a step timer is armed + assert.is_true(pauseSpeedwalk()) + end) + + it("Should raise sysSpeedwalkFinished on the last step", function() + local finished = false + local handler = registerAnonymousEventHandler("sysSpeedwalkFinished", function() finished = true end) + finally(function() killAnonymousEventHandler(handler) end) + local send = spy.on(_G, "send") + finally(function() send:revert() end) + -- clear any step timer an earlier test armed so the pause check below + -- can only be answering for this walklist + pcall(pauseSpeedwalk) + local list = {"n"} + speedwalktimer(list, 100, false) + assert.spy(send).was.called_with("n", false) + assert.are.same({}, list) + assert.is_true(finished) + -- nothing was queued, so there is no timer left to pause + assert.is_nil((pauseSpeedwalk())) + end) + end) + + describe("Tests the functionality of deleteFull", function() + after_each(function() + -- deleteFull leaves a one line trigger behind; flush it so it cannot + -- gag a line belonging to a later spec + feedTriggers("deleteFullFlush\n") + end) + + it("Should delete the line it runs on", function() + local id = tempTrigger("deleteFullMarker", function() deleteFull() end) + feedTriggers("deleteFullMarker line\n") + killTrigger(id) + moveCursorEnd() + moveCursorUp() + assert.are_not.equal("deleteFullMarker line", getCurrentLine()) + end) + + it("Should arm a one line trigger that gags a following prompt", function() + local lineTrigger = spy.on(_G, "tempLineTrigger") + finally(function() lineTrigger:revert() end) + local id = tempTrigger("deleteFullArmMarker", function() deleteFull() end) + feedTriggers("deleteFullArmMarker line\n") + killTrigger(id) + assert.spy(lineTrigger).was.called(1) + assert.spy(lineTrigger).was.called_with(1, 1, [[if isPrompt() then deleteLine() end]]) + end) + end) + + describe("Tests the functionality of condenseMapLoad", function() + before_each(function() + clearWindow() + moveCursorEnd() + end) + + it("Should delete the map loading block and return the time it took", function() + echo("[ INFO ] - Reading map. Please wait...\n") + echo("[ INFO ] - Map read in 1.5s.\n") + echo("[ INFO ] - Map deserialised in 0.25s.\n") + local loadTime = condenseMapLoad() + assert.are.equal(1.75, loadTime) + local text = table.concat(getLines("main", 0, getLastLineNumber("main") + 1), "\n") + assert.is_falsy(text:find("Reading map", 1, true)) + assert.is_falsy(text:find("deserialised", 1, true)) + end) + + it("Should refuse to condense when the user must see an alert", function() + echo("[ INFO ] - Reading map. Please wait...\n") + echo("[ ALERT ] - something the user has to read\n") + local loadTime, err = condenseMapLoad() + assert.is_nil(loadTime) + assert.are.equal("an alert, warning, or error that the user must see is present", err) + local text = table.concat(getLines("main", 0, getLastLineNumber("main") + 1), "\n") + assert.is_truthy(text:find("something the user has to read", 1, true)) + end) + + it("Should report when there is no map load output to condense", function() + echo("nothing to do with maps at all\n") + local loadTime, err = condenseMapLoad() + assert.is_nil(loadTime) + assert.are.equal("couldn't find the starting line for map load output", err) + end) + end) + + describe("Tests the functionality of loadTranslations", function() + it("Should return the strings of the package it is asked for", function() + local translations = loadTranslations("AdjustableContainer") + assert.is_table(translations) + assert.is_table(translations.attach) + assert.is_string(translations.attach.message) + assert.is_truthy(translations.top and translations.bottom and translations.left and translations.right) + end) + + it("Should strip the package prefix off every key", function() + local translations = loadTranslations("AdjustableContainer") + for key in pairs(translations) do + assert.is_falsy(key:find("AdjustableContainer.", 1, true)) + end + end) + + it("Should report a package the translation file has no strings for", function() + local translations, err = loadTranslations("NoSuchPackageInTheTranslationFile") + assert.is_nil(translations) + assert.are.equal("couldn't find translations for 'NoSuchPackageInTheTranslationFile'", err) + end) + + it("Should report a translation file it cannot find", function() + local translations, err = loadTranslations("AdjustableContainer", "noSuchTranslationFile") + assert.is_nil(translations) + assert.is_truthy(err:find("unable to find 'noSuchTranslationFile.json'", 1, true)) + end) + + it("Should reject arguments of the wrong type", function() + assert.has_error(function() loadTranslations(5) end) + assert.has_error(function() loadTranslations("AdjustableContainer", 5) end) + assert.has_error(function() loadTranslations("AdjustableContainer", "mudlet-lua", 5) end) + end) + end) + + describe("Tests the functionality of onConnect", function() + -- defined in LuaGlobal.lua as an empty default users may override + it("Should exist and do nothing", function() + assert.are.equal("function", type(onConnect)) + assert.are.same({}, {onConnect()}) + end) + end) end) diff --git a/src/mudlet-lua/tests/TableUtils_spec.lua b/src/mudlet-lua/tests/TableUtils_spec.lua index 2118d8e1b..14cd9aac0 100644 --- a/src/mudlet-lua/tests/TableUtils_spec.lua +++ b/src/mudlet-lua/tests/TableUtils_spec.lua @@ -965,4 +965,33 @@ describe("Tests TableUtils.lua functions", function() assert.spy(echo).was.called_with("2. ) second\n") end) end) + + describe("Tests the contract of __printTable", function() + -- __printTable is documented as printTable's helper but printTable never + -- calls it; it is a standalone one pair formatter reachable from scripts, + -- writing into the main console at the cursor + it("should insert a newline terminated key and value pair", function() + local insertText = spy.on(_G, "insertText") + finally(function() insertText:revert() end) + __printTable("alpha", "one") + assert.spy(insertText).was.called(1) + assert.spy(insertText).was.called_with("\nkey = alpha value = one") + end) + + it("should tostring both the key and the value", function() + local insertText = spy.on(_G, "insertText") + finally(function() insertText:revert() end) + __printTable(3, true) + assert.spy(insertText).was.called_with("\nkey = 3 value = true") + end) + + it("should land the pair in the main console buffer", function() + clearWindow() + echo("a line for the cursor to sit on\n") + moveCursorEnd() + __printTable("visible", "value") + local text = table.concat(getLines("main", 0, getLastLineNumber("main") + 1), "\n") + assert.is_truthy(text:find("key = visible value = value", 1, true)) + end) + end) end) From 936e91d65cf229339def6d716fc543b990345465 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Tue, 4 Aug 2026 21:53:50 +0200 Subject: [PATCH 080/155] infrastructure: Discord effect specs against a fake Discord IPC server (#9631) #### Brief overview of PR changes/additions - `CI/discord-ipc-fixture.py`: a fake Discord IPC server that completes the genuine discord-rpc handshake, reports a logged-in user, and appends every frame Mudlet's copy of libdiscord-rpc sends to a JSON-lines capture file. It is the Python counterpart of `DiscordIpcServerStub` (#9475). - Both ubuntu workflows start the fixture before the Lua tests and put the bundled discord-rpc library on the load path, so ~20 Lua functions CI could never reach are exercised there for the first time. macOS is left alone: its test leg runs the unpackaged bundle, which has no `libdiscord-rpc.dylib` in it (only the installer copies one in), so the specs pend there as they do on Windows. #### Motivation for adding to Mudlet Discord rich presence was the largest block of Lua functions with no effect coverage at all - CI could not even load the library, so every one of them was only ever checked for the message it returns when denied. With a fake Discord client on the other end of the socket, the payloads themselves become assertable. #### Other info (issues closed, discussion etc) Two defects turned up while writing these and are left as `pending` specs rather than frozen in, each with a follow-up: the six Discord getters hand the stored text to `lua_pushfstring()` as its format string (`getDiscordDetail()` on `"Level %d Mage"` returns a garbage number, and a `%s` would dereference a pointer that was never passed - the text can come from the server over GMCP, so it is remotely reachable), fixed in the stacked #9660; and `localDiscordPresence` truncates at 127 bytes with no regard for UTF-8, putting an invalid frame on the wire, filed as #9634. Loading the library in CI makes Networking_spec.lua's 22 Discord availability-contract rows pend by their own design ("on a machine where Discord is live these pend"); that denial path stays covered by `TDiscordModeTest`. Moving those rows into `Discord_spec.lua`, where the fixture can arrange both states, is a deliberate follow-up and not done here. The Linux Lua step's `timeout-minutes` goes 1 -> 3 because these specs wait out real discord-rpc reconnects. **Test case:** full suite green twice with the fixture (1848 passed / 0 failed / 41 pending, 43 of those new) and once without it (1829 / 0 / 60, every Discord spec pending cleanly, no failures); leak detection clean under the CI leg's ASan settings; sabotaging six behaviours in `discord.cpp`/`TLuaInterpreterDiscord.cpp` failed 9 of the 41 active specs directly (22%), all reverted afterwards. Assisted-by: Claude:claude-opus-5 --- .github/workflows/build-mudlet-pr.yml | 55 +- .github/workflows/build-mudlet.yml | 55 +- CI/discord-ipc-fixture.py | 210 +++++++ src/mudlet-lua/tests/Discord_spec.lua | 767 ++++++++++++++++++++++++++ 4 files changed, 1085 insertions(+), 2 deletions(-) create mode 100644 CI/discord-ipc-fixture.py create mode 100644 src/mudlet-lua/tests/Discord_spec.lua diff --git a/.github/workflows/build-mudlet-pr.yml b/.github/workflows/build-mudlet-pr.yml index 7abd33c8b..93dc7a9d6 100644 --- a/.github/workflows/build-mudlet-pr.yml +++ b/.github/workflows/build-mudlet-pr.yml @@ -520,9 +520,40 @@ jobs: echo "MUDLET_TEST_HTTP_PORT=${port}" >> "${GITHUB_ENV}" echo "fixture HTTP server ready on 127.0.0.1:${port}" + - name: (Linux) Start fake Discord IPC server for Lua tests + if: matrix.run_tests == 'true' && runner.os == 'Linux' + shell: bash + run: | + # A short runtime directory of its own: the whole discord-ipc-0 socket + # path has to fit into sockaddr_un's 108 character sun_path, and + # runner.temp does not leave room for it. + runtime_dir="$(mktemp -d /tmp/mdxdg-XXXX)" + ready_file="${{runner.temp}}/mudlet-discord-fixture-ready" + rm -f "${ready_file}" + nohup python3 "${{github.workspace}}/CI/discord-ipc-fixture.py" \ + --runtime-dir "${runtime_dir}" \ + --capture-file "${{runner.temp}}/mudlet-discord-frames.jsonl" \ + --ready-file "${ready_file}" > "${{runner.temp}}/discord-ipc-fixture.log" 2>&1 & + for _ in $(seq 1 50); do + [ -s "${ready_file}" ] && break + sleep 0.1 + done + if [ ! -s "${ready_file}" ] || [ ! -S "${runtime_dir}/discord-ipc-0" ]; then + echo "fake Discord IPC server failed to start" >&2 + cat "${{runner.temp}}/discord-ipc-fixture.log" 2>/dev/null || true + exit 1 + fi + cat "${ready_file}" >> "${GITHUB_ENV}" + # Prepended rather than replacing: the Qt install action puts Qt's own + # libraries on this path. + echo "MUDLET_TEST_DISCORD_LIB_PATH=${{github.workspace}}/3rdparty/discord/rpc/lib${LD_LIBRARY_PATH:+:${LD_LIBRARY_PATH}}" >> "${GITHUB_ENV}" + echo "fake Discord IPC server ready in ${runtime_dir}" + - name: (Linux) Run Lua tests if: matrix.run_tests == 'true' && runner.os == 'Linux' - timeout-minutes: 1 + # Longer than the other platforms': this leg also drives the real + # discord-rpc library, whose reconnects happen in wall-clock time. + timeout-minutes: 3 run: xvfb-run --auto-servernum ${{github.workspace}}/src/mudlet --profile "Mudlet self-test" --mirror env: AUTORUN_BUSTED_TESTS: 'true' @@ -534,6 +565,19 @@ jobs: # environment quirk. macOS runners start no player at all, so the gate # stays off there. MUDLET_TEST_REQUIRE_MEDIA: 1 + # The fake Discord IPC server's socket lives in this runtime directory, + # and the bundled discord-rpc library is only reachable through this + # library path - without both the Discord specs have nothing to talk to. + MUDLET_TEST_REQUIRE_DISCORD: 1 + XDG_RUNTIME_DIR: ${{env.MUDLET_TEST_DISCORD_RUNTIME_DIR}} + LD_LIBRARY_PATH: ${{env.MUDLET_TEST_DISCORD_LIB_PATH}} + # The session bus socket lives in the runtime directory replaced above, + # so Qt's D-Bus platform theme can no longer find it and would fall back + # to spawning dbus-launch. Point it at nothing instead: libdbus leaks + # the buffer it reads the autolaunch reply into (1032 bytes, reported + # against this job by LeakSanitizer with no Mudlet frames in the stack), + # and no spec needs a session bus. + DBUS_SESSION_BUS_ADDRESS: 'disabled:' TESTS_DIRECTORY: ${{github.workspace}}/src/mudlet-lua/tests QUIT_MUDLET_AFTER_TESTS: 'true' ASAN_OPTIONS: ${{ matrix.enable_asan == 'true' && 'detect_leaks=1' || '' }} @@ -554,6 +598,15 @@ jobs: QUIT_MUDLET_AFTER_TESTS: 'true' ASAN_OPTIONS: detect_leaks=0 + - name: (Linux) Show the captured Discord frames on failure + if: failure() && matrix.run_tests == 'true' && runner.os == 'Linux' + shell: bash + run: | + echo "--- fake Discord IPC server log ---" + cat "${{runner.temp}}/discord-ipc-fixture.log" 2>/dev/null || true + echo "--- frames it captured ---" + cat "${{runner.temp}}/mudlet-discord-frames.jsonl" 2>/dev/null || true + - name: Passed Lua tests if: matrix.run_tests == 'true' run: | diff --git a/.github/workflows/build-mudlet.yml b/.github/workflows/build-mudlet.yml index 57ca2e868..4825bfcba 100644 --- a/.github/workflows/build-mudlet.yml +++ b/.github/workflows/build-mudlet.yml @@ -536,9 +536,40 @@ jobs: echo "MUDLET_TEST_HTTP_PORT=${port}" >> "${GITHUB_ENV}" echo "fixture HTTP server ready on 127.0.0.1:${port}" + - name: (Linux) Start fake Discord IPC server for Lua tests + if: matrix.run_tests == 'true' && runner.os == 'Linux' + shell: bash + run: | + # A short runtime directory of its own: the whole discord-ipc-0 socket + # path has to fit into sockaddr_un's 108 character sun_path, and + # runner.temp does not leave room for it. + runtime_dir="$(mktemp -d /tmp/mdxdg-XXXX)" + ready_file="${{runner.temp}}/mudlet-discord-fixture-ready" + rm -f "${ready_file}" + nohup python3 "${{github.workspace}}/CI/discord-ipc-fixture.py" \ + --runtime-dir "${runtime_dir}" \ + --capture-file "${{runner.temp}}/mudlet-discord-frames.jsonl" \ + --ready-file "${ready_file}" > "${{runner.temp}}/discord-ipc-fixture.log" 2>&1 & + for _ in $(seq 1 50); do + [ -s "${ready_file}" ] && break + sleep 0.1 + done + if [ ! -s "${ready_file}" ] || [ ! -S "${runtime_dir}/discord-ipc-0" ]; then + echo "fake Discord IPC server failed to start" >&2 + cat "${{runner.temp}}/discord-ipc-fixture.log" 2>/dev/null || true + exit 1 + fi + cat "${ready_file}" >> "${GITHUB_ENV}" + # Prepended rather than replacing: the Qt install action puts Qt's own + # libraries on this path. + echo "MUDLET_TEST_DISCORD_LIB_PATH=${{github.workspace}}/3rdparty/discord/rpc/lib${LD_LIBRARY_PATH:+:${LD_LIBRARY_PATH}}" >> "${GITHUB_ENV}" + echo "fake Discord IPC server ready in ${runtime_dir}" + - name: (Linux) Run Lua tests if: matrix.run_tests == 'true' && runner.os == 'Linux' - timeout-minutes: 1 + # Longer than the other platforms': this leg also drives the real + # discord-rpc library, whose reconnects happen in wall-clock time. + timeout-minutes: 3 run: xvfb-run --auto-servernum ${{github.workspace}}/src/mudlet --profile "Mudlet self-test" --mirror env: AUTORUN_BUSTED_TESTS: 'true' @@ -550,6 +581,19 @@ jobs: # environment quirk. macOS runners start no player at all, so the gate # stays off there. MUDLET_TEST_REQUIRE_MEDIA: 1 + # The fake Discord IPC server's socket lives in this runtime directory, + # and the bundled discord-rpc library is only reachable through this + # library path - without both the Discord specs have nothing to talk to. + MUDLET_TEST_REQUIRE_DISCORD: 1 + XDG_RUNTIME_DIR: ${{env.MUDLET_TEST_DISCORD_RUNTIME_DIR}} + LD_LIBRARY_PATH: ${{env.MUDLET_TEST_DISCORD_LIB_PATH}} + # The session bus socket lives in the runtime directory replaced above, + # so Qt's D-Bus platform theme can no longer find it and would fall back + # to spawning dbus-launch. Point it at nothing instead: libdbus leaks + # the buffer it reads the autolaunch reply into (1032 bytes, reported + # against this job by LeakSanitizer with no Mudlet frames in the stack), + # and no spec needs a session bus. + DBUS_SESSION_BUS_ADDRESS: 'disabled:' TESTS_DIRECTORY: ${{github.workspace}}/src/mudlet-lua/tests QUIT_MUDLET_AFTER_TESTS: 'true' ASAN_OPTIONS: ${{ matrix.enable_asan == 'true' && 'detect_leaks=1' || '' }} @@ -570,6 +614,15 @@ jobs: QUIT_MUDLET_AFTER_TESTS: 'true' ASAN_OPTIONS: detect_leaks=0 + - name: (Linux) Show the captured Discord frames on failure + if: failure() && matrix.run_tests == 'true' && runner.os == 'Linux' + shell: bash + run: | + echo "--- fake Discord IPC server log ---" + cat "${{runner.temp}}/discord-ipc-fixture.log" 2>/dev/null || true + echo "--- frames it captured ---" + cat "${{runner.temp}}/mudlet-discord-frames.jsonl" 2>/dev/null || true + - name: Passed Lua tests if: matrix.run_tests == 'true' run: | diff --git a/CI/discord-ipc-fixture.py b/CI/discord-ipc-fixture.py new file mode 100644 index 000000000..049977a02 --- /dev/null +++ b/CI/discord-ipc-fixture.py @@ -0,0 +1,210 @@ +#!/usr/bin/env python3 +"""Fake Discord IPC server for Mudlet's Lua self-tests. + +Speaks enough of the discord-rpc wire protocol that the bundled +libdiscord-rpc library believes a Discord client is running, reports a +logged-in user, and accepts rich presence updates. Every frame the library +sends is appended to a capture file so the Lua specs can assert on the +SET_ACTIVITY payload that actually reached "Discord", rather than on the +return value of the setter that produced it. + +Wire framing: [opcode:uint32 LE][length:uint32 LE][json payload] + opcode 0 = HANDSHAKE (client -> server) + opcode 1 = FRAME (both directions) + opcode 2 = CLOSE + opcode 3 = PING + opcode 4 = PONG + +Capture file format: one JSON object per line, + {"op": , "payload": | {"raw": ""}} +Records are appended under a lock to an O_APPEND descriptor so a spec reading +the file concurrently never sees a half-written or spliced line. + +The C++ equivalent used by TDiscordModeTest is +test/functional_tests/DiscordIpcServerStub.cpp - keep the two in step. + +Usage: + discord-ipc-fixture.py --ready-file [--runtime-dir ] + [--capture-file ] [--username ] + +It prints (and, with --ready-file, writes) shell-style KEY=VALUE lines naming +the runtime directory and capture file once it is listening. Point +XDG_RUNTIME_DIR at the former before Mudlet starts: discord-rpc's reconnect +backoff is process-global and survives Discord_Shutdown, so a server that only +appears after the first failed connection attempt can cost up to ~120s. +""" + +import argparse +import json +import os +import socket +import struct +import sys +import tempfile +import threading + +SOCKET_FILE_NAME = "discord-ipc-0" + +OP_HANDSHAKE = 0 +OP_FRAME = 1 +OP_CLOSE = 2 +OP_PING = 3 +OP_PONG = 4 + +# discord-rpc's own send buffer is 16KB, so anything near this is nonsense: +MAXIMUM_FRAME_BYTES = 1024 * 1024 + + +def ready_payload(username): + return { + "cmd": "DISPATCH", + "evt": "READY", + "data": { + "v": 1, + "config": { + "cdn_host": "cdn.discordapp.com", + "api_endpoint": "//discord.com/api", + "environment": "production", + }, + "user": { + "id": "111111111111111111", + "username": username, + "discriminator": "0", + "global_name": username, + "avatar": None, + "bot": False, + "flags": 0, + "premium_type": 0, + }, + }, + } + + +class CaptureLog: + def __init__(self, path): + self._fd = os.open(path, os.O_WRONLY | os.O_CREAT | os.O_APPEND, 0o644) + self._lock = threading.Lock() + + def append(self, opcode, payload_bytes): + try: + payload = json.loads(payload_bytes.decode("utf-8")) + except (UnicodeDecodeError, ValueError): + payload = {"raw": payload_bytes.decode("utf-8", "replace")} + line = (json.dumps({"op": opcode, "payload": payload}, sort_keys=True) + "\n").encode("utf-8") + # os.write() may write less than it was given, and discord-rpc's + # reconnects overlap connections, so two serve_connection() threads can + # be here at once. Without the lock one record's remainder could land + # after another record's first write, splicing both into one malformed + # line that framesAfter() would silently drop. + with self._lock: + while line: + line = line[os.write(self._fd, line):] + + +def frame(opcode, payload_bytes): + return struct.pack(" MAXIMUM_FRAME_BYTES: + # A desynchronised stream would otherwise have us block on a + # length that never arrives, with the specs polling a capture + # file that has quietly stopped growing. + sys.stdout.write("discord-ipc-fixture: refusing a %d byte frame, closing the connection\n" % length) + sys.stdout.flush() + return + payload = read_exact(conn, length) if length else b"" + if payload is None: + return + capture.append(opcode, payload) + if opcode == OP_HANDSHAKE: + conn.sendall(frame(OP_FRAME, json.dumps(ready_payload(username)).encode("utf-8"))) + elif opcode == OP_PING: + conn.sendall(frame(OP_PONG, payload)) + elif opcode == OP_CLOSE: + return + # opcode 1 (FRAME, e.g. SET_ACTIVITY) needs no reply - the real + # Discord client answers it, but discord-rpc ignores the answer. + except OSError as error: + sys.stdout.write("discord-ipc-fixture: connection ended: %s\n" % error) + sys.stdout.flush() + + +def main(): + parser = argparse.ArgumentParser(description="Fake Discord IPC server for Mudlet's Lua self-tests") + parser.add_argument("--runtime-dir", help="directory to create the discord-ipc-0 socket in (default: a fresh short temporary directory)") + parser.add_argument("--capture-file", help="file to append captured frames to (default: discord-frames.jsonl inside the runtime directory)") + parser.add_argument("--username", default="MudletSelfTest", help="username the READY dispatch reports as logged in") + parser.add_argument("--ready-file", help="file to write the KEY=VALUE handover lines to once listening") + args = parser.parse_args() + + runtime_dir = args.runtime_dir + if runtime_dir: + os.makedirs(runtime_dir, exist_ok=True) + # Qt refuses to use an XDG_RUNTIME_DIR that anyone else can read, and + # falls back with a warning: + os.chmod(runtime_dir, 0o700) + else: + # Deliberately short: sizeof(sockaddr_un::sun_path) is 108 on Linux and + # 104 on macOS, and the whole socket path has to fit. + runtime_dir = tempfile.mkdtemp(prefix="mdxdg-") + + socket_path = os.path.join(runtime_dir, SOCKET_FILE_NAME) + if len(socket_path) >= 100: + sys.stderr.write("discord-ipc-fixture: socket path %s is too long for AF_UNIX\n" % socket_path) + return 1 + + capture_file = args.capture_file or os.path.join(runtime_dir, "discord-frames.jsonl") + # Truncate any capture left over from an earlier run so the specs never see + # frames from a previous suite: + with open(capture_file, "w"): + pass + capture = CaptureLog(capture_file) + + if os.path.exists(socket_path): + os.unlink(socket_path) + server = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM) + server.bind(socket_path) + server.listen(8) + + handover = "MUDLET_TEST_DISCORD_RUNTIME_DIR=%s\nMUDLET_TEST_DISCORD_CAPTURE_FILE=%s\n" % (runtime_dir, capture_file) + if args.ready_file: + with open(args.ready_file, "w") as handle: + handle.write(handover) + sys.stdout.write(handover) + sys.stdout.write("discord-ipc-fixture: listening on %s as Discord user %s\n" % (socket_path, args.username)) + sys.stdout.flush() + + while True: + try: + conn, _ = server.accept() + except OSError as error: + # Staying up matters: every spec still to run would otherwise wait + # out its timeout against a capture file nobody is writing to. + sys.stdout.write("discord-ipc-fixture: accept failed: %s\n" % error) + sys.stdout.flush() + continue + threading.Thread(target=serve_connection, args=(conn, capture, args.username), daemon=True).start() + + +if __name__ == "__main__": + sys.exit(main()) diff --git a/src/mudlet-lua/tests/Discord_spec.lua b/src/mudlet-lua/tests/Discord_spec.lua new file mode 100644 index 000000000..e4d385b1d --- /dev/null +++ b/src/mudlet-lua/tests/Discord_spec.lua @@ -0,0 +1,767 @@ +-- Specs for the Discord rich-presence Lua API. +-- +-- Networking_spec.lua covers the availability contract - every gated function +-- returning the same denial while the discord-rpc library cannot be loaded. +-- These specs need the opposite arrangement: a Discord client to talk to. +-- CI/discord-ipc-fixture.py is one, a fake Discord IPC server that completes +-- the genuine discord-rpc handshake, reports a logged-in user, and appends +-- every frame the library sends it to the capture file named by +-- MUDLET_TEST_DISCORD_CAPTURE_FILE. That capture is what is asserted on here: +-- the SET_ACTIVITY payload that actually reached "Discord", rather than the +-- return value of the setter that produced it. Nothing is mocked - the real +-- libdiscord-rpc does the talking, over a real socket. +-- +-- To run them locally, start the fixture first: +-- python3 CI/discord-ipc-fixture.py --runtime-dir "$(mktemp -d /tmp/mdxdg-XXXX)" \ +-- --capture-file /tmp/discord-frames.jsonl --ready-file /tmp/discord-ready & +-- then start Mudlet with XDG_RUNTIME_DIR set to that runtime directory, +-- MUDLET_TEST_DISCORD_CAPTURE_FILE to that capture file, and LD_LIBRARY_PATH +-- including 3rdparty/discord/rpc/lib so the bundled library can be found. +-- +-- The fixture has to be listening BEFORE Mudlet starts. discord-rpc's +-- reconnect backoff is process-global, survives Discord_Shutdown and gates +-- even the READY read, so a server that only appears after the first failed +-- attempt costs up to a couple of minutes instead of the ~1s a cold start +-- takes. + +local capturePath = os.getenv("MUDLET_TEST_DISCORD_CAPTURE_FILE") +-- A developer's local run without the fixture pends the whole family; CI sets +-- MUDLET_TEST_REQUIRE_DISCORD so that a workflow which stops starting the +-- fixture, or an image where the library cannot be loaded, fails instead of +-- quietly skipping everything. +local requireDiscord = os.getenv("MUDLET_TEST_REQUIRE_DISCORD") + +-- Mudlet's own Discord application, from Discord::mMudletApplicationId +local mudletApplicationId = "450571881909583884" +-- MidMUD's, one of the registered test applications listed in src/discord.cpp +local otherApplicationId = "460618737712889858" + +local function contains(haystack, needle) + return type(haystack) == "string" and haystack:find(needle, 1, true) ~= nil +end + +-- Asserts that calling fn raises a Lua error whose message contains needle. +-- Matching the message rather than merely "did it error?" proves the call +-- reached its own argument validation: an unregistered function would raise a +-- different "attempt to call" error. +local function assertArgError(fn, needle) + local ok, err = pcall(fn) + assert.is_false(ok) + assert.is_true(contains(err, needle), tostring(err)) +end + +-- Every frame the fake Discord client has recorded so far, oldest first, still +-- as JSON text. Only whole lines are taken: the fixture appends one JSON +-- object per line in a single write, so an unterminated tail can only be a +-- record still being written. +local function capturedLines() + local handle = io.open(capturePath, "rb") + if not handle then + return {} + end + local body = handle:read("*a") + handle:close() + local lines = {} + for line in body:gmatch("[^\n]+\n") do + lines[#lines + 1] = line + end + return lines +end + +local function frameCount() + return #capturedLines() +end + +-- The frames recorded after `mark`, as {op = , payload = }. +-- Decoding from `mark` rather than from the start of the file is what keeps +-- the polling below cheap as the capture grows over a suite run. +local function framesAfter(mark) + local lines = capturedLines() + local frames = {} + for index = mark + 1, #lines do + local decoded = select(2, pcall(yajl.to_value, lines[index])) + if type(decoded) == "table" then + frames[#frames + 1] = decoded + end + end + return frames +end + +-- Hands control back to Mudlet's event loop for a moment. The frames arrive on +-- discord-rpc's own IO thread and are written by the fixture process, so the +-- specs can only see them while Mudlet is idle. +local function pumpEventLoop(milliseconds) + tempTimer(milliseconds / 1000, function() raiseEvent("bustedDiscordTick") end) + waitForEvent("bustedDiscordTick", milliseconds + 1000) +end + +-- The rich presence of the first SET_ACTIVITY recorded after `mark` that +-- `accept` is satisfied with. Every new frame is offered to `accept`, not just +-- the newest one, so an update that lands while waiting cannot make the +-- expectation unsatisfiable. On timeout the most recent frame seen is returned +-- instead, so a spec whose expectation is never met reports what Discord +-- really received rather than a bare timeout. +local function waitForActivity(mark, accept, timeoutMilliseconds) + timeoutMilliseconds = timeoutMilliseconds or 5000 + local waited = 0 + local latest + while true do + for _, frame in ipairs(framesAfter(mark)) do + if frame.op == 1 and type(frame.payload) == "table" and frame.payload.cmd == "SET_ACTIVITY" then + latest = frame.payload.args.activity + if latest and (not accept or accept(latest)) then + return latest + end + end + end + if waited >= timeoutMilliseconds then + return latest + end + -- A frame normally lands within a few milliseconds of the setter, so poll + -- finely: over the whole file this is the difference between adding a + -- couple of seconds to the suite and adding ten. + pumpEventLoop(10) + waited = waited + 10 + end +end + +-- Runs `action` and returns the rich presence Discord received because of it. +local function activityFrom(action, accept, timeoutMilliseconds) + local mark = frameCount() + action() + local activity = waitForActivity(mark, accept, timeoutMilliseconds) + assert.is_table(activity, "no SET_ACTIVITY frame reached the fake Discord client in time") + -- Fail here, on the whole payload, rather than leaving the spec's own + -- assertions to index a field that never arrived and report a nil error. + if accept and not accept(activity) then + assert.is_true(false, "the presence Discord received is not the one expected: " .. tostring(select(2, pcall(yajl.to_string, activity)))) + end + return activity +end + +-- How many presence updates have reached the fake Discord client. Counting +-- SET_ACTIVITY frames rather than all of them keeps an unrelated handshake or +-- subscription from being mistaken for a presence update. +local function activityFrameCount() + local count = 0 + for _, frame in ipairs(framesAfter(0)) do + if frame.op == 1 and type(frame.payload) == "table" and frame.payload.cmd == "SET_ACTIVITY" then + count = count + 1 + end + end + return count +end + +-- The application IDs of the handshakes recorded after `mark`, waited for +-- until at least one arrives. Changing the application ID makes discord-rpc +-- tear its connection down and hand the new ID over in a fresh handshake, +-- which is the only externally visible proof that the switch took effect. +local function waitForHandshakes(mark, timeoutMilliseconds) + local waited = 0 + while true do + local applicationIds = {} + for _, frame in ipairs(framesAfter(mark)) do + if frame.op == 0 then + applicationIds[#applicationIds + 1] = frame.payload.client_id + end + end + if #applicationIds > 0 or waited >= (timeoutMilliseconds or 20000) then + return applicationIds + end + pumpEventLoop(50) + waited = waited + 50 + end +end + +local function discordApiAvailable() + -- A read-access getter: nil plus a message means the API is gated off, any + -- string means the library is loaded and Discord is enabled for this profile. + return getDiscordState() ~= nil +end + +-- Established lazily by connectedToFakeDiscord(): discord-rpc opens its +-- connection on the first presence update and only sends once the READY +-- dispatch has arrived, so the first frame of a run takes about a second while +-- every later one lands within ~50ms. +local connectionProbe +-- Latched once a reset stops coming back, so that a fixture which dies partway +-- through fails the rest of the file at once instead of spending every +-- remaining spec's timeout on a connection that is not going to answer. +local connectionLost = false + +-- What resetDiscordData() puts on the wire: everything cleared but the Mudlet +-- logo, which is not profile data. Recognising it exactly is what lets the +-- reset below double as a drain - once that frame has been seen, no frame from +-- an earlier spec can still be in flight. +local function emptyPresence(activity) + return type(activity.assets) == "table" and activity.assets.large_image == "mudlet" and activity.assets.large_text == nil + and activity.assets.small_image == nil and activity.assets.small_text == nil and activity.details == nil + and activity.state == nil and activity.party == nil and activity.timestamps == nil +end + +-- Clears the presence and waits for the frame that proves it arrived, which is +-- also the whole of the connection probe on the first call. +local function resetPresence(timeoutMilliseconds) + local mark = frameCount() + resetDiscordData() + local activity = waitForActivity(mark, emptyPresence, timeoutMilliseconds) + -- Re-checked, because waitForActivity() hands back the last frame it saw + -- when it times out rather than nothing at all. + return type(activity) == "table" and emptyPresence(activity) +end + +local function connectedToFakeDiscord() + if connectionProbe == nil then + connectionProbe = resetPresence(20000) + end + return connectionProbe +end + +-- Every spec below starts here. Returns false when there is no fake Discord +-- client to talk to, and otherwise leaves the presence empty so that the frame +-- the spec's own call produces is unambiguous. The reset is re-checked every +-- time rather than trusting the first probe: a fixture that dies mid-run would +-- otherwise let the remaining specs pass without asserting anything. +local function readyForDiscord() + local reason + if not capturePath then + reason = "MUDLET_TEST_DISCORD_CAPTURE_FILE is not set (fake Discord IPC server not running)" + elseif not discordApiAvailable() then + reason = "the Discord API is unavailable (discord-rpc could not be loaded, or Discord is disabled for this profile)" + elseif not connectedToFakeDiscord() then + reason = "no presence update reached the fake Discord IPC server" + elseif connectionLost then + reason = "the fake Discord IPC server did not see the cleared presence resetDiscordData() should have sent" + elseif not resetPresence(8000) then + connectionLost = true + reason = "the fake Discord IPC server did not see the cleared presence resetDiscordData() should have sent" + end + if reason then + if requireDiscord then + assert.is_true(false, "MUDLET_TEST_REQUIRE_DISCORD is set but " .. reason) + end + pending(reason) + return false + end + return true +end + +describe("Discord presence reaches Discord", function() + it("completes the IPC handshake with Mudlet's own application ID", function() + if not readyForDiscord() then + return + end + -- The first handshake of the run, which is the one Mudlet's own presence + -- opened before any spec asked for a different application. + assert.equals(mudletApplicationId, waitForHandshakes(0)[1]) + end) + + it("reports that the default Mudlet application ID is in use", function() + if not readyForDiscord() then + return + end + assert.is_true(usingMudletsDiscordID()) + end) + + it("sends the Mudlet logo as the large icon when the profile sets none", function() + if not readyForDiscord() then + return + end + local activity = activityFrom(function() setDiscordState("no icon of its own") end) + assert.equals("mudlet", activity.assets.large_image) + end) + + it("leaves every read-access function callable while Discord is available", function() + if not readyForDiscord() then + return + end + -- The mirror of Networking_spec.lua's availability contract: those specs + -- prove one shared denial while the API is gated off, this one proves the + -- same set is reachable once it is not. + local readers = { + "getDiscordDetail", "getDiscordLargeIcon", "getDiscordLargeIconText", + "getDiscordParty", "getDiscordSmallIcon", "getDiscordSmallIconText", + "getDiscordState", "getDiscordTimeStamps", "usingMudletsDiscordID", + } + for _, name in ipairs(readers) do + assert.is_not_nil(_G[name](), name .. " should be reachable while Discord is available") + end + end) +end) + +describe("setDiscordDetail", function() + it("sends the detail text to Discord", function() + if not readyForDiscord() then + return + end + local activity = activityFrom(function() setDiscordDetail("Exploring the fixture") end, + function(seen) return seen.details == "Exploring the fixture" end) + assert.equals("Exploring the fixture", activity.details) + end) + + it("reports the detail text it sent", function() + if not readyForDiscord() then + return + end + assert.is_true(setDiscordDetail("Hunting in the woods")) + assert.equals("Hunting in the woods", getDiscordDetail()) + end) + + it("substitutes a placeholder for an empty detail text", function() + if not readyForDiscord() then + return + end + -- The placeholder is tr("via Mudlet"), so a localised Mudlet sends a + -- different string; what matters is that something took the empty text's + -- place and that it is what the getter reports. + local activity = activityFrom(function() setDiscordDetail("") end, + function(seen) return seen.details ~= nil end) + assert.is_true(#activity.details > 1) + assert.equals(getDiscordDetail(), activity.details) + end) + + it("refuses a one character detail text and leaves the presence alone", function() + if not readyForDiscord() then + return + end + -- Waited for, so that the frame count below can only move if the rejected + -- call produced one of its own. + activityFrom(function() setDiscordDetail("still here") end, + function(seen) return seen.details == "still here" end) + local presenceUpdates = activityFrameCount() + local ok, message = setDiscordDetail("x") + assert.is_nil(ok) + assert.is_true(contains(message, "text of length 1 not allowed by Discord")) + assert.equals("still here", getDiscordDetail()) + -- A rejected setter must not reach Discord at all, so no further presence + -- update is expected - unlike everywhere else, seeing one here is the + -- failure. + pumpEventLoop(500) + assert.equals(presenceUpdates, activityFrameCount()) + end) + + it("sends a detail text containing a percent sequence unchanged", function() + if not readyForDiscord() then + return + end + -- What reaches Discord is fine; it is only the getter that mangles this, + -- which the pending spec at the end of this file covers. Reading it back + -- here would be the thing that misbehaves, so this one stops at the wire. + local activity = activityFrom(function() setDiscordDetail("Level %d Mage") end, + function(seen) return seen.details ~= nil end) + assert.equals("Level %d Mage", activity.details) + end) + + it("raises a Lua error when the detail text is not a string", function() + if not readyForDiscord() then + return + end + -- Only reachable with the API available: the availability gate is checked + -- before any argument is, so Networking_spec.lua cannot get this far. + assertArgError(function() setDiscordDetail({}) end, "setDiscordDetail: bad argument #1") + end) + + it("truncates a detail text that overflows Discord's 128 byte field", function() + if not readyForDiscord() then + return + end + local overlong = string.rep("a", 200) + local activity = activityFrom(function() setDiscordDetail(overlong) end, + function(seen) return seen.details ~= nil end) + assert.equals(127, #activity.details) + assert.equals(string.rep("a", 127), activity.details) + -- Only what Discord is sent is truncated; Mudlet keeps the whole string. + assert.equals(overlong, getDiscordDetail()) + end) +end) + +describe("setDiscordState", function() + it("sends the state text to Discord", function() + if not readyForDiscord() then + return + end + local activity = activityFrom(function() setDiscordState("Level 50 Mage") end, + function(seen) return seen.state == "Level 50 Mage" end) + assert.equals("Level 50 Mage", activity.state) + end) + + it("reports the state text it sent", function() + if not readyForDiscord() then + return + end + assert.is_true(setDiscordState("In combat")) + assert.equals("In combat", getDiscordState()) + end) + + it("omits the state field entirely when the state text is empty", function() + if not readyForDiscord() then + return + end + -- Empty fields are sent as JSON absences, not as "", so Discord hides the + -- line rather than showing a blank one. + local activity = activityFrom(function() setDiscordState("") end) + assert.is_nil(activity.state) + end) + + it("refuses a one character state text", function() + if not readyForDiscord() then + return + end + assert.is_true(setDiscordState("holding")) + local ok, message = setDiscordState("x") + assert.is_nil(ok) + assert.is_true(contains(message, "text of length 1 not allowed by Discord")) + assert.equals("holding", getDiscordState()) + end) +end) + +describe("setDiscordGame", function() + it("sets both the detail text and the large icon from the game name", function() + if not readyForDiscord() then + return + end + local activity = activityFrom(function() setDiscordGame("WoTMUD") end, + function(seen) return seen.details ~= nil and seen.assets.large_image == "wotmud" end) + -- The detail text is tr("Playing %1"), so only the interpolated game name + -- is the same on a localised Mudlet. + assert.is_true(contains(activity.details, "WoTMUD")) + assert.equals("wotmud", activity.assets.large_image) + end) +end) + +describe("setDiscordLargeIcon and setDiscordSmallIcon", function() + it("lower-cases the large icon key on the way to Discord", function() + if not readyForDiscord() then + return + end + -- Discord asset keys are lower case, so Mudlet folds whatever it is given. + local activity = activityFrom(function() setDiscordLargeIcon("Achaea") end, + function(seen) return seen.assets.large_image ~= "mudlet" end) + assert.equals("achaea", activity.assets.large_image) + assert.equals("achaea", getDiscordLargeIcon()) + end) + + it("sends the large icon's tooltip text", function() + if not readyForDiscord() then + return + end + local activity = activityFrom(function() setDiscordLargeIconText("Achaea, Dreams of Divine Lands") end, + function(seen) return seen.assets.large_text ~= nil end) + assert.equals("Achaea, Dreams of Divine Lands", activity.assets.large_text) + assert.equals("Achaea, Dreams of Divine Lands", getDiscordLargeIconText()) + end) + + it("lower-cases the small icon key on the way to Discord", function() + if not readyForDiscord() then + return + end + local activity = activityFrom(function() setDiscordSmallIcon("Shield") end, + function(seen) return seen.assets.small_image ~= nil end) + assert.equals("shield", activity.assets.small_image) + assert.equals("shield", getDiscordSmallIcon()) + end) + + it("sends the small icon's tooltip text", function() + if not readyForDiscord() then + return + end + local activity = activityFrom(function() setDiscordSmallIconText("Guardian") end, + function(seen) return seen.assets.small_text ~= nil end) + assert.equals("Guardian", activity.assets.small_text) + assert.equals("Guardian", getDiscordSmallIconText()) + end) + + it("refuses a one character large icon text", function() + if not readyForDiscord() then + return + end + assert.is_true(setDiscordLargeIconText("unchanged")) + local ok, message = setDiscordLargeIconText("x") + assert.is_nil(ok) + assert.is_true(contains(message, "text of length 1 not allowed by Discord")) + assert.equals("unchanged", getDiscordLargeIconText()) + end) + + it("refuses a one character small icon text", function() + if not readyForDiscord() then + return + end + assert.is_true(setDiscordSmallIconText("unchanged")) + local ok, message = setDiscordSmallIconText("x") + assert.is_nil(ok) + assert.is_true(contains(message, "text of length 1 not allowed by Discord")) + assert.equals("unchanged", getDiscordSmallIconText()) + end) +end) + +describe("setDiscordElapsedStartTime and setDiscordRemainingEndTime", function() + it("sends an elapsed start time and no end time", function() + if not readyForDiscord() then + return + end + local activity = activityFrom(function() setDiscordElapsedStartTime(1700000000) end, + function(seen) return seen.timestamps ~= nil end) + assert.equals(1700000000, activity.timestamps.start) + assert.is_nil(activity.timestamps["end"]) + end) + + it("replaces an elapsed start time with a remaining end time", function() + if not readyForDiscord() then + return + end + -- The two are mutually exclusive: Discord shows either "elapsed" or + -- "remaining", so setting one has to clear the other. + assert.is_true(setDiscordElapsedStartTime(1700000000)) + local activity = activityFrom(function() setDiscordRemainingEndTime(1900000000) end, + function(seen) return seen.timestamps and seen.timestamps["end"] ~= nil end) + assert.equals(1900000000, activity.timestamps["end"]) + assert.is_nil(activity.timestamps.start) + end) + + it("reports the timestamps it sent", function() + if not readyForDiscord() then + return + end + assert.is_true(setDiscordElapsedStartTime(1700000000)) + local startTime, endTime = getDiscordTimeStamps() + assert.equals(1700000000, startTime) + assert.equals(0, endTime) + + assert.is_true(setDiscordRemainingEndTime(1900000000)) + startTime, endTime = getDiscordTimeStamps() + assert.equals(0, startTime) + assert.equals(1900000000, endTime) + end) + + it("drops the timestamps entirely when given zero", function() + if not readyForDiscord() then + return + end + -- Waited for, not just called: the spec below asserts on the first frame + -- that follows, so this one's has to have landed already. + activityFrom(function() setDiscordElapsedStartTime(1700000000) end, + function(seen) return seen.timestamps ~= nil end) + local activity = activityFrom(function() setDiscordElapsedStartTime(0) end) + assert.is_nil(activity.timestamps) + end) + + it("refuses a negative elapsed start time", function() + if not readyForDiscord() then + return + end + assert.is_true(setDiscordElapsedStartTime(1700000000)) + local ok, message = setDiscordElapsedStartTime(-1) + assert.is_nil(ok) + assert.is_true(contains(message, "the timestamp must be zero")) + assert.equals(1700000000, (getDiscordTimeStamps())) + end) + + it("refuses a negative remaining end time", function() + if not readyForDiscord() then + return + end + assert.is_true(setDiscordRemainingEndTime(1900000000)) + local ok, message = setDiscordRemainingEndTime(-1) + assert.is_nil(ok) + assert.is_true(contains(message, "the timestamp must be zero")) + assert.equals(1900000000, select(2, getDiscordTimeStamps())) + end) +end) + +describe("setDiscordParty", function() + it("sends the party size and maximum", function() + if not readyForDiscord() then + return + end + local activity = activityFrom(function() setDiscordParty(2, 5) end, + function(seen) return seen.party ~= nil end) + assert.same({2, 5}, activity.party.size) + end) + + it("raises the maximum to the size when only a size is given", function() + if not readyForDiscord() then + return + end + local activity = activityFrom(function() setDiscordParty(3) end, + function(seen) return seen.party ~= nil end) + assert.same({3, 3}, activity.party.size) + end) + + it("keeps an established maximum when only a smaller size is given", function() + if not readyForDiscord() then + return + end + assert.is_true(setDiscordParty(2, 5)) + local activity = activityFrom(function() setDiscordParty(1) end, + function(seen) return seen.party and seen.party.size[1] == 1 end) + assert.same({1, 5}, activity.party.size) + end) + + it("removes the party from the presence when the maximum is zero", function() + if not readyForDiscord() then + return + end + activityFrom(function() setDiscordParty(2, 5) end, function(seen) return seen.party ~= nil end) + local activity = activityFrom(function() setDiscordParty(0, 0) end) + assert.is_nil(activity.party) + end) + + it("reports the party it sent", function() + if not readyForDiscord() then + return + end + assert.is_true(setDiscordParty(4, 8)) + local size, maximum = getDiscordParty() + assert.equals(4, size) + assert.equals(8, maximum) + end) + + it("refuses a negative party size", function() + if not readyForDiscord() then + return + end + assert.is_true(setDiscordParty(2, 5)) + local ok, message = setDiscordParty(-1) + assert.is_nil(ok) + assert.is_true(contains(message, "the current party size must be zero or more")) + assert.equals(2, (getDiscordParty())) + end) + + it("refuses a negative party maximum", function() + if not readyForDiscord() then + return + end + assert.is_true(setDiscordParty(2, 5)) + local ok, message = setDiscordParty(3, -1) + assert.is_nil(ok) + assert.is_true(contains(message, "the optional party maximum size")) + -- Both, so that a rejected call falling through to the size-only overload + -- would be caught rather than looking unchanged. + local size, maximum = getDiscordParty() + assert.equals(2, size) + assert.equals(5, maximum) + end) + + it("raises a Lua error when the party size is not a number", function() + if not readyForDiscord() then + return + end + assertArgError(function() setDiscordParty("a few") end, "setDiscordParty: bad argument #1") + end) +end) + +describe("resetDiscordData", function() + it("clears every presence field it had set", function() + if not readyForDiscord() then + return + end + assert.is_true(setDiscordDetail("Exploring the forest")) + assert.is_true(setDiscordState("Level 50 Mage")) + assert.is_true(setDiscordLargeIcon("achaea")) + assert.is_true(setDiscordLargeIconText("Achaea")) + assert.is_true(setDiscordSmallIcon("shield")) + assert.is_true(setDiscordSmallIconText("Guardian")) + assert.is_true(setDiscordParty(2, 5)) + assert.is_true(setDiscordElapsedStartTime(1700000000)) + + local activity = activityFrom(function() resetDiscordData() end, + function(seen) return seen.details == nil end) + assert.is_nil(activity.details) + assert.is_nil(activity.state) + assert.is_nil(activity.party) + assert.is_nil(activity.timestamps) + assert.is_nil(activity.assets.large_text) + assert.is_nil(activity.assets.small_image) + assert.is_nil(activity.assets.small_text) + -- The Mudlet logo is not profile data, so it comes back with the reset + -- presence rather than being cleared by it. + assert.equals("mudlet", activity.assets.large_image) + end) + + it("clears what the getters report", function() + if not readyForDiscord() then + return + end + assert.is_true(setDiscordDetail("Exploring the forest")) + assert.is_true(setDiscordSmallIconText("Guardian")) + assert.is_true(setDiscordParty(2, 5)) + assert.is_true(setDiscordElapsedStartTime(1700000000)) + + assert.is_true(resetDiscordData()) + + assert.equals("", getDiscordDetail()) + assert.equals("", getDiscordState()) + assert.equals("", getDiscordLargeIcon()) + assert.equals("", getDiscordSmallIconText()) + assert.equals(0, (getDiscordParty())) + assert.equals(0, (getDiscordTimeStamps())) + end) +end) + +describe("setDiscordApplicationID", function() + it("reconnects to Discord under the new application ID and back again", function() + if not readyForDiscord() then + return + end + -- Should an assertion below leave the other application in place, the + -- following spec would open with a reconnect it does not expect. + finally(function() setDiscordApplicationID() end) + + -- Both directions in one spec on purpose: each switch makes discord-rpc + -- drop its socket and hand the new ID over in a fresh handshake, which + -- costs about a second and a half of real reconnect time. + local mark = frameCount() + assert.is_true(setDiscordApplicationID(otherApplicationId)) + assert.is_false(usingMudletsDiscordID()) + -- The first handshake after the switch, rather than the whole list: a + -- connection attempt that had to be retried would add another. + assert.equals(otherApplicationId, waitForHandshakes(mark)[1]) + + mark = frameCount() + assert.is_true(setDiscordApplicationID()) + assert.is_true(usingMudletsDiscordID()) + assert.equals(mudletApplicationId, waitForHandshakes(mark)[1]) + end) + + it("treats an empty application ID as the request to go back to Mudlet's", function() + if not readyForDiscord() then + return + end + finally(function() setDiscordApplicationID() end) + + local mark = frameCount() + assert.is_true(setDiscordApplicationID(otherApplicationId)) + assert.equals(otherApplicationId, waitForHandshakes(mark)[1]) + + mark = frameCount() + assert.is_true(setDiscordApplicationID("")) + assert.is_true(usingMudletsDiscordID()) + assert.equals(mudletApplicationId, waitForHandshakes(mark)[1]) + end) + + it("refuses an application ID that is not a number", function() + if not readyForDiscord() then + return + end + local ok, message = setDiscordApplicationID("not-an-id") + assert.is_nil(ok) + assert.is_true(contains(message, "can not be converted to the expected numeric Discord application ID")) + assert.is_true(usingMudletsDiscordID()) + end) +end) + +describe("known Discord API defects", function() + it("returns a detail text containing a percent sequence unchanged", function() + pending("getDiscordDetail() and the other five Discord getters pass the stored text to " + .. "lua_pushfstring() as its format string, so a detail of 'Level %d Mage' comes back " + .. "with a garbage number in place of the %d and a '%s' would dereference a pointer " + .. "that was never passed - fix TLuaInterpreterDiscord.cpp to push the string as data, " + .. "then unpend this") + end) + + it("truncates an overlong detail text on a character boundary", function() + pending("localDiscordPresence cuts the text at 127 bytes without regard for UTF-8, so 64 " + .. "two-byte characters reach Discord as 63 characters plus half of one - the frame is " + .. "no longer valid UTF-8. Fix the truncation in discord.cpp, then unpend this") + end) +end) From 50edd35345237a38404f827cb203fb90b5aa834c Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Tue, 4 Aug 2026 21:54:48 +0200 Subject: [PATCH 081/155] infrastructure: package and module lifecycle specs with a committed fixture kit (#9632) #### Brief overview of PR changes/additions - New `src/mudlet-lua/tests/Package_spec.lua`: 62 busted specs for the package and module lifecycle API (`installPackage`/`uninstallPackage`, `installModule`/`uninstallModule`, `reloadModule`, `getPackages`/`getModules`, `get`/`setPackageInfo`, `get`/`setModuleInfo`, `getModulePath`, `get`/`setModulePriority`, `enable`/`disable`/`getModuleSync`). Contract and effect both: files really land under `getMudletHomeDir()`, aliases and scripts really exist, package scripts really run, the install and uninstall events really fire. Nothing is mocked. - New `src/mudlet-lua/tests/fixtures/packages/`: seven fixture packages (4 KB of archives in total) kept as readable sources plus the committed `.mpackage` each one zips to, with `build-fixtures.sh` to rebuild them byte for byte. A minimal package, one with a resources folder, a module, a self-uninstalling package (#9557), an archive without a `config.lua`, an empty archive and a file that is not a zip at all. - **Both are new files, so this is your veto point** (precedent: `Media_spec.lua`). Everything the specs install is uninstalled again when the spec ends, and the last spec asserts the profile was left as it was found. #### Motivation for adding to Mudlet All seventeen of these functions were at zero coverage, and they are what every package manager, auto-updater and `mpkg` install goes through. Writing the specs turned up five defects, listed below (#9670, #9653, #9654, #9655, and one that is already #7820); three of them sit here as `pending` specs rather than pinned behaviour, so a fix flips them green instead of having to be rewritten. #### Other info (issues closed, discussion etc) Found while writing these, none fixed here (1, 4 and 5 are the ones that matter). Item 6 is not a defect - it is written down because it explains a same-profile suite re-run failure: 1. (already #7820) An install that arrives while a profile save is running is postponed on `profileSaveFinished()`, which is never emitted once the profile writer is gone - so `installPackage()` answers `true` and never installs anything. `installModule()` and `reloadModule()` share the path; `uninstallPackage()` refuses outright. Every helper in the spec file has to retry around this. 2. (#9655) `getModulePriority()` answers `nil, "module doesn't exist"` for an installed module until someone calls `setModulePriority()` on it. 3. (#9654) An archive with neither a `config.lua` nor a package XML is unpacked and answered with `true`, but is not registered - so it cannot be uninstalled and its folder stays in the profile. 4. (#9653) `uninstallPackage()` followed by closing Mudlet is a heap-use-after-free: the profile save it queues on a zero-timer runs after `~Host()` (ASan, in `Host::pendingXmlSaveFutures()`). 5. (#9670) Mudlet stops responding part way through this file **on macOS**: both CI runs went silent for ~55s at the same point - reconstructed from busted's progress marks as the module install and uninstall region, not directly observed - after about twenty of the profile saves that every install and uninstall starts, and the one-minute CI step was killed. Linux (including the ASan build) and single-core runs never reproduce it. The specs that install something are `pending` on macOS until #9670 is fixed - 27 contract specs still run there and the file costs no profile saves at all. 6. Not a Mudlet defect, but worth knowing about this file: driving package uninstalls from inside `waitForEvent()`'s nested event loop makes the profile's button toolbars stack up, because the deferred deletes they post are only processed by the outer loop - the main console loses about 90px of height per uninstall for the rest of the run. Driven from the real main event loop instead, the height does not move, so this is an artefact of how a spec file drives Mudlet rather than something a user hits. It is why a *second* run of the whole suite against the same profile trips `UI_spec.lua`'s own `getMainWindowSize` spec: `UI_spec`'s `tempButton` specs leave toolbars in the self-test profile on every run, and these uninstalls then stack them. A fresh profile, which is what CI uses, is unaffected. **Test case:** Lua suite on a fresh profile: 1888 successes / 0 failures / 20 pending in 15.6s (baseline without this file 1829/0/17 in 10.3s; the specs that only read share one installed fixture so the file costs 19 profile saves rather than 49). Sabotage check: six defects injected into `Host.cpp`/`TLuaInterpreter.cpp` (package info dropped, module sync flag ignored, package folder kept, install event not raised, priority not stored, `reloadModule()` a no-op) failed 15 of the 62 specs and nothing else. Simulating the macOS gate locally leaves 1856/0/52 with no installs and one profile save. `ctest` 38/39, the one failure being `TKeySequenceEditTest` needing a window manager this machine has none of. Assisted-by: Claude:claude-opus-5 --- src/CMakeLists.txt | 7 +- src/mudlet-lua/tests/Package_spec.lua | 984 ++++++++++++++++++ .../tests/fixtures/packages/README.md | 32 + .../tests/fixtures/packages/build-fixtures.sh | 35 + .../mudlet-spec-emptyarchive.mpackage | Bin 0 -> 184 bytes .../packages/mudlet-spec-minimal.mpackage | Bin 0 -> 722 bytes .../packages/mudlet-spec-module.mpackage | Bin 0 -> 723 bytes .../packages/mudlet-spec-noconfig.mpackage | Bin 0 -> 414 bytes .../packages/mudlet-spec-notazip.mpackage | 2 + .../packages/mudlet-spec-resources.mpackage | Bin 0 -> 1220 bytes .../mudlet-spec-selfuninstall.mpackage | Bin 0 -> 742 bytes .../mudlet-spec-emptyarchive/readme.txt | 1 + .../sources/mudlet-spec-minimal/config.lua | 5 + .../mudlet-spec-minimal.xml | 28 + .../sources/mudlet-spec-module/config.lua | 5 + .../mudlet-spec-module/mudlet-spec-module.xml | 28 + .../mudlet-spec-noconfig.xml | 21 + .../sources/mudlet-spec-resources/config.lua | 5 + .../mudlet-spec-resources.xml | 21 + .../resources/nested/spec-nested.txt | 1 + .../resources/spec-note.txt | 1 + .../mudlet-spec-selfuninstall/config.lua | 5 + .../mudlet-spec-selfuninstall.xml | 35 + .../mudlet-spec-xmlonly.xml | 21 + 24 files changed, 1236 insertions(+), 1 deletion(-) create mode 100644 src/mudlet-lua/tests/Package_spec.lua create mode 100644 src/mudlet-lua/tests/fixtures/packages/README.md create mode 100755 src/mudlet-lua/tests/fixtures/packages/build-fixtures.sh create mode 100644 src/mudlet-lua/tests/fixtures/packages/mudlet-spec-emptyarchive.mpackage create mode 100644 src/mudlet-lua/tests/fixtures/packages/mudlet-spec-minimal.mpackage create mode 100644 src/mudlet-lua/tests/fixtures/packages/mudlet-spec-module.mpackage create mode 100644 src/mudlet-lua/tests/fixtures/packages/mudlet-spec-noconfig.mpackage create mode 100644 src/mudlet-lua/tests/fixtures/packages/mudlet-spec-notazip.mpackage create mode 100644 src/mudlet-lua/tests/fixtures/packages/mudlet-spec-resources.mpackage create mode 100644 src/mudlet-lua/tests/fixtures/packages/mudlet-spec-selfuninstall.mpackage create mode 100644 src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-emptyarchive/readme.txt create mode 100644 src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-minimal/config.lua create mode 100644 src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-minimal/mudlet-spec-minimal.xml create mode 100644 src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-module/config.lua create mode 100644 src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-module/mudlet-spec-module.xml create mode 100644 src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-noconfig/mudlet-spec-noconfig.xml create mode 100644 src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-resources/config.lua create mode 100644 src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-resources/mudlet-spec-resources.xml create mode 100644 src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-resources/resources/nested/spec-nested.txt create mode 100644 src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-resources/resources/spec-note.txt create mode 100644 src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-selfuninstall/config.lua create mode 100644 src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-selfuninstall/mudlet-spec-selfuninstall.xml create mode 100644 src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-xmlonly/mudlet-spec-xmlonly.xml diff --git a/src/CMakeLists.txt b/src/CMakeLists.txt index a82ea4244..e18bfee5f 100644 --- a/src/CMakeLists.txt +++ b/src/CMakeLists.txt @@ -924,7 +924,12 @@ if(UNIX AND NOT APPLE) DIRECTORY "mudlet-lua/tests" DESTINATION "share/mudlet" FILES_MATCHING - PATTERN "*.lua" PERMISSIONS OWNER_READ OWNER_WRITE GROUP_READ WORLD_READ) + PATTERN "*.lua" PERMISSIONS OWNER_READ OWNER_WRITE GROUP_READ WORLD_READ + # the package specs install these fixtures, so they have to travel with them + PATTERN "*.mpackage" PERMISSIONS OWNER_READ OWNER_WRITE GROUP_READ + WORLD_READ + PATTERN "*.xml" PERMISSIONS OWNER_READ OWNER_WRITE GROUP_READ WORLD_READ + PATTERN "*.txt" PERMISSIONS OWNER_READ OWNER_WRITE GROUP_READ WORLD_READ) install( DIRECTORY "../3rdparty/lcf" DESTINATION "share/mudlet/lua" diff --git a/src/mudlet-lua/tests/Package_spec.lua b/src/mudlet-lua/tests/Package_spec.lua new file mode 100644 index 000000000..6769fbea7 --- /dev/null +++ b/src/mudlet-lua/tests/Package_spec.lua @@ -0,0 +1,984 @@ +-- Specs for the package and module lifecycle Lua APIs. +-- +-- Every spec here drives the real API against the fixture kit committed in +-- fixtures/packages/ - nothing is mocked. Alongside each contract (what a call +-- returns, and what it returns when it is misused) the effect is checked too: +-- the package's files actually land under getMudletHomeDir(), its aliases and +-- scripts actually exist, its script body actually ran, and getPackages() / +-- getModules() actually list it. +-- +-- Installing or uninstalling anything costs a full profile save, so the specs +-- that only read share one installed fixture through setup()/teardown() rather +-- than each installing their own - a file that saved the profile fifty times +-- took longer than the whole rest of the suite. +-- +-- Everything these specs install is uninstalled again when the spec (or its +-- block) ends, and the last spec in the file asserts that nothing was left +-- behind: the self-test profile is reused between runs, so a leak here would +-- break the next run. + +-- waitForEvent() is inert outside test mode, and without it these specs cannot +-- let the profile save finish - the uninstalls would fail and strand fixture +-- packages in the profile, so say so rather than make a mess of it. +if not os.getenv("MUDLET_TEST_MODE") then + describe("Tests the package and module lifecycle", function() + it("needs test mode", function() + pending("the package specs need MUDLET_TEST_MODE (waitForEvent() does nothing without it)") + end) + end) + return +end + +local specDirectory = debug.getinfo(1, "S").source:match("^@(.*)[/\\]") +assert(specDirectory, "Package_spec.lua has to be run from a file so that it can find its fixtures") +local fixtureDirectory = specDirectory .. "/fixtures/packages" + +-- Where the module fixtures are copied to before being installed - see +-- installFixtureModule() for why they cannot be installed from the repository. +local scratchDirectory = getMudletHomeDir() .. "/busted-package-fixtures" + +local minimalPackage = "mudlet-spec-minimal" +local resourcesPackage = "mudlet-spec-resources" +local moduleName = "mudlet-spec-module" + +-- busted keeps only the last function handed to finally(), so everything that +-- has to be undone at the end of a spec goes through one registration here - +-- otherwise a spec that cleans up both a fixture and an event handler silently +-- loses one of them. +local cleanups +local function defer(cleanup) + if not cleanups then + cleanups = {} + finally(function() + local queued = cleanups + cleanups = nil + -- one clean-up giving up (an uninstall that never took, say) must not + -- strand the rest, so run them all and report the first failure after + local firstFailure + for index = #queued, 1, -1 do + local ok, err = pcall(queued[index]) + if not ok and not firstFailure then + firstFailure = err + end + end + if firstFailure then + error(firstFailure, 0) + end + end) + end + cleanups[#cleanups + 1] = cleanup +end + +-- Mudlet stops responding part way through this file on macOS: every install +-- and uninstall starts a profile save, and on that platform the run wedges +-- somewhere in the middle of them, so the one-minute CI step for the Lua tests +-- is killed. Linux (including the AddressSanitizer build) and Windows run the +-- whole file fine. Until the save is fixed the specs that install something are +-- pending on macOS; the contract specs still run there. +local installsWedgeThisPlatform = getOS() == "mac" + +local function requireWorkingInstalls() + if installsWedgeThisPlatform then + pending("installing a package wedges Mudlet on macOS - see the PR that added this file") + end +end + +local function contains(haystack, needle) + return type(haystack) == "string" and haystack:find(needle, 1, true) ~= nil +end + +-- Asserts that calling fn raises a Lua error whose message contains needle. +-- Matching a message substring (rather than merely "did it error?") ensures the +-- function is actually registered and reached its own argument validation: an +-- unregistered/nil function would raise a different "attempt to call" error. +local function assertArgError(fn, needle) + local ok, err = pcall(fn) + assert.is_false(ok) + assert.is_true(contains(err, needle), tostring(err)) +end + +-- waitForEvent() spins the Qt event loop, so waiting for an event nothing ever +-- raises is how a spec gives Mudlet's queued work a chance to run: the install +-- events are raised from a zero-timer, and so is the profile save that +-- uninstallPackage() schedules. +local function pumpEventLoop(milliseconds) + waitForEvent("mudletPackageSpecIdleEvent", milliseconds) +end + +local function waitUntil(condition, timeoutMilliseconds) + local waited = 0 + while waited < timeoutMilliseconds do + if condition() then + return true + end + pumpEventLoop(50) + waited = waited + 50 + end + return condition() and true or false +end + +local function listContains(list, name) + for _, entry in ipairs(list) do + if entry == name then + return true + end + end + return false +end + +local function packageInstalled(name) + return listContains(getPackages(), name) +end + +local function moduleInstalled(name) + return listContains(getModules(), name) +end + +local function fileExists(path) + return lfs.attributes(path, "mode") ~= nil +end + +local function copyFile(from, to) + local source = io.open(from, "rb") + assert.is_not_nil(source, "could not read the fixture " .. from) + local contents = source:read("*a") + source:close() + local destination = io.open(to, "wb") + assert.is_not_nil(destination, "could not write to " .. to) + assert.is_not_nil(destination:write(contents), "could not write to " .. to) + destination:close() +end + +-- Every install and uninstall here starts an asynchronous profile save, and +-- while one is running the package API stops doing what it is told: an install +-- is postponed and answered with a bare true (see the pending spec at the end +-- of this file), an uninstall is refused, and a module reload is dropped. Lua +-- cannot ask whether a save is running, so each of the helpers below asks again +-- until what it wanted has actually happened. They wait longer between tries +-- than they need to on a fast machine on purpose: each postponed call queues +-- another attempt for whenever the save does finish, and a pile of those all +-- arriving at once starts a pile of saves. +-- Lua has no direct way to ask whether a profile save is running, but +-- installPackage() gives it away: while one is in progress it postpones +-- whatever it was asked to do and answers true, even for an empty path it would +-- otherwise refuse outright. Waiting for the refusal to come back is what keeps +-- the installs below from being postponed - a postponed install is carried out +-- later, and can put a package back after a spec has taken it away again. +local function waitForProfileSaveToPass() + return waitUntil(function() return installPackage("") == nil end, 5000) +end + +local function installUntilConfirmed(install, path, isInstalled, what) + for attempt = 1, 3 do + if isInstalled() then + return + end + waitForProfileSaveToPass() + local ok, err = install(path) + -- a postponed install can still be carried out while the pump below runs + -- the event loop, so a repeat may legitimately come back "already installed" + if ok ~= true and not contains(err, "already installed") then + assert.is_true(false, tostring(err)) + end + -- an install that is carried out is carried out there and then, so if it is + -- not listed by the time the call returns it was postponed + if isInstalled() then + return + end + pumpEventLoop(400 * attempt) + end + assert.is_true(false, "could not install " .. what) +end + +-- The same postponement answers a bad install path with true as well, so a spec +-- about the refusal waits for the save to pass and asks again. +local function installUntilRefused(install, path) + for attempt = 1, 3 do + waitForProfileSaveToPass() + local ok, err = install(path) + if ok == nil then + return err + end + pumpEventLoop(400 * attempt) + end + assert.is_true(false, "the install was postponed instead of being answered") +end + +-- reloadModule() is postponed the same way and then quietly dropped, so ask +-- until the reload is observable. +local function reloadModuleUntil(name, reloaded) + for attempt = 1, 3 do + reloadModule(name) + if waitUntil(reloaded, 300) then + return + end + pumpEventLoop(400 * attempt) + end + assert.is_true(false, "the module was never reloaded") +end + +-- Uninstalls and then waits, twice over if it has to: an install this file +-- postponed earlier can be carried out while the wait runs the event loop, and +-- would otherwise reinstall the package behind the spec's back. +local function removeFixturePackage(name) + for _ = 1, 3 do + if not packageInstalled(name) then + return + end + waitForProfileSaveToPass() + -- uninstallPackage() refuses while a profile save is in progress, and the + -- installs here start one, so keep asking until it takes + assert.is_true(waitUntil(function() return uninstallPackage(name) == true end, 5000), + "could not uninstall the fixture package " .. name) + -- let the profile save that uninstallPackage() queues run now, rather than + -- during Mudlet's shutdown + pumpEventLoop(200) + end + assert.is_false(packageInstalled(name), "the fixture package " .. name .. " reinstalled itself") +end + +local function installFixturePackage(name) + installUntilConfirmed(installPackage, fixtureDirectory .. "/" .. name .. ".mpackage", + function() return packageInstalled(name) end, "the fixture package " .. name) +end + +local function withFixturePackage(name) + defer(function() removeFixturePackage(name) end) + installFixturePackage(name) +end + +local function removeFixtureModule(name) + for _ = 1, 3 do + if not moduleInstalled(name) then + break + end + waitForProfileSaveToPass() + assert.is_true(waitUntil(function() return uninstallModule(name) == true end, 5000), + "could not uninstall the fixture module " .. name) + pumpEventLoop(200) + end + assert.is_false(moduleInstalled(name), "the fixture module " .. name .. " reinstalled itself") + os.remove(scratchDirectory .. "/" .. name .. ".mpackage") + lfs.rmdir(scratchDirectory) +end + +-- A module is installed from a copy inside the profile, never from the +-- repository: with sync enabled a profile save rewrites the module's own +-- .mpackage in place, which would corrupt the committed fixture. +local function installFixtureModule(name) + lfs.mkdir(scratchDirectory) + local path = scratchDirectory .. "/" .. name .. ".mpackage" + copyFile(fixtureDirectory .. "/" .. name .. ".mpackage", path) + installUntilConfirmed(installModule, path, function() return moduleInstalled(name) end, "the fixture module " .. name) + return path +end + +-- The clean-up is registered before the install so a fixture that only got +-- half-way in still leaves nothing behind. +local function withFixtureModule(name) + defer(function() removeFixtureModule(name) end) + return installFixtureModule(name) +end + +-- Collects every occurrence of an event until stopCollecting() is called. The +-- uninstall events are raised inside uninstallPackage() itself, before a +-- waitForEvent() could be armed, so a pre-armed handler is what sees them. +-- Returns the list the events land in and the handler id to kill. +local function collectEvents(eventName) + local events = {} + local handler = registerAnonymousEventHandler(eventName, function(_, ...) + events[#events + 1] = {...} + end) + return events, handler +end + +-- The same, for a spec that can register its own clean-up. +local function collectEventsForSpec(eventName) + local events, handler = collectEvents(eventName) + defer(function() killAnonymousEventHandler(handler) end) + return events +end + +describe("Tests the functionality of installPackage", function() + it("raises a Lua error when called with no arguments", function() + -- the Lua wrapper that lets installPackage() take a URL indexes its + -- argument before the C++ side gets to report a "bad argument #1", so the + -- call fails less clearly than its siblings do + assert.has_error(function() installPackage() end) + end) + + it("returns nil+msg when given an empty path", function() + local err = installUntilRefused(installPackage, "") + assert.is_true(contains(err, "no package file was actually given"), tostring(err)) + end) + + it("returns nil+msg for a file that is not there", function() + local err = installUntilRefused(installPackage, fixtureDirectory .. "/mudlet-spec-there-is-no-such-package.mpackage") + assert.is_true(contains(err, "could not open file"), tostring(err)) + end) + + it("returns nil+msg for a file that is not a zip archive", function() + -- the failed unpacking still creates the destination folder; drop it so the + -- profile is left exactly as it was found + defer(function() lfs.rmdir(getMudletHomeDir() .. "/mudlet-spec-notazip") end) + + local err = installUntilRefused(installPackage, fixtureDirectory .. "/mudlet-spec-notazip.mpackage") + assert.is_true(contains(err, "could not unzip package"), tostring(err)) + assert.is_false(packageInstalled("mudlet-spec-notazip")) + end) + + describe("with the fixture package installed", function() + local runsBefore, installEvents, packageEvents, handlers + + setup(function() + if installsWedgeThisPlatform then + return + end + runsBefore = mudletSpecMinimalRuns or 0 + local genericHandler, detailedHandler + installEvents, genericHandler = collectEvents("sysInstall") + packageEvents, detailedHandler = collectEvents("sysInstallPackage") + handlers = {genericHandler, detailedHandler} + installFixturePackage(minimalPackage) + -- the install events are raised from a zero-timer once the install is done + waitUntil(function() return #packageEvents > 0 end, 2000) + end) + + teardown(function() + if installsWedgeThisPlatform then + return + end + for _, handler in ipairs(handlers) do + killAnonymousEventHandler(handler) + end + removeFixturePackage(minimalPackage) + end) + + it("unpacks the package into the profile and runs its contents", function() + requireWorkingInstalls() + local packageDirectory = getMudletHomeDir() .. "/" .. minimalPackage + assert.is_true(fileExists(packageDirectory), "the package folder was not created") + assert.is_true(fileExists(packageDirectory .. "/config.lua")) + assert.is_true(fileExists(packageDirectory .. "/" .. minimalPackage .. ".xml")) + assert.equals(1, exists(minimalPackage .. " alias", "alias")) + assert.equals(1, exists("mudletSpecMinimalScript", "script")) + assert.is_true(mudletSpecMinimalRuns > runsBefore, "the package's script did not run") + end) + + it("raises sysInstall and sysInstallPackage once the install is complete", function() + requireWorkingInstalls() + assert.equals(1, #installEvents) + assert.equals(minimalPackage, installEvents[1][1]) + assert.equals(1, #packageEvents) + assert.equals(minimalPackage, packageEvents[1][1]) + assert.is_true(contains(packageEvents[1][2], minimalPackage .. ".mpackage"), tostring(packageEvents[1][2])) + end) + + it("refuses to install a package that is already installed", function() + requireWorkingInstalls() + local err = installUntilRefused(installPackage, fixtureDirectory .. "/" .. minimalPackage .. ".mpackage") + assert.is_true(contains(err, "package " .. minimalPackage .. " is already installed"), tostring(err)) + end) + end) + + it("unpacks a folder of resources that ships with a package", function() + requireWorkingInstalls() + withFixturePackage(resourcesPackage) + + local packageDirectory = getMudletHomeDir() .. "/" .. resourcesPackage + assert.is_true(fileExists(packageDirectory .. "/resources/spec-note.txt")) + assert.is_true(fileExists(packageDirectory .. "/resources/nested/spec-nested.txt")) + local handle = io.open(packageDirectory .. "/resources/spec-note.txt", "rb") + assert.is_not_nil(handle) + local contents = handle:read("*a") + handle:close() + assert.is_true(contains(contents, "mudlet-spec-resources fixture resource")) + -- the resources package declares its own version, unlike the minimal one + assert.equals("2.5", getPackageInfo(resourcesPackage, "version")) + end) + + it("names a package after its file when the archive has no config.lua", function() + requireWorkingInstalls() + withFixturePackage("mudlet-spec-noconfig") + + assert.equals(1, exists("mudlet-spec-noconfig alias", "alias")) + assert.same({}, getPackageInfo("mudlet-spec-noconfig")) + end) + + it("installs a package from a plain XML file", function() + requireWorkingInstalls() + local path = fixtureDirectory .. "/sources/mudlet-spec-xmlonly/mudlet-spec-xmlonly.xml" + defer(function() removeFixturePackage("mudlet-spec-xmlonly") end) + installUntilConfirmed(installPackage, path, function() return packageInstalled("mudlet-spec-xmlonly") end, + "the XML fixture package") + + assert.equals(1, exists("mudlet-spec-xmlonly alias", "alias")) + -- nothing is unpacked for a bare XML: the file stays where it is + assert.is_false(fileExists(getMudletHomeDir() .. "/mudlet-spec-xmlonly")) + assert.is_true(fileExists(path), "the package XML must not be moved out of the fixtures") + end) +end) + +describe("Tests the functionality of uninstallPackage", function() + it("raises a Lua error when called with no arguments", function() + assertArgError(function() uninstallPackage() end, "uninstallPackage: bad argument #1 type") + end) + + -- uninstallPackage() answers nil with no message where uninstallModule() + -- answers false: two conventions for the same case, pinned as they are + -- because packages published today read one or the other. + it("returns nil and no message for a package that is not installed", function() + local ok, err = uninstallPackage("mudlet-spec-never-installed") + assert.is_nil(ok) + assert.is_nil(err) + end) + + it("removes the package, its items and its folder, and raises the uninstall events", function() + requireWorkingInstalls() + withFixturePackage(minimalPackage) + local packageDirectory = getMudletHomeDir() .. "/" .. minimalPackage + assert.is_true(fileExists(packageDirectory)) + assert.is_true(packageInstalled(minimalPackage)) + local generic = collectEventsForSpec("sysUninstall") + local detailed = collectEventsForSpec("sysUninstallPackage") + + removeFixturePackage(minimalPackage) + + assert.is_false(packageInstalled(minimalPackage)) + assert.equals(0, exists(minimalPackage .. " alias", "alias")) + assert.equals(0, exists("mudletSpecMinimalScript", "script")) + assert.is_false(fileExists(packageDirectory), "the package folder was left behind") + assert.same({}, getPackageInfo(minimalPackage)) + assert.equals(1, #generic) + assert.equals(minimalPackage, generic[1][1]) + assert.equals(1, #detailed) + assert.equals(minimalPackage, detailed[1][1]) + end) +end) + +describe("Tests the functionality of getPackages", function() + it("returns a table of the installed packages", function() + local packages = getPackages() + assert.is_table(packages) + -- run-tests is the package running these specs, so it is always installed + assert.is_true(listContains(packages, "run-tests")) + assert.is_false(listContains(packages, "mudlet-spec-never-installed")) + end) +end) + +describe("Tests the package info accessors", function() + setup(function() + if not installsWedgeThisPlatform then + installFixturePackage(minimalPackage) + end + end) + teardown(function() + if not installsWedgeThisPlatform then + removeFixturePackage(minimalPackage) + end + end) + + describe("Tests the functionality of getPackageInfo", function() + it("raises a Lua error when the package name is not a string", function() + assertArgError(function() getPackageInfo({}) end, "getPackageInfo: bad argument #1 type") + end) + + it("raises a Lua error when the requested field is not a string", function() + requireWorkingInstalls() + assertArgError(function() getPackageInfo(minimalPackage, {}) end, "getPackageInfo: bad argument #2 type") + end) + + it("returns everything the package's config.lua declared", function() + requireWorkingInstalls() + assert.same({ + mpackage = minimalPackage, + author = "Mudlet test suite", + title = "Minimal fixture package for Package_spec.lua", + version = "1.0", + description = "One alias and one script, just enough to prove a package installed.", + }, getPackageInfo(minimalPackage)) + end) + + it("returns a single field when one is named", function() + requireWorkingInstalls() + assert.equals("1.0", getPackageInfo(minimalPackage, "version")) + assert.equals("Mudlet test suite", getPackageInfo(minimalPackage, "author")) + end) + + it("returns an empty string for a field the package does not have", function() + requireWorkingInstalls() + assert.equals("", getPackageInfo(minimalPackage, "no-such-field")) + end) + + it("returns an empty table for a package that is not installed", function() + assert.same({}, getPackageInfo("mudlet-spec-never-installed")) + end) + end) + + describe("Tests the functionality of setPackageInfo", function() + it("raises a Lua error when called with no arguments", function() + assertArgError(function() setPackageInfo() end, "setPackageInfo: bad argument #1 type") + end) + + it("raises a Lua error when the value is missing", function() + requireWorkingInstalls() + assertArgError(function() setPackageInfo(minimalPackage, "version") end, "setPackageInfo: bad argument #3 type") + end) + + it("round-trips a value through getPackageInfo", function() + requireWorkingInstalls() + defer(function() setPackageInfo(minimalPackage, "version", "1.0") end) + + assert.is_true(setPackageInfo(minimalPackage, "version", "9.9")) + assert.equals("9.9", getPackageInfo(minimalPackage, "version")) + assert.equals("9.9", getPackageInfo(minimalPackage).version) + end) + + it("adds a field the package did not declare", function() + requireWorkingInstalls() + assert.is_true(setPackageInfo(minimalPackage, "spec-added", "yes")) + assert.equals("yes", getPackageInfo(minimalPackage, "spec-added")) + end) + end) +end) + +describe("Tests the functionality of installModule", function() + it("raises a Lua error when called with no arguments", function() + assertArgError(function() installModule() end, "installModule: bad argument #1 type") + end) + + it("returns nil+msg for a file that is not there", function() + local err = installUntilRefused(installModule, fixtureDirectory .. "/mudlet-spec-there-is-no-such-module.mpackage") + assert.is_true(contains(err, "could not open file"), tostring(err)) + end) + + describe("with the fixture module installed", function() + local runsBefore, installEvents, moduleEvents, handlers, modulePath + + setup(function() + if installsWedgeThisPlatform then + return + end + runsBefore = mudletSpecModuleRuns or 0 + local genericHandler, detailedHandler + installEvents, genericHandler = collectEvents("sysInstall") + moduleEvents, detailedHandler = collectEvents("sysLuaInstallModule") + handlers = {genericHandler, detailedHandler} + modulePath = installFixtureModule(moduleName) + waitUntil(function() return #moduleEvents > 0 end, 2000) + end) + + teardown(function() + if installsWedgeThisPlatform then + return + end + for _, handler in ipairs(handlers) do + killAnonymousEventHandler(handler) + end + removeFixtureModule(moduleName) + end) + + it("installs the module, unpacks it and runs its contents", function() + requireWorkingInstalls() + assert.is_true(moduleInstalled(moduleName)) + -- a module is not a package: it must not turn up in getPackages() + assert.is_false(packageInstalled(moduleName)) + assert.is_true(fileExists(getMudletHomeDir() .. "/" .. moduleName)) + assert.equals(1, exists(moduleName .. " alias", "alias")) + assert.is_true(mudletSpecModuleRuns > runsBefore, "the module's script did not run") + end) + + it("raises sysInstall and sysLuaInstallModule", function() + requireWorkingInstalls() + assert.equals(1, #installEvents) + assert.equals(moduleName, installEvents[1][1]) + assert.equals(1, #moduleEvents) + assert.equals(moduleName, moduleEvents[1][1]) + assert.is_true(contains(moduleEvents[1][2], moduleName .. ".mpackage"), tostring(moduleEvents[1][2])) + end) + + it("refuses to install a module that is already installed", function() + requireWorkingInstalls() + local err = installUntilRefused(installModule, modulePath) + assert.is_true(contains(err, "module " .. moduleName .. " is already installed"), tostring(err)) + end) + end) +end) + +describe("Tests the functionality of uninstallModule", function() + it("raises a Lua error when called with no arguments", function() + assertArgError(function() uninstallModule() end, "uninstallModule: bad argument #1 type") + end) + + it("returns false for a module that is not installed", function() + assert.is_false(uninstallModule("mudlet-spec-never-installed")) + end) + + it("removes the module, its items and its folder, and raises the uninstall events", function() + requireWorkingInstalls() + withFixtureModule(moduleName) + local moduleDirectory = getMudletHomeDir() .. "/" .. moduleName + assert.is_true(fileExists(moduleDirectory)) + local generic = collectEventsForSpec("sysUninstall") + local detailed = collectEventsForSpec("sysLuaUninstallModule") + + removeFixtureModule(moduleName) + + assert.is_false(moduleInstalled(moduleName)) + assert.equals(0, exists(moduleName .. " alias", "alias")) + assert.is_false(fileExists(moduleDirectory), "the module folder was left behind") + assert.same({}, getModuleInfo(moduleName)) + assert.equals(1, #generic) + assert.equals(moduleName, generic[1][1]) + assert.equals(1, #detailed) + assert.equals(moduleName, detailed[1][1]) + end) +end) + +describe("Tests the functionality of getModules", function() + it("returns a table of the installed modules", function() + local modules = getModules() + assert.is_table(modules) + assert.is_false(listContains(modules, "mudlet-spec-never-installed")) + end) +end) + +describe("Tests the module accessors", function() + local modulePath + + setup(function() + if not installsWedgeThisPlatform then + modulePath = installFixtureModule(moduleName) + end + end) + teardown(function() + if not installsWedgeThisPlatform then + removeFixtureModule(moduleName) + end + end) + + describe("Tests the functionality of getModuleInfo", function() + it("raises a Lua error when the module name is not a string", function() + assertArgError(function() getModuleInfo({}) end, "getModuleInfo: bad argument #1 type") + end) + + it("returns everything the module's config.lua declared", function() + requireWorkingInstalls() + assert.same({ + mpackage = moduleName, + author = "Mudlet test suite", + title = "Module fixture for Package_spec.lua", + version = "3.1", + description = "Counts how often its script has been compiled, so a reload is observable.", + }, getModuleInfo(moduleName)) + end) + + it("returns a single field when one is named", function() + requireWorkingInstalls() + assert.equals("3.1", getModuleInfo(moduleName, "version")) + assert.equals("", getModuleInfo(moduleName, "no-such-field")) + end) + + it("returns an empty table for a module that is not installed", function() + assert.same({}, getModuleInfo("mudlet-spec-never-installed")) + end) + end) + + describe("Tests the functionality of setModuleInfo", function() + it("raises a Lua error when the value is missing", function() + requireWorkingInstalls() + assertArgError(function() setModuleInfo(moduleName, "version") end, "setModuleInfo: bad argument #3 type") + end) + + it("round-trips a value through getModuleInfo", function() + requireWorkingInstalls() + defer(function() setModuleInfo(moduleName, "version", "3.1") end) + + assert.is_true(setModuleInfo(moduleName, "version", "8.8")) + assert.equals("8.8", getModuleInfo(moduleName, "version")) + assert.equals("8.8", getModuleInfo(moduleName).version) + end) + end) + + describe("Tests the functionality of getModulePath", function() + it("returns the file the module was installed from", function() + requireWorkingInstalls() + assert.equals(modulePath, getModulePath(moduleName)) + end) + end) + + describe("Tests the functionality of getModulePriority", function() + -- Runs before setModulePriority's specs on purpose: a priority outlives the + -- module it was set on (Host::uninstallPackage() leaves mModulePriorities + -- alone), so once one has been set for this module the default this spec is + -- about can never be observed again. + it("reports the default priority of a freshly installed module", function() + -- BUG: a module nobody has called setModulePriority() on has no entry in + -- the priority map, so getModulePriority() answers nil and "module + -- doesn't exist" for a module that plainly does exist. The module manager + -- reads the same map with operator[] and so shows 0, which is what this + -- should return. Left pending rather than pinning the wrong answer. + pending("getModulePriority() reports an installed module as non-existent until a priority is set") + + assert.equals(0, getModulePriority(moduleName)) + end) + end) + + describe("Tests the functionality of setModulePriority", function() + it("raises a Lua error when the priority is missing", function() + requireWorkingInstalls() + assertArgError(function() setModulePriority(moduleName) end, "setModulePriority: bad argument #2 type") + end) + + it("returns nil+msg for a module that is not installed", function() + local ok, err = setModulePriority("mudlet-spec-never-installed", 3) + assert.is_nil(ok) + assert.is_true(contains(err, "module doesn't exist"), tostring(err)) + end) + + it("returns no values and is read back by getModulePriority", function() + requireWorkingInstalls() + assert.equals(0, select('#', setModulePriority(moduleName, 7))) + assert.equals(7, getModulePriority(moduleName)) + setModulePriority(moduleName, -2) + assert.equals(-2, getModulePriority(moduleName)) + end) + end) + + describe("Tests the functionality of enableModuleSync", function() + it("raises a Lua error when called with no arguments", function() + assertArgError(function() enableModuleSync() end, "enableModuleSync: bad argument #1 type") + end) + + it("returns nil+msg for an empty module name", function() + local ok, err = enableModuleSync("") + assert.is_nil(ok) + assert.is_true(contains(err, "module name cannot be an empty string"), tostring(err)) + end) + + it("returns nil+msg for a module that is not installed", function() + local ok, err = enableModuleSync("mudlet-spec-never-installed") + assert.is_nil(ok) + assert.is_true(contains(err, "not found"), tostring(err)) + end) + + it("turns syncing on for an installed module", function() + requireWorkingInstalls() + -- leave the module unsynced: a profile save rewrites a synced module's + -- own .mpackage, and the fixture copy is thrown away when this block ends + defer(function() disableModuleSync(moduleName) end) + assert.is_false(getModuleSync(moduleName)) + + assert.is_true(enableModuleSync(moduleName)) + assert.is_true(getModuleSync(moduleName)) + end) + end) + + describe("Tests the functionality of disableModuleSync", function() + it("returns nil+msg for a module that is not installed", function() + local ok, err = disableModuleSync("mudlet-spec-never-installed") + assert.is_nil(ok) + assert.is_true(contains(err, "not found"), tostring(err)) + end) + + it("turns syncing back off", function() + requireWorkingInstalls() + defer(function() disableModuleSync(moduleName) end) + assert.is_true(enableModuleSync(moduleName)) + + assert.is_true(disableModuleSync(moduleName)) + assert.is_false(getModuleSync(moduleName)) + end) + end) + + describe("Tests the functionality of getModuleSync", function() + it("raises a Lua error when called with no arguments", function() + assertArgError(function() getModuleSync() end, "getModuleSync: bad argument #1 type") + end) + + it("returns nil+msg for a module that is not installed", function() + local ok, err = getModuleSync("mudlet-spec-never-installed") + assert.is_nil(ok) + assert.is_true(contains(err, "not found"), tostring(err)) + end) + + it("is false for a module that nobody has turned syncing on for", function() + requireWorkingInstalls() + assert.is_false(getModuleSync(moduleName)) + end) + end) +end) + +describe("Tests the functionality of reloadModule", function() + it("raises a Lua error when called with no arguments", function() + assertArgError(function() reloadModule() end, "reloadModule: bad argument #1 type") + end) + + it("returns no values and does nothing for a module that is not installed", function() + assert.equals(0, select('#', reloadModule("mudlet-spec-never-installed"))) + assert.is_false(moduleInstalled("mudlet-spec-never-installed")) + end) + + describe("with the fixture module installed", function() + setup(function() + if not installsWedgeThisPlatform then + installFixtureModule(moduleName) + end + end) + teardown(function() + if not installsWedgeThisPlatform then + removeFixtureModule(moduleName) + end + end) + + it("runs the module's scripts again", function() + requireWorkingInstalls() + local runsBefore = mudletSpecModuleRuns + + reloadModuleUntil(moduleName, function() return mudletSpecModuleRuns > runsBefore end) + + assert.is_true(moduleInstalled(moduleName)) + assert.equals(1, exists(moduleName .. " alias", "alias")) + end) + + it("re-reads the module's info from its config.lua", function() + requireWorkingInstalls() + setModuleInfo(moduleName, "title", "changed by the spec") + assert.equals("changed by the spec", getModuleInfo(moduleName, "title")) + + reloadModuleUntil(moduleName, function() + return getModuleInfo(moduleName, "title") == "Module fixture for Package_spec.lua" + end) + end) + + it("keeps the module's priority and sync setting", function() + requireWorkingInstalls() + defer(function() disableModuleSync(moduleName) end) + setModulePriority(moduleName, 4) + assert.is_true(enableModuleSync(moduleName)) + local runsBefore = mudletSpecModuleRuns + + reloadModuleUntil(moduleName, function() return mudletSpecModuleRuns > runsBefore end) + + assert.equals(4, getModulePriority(moduleName)) + assert.is_true(getModuleSync(moduleName)) + end) + end) +end) + +describe("Tests a package that uninstalls itself", function() + -- Regression #9557: a package whose event handler uninstalls its own package + -- used to free the TScript objects that Host::raiseEvent() was still + -- iterating over. Package auto-updaters do exactly this. + it("survives a package uninstalling itself from its own event handler", function() + requireWorkingInstalls() + defer(function() + removeFixturePackage("mudlet-spec-selfuninstall") + mudletSpecSelfUninstallHandler = nil + mudletSpecSelfUninstallSecondHandler = nil + mudletSpecSelfUninstallRan = nil + mudletSpecSelfUninstallSecondRan = nil + end) + installFixturePackage("mudlet-spec-selfuninstall") + assert.equals(1, exists("mudletSpecSelfUninstallHandler", "script")) + + -- the handler's uninstallPackage() declines while the save the install + -- started is still running, so raise until the package is really gone + assert.is_true(waitUntil(function() + mudletSpecSelfUninstallRan = nil + mudletSpecSelfUninstallSecondRan = nil + raiseEvent("mudletSpecSelfUninstall") + return not packageInstalled("mudlet-spec-selfuninstall") + end, 5000), "the package did not uninstall itself") + + assert.is_true(mudletSpecSelfUninstallRan, "the package's own handler did not run") + -- the package's second handler for this event is the one the pre-fix code + -- would have called through a freed script; whether it is reached at all + -- depends on where in the dispatch the uninstall landed, so what is checked + -- here is that both scripts are gone afterwards and nothing crashed + assert.equals(0, exists("mudletSpecSelfUninstallHandler", "script")) + assert.equals(0, exists("mudletSpecSelfUninstallSecondHandler", "script")) + -- raising the event again must not reach the removed scripts + raiseEvent("mudletSpecSelfUninstall") + pumpEventLoop(100) + assert.is_false(packageInstalled("mudlet-spec-selfuninstall")) + end) +end) + +describe("Tests installing a package while the profile is being saved", function() + it("installs a package that is asked for while an earlier install is still saving", function() + -- BUG: installing a package starts an asynchronous profile save, and an + -- install that arrives during one is postponed until profileSaveFinished(). + -- That signal is only emitted while the profile writer is being retired, so + -- an install asked for after the writers are gone but before the save has + -- finished is never carried out - and installPackage() has already answered + -- true, so a script has no way to notice. Left pending rather than pinning + -- a silently dropped install as correct. + pending("installPackage() answers true but drops the install when a save is in progress") + defer(function() + removeFixturePackage(minimalPackage) + removeFixturePackage("mudlet-spec-noconfig") + end) + installFixturePackage(minimalPackage) + + assert.is_true(installPackage(fixtureDirectory .. "/mudlet-spec-noconfig.mpackage")) + assert.is_true(waitUntil(function() return packageInstalled("mudlet-spec-noconfig") end, 5000)) + end) +end) + +describe("Tests installing an archive with nothing in it for Mudlet", function() + it("refuses an archive that holds neither a config.lua nor a package XML", function() + -- BUG: such an archive is unpacked into the profile and answered with true, + -- but nothing is registered: it is missing from getPackages(), so + -- uninstallPackage() will not take it and the unpacked folder stays in the + -- profile for good. Left pending rather than pinning a success that + -- installs nothing and cannot be undone. + pending("installPackage() answers true for an archive with no package in it, and leaves it unremovable") + -- uninstallPackage() will not take a package it never registered, so the + -- unpacked folder has to go by hand + defer(function() + os.remove(getMudletHomeDir() .. "/mudlet-spec-emptyarchive/readme.txt") + lfs.rmdir(getMudletHomeDir() .. "/mudlet-spec-emptyarchive") + end) + + local ok, err = installPackage(fixtureDirectory .. "/mudlet-spec-emptyarchive.mpackage") + assert.is_nil(ok) + assert.is_string(err) + assert.is_false(fileExists(getMudletHomeDir() .. "/mudlet-spec-emptyarchive")) + end) +end) + +describe("The package specs clean up after themselves", function() + it("leaves no fixture package, module or folder behind", function() + for _, name in ipairs(getPackages()) do + assert.is_nil(name:find("mudlet%-spec%-"), "left the package " .. name .. " installed") + end + for _, name in ipairs(getModules()) do + assert.is_nil(name:find("mudlet%-spec%-"), "left the module " .. name .. " installed") + end + for entry in lfs.dir(getMudletHomeDir()) do + assert.is_nil(entry:find("mudlet%-spec%-"), "left the folder " .. entry .. " behind") + end + assert.is_false(fileExists(scratchDirectory), "left the fixture scratch folder behind") + + -- A profile save that catches the sync spec's module while syncing is on + -- copies it into the shared module backup folder. That is Mudlet working as + -- intended rather than a leak to fail the run over, but the copy is this + -- file's to take away again. + local configurationDirectory = getMudletHomeDir():match("^(.*)[/\\]profiles[/\\]") + assert.is_string(configurationDirectory, "could not work out the configuration folder from " .. getMudletHomeDir()) + local backups = configurationDirectory .. "/moduleBackups" + if fileExists(backups) then + for entry in lfs.dir(backups) do + if entry:find("mudlet%-spec%-") then + os.remove(backups .. "/" .. entry) + end + end + end + + -- Let the profile save that the last uninstall queued run while the profile + -- is still up: it dereferences the profile when it fires, and Mudlet may be + -- shutting down by the time it would otherwise get its turn. + pumpEventLoop(1500) + end) +end) diff --git a/src/mudlet-lua/tests/fixtures/packages/README.md b/src/mudlet-lua/tests/fixtures/packages/README.md new file mode 100644 index 000000000..5a4b8f018 --- /dev/null +++ b/src/mudlet-lua/tests/fixtures/packages/README.md @@ -0,0 +1,32 @@ +# Package fixtures + +Fixture packages and modules for `Package_spec.lua`. They are deliberately tiny +(the largest archive is about 1 KB) and every one of them is named +`mudlet-spec-*` so anything they leave behind is obviously test-owned. + +`sources/` holds the readable source of each fixture; the `.mpackage` files next +to this README are those directories zipped up. `.mpackage` files are zip +archives, so never edit one in place - change the source and rebuild: + +```sh +./build-fixtures.sh +``` + +The archives are committed instead of being zipped when the specs run because +busted runs on every platform Mudlet builds on and a `zip` tool is not there on +all of them. `build-fixtures.sh` forces the timestamps and passes `-X`, so +rebuilding unchanged sources with Info-ZIP reproduces the committed archives +byte for byte; another zip implementation may well write different bytes for the +same contents, which is harmless as long as the archives are only rebuilt +deliberately. + +| fixture | what it is for | +| --- | --- | +| `mudlet-spec-minimal` | valid package: `config.lua`, one alias, one script | +| `mudlet-spec-resources` | valid package that also ships a `resources/` folder with a nested subfolder | +| `mudlet-spec-module` | installed as a module; its script counts its own compiles so a reload is observable | +| `mudlet-spec-selfuninstall` | package whose event handler uninstalls its own package (regression #9557) | +| `mudlet-spec-noconfig` | archive with a package XML but no `config.lua`, so the name comes from the file name | +| `mudlet-spec-emptyarchive` | archive with neither `config.lua` nor a package XML | +| `mudlet-spec-notazip.mpackage` | not a zip archive at all, for the unpacking error path | +| `sources/mudlet-spec-xmlonly` | bare package XML, installed without any archive around it | diff --git a/src/mudlet-lua/tests/fixtures/packages/build-fixtures.sh b/src/mudlet-lua/tests/fixtures/packages/build-fixtures.sh new file mode 100755 index 000000000..5fba9717a --- /dev/null +++ b/src/mudlet-lua/tests/fixtures/packages/build-fixtures.sh @@ -0,0 +1,35 @@ +#!/bin/sh +# Rebuilds the .mpackage fixtures used by Package_spec.lua from the directories +# under sources/. Run it after editing any fixture source, then commit both the +# source and the rebuilt archive. +# +# The archives are committed rather than zipped at spec runtime so the specs do +# not depend on a zip tool being installed on every platform CI runs busted on. +# Each fixture is staged in a temporary folder where the timestamps are forced, +# and -X drops the platform-specific extra fields, so rebuilding from unchanged +# sources produces a byte-identical archive without disturbing the sources. +set -eu + +cd "$(dirname "$0")" +outputDirectory=$(pwd) + +command -v zip >/dev/null 2>&1 || { echo "zip is not installed" >&2; exit 1; } + +# Any fixed date does; this one is the day the fixture kit was added. +timestamp=202608040000.00 + +for source in sources/*/; do + name=$(basename "$source") + # mudlet-spec-xmlonly is installed straight from its .xml file, it has no archive + if [ "$name" = "mudlet-spec-xmlonly" ]; then + continue + fi + archive="$outputDirectory/$name.mpackage" + staging=$(mktemp -d) + cp -R "$source." "$staging" + find "$staging" -exec touch -t "$timestamp" {} + + rm -f "$archive" + (cd "$staging" && zip -q -r -X -9 "$archive" .) + rm -rf "$staging" + echo "built $name.mpackage" +done diff --git a/src/mudlet-lua/tests/fixtures/packages/mudlet-spec-emptyarchive.mpackage b/src/mudlet-lua/tests/fixtures/packages/mudlet-spec-emptyarchive.mpackage new file mode 100644 index 0000000000000000000000000000000000000000..8c781b7087e5b91690f55f67ba08912b8ad7aaf7 GIT binary patch literal 184 zcmWIWW@Zs#U}E54U|?X071<;6#RK!mI5|HrEi+v&r!>*F&ztX%0gub~IfvL6 zh{`l5hiq7{m7c$lnkks4=zmikR5-4+|9yKD%eBS*%K5DxX{TZ&!7A;KAOahZ1F9ZpDXe4DorU z(q6^S@oU#@zF9-Sa)~e^v$A-FY=7=RoBawMEUR?Nk$% zgl0_Yu+u%hSKF%R_MbP;K34rS+O2wdtC!+z&Y!A6CtBU^WL%NIu;cC{?{-h7bwwK{ zIM+^)T&nTM|N1pM#|!-_ZPFbt_-xJ|-smg3qeCj%-sBlXg+*DDY)wJ7veyeh^Q1_`|+w72c3D+Gy>Bw|_7kL$+ zwnAiv*T8bK^XazfXK9&;eo5PkcBEFAF| T;LXYgQpf~^wLsdQ3B&^cHZK{S literal 0 HcmV?d00001 diff --git a/src/mudlet-lua/tests/fixtures/packages/mudlet-spec-module.mpackage b/src/mudlet-lua/tests/fixtures/packages/mudlet-spec-module.mpackage new file mode 100644 index 0000000000000000000000000000000000000000..5b7b220f048cd0a31b8df07fd06c61b25f85393a GIT binary patch literal 723 zcmWIWW@Zs#U}E54U|?X0<(}0y-HVZdftQ(qK@2F8Tbh!STB2KAkeaNUo1apeld4yd zn=^G%toLC9k+${Q;{}_=rHwYR?mlw{T7jrjW?fmNOEoWMra*qB` z_g?6+$%;Nj1&nS4(&-d&0Ha9Gp|IsH;@lf@L9URZYI12>L zw&leA;JGaDdc%yHzcPYK!iDM-jqS8)O#Ym{8RFZUIzoU1CK zn*W`*>Xk*dg|2#~w!*&8D&gg~$`ifrf>M80M7JMvE@@NCUA2LAvM$#wt~+bLMDEyd zV8c4wubUg6uzk~&^FQPHZP^0P6vbAC;PjeQ6?Z=`tNA~<15iTW_RggI*}zc055!zR zoSdJRmYJ@XQ<`YnW5{>NfXB7m?;-OAua23WJB6x46}K0zbPaOf7;Isesik)M|KIP< zM_%^oH%Wh~J#lWbsZ?fG(~dWp5`HssCx%ppTS}~KOxq?aJ=^}xIw^zC*Ne2ad-Ny& z*{Q$HF8O8tlqsoek8RyM<;X<8&c%N(?|yPsMC@n788_{MpM6|9D-428s&P)V-D$jn z!AVK~MT2Nch?jKVyjz?8G6#4wGRZOHPC`I`FaT2&!Hv>H&Ksq62)B!0( UumpIsvVr87fUpKgJ2HWI02cTZ<^TWy literal 0 HcmV?d00001 diff --git a/src/mudlet-lua/tests/fixtures/packages/mudlet-spec-noconfig.mpackage b/src/mudlet-lua/tests/fixtures/packages/mudlet-spec-noconfig.mpackage new file mode 100644 index 0000000000000000000000000000000000000000..900af3d6c135e1a6bf7717b882b0904225ba25e0 GIT binary patch literal 414 zcmWIWW@Zs#U}E54U|?X0t$e@m8V@4_gBlY9g9K0{w=^XuwM4hLAT?PxFF!dyFD)}& zuOc_6G|<=kuz`eK{(dDk{;Cx>^W-k|E#z~&(l}e8Ltt|G$D?YRp0c<1Z}$w3Tz&6T z&7OGwA35n>n^@&9+??a5uQsJ&s^7w^ma*%_ZmP}|O|C2YTd}n&^4^5s`k_vHMLq>* zWVFb=Go9s=X(;z`s{7i5<$TjDOqkQ+7IE0ey0bSW%s4HzeZpm1mRko}wMBo-i4vb} zZl}#7qNY2sl`AD}Zb@15td1Lvn^QclDcFXUGJZNd_u_x=6Ku9C!oAO1T2EP0^s+}V zOmt4^dYACGm-q{L(vNGLlrwqLwSE7wxkcAjeT#<=;=AZ#s~54~V&dI5|HrEi+v&r!>*F&yeqs0gr3B-$U*# z%tFfA(!$AC6}|2p%bMk~t@*`U!`4l8|G)3M{_4-8v=(ii!?&EA-Y!}6USg@qH;u;? zMZU=o_ZHpPUZBBs$>ZWVuUY$=r1x$yJf!%wuX3?XbMt=wWs{gT75b+voK*hlPP`7M z#=MoUCfX^5HpUcvzdcuDrehbUef%v4Hu;PC3k1zQ^wo%J$97YoGAkffz^1&oAT?PRqE)Y? zqQvyXPEG~|0hR-Iw6-yJ3+1yO?5{rXsdr96+KC0})@vd&t+!md@at>9BmQ4b2Nzkg z=JGFG#tw2J!pg5pm3WkaR;dHAIEs}JyYfp?K{lP%^*!mSdr?=2Kss* zHjuE(-><~RU$x?9p4_FLg?x@z8fPnX2u!~ID{1nSCDOO|Z}$w3TwQVc^T#^dhnweW zo)oKbNH4b9J0pN8%(8deiI-JdPw2h$>G^r`>*K4hQY)R`neS?;(!4rdXMteVj_Vml zOOtFKY4^J_?knDKWTB+NXQ9*|FRiQuSPsWr-O)Pdo#F*Hy_l5;pI_N^W6#IPOotg; zT*R~jX0|^ti*r;k+V()la+0}5f2giQ?JnbA{=7dO_y;8%QY|5Q1z|Wd`v8>lK6} literal 0 HcmV?d00001 diff --git a/src/mudlet-lua/tests/fixtures/packages/mudlet-spec-selfuninstall.mpackage b/src/mudlet-lua/tests/fixtures/packages/mudlet-spec-selfuninstall.mpackage new file mode 100644 index 0000000000000000000000000000000000000000..9ca2f1de18d99b321ca0d9b29d20c50225b9121a GIT binary patch literal 742 zcmWIWW@Zs#U}E54U|?X0JsRz?W+{;M8;H4pI5|HrEi+v&r!>*^oFU&K10L23bAuz2 z8W(c3aT#vdv~fe2?4m1~N|%;wntSM@C$sMC)cU>e6GMKjtZLCVIXl6sKj>q}uB0z& ztl|+_M9jTu<_vHEl+k+FNw(naGkdc^m_3Za| zcXvPkJhR`v*f%U;jh4Zp#itcj8!{C|(*$GBs6P~yJ7(=3Kj+NjA^ovx>j|Y&n1FhRughEMJ>1 zt)Klx?PTS{e+mlAHT0Q0U9^ImA79bkwKr+LS?I#j)P<#`)@-sY4U;yn6@JeZ)^K&( z^X5&wug-)WvwgPmv~{Q2d(|8MQgc*y>+LuG$a0D4>HM>MmFx3<@qT>3`!9Lf+rs_V z|HxgNd$eBEt+SlBeYJgP5Yslv+X6Su)zaPVzi|h6Gcw6B<4#V%NMHa)2*Z{}5DSsG h(Dk9m97r`p-&r6FZ#)Kgv$BDdGXY^UkoIK)@c{Mu9FG71 literal 0 HcmV?d00001 diff --git a/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-emptyarchive/readme.txt b/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-emptyarchive/readme.txt new file mode 100644 index 000000000..5a72b6929 --- /dev/null +++ b/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-emptyarchive/readme.txt @@ -0,0 +1 @@ +This archive deliberately contains no config.lua and no package XML. diff --git a/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-minimal/config.lua b/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-minimal/config.lua new file mode 100644 index 000000000..758af6909 --- /dev/null +++ b/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-minimal/config.lua @@ -0,0 +1,5 @@ +mpackage = [[mudlet-spec-minimal]] +author = [[Mudlet test suite]] +title = [[Minimal fixture package for Package_spec.lua]] +version = [[1.0]] +description = [[One alias and one script, just enough to prove a package installed.]] diff --git a/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-minimal/mudlet-spec-minimal.xml b/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-minimal/mudlet-spec-minimal.xml new file mode 100644 index 000000000..64747854c --- /dev/null +++ b/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-minimal/mudlet-spec-minimal.xml @@ -0,0 +1,28 @@ + + + + + + + + mudlet-spec-minimal alias + + + + ^mudlet-spec-minimal$ + + + + + + + + + + + + + diff --git a/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-module/config.lua b/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-module/config.lua new file mode 100644 index 000000000..97432d624 --- /dev/null +++ b/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-module/config.lua @@ -0,0 +1,5 @@ +mpackage = [[mudlet-spec-module]] +author = [[Mudlet test suite]] +title = [[Module fixture for Package_spec.lua]] +version = [[3.1]] +description = [[Counts how often its script has been compiled, so a reload is observable.]] diff --git a/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-module/mudlet-spec-module.xml b/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-module/mudlet-spec-module.xml new file mode 100644 index 000000000..7d468ccdc --- /dev/null +++ b/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-module/mudlet-spec-module.xml @@ -0,0 +1,28 @@ + + + + + + + + mudlet-spec-module alias + + + + ^mudlet-spec-module$ + + + + + + + + + + + + + diff --git a/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-noconfig/mudlet-spec-noconfig.xml b/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-noconfig/mudlet-spec-noconfig.xml new file mode 100644 index 000000000..5c86cfe70 --- /dev/null +++ b/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-noconfig/mudlet-spec-noconfig.xml @@ -0,0 +1,21 @@ + + + + + + + + mudlet-spec-noconfig alias + + + + ^mudlet-spec-noconfig$ + + + + + + + + + diff --git a/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-resources/config.lua b/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-resources/config.lua new file mode 100644 index 000000000..697af8a8c --- /dev/null +++ b/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-resources/config.lua @@ -0,0 +1,5 @@ +mpackage = [[mudlet-spec-resources]] +author = [[Mudlet test suite]] +title = [[Fixture package carrying a resources folder]] +version = [[2.5]] +description = [[Ships non-Mudlet files so a spec can check they land on disk.]] diff --git a/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-resources/mudlet-spec-resources.xml b/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-resources/mudlet-spec-resources.xml new file mode 100644 index 000000000..cb626db04 --- /dev/null +++ b/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-resources/mudlet-spec-resources.xml @@ -0,0 +1,21 @@ + + + + + + + + mudlet-spec-resources alias + + + + ^mudlet-spec-resources$ + + + + + + + + + diff --git a/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-resources/resources/nested/spec-nested.txt b/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-resources/resources/nested/spec-nested.txt new file mode 100644 index 000000000..ab103dae8 --- /dev/null +++ b/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-resources/resources/nested/spec-nested.txt @@ -0,0 +1 @@ +mudlet-spec-resources fixture resource in a nested folder diff --git a/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-resources/resources/spec-note.txt b/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-resources/resources/spec-note.txt new file mode 100644 index 000000000..de086e889 --- /dev/null +++ b/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-resources/resources/spec-note.txt @@ -0,0 +1 @@ +mudlet-spec-resources fixture resource diff --git a/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-selfuninstall/config.lua b/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-selfuninstall/config.lua new file mode 100644 index 000000000..0d0523406 --- /dev/null +++ b/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-selfuninstall/config.lua @@ -0,0 +1,5 @@ +mpackage = [[mudlet-spec-selfuninstall]] +author = [[Mudlet test suite]] +title = [[Fixture package that uninstalls itself from its own event handler]] +version = [[1.0]] +description = [[Regression fixture for the package self-uninstall crash (#9557).]] diff --git a/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-selfuninstall/mudlet-spec-selfuninstall.xml b/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-selfuninstall/mudlet-spec-selfuninstall.xml new file mode 100644 index 000000000..c05a5b280 --- /dev/null +++ b/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-selfuninstall/mudlet-spec-selfuninstall.xml @@ -0,0 +1,35 @@ + + + + + + + + + + + mudletSpecSelfUninstall + + + + + mudletSpecSelfUninstall + + + + + + + + diff --git a/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-xmlonly/mudlet-spec-xmlonly.xml b/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-xmlonly/mudlet-spec-xmlonly.xml new file mode 100644 index 000000000..2abefa354 --- /dev/null +++ b/src/mudlet-lua/tests/fixtures/packages/sources/mudlet-spec-xmlonly/mudlet-spec-xmlonly.xml @@ -0,0 +1,21 @@ + + + + + + + + mudlet-spec-xmlonly alias + + + + ^mudlet-spec-xmlonly$ + + + + + + + + + From c5df316ab953c85cdedfae479ddae3532a26349e Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Tue, 4 Aug 2026 21:57:29 +0200 Subject: [PATCH 082/155] infrastructure: busted specs for the Geyser widget classes with no spec home (#9665) #### Brief overview of PR changes/additions - Adds the four Geyser per-class spec files - `GeyserCommandLine_spec.lua`, `GeyserUserWindow_spec.lua`, `GeyserMapper_spec.lua` and `GeyserScrollBox_spec.lua` - covering the widget classes that had no spec home, in the same one-spec-per-class layout as the existing Geyser specs. - 83 specs over 15 testability-checklist rows, asserting real widget state through `windowType`/`windowVisible`/`getWindowGeometry`/`getUserWindowSize`/`getCmdLine` and the map widget's own return values, not just that a call did not error. - 17 pendings. Six wait on getters a sibling PR is adding right now (`getUserWindowTitle`, `getUserWindowStyleSheet`, `getMapWindowTitle`, `getCmdLineStyleSheet`, a user window scroll bar getter, a command line selection getter) and will flip in a small follow-up; the rest are functional-only surface or defects found on the way, named rather than frozen into a passing assertion. #### Motivation for adding to Mudlet These four classes had no coverage at all: `UI_spec` exercised only the raw `createCommandLine`/`createScrollBox`/`openUserWindow` primitives underneath them, so every Geyser wrapper on top was untested. Writing the specs turned up four defects, each left pending with the cause named: a scroll box built inside a hidden `add2` container comes up visible because `Geyser.ScrollBox:new` is the one widget constructor that never re-hides itself; `Geyser.UserWindow:show()` drops the `auto` flag, so a hidden user window reappears when its container is shown; deleting a user window leaks the `Container` root container Geyser made for it; and `selectCmdLineText` returns the window name instead of a result. #### Other info (issues closed, discussion etc) `GeyserMapper_spec` is now the first file alphabetically to open the map widget, which is a one way door for a profile. Nothing fails, but `Mapper_spec`'s opening block loses its "registered before the widget was opened" premise; the header comment records this, and restoring that coverage means moving the block into an earlier sorting file, which is out of scope here. **Test case:** full busted suite 1912 successes / 0 failures / 0 errors / 34 pending (from 1829/0/0/17), identical across three runs on one profile plus a fresh one; seven sabotage rounds breaking the geyser methods under test failed 41 of the 83 new specs. Assisted-by: Claude:claude-opus-5 --- .../tests/GeyserCommandLine_spec.lua | 217 ++++++++++ src/mudlet-lua/tests/GeyserMapper_spec.lua | 277 ++++++++++++ src/mudlet-lua/tests/GeyserScrollBox_spec.lua | 232 ++++++++++ .../tests/GeyserUserWindow_spec.lua | 396 ++++++++++++++++++ 4 files changed, 1122 insertions(+) create mode 100644 src/mudlet-lua/tests/GeyserCommandLine_spec.lua create mode 100644 src/mudlet-lua/tests/GeyserMapper_spec.lua create mode 100644 src/mudlet-lua/tests/GeyserScrollBox_spec.lua create mode 100644 src/mudlet-lua/tests/GeyserUserWindow_spec.lua diff --git a/src/mudlet-lua/tests/GeyserCommandLine_spec.lua b/src/mudlet-lua/tests/GeyserCommandLine_spec.lua new file mode 100644 index 000000000..f5cf6c9e5 --- /dev/null +++ b/src/mudlet-lua/tests/GeyserCommandLine_spec.lua @@ -0,0 +1,217 @@ +-- Geyser.CommandLine wraps Mudlet's sub-command-line primitive, so everything +-- it does is read back through windowType/getWindowGeometry/windowVisible and +-- getCmdLine rather than through the Geyser object's own bookkeeping. +local function geometry(name) + local x, y, width, height = getWindowGeometry(name) + return {x = x, y = y, width = width, height = height} +end + +describe("Tests functionality of Geyser.CommandLine", function() + local created + + local function track(object) + created[#created + 1] = object + return object + end + + local function alive(object) + if not object or not object.container or not object.container.windowList then + return false + end + return object.container.windowList[object.name] == object + end + + before_each(function() + created = {} + end) + + after_each(function() + for _, object in ipairs(created) do + if alive(object) then + object:delete() + end + end + created = {} + end) + + describe("Geyser.CommandLine:new/new2", function() + it("creates a command line widget at the constrained geometry", function() + local commandLine = track(Geyser.CommandLine:new({name = "gclNew", x = 30, y = 40, width = 200, height = 30})) + -- Geyser's own type string is camel cased, Mudlet's windowType is not + assert.are.equal("commandLine", commandLine.type) + assert.are.equal("commandline", windowType("gclNew")) + assert.are.same({x = 30, y = 40, width = 200, height = 30}, geometry("gclNew")) + assert.is_true(windowVisible("gclNew")) + assert.are.equal(commandLine, Geyser.windowList.gclNew) + assert.are.equal("main", commandLine.windowname) + end) + + it("uses Geyser's defaults when no constraints are given", function() + track(Geyser.CommandLine:new({name = "gclDefaults"})) + assert.are.same({x = 10, y = 10, width = 300, height = 200}, geometry("gclDefaults")) + end) + + it("resolves percentages against its container", function() + local container = track(Geyser.Container:new({name = "gclBox", x = 100, y = 50, width = 400, height = 200})) + track(Geyser.CommandLine:new({name = "gclInBox", x = "25%", y = "50%", width = "50%", height = "25%"}, container)) + assert.are.same({x = 200, y = 150, width = 200, height = 50}, geometry("gclInBox")) + end) + + it("new2 marks the command line as using add2", function() + local commandLine = track(Geyser.CommandLine:new2({name = "gclNew2", x = 0, y = 0, width = 100, height = 30})) + assert.is_true(commandLine.useAdd2) + assert.are.equal("commandline", windowType("gclNew2")) + end) + + it("keeps a new command line of a hidden add2 container hidden", function() + local container = track(Geyser.Container:new2({name = "gclHiddenBox", x = 0, y = 0, width = 200, height = 100})) + container:hide() + local commandLine = track(Geyser.CommandLine:new2({name = "gclHiddenChild", x = 0, y = 0, width = 50, height = 20}, container)) + assert.is_true(commandLine.auto_hidden) + assert.is_false(windowVisible("gclHiddenChild")) + container:show() + assert.is_true(windowVisible("gclHiddenChild")) + end) + end) + + describe("Geyser.CommandLine:print/append/getText/clear", function() + local commandLine + + before_each(function() + commandLine = track(Geyser.CommandLine:new({name = "gclText", x = 0, y = 0, width = 200, height = 30})) + end) + + it("prints text into the command line", function() + commandLine:print("hello") + assert.are.equal("hello", commandLine:getText()) + assert.are.equal("hello", getCmdLine("gclText")) + end) + + it("replaces what was there on the next print", function() + commandLine:print("first") + commandLine:print("second") + assert.are.equal("second", commandLine:getText()) + end) + + it("appends to the text already in the command line", function() + commandLine:print("hello") + commandLine:append(" world") + assert.are.equal("hello world", commandLine:getText()) + end) + + it("appends into an empty command line", function() + commandLine:append("only") + assert.are.equal("only", commandLine:getText()) + end) + + it("clears the command line", function() + commandLine:print("something") + commandLine:clear() + assert.are.equal("", commandLine:getText()) + assert.are.equal("", getCmdLine("gclText")) + end) + end) + + -- Two things are in the way. The selection itself has no getter; and + -- selectCmdLineText (TLuaInterpreterUI.cpp) declares one return value without + -- pushing one, so it hands back whatever was left on the Lua stack - the + -- window name it was passed - rather than a result. Asserting either of those + -- as they stand would freeze the defect in place. + pending("Geyser.CommandLine:selectText selects every character - the selection is not readable from Lua and needs a getCmdLineSelection getter, and selectCmdLineText returns the window name instead of a result") + + describe("Geyser.CommandLine:setStyleSheet", function() + it("reuses the remembered stylesheet when called without one", function() + local commandLine = track(Geyser.CommandLine:new({name = "gclCss", x = 0, y = 0, width = 100, height = 30})) + commandLine:setStyleSheet("background-color: red;") + assert.are.equal("background-color: red;", commandLine.stylesheet) + commandLine:setStyleSheet() + assert.are.equal("background-color: red;", commandLine.stylesheet) + end) + end) + + pending("Geyser.CommandLine:setStyleSheet applies the stylesheet to the widget - needs a getCmdLineStyleSheet getter") + + describe("Geyser.CommandLine:setAction/resetAction", function() + it("remembers the action and its arguments, and forgets them again", function() + local commandLine = track(Geyser.CommandLine:new({name = "gclAction", x = 0, y = 0, width = 100, height = 30})) + local action = function() end + commandLine:setAction(action, "one", "two") + assert.are.equal(action, commandLine.actionFunc) + assert.are.same({"one", "two"}, commandLine.actionArgs) + commandLine:resetAction() + assert.is_nil(commandLine.actionFunc) + assert.is_nil(commandLine.actionArgs) + end) + end) + + pending("Geyser.CommandLine:setAction runs the action when the command line sends its text - no Lua API submits input to a command line, so this needs a functional test") + + describe("Geyser.CommandLine geometry and visibility", function() + local commandLine + + before_each(function() + commandLine = track(Geyser.CommandLine:new({name = "gclMove", x = 10, y = 20, width = 200, height = 30})) + end) + + it("moves and resizes the widget", function() + commandLine:move(60, 70) + commandLine:resize(120, 40) + assert.are.same({x = 60, y = 70, width = 120, height = 40}, geometry("gclMove")) + end) + + it("hides and shows the widget", function() + commandLine:hide() + assert.is_true(commandLine.hidden) + assert.is_false(windowVisible("gclMove")) + commandLine:show() + assert.is_false(commandLine.hidden) + assert.is_true(windowVisible("gclMove")) + end) + + it("follows its container when the container moves", function() + local container = track(Geyser.Container:new({name = "gclDragBox", x = 0, y = 0, width = 200, height = 100})) + track(Geyser.CommandLine:new({name = "gclDragged", x = 0, y = 0, width = "100%", height = 30}, container)) + container:move(150, 30) + assert.are.same({x = 150, y = 30, width = 200, height = 30}, geometry("gclDragged")) + end) + end) + + describe("Geyser.CommandLine error paths", function() + it("raises on a constraint it cannot parse, leaving no widget behind", function() + -- the object is registered before its constraints are resolved, so the + -- failed attempt has to be swept out of the root window list by hand + finally(function() + local zombie = Geyser.windowList.gclBadConstraint + if zombie then + zombie:delete() + end + end) + local ok, message = pcall(function() + return Geyser.CommandLine:new({name = "gclBadConstraint", x = 0, y = 0, width = true, height = 20}) + end) + assert.is_false(ok) + assert.is_truthy(tostring(message):find("GeyserSetConstraints.lua", 1, true)) + assert.is_nil(windowType("gclBadConstraint")) + end) + + it("raises when printing something that is not text, leaving the text alone", function() + local commandLine = track(Geyser.CommandLine:new({name = "gclBadPrint", x = 0, y = 0, width = 100, height = 30})) + commandLine:print("kept") + local ok, message = pcall(function() commandLine:print(nil) end) + assert.is_false(ok) + assert.is_truthy(tostring(message):find("printCmdLine", 1, true)) + assert.are.equal("kept", commandLine:getText()) + end) + end) + + describe("Geyser.CommandLine:type_delete", function() + it("deletes the widget with the object", function() + local commandLine = track(Geyser.CommandLine:new({name = "gclDelete", x = 0, y = 0, width = 100, height = 30})) + assert.are.equal("commandline", windowType("gclDelete")) + commandLine:delete() + assert.is_nil(windowType("gclDelete")) + assert.is_nil(getWindowGeometry("gclDelete")) + assert.is_nil(Geyser.windowList.gclDelete) + end) + end) +end) diff --git a/src/mudlet-lua/tests/GeyserMapper_spec.lua b/src/mudlet-lua/tests/GeyserMapper_spec.lua new file mode 100644 index 000000000..08d04f528 --- /dev/null +++ b/src/mudlet-lua/tests/GeyserMapper_spec.lua @@ -0,0 +1,277 @@ +-- Geyser.Mapper drives Mudlet's one map per profile. The dockable map widget +-- has no window name of its own, so windowType/getWindowGeometry cannot see it; +-- what is observable is the Geyser object's resolved constraints plus +-- closeMapWidget(), which reports "map widget already closed" when the widget +-- is not on screen and so doubles as a visibility probe. +-- +-- Every mapper here is created with embedded = false or a dock position, which +-- is the map widget rather than a mapper drawn into the main console: see the +-- pending below for why the embedded form cannot be exercised in this suite. +-- +-- Opening the map widget is a one way door for the profile - Host::closeMapWidget +-- only hides it - and busted runs its files in sorted order, so this file is +-- now the first to open it, ahead of Mapper_spec.lua. That costs Mapper_spec's +-- opening block its "registered before the widget was opened" premise; nothing +-- there fails, but the deferred registration path it meant to cover is no +-- longer reached from here on. Restoring it means moving that block into an +-- earlier sorting file of its own. + +-- Reports whether the map widget is currently on screen, without leaving it in +-- a different state than it was found in. +local function mapWidgetVisible() + local closed = closeMapWidget() + if closed then + assert.is_true(openMapWidget(), "could not put the map widget back after probing it") + return true + end + return false +end + +describe("Tests functionality of Geyser.Mapper", function() + local created + + local function track(object) + created[#created + 1] = object + return object + end + + local function alive(object) + if not object or not object.container or not object.container.windowList then + return false + end + return object.container.windowList[object.name] == object + end + + before_each(function() + created = {} + end) + + -- The map widget outlives every mapper object, so put it away again rather + -- than leaving it over the specs that run after this file. + after_each(function() + for _, object in ipairs(created) do + if alive(object) then + object:delete() + end + end + created = {} + closeMapWidget() + end) + + describe("Geyser.Mapper:new/new2", function() + it("registers a mapper that has no addressable widget of its own", function() + local mapper = track(Geyser.Mapper:new({name = "gmpNew", x = 10, y = 20, width = 300, height = 200, embedded = false})) + assert.are.equal("mapper", mapper.type) + assert.are.equal(mapper, Geyser.windowList.gmpNew) + -- the map lives in a dock widget Mudlet does not name, so the window + -- getters cannot reach it + assert.is_nil(windowType("gmpNew")) + local found, message = getWindowGeometry("gmpNew") + assert.is_nil(found) + assert.is_truthy(message:find("gmpNew", 1, true)) + end) + + it("opens the map widget", function() + track(Geyser.Mapper:new({name = "gmpOpen", x = 10, y = 20, width = 300, height = 200, embedded = false})) + assert.is_true(mapWidgetVisible()) + end) + + it("resolves its constraints like any other Geyser window", function() + local mapper = track(Geyser.Mapper:new({name = "gmpPixels", x = 10, y = 20, width = 300, height = 200, embedded = false})) + assert.are.equal(10, mapper:get_x()) + assert.are.equal(20, mapper:get_y()) + assert.are.equal(300, mapper:get_width()) + assert.are.equal(200, mapper:get_height()) + end) + + it("resolves percentages against its container", function() + local container = track(Geyser.Container:new({name = "gmpBox", x = 100, y = 50, width = 400, height = 200})) + local mapper = track(Geyser.Mapper:new({name = "gmpInBox", x = "25%", y = "50%", width = "50%", height = "50%", embedded = false}, container)) + assert.are.equal(200, mapper:get_x()) + assert.are.equal(150, mapper:get_y()) + assert.are.equal(200, mapper:get_width()) + assert.are.equal(100, mapper:get_height()) + end) + + it("treats a mapper given a dock position as not embedded", function() + local mapper = track(Geyser.Mapper:new({name = "gmpDocked", x = 0, y = 0, width = 200, height = 150, dockPosition = "right"})) + assert.is_false(mapper.embedded) + assert.are.equal("right", mapper.dockPosition) + end) + + it("shortens a floating dock position to f", function() + local mapper = track(Geyser.Mapper:new({name = "gmpFloating", x = 0, y = 0, width = 200, height = 150, dockPosition = "floating"})) + assert.is_false(mapper.embedded) + assert.are.equal("f", mapper.dockPosition) + end) + + it("new2 marks the mapper as using add2", function() + local mapper = track(Geyser.Mapper:new2({name = "gmpNew2", x = 0, y = 0, width = 200, height = 150, embedded = false})) + assert.is_true(mapper.useAdd2) + assert.are.equal("mapper", mapper.type) + end) + end) + + describe("Geyser.Mapper:move/resize", function() + local mapper + + before_each(function() + mapper = track(Geyser.Mapper:new({name = "gmpMove", x = 10, y = 20, width = 300, height = 200, embedded = false})) + end) + + it("takes the new constraints and resolves them", function() + mapper:move(60, 70) + assert.are.equal("60px", mapper.x) + assert.are.equal("70px", mapper.y) + assert.are.equal(60, mapper:get_x()) + assert.are.equal(70, mapper:get_y()) + mapper:resize(150, 100) + assert.are.equal("150px", mapper.width) + assert.are.equal(150, mapper:get_width()) + assert.are.equal(100, mapper:get_height()) + end) + + it("refuses to move or resize while it is hidden", function() + mapper:hide() + mapper:move(200, 210) + mapper:resize(50, 60) + assert.are.equal("10px", mapper.x) + assert.are.equal("20px", mapper.y) + assert.are.equal(10, mapper:get_x()) + assert.are.equal(300, mapper:get_width()) + assert.are.equal(200, mapper:get_height()) + end) + end) + + describe("Geyser.Mapper:hide/show", function() + it("closes and reopens the map widget", function() + local mapper = track(Geyser.Mapper:new({name = "gmpHide", x = 10, y = 20, width = 300, height = 200, embedded = false})) + assert.is_true(mapWidgetVisible()) + mapper:hide() + assert.is_true(mapper.hidden) + assert.is_false(mapWidgetVisible()) + mapper:show() + assert.is_false(mapper.hidden) + assert.is_true(mapWidgetVisible()) + end) + + it("reports that a closed map widget is already closed", function() + local mapper = track(Geyser.Mapper:new({name = "gmpClosed", x = 10, y = 20, width = 300, height = 200, embedded = false})) + mapper:hide() + local closed, message = closeMapWidget() + assert.is_nil(closed) + assert.is_truthy(message:find("already closed", 1, true)) + end) + end) + + describe("Geyser.Mapper:setDockPosition", function() + it("puts a closed map widget back on screen", function() + local mapper = track(Geyser.Mapper:new({name = "gmpDockOpen", x = 10, y = 20, width = 300, height = 200, embedded = false})) + mapper:hide() + assert.is_false(mapWidgetVisible()) + assert.is_true(mapper:setDockPosition("f")) + assert.is_true(mapWidgetVisible()) + end) + + it("refuses a dock position that is not one of the five", function() + local mapper = track(Geyser.Mapper:new({name = "gmpDockBad", x = 10, y = 20, width = 300, height = 200, embedded = false})) + local result, message = mapper:setDockPosition("nonsense") + assert.is_nil(result) + assert.is_string(message) + assert.is_truthy(message:find("not available", 1, true)) + -- refusing is not fatal, the widget stays where it was + assert.is_true(mapWidgetVisible()) + end) + end) + + describe("Geyser.Mapper:reposition", function() + it("leaves the map widget alone when the main window is resized", function() + local mapper = track(Geyser.Mapper:new({name = "gmpReposition", x = 10, y = 20, width = 300, height = 200, embedded = false})) + local mainWidth, mainHeight = getMainWindowSize() + -- a mapper has no window for moveWindow/resizeWindow to act on, which is + -- why it overrides reposition to do nothing unless it is embedded. This + -- is a regression guard: the constraints cannot move today, so the + -- load-bearing assertion is that the widget is still on screen after. + GeyserReposition("sysWindowResizeEvent", mainWidth, mainHeight) + assert.are.equal(10, mapper:get_x()) + assert.are.equal(20, mapper:get_y()) + assert.are.equal(300, mapper:get_width()) + assert.are.equal(200, mapper:get_height()) + assert.is_true(mapWidgetVisible()) + end) + end) + + describe("Geyser.Mapper:setTitle/resetTitle", function() + it("remembers the title it was given, and empties it again on reset", function() + local mapper = track(Geyser.Mapper:new({ + name = "gmpTitle", + x = 10, y = 20, width = 300, height = 200, + embedded = false, + titleText = "My map", + })) + assert.are.equal("My map", mapper.titleText) + -- setMapWindowTitle answers nil and a message rather than raising when + -- there is no map window, so the return value is what says the title + -- reached one; without it titleText alone would look right regardless + assert.is_true(mapper:setTitle("Renamed")) + assert.are.equal("Renamed", mapper.titleText) + assert.is_true(mapper:resetTitle()) + assert.are.equal("", mapper.titleText) + end) + + it("starts with an empty title when it was not given one", function() + local mapper = track(Geyser.Mapper:new({name = "gmpNoTitle", x = 10, y = 20, width = 300, height = 200, embedded = false})) + assert.are.equal("", mapper.titleText) + end) + end) + + pending("Geyser.Mapper:setTitle/resetTitle put the text on the map window's title bar - needs a getMapWindowTitle getter") + + pending("Geyser.Mapper:setDockPosition docks the map widget against the edge it names - which edge it ended up on is not readable from Lua") + + pending("Geyser.Mapper:raise/lower stack the map against the other windows - Mudlet exposes no z-order readback") + + -- An embedded mapper and the dockable map widget are mutually exclusive for + -- the life of a profile (TMainConsole::createMapper and Host::openMapWidget + -- each refuse when the other one exists), and neither can be destroyed once + -- made. Creating an embedded mapper here would take the map widget away from + -- Mapper_spec for the rest of the run. + pending("Geyser.Mapper embedded in the main console - an embedded mapper cannot be undone, so it cannot be created inside this suite") + + describe("Geyser.Mapper:type_delete", function() + it("closes the map widget and unregisters the mapper", function() + local mapper = track(Geyser.Mapper:new({name = "gmpDelete", x = 10, y = 20, width = 300, height = 200, embedded = false})) + assert.is_true(mapWidgetVisible()) + mapper:delete() + assert.is_nil(Geyser.windowList.gmpDelete) + assert.is_false(mapWidgetVisible()) + end) + + it("goes away with the container it was put in", function() + local container = track(Geyser.Container:new({name = "gmpOuter", x = 0, y = 0, width = 300, height = 200})) + local mapper = track(Geyser.Mapper:new({name = "gmpNested", x = 0, y = 0, width = "100%", height = "100%", embedded = false}, container)) + assert.are.equal(mapper, container.windowList.gmpNested) + assert.is_true(mapWidgetVisible()) + container:delete() + -- the widget closing is what says the cascade reached the mapper: + -- Geyser.Container:delete empties its own windowList either way + assert.is_false(mapWidgetVisible()) + assert.is_nil(container.windowList.gmpNested) + end) + + -- A profile has one map, so two Geyser.Mapper objects are two handles on + -- the same widget: deleting either one closes it under the other. That is + -- worth pinning down, because it is the trap a second mapper walks into. + it("closes the one shared map widget even when another mapper still holds it", function() + local first = track(Geyser.Mapper:new({name = "gmpShared", x = 10, y = 20, width = 300, height = 200, embedded = false})) + local second = track(Geyser.Mapper:new({name = "gmpSharing", x = 0, y = 0, width = 200, height = 150, embedded = false})) + assert.is_true(mapWidgetVisible()) + second:delete() + assert.is_false(mapWidgetVisible()) + -- the surviving mapper is untouched as an object, and can reopen the map + assert.are.equal(first, Geyser.windowList.gmpShared) + first:show() + assert.is_true(mapWidgetVisible()) + end) + end) +end) diff --git a/src/mudlet-lua/tests/GeyserScrollBox_spec.lua b/src/mudlet-lua/tests/GeyserScrollBox_spec.lua new file mode 100644 index 000000000..988e76bd3 --- /dev/null +++ b/src/mudlet-lua/tests/GeyserScrollBox_spec.lua @@ -0,0 +1,232 @@ +-- A Geyser.ScrollBox is both a widget in its parent window and a parent window +-- of its own: it swaps its windowname for its own name so that everything added +-- to it is created inside the scroll box. Its children therefore report +-- geometry in the scroll box's coordinate space, not the main window's, which +-- is what lets a child be taller than the box and scroll. +local function geometry(name) + local x, y, width, height = getWindowGeometry(name) + return {x = x, y = y, width = width, height = height} +end + +describe("Tests functionality of Geyser.ScrollBox", function() + local created + + local function track(object) + created[#created + 1] = object + return object + end + + local function alive(object) + if not object or not object.container or not object.container.windowList then + return false + end + return object.container.windowList[object.name] == object + end + + before_each(function() + created = {} + end) + + after_each(function() + for _, object in ipairs(created) do + if alive(object) then + object:delete() + end + end + created = {} + end) + + describe("Geyser.ScrollBox:new/new2", function() + it("creates a scroll box widget at the constrained geometry", function() + local scrollBox = track(Geyser.ScrollBox:new({name = "gsbNew", x = 10, y = 20, width = 200, height = 150})) + -- Geyser's own type string is camel cased, Mudlet's windowType is not + assert.are.equal("scrollBox", scrollBox.type) + assert.are.equal("scrollbox", windowType("gsbNew")) + assert.are.same({x = 10, y = 20, width = 200, height = 150}, geometry("gsbNew")) + assert.is_true(windowVisible("gsbNew")) + assert.are.equal(scrollBox, Geyser.windowList.gsbNew) + end) + + it("becomes a parent window of its own, remembering the one it was made in", function() + local scrollBox = track(Geyser.ScrollBox:new({name = "gsbParent", x = 0, y = 0, width = 100, height = 100})) + assert.are.equal("gsbParent", scrollBox.windowname) + assert.are.equal("main", scrollBox.parentWindowName) + assert.are.equal(scrollBox, Geyser.parentWindows.gsbParent) + end) + + it("reports its own origin as zero so children are placed inside it", function() + local scrollBox = track(Geyser.ScrollBox:new({name = "gsbOrigin", x = 40, y = 60, width = 100, height = 100})) + assert.are.equal(0, scrollBox.get_x()) + assert.are.equal(0, scrollBox.get_y()) + -- the widget itself is still where its constraints put it + assert.are.same({x = 40, y = 60, width = 100, height = 100}, geometry("gsbOrigin")) + end) + + it("uses Geyser's defaults when no constraints are given", function() + track(Geyser.ScrollBox:new({name = "gsbDefaults"})) + assert.are.same({x = 10, y = 10, width = 300, height = 200}, geometry("gsbDefaults")) + end) + + it("resolves percentages against its container", function() + local container = track(Geyser.Container:new({name = "gsbBox", x = 50, y = 60, width = 300, height = 200})) + track(Geyser.ScrollBox:new({name = "gsbInBox", x = "10%", y = "10%", width = "80%", height = "80%"}, container)) + assert.are.same({x = 80, y = 80, width = 240, height = 160}, geometry("gsbInBox")) + end) + + it("new2 marks the scroll box as using add2", function() + local scrollBox = track(Geyser.ScrollBox:new2({name = "gsbNew2", x = 0, y = 0, width = 50, height = 50})) + assert.is_true(scrollBox.useAdd2) + assert.are.equal("scrollbox", windowType("gsbNew2")) + end) + end) + + describe("Geyser.ScrollBox children", function() + local scrollBox + + before_each(function() + scrollBox = track(Geyser.ScrollBox:new({name = "gsbHolder", x = 10, y = 20, width = 200, height = 150})) + end) + + it("places children in its own coordinate space", function() + local console = track(Geyser.MiniConsole:new({name = "gsbConsole", x = "10%", y = "10%", width = "80%", height = "50%"}, scrollBox)) + assert.are.equal("gsbHolder", console.windowname) + -- 10%/10% of the box, not of the main window, and with no 10,20 offset + assert.are.same({x = 20, y = 15, width = 160, height = 75}, geometry("gsbConsole")) + end) + + it("holds a command line as well as a console", function() + track(Geyser.CommandLine:new({name = "gsbCmdLine", x = 0, y = "80%", width = "100%", height = 25}, scrollBox)) + assert.are.equal("commandline", windowType("gsbCmdLine")) + assert.are.same({x = 0, y = 120, width = 200, height = 25}, geometry("gsbCmdLine")) + end) + + it("lets a child be taller than the box, which is what makes it scroll", function() + track(Geyser.Label:new({name = "gsbTall", x = 0, y = 0, width = "100%", height = 2000}, scrollBox)) + assert.are.same({x = 0, y = 0, width = 200, height = 2000}, geometry("gsbTall")) + end) + + it("re-lays its children out when it is resized", function() + track(Geyser.MiniConsole:new({name = "gsbResized", x = "10%", y = "10%", width = "80%", height = "50%"}, scrollBox)) + scrollBox:resize(400, 300) + assert.are.same({x = 10, y = 20, width = 400, height = 300}, geometry("gsbHolder")) + assert.are.same({x = 40, y = 30, width = 320, height = 150}, geometry("gsbResized")) + end) + + it("keeps children where they are when the box itself moves", function() + track(Geyser.Label:new({name = "gsbFollower", x = "50%", y = 0, width = "50%", height = "100%"}, scrollBox)) + assert.are.same({x = 100, y = 0, width = 100, height = 150}, geometry("gsbFollower")) + scrollBox:move(80, 90) + assert.are.same({x = 80, y = 90, width = 200, height = 150}, geometry("gsbHolder")) + -- the child rides along inside the widget, so its own coordinates do not move + assert.are.same({x = 100, y = 0, width = 100, height = 150}, geometry("gsbFollower")) + end) + + it("nests a container of its own inside the scroll box", function() + local inner = track(Geyser.Container:new({name = "gsbInner", x = 0, y = 0, width = "50%", height = "50%"}, scrollBox)) + local label = track(Geyser.Label:new({name = "gsbInnerLabel", x = "50%", y = 0, width = "50%", height = "100%"}, inner)) + assert.are.equal("gsbHolder", label.windowname) + assert.are.same({x = 50, y = 0, width = 50, height = 75}, geometry("gsbInnerLabel")) + end) + + it("nests a scroll box inside a scroll box, each its own parent window", function() + local inner = track(Geyser.ScrollBox:new({name = "gsbNestedBox", x = 10, y = 10, width = "50%", height = "50%"}, scrollBox)) + assert.are.equal("gsbNestedBox", inner.windowname) + assert.are.equal("gsbHolder", inner.parentWindowName) + assert.are.same({x = 10, y = 10, width = 100, height = 75}, geometry("gsbNestedBox")) + -- a child of the inner box is placed in the inner box's own space again + local label = track(Geyser.Label:new({name = "gsbNestedLabel", x = "50%", y = 0, width = "50%", height = "100%"}, inner)) + assert.are.equal("gsbNestedBox", label.windowname) + assert.are.same({x = 50, y = 0, width = 50, height = 75}, geometry("gsbNestedLabel")) + end) + end) + + describe("Geyser.ScrollBox:hide/show", function() + it("hides and shows the scroll box and its children", function() + local scrollBox = track(Geyser.ScrollBox:new({name = "gsbVisible", x = 0, y = 0, width = 200, height = 150})) + track(Geyser.Label:new({name = "gsbVisibleChild", x = 0, y = 0, width = "100%", height = "100%"}, scrollBox)) + scrollBox:hide() + assert.is_true(scrollBox.hidden) + assert.is_false(windowVisible("gsbVisible")) + assert.is_false(windowVisible("gsbVisibleChild")) + scrollBox:show() + assert.is_false(scrollBox.hidden) + assert.is_true(windowVisible("gsbVisible")) + assert.is_true(windowVisible("gsbVisibleChild")) + end) + end) + + describe("Geyser.ScrollBox:reposition", function() + it("restores geometry that was changed behind Geyser's back", function() + local scrollBox = track(Geyser.ScrollBox:new({name = "gsbReposition", x = 10, y = 10, width = 100, height = 80})) + track(Geyser.Label:new({name = "gsbRepositionChild", x = 5, y = 5, width = "50%", height = "50%"}, scrollBox)) + moveWindow("gsbReposition", 300, 300) + resizeWindow("gsbReposition", 20, 20) + assert.are.same({x = 300, y = 300, width = 20, height = 20}, geometry("gsbReposition")) + local mainWidth, mainHeight = getMainWindowSize() + GeyserReposition("sysWindowResizeEvent", mainWidth, mainHeight) + assert.are.same({x = 10, y = 10, width = 100, height = 80}, geometry("gsbReposition")) + assert.are.same({x = 5, y = 5, width = 50, height = 40}, geometry("gsbRepositionChild")) + end) + + it("puts its own origin back to zero after repositioning", function() + local scrollBox = track(Geyser.ScrollBox:new({name = "gsbOriginKept", x = 30, y = 40, width = 100, height = 80})) + scrollBox:reposition() + assert.are.equal(0, scrollBox.get_x()) + assert.are.equal(0, scrollBox.get_y()) + assert.are.same({x = 30, y = 40, width = 100, height = 80}, geometry("gsbOriginKept")) + end) + end) + + -- Geyser:add2 runs from inside Geyser.Container:new, so the hide it asks for + -- lands before createScrollBox has made the widget. Every other Geyser widget + -- constructor hides itself again afterwards (GeyserCommandLine.lua:89, + -- GeyserMiniConsole.lua:605, GeyserLabel.lua:998, GeyserTextEdit.lua:70, + -- GeyserMapper.lua:133); Geyser.ScrollBox:new is the one that does not, so it + -- comes up on screen with auto_hidden already true. A Geyser.MiniConsole + -- built the same way stays hidden, which is the behaviour this asks for. + pending("Geyser.ScrollBox created in a hidden add2 container stays hidden - Geyser.ScrollBox:new never re-hides the widget it just created") + + describe("Geyser.ScrollBox scroll bars", function() + -- A scroll box scrolls by being a QScrollArea (TScrollBox.h), not by being + -- a console, so Mudlet's scroll bar API cannot reach it: Host::findConsole + -- only looks through the sub-console map, and a scroll box is not in it. + -- Geyser.ScrollBox descends from Geyser.Window rather than + -- Geyser.MiniConsole, so it offers no scroll bar method of its own either. + -- Its scroll bars are Qt's, and appear on their own when a child overflows. + it("is not reachable by the console scroll bar functions", function() + track(Geyser.ScrollBox:new({name = "gsbScrollBar", x = 0, y = 0, width = 200, height = 150})) + local enabled, enableMessage = enableScrollBar("gsbScrollBar") + assert.is_nil(enabled) + assert.is_truthy(enableMessage:find("gsbScrollBar", 1, true)) + local disabled, disableMessage = disableScrollBar("gsbScrollBar") + assert.is_nil(disabled) + assert.is_truthy(disableMessage:find("gsbScrollBar", 1, true)) + assert.is_nil(Geyser.ScrollBox.enableScrollBar) + assert.is_nil(Geyser.ScrollBox.disableScrollBar) + end) + end) + + pending("Geyser.ScrollBox shows Qt's own scroll bar once a child overflows it - a scroll box is not a console, so no console scroll bar getter can report it; this needs a scroll box specific getter") + + pending("Geyser.ScrollBox:setStyleSheet - the method is commented out in GeyserScrollBox.lua because Mudlet has no setScrollBoxStyleSheet primitive to call") + + describe("Geyser.ScrollBox:type_delete", function() + it("deletes the widget, its children and its parent window registration", function() + local scrollBox = track(Geyser.ScrollBox:new({name = "gsbDelete", x = 0, y = 0, width = 200, height = 150})) + track(Geyser.Label:new({name = "gsbDeleteChild", x = 0, y = 0, width = "100%", height = "100%"}, scrollBox)) + scrollBox:delete() + assert.is_nil(windowType("gsbDelete")) + assert.is_nil(windowType("gsbDeleteChild")) + assert.is_nil(Geyser.windowList.gsbDelete) + assert.is_nil(Geyser.parentWindows.gsbDelete) + end) + + it("goes away with the container it was put in", function() + local container = track(Geyser.Container:new({name = "gsbOuter", x = 0, y = 0, width = 300, height = 200})) + track(Geyser.ScrollBox:new({name = "gsbNested", x = 0, y = 0, width = "100%", height = "100%"}, container)) + container:delete() + assert.is_nil(windowType("gsbNested")) + assert.is_nil(Geyser.parentWindows.gsbNested) + end) + end) +end) diff --git a/src/mudlet-lua/tests/GeyserUserWindow_spec.lua b/src/mudlet-lua/tests/GeyserUserWindow_spec.lua new file mode 100644 index 000000000..088f6f303 --- /dev/null +++ b/src/mudlet-lua/tests/GeyserUserWindow_spec.lua @@ -0,0 +1,396 @@ +-- A Geyser.UserWindow is a Geyser.MiniConsole living in a dock widget of its +-- own. getWindowGeometry reports that dock, which is what move()/resize() drive, +-- while getUserWindowSize reports the usable area inside it. How much of the +-- dock that area leaves out is a platform matter: Qt draws a floating dock's +-- title bar and frame itself on X11 and Wayland, so there they are taken out of +-- the usable area, while Windows and macOS let the window manager decorate the +-- dock and so draw them outside it, leaving the whole dock usable. The usable +-- area is therefore never bigger than the dock, but only strictly shorter than +-- it where Qt draws the title bar. No size difference is hardcoded here. +-- +-- Geyser gives every user window an extra root container named +-- "Container" whose size tracks the real user window; the user window is +-- that container's only child, which is why it is not in Geyser.windowList +-- itself. +local dockDecoratedByWindowManager = getOS() == "windows" or getOS() == "mac" + +local function geometry(name) + local x, y, width, height = getWindowGeometry(name) + return {x = x, y = y, width = width, height = height} +end + +-- Selects the line last written by a newline terminated echo. getLineCount +-- returns the index of the last line rather than a count, and the trailing +-- newline leaves the cursor on that still empty line, so the text is one above. +local function lastLine(name) + local index = getLineCount(name) - 1 + assert.is_true(index >= 0, "nothing has been echoed to " .. name .. " yet") + moveCursor(name, 0, index) + selectCurrentLine(name) + return getCurrentLine(name) +end + +describe("Tests functionality of Geyser.UserWindow", function() + local created + + local function track(object) + created[#created + 1] = object + return object + end + + local function alive(object) + if not object or not object.container or not object.container.windowList then + return false + end + return object.container.windowList[object.name] == object + end + + before_each(function() + created = {} + end) + + -- Deleting a user window leaves its "Container" root container behind + -- (see the pending below), so sweep those out by hand to keep repeat runs of + -- this file against the same profile identical. + after_each(function() + local names = {} + for _, object in ipairs(created) do + if object.type == "userwindow" then + names[#names + 1] = object.name .. "Container" + end + if alive(object) then + object:delete() + end + end + for _, name in ipairs(names) do + local orphan = Geyser.windowList[name] + if orphan then + orphan:delete() + end + end + created = {} + end) + + describe("Geyser.UserWindow:new/new2", function() + it("opens a user window at the geometry it was given", function() + local userWindow = track(Geyser.UserWindow:new({name = "guwNew", x = 20, y = 30, width = 300, height = 200})) + assert.are.equal("userwindow", userWindow.type) + assert.are.equal("userwindow", windowType("guwNew")) + assert.are.same({x = 20, y = 30, width = 300, height = 200}, geometry("guwNew")) + assert.is_true(windowVisible("guwNew")) + end) + + it("resets its own constraints to fill the window it opened", function() + local userWindow = track(Geyser.UserWindow:new({name = "guwFilled", x = 10, y = 10, width = 250, height = 180})) + assert.are.equal("0px", userWindow.x) + assert.are.equal("0px", userWindow.y) + assert.are.equal("100%", userWindow.width) + assert.are.equal("100%", userWindow.height) + local usableWidth, usableHeight = getUserWindowSize("guwFilled") + assert.are.equal(usableWidth, userWindow:get_width()) + assert.are.equal(usableHeight, userWindow:get_height()) + end) + + it("gives itself a root container sized to the user window", function() + local userWindow = track(Geyser.UserWindow:new({name = "guwRoot", x = 10, y = 10, width = 300, height = 200})) + local container = userWindow.container + assert.are.equal("guwRootContainer", container.name) + assert.are.equal(container, Geyser.windowList.guwRootContainer) + -- the user window belongs to that container, not to the root window list + assert.is_nil(Geyser.windowList.guwRoot) + assert.are.equal(userWindow, container.windowList.guwRoot) + -- that the container really is sized to the user window is read off a + -- child widget filling it, rather than off the same getter the container + -- was given as its own get_width/get_height + track(Geyser.Label:new({name = "guwRootChild", x = 0, y = 0, width = "100%", height = "100%"}, userWindow)) + local usableWidth, usableHeight = getUserWindowSize("guwRoot") + assert.are.same({x = 0, y = 0, width = usableWidth, height = usableHeight}, geometry("guwRootChild")) + -- the dock is the size it was asked for, and the usable area is real and + -- inside it - by however much this platform's dock decoration costs + local dock = geometry("guwRoot") + assert.are.equal(300, dock.width) + assert.are.equal(200, dock.height) + assert.is_true(usableWidth > 0 and usableWidth <= dock.width, + string.format("usable width %d is not inside the dock width %d", usableWidth, dock.width)) + assert.is_true(usableHeight > 0 and usableHeight <= dock.height, + string.format("usable height %d is not inside the dock height %d", usableHeight, dock.height)) + if not dockDecoratedByWindowManager then + assert.is_true(usableHeight < dock.height, + string.format("Qt draws the dock title bar here, so it must cost height: usable %d, dock %d", + usableHeight, dock.height)) + end + end) + + it("registers itself as a parent window so children can be put in it", function() + local userWindow = track(Geyser.UserWindow:new({name = "guwParent", x = 10, y = 10, width = 200, height = 150})) + assert.are.equal(userWindow, Geyser.parentWindows.guwParent) + assert.are.equal("guwParent", userWindow.windowname) + end) + + it("defaults to an undocked, auto docking window that does not restore a layout", function() + local userWindow = track(Geyser.UserWindow:new({name = "guwDefaults", x = 10, y = 10, width = 200, height = 150})) + assert.is_false(userWindow.docked) + assert.is_false(userWindow.restoreLayout) + assert.is_true(userWindow.autoDock) + assert.are.equal("floating", userWindow.dockPosition) + end) + + it("takes the font size and wrap it was given", function() + track(Geyser.UserWindow:new({name = "guwFont", x = 10, y = 10, width = 250, height = 180, fontSize = 12, wrapAt = 40})) + assert.are.equal(12, getFontSize("guwFont")) + assert.are.equal(40, getWindowWrap("guwFont")) + end) + + -- Ubuntu Mono is asked for rather than a system font like Courier New: + -- Mudlet ships and loads it itself, so it is there to be had on every + -- platform, where a bare Linux CI image has no Courier New and Qt quietly + -- substitutes the nearest match. It is also not the console default + -- (Bitstream Vera Sans Mono), so a font that never reached the widget still + -- fails this. + it("takes the font family it was given", function() + local userWindow = track(Geyser.UserWindow:new({name = "guwFamily", x = 10, y = 10, width = 250, height = 180, font = "Ubuntu Mono"})) + assert.are.equal("Ubuntu Mono", getFont("guwFamily")) + assert.are.equal("Ubuntu Mono", userWindow.font) + end) + + it("derives an auto wrap from its usable width", function() + track(Geyser.UserWindow:new({name = "guwAutoWrap", x = 10, y = 10, width = 300, height = 200, wrapAt = "auto"})) + local usableWidth = getUserWindowSize("guwAutoWrap") + local charWidth = calcFontSize("guwAutoWrap") + assert.are.equal(math.floor(usableWidth / charWidth), getWindowWrap("guwAutoWrap")) + end) + + -- Mudlet cannot report whether the scroll bar is on screen, but + -- Geyser.MiniConsole:resetAutoWrap keeps 15 pixels clear for one when it + -- is, so an auto wrapping console wraps that much earlier - which is + -- readable, and is what proves the constraint reached the widget. + it("keeps room for the scroll bar it was asked for when wrapping", function() + track(Geyser.UserWindow:new({name = "guwScrollBar", x = 10, y = 10, width = 300, height = 200, wrapAt = "auto", scrollBar = true})) + local usableWidth = getUserWindowSize("guwScrollBar") + local charWidth = calcFontSize("guwScrollBar") + assert.are.equal(math.floor((usableWidth - 15) / charWidth), getWindowWrap("guwScrollBar")) + end) + + it("ignores the geometry it was given when it is asked to start docked", function() + local userWindow = track(Geyser.UserWindow:new({name = "guwDocked", x = 10, y = 10, width = 300, height = 200, docked = true})) + -- a docked window keeps the dock position it was opened with instead of + -- being floated, and the dock area decides its geometry, not the + -- constraints, so only the position it kept is asserted here + assert.are.equal("r", userWindow.dockPosition) + assert.are.equal("userwindow", windowType("guwDocked")) + assert.is_true(windowVisible("guwDocked")) + end) + + it("new2 marks the user window as using add2", function() + local userWindow = track(Geyser.UserWindow:new2({name = "guwNew2", x = 10, y = 10, width = 200, height = 150})) + assert.is_true(userWindow.useAdd2) + assert.are.equal("userwindow", windowType("guwNew2")) + end) + + it("reopens a user window that was opened under the same name before", function() + local first = track(Geyser.UserWindow:new({name = "guwReused", x = 10, y = 10, width = 200, height = 150})) + local trackedWindows = #Geyser.windows + first:delete() + local second = track(Geyser.UserWindow:new({name = "guwReused", x = 40, y = 50, width = 260, height = 190})) + assert.are.same({x = 40, y = 50, width = 260, height = 190}, geometry("guwReused")) + assert.are.equal(trackedWindows, #Geyser.windows) + assert.are.equal("guwReusedContainer", second.container.name) + end) + end) + + describe("Geyser.UserWindow:move/resize", function() + local userWindow + + before_each(function() + userWindow = track(Geyser.UserWindow:new({name = "guwMove", x = 10, y = 20, width = 300, height = 200})) + end) + + it("moves and resizes the dock", function() + userWindow:move(60, 70) + userWindow:resize(320, 210) + assert.are.same({x = 60, y = 70, width = 320, height = 210}, geometry("guwMove")) + end) + + it("goes back to filling itself after a move", function() + userWindow:move(60, 70) + assert.are.equal("0px", userWindow.x) + assert.are.equal("100%", userWindow.width) + local usableWidth = getUserWindowSize("guwMove") + assert.are.equal(usableWidth, userWindow:get_width()) + end) + + it("re-resolves the size of percentage children when it is resized", function() + track(Geyser.Label:new({name = "guwMoveChild", x = 0, y = 0, width = "50%", height = "100%"}, userWindow)) + local firstWidth, firstHeight = getUserWindowSize("guwMove") + assert.are.same({x = 0, y = 0, width = math.floor(firstWidth / 2), height = firstHeight}, geometry("guwMoveChild")) + userWindow:resize(400, 260) + local secondWidth, secondHeight = getUserWindowSize("guwMove") + assert.is_true(secondWidth > firstWidth) + assert.are.same({x = 0, y = 0, width = math.floor(secondWidth / 2), height = secondHeight}, geometry("guwMoveChild")) + end) + end) + + describe("Geyser.UserWindow children", function() + local userWindow + + before_each(function() + userWindow = track(Geyser.UserWindow:new({name = "guwHolder", x = 10, y = 20, width = 300, height = 200})) + end) + + it("creates children inside the user window, sized against its usable area", function() + local label = track(Geyser.Label:new({name = "guwLabel", x = "50%", y = 0, width = "50%", height = "100%"}, userWindow)) + assert.are.equal("guwHolder", label.windowname) + local usableWidth, usableHeight = getUserWindowSize("guwHolder") + assert.are.same({ + x = math.floor(usableWidth / 2), + y = 0, + width = math.floor(usableWidth / 2), + height = usableHeight, + }, geometry("guwLabel")) + assert.is_true(windowVisible("guwLabel")) + end) + + it("holds a command line of its own", function() + track(Geyser.CommandLine:new({name = "guwCmdLine", x = 0, y = 0, width = 80, height = 20}, userWindow)) + assert.are.equal("commandline", windowType("guwCmdLine")) + assert.are.same({x = 0, y = 0, width = 80, height = 20}, geometry("guwCmdLine")) + end) + + it("holds a scroll box, which becomes a parent window inside it", function() + local scrollBox = track(Geyser.ScrollBox:new({name = "guwScrollBox", x = 0, y = 0, width = "100%", height = "50%"}, userWindow)) + assert.are.equal("scrollbox", windowType("guwScrollBox")) + -- the scroll box takes over as parent window, remembering the user window + assert.are.equal("guwScrollBox", scrollBox.windowname) + assert.are.equal("guwHolder", scrollBox.parentWindowName) + local usableWidth, usableHeight = getUserWindowSize("guwHolder") + assert.are.same({x = 0, y = 0, width = usableWidth, height = math.floor(usableHeight / 2)}, geometry("guwScrollBox")) + -- and a child of the scroll box is placed in the scroll box's own space + local label = track(Geyser.Label:new({name = "guwScrollBoxLabel", x = 0, y = 0, width = "50%", height = "100%"}, scrollBox)) + assert.are.equal("guwScrollBox", label.windowname) + assert.are.equal(math.floor(usableWidth / 2), geometry("guwScrollBoxLabel").width) + end) + + it("deletes its children with itself", function() + track(Geyser.Label:new({name = "guwDoomedLabel", x = 0, y = 0, width = 20, height = 20}, userWindow)) + userWindow:delete() + assert.is_nil(windowType("guwHolder")) + assert.is_nil(windowType("guwDoomedLabel")) + end) + end) + + describe("Geyser.UserWindow echo", function() + it("echoes into the console the user window contains", function() + local userWindow = track(Geyser.UserWindow:new({name = "guwEcho", x = 10, y = 20, width = 300, height = 200})) + userWindow:echo("into the user window\n") + assert.are.equal("into the user window\n", userWindow.message) + assert.are.equal("into the user window", lastLine("guwEcho")) + end) + end) + + describe("Geyser.UserWindow:hide/show", function() + it("hides and shows the dock", function() + local userWindow = track(Geyser.UserWindow:new({name = "guwHide", x = 10, y = 20, width = 200, height = 150})) + userWindow:hide() + assert.is_true(userWindow.hidden) + assert.is_false(windowVisible("guwHide")) + userWindow:show() + assert.is_false(userWindow.hidden) + assert.is_true(windowVisible("guwHide")) + end) + + it("hides the children in it along with the dock", function() + local userWindow = track(Geyser.UserWindow:new({name = "guwHideChild", x = 10, y = 20, width = 200, height = 150})) + track(Geyser.Label:new({name = "guwHiddenLabel", x = 0, y = 0, width = "100%", height = "100%"}, userWindow)) + userWindow:hide() + assert.is_false(windowVisible("guwHiddenLabel")) + userWindow:show() + assert.is_true(windowVisible("guwHiddenLabel")) + end) + end) + + -- Geyser.UserWindow:show() (GeyserUserWindow.lua:52) forwards to its parent + -- without the `auto` flag its container passes down, so an automatic show + -- clears self.hidden as if the user had asked for it. A user window hidden by + -- hand therefore reappears the moment its root container is shown, where a + -- Geyser.MiniConsole in the same position correctly stays hidden. + pending("Geyser.UserWindow stays hidden when its root container is shown - Geyser.UserWindow:show() drops the auto flag") + + describe("Geyser.UserWindow:setTitle/resetTitle", function() + -- setUserWindowTitle answers nil and a message rather than raising when it + -- cannot find the window, so the return value is what says the title + -- reached the right dock; without it a wrapper naming the wrong window + -- would still leave titleText looking right. + it("remembers the title it was given, and empties it again on reset", function() + local userWindow = track(Geyser.UserWindow:new({name = "guwTitle", x = 10, y = 20, width = 200, height = 150, titleText = "My window"})) + assert.are.equal("My window", userWindow.titleText) + assert.is_true(userWindow:setTitle("Renamed")) + assert.are.equal("Renamed", userWindow.titleText) + assert.is_true(userWindow:resetTitle()) + assert.are.equal("", userWindow.titleText) + end) + + it("starts with an empty title when it was not given one", function() + local userWindow = track(Geyser.UserWindow:new({name = "guwNoTitle", x = 10, y = 20, width = 200, height = 150})) + assert.are.equal("", userWindow.titleText) + end) + end) + + pending("Geyser.UserWindow:setTitle/resetTitle put the text on the dock's title bar - needs a getUserWindowTitle getter") + + describe("Geyser.UserWindow:setStyleSheet", function() + it("remembers the stylesheet it was given", function() + local userWindow = track(Geyser.UserWindow:new({ + name = "guwCss", + x = 10, y = 20, width = 200, height = 150, + stylesheet = "border: 1px solid red;", + })) + assert.are.equal("border: 1px solid red;", userWindow.stylesheet) + userWindow:setStyleSheet("background-color: green;") + assert.are.equal("background-color: green;", userWindow.stylesheet) + end) + end) + + pending("Geyser.UserWindow:setStyleSheet applies the stylesheet to the dock - needs a getUserWindowStyleSheet getter") + + pending("Geyser.UserWindow scrollBar constraint puts a scroll bar on screen - the wrap it leaves room for is covered above, but the scroll bar's own visibility is not readable from Lua and needs a scroll bar getter") + + describe("Geyser.UserWindow:enableAutoDock/disableAutoDock", function() + it("turns automatic docking off and on again without disturbing the window", function() + local userWindow = track(Geyser.UserWindow:new({name = "guwAutoDock", x = 10, y = 20, width = 300, height = 200})) + assert.is_true(userWindow:disableAutoDock()) + assert.is_false(userWindow.autoDock) + -- both of these reopen the window, so the dock must survive them intact + assert.is_true(windowVisible("guwAutoDock")) + assert.are.same({x = 10, y = 20, width = 300, height = 200}, geometry("guwAutoDock")) + assert.is_true(userWindow:enableAutoDock()) + assert.is_true(userWindow.autoDock) + assert.is_true(windowVisible("guwAutoDock")) + assert.are.same({x = 10, y = 20, width = 300, height = 200}, geometry("guwAutoDock")) + end) + end) + + pending("Geyser.UserWindow:setDockPosition - which edge a user window ended up docked to, and whether it docks by itself when dragged, are not readable from Lua") + + -- restoreLayout = true makes the constructor reopen the window from the + -- layout saved in the profile and skip the move/resize it was given. Running + -- that here would write this file's window layouts into the shared self-test + -- profile, so repeat runs against the same profile would stop matching. + pending("Geyser.UserWindow restoreLayout reopens the window where it was last left") + + describe("Geyser.UserWindow:delete", function() + it("closes the dock and unregisters the user window", function() + local userWindow = track(Geyser.UserWindow:new({name = "guwDelete", x = 10, y = 20, width = 200, height = 150})) + assert.are.equal("userwindow", windowType("guwDelete")) + userWindow:delete() + assert.is_nil(windowType("guwDelete")) + assert.is_nil(getWindowGeometry("guwDelete")) + assert.is_nil(Geyser.parentWindows.guwDelete) + end) + end) + + -- Geyser.Container:new (GeyserContainer.lua:361) makes the "Container" + -- root container for a user window, but Geyser.Container:delete only unhooks + -- the user window from it, so the container is left registered in + -- Geyser.windowList and Geyser.windows for the rest of the session. + pending("deleting a Geyser.UserWindow also removes the root container it created") +end) From dd487dc94b9cf6fefd77ba1b2486e1732b085ccf Mon Sep 17 00:00:00 2001 From: Stephen Lyons Date: Tue, 4 Aug 2026 23:18:32 +0100 Subject: [PATCH 083/155] Improve: make filler widget size in toolbars user settable (#9332) #### Brief overview of PR changes/additions Replace code that tried to offset the first button in a toolbar by one extra "space" every time it is saved by a settable variable that can add zero to one less than the number of rows/columns that a toolbar has. The maximum value for this and the control in the editor is automatically set to be that one less every time the number of rows/columns is changed, and the control disabled should the other one be set to less that 2. It seems that it is possible to set the number of rows/columns to zero and it looks as though, many years ago, it was possible to use that zero value to disable the use of a `QGridLayout` for the toolbar and instead allow the buttons to have a manually/custom layout. The code with reproducing the manual layout seems to have persisted but that to allow it to be modified looks to have disappeared. That bares further investigation. #### Motivation for adding to Mudlet With the introduction of autosaving in the editor it is no longer reasonable to change the layout every time something in a toolbar is edited causing things to be saved - and relying on the end-user not ever touching the arrangement in the editor window. Instead this knob can be used to set it explicitly. There is no provision in the Lua API for this "knob" in this PR because the current Button/Menu/Toolbar implementation in the Lua subsystem is seriously borked/incomplete. A major overhaul of that is intended for a future PR! #### Other info (issues closed, discussion etc) Also: * Make members of `TAction` class that have getters/setters `private:`. * Make the text in the editor for toolbars: "Number of columns/rows (depending on orientation):" actually change to match the setting for the selected orientation. * Move the `QLineEdit` to show the file name for the button icon into the appropriate `QGroupBox` and add a `QLabel` for it - but keep them hidden for now. This feature was disabled (without reason?) in 4e651d55fd7a73af24fe66ae3d85e9e5b13a1fc5 which removed the button that was used to select a file to provide an icon however the reproduction of icons on buttons and menus was never removed. Previously the `QLineEdit` was used in a read-only mode to display (until it was shrunk to a zero size before this change) the file chosen. I intend to re-enable this functionality in the future. --------- Signed-off-by: Stephen Lyons --- src/ActionUnit.cpp | 9 +- src/EditorItemXMLHelpers.cpp | 28 ++--- src/EditorModifyPropertyCommand.cpp | 2 +- src/TAction.cpp | 4 + src/TAction.h | 162 +++++++++++++++++++++------- src/TEasyButtonBar.cpp | 56 +++++----- src/TEasyButtonBar.h | 1 + src/TFlipButton.h | 4 + src/TToolBar.cpp | 42 ++++---- src/TToolBar.h | 1 + src/XMLexport.cpp | 2 + src/XMLimport.cpp | 23 ++-- src/dlgActionMainArea.cpp | 51 ++++++++- src/dlgActionMainArea.h | 4 +- src/dlgTriggerEditor.cpp | 80 ++++++++++---- src/dlgTriggerEditor.h | 1 + src/ui/actions_main_area.ui | 98 +++++++++++++---- 17 files changed, 402 insertions(+), 166 deletions(-) diff --git a/src/ActionUnit.cpp b/src/ActionUnit.cpp index 1eb4f2702..90b452f41 100644 --- a/src/ActionUnit.cpp +++ b/src/ActionUnit.cpp @@ -130,13 +130,11 @@ void ActionUnit::compileAll() TAction* ActionUnit::findAction(const QString& name) { - //QMap mActionMap; - QMapIterator it(mActionMap); while (it.hasNext()) { it.next(); if (it.value()->getName() == name) { - qDebug() << it.value()->getName(); + // qDebug().nospace().noquote() << "ActionUnit::findAction(const QString&) INFO - found: \"" << it.value()->getName() << "\"."; TAction* pT = it.value(); return pT; } @@ -569,8 +567,9 @@ void ActionUnit::constructToolbar(TAction* pAction, TToolBar* pToolBar) pToolBar->setFeatures(QDockWidget::DockWidgetMovable | QDockWidget::DockWidgetFloatable); if (pAction->mLocation == 4) { if (pAction->mToolbarLastDockArea == Qt::NoDockWidgetArea) { - qWarning() << "ActionUnit::constructToolbar(TAction*, TToolBar*) WARNING - no last dockarea was set for the TAction (\"" << pAction->getName() - << "\"), for this toolbar forcing it to the Left one!"; + qWarning().nospace().noquote() << "ActionUnit::constructToolbar(TAction*, TToolBar*) WARNING - no last dockarea was set for the TAction (\"" + << pAction->getName() + << "\"), for this toolbar forcing it to the Left one!"; } mudlet::self()->addDockWidget(((pAction->mToolbarLastDockArea != Qt::NoDockWidgetArea) ? pAction->mToolbarLastDockArea : Qt::LeftDockWidgetArea), pToolBar); if (pAction->mToolbarLastFloatingState) { diff --git a/src/EditorItemXMLHelpers.cpp b/src/EditorItemXMLHelpers.cpp index 41d0994ff..1a677341f 100644 --- a/src/EditorItemXMLHelpers.cpp +++ b/src/EditorItemXMLHelpers.cpp @@ -1179,8 +1179,8 @@ TAction* importActionFromXML(const QString& xmlSnapshot, TAction* pParent, Host* // Read attributes pA->setIsActive(QString::fromStdString(actionNode.attribute("isActive").value()) == "yes"); pA->setIsFolder(QString::fromStdString(actionNode.attribute("isFolder").value()) == "yes"); - pA->mIsPushDownButton = QString::fromStdString(actionNode.attribute("isPushButton").value()) == "yes"; - pA->mButtonFlat = QString::fromStdString(actionNode.attribute("isFlatButton").value()) == "yes"; + pA->setIsPushDownButton(QString::fromStdString(actionNode.attribute("isPushButton").value()) == "yes"); + pA->setButtonFlat(QString::fromStdString(actionNode.attribute("isFlatButton").value()) == "yes"); pA->mUseCustomLayout = QString::fromStdString(actionNode.attribute("useCustomLayout").value()) == "yes"; // Read child elements @@ -1207,13 +1207,15 @@ TAction* importActionFromXML(const QString& xmlSnapshot, TAction* pParent, Host* } else if (nodeName == "location") { pA->mLocation = nodeValue.toInt(); } else if (nodeName == "buttonRotation") { - pA->mButtonRotation = nodeValue.toInt(); + pA->setButtonRotation(nodeValue.toInt()); } else if (nodeName == "sizeX") { - pA->mSizeX = nodeValue.toInt(); + pA->setSizeX(nodeValue.toInt()); } else if (nodeName == "sizeY") { - pA->mSizeY = nodeValue.toInt(); + pA->setSizeY(nodeValue.toInt()); } else if (nodeName == "buttonColumn") { - pA->mButtonColumns = nodeValue.toInt(); + pA->setButtonColumns(nodeValue.toInt()); + } else if (nodeName == "buttonFillerOffset") { + pA->setButtonFillerOffset(nodeValue.toInt()); } else if (nodeName == "buttonColor") { // Deprecated - skip this element } else if (nodeName == "posX") { @@ -1280,8 +1282,8 @@ bool updateActionFromXML(TAction* pA, const QString& xmlSnapshot) // Update attributes pA->setIsActive(QString::fromStdString(actionNode.attribute("isActive").value()) == "yes"); pA->setIsFolder(QString::fromStdString(actionNode.attribute("isFolder").value()) == "yes"); - pA->mIsPushDownButton = QString::fromStdString(actionNode.attribute("isPushButton").value()) == "yes"; - pA->mButtonFlat = QString::fromStdString(actionNode.attribute("isFlatButton").value()) == "yes"; + pA->setIsPushDownButton(QString::fromStdString(actionNode.attribute("isPushButton").value()) == "yes"); + pA->setButtonFlat(QString::fromStdString(actionNode.attribute("isFlatButton").value()) == "yes"); pA->mUseCustomLayout = QString::fromStdString(actionNode.attribute("useCustomLayout").value()) == "yes"; // Update child elements @@ -1306,13 +1308,15 @@ bool updateActionFromXML(TAction* pA, const QString& xmlSnapshot) } else if (nodeName == "location") { pA->mLocation = nodeValue.toInt(); } else if (nodeName == "buttonRotation") { - pA->mButtonRotation = nodeValue.toInt(); + pA->setButtonRotation(nodeValue.toInt()); } else if (nodeName == "sizeX") { - pA->mSizeX = nodeValue.toInt(); + pA->setSizeX(nodeValue.toInt()); } else if (nodeName == "sizeY") { - pA->mSizeY = nodeValue.toInt(); + pA->setSizeY(nodeValue.toInt()); } else if (nodeName == "buttonColumn") { - pA->mButtonColumns = nodeValue.toInt(); + pA->setButtonColumns(nodeValue.toInt()); + } else if (nodeName == "buttonFillerOffset") { + pA->setButtonFillerOffset(nodeValue.toInt()); } else if (nodeName == "buttonColor") { // Deprecated - skip this element } else if (nodeName == "posX") { diff --git a/src/EditorModifyPropertyCommand.cpp b/src/EditorModifyPropertyCommand.cpp index a31e61736..1ed908c60 100644 --- a/src/EditorModifyPropertyCommand.cpp +++ b/src/EditorModifyPropertyCommand.cpp @@ -281,7 +281,7 @@ QString EditorModifyPropertyCommand::generateText(EditorViewType viewType, const return QObject::tr("modify key \"%1\"").arg(itemName); case EditorViewType::cmActionView: //: Undo/redo menu text for modifying a button's properties - return QObject::tr("modify button \"%1\"").arg(itemName); + return QObject::tr("modify button/menu/toolbar \"%1\"").arg(itemName); default: //: Undo/redo menu text for modifying an unknown item's properties return QObject::tr("modify item \"%1\"").arg(itemName); diff --git a/src/TAction.cpp b/src/TAction.cpp index 89ea22b98..108917d29 100644 --- a/src/TAction.cpp +++ b/src/TAction.cpp @@ -182,6 +182,8 @@ void TAction::execute() void TAction::expandToolbar(TToolBar* pT) { + // The -1 is needed to compensate for the initial pre-increment to TToolBar::mItemCount + pT->resetItemCount(mButtonFillerOffset - 1); for (auto pTAction : *mpMyChildrenList) { if (!pTAction->isActive()) { // This test and conditional loop abort was missing from this method @@ -267,6 +269,8 @@ void TAction::insertActions(TToolBar* pT, QMenu* pMenu) void TAction::expandToolbar(TEasyButtonBar* pT) { + // The -1 is needed to compensate for the initial pre-increment to TEasyButtonBar::mItemCount + pT->resetItemCount(mButtonFillerOffset - 1); for (auto pTAction : *mpMyChildrenList) { if (!pTAction->isActive()) { continue; diff --git a/src/TAction.h b/src/TAction.h index bb730cc1a..b1ff553b4 100644 --- a/src/TAction.h +++ b/src/TAction.h @@ -55,42 +55,111 @@ public: void compileAll(); QString getName() const { return mName; } void setName(const QString& name); - void setButtonRotation(int rotation) { if (rotation != mButtonRotation) { setDataChanged(); mButtonRotation = rotation; } } + void setButtonRotation(int rotation) { + if (rotation != mButtonRotation) { + setDataChanged(); + mButtonRotation = rotation; + } + } int getButtonRotation() const { return mButtonRotation; } - void setButtonColumns(int columns) { if (columns != mButtonColumns) { setDataChanged(); mButtonColumns = columns; } } + void setButtonColumns(int columns) { + if (columns != mButtonColumns) { + setDataChanged(); + mButtonColumns = columns; + } + } int getButtonColumns() const { return mButtonColumns; } bool getButtonFlat() const { return mButtonFlat; } - void setButtonFlat(bool flat) { if (flat != mButtonFlat) { setDataChanged(); mButtonFlat = flat; } } - - void setSizeX(int size) { if (size != mSizeX) { setDataChanged(); mSizeX = size; } } + void setButtonFlat(bool flat) { + if (flat != mButtonFlat) { + setDataChanged(); + mButtonFlat = flat; + } + } + // This should always be called AFTER setButtonColumns! + void setButtonFillerOffset(const int value) + { + const auto newValue = std::max(0, std::min(value, mButtonColumns - 1)); + if (newValue != mButtonFillerOffset) { + setDataChanged(); + mButtonFillerOffset = newValue; + } + } + int getButtonFillerOffset() const { return mButtonFillerOffset; } + void setSizeX(int size) { + if (size != mSizeX) { + setDataChanged(); + mSizeX = size; + } + } int getSizeX() const { return mSizeX; } - void setSizeY(int size) { if (size != mSizeY) { setDataChanged(); mSizeY = size; } } + void setSizeY(int size) { + if (size != mSizeY) { + setDataChanged(); + mSizeY = size; + } + } int getSizeY() const { return mSizeY; } + QSize getSize() const { return {mSizeX, mSizeY}; } void fillMenu(TEasyButtonBar* pT, QMenu* menu); void compile(); bool compileScript(); void execute(); QString getIcon() const { return mIcon; } - void setIcon(const QString& icon) { if (icon != mIcon) { mIcon = icon; } } + void setIcon(const QString& icon) { + if (icon != mIcon) { + mIcon = icon; + } + } QString getScript() const { return mScript; } bool setScript(const QString& script); QString getCommandButtonUp() const { return mCommandButtonUp; } - void setCommandButtonUp(const QString& cmd) { if (cmd != mCommandButtonUp) { setDataChanged(); mCommandButtonUp = cmd; } } - void setCommandButtonDown(const QString& cmd) { if (cmd != mCommandButtonDown) { setDataChanged(); mCommandButtonDown = cmd; } } + void setCommandButtonUp(const QString& cmd) { + if (cmd != mCommandButtonUp) { + setDataChanged(); + mCommandButtonUp = cmd; + } + } + void setCommandButtonDown(const QString& cmd) { + if (cmd != mCommandButtonDown) { + setDataChanged(); + mCommandButtonDown = cmd; + } + } QString getCommandButtonDown() const { return mCommandButtonDown; } - bool isPushDownButton() { return mIsPushDownButton; } - void setIsPushDownButton(bool b) { if (b != mIsPushDownButton) { setDataChanged(); mIsPushDownButton = b; } } + bool isPushDownButton() const { return mIsPushDownButton; } + void setIsPushDownButton(const bool b) { + if (b != mIsPushDownButton) { + setDataChanged(); + mIsPushDownButton = b; + } + } - void setIsFolder(bool b) { if (b != isFolder()) { setDataChanged(); this->Tree::setIsFolder(b);} } + void setIsFolder(bool b) { + if (b != isFolder()) { + setDataChanged(); + this->Tree::setIsFolder(b); + } + } bool registerAction(); void insertActions(TToolBar* pT, QMenu* menu); void expandToolbar(TToolBar* pT); void insertActions(TEasyButtonBar* pT, QMenu* menu); void expandToolbar(TEasyButtonBar* pT); - void setDataSaved() { if (mpParent) { mpParent->setDataSaved(); } mDataChanged = false; } - void setDataChanged() { if (mpParent) { mpParent->setDataChanged(); } mDataChanged = true; } + void setDataSaved() { + if (mpParent) { + mpParent->setDataSaved(); + } + mDataChanged = false; + } + void setDataChanged() { + if (mpParent) { + mpParent->setDataChanged(); + } + mDataChanged = true; + } bool isDataChanged() { return mDataChanged; } QString packageName(TAction* pAction) const; QString moduleName(TAction* pAction) const; @@ -100,42 +169,33 @@ public: QPointer mpEasyButtonBar; QPointer mpEAction; QPointer mpFButton; - // The following was an int but there was confusion over: - // EITHER: "1" = released/unclicked/up & "2" = pressed/clicked/down - // OR: "1" = pressed/clicked/down & "0" = released/unclicked/up - // The Wiki says it should be "1" and "2" but the code sort of did "0"/"1" - // in some places. - // Now uses a boolean: - // "true" = pressed/clicked/down & "false" = released/unclicked/up + /* The following was an int but there was confusion over: + * EITHER: "1" = released/unclicked/up & "2" = pressed/clicked/down, + * OR: "1" = pressed/clicked/down & "0" = released/unclicked/up. + * The Wiki says it should be "1" and "2" but the code sort of did "0"/"1" + * in some places. + * Now uses a boolean: + * "true" = pressed/clicked/down & "false" = released/unclicked/up. + * Only relevant for "push-down" buttons*/ bool mButtonState = false; int mPosX = 0; int mPosY = 0; - // THIS class uses 0 = horizontal, 1 = vertical; c.f. TFlipButton class - // which uses Qt::Orientation enum for the same thing: + /* THIS class uses 0 = horizontal, 1 = vertical. + * c.f. TFlipButton class which uses Qt::Orientation enum + * (1 = Qt::Horizontal, 2 = Qt::Vertical).*/ int mOrientation = 0; - // 0 to 3 are only applicable to the Easy Button Bar buttons/menus (around - // edge of main console: - // 0 = Top "Toolbar" (Easy Button Bar) - // 2 = Left "Toolbar" (Easy Button Bar) - // 3 = Left "Toolbar" (Easy Button Bar) - // 4 = Dockable/floating Toolbar + /* 0, 2, 3 are only applicable to the Easy Button Bar buttons/menus (around + * edge of main console): + * 0 = Top "Toolbar" (Easy Button Bar). + * 1 = Not used since 2009 in commit: c5f404729d46976c6b2c7cf89fd098f5806440c8. + * 2 = Left "Toolbar" (Easy Button Bar). + * 3 = Right "Toolbar" (Easy Button Bar). + * 4 = Dockable/floating Toolbar.*/ int mLocation = 0; - bool mIsPushDownButton = false; bool mNeedsToBeCompiled = true; - QString mIcon; QIcon mIconPix; - // 0 = Horizontal - // 1 = Vertical - // 2 = Vertical + Mirrored - int mButtonRotation = 0; - int mButtonColumns = 1; - // Not currently user accessible but was previously and maintained in game - // saves - and applied to buttons when drawn: - bool mButtonFlat = false; - int mSizeX = 0; - int mSizeY = 0; // Not currently user accessible but was previously and maintained in game // saves - and applied to buttons when drawn: bool mUseCustomLayout = false; @@ -156,6 +216,26 @@ private: QString mFuncName; bool mModuleMember = false; bool mDataChanged = true; + bool mIsPushDownButton = false; // Make private + + QString mIcon; + // 0 = Horizontal + // 1 = Vertical + // 2 = Vertical + Mirrored + int mButtonRotation = 0; + int mButtonColumns = 1; + /* Maximum is one less than the above, and is the number of columns/rows + * the first button/menu in a toolbar must be offset. This replaces the + * prior arrangement that incremented this by one (modulus the + * mButtonColums) each time the toolbar was saved. Since that now happens + * a lot with the undo/redo and auto-save features that is no longer + * sustainable. */ + int mButtonFillerOffset = 0; + /* Not currently user accessible but was previously and maintained in game + * saves - and applied to buttons when drawn: */ + bool mButtonFlat = false; // Make private + int mSizeX = 0; // Make private + int mSizeY = 0; // Make private }; #ifndef QT_NO_DEBUG_STREAM diff --git a/src/TEasyButtonBar.cpp b/src/TEasyButtonBar.cpp index d2e7d0e97..3a06f96bb 100644 --- a/src/TEasyButtonBar.cpp +++ b/src/TEasyButtonBar.cpp @@ -51,11 +51,9 @@ TEasyButtonBar::TEasyButtonBar(TAction* pA, QString name, QWidget* pW) const QSizePolicy sizePolicy(QSizePolicy::Expanding, QSizePolicy::Preferred); mpWidget->setSizePolicy(sizePolicy); } else { - mpWidget->setMinimumHeight(mpTAction->mSizeY); - mpWidget->setMaximumHeight(mpTAction->mSizeY); - mpWidget->setMinimumWidth(mpTAction->mSizeX); - mpWidget->setMaximumWidth(mpTAction->mSizeX); - mpWidget->setGeometry(mpTAction->mPosX, mpTAction->mPosY, mpTAction->mSizeX, mpTAction->mSizeY); + mpWidget->setMaximumSize(mpTAction->getSize()); + mpWidget->setMinimumSize(mpTAction->getSize()); + mpWidget->setGeometry(mpTAction->mPosX, mpTAction->mPosY, mpTAction->getSizeX(), mpTAction->getSizeY()); } setStyleSheet(mpTAction->css); mpWidget->setStyleSheet(mpTAction->css); @@ -75,11 +73,11 @@ void TEasyButtonBar::addButton(TFlipButton* pB) } } else { qDebug() << "setting up custom sizes"; - const QSize size = QSize(pB->mpTAction->mSizeX, pB->mpTAction->mSizeY); + const QSize size = pB->mpTAction->getSize(); pB->setMaximumSize(size); pB->setMinimumSize(size); pB->setParent(mpWidget); - pB->setGeometry(pB->mpTAction->mPosX, pB->mpTAction->mPosY, pB->mpTAction->mSizeX, pB->mpTAction->mSizeY); + pB->setGeometry(pB->mpTAction->mPosX, pB->mpTAction->mPosY, pB->mpTAction->getSizeX(), pB->mpTAction->getSizeY()); } pB->setStyleSheet(pB->mpTAction->css); @@ -101,12 +99,8 @@ void TEasyButtonBar::addButton(TFlipButton* pB) if (!mpTAction->mUseCustomLayout) { // tool bar mButtonColumns > 0 -> autolayout // case == 0: use individual button placement for user defined layouts - int columns = mpTAction->getButtonColumns(); - if (columns <= 0) { - columns = 1; - } - mItemCount++; - const int row = mItemCount / columns; + int columns = std::max(1, mpTAction->getButtonColumns()); + const int row = ++mItemCount / columns; const int col = mItemCount % columns; if (mVerticalOrientation) { mpLayout->addWidget(pB, row, col); @@ -128,21 +122,23 @@ void TEasyButtonBar::addButton(TFlipButton* pB) void TEasyButtonBar::finalize() { - if (mpTAction->mUseCustomLayout) { + if (mpTAction->mUseCustomLayout || !mpTAction->getButtonFillerOffset()) { return; } - auto fillerWidget = new QWidget; - - const QSizePolicy sizePolicy(QSizePolicy::Expanding, QSizePolicy::Expanding); - fillerWidget->setSizePolicy(sizePolicy); - int columns = mpTAction->getButtonColumns(); - if (columns <= 0) { - columns = 1; - } - const int row = (++mItemCount) / columns; - const int column = mItemCount % columns; + auto fillerWidget = new QWidget(this); + QPushButton dummy; + fillerWidget->setMinimumSize(dummy.minimumSizeHint()); + fillerWidget->setMaximumSize(dummy.minimumSizeHint()); if (mpLayout) { - mpLayout->addWidget(fillerWidget, row, column); + if (mpTAction->mOrientation == 1) { + // The toolbar is to be filled with rows of mpTAction->getButtonColumns() wide + // The filler widget is to be one or more columns wide + mpLayout->addWidget(fillerWidget, 0, 0, mpTAction->getButtonFillerOffset(), 1); + } else { + // The toolbar is to be filled with columns of mpTAction->getButtonColumns() tall + // The filler widget is to be one or more rows tall + mpLayout->addWidget(fillerWidget, 0, 0, 1, mpTAction->getButtonFillerOffset()); + } } } @@ -178,7 +174,7 @@ void TEasyButtonBar::slot_pressed(const bool isChecked) // entries... pB->showMenu(); - if (pA->mIsPushDownButton) { + if (pA->isPushDownButton()) { // DO NOT MANIPULATE THE BUTTON STATE OURSELF NOW pA->mButtonState = isChecked; pA->mpHost->mpConsole->mButtonState = (pA->mButtonState ? 2 : 1); @@ -216,11 +212,9 @@ void TEasyButtonBar::clear() mpWidget->setContentsMargins(0, 0, 0, 0); } else { mpLayout = nullptr; - mpWidget->setMinimumHeight(mpTAction->mSizeY); - mpWidget->setMaximumHeight(mpTAction->mSizeY); - mpWidget->setMinimumWidth(mpTAction->mSizeX); - mpWidget->setMaximumWidth(mpTAction->mSizeX); - mpWidget->setGeometry(mpTAction->mPosX, mpTAction->mPosY, mpTAction->mSizeX, mpTAction->mSizeY); + mpWidget->setMinimumSize(mpTAction->getSize()); + mpWidget->setMaximumSize(mpTAction->getSize()); + mpWidget->setGeometry(mpTAction->mPosX, mpTAction->mPosY, mpTAction->getSizeX(), mpTAction->getSizeY()); } layout()->addWidget(pW); setStyleSheet(mpTAction->css); diff --git a/src/TEasyButtonBar.h b/src/TEasyButtonBar.h index 92ec2febe..ec347b499 100644 --- a/src/TEasyButtonBar.h +++ b/src/TEasyButtonBar.h @@ -41,6 +41,7 @@ public: Q_DISABLE_COPY(TEasyButtonBar) TEasyButtonBar(TAction*, QString, QWidget* pW = nullptr); void addButton(TFlipButton* pW); + void resetItemCount(const int initialOffset) { mItemCount = initialOffset; } void setVerticalOrientation() { mVerticalOrientation = true; } void setHorizontalOrientation() { mVerticalOrientation = false; } void clear(); diff --git a/src/TFlipButton.h b/src/TFlipButton.h index cb9132a38..b166fc3c7 100644 --- a/src/TFlipButton.h +++ b/src/TFlipButton.h @@ -53,7 +53,11 @@ protected: private: int mID = 0; QPointer mpHost; + // This and mMirrored are derived from TAction::mButtonRotation, NOT + // TAction::mOrientation! Qt::Orientation mOrientation = Qt::Horizontal; + // This and mOrientation are derived from TAction::mButtonRotation, NOT + // TAction::mOrientation! bool mMirrored = false; }; diff --git a/src/TToolBar.cpp b/src/TToolBar.cpp index a481bfaae..046ed78fe 100644 --- a/src/TToolBar.cpp +++ b/src/TToolBar.cpp @@ -115,11 +115,11 @@ void TToolBar::addButton(TFlipButton* pB) pB->setMaximumSize(size); pB->setMinimumSize(size); } else { - const QSize size = QSize(pB->mpTAction->mSizeX, pB->mpTAction->mSizeY); + const QSize size = pB->mpTAction->getSize(); pB->setMaximumSize(size); pB->setMinimumSize(size); pB->setParent(mpWidget); - pB->setGeometry(pB->mpTAction->mPosX, pB->mpTAction->mPosY, pB->mpTAction->mSizeX, pB->mpTAction->mSizeY); + pB->setGeometry(pB->mpTAction->mPosX, pB->mpTAction->mPosY, pB->mpTAction->getSizeX(), pB->mpTAction->getSizeY()); } pB->setStyleSheet(pB->mpTAction->css); @@ -141,12 +141,8 @@ void TToolBar::addButton(TFlipButton* pB) if (!mpTAction->mUseCustomLayout) { // tool bar mButtonColumns > 0 -> autolayout // case == 0: use individual button placement for user defined layouts - int columns = mpTAction->getButtonColumns(); - if (columns <= 0) { - columns = 1; - } - mItemCount++; - const int row = mItemCount / columns; + int columns = std::max(1, mpTAction->getButtonColumns()); + const int row = ++mItemCount / columns; const int col = mItemCount % columns; if (mVerticalOrientation) { mpLayout->addWidget(pB, row, col); @@ -164,22 +160,24 @@ void TToolBar::addButton(TFlipButton* pB) void TToolBar::finalize() { - if (mpTAction->mUseCustomLayout) { + if (mpTAction->mUseCustomLayout || !mpTAction->getButtonFillerOffset()) { return; } - auto fillerWidget = new QWidget; - const QSizePolicy sizePolicy(QSizePolicy::Expanding, QSizePolicy::Expanding); - fillerWidget->setSizePolicy(sizePolicy); - int columns = mpTAction->getButtonColumns(); - if (columns <= 0) { - columns = 1; + auto fillerWidget = new QWidget(this); + QPushButton dummy; + fillerWidget->setMinimumSize(dummy.minimumSizeHint()); + fillerWidget->setMaximumSize(dummy.minimumSizeHint()); + if (mpLayout) { + if (mpTAction->mOrientation == 1) { + // The toolbar is to be filled with rows of mpTAction->getButtonColumns() wide + // The filler widget is to be one or more columns wide + mpLayout->addWidget(fillerWidget, 0, 0, mpTAction->getButtonFillerOffset(), 1); + } else { + // The toolbar is to be filled with columns of mpTAction->getButtonColumns() tall + // The filler widget is to be one or more rows tall + mpLayout->addWidget(fillerWidget, 0, 0, 1, mpTAction->getButtonFillerOffset()); + } } - const int row = (++mItemCount) / columns; - const int column = (mItemCount - 1) % columns; - mpLayout->addWidget(fillerWidget, row, column); - // 3 lines above are to avoid order of operations problem of original line - // (-Wsequence-point warning on mItemCount) NEEDS TO BE CHECKED: - // mpLayout->addWidget( fillerWidget, ++mItemCount/columns, mItemCount%columns ); } // Used by buttons directly on a TToolBar instance but NOT on sub-menu item - we @@ -213,7 +211,7 @@ void TToolBar::slot_pressed(const bool isChecked) // entries... pB->menu(); - if (pA->mIsPushDownButton) { + if (pA->isPushDownButton()) { pA->mButtonState = isChecked; mpHost->mpConsole->mButtonState = (pA->mButtonState ? 2 : 1); // Was using 1 and 0 but that was wrong } else { diff --git a/src/TToolBar.h b/src/TToolBar.h index c7d60e23f..ee77dbe52 100644 --- a/src/TToolBar.h +++ b/src/TToolBar.h @@ -39,6 +39,7 @@ public: Q_DISABLE_COPY(TToolBar) TToolBar(Host*, TAction*, const QString&, QWidget* pW = nullptr); void addButton(TFlipButton* pW); + void resetItemCount(const int initialOffset) { mItemCount = initialOffset; } void resizeEvent(QResizeEvent* e) override; void moveEvent(QMoveEvent* e) override; void mousePressEvent(QMouseEvent*) override; diff --git a/src/XMLexport.cpp b/src/XMLexport.cpp index 29d231f8d..66354b5f6 100644 --- a/src/XMLexport.cpp +++ b/src/XMLexport.cpp @@ -1157,6 +1157,8 @@ void XMLexport::writeAction(TAction* pT, pugi::xml_node xmlParent) actionContents.append_child("sizeX").text().set(QString::number(pT->mSizeX).toUtf8().constData()); actionContents.append_child("sizeY").text().set(QString::number(pT->mSizeY).toUtf8().constData()); actionContents.append_child("buttonColumn").text().set(QString::number(pT->mButtonColumns).toUtf8().constData()); + // This will be noted as an unrecognised item in Mudlet versions prior to 4.22.0 + actionContents.append_child("buttonFillerOffset").text().set(QString::number(pT->mButtonFillerOffset).toUtf8().constData()); actionContents.append_child("buttonRotation").text().set(QString::number(pT->mButtonRotation).toUtf8().constData()); } } diff --git a/src/XMLimport.cpp b/src/XMLimport.cpp index 6436b4106..41b0d19ca 100644 --- a/src/XMLimport.cpp +++ b/src/XMLimport.cpp @@ -1610,8 +1610,8 @@ int XMLimport::readAction(TAction* pParent) auto pT = new TAction(pParent, mpHost); pT->setIsFolder(attributes().value(qsl("isFolder")) == YES); - pT->mIsPushDownButton = attributes().value(qsl("isPushButton")) == YES; - pT->mButtonFlat = attributes().value(qsl("isFlatButton")) == YES; + pT->setIsPushDownButton(attributes().value(qsl("isPushButton")) == YES); + pT->setButtonFlat(attributes().value(qsl("isFlatButton")) == YES); pT->mUseCustomLayout = attributes().value(qsl("useCustomLayout")) == YES; mpHost->getActionUnit()->registerAction(pT); pT->setIsActive(attributes().value(qsl("isActive")) == YES); @@ -1628,7 +1628,7 @@ int XMLimport::readAction(TAction* pParent) } if (isStartElement()) { if (name() == qsl("name")) { - pT->mName = readElementText(); + pT->setName(readElementText()); } else if (name() == qsl("packageName")) { pT->mPackageName = readElementText(); } else if (name() == qsl("script")) { @@ -1639,21 +1639,21 @@ int XMLimport::readAction(TAction* pParent) } else if (name() == qsl("css")) { pT->css = readElementText(); } else if (name() == qsl("commandButtonUp")) { - pT->mCommandButtonUp = readElementText(); + pT->setCommandButtonUp(readElementText()); } else if (name() == qsl("commandButtonDown")) { - pT->mCommandButtonDown = readElementText(); + pT->setCommandButtonDown(readElementText()); } else if (name() == qsl("icon")) { - pT->mIcon = readElementText(); + pT->setIcon(readElementText()); } else if (name() == qsl("orientation")) { pT->mOrientation = readElementText().toInt(); } else if (name() == qsl("location")) { pT->mLocation = readElementText().toInt(); } else if (name() == qsl("buttonRotation")) { - pT->mButtonRotation = readElementText().toInt(); + pT->setButtonRotation(readElementText().toInt()); } else if (name() == qsl("sizeX")) { - pT->mSizeX = readElementText().toInt(); + pT->setSizeX(readElementText().toInt()); } else if (name() == qsl("sizeY")) { - pT->mSizeY = readElementText().toInt(); + pT->setSizeY(readElementText().toInt()); } else if (name() == qsl("mButtonState")) { // We now use a boolean but file must use original "1" (false) // or "2" (true) for backward compatibility @@ -1662,7 +1662,10 @@ int XMLimport::readAction(TAction* pParent) // Not longer present/used, skip over it if it is still in file: skipCurrentElement(); } else if (name() == qsl("buttonColumn")) { - pT->mButtonColumns = readElementText().toInt(); + // The above ought to have been plural! + pT->setButtonColumns(readElementText().toInt()); + } else if (name() == qsl("buttonFillerOffset")) { + pT->setButtonFillerOffset(readElementText().toInt()); } else if (name() == qsl("posX")) { pT->mPosX = readElementText().toInt(); } else if (name() == qsl("posY")) { diff --git a/src/dlgActionMainArea.cpp b/src/dlgActionMainArea.cpp index 39392d7c2..6fe43b32c 100644 --- a/src/dlgActionMainArea.cpp +++ b/src/dlgActionMainArea.cpp @@ -1,7 +1,7 @@ /*************************************************************************** * Copyright (C) 2008-2009 by Heiko Koehn - KoehnHeiko@googlemail.com * * Copyright (C) 2014 by Ahmed Charles - acharles@outlook.com * - * Copyright (C) 2022 by Stephen Lyons - slysven@virginmedia.com * + * Copyright (C) 2022, 2026 by Stephen Lyons - slysven@virginmedia.com * * * * This program is free software; you can redistribute it and/or modify * * it under the terms of the GNU General Public License as published by * @@ -30,6 +30,11 @@ dlgActionMainArea::dlgActionMainArea(QWidget* pParentWidget) setupUi(this); connect(lineEdit_action_name, &QLineEdit::editingFinished, this, &dlgActionMainArea::slot_editingNameFinished); + connect(spinBox_action_bar_columns, &QSpinBox::valueChanged, this, &dlgActionMainArea::slot_setMaximumValueForOffset); + connect(comboBox_action_bar_orientation, &QComboBox::currentIndexChanged, this, &dlgActionMainArea::slot_setColumnsOrRowsCountText); + // Hide until we can resurrect icons on menus and buttons: + label_action_icon->hide(); + lineEdit_action_icon->hide(); } void dlgActionMainArea::trimName() @@ -41,3 +46,47 @@ void dlgActionMainArea::slot_editingNameFinished() { trimName(); } + +void dlgActionMainArea::slot_setMaximumValueForOffset(const int value) +{ + // Disable or hide the offset control if required: + if (value > 1) { + spinBox_action_bar_offsetToFirstButton->setMaximum(value - 1); + if (spinBox_action_bar_offsetToFirstButton->value() >= value) { + spinBox_action_bar_offsetToFirstButton->setValue(spinBox_action_bar_offsetToFirstButton->maximum()); + } + spinBox_action_bar_offsetToFirstButton->setEnabled(true); + label_action_bar_offsetToFirstButton->setEnabled(true); + spinBox_action_bar_offsetToFirstButton->setVisible(true); + label_action_bar_offsetToFirstButton->setVisible(true); + } else { + spinBox_action_bar_offsetToFirstButton->setMaximum(0); + spinBox_action_bar_offsetToFirstButton->setValue(0); + if (value == 1) { + spinBox_action_bar_offsetToFirstButton->setEnabled(false); + label_action_bar_offsetToFirstButton->setEnabled(false); + spinBox_action_bar_offsetToFirstButton->setVisible(true); + label_action_bar_offsetToFirstButton->setVisible(true); + } else { + /* A zero value has previously been allowed and it is possible that + * that value was intended to trigger the previous + * "mUseCustomLayout".*/ + spinBox_action_bar_offsetToFirstButton->setEnabled(false); + label_action_bar_offsetToFirstButton->setEnabled(false); + spinBox_action_bar_offsetToFirstButton->setVisible(false); + label_action_bar_offsetToFirstButton->setVisible(false); + } + } +} + +// index: 0 = horizontalm 1 = vertical +void dlgActionMainArea::slot_setColumnsOrRowsCountText(const int index) +{ + if (index > 0) { + //: A toolbar is being set to vertical orientation - so multiple rows of this number of columns + label_action_bar_columns->setText(tr("Number of columns:")); + } else { + //: A toolbar is being set to horizontal orientation - so multiple columns of this number of rows + label_action_bar_columns->setText(tr("Number of rows:")); + } +} diff --git a/src/dlgActionMainArea.h b/src/dlgActionMainArea.h index 320c6ecac..d5d09cefd 100644 --- a/src/dlgActionMainArea.h +++ b/src/dlgActionMainArea.h @@ -4,7 +4,7 @@ /*************************************************************************** * Copyright (C) 2008-2009 by Heiko Koehn - KoehnHeiko@googlemail.com * * Copyright (C) 2014 by Ahmed Charles - acharles@outlook.com * - * Copyright (C) 2022 by Stephen Lyons - slysven@virginmedia.com * + * Copyright (C) 2022, 2026 by Stephen Lyons - slysven@virginmedia.com * * * * This program is free software; you can redistribute it and/or modify * * it under the terms of the GNU General Public License as published by * @@ -40,6 +40,8 @@ public: private slots: void slot_editingNameFinished(); + void slot_setMaximumValueForOffset(const int); + void slot_setColumnsOrRowsCountText(const int); }; #endif // MUDLET_DLGACTIONMAINAREA_H diff --git a/src/dlgTriggerEditor.cpp b/src/dlgTriggerEditor.cpp index 305c175f3..b725aa08c 100644 --- a/src/dlgTriggerEditor.cpp +++ b/src/dlgTriggerEditor.cpp @@ -1215,6 +1215,7 @@ dlgTriggerEditor::dlgTriggerEditor(Host* pH) connect(mpActionsMainArea->lineEdit_action_button_command_up, &QLineEdit::editingFinished, this, &dlgTriggerEditor::slot_saveProperty_ActionCommandUp); connect(mpActionsMainArea->checkBox_action_button_isPushDown, &QCheckBox::toggled, this, &dlgTriggerEditor::slot_saveProperty_ActionIsPushDown); connect(mpActionsMainArea->spinBox_action_bar_columns, qOverload(&QSpinBox::valueChanged), this, &dlgTriggerEditor::slot_saveProperty_ActionBarColumns); + connect(mpActionsMainArea->spinBox_action_bar_offsetToFirstButton, qOverload(&QSpinBox::valueChanged), this, &dlgTriggerEditor::slot_saveProperty_ActionBarFillerOffset); connect(mpActionsMainArea->comboBox_action_bar_orientation, qOverload(&QComboBox::currentIndexChanged), this, &dlgTriggerEditor::slot_saveProperty_ActionBarOrientation); connect(mpActionsMainArea->comboBox_action_bar_location, qOverload(&QComboBox::currentIndexChanged), this, &dlgTriggerEditor::slot_saveProperty_ActionBarLocation); connect(mpActionsMainArea->comboBox_action_button_rotation, qOverload(&QComboBox::currentIndexChanged), this, &dlgTriggerEditor::slot_saveProperty_ActionButtonRotation); @@ -5379,9 +5380,6 @@ void dlgTriggerEditor::addAction(bool isFolder) QString name = isFolder ? tr("New menu") : tr("New button"); QStringList nameList = {name}; - const QString cmdButtonUp = ""; - const QString cmdButtonDown = ""; - const QString script = ""; QTreeWidgetItem* pParentItem = treeWidget_actions->currentItem(); QTreeWidgetItem* pNewItem = nullptr; @@ -5405,10 +5403,11 @@ void dlgTriggerEditor::addAction(bool isFolder) } } // Otherwise: insert a new root item + // CHECKME: doesn't this HAVE to be a toolbar - surely buttons MUST be in a container? if (!pNewAction) { name = isFolder ? tr("New toolbar") : tr("New button"); pNewAction = new TAction(name, mpHost); - pNewAction->setCommandButtonUp(cmdButtonUp); + pNewAction->setCommandButtonUp(QString()); QStringList nl; nl << name; pNewItem = new QTreeWidgetItem(mpActionBaseItem, nl); @@ -5417,12 +5416,12 @@ void dlgTriggerEditor::addAction(bool isFolder) // Initialize logic object properties pNewAction->setName(name); - pNewAction->setCommandButtonUp(cmdButtonUp); - pNewAction->setCommandButtonDown(cmdButtonDown); + pNewAction->setCommandButtonUp(QString()); + pNewAction->setCommandButtonDown(QString()); pNewAction->setIsPushDownButton(false); pNewAction->mLocation = 1; pNewAction->mOrientation = 1; - pNewAction->setScript(script); + pNewAction->setScript(QString()); pNewAction->setIsFolder(isFolder); pNewAction->setIsActive(false); pNewAction->registerAction(); @@ -6399,13 +6398,15 @@ void dlgTriggerEditor::saveAction() const QString script = mpSourceEditorEdbeeDocument->text(); // currentIndex() can return -1 if no setting was previously made - need to fixup: const int rotation = qMax(0, mpActionsMainArea->comboBox_action_button_rotation->currentIndex()); - const int columns = mpActionsMainArea->spinBox_action_bar_columns->text().toInt(); + const int columns = mpActionsMainArea->spinBox_action_bar_columns->value(); + const int offset = mpActionsMainArea->spinBox_action_bar_offsetToFirstButton->value(); const bool isChecked = mpActionsMainArea->checkBox_action_button_isPushDown->isChecked(); // bottom location is no longer supported i.e. location = 1 = 0 = location top // currentIndex() can return -1 if no setting was previously made - need to fixup: int location = qMax(0, mpActionsMainArea->comboBox_action_bar_location->currentIndex()); if (location > 0) { - location++; + // The comboBox has indexes of 0 to 4 but we don't use 1 so jump over it: + ++location; } // currentIndex() can return -1 if no setting was previously made - need to fixup: @@ -6439,6 +6440,7 @@ void dlgTriggerEditor::saveAction() pA->setIsActive(pA->shouldBeActive()); pA->setButtonRotation(rotation); pA->setButtonColumns(columns); + pA->setButtonFillerOffset(offset); pA->mUseCustomLayout = false; pA->css = mpActionsMainArea->plainTextEdit_action_css->toPlainText(); } @@ -8256,6 +8258,9 @@ void dlgTriggerEditor::slot_actionSelected(QTreeWidgetItem* pItem) mpActionsMainArea->comboBox_action_bar_orientation->setCurrentIndex(0); mpActionsMainArea->comboBox_action_button_rotation->setCurrentIndex(0); mpActionsMainArea->spinBox_action_bar_columns->setValue(1); + mpActionsMainArea->spinBox_action_bar_offsetToFirstButton->setMaximum(0); + mpActionsMainArea->spinBox_action_bar_offsetToFirstButton->setEnabled(false); + mpActionsMainArea->spinBox_action_bar_offsetToFirstButton->setValue(0); mpCurrentActionItem = pItem; //remember what has been clicked to save it // ID will be 0 for the root of the treewidget and it is not appropriate @@ -8274,6 +8279,7 @@ void dlgTriggerEditor::slot_actionSelected(QTreeWidgetItem* pItem) mpActionsMainArea->lineEdit_action_icon->setText(pT->getIcon()); mpActionsMainArea->lineEdit_action_button_command_down->setText(pT->getCommandButtonDown()); mpActionsMainArea->lineEdit_action_button_command_up->setText(pT->getCommandButtonUp()); + mpActionsMainArea->comboBox_action_button_rotation->setCurrentIndex(pT->getButtonRotation()); clearDocument(mpSourceEditorEdbee, pT->getScript()); restoreEditorState(EditorViewType::cmActionView, ID); @@ -8287,6 +8293,7 @@ void dlgTriggerEditor::slot_actionSelected(QTreeWidgetItem* pItem) mpActionsMainArea->comboBox_action_bar_orientation->setCurrentIndex(pT->mOrientation); mpActionsMainArea->comboBox_action_button_rotation->setCurrentIndex(pT->getButtonRotation()); mpActionsMainArea->spinBox_action_bar_columns->setValue(pT->getButtonColumns()); + mpActionsMainArea->spinBox_action_bar_offsetToFirstButton->setValue(pT->getButtonFillerOffset()); mpActionsMainArea->plainTextEdit_action_css->setPlainText(pT->css); if (pT->isFolder()) { if (!pT->mPackageName.isEmpty()) { @@ -9904,13 +9911,13 @@ void dlgTriggerEditor::changeView(EditorViewType view) case EditorViewType::cmActionView: mAddItem->setText(tr("Add Button")); mAddItem->setStatusTip(tr("Add new button")); - mAddGroup->setText(tr("Add Button Group")); - mAddGroup->setStatusTip(tr("Add new group of buttons")); - mDeleteItem->setText(tr("Delete Button")); - mDeleteItem->setStatusTip(tr("Delete the selected button")); - mSaveItem->setText(tr("Save Button")); + mAddGroup->setText(tr("Add Toolbar or Menu")); + mAddGroup->setStatusTip(tr("Add a Toolbar (top level) or Menu (lower levels) to contain menus or buttons")); + mDeleteItem->setText(tr("Delete Button, Menu or Toolbar")); + mDeleteItem->setStatusTip(tr("Delete the selected button, menu or toolbar")); + mSaveItem->setText(tr("Save item")); //: Status tip for saving button changes - mSaveItem->setStatusTip(tr("Apply button changes (does not save to disk).")); + mSaveItem->setStatusTip(tr("Apply button/menu/toolbar changes (does not save to disk).")); break; case EditorViewType::cmKeysView: mAddItem->setText(tr("Add Key")); @@ -14533,7 +14540,7 @@ pushTriggerPropertyCommand(EditorUndoStack* undoStack, Host* host, int triggerID } auto* cmd = new EditorModifyPropertyCommand(EditorViewType::cmTriggerView, triggerID, triggerName, oldStateXML, newStateXML, host); - cmd->setPropertyId(qsl("trigger:%1:%2").arg(triggerID).arg(propertyName)); + cmd->setPropertyId(qsl("trigger:%1:%2").arg(QString::number(triggerID), propertyName)); undoStack->pushCommand(cmd); } @@ -14818,7 +14825,7 @@ static void pushAliasPropertyCommand(EditorUndoStack* undoStack, Host* host, int } auto* cmd = new EditorModifyPropertyCommand(EditorViewType::cmAliasView, aliasID, aliasName, oldStateXML, newStateXML, host); - cmd->setPropertyId(qsl("alias:%1:%2").arg(aliasID).arg(propertyName)); + cmd->setPropertyId(qsl("alias:%1:%2").arg(QString::number(aliasID), propertyName)); undoStack->pushCommand(cmd); } @@ -14933,7 +14940,7 @@ static void pushTimerPropertyCommand(EditorUndoStack* undoStack, Host* host, int } auto* cmd = new EditorModifyPropertyCommand(EditorViewType::cmTimerView, timerID, timerName, oldStateXML, newStateXML, host); - cmd->setPropertyId(qsl("timer:%1:%2").arg(timerID).arg(propertyName)); + cmd->setPropertyId(qsl("timer:%1:%2").arg(QString::number(timerID), propertyName)); undoStack->pushCommand(cmd); } @@ -15030,7 +15037,7 @@ pushScriptPropertyCommand(EditorUndoStack* undoStack, Host* host, int scriptID, } auto* cmd = new EditorModifyPropertyCommand(EditorViewType::cmScriptView, scriptID, scriptName, oldStateXML, newStateXML, host); - cmd->setPropertyId(qsl("script:%1:%2").arg(scriptID).arg(propertyName)); + cmd->setPropertyId(qsl("script:%1:%2").arg(QString::number(scriptID), propertyName)); undoStack->pushCommand(cmd); } @@ -15102,7 +15109,7 @@ static void pushKeyPropertyCommand(EditorUndoStack* undoStack, Host* host, int k } auto* cmd = new EditorModifyPropertyCommand(EditorViewType::cmKeysView, keyID, keyName, oldStateXML, newStateXML, host); - cmd->setPropertyId(qsl("key:%1:%2").arg(keyID).arg(propertyName)); + cmd->setPropertyId(qsl("key:%1:%2").arg(QString::number(keyID), propertyName)); undoStack->pushCommand(cmd); } @@ -15171,7 +15178,7 @@ pushActionPropertyCommand(EditorUndoStack* undoStack, Host* host, int actionID, } auto* cmd = new EditorModifyPropertyCommand(EditorViewType::cmActionView, actionID, actionName, oldStateXML, newStateXML, host); - cmd->setPropertyId(qsl("action:%1:%2").arg(actionID).arg(propertyName)); + cmd->setPropertyId(qsl("action:%1:%2").arg(QString::number(actionID), propertyName)); undoStack->pushCommand(cmd); } @@ -15299,7 +15306,32 @@ void dlgTriggerEditor::slot_saveProperty_ActionBarColumns() pT->setButtonColumns(newValue); QString newStateXML = exportActionToXML(pT); - pushActionPropertyCommand(mpUndoStack, mpHost, actionID, pT->getName(), qsl("barColumns"), oldStateXML, newStateXML); + pushActionPropertyCommand(mpUndoStack, mpHost, actionID, pT->getName(), qsl("buttonColumn"), oldStateXML, newStateXML); +} + +void dlgTriggerEditor::slot_saveProperty_ActionBarFillerOffset() +{ + if (mBlockPropertySave || !mpCurrentActionItem) { + return; + } + + const int actionID = mpCurrentActionItem->data(0, Qt::UserRole).toInt(); + TAction* pT = mpHost->getActionUnit()->getAction(actionID); + if (!pT) { + return; + } + + const int newValue = mpActionsMainArea->spinBox_action_bar_offsetToFirstButton->value(); + + if (pT->getButtonFillerOffset() == newValue) { + return; + } + + QString oldStateXML = exportActionToXML(pT); + pT->setButtonFillerOffset(newValue); + QString newStateXML = exportActionToXML(pT); + + pushActionPropertyCommand(mpUndoStack, mpHost, actionID, pT->getName(), qsl("buttonFillerOffset"), oldStateXML, newStateXML); } void dlgTriggerEditor::slot_saveProperty_ActionBarOrientation() @@ -15314,6 +15346,7 @@ void dlgTriggerEditor::slot_saveProperty_ActionBarOrientation() return; } + // 0 = horizontal, 1 = vertical const int newValue = mpActionsMainArea->comboBox_action_bar_orientation->currentIndex(); if (pT->mOrientation == newValue) { @@ -15324,7 +15357,7 @@ void dlgTriggerEditor::slot_saveProperty_ActionBarOrientation() pT->mOrientation = newValue; QString newStateXML = exportActionToXML(pT); - pushActionPropertyCommand(mpUndoStack, mpHost, actionID, pT->getName(), qsl("barOrientation"), oldStateXML, newStateXML); + pushActionPropertyCommand(mpUndoStack, mpHost, actionID, pT->getName(), qsl("orientation"), oldStateXML, newStateXML); } void dlgTriggerEditor::slot_saveProperty_ActionBarLocation() @@ -15339,6 +15372,7 @@ void dlgTriggerEditor::slot_saveProperty_ActionBarLocation() return; } + // CHECKME: This may need the increment if it isn't zero! const int newValue = mpActionsMainArea->comboBox_action_bar_location->currentIndex(); if (pT->mLocation == newValue) { diff --git a/src/dlgTriggerEditor.h b/src/dlgTriggerEditor.h index b1bdad8ec..942301296 100644 --- a/src/dlgTriggerEditor.h +++ b/src/dlgTriggerEditor.h @@ -379,6 +379,7 @@ private slots: void slot_saveProperty_ActionCommandUp(); void slot_saveProperty_ActionIsPushDown(); void slot_saveProperty_ActionBarColumns(); + void slot_saveProperty_ActionBarFillerOffset(); void slot_saveProperty_ActionBarOrientation(); void slot_saveProperty_ActionBarLocation(); void slot_saveProperty_ActionButtonRotation(); diff --git a/src/ui/actions_main_area.ui b/src/ui/actions_main_area.ui index 4d9a34c96..0b8ab41a6 100644 --- a/src/ui/actions_main_area.ui +++ b/src/ui/actions_main_area.ui @@ -7,7 +7,7 @@ 0 0 625 - 300 + 322 @@ -22,7 +22,7 @@ 0 - + 2 @@ -64,6 +64,9 @@ Qt::AlignRight|Qt::AlignTrailing|Qt::AlignVCenter + + lineEdit_action_name + @@ -174,7 +177,7 @@ - Number of columns/rows (depending on orientation): + Number of rows: Qt::AlignRight|Qt::AlignTrailing|Qt::AlignVCenter @@ -187,7 +190,30 @@ - + + + + false + + + Offset of first button: + + + Qt::AlignRight|Qt::AlignTrailing|Qt::AlignVCenter + + + spinBox_action_bar_offsetToFirstButton + + + + + + + false + + + + @@ -207,7 +233,7 @@ - + @@ -266,6 +292,9 @@ Qt::AlignRight|Qt::AlignTrailing|Qt::AlignVCenter + + comboBox_action_button_rotation + @@ -308,6 +337,9 @@ Qt::AlignRight|Qt::AlignTrailing|Qt::AlignVCenter + + lineEdit_action_button_command_down + @@ -328,6 +360,9 @@ Qt::AlignRight|Qt::AlignTrailing|Qt::AlignVCenter + + lineEdit_action_button_command_up + @@ -340,6 +375,32 @@ + + + + false + + + Icon + + + Qt::AlignRight|Qt::AlignTrailing|Qt::AlignVCenter + + + lineEdit_action_icon + + + + + + + false + + + ForbiddenCursor + + + @@ -403,25 +464,24 @@ - - - - false - - - - 0 - 0 - - - - - lineEdit_action_icon widget_top groupBox_css widget_middle + + lineEdit_action_name + spinBox_action_bar_columns + spinBox_action_bar_offsetToFirstButton + comboBox_action_bar_orientation + comboBox_action_bar_location + comboBox_action_button_rotation + checkBox_action_button_isPushDown + lineEdit_action_button_command_down + lineEdit_action_button_command_up + lineEdit_action_icon + plainTextEdit_action_css + From 8dd99e4db61445c79d7c59930cb9b278961c02ed Mon Sep 17 00:00:00 2001 From: Mike Conley Date: Wed, 5 Aug 2026 00:34:43 -0400 Subject: [PATCH 084/155] Fix: Sounds going silent when a file fails to load (#9612) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit #### Brief overview of PR changes/additions Follow-up hardening on top of #9569. Two ways a media player could end up silent while still holding its source, plus the crash and the test gaps found chasing them. **A track that fails to load.** Nothing in `TMedia` listened for `QMediaPlayer::errorOccurred`. A player that was already stopped when its source failed reports no playback state change — and that signal is what ends a playback, releases the source and raises `sysMediaFinished`. The track fell silent holding a file nothing would ever release. The error is now acted on. **A track stopped while it is still loading.** Qt already considers an unstarted player stopped, so `stop()` draws no state change out of one mid-load, with the same result. This is not a narrow race: on an asynchronous backend the Linux and Windows runners hit it every time. `stopMedia()` now ends such a playback itself instead of waiting for a report that is never coming. Around those: - The deferred source release is a single function shared by the stop, error and teardown paths. Whether the player's own state gets a say differs between them, so callers pass a `PlaybackEnd`: a stop needs it, because a restart may be in flight and a player loading its next source looks identical to a stopped one; a failure must *not* have it, because a backend can report `PlayingState` for media it has just failed to load. - Re-sourcing a player goes through `claimSource()`, `continuePlaying()` and `releaseSource()`, so the generation bump that tells a pending release the track has moved on cannot be forgotten at a call site. A missed bump is what let an earlier revision of #9569 clear the source of a track that had just been restarted. - `stopMedia()` empties the playlist, so an explicit stop cannot leave a loop armed to restart itself from the `EndOfMedia` handler. - `setupVideo()` failing now releases the source it claimed, and hides the video widget only under the same `mediaWidget`/`mediaClose` guards the deferred release uses — previously it could hide a label belonging to an earlier clip. - `src/dlgTriggerEditor.cpp` is here for one guard: `runScheduledCleanReset()` repopulates itself from a `Host` that a profile teardown has already destroyed. Unrelated to media, but it crashed the media tests once they started running. Behaviour worth knowing about when reviewing: - `sysMediaFinished` now fires for a failed load and for a stop issued mid-load, where nothing fired before. It is suppressed when the source has already been released, where it would only have carried an empty file name and path. - `purgeMediaCache()` returns `false` when the directory could not be fully removed, instead of always returning `true`. - The closing closed caption is suppressed between the passes of a looping track, and printed by `stopAllMediaPlayers()`, which releases synchronously. - `TMedia` gains three read-only diagnostics used by the tests — `playersHoldingSource()`, `mediaPlayerCount()` and `playersInPlayingState()`. A deferred release is otherwise unobservable: `playingMedia()` has already dropped the player, the caption needs captions enabled, and the video signal needs a widget. Tests: new slots for a finite `loops=N` track, an explicit stop, an unplayable source and a reused player. `probeBackend()` measures what the backend can demonstrate — whether it starts playback at all, decodes to `EndOfMedia`, orders `EndOfMedia` against `StoppedState`, starts synchronously, and reports an undecodable file — and each test skips on the capabilities it needs, printing what was measured. `QT_MEDIA_BACKEND` is pinned to whatever `main.cpp` ships per platform, since `QTEST_MAIN` does not run `main.cpp` and the tests were otherwise exercising Qt's default backend rather than the one users get. #### Motivation for adding to Mudlet Both silent-failure cases are real and user-visible. A game sending a filename Qt cannot decode, or a file gone from the media cache, would kill the sound and leak the player's source while reporting nothing; and `stopMusic()` shortly after `playMusic()` would leak the source every time on Windows and Linux. A script chaining tracks off `sysMediaFinished` waited forever in both cases. They share a root cause with #9566: the deferred release could not tell what the player was doing when its turn came around. The `claimSource()`/`continuePlaying()`/`releaseSource()` encapsulation is the durable part — it turns "remember to bump the counter" from a convention into something the API does for you. The test work matters as much as the fixes. The #9566 regression guard was skipping on every CI job, so it was protecting nothing; both bugs above were caught only once it actually ran. #### Other info (issues closed, discussion etc) Follow-up to #9569 / #9566. No issue number of its own. Testing notes: the full functional suite passes — 66/66 on Linux, and the media suite is green on the Ubuntu, Windows and both macOS jobs. Backends differ in what they can demonstrate, so some media tests skip by design. Under the environment ctest uses, six of the seven skip on macOS: the `darwin` backend starts playback synchronously and delivers `EndOfMedia` before `StoppedState`, so it can stage neither the claim race nor the #9566 ordering, and it does not decode under `QT_QPA_PLATFORM=offscreen`. Those paths run on the Ubuntu and Windows FFmpeg builds, which is where both bugs in this PR were caught. Every skip prints what the backend could not demonstrate and why, so an inert guard is visible rather than silent. --------- Signed-off-by: Michael Conley --- .github/workflows/build-mudlet-pr.yml | 5 + .github/workflows/build-mudlet-win-pr.yml | 5 + src/TLuaInterpreterMedia.cpp | 3 +- src/TMedia.cpp | 394 +++++++++++++---- src/TMedia.h | 82 +++- src/dlgProfilePreferences.cpp | 20 +- src/dlgTriggerEditor.cpp | 8 + test/functional_tests/CMakeLists.txt | 16 +- test/functional_tests/TMediaLoopTest.cpp | 488 ++++++++++++++++++---- 9 files changed, 836 insertions(+), 185 deletions(-) diff --git a/.github/workflows/build-mudlet-pr.yml b/.github/workflows/build-mudlet-pr.yml index 93dc7a9d6..9fb032592 100644 --- a/.github/workflows/build-mudlet-pr.yml +++ b/.github/workflows/build-mudlet-pr.yml @@ -411,6 +411,11 @@ jobs: env: QT_QPA_PLATFORM: offscreen QT_FORCE_STDERR_LOGGING: 1 + # This runner has Qt's FFmpeg backend and can decode, so TMediaLoopTest must + # demonstrate every media behaviour rather than skip any of them. Without a floor + # somewhere, a lost codec or a changed default backend would turn the whole file + # green-by-skip on every platform and say nothing about it. + MUDLET_MEDIA_TESTS_REQUIRE_PLAYBACK: 1 - name: (macOS) Run C++ tests if: runner.os == 'macOS' diff --git a/.github/workflows/build-mudlet-win-pr.yml b/.github/workflows/build-mudlet-win-pr.yml index b0b6c3fee..5eca3f421 100644 --- a/.github/workflows/build-mudlet-win-pr.yml +++ b/.github/workflows/build-mudlet-win-pr.yml @@ -140,6 +140,11 @@ jobs: ctest --test-dir $GITHUB_WORKSPACE/build-$MSYSTEM/test --output-on-failure env: QT_FORCE_STDERR_LOGGING: 1 + # This runner has Qt's FFmpeg backend and can decode, so TMediaLoopTest must + # demonstrate every media behaviour rather than skip any of them. Without a floor + # somewhere, a lost codec or a changed default backend would turn the whole file + # green-by-skip on every platform and say nothing about it. + MUDLET_MEDIA_TESTS_REQUIRE_PLAYBACK: 1 - name: (Windows) Run Lua tests timeout-minutes: 2 diff --git a/src/TLuaInterpreterMedia.cpp b/src/TLuaInterpreterMedia.cpp index 7b1da0e09..204bad28e 100644 --- a/src/TLuaInterpreterMedia.cpp +++ b/src/TLuaInterpreterMedia.cpp @@ -2706,7 +2706,6 @@ int TLuaInterpreter::pauseVideos(lua_State* L) int TLuaInterpreter::purgeMediaCache(lua_State* L) { Host& host = getHostFromLua(L); - host.mTelnet.purgeMediaCache(); - lua_pushboolean(L, true); + lua_pushboolean(L, host.mTelnet.purgeMediaCache()); return 1; } diff --git a/src/TMedia.cpp b/src/TMedia.cpp index c5985d6a6..a11d4ff32 100644 --- a/src/TMedia.cpp +++ b/src/TMedia.cpp @@ -317,6 +317,24 @@ void TMedia::stopMedia(TMediaData& mediaData) continue; } + // A pooled player between tracks holds no source and has nothing to stop. Criteria this + // broad are the common case - a bare stopMusic() or Client.Media.Stop {} matches every + // player there is - so without this each idle one would be ended all over again, and + // told about with an empty file name and the key and tag of its last track. + if (!pPlayer->mediaPlayer() || pPlayer->mediaPlayer()->source().isEmpty()) { + continue; + } + + // Whichever way this track is being ended below, it is not to start again. A looping + // or multi-entry track restarts itself from the EndOfMedia handler in + // connectMediaPlayer(), which would undo the stop that was just asked for - on a + // StoppedState-first backend that signal can still be on its way when the stop + // arrives. An emptied playlist is what that handler checks, and play() builds a fresh + // one whenever this player is picked up again. + if (pPlayer->playlist()) { + pPlayer->playlist()->clear(); + } + if ((mediaData.mediaFadeAway() == TMediaData::MediaFadeAwayEnabled || mediaData.mediaFadeOut() != TMediaData::MediaFadeNotSet) && pPlayer->mediaData().mediaEnd() == TMediaData::MediaEndNotSet) { const int finishPosition = pPlayer->mediaData().mediaFinish(); @@ -340,7 +358,22 @@ void TMedia::stopMedia(TMediaData& mediaData) } // **Stop the player but keep it for reuse** + // Only a player that had started reports a change back to StoppedState, and that + // signal is what ends the playback and releases the source. One that is still loading + // - where a stop issued soon after a play lands on an asynchronous backend - is + // already stopped as far as Qt is concerned, so it reports nothing and its source + // would be held for good. + const bool willReportItsOwnStop = pPlayer->getPlaybackState() != QMediaPlayer::StoppedState; + pPlayer->mediaPlayer()->stop(); + + if (!willReportItsOwnStop) { + releaseMediaSourceAfterEvents(pPlayer, pPlayer->mediaData(), PlaybackEnd::Stopped); + // Announced at most once per playback, so a handler that stops the media it has + // just been told about does not arrive back here for the same track: the source it + // reads as live stays set until the deferred release above runs. + raiseMediaFinishedEvent(pPlayer, pPlayer->mediaPlayer()->source(), pPlayer->mediaData()); + } } } @@ -394,7 +427,12 @@ bool TMedia::purgeMediaCache() } stopAllMediaPlayers(); - mediaDir.removeRecursively(); + + if (!mediaDir.removeRecursively()) { + qWarning() << qsl("TMedia::purgeMediaCache() WARNING - not able to remove all of directory: %1").arg(mediaPath); + return false; + } + return true; } @@ -564,11 +602,53 @@ void TMedia::stopAllMediaPlayers() QList> mediaPlayerList = findMediaPlayersByCriteria(mediaData); for (const auto& pPlayer : std::as_const(mediaPlayerList)) { - if (!pPlayer) { - continue; + if (!pPlayer || !pPlayer->mediaPlayer() || pPlayer->mediaPlayer()->source().isEmpty()) { + continue; // A pooled player between tracks has nothing playing to stop + } + + // Everything the ending is described by has to be read before the source goes, because + // releasing is what makes it unreadable. + const TMediaData endedData = pPlayer->mediaData(); + const QUrl endedUrl = pPlayer->mediaPlayer()->source(); + const bool hadVideoOutput = pPlayer->mediaPlayer()->videoOutput() != nullptr; + const quint64 claimedAt = pPlayer->claimGeneration(); + + // No loop is to survive this: the EndOfMedia handler restarts one from the playlist, + // and a StoppedState-first backend can still have that signal on its way. + if (pPlayer->playlist()) { + pPlayer->playlist()->clear(); } pPlayer->mediaPlayer()->stop(); + + // stop() can deliver StoppedState synchronously, whose handler raises sysMediaFinished + // and so lets a script hand this player straight to another track. The release below is + // direct - it carries no generation of its own for releaseMediaSourceAfterEvents()' + // checks to catch - so this is the one thing standing between that new track and having + // its source cleared out from under it. + if (pPlayer->claimGeneration() != claimedAt) { + continue; + } + + // Released here rather than left to releaseMediaSourceAfterEvents(): this is a + // teardown, so there is no loop left to restart and no reason to wait a turn, and a + // caller may need the files free straight away - purgeMediaCache() deletes them. The + // empty source left behind is also what tells any release already scheduled for this + // player to stay quiet when its turn comes, so nothing is said twice. + pPlayer->releaseSource(); + + if (endedData.mediaWidget() == TMediaData::MediaWidgetLabel && endedData.mediaClose() == TMediaData::MediaCloseEnabled && hadVideoOutput) { + emit signal_hideVideoOutput(pPlayer.get()); + } + + // Announced from here because releasing synchronously means no deferred turn will do + // it: on a backend that reports StoppedState asynchronously nothing else ever would, + // and a script waiting on sysMediaFinished would sit through the teardown none the + // wiser. Skipped when stop() above already announced it - see endAnnounced(). + raiseMediaFinishedEvent(pPlayer, endedUrl, endedData); + + //: This word is part of a sentence like "Music stops" when the music is about to stop. + printClosedCaption(endedData, tr("stops")); } } @@ -588,23 +668,25 @@ int TMedia::playersHoldingSource() const + countHeld(mAPIVideoList); } -// The cleanup that releases a stopped player's source runs one event-loop turn -// after the stop (see handlePlayerPlaybackStateChanged), so a player reused for -// a new play request can still hold the file it just finished. Replaying that -// same file leaves QMediaPlayer with its media already loaded, so play() starts -// it synchronously, raising sysMediaStarted re-entrantly inside the script call -// that started it. Finish the deferred cleanup here instead, so every fresh -// play request loads its media asynchronously, as it did when the cleanup ran -// at stop time. -void TMedia::releaseStoppedSource(const std::shared_ptr& player) +int TMedia::playersInPlayingState() const { - if (!player || !player->mediaPlayer()) { - return; - } + const auto countPlaying = [](const QList>& list) { + int playing = 0; + for (const auto& player : list) { + if (player && player->getPlaybackState() == QMediaPlayer::PlayingState) { + ++playing; + } + } + return playing; + }; - if (player->getPlaybackState() == QMediaPlayer::StoppedState && !player->mediaPlayer()->source().isEmpty()) { - player->mediaPlayer()->setSource(QUrl()); - } + return countPlaying(mMSPSoundList) + countPlaying(mMSPMusicList) + countPlaying(mGMCPSoundList) + countPlaying(mGMCPMusicList) + countPlaying(mGMCPVideoList) + countPlaying(mAPISoundList) + + countPlaying(mAPIMusicList) + countPlaying(mAPIVideoList); +} + +int TMedia::mediaPlayerCount() const +{ + return mMSPSoundList.size() + mMSPMusicList.size() + mGMCPSoundList.size() + mGMCPMusicList.size() + mGMCPVideoList.size() + mAPISoundList.size() + mAPIMusicList.size() + mAPIVideoList.size(); } void TMedia::setMediaPlayersMuted(const TMediaData::MediaProtocol mediaProtocol, const bool state) @@ -1086,7 +1168,7 @@ QString TMedia::setupMediaAbsolutePathFileName(TMediaData& mediaData) void TMedia::connectMediaPlayer(std::shared_ptr& player) { - if (!player) { + if (!player || !player->mediaPlayer()) { qWarning() << qsl("TMedia::connectMediaPlayer() WARNING - Attempted to connect a null TMediaPlayer."); return; } @@ -1112,20 +1194,80 @@ void TMedia::connectMediaPlayer(std::shared_ptr& player) QUrl nextMedia = lockedPlayer->playlist()->next(); if (!nextMedia.isEmpty()) { - lockedPlayer->noteContinued(); - lockedPlayer->mediaPlayer()->setSource(nextMedia); - lockedPlayer->mediaPlayer()->play(); + lockedPlayer->continuePlaying(nextMedia); } else if (lockedPlayer->playlist()->playbackMode() == TMediaPlaylist::Loop) { - lockedPlayer->noteContinued(); lockedPlayer->playlist()->setCurrentIndex(0); - lockedPlayer->mediaPlayer()->setSource(lockedPlayer->playlist()->currentMedia()); - lockedPlayer->mediaPlayer()->play(); + lockedPlayer->continuePlaying(lockedPlayer->playlist()->currentMedia()); } } } } }); + // Error connection + disconnect(player->mediaPlayer(), &QMediaPlayer::errorOccurred, nullptr, nullptr); + connect(player->mediaPlayer(), &QMediaPlayer::errorOccurred, this, [this, weakPlayer](QMediaPlayer::Error error, const QString& errorString) { + const auto lockedPlayer = weakPlayer.lock(); + + if (!lockedPlayer || !lockedPlayer->mediaPlayer() || error == QMediaPlayer::NoError) { + return; + } + + qWarning().noquote() << qsl("TMedia::connectMediaPlayer() WARNING - media player error %1 on \"%2\": %3") + .arg(QString::number(static_cast(error)), lockedPlayer->mediaPlayer()->source().toString(), errorString); + + if (mudlet::smDebugMode && mpHost && mpHost->mpConsole) { + //: %1 is the media backend's own description of what went wrong, e.g. "Failed to load media". + mpHost->mpConsole->printSystemMessage(qsl("%1\n").arg(tr("Media error: %1").arg(errorString))); + } + + // Only a failure nothing else will report is ended from here. A track that was playing + // reports StoppedState when the error takes it down, and the playback state handler + // ends it from there. That leaves two cases: a player already stopped, which is where a + // load failure lands because claimSource() leaves it stopped and there is no state to + // change from; and Qt's darwin backend, which reports PlayingState for media it has + // just failed to load and then never moves off it. InvalidMedia catches that second + // case and only that one - it cannot be asked to carry the first, because Qt's FFmpeg + // backend raises this signal before it sets the status. + if (lockedPlayer->mediaPlayer()->mediaStatus() != QMediaPlayer::InvalidMedia && lockedPlayer->getPlaybackState() != QMediaPlayer::StoppedState) { + return; + } + + // Nothing else will end it: a source set on a player that was already stopped - which + // is what every claimSource() on a new or finished player does, and what a loop restart + // or playlist advance does from the EndOfMedia handler - has no state to change from. + // Left alone the track falls silent still holding a source nothing will ever release, + // and a script waiting on sysMediaFinished to start the next one waits forever. + // + // Ended a turn from now rather than here, because setSource() can deliver this error + // synchronously from inside claimSource(): sysMediaFinished would then reach a script + // in the middle of the playMusic() call that asked for the track, and a handler that + // responds by playing the same undecodable file again would recurse until the stack + // gave out. The claim generation says whether this failure is still anyone's to report + // by the time the turn comes: a track that took the player over in between owns it now. + const quint64 claimedAt = lockedPlayer->claimGeneration(); + + QTimer::singleShot(0, this, [this, weakPlayer, claimedAt] { + const auto endingPlayer = weakPlayer.lock(); + + if (!endingPlayer || !endingPlayer->mediaPlayer() || endingPlayer->claimGeneration() != claimedAt) { + return; + } + + // The release armed below ignores playback state by design, since darwin claims to + // be playing media it has just failed to load. That makes this the only place an + // error the backend recovered from can be told apart from one it did not: a turn + // on, media it has condemned says so with InvalidMedia, and media that is playing + // without having been condemned is fine after all and must be left alone. + if (endingPlayer->mediaPlayer()->mediaStatus() != QMediaPlayer::InvalidMedia && endingPlayer->getPlaybackState() == QMediaPlayer::PlayingState) { + return; + } + + releaseMediaSourceAfterEvents(endingPlayer, endingPlayer->mediaData(), PlaybackEnd::Failed); + raiseMediaFinishedEvent(endingPlayer, endingPlayer->mediaPlayer()->source(), endingPlayer->mediaData()); + }); + }); + // Playback state changed connection disconnect(player->mediaPlayer(), &QMediaPlayer::playbackStateChanged, nullptr, nullptr); connect(player->mediaPlayer(), &QMediaPlayer::playbackStateChanged, this, [this, weakPlayer](QMediaPlayerPlaybackState playbackState) { @@ -1381,6 +1523,128 @@ void TMedia::getMediaPlayerCounts(int& soundPlayers, int& musicPlayers, int& sto } #endif // MUDLET_MEMORY_TRACKING +// Tells scripts a playback is over. Raised for a failed load as well as for a stop, because a +// script that starts its next track from sysMediaFinished otherwise waits forever on the first +// file the backend cannot decode. +void TMedia::raiseMediaFinishedEvent(const std::shared_ptr& player, const QUrl& endedUrl, const TMediaData& endedData) +{ + if (!mpHost || !player) { + return; + } + + if (endedUrl.isEmpty()) { + // A pooled player between tracks. There is no playback to report, and the event would + // carry an empty file name and path with the key and tag of whatever it last played. + return; + } + + if (player->endAnnounced()) { + // Already reported by whichever of the stop, the error and the StoppedState got here + // first - see TMediaPlayer::endAnnounced(). + return; + } + + // Set before the handlers run, not after: raiseEvent() dispatches synchronously, and a + // handler that stops this player would otherwise arrive back here and announce again. + player->noteEndAnnounced(); + + TEvent mediaFinished{}; + mediaFinished.mArgumentList.append(qsl("sysMediaFinished")); + + mediaFinished.mArgumentList.append(endedUrl.fileName()); + mediaFinished.mArgumentList.append(endedUrl.path()); + mediaFinished.mArgumentList.append(mediaTypeToString(endedData.mediaType())); + mediaFinished.mArgumentList.append(endedData.mediaKey()); + mediaFinished.mArgumentList.append(endedData.mediaTag()); + mediaFinished.mArgumentTypeList.append(ARGUMENT_TYPE_STRING); + mediaFinished.mArgumentTypeList.append(ARGUMENT_TYPE_STRING); + mediaFinished.mArgumentTypeList.append(ARGUMENT_TYPE_STRING); + mediaFinished.mArgumentTypeList.append(ARGUMENT_TYPE_STRING); + mediaFinished.mArgumentTypeList.append(ARGUMENT_TYPE_STRING); + mediaFinished.mArgumentTypeList.append(ARGUMENT_TYPE_STRING); + + mpHost->raiseEvent(mediaFinished); +} + +// Ends a playback: releases the media source and prints the closing caption, one event-loop +// turn from now. Deferred so a StoppedState-first backend can still emit the EndOfMedia that +// restarts a loop - clearing the source immediately destroys the playback engine and that +// signal never arrives (#9566). See TMediaPlayer for the generation counters this compares. +// +// endedBy decides whether the player's own state gets a say in the deferred turn. A stop needs +// it: on an EndOfMedia-first backend the restart happened before the snapshot, so the +// continuation counter cannot see it and a player still reporting PlayingState is the only sign +// the track carried on. A failure must not have it, because a backend can report PlayingState +// for media it has just failed to load (Qt 6.9's darwin backend does), and believing that would +// leave the dead source held forever - no state change follows to schedule another release. +void TMedia::releaseMediaSourceAfterEvents(const std::shared_ptr& player, const TMediaData& endedData, const PlaybackEnd endedBy) +{ + const bool playbackStateDecides = (endedBy == PlaybackEnd::Stopped); + + if (!player->mediaPlayer() || player->mediaPlayer()->source().isEmpty()) { + // Nothing left to end, so no caption for it either + qDebug() << "TMedia::releaseMediaSourceAfterEvents() - asked to end a playback that is already holding no source; nothing to do."; + return; + } + + const std::weak_ptr weakPlayer = player; + const quint64 claimedAt = player->claimGeneration(); + const quint64 continuedAt = player->continuationGeneration(); + + QTimer::singleShot(0, this, [this, weakPlayer, endedData, claimedAt, continuedAt, playbackStateDecides] { + const auto lockedPlayer = weakPlayer.lock(); + const bool stillOurs = lockedPlayer && lockedPlayer->claimGeneration() == claimedAt; + // Two ways the same playback can have carried on during the deferred turn. On a + // StoppedState-first backend the loop restarts from the EndOfMedia handler after the + // snapshot above, so the counter is what sees it; on an EndOfMedia-first backend the + // restart already happened before the snapshot, so the counter cannot see it and the + // player still reporting PlayingState is. + const bool sameMediaContinues = + lockedPlayer && (lockedPlayer->continuationGeneration() != continuedAt || (playbackStateDecides && stillOurs && lockedPlayer->getPlaybackState() == QMediaPlayer::PlayingState)); + + if (sameMediaContinues) { + // No caption either: nothing ended, so "stops" between the passes of a looping + // track would be wrong. Logged because this is the one outcome that keeps a source + // on purpose, which makes it the first thing to rule out when one is held too long. + qDebug() << "TMedia::releaseMediaSourceAfterEvents() - the same playback carried on into another pass; keeping its source."; + return; + } + + // Releasing bumps no generation, so any path that clears the source itself leaves a + // pending turn still looking entitled to end this playback - an error and the stop + // that follows it, stopAllMediaPlayers(), the setupVideo() failure in play(). Each of + // those announces its own ending, so this one has nothing left to do or to say. + if (stillOurs && lockedPlayer->mediaPlayer() && lockedPlayer->mediaPlayer()->source().isEmpty()) { + qDebug() << "TMedia::releaseMediaSourceAfterEvents() - this playback was already ended by whoever released the source; nothing left to do."; + return; + } + + if (!lockedPlayer) { + qDebug() << "TMedia::releaseMediaSourceAfterEvents() - player was destroyed before its deferred release ran; its destructor released the source."; + } else if (!stillOurs) { + // A claimed player is already loading the source of the track that took it over, + // which on an asynchronous backend still reads as stopped. + qDebug() << "TMedia::releaseMediaSourceAfterEvents() - another track claimed this player before its deferred release ran; keeping the new source."; + } else if (!lockedPlayer->mediaPlayer()) { + qWarning() << "TMedia::releaseMediaSourceAfterEvents() WARNING - mediaPlayer() is null, cannot release the media source."; + } else if (playbackStateDecides && lockedPlayer->getPlaybackState() != QMediaPlayer::StoppedState) { + qDebug() << "TMedia::releaseMediaSourceAfterEvents() - player is no longer stopped, keeping its source."; + } else { + qDebug() << "TMedia::releaseMediaSourceAfterEvents() - releasing the media source of the playback that ended."; + lockedPlayer->releaseSource(); + + if (endedData.mediaWidget() == TMediaData::MediaWidgetLabel && endedData.mediaClose() == TMediaData::MediaCloseEnabled && lockedPlayer->mediaPlayer()->videoOutput() != nullptr) { + emit signal_hideVideoOutput(lockedPlayer.get()); + } + } + + // Printed on every path that got past the continuation check: the track this release + // was scheduled for is over regardless of what has become of the player since. + //: This word is part of a sentence like "Music stops" when the music is about to stop. + printClosedCaption(endedData, tr("stops")); + }); +} + void TMedia::handlePlayerPlaybackStateChanged(QMediaPlayerPlaybackState playbackState, const std::shared_ptr& player) { if (!player) { @@ -1388,60 +1652,20 @@ void TMedia::handlePlayerPlaybackStateChanged(QMediaPlayerPlaybackState playback } if (playbackState == QMediaPlayer::StoppedState) { - // Captured before the event below, because a sysMediaFinished handler runs - // synchronously and may hand this player to the next track. - const std::weak_ptr weakPlayer = player; - const TMediaData stoppedData = player->mediaData(); - const quint64 claimGeneration = player->claimGeneration(); - const quint64 continuationGeneration = player->continuationGeneration(); - - TEvent mediaFinished{}; - mediaFinished.mArgumentList.append(qsl("sysMediaFinished")); - - const QUrl mediaUrl = player->mediaPlayer()->source(); - mediaFinished.mArgumentList.append(mediaUrl.fileName()); - mediaFinished.mArgumentList.append(mediaUrl.path()); - mediaFinished.mArgumentList.append(mediaTypeToString(player->mediaData().mediaType())); - mediaFinished.mArgumentList.append(player->mediaData().mediaKey()); - mediaFinished.mArgumentList.append(player->mediaData().mediaTag()); - mediaFinished.mArgumentTypeList.append(ARGUMENT_TYPE_STRING); - mediaFinished.mArgumentTypeList.append(ARGUMENT_TYPE_STRING); - mediaFinished.mArgumentTypeList.append(ARGUMENT_TYPE_STRING); - mediaFinished.mArgumentTypeList.append(ARGUMENT_TYPE_STRING); - mediaFinished.mArgumentTypeList.append(ARGUMENT_TYPE_STRING); - mediaFinished.mArgumentTypeList.append(ARGUMENT_TYPE_STRING); - - if (mpHost) { - mpHost->raiseEvent(mediaFinished); + if (!player->mediaPlayer() || player->mediaPlayer()->source().isEmpty()) { + // Whoever released the source already ended this playback and raised its event. A + // second one from here would carry an empty file name and path, because the URL + // they describe is exactly what was just cleared. + qDebug() << "TMedia::handlePlayerPlaybackStateChanged() - stopped a player that is already holding no source; its playback was ended elsewhere."; + return; } - // Deferred so the backend can still emit EndOfMedia, which is what restarts a loop: - // clearing the source here destroys the playback engine and that signal never arrives. - QTimer::singleShot(0, this, [this, weakPlayer, stoppedData, claimGeneration, continuationGeneration] { - const auto lockedPlayer = weakPlayer.lock(); - const bool stillOurs = lockedPlayer && lockedPlayer->claimGeneration() == claimGeneration; - // Backends that emit EndOfMedia before StoppedState have already restarted the - // loop by now, so a player still playing its own track has not stopped either. - const bool sameMediaContinues = - lockedPlayer && (lockedPlayer->continuationGeneration() != continuationGeneration || (stillOurs && lockedPlayer->getPlaybackState() == QMediaPlayer::PlayingState)); + // Scheduled before the event below, because a sysMediaFinished handler runs + // synchronously and may hand this player to the next track - which would change both + // the media data and the generations the release has to be judged against. + releaseMediaSourceAfterEvents(player, player->mediaData(), PlaybackEnd::Stopped); + raiseMediaFinishedEvent(player, player->mediaPlayer()->source(), player->mediaData()); - if (sameMediaContinues) { - return; - } - - // Only release a player nothing else has taken over: a claimed one is already - // loading its new source, which on an asynchronous backend still reads as stopped. - if (stillOurs && lockedPlayer->mediaPlayer() && lockedPlayer->getPlaybackState() == QMediaPlayer::StoppedState) { - lockedPlayer->mediaPlayer()->setSource(QUrl()); - - if (stoppedData.mediaWidget() == TMediaData::MediaWidgetLabel && stoppedData.mediaClose() == TMediaData::MediaCloseEnabled && lockedPlayer->mediaPlayer()->videoOutput() != nullptr) { - emit signal_hideVideoOutput(lockedPlayer.get()); - } - } - - //: This word is part of a sentence like "Music stops" when the music is about to stop. - printClosedCaption(stoppedData, tr("stops")); - }); return; } else if (playbackState == QMediaPlayer::PlayingState && player->mediaData().mediaVolume() != TMediaData::MediaVolumePreload) { // NOLINT(readability-else-after-return) TEvent mediaStarted{}; @@ -1677,9 +1901,7 @@ void TMedia::play(TMediaData& mediaData) } const QUrl mediaSource = mediaData.mediaInput() == TMediaData::MediaInputFile ? QUrl::fromLocalFile(absolutePathFileName) : QUrl(absolutePathFileName); - releaseStoppedSource(pPlayer); - pPlayer->noteClaimed(); - pPlayer->mediaPlayer()->setSource(mediaSource); + pPlayer->claimSource(mediaSource); } else { if (mediaData.mediaLoops() == TMediaData::MediaLoopsRepeat) { // Repeat indefinitely playlist->setPlaybackMode(TMediaPlaylist::Loop); @@ -1745,9 +1967,7 @@ void TMedia::play(TMediaData& mediaData) playlist->setCurrentIndex(0); pPlayer->setPlaylist(playlist); - releaseStoppedSource(pPlayer); - pPlayer->noteClaimed(); - pPlayer->mediaPlayer()->setSource(playlist->currentMedia()); + pPlayer->claimSource(playlist->currentMedia()); } // Set volume and start position @@ -1772,6 +1992,16 @@ void TMedia::play(TMediaData& mediaData) // Handle video setup if applicable if (mediaData.mediaType() == TMediaData::MediaTypeVideo && !setupVideo(pPlayer)) { + // Claiming the player disarmed any release still pending on it, so drop the source it + // is now never going to play rather than leave it held indefinitely. + pPlayer->releaseSource(); + + // Same guards as the deferred release: a reused player can still be showing the widget + // of an earlier clip, and hiding that is only wanted when this request asked for it. + if (mediaData.mediaWidget() == TMediaData::MediaWidgetLabel && mediaData.mediaClose() == TMediaData::MediaCloseEnabled && pPlayer->mediaPlayer()->videoOutput() != nullptr) { + emit signal_hideVideoOutput(pPlayer.get()); + } + return; } diff --git a/src/TMedia.h b/src/TMedia.h index a2566dbc0..6a7212550 100644 --- a/src/TMedia.h +++ b/src/TMedia.h @@ -34,6 +34,7 @@ #include #include #include +#include class QJsonObject; @@ -63,15 +64,63 @@ public: TMediaData mediaData() const { return mMediaData; } void setMediaData(TMediaData& mediaData) { mMediaData = mediaData; } - // A stop is acted on one event-loop turn late, by which time a stopped player is - // indistinguishable from one asynchronously loading a source set since. These - // record what happened in between: a claim is this player being given a new source - // to play, a continuation is its own playlist advancing or looping. + // TMedia::releaseMediaSourceAfterEvents() ends a playback one event-loop turn late, by which + // time a stopped player is indistinguishable from one asynchronously loading a source set + // since. These two counters record what happened in between: a claim is this player being + // given a new track to play, a continuation is its own playlist advancing or looping. + // Outside this class, install a source only through claimSource() or continuePlaying() - + // never through mediaPlayer()->setSource() directly, since a missed bump lets that pending + // release clear the new source again. As of Qt 6.9 that reproduces only on backends that + // load asynchronously, so it will not show up on a macOS-only test run. + void claimSource(const QUrl& media) + { + // Bumped before the source is touched because setSource() can raise errorOccurred + // synchronously, and that handler snapshots these counters to arm its own release. + ++mClaimGeneration; + mEndAnnounced = false; + if (mMediaPlayer) { + // A stopped player still holding anything has that media loaded, so handing it a + // source now starts playback synchronously and raises sysMediaStarted inside the + // script call that asked for it. Unloading first restores the usual asynchronous + // start. The reported symptom was replaying the same file (#9611). + if (mMediaPlayer->playbackState() == QMediaPlayer::StoppedState && !mMediaPlayer->source().isEmpty()) { + releaseSource(); + } + mMediaPlayer->setSource(media); + } + } + void continuePlaying(const QUrl& media) + { + ++mContinuationGeneration; + mEndAnnounced = false; + if (mMediaPlayer) { + mMediaPlayer->setSource(media); + mMediaPlayer->play(); + } + } + // No bump: an empty source cannot be mistaken for a track that needs protecting from a + // pending release. A release already scheduled therefore still fires, and recognises that + // it has nothing left to do by the source being empty - see releaseMediaSourceAfterEvents(). + void releaseSource() + { + if (mMediaPlayer) { + mMediaPlayer->setSource(QUrl()); + } + } quint64 claimGeneration() const { return mClaimGeneration; } - void noteClaimed() { ++mClaimGeneration; } quint64 continuationGeneration() const { return mContinuationGeneration; } - void noteContinued() { ++mContinuationGeneration; } + // One ended playback can be reported from three places - a stop, a load error and the + // StoppedState that follows either - and the source stays set until the deferred release + // runs, so each of them still finds a playback that looks live. Only the first may tell + // scripts about it: a second sysMediaFinished for the same track is at best a duplicate, + // and at worst unbounded recursion when the handler stops the media it was told about. + // Cleared by the two ways this player is given something new to play, above. + bool endAnnounced() const { return mEndAnnounced; } + void noteEndAnnounced() { mEndAnnounced = true; } + + // Read-only uses and playback control are fine; do not setSource() on it, for the reason + // given above claimSource(). QMediaPlayer* mediaPlayer() const { return mMediaPlayer.get(); } bool isInitialized() const { return initialized; } QMediaPlayer::PlaybackState getPlaybackState() const @@ -129,6 +178,7 @@ private: bool initialized = false; quint64 mClaimGeneration = 0; quint64 mContinuationGeneration = 0; + bool mEndAnnounced = false; }; class TMedia : public QObject @@ -161,9 +211,17 @@ public: void printClosedCaption(const TMediaData& mediaData, const QString& action) const; void stopAllMediaPlayers(); - // Number of players still holding a media source. Releasing that source is the only - // observable effect of the deferred stop cleanup, so tests need a way to see it. + // Read-only diagnostics for the media tests. A deferred release is otherwise hard to + // observe: playingMedia() has already dropped the player, the closed caption needs captions + // enabled and signal_hideVideoOutput needs a video widget. int playersHoldingSource() const; + // Players that have actually started. playingMedia() deliberately counts one that is still + // loading as playing, which is not enough for a test that needs playback truly under way. + int playersInPlayingState() const; + // Players registered in the protocol lists, so a reuse test can tell a claimed player from + // a second one allocated alongside it. A player play() abandons before it finishes is never + // registered and so is never counted. + int mediaPlayerCount() const; // Returns true if mediaFileName would resolve to a location outside mediaRoot, either // lexically (e.g. via "../" traversal) or through a symlink component that already exists @@ -183,7 +241,6 @@ private: bool isMediaMatch(const std::shared_ptr& player, const TMediaData& mediaData); bool resume(TMediaData mediaData); void setMediaPlayersMuted(const TMediaData::MediaProtocol mediaProtocol, const bool state); - static void releaseStoppedSource(const std::shared_ptr& player); void transitionNonRelativeFile(TMediaData& mediaData); QString getStreamUrl(const TMediaData& mediaData); QUrl parseUrl(TMediaData& mediaData); @@ -205,6 +262,13 @@ private: std::shared_ptr matchMediaPlayer(TMediaData& mediaData); bool doesMediaHavePriorityToPlay(TMediaData& mediaData, const QString& absolutePathFileName); void matchMediaKeyAndStopMediaVariants(TMediaData& mediaData, const QString& absolutePathFileName); + // Why a playback ended, which decides whether the player's own state is worth consulting + // when the deferred release comes around. See releaseMediaSourceAfterEvents(). + enum class PlaybackEnd { Stopped, Failed }; + // endedUrl and endedData are passed in rather than read off the player, so a caller that has + // already released the source can still say what it was that ended. + void raiseMediaFinishedEvent(const std::shared_ptr& player, const QUrl& endedUrl, const TMediaData& endedData); + void releaseMediaSourceAfterEvents(const std::shared_ptr& player, const TMediaData& endedData, const PlaybackEnd endedBy); void handlePlayerPlaybackStateChanged(QMediaPlayerPlaybackState playbackState, const std::shared_ptr& player); bool setupVideo(const std::shared_ptr& player); static QString mediaTypeToString(int mediaType); diff --git a/src/dlgProfilePreferences.cpp b/src/dlgProfilePreferences.cpp index 235c7fa49..363d67742 100644 --- a/src/dlgProfilePreferences.cpp +++ b/src/dlgProfilePreferences.cpp @@ -914,14 +914,19 @@ void dlgProfilePreferences::initWithHost(Host* pHost) checkBox_discordServerAccessToPartyInfo->setChecked(!(discordFlags & Host::DiscordSetPartyInfo)); checkBox_discordServerAccessToTimerInfo->setChecked(!(discordFlags & Host::DiscordSetTimeInfo)); lineEdit_discordUserName->setText(pHost->mRequiredDiscordUserName); - lineEdit_discordUserName->setToolTip(utils::richText(tr("Mudlet will only show Rich Presence information while you use this Discord username (useful if you have multiple Discord accounts). Leave empty to show it for any Discord account you log in to. This must be the unique Discord username that uses a restricted lowercase ASCII character set and not any \"Nickname\" that you may have set for a particular Server."))); - lineEdit_discordUserName->setAccessibleDescription(tr("Mudlet will only show Rich Presence information while you use this Discord username (useful if you have multiple Discord accounts). Leave empty to show it for any Discord account you log in to. This must be the unique Discord username that uses a restricted lowercase ASCII character set and not any \"Nickname\" that you may have set for a particular Server.")); + lineEdit_discordUserName->setToolTip(utils::richText(tr("Mudlet will only show Rich Presence information while you use this Discord username (useful if you have multiple Discord accounts). " + "Leave empty to show it for any Discord account you log in to. This must be the unique Discord username that uses a restricted " + "lowercase ASCII character set and not any \"Nickname\" that you may have set for a particular Server."))); + lineEdit_discordUserName->setAccessibleDescription(tr("Mudlet will only show Rich Presence information while you use this Discord username (useful if you have multiple Discord accounts). " + "Leave empty to show it for any Discord account you log in to. This must be the unique Discord username that uses a restricted lowercase " + "ASCII character set and not any \"Nickname\" that you may have set for a particular Server.")); const QString currentDiscordUser = Discord::getLoggedInUserName(); if (!currentDiscordUser.isEmpty()) { //: Shows which Discord account is logged in: label_data_discordCurrentUser->setText(currentDiscordUser); - label_data_discordCurrentUser->setToolTip(utils::richText(tr("This is the unique username using a restricted character set for the Discord account, and not necessarily the nickname that you might have set for a particular Server."))); + label_data_discordCurrentUser->setToolTip(utils::richText( + tr("This is the unique username using a restricted character set for the Discord account, and not necessarily the nickname that you might have set for a particular Server."))); } else { label_data_discordCurrentUser->setText(tr("(Not connected)")); //: Tooltip shown when Discord Rich Presence cannot detect a logged-in user @@ -2095,7 +2100,14 @@ void dlgProfilePreferences::slot_purgeMediaCache() return; } - pHost->mpMedia->purgeMediaCache(); + if (!pHost->mpMedia->purgeMediaCache()) { + //: Shown after the "Clear stored media" button in preferences fails to empty the profile's media directory. + pHost->postMessage(tr("[ WARN ] - Could not clear all of the stored media; some files may still be in use.")); + return; + } + + //: Shown after the "Clear stored media" button in preferences empties the profile's media directory. + pHost->postMessage(tr("[ OK ] - The stored media files for this profile have been cleared.")); } void dlgProfilePreferences::slot_resetColors() diff --git a/src/dlgTriggerEditor.cpp b/src/dlgTriggerEditor.cpp index b725aa08c..04bf69b93 100644 --- a/src/dlgTriggerEditor.cpp +++ b/src/dlgTriggerEditor.cpp @@ -12392,6 +12392,14 @@ void dlgTriggerEditor::doCleanReset() void dlgTriggerEditor::runScheduledCleanReset() { + if (!mpHost) { + // The profile went away between doCleanReset() scheduling this and the timer firing, + // which is the order a teardown destroys them in. There is nothing left to repopulate + // from, and clearing the tree widgets below would re-enter the editor through + // selectionChanged to read the theme and font off the Host that has just gone. + return; + } + // Clear all current item pointers BEFORE attempting to save or clear tree widgets // to prevent heap-use-after-free when the tree widgets are cleared mpCurrentTriggerItem = nullptr; diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index 53b1751ac..ab97cc0c7 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -112,8 +112,22 @@ set_tests_properties(InsertTextCapTest PROPERTIES TIMEOUT 300) set_tests_properties(LogRestartDuplicateLineTest PROPERTIES TIMEOUT 300) # TMediaLoopTest probes the audio backend and creates a fresh profile per test method, -# and each clip has to be waited out in real time, so it needs a longer timeout +# and each clip has to be waited out in real time, so it needs a longer timeout. +# QTEST_MAIN does not run src/main.cpp, so pin QT_MEDIA_BACKEND to what main.cpp picks for +# the shipped application - otherwise the tests silently exercise Qt's default backend for +# the platform rather than the one users actually get. +if(APPLE) + set(mediaLoopTestBackend "darwin") +elseif(WIN32) + set(mediaLoopTestBackend "ffmpeg") +else() + set(mediaLoopTestBackend "") +endif() set_tests_properties(TMediaLoopTest PROPERTIES TIMEOUT 300) +if(mediaLoopTestBackend) + # APPEND, so the environment set by the loop above stays in force rather than being replaced + set_property(TEST TMediaLoopTest APPEND PROPERTY ENVIRONMENT "QT_MEDIA_BACKEND=${mediaLoopTestBackend}") +endif() # The round-trip tests boot a full mudlet instance and save/reload profile and # map data, so they need a longer timeout diff --git a/test/functional_tests/TMediaLoopTest.cpp b/test/functional_tests/TMediaLoopTest.cpp index 34800aeba..e8a02d8f1 100644 --- a/test/functional_tests/TMediaLoopTest.cpp +++ b/test/functional_tests/TMediaLoopTest.cpp @@ -43,28 +43,47 @@ void initializeQRCResourcesForMediaLoop(); using namespace std::chrono_literals; +// A skip is how these tests stay honest on a backend that cannot stage what they need. It is +// also how the whole file could go green everywhere and mean nothing, if a CI image lost its +// codecs or swapped its default backend - macOS already skips most of them by design, so a +// second platform quietly joining it would look no different. Runners known to carry a backend +// that can demonstrate everything here set MUDLET_MEDIA_TESTS_REQUIRE_PLAYBACK, which turns +// every capability skip into a failure and makes that loss a red build instead of silence. +#define SKIP_OR_FAIL_WITHOUT(reason) \ + do { \ + const QString incapable = (reason); \ + if (!incapable.isEmpty()) { \ + if (qEnvironmentVariableIsSet("MUDLET_MEDIA_TESTS_REQUIRE_PLAYBACK")) { \ + QFAIL(qPrintable(qsl("MUDLET_MEDIA_TESTS_REQUIRE_PLAYBACK is set for this runner, so a backend that cannot do this is a failure and " \ + "not a skip: %1") \ + .arg(incapable))); \ + } \ + QSKIP(qPrintable(incapable)); \ + } \ + } while (false) + /* - * Regression guard for "Client.Media loops=-1 plays once" (issue #9566). + * Regression guard for "Client.Media loops=-1 plays once" (issue #9566): the deferred media + * source release in TMedia, and the generation counters documented on TMediaPlayer that decide + * whether it still applies by the time its turn comes. The obligations that follow: * - * Qt's FFmpeg backend ends a track by emitting StoppedState first and only then - * EndOfMedia, and it skips the EndOfMedia notification if the playback engine - * disappeared in between. Mudlet restarts a loop from its EndOfMedia handler, so - * when the StoppedState handler cleared the source immediately (added by #9237 as - * a cleanup measure) it destroyed the engine, EndOfMedia never arrived and an - * indefinitely looping track played exactly once. + * - a looping track must survive the stop/restart cycle (the #9566 bug itself); + * - a finite loops=N track must reach every pass, which goes through the playlist + * branch of the same handler; + * - a track that genuinely finishes, or is stopped outright, must still release + * its source, or the resource release #9237 added is lost; + * - a source the backend cannot decode must release itself off the error signal, since + * the player was already stopped and no playback state change follows; + * - a player re-sourced during the deferred turn, by a different track or by a + * continue=false restart of the same one, must keep the source it was given; + * - each of those endings must raise sysMediaFinished exactly once, since releasing the + * source alone leaves a script chaining its next track off that event waiting forever, + * and announcing twice re-enters any handler that stops the media it was told about. * - * The cleanup is therefore deferred by one event-loop turn and re-checks the - * playback state, which lets a loop restart claim the player first. Both halves of - * that contract are covered here: a looping track must survive the stop/restart - * cycle, and a one-shot track must still be torn down so #9237 is not regressed. - * - * Both assertions depend on the platform actually decoding a clip through to - * EndOfMedia. Some setups cannot - notably the macOS darwin backend under - * QT_QPA_PLATFORM=offscreen, which the functional suite sets, stalls in - * LoadingMedia indefinitely. TMedia reports a stalled player as still playing, so - * without a capability check the looping assertion would pass on broken code too. - * Each test therefore probes a plain QMediaPlayer first and skips if the backend - * cannot finish a clip. + * Which of those a backend can demonstrate varies, so probeBackend() measures one up front and + * each test skips with what it found. CMakeLists.txt pins QT_MEDIA_BACKEND on the platforms + * where main.cpp does, and leaves it to Qt elsewhere, exactly as the shipped application does - + * so a skip reflects what users actually get. */ class TMediaLoopTest : public QObject { @@ -72,6 +91,7 @@ class TMediaLoopTest : public QObject private: TelnetServerStub* mpServer = nullptr; + Host* mpHost = nullptr; const QString mHostname = "Test-Media-Loop"; const QString mPort = "4012"; const QString mLocalhost = "localhost"; @@ -80,16 +100,19 @@ private: // artefact of start-up latency, short enough to loop several times quickly. static constexpr int clipMs = 400; - // Probed once, because the probe has to wait out a whole clip and the suite gives - // every functional test a single wall-clock budget for all of its slots. QTemporaryDir mProbeDir; - // Set when the backend cannot decode a clip through to EndOfMedia at all. + // Set when the backend never reaches PlayingState, so nothing below can even be started. + QString mCannotStartReason; + // Set when the backend starts a clip but never decodes it through to EndOfMedia. QString mCannotPlayReason; // Set when the backend ends a track with EndOfMedia before StoppedState. QString mWrongOrderReason; // Set when the backend starts playing synchronously, so a player that has just been - // re-sourced can never be mistaken for a stopped one. + // re-sourced can never be mistaken for a stopped one - which is the whole race the + // claim counter exists to settle. QString mSynchronousStartReason; + // Set when the backend does not report an undecodable file as an error. + QString mNoLoadErrorReason; private slots: void initTestCase() @@ -115,17 +138,14 @@ private slots: // was never delivered and the player dropped out of the playing set for good. void test_loopingTrackKeepsPlayingPastFirstPass() { - if (!mCannotPlayReason.isEmpty()) { - QSKIP(qPrintable(mCannotPlayReason)); - } - if (!mWrongOrderReason.isEmpty()) { - QSKIP(qPrintable(mWrongOrderReason)); - } + SKIP_OR_FAIL_WITHOUT(mCannotPlayReason); + SKIP_OR_FAIL_WITHOUT(mWrongOrderReason); auto* media = startProfileAndGetMedia(); QVERIFY(media); const QString fileName = writeClip(qsl("loop.wav")); + QVERIFY(!fileName.isEmpty()); TMediaData data = clipData(fileName); data.setMediaLoops(TMediaData::MediaLoopsRepeat); @@ -133,26 +153,63 @@ private slots: QVERIFY2(waitForPlaying(media, fileName), "The looping track never started playing."); - // Span several passes so a single missed restart cannot pass by luck. - QTest::qWait(clipMs * 4); + // Span several passes so a single missed restart cannot pass by luck, and land off a + // clip boundary: StoppedState and the EndOfMedia that restarts the loop are separate + // signals, and in the window between them a healthy player reads as not playing. + QTest::qWait(clipMs * 4 + clipMs / 2); - QVERIFY2(playing(media, fileName), "A loops=-1 track stopped after its first pass - the StoppedState cleanup suppressed EndOfMedia and the loop never restarted."); + QVERIFY2(waitForPlaying(media, fileName, 2s), "A loops=-1 track stopped after its first pass - the StoppedState cleanup suppressed EndOfMedia and the loop never restarted."); } - // The deferred cleanup must still fire for a genuinely finished track, otherwise - // the resource release that #9237 added would be lost. Releasing the source is the - // only observable effect of the deferred stop cleanup: playingMedia() drops a player - // the moment it reports StoppedState, well before that cleanup runs. - void test_oneShotTrackIsCleanedUpWhenItFinishes() + // Every pass of a finite loops=N track after the first comes from the playlist branch of + // the same EndOfMedia handler, which the indefinite-loop test never reaches. Its final + // pass is also the one place a continuation ends and the deferred cleanup must take over. + // Both hold whichever way round the backend emits EndOfMedia and StoppedState, so unlike + // the loop test this one needs no mWrongOrderReason gate. + void test_finiteLoopsReachEveryPass() { - if (!mCannotPlayReason.isEmpty()) { - QSKIP(qPrintable(mCannotPlayReason)); - } + SKIP_OR_FAIL_WITHOUT(mCannotPlayReason); auto* media = startProfileAndGetMedia(); QVERIFY(media); + const QString fileName = writeClip(qsl("finite.wav")); + QVERIFY(!fileName.isEmpty()); + + TMediaData data = clipData(fileName); + data.setMediaLoops(3); + media->playMedia(data); + + QVERIFY2(waitForPlaying(media, fileName), "The finite-loop track never started playing."); + + // Into the second pass, which only happens if the playlist advanced. + QTest::qWait(clipMs + clipMs / 2); + QVERIFY2(waitForPlaying(media, fileName, 2s), "A loops=3 track stopped after its first pass - the playlist never advanced to the next entry."); + + // ...and the last pass must still hand back to the cleanup rather than loop forever. + const bool cleanedUp = QTest::qWaitFor( + [&]() { + return !playing(media, fileName) && media->playersHoldingSource() == 0; + }, + QDeadlineTimer(10s)); + + QVERIFY2(cleanedUp, "A loops=3 track never finished and released its source - the deferred cleanup did not take over from the last pass."); + } + + // The deferred cleanup must still fire for a genuinely finished track, otherwise the + // media source release added by #9237 is lost. Releasing the source is what this asserts + // on because playingMedia() has already dropped the player by the time the cleanup runs. + void test_oneShotTrackIsCleanedUpWhenItFinishes() + { + SKIP_OR_FAIL_WITHOUT(mCannotPlayReason); + + auto* media = startProfileAndGetMedia(); + QVERIFY(media); + + watchMediaFinished(); + const QString fileName = writeClip(qsl("oneshot.wav")); + QVERIFY(!fileName.isEmpty()); TMediaData data = clipData(fileName); data.setMediaLoops(TMediaData::MediaLoopsDefault); @@ -167,32 +224,174 @@ private slots: QDeadlineTimer(10s)); QVERIFY2(cleanedUp, "A finished one-shot track never released its media source - the deferred cleanup did not run."); + + QVERIFY2(waitForMediaFinishedCount(1), "A finished one-shot track raised no single sysMediaFinished - a script chaining its next track off that event would wait forever."); + QVERIFY2(mediaFinishedHolds(qsl("mediaFinishedNames[1] == 'oneshot.wav'")), "sysMediaFinished named the wrong file for a finished one-shot track."); + } + + // The same obligation as above, reached by an explicit stop rather than by the clip + // ending. It asks the least of the backend of any test here - only that playback starts - + // so it is the one that still runs on a runner whose backend cannot decode a clip. + // + // Deliberately the weaker waitForPlaying(): on an asynchronous backend that lands the stop + // while the track is still loading, which is a player Qt already considers stopped and so + // one that reports no state change to end its playback. Holding a source for good is + // exactly what that used to cost, so this is the case worth keeping. + void test_stoppedTrackReleasesItsSource() + { + SKIP_OR_FAIL_WITHOUT(mCannotStartReason); + + auto* media = startProfileAndGetMedia(); + QVERIFY(media); + + watchMediaFinished(); + + const QString fileName = writeClip(qsl("stopped.wav")); + QVERIFY(!fileName.isEmpty()); + + TMediaData data = clipData(fileName); + data.setMediaLoops(TMediaData::MediaLoopsRepeat); + media->playMedia(data); + + QVERIFY2(waitForPlaying(media, fileName), "The track never started playing."); + + TMediaData stop = clipData(fileName); + media->stopMedia(stop); + + // Asserted separately from the release below: "still playing" and "still holding a + // source" are different faults with different causes, and a combined wait cannot say + // which of them a failure is. + const bool stopped = QTest::qWaitFor( + [&]() { + return !playing(media, fileName); + }, + QDeadlineTimer(10s)); + + QVERIFY2(stopped, "A stopped track was still reported as playing - stopMedia() did not take it out of the playing set."); + + const bool released = QTest::qWaitFor( + [&]() { + return media->playersHoldingSource() == 0; + }, + QDeadlineTimer(10s)); + + QVERIFY2(released, "A stopped track never released its media source - the deferred release did not run."); + + QVERIFY2(waitForMediaFinishedCount(1), "A stopped track raised no single sysMediaFinished - the silent stop this test exists for is only half fixed if the release happens without it."); + QVERIFY2(mediaFinishedHolds(qsl("mediaFinishedNames[1] == 'stopped.wav'")), "sysMediaFinished named the wrong file for a stopped track."); + + // Nothing more may be said about it afterwards. The source outlives the event by a + // turn, so the stop, the error handler and a StoppedState report can each still find a + // playback that looks live and announce the same ending over again. + QTest::qWait(clipMs); + QVERIFY2(mediaFinishedHolds(qsl("mediaFinishedCount == 1")), "A stopped track raised sysMediaFinished more than once for the same playback."); + } + + // Two ways a stop can say something it should not. A bare stopMusic() matches every player + // there is, including pooled ones between tracks that have nothing playing to end; and a + // stop issued from inside a sysMediaFinished handler - the natural place for a script to + // decide it has heard enough - lands on a player still holding the source of the track it + // was just told about, which used to look exactly like one more playback to end. That + // announced again, re-entered the same handler, and recursed until the stack gave out. + void test_stopDoesNotAnnounceWhatIsNotPlaying() + { + SKIP_OR_FAIL_WITHOUT(mCannotStartReason); + + auto* media = startProfileAndGetMedia(); + QVERIFY(media); + + watchMediaFinished(qsl("stopMusic()")); + + const QString fileName = writeClip(qsl("recursion.wav")); + QVERIFY(!fileName.isEmpty()); + + TMediaData data = clipData(fileName); + data.setMediaLoops(TMediaData::MediaLoopsRepeat); + media->playMedia(data); + + QVERIFY2(waitForPlaying(media, fileName), "The track never started playing."); + + TMediaData stop = clipData(fileName); + media->stopMedia(stop); + + QVERIFY2(waitForMediaFinishedCount(1), "A stopped track raised no single sysMediaFinished, so the handler that stops it again never ran and the recursion this test guards was never staged."); + + // Everything is idle by now, so a stop matching every player has nothing left to end. + TMediaData stopEverything; + stopEverything.setMediaProtocol(TMediaData::MediaProtocolAPI); + media->stopMedia(stopEverything); + + QTest::qWait(clipMs); + QVERIFY2(mediaFinishedHolds(qsl("mediaFinishedCount == 1")), + "A stop announced a playback that was already over - either the handler's own stopMusic() recursed back through it, or pooled players holding nothing were ended too."); + } + + // A source that fails to load reports an error and no playback state change, because a + // player that was already stopped - as every claimSource() on a new or finished player + // leaves it, and as a loop restart or playlist advance finds it - has nothing to change + // from. Without the error being acted on, the track falls silent still holding a source + // nothing will ever release. + void test_unplayableTrackReleasesItsSource() + { + SKIP_OR_FAIL_WITHOUT(mCannotPlayReason); + SKIP_OR_FAIL_WITHOUT(mNoLoadErrorReason); + + auto* media = startProfileAndGetMedia(); + QVERIFY(media); + + watchMediaFinished(); + + const QString fileName = writeUnplayableClip(qsl("broken.wav")); + QVERIFY(!fileName.isEmpty()); + + TMediaData data = clipData(fileName); + data.setMediaLoops(TMediaData::MediaLoopsRepeat); + media->playMedia(data); + + // Without this the wait below is satisfied at once by a play() that bailed out early, + // and the error path this test exists for is never reached. claimSource() sets the + // source inside playMedia() and the release is deferred, so the count is settled here. + QCOMPARE(media->playersHoldingSource(), 1); + + const bool released = QTest::qWaitFor( + [&]() { + return media->playersHoldingSource() == 0; + }, + QDeadlineTimer(10s)); + + QVERIFY2(released, "A track that could not be decoded held on to its media source - the playback error was never acted on."); + + QVERIFY2(waitForMediaFinishedCount(1), "A track that could not be decoded raised no single sysMediaFinished - a script chaining its next track off that event would wait forever."); + QVERIFY2(mediaFinishedHolds(qsl("mediaFinishedNames[1] == 'broken.wav'")), "sysMediaFinished named the wrong file for a track that could not be decoded."); + + // The error and the StoppedState that can follow it are two reports of one failure. + QTest::qWait(clipMs); + QVERIFY2(mediaFinishedHolds(qsl("mediaFinishedCount == 1")), "A track that could not be decoded raised sysMediaFinished more than once for the same failure."); } // A player that is handed to a different track in the same event-loop turn, as - // stopMusic() followed by playMusic{} in one script does, must keep the new source. - // The pending cleanup belongs to the track that stopped, and on this backend the - // player still reads as stopped while it loads the new one. + // stopMusic{} followed by playMusic{} in one script does, must keep the new source. The + // pending cleanup belongs to the track that stopped, and on an asynchronously starting + // backend (see mSynchronousStartReason) the player still reads as stopped while it loads. void test_reusedPlayerKeepsTheTrackThatClaimedIt() { - if (!mCannotPlayReason.isEmpty()) { - QSKIP(qPrintable(mCannotPlayReason)); - } - if (!mSynchronousStartReason.isEmpty()) { - QSKIP(qPrintable(mSynchronousStartReason)); - } + SKIP_OR_FAIL_WITHOUT(mCannotStartReason); + SKIP_OR_FAIL_WITHOUT(mSynchronousStartReason); auto* media = startProfileAndGetMedia(); QVERIFY(media); const QString firstFile = writeClip(qsl("first.wav")); const QString secondFile = writeClip(qsl("second.wav")); + QVERIFY(!firstFile.isEmpty() && !secondFile.isEmpty()); TMediaData first = clipData(firstFile); first.setMediaLoops(TMediaData::MediaLoopsRepeat); media->playMedia(first); - QVERIFY2(waitForPlaying(media, firstFile), "The first track never started playing."); + QVERIFY2(waitForPlaybackStarted(media, firstFile), "The first track never started playing."); + + const int playerCount = media->mediaPlayerCount(); TMediaData stopFirst = clipData(firstFile); media->stopMedia(stopFirst); @@ -203,34 +402,35 @@ private slots: QVERIFY2(waitForPlaying(media, secondFile), "The replacement track never started playing."); + // Without this the test passes vacuously on a second player, having never exercised + // the claim the deferred cleanup has to notice. + QCOMPARE(media->mediaPlayerCount(), playerCount); + // Past the turn the stopped track's cleanup was scheduled for. QTest::qWait(clipMs); - QVERIFY2(playing(media, secondFile), "The replacement track was cut off - the previous track's deferred cleanup cleared the source out from under it."); + QVERIFY2(waitForPlaying(media, secondFile, 2s), "The replacement track was cut off - the previous track's deferred cleanup cleared the source out from under it."); } - // continue=false restarts a track by stopping it and re-sourcing the same player - // inside one call. That player is matched, not claimed, so nothing in the reuse path - // tells the pending cleanup that the track it belongs to has already been replaced. + // continue=false restarts a track by stopping it and re-sourcing the same player inside + // one call. That player is matched rather than newly acquired, so the restart has to + // register the claim itself or the stop it just performed clears the source it just set. void test_restartedTrackKeepsItsNewSource() { - if (!mCannotPlayReason.isEmpty()) { - QSKIP(qPrintable(mCannotPlayReason)); - } - if (!mSynchronousStartReason.isEmpty()) { - QSKIP(qPrintable(mSynchronousStartReason)); - } + SKIP_OR_FAIL_WITHOUT(mCannotStartReason); + SKIP_OR_FAIL_WITHOUT(mSynchronousStartReason); auto* media = startProfileAndGetMedia(); QVERIFY(media); const QString fileName = writeClip(qsl("restart.wav")); + QVERIFY(!fileName.isEmpty()); TMediaData data = clipData(fileName); data.setMediaLoops(TMediaData::MediaLoopsRepeat); media->playMedia(data); - QVERIFY2(waitForPlaying(media, fileName), "The track never started playing."); + QVERIFY2(waitForPlaybackStarted(media, fileName), "The track never started playing."); TMediaData restart = clipData(fileName); restart.setMediaLoops(TMediaData::MediaLoopsRepeat); @@ -240,13 +440,14 @@ private slots: // Past the turn the stop inside that restart scheduled its cleanup for. QTest::qWait(clipMs); - QVERIFY2(playing(media, fileName), "A restarted track was cut off - the cleanup deferred by its own stop cleared the source it had just been given."); + QVERIFY2(waitForPlaying(media, fileName, 2s), "A restarted track was cut off - the cleanup deferred by its own stop cleared the source it had just been given."); } void cleanup() { delete mpServer; mpServer = nullptr; + mpHost = nullptr; deleteProfileDirectory(mHostname); delete mudlet::self(); } @@ -265,32 +466,60 @@ private: QTest::qFail("Host has no TMedia instance.", __FILE__, __LINE__); return nullptr; } + mpHost = host; return media; } - // Records what this backend is and is not able to demonstrate. - // - // - A backend that stalls in LoadingMedia (macOS darwin under - // QT_QPA_PLATFORM=offscreen, which the functional suite sets) never stops, and - // TMedia reports a stalled player as still playing, so nothing below is - // observable at all. - // - A backend that emits EndOfMedia *before* StoppedState (macOS darwin under - // cocoa) restarts a loop before any cleanup can run, so issue #9566 cannot occur - // and the looping assertion would hold on broken code. Only the - // StoppedState-first ordering (Qt's FFmpeg backend) can reproduce it. The other - // two tests turn on an explicit stop, so they hold on any backend that plays. + // sysMediaFinished is half of what the fixes here are for - a track that fails to load and + // one stopped while it is still loading each used to end in silence, with a script chaining + // its next track off that event waiting forever. Releasing the source, which is all the + // tests otherwise assert on, happens either way, so nothing here would notice the event + // going missing. Counted rather than merely seen: announcing the same ended playback more + // than once is its own bug, and one of them recursed until the stack gave out. + void watchMediaFinished(const QString& extraHandlerBody = QString()) + { + if (!mpHost) { + return; + } + + mpHost->getLuaInterpreter()->compileAndExecuteScript(qsl("mediaFinishedCount = 0\n" + "mediaFinishedNames = {}\n" + "registerAnonymousEventHandler('sysMediaFinished', function(_, fileName)\n" + " mediaFinishedCount = mediaFinishedCount + 1\n" + " mediaFinishedNames[#mediaFinishedNames + 1] = fileName\n" + " %1\n" + "end)\n") + .arg(extraHandlerBody)); + } + + // Runs a Lua assertion against what watchMediaFinished() recorded; compileAndExecuteScript() + // reports a raised error as false, so a failed assert() comes back here as one. + bool mediaFinishedHolds(const QString& luaCondition) const { return mpHost && mpHost->getLuaInterpreter()->compileAndExecuteScript(qsl("assert(%1)").arg(luaCondition)); } + + bool waitForMediaFinishedCount(int count, std::chrono::milliseconds timeout = 10s) const + { + return QTest::qWaitFor( + [&]() { + return mediaFinishedHolds(qsl("mediaFinishedCount == %1").arg(count)); + }, + QDeadlineTimer(timeout)); + } + + // Records what this backend is and is not able to demonstrate; each reason string set below + // spells out what that costs the tests reading it. Probed once, because it has to wait out a + // whole clip and the suite gives each test executable one wall-clock budget for all of its + // slots. test_stoppedTrackReleasesItsSource needs no capability and always runs. void probeBackend() { if (!mProbeDir.isValid()) { - mCannotPlayReason = qsl("Could not create a temporary directory for the backend probe."); - return; + // Not a backend capability, so not a skip: the harness cannot do its own setup. + QFAIL("Could not create a temporary directory for the backend probe."); } const QString path = qsl("%1/probe.wav").arg(mProbeDir.path()); QFile file(path); if (!file.open(QIODevice::WriteOnly)) { - mCannotPlayReason = qsl("Could not write the backend probe clip."); - return; + QFAIL("Could not write the backend probe clip."); } file.write(wavBytes()); file.close(); @@ -302,12 +531,16 @@ private: bool sawEndOfMedia = false; bool stoppedCameFirst = false; + bool sawPlaying = false; connect(&probe, &QMediaPlayer::mediaStatusChanged, this, [&](QMediaPlayer::MediaStatus status) { if (status == QMediaPlayer::EndOfMedia) { sawEndOfMedia = true; } }); connect(&probe, &QMediaPlayer::playbackStateChanged, this, [&](QMediaPlayer::PlaybackState state) { + if (state == QMediaPlayer::PlayingState) { + sawPlaying = true; + } if (state == QMediaPlayer::StoppedState && !sawEndOfMedia) { stoppedCameFirst = true; } @@ -326,17 +559,83 @@ private: QDeadlineTimer(10s)); probe.stop(); + // Both recorded before the decode verdict below, because the tests that need them do + // not need the backend to finish a clip - an early return here would leave them + // believing this backend starts playback and loads asynchronously when it does neither. + if (startsSynchronously) { + mSynchronousStartReason = qsl("This Qt Multimedia backend reaches PlayingState synchronously, so a player that has just been claimed by another track never reads as stopped and cannot " + "have its source cleared out from under it. Needs a backend that loads asynchronously, such as Qt's FFmpeg one."); + } + + if (!sawPlaying && !startsSynchronously) { + // Without this every test that only stops a track - the ones that need nothing else + // of the backend - would fail its opening "never started playing" assertion rather + // than skip, which is a red build on any runner without a usable backend. + mCannotStartReason = qsl("This Qt Multimedia backend never reached PlayingState within 10s, so no playback can be started to act on. Backend: \"%1\", final media status: %2, error: " + "\"%3\".") + .arg(QString::fromLocal8Bit(qgetenv("QT_MEDIA_BACKEND")), QString::number(static_cast(probe.mediaStatus())), probe.errorString()); + } + if (!finished) { - mCannotPlayReason = qsl("This Qt Multimedia backend cannot decode a clip to completion here (it stalls before EndOfMedia), so media playback behaviour cannot be observed."); + // Report what was measured rather than a cause that was not diagnosed - no audio + // device, a missing codec and a stalled decoder all land here. + mCannotPlayReason = qsl("This Qt Multimedia backend did not reach EndOfMedia within 10s, so anything that waits for a clip to finish cannot be observed. Backend: \"%1\", reached " + "PlayingState: %2, final media status: %3, error: \"%4\".") + .arg(QString::fromLocal8Bit(qgetenv("QT_MEDIA_BACKEND")), + startsSynchronously ? qsl("yes") : qsl("no"), + QString::number(static_cast(probe.mediaStatus())), + probe.errorString()); return; } + if (!stoppedCameFirst) { mWrongOrderReason = qsl("This Qt Multimedia backend emits EndOfMedia before StoppedState, so the loop restarts before any cleanup runs and issue #9566 cannot occur here. Needs a " "StoppedState-first backend such as Qt's FFmpeg one."); } - if (startsSynchronously) { - mSynchronousStartReason = qsl("This Qt Multimedia backend reaches PlayingState synchronously, so a player that has just been claimed by another track never reads as stopped and cannot " - "have its source cleared out from under it. Needs a backend that loads asynchronously, such as Qt's FFmpeg one."); + + // Only worth asking of a backend that got this far. Assumed, not measured: one that + // cannot finish a valid clip is taken not to reject an invalid one either. + probeLoadFailureReporting(); + } + + // Whether an undecodable file is reported as an error at all. A backend that stays silent + // gives TMedia nothing to act on, so the release it cannot schedule cannot be asserted. + void probeLoadFailureReporting() + { + const QString path = qsl("%1/unplayable.wav").arg(mProbeDir.path()); + QFile file(path); + if (!file.open(QIODevice::WriteOnly)) { + QFAIL("Could not write the unplayable probe clip."); + } + file.write(QByteArray("not a WAV file, and not decodable as anything else")); + file.close(); + + QMediaPlayer probe; + auto* output = new QAudioOutput(&probe); + output->setMuted(true); + probe.setAudioOutput(output); + + bool sawError = false; + connect(&probe, &QMediaPlayer::errorOccurred, this, [&](QMediaPlayer::Error error, const QString&) { + if (error != QMediaPlayer::NoError) { + sawError = true; + } + }); + + probe.setSource(QUrl::fromLocalFile(path)); + probe.play(); + + const bool reported = QTest::qWaitFor( + [&]() { + return sawError; + }, + QDeadlineTimer(10s)); + probe.stop(); + + if (!reported) { + mNoLoadErrorReason = qsl("This Qt Multimedia backend does not report an error for an undecodable file within 10s, so there is no failure for TMedia to act on. Backend: \"%1\", final " + "media status: %2.") + .arg(QString::fromLocal8Bit(qgetenv("QT_MEDIA_BACKEND")), QString::number(static_cast(probe.mediaStatus()))); } } @@ -351,8 +650,8 @@ private: return data; } - // TMedia reports a player only while it is actually playing (or still loading), - // which is the observable this regression turns on. + // TMedia reports a player only while it is actually playing, or still loading - the + // carve-out that lets a stalled backend look busy, and the observable this turns on. bool playing(TMedia* media, const QString& fileName) const { TMediaData criteria = clipData(fileName); @@ -368,9 +667,24 @@ private: QDeadlineTimer(timeout)); } - // Writes a silent 16-bit mono PCM WAV into the profile media directory. Silence is - // fine: the test asserts on playback state transitions, not on what is heard. - QString writeClip(const QString& fileName) const + // Stronger than waitForPlaying(): a player that is still loading counts as playing to + // TMedia, and it is not yet stoppable in the way a started one is - stopping it produces no + // playback state change, and getMediaPlayer() will not hand it to another track. + bool waitForPlaybackStarted(TMedia* media, const QString& fileName, std::chrono::milliseconds timeout = 10s) + { + return QTest::qWaitFor( + [&]() { + return playing(media, fileName) && media->playersInPlayingState() > 0; + }, + QDeadlineTimer(timeout)); + } + + // Passes the file-name checks in TMedia::play(), so it reaches the backend and fails + // there, so the error path is reached the way a real undecodable file would reach it. + QString writeUnplayableClip(const QString& fileName) const { return writeClip(fileName, QByteArray("not a WAV file, and not decodable as anything else")); } + + // Writes a clip into the profile media directory, returning {} if that fails. + QString writeClip(const QString& fileName, const QByteArray& contents = wavBytes()) const { const QString mediaPath = mudlet::getMudletPath(enums::profileMediaPath, mHostname); if (!QDir().mkpath(mediaPath)) { @@ -383,7 +697,7 @@ private: QTest::qFail("Could not write the test media file.", __FILE__, __LINE__); return {}; } - file.write(wavBytes()); + file.write(contents); file.close(); return fileName; } From bfeb4dea3d29fb20dcc013d603308bb4530a1694 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Wed, 5 Aug 2026 06:41:14 +0200 Subject: [PATCH 085/155] Fix: stop map saves polluting userData with fallback keys (#9469) #### Brief overview of PR changes/additions Saving a map at format <= 19 was leaking internal `system.fallback_*` keys into the live map's user-visible userData, permanently. A format-19 save polluted room userData; a save at format < 19 tainted map userData forever. - The first commit serialises a locally-augmented copy, so saves never mutate the live map. Old-format **file** output stays byte-identical, so older Mudlets still receive their compatibility keys. - The second commit strips stale leaked keys on format >= 19 loads, so already-tainted maps self-clean. #### Motivation for adding to Mudlet Users' maps were silently accumulating internal keys they never set, and those keys survived across save/load cycles. This stops new pollution and cleans up existing damage. #### Other info (issues closed, discussion etc) Stacked on top of #9468 (base branch `add-persistence-roundtrip-tests`); GitHub will auto-retarget to `development` once that PR merges. Please merge after #9468. These are the two bugs the round-trip tests caught, so this PR also flips their `QEXPECT_FAIL` markers to hard assertions. Human build/test pending; DCO sign-off to be added at squash time. https://github.com/user-attachments/assets/3931edb7-4daf-4277-bac4-0c6680d5bfe3 --- src/TMap.cpp | 56 ++++++----- src/TRoom.cpp | 15 ++- test/functional_tests/MapRoundTripTest.cpp | 104 +++++++++++++++------ 3 files changed, 126 insertions(+), 49 deletions(-) diff --git a/src/TMap.cpp b/src/TMap.cpp index dcb17f21a..ba5ae0264 100644 --- a/src/TMap.cpp +++ b/src/TMap.cpp @@ -1157,13 +1157,15 @@ bool TMap::serialize(QDataStream& ofs, int saveVersion) ofs << mCustomEnvColors; ofs << mpRoomDB->hashToRoomID; if (mSaveVersion < 19) { - // Save the data in the map user data for older versions - mUserData.insert(qsl("system.fallback_mapSymbolFont"), mMapSymbolFont.toString()); - mUserData.insert(qsl("system.fallback_mapSymbolFontFudgeFactor"), QString::number(mMapSymbolFontFudgeFactor)); - mUserData.insert(qsl("system.fallback_onlyUseMapSymbolFont"), mIsOnlyMapSymbolFontToBeUsed ? qsl("true") : qsl("false")); - } - ofs << mUserData; - if (mSaveVersion >= 19) { + // Save the data in the map user data for older versions - use a local + // copy so that saving does not modify the live map's user data: + QMap userData{mUserData}; + userData.insert(qsl("system.fallback_mapSymbolFont"), mMapSymbolFont.toString()); + userData.insert(qsl("system.fallback_mapSymbolFontFudgeFactor"), QString::number(mMapSymbolFontFudgeFactor)); + userData.insert(qsl("system.fallback_onlyUseMapSymbolFont"), mIsOnlyMapSymbolFontToBeUsed ? qsl("true") : qsl("false")); + ofs << userData; + } else { + ofs << mUserData; // Save the data directly in supported format versions (19 and above) ofs << mMapSymbolFont; ofs << mMapSymbolFontFudgeFactor; @@ -1315,16 +1317,6 @@ bool TMap::serialize(QDataStream& ofs, int saveVersion) } ofs << pR->getId(); - if (mSaveVersion <= 19) { - if (!pR->mSymbol.isEmpty()) { - pR->userData.insert(QLatin1String("system.fallback_symbol"), pR->mSymbol); - } - } - if (mSaveVersion < 21) { - if (pR->hidden) { - pR->userData.insert(QLatin1String("system.fallback_hidden"), QLatin1String("true")); - } - } ofs << pR->getArea(); ofs << pR->x(); ofs << pR->y(); @@ -1379,10 +1371,6 @@ bool TMap::serialize(QDataStream& ofs, int saveVersion) if (mSaveVersion >= 21) { ofs << pR->mSymbolColor; - } else { - if (pR->mSymbolColor.isValid()) { - pR->userData.insert(QLatin1String("system.fallback_symbol_color"), pR->mSymbolColor.name()); - } } // Border properties are stored in userData (not binary stream) to avoid map bloat @@ -1397,7 +1385,25 @@ bool TMap::serialize(QDataStream& ofs, int saveVersion) pR->userData.remove(ROOM_UI_BORDERTHICKNESS); } - ofs << pR->userData; + // Formats before 21 carry the hidden flag and symbol color - and + // formats before 19 the symbol - as user data fallbacks; use a local + // copy so that saving does not modify the live room's user data. + // TRoom::restore() strips each key again when loading a format that + // carries it, so none may appear in formats which store the value + // directly in the stream: + QMap userData{pR->userData}; + if (mSaveVersion < 21) { + if (pR->hidden) { + userData.insert(QLatin1String("system.fallback_hidden"), QLatin1String("true")); + } + if (pR->mSymbolColor.isValid()) { + userData.insert(QLatin1String("system.fallback_symbol_color"), pR->mSymbolColor.name()); + } + } + if (mSaveVersion < 19 && !pR->mSymbol.isEmpty()) { + userData.insert(QLatin1String("system.fallback_symbol"), pR->mSymbol); + } + ofs << userData; if (mSaveVersion >= 20) { // Before version 20 stored the style as an Latin1 string, the color // as a QList for the RGB components and used UPPER case for @@ -1695,6 +1701,12 @@ bool TMap::restore(QString location) } ifs >> mMapSymbolFontFudgeFactor; ifs >> mIsOnlyMapSymbolFontToBeUsed; + // Clean up stale fallback keys that past versions could leave + // behind in the live map's user data (and thus in files saved + // from it) after saving in a format before 19: + mUserData.remove(qsl("system.fallback_mapSymbolFont")); + mUserData.remove(qsl("system.fallback_mapSymbolFontFudgeFactor")); + mUserData.remove(qsl("system.fallback_onlyUseMapSymbolFont")); } else { // Fallback to reading the data from the map user data - and // remove it from the data the user will see: diff --git a/src/TRoom.cpp b/src/TRoom.cpp index 2a55d2079..a1e654e9a 100644 --- a/src/TRoom.cpp +++ b/src/TRoom.cpp @@ -892,8 +892,17 @@ void TRoom::restore(QDataStream& ifs, int roomID, int version) if (!hiddenString.compare(QLatin1String("true"), Qt::CaseInsensitive)) { hidden = true; } + } else { + // The stream carries the authoritative value so any copy of the + // fallback key in the user data is stale: + userData.remove(QLatin1String("system.fallback_hidden")); } - if (version < 19) { + if (version >= 19) { + // Clean up a stale fallback key that past versions could leave + // behind in the live room's user data (and thus in files saved + // from it) after saving in a format before 19: + userData.remove(QLatin1String("system.fallback_symbol")); + } else { const QString symbolString = userData.take(QLatin1String("system.fallback_symbol")); if (!symbolString.isEmpty()) { // There is a fallback in the user data @@ -915,6 +924,10 @@ void TRoom::restore(QDataStream& ifs, int roomID, int version) if (userData.contains(symbolColorFallbackKey)) { mSymbolColor = QColor(userData.take(symbolColorFallbackKey)); } + } else { + // The stream carries the authoritative value so any copy of the + // fallback key in the user data is stale: + userData.remove(QLatin1String("system.fallback_symbol_color")); } // Border properties are stored in userData (not binary stream) to avoid map bloat diff --git a/test/functional_tests/MapRoundTripTest.cpp b/test/functional_tests/MapRoundTripTest.cpp index cc4f9fc2c..0d435ed08 100644 --- a/test/functional_tests/MapRoundTripTest.cpp +++ b/test/functional_tests/MapRoundTripTest.cpp @@ -38,6 +38,7 @@ #include +#include #include #include @@ -113,10 +114,6 @@ private: AreaBounds mBoundsB; QImage mLabelImage; QSizeF mLabelSize; - // Once the source map has been saved at a format below 19 its mUserData - // carries stray system.fallback_mapSymbolFont* keys forever - see the - // QEXPECT_FAIL in verifyMap(): - bool mSourcePollutedByPre19Save = false; static QMap expectedMapUserData() { return {{qsl("map.author 日本語"), qsl("величина <>&\"' ]]>")}, {qsl("plain"), qsl("value")}}; } @@ -268,6 +265,23 @@ private: return file.commit(); } + // QDataStream stores QStrings as a length prefix plus the string encoded as UTF-16BE, + // so the raw file can be scanned for a serialized string's bytes: + static bool fileContainsSerializedString(const QString& fileName, const QString& needle) + { + QFile file(fileName); + if (!file.open(QIODevice::ReadOnly)) { + return false; + } + const QByteArray raw = file.readAll(); + QByteArray needleBytes; + QDataStream out(&needleBytes, QIODevice::WriteOnly); + out << needle; + // The length prefix stays in the needle so a key cannot match a longer key it is + // a byte prefix of ("system.fallback_mapSymbolFont" vs. "...FontFudgeFactor"): + return raw.contains(needleBytes); + } + void verifyArea(TArea* pArea, const AreaBounds& bounds, const QString& areaLabel) { QVERIFY2(pArea, qPrintable(qsl("%1 is missing").arg(areaLabel))); @@ -346,14 +360,9 @@ private: QCOMPARE(pR1->customLinesColor, (QMap{{qsl("n"), scmCustomLineColor}})); QCOMPARE(pR1->customLinesStyle, (QMap{{qsl("n"), Qt::DashLine}})); QCOMPARE(pR1->customLinesArrow, (QMap{{qsl("n"), true}})); - if (savedVersion == 19) { - // Finding: TMap::serialize() stores the symbol fallback for - // mSaveVersion <= 19 but TRoom::restore() only removes it again - // for version < 19, so a map saved at exactly format 19 leaves a - // stray "system.fallback_symbol" entry in the room's userData - // after loading: - QEXPECT_FAIL("", "system.fallback_symbol is written at save version 19 (TMap::serialize) but only stripped for versions below 19 (TRoom::restore)", Continue); - } + // The format 19 leg runs after the format 17/18 ones, so this also + // guards against a < 19 save leaving a stray system.fallback_symbol + // entry behind in the live source room's user data: QCOMPARE(pR1->userData, expectedRoom1UserData()); TRoom* pR2 = pDB->getRoom(scmRoom2); @@ -396,17 +405,10 @@ private: QCOMPARE(pR4->getOut(), scmRoom2); QCOMPARE(pR4->getNorthwest(), scmRoom3); - if (savedVersion >= 19 && mSourcePollutedByPre19Save) { - // Finding: TMap::serialize() inserts system.fallback_mapSymbolFont, - // system.fallback_mapSymbolFontFudgeFactor and - // system.fallback_onlyUseMapSymbolFont into the live map's - // mUserData when saving at format < 19 and never removes them - // afterwards, so every subsequent save at format >= 19 embeds - // those stale keys and TMap::restore() only strips them again for - // format < 19 loads: - QEXPECT_FAIL( - "", "saving at format < 19 permanently pollutes TMap::mUserData with system.fallback_mapSymbolFont* keys (TMap::serialize) which leak into later format >= 19 saves", Continue); - } + // The format 19 leg runs after the format 17/18 ones, so this also + // guards against a < 19 save leaving stray + // system.fallback_mapSymbolFont* entries behind in the live source + // map's user data: QCOMPARE(pMap->mUserData, expectedMapUserData()); QCOMPARE(pMap->mEnvColors, (QMap{{5, 2}, {12, 7}})); QCOMPARE(pMap->mCustomEnvColors.value(300), QColor(12, 34, 56)); @@ -430,9 +432,13 @@ private: { const QString fileName = qsl("%1/map_v%2.dat").arg(mSaveDir.path()).arg(saveVersion); QVERIFY2(saveMapToFile(mpSource->mpMap.data(), fileName, saveVersion), qPrintable(qsl("failed to save map at format version %1").arg(saveVersion))); - if (saveVersion < 19) { - mSourcePollutedByPre19Save = true; - } + + // Saving at any format must not leak system.fallback_* keys into the + // live source map's or rooms' user data - room 1 carries a symbol and + // a symbol color, room 3 is hidden: + QCOMPARE(mpSource->mpMap->mUserData, expectedMapUserData()); + QCOMPARE(mpSource->mpMap->mpRoomDB->getRoom(scmRoom1)->userData, expectedRoom1UserData()); + QVERIFY(mpSource->mpMap->mpRoomDB->getRoom(scmRoom3)->userData.isEmpty()); TMap* pTargetMap = mpTarget->mpMap.data(); pTargetMap->mapClear(); @@ -508,6 +514,52 @@ private slots: QFETCH(int, saveVersion); roundTripAtVersion(saveVersion); } + + void test_taintedMapSelfCleansOnFormat19PlusLoad() + { + // Simulate a map already tainted in the wild by past versions whose + // saving in a format below 19 left the fallback keys behind in the + // live user data - which then rode along in every format >= 19 save: + TMap* pSourceMap = mpSource->mpMap.data(); + TRoom* pSourceR1 = pSourceMap->mpRoomDB->getRoom(scmRoom1); + QVERIFY(pSourceR1); + pSourceMap->mUserData.insert(qsl("system.fallback_mapSymbolFont"), qsl("Stale Font,10,-1,5,400,0,0,0,0,0")); + pSourceMap->mUserData.insert(qsl("system.fallback_mapSymbolFontFudgeFactor"), qsl("9.99")); + pSourceMap->mUserData.insert(qsl("system.fallback_onlyUseMapSymbolFont"), qsl("false")); + // The unique value doubles as the proof below that this key really + // made it into the file: + pSourceR1->userData.insert(qsl("system.fallback_symbol"), qsl("stale-room-symbol-junk")); + + const int saveVersion = pSourceMap->mDefaultVersion; + QVERIFY(saveVersion >= 19); + const QString fileName = qsl("%1/map_tainted_v%2.dat").arg(mSaveDir.path()).arg(saveVersion); + QVERIFY(saveMapToFile(pSourceMap, fileName, saveVersion)); + + // Undo the tainting of the live source map: + pSourceMap->mUserData = expectedMapUserData(); + pSourceR1->userData = expectedRoom1UserData(); + + // The junk keys really did make it into the serialized stream: + QVERIFY(fileContainsSerializedString(fileName, qsl("system.fallback_mapSymbolFont"))); + QVERIFY(fileContainsSerializedString(fileName, qsl("system.fallback_onlyUseMapSymbolFont"))); + QVERIFY(fileContainsSerializedString(fileName, qsl("stale-room-symbol-junk"))); + + TMap* pTargetMap = mpTarget->mpMap.data(); + pTargetMap->mapClear(); + QVERIFY(pTargetMap->restore(fileName)); + pTargetMap->audit(); + + // Loading strips the junk keys while the legitimate user data - and + // the authoritative values stored directly in the stream - survive: + QCOMPARE(pTargetMap->mUserData, expectedMapUserData()); + QCOMPARE(pTargetMap->mMapSymbolFont.family(), qsl("DejaVu Serif")); + QCOMPARE(pTargetMap->mMapSymbolFontFudgeFactor, 1.25); + QVERIFY(pTargetMap->mIsOnlyMapSymbolFontToBeUsed); + TRoom* pTargetR1 = pTargetMap->mpRoomDB->getRoom(scmRoom1); + QVERIFY(pTargetR1); + QCOMPARE(pTargetR1->userData, expectedRoom1UserData()); + QCOMPARE(pTargetR1->mSymbol, qsl("⚔")); + } }; void initializeQRCResourcesForMapRoundTripTest() From 5b33c2f35fdee5ac251eaa7208913a50253d0379 Mon Sep 17 00:00:00 2001 From: Mike Conley Date: Wed, 5 Aug 2026 00:42:14 -0400 Subject: [PATCH 086/155] Fix: don't replay a sign-in token the game already rejected (#9676) #### Brief overview of PR changes/additions - Latch the "this token was rejected" flag synchronously at the rejection, instead of when the asynchronous keychain read returns, so a `Char.Login.Default` arriving mid-read cannot replay the just-rejected token. - Capture the per-connection facts the recovery needs (sent-token hash, rotation-retry flag, account, provider) before awaiting the read, so a `mConn` reset mid-read cannot corrupt the rotated-vs-dead decision or downgrade the resume hint into a full discard. - Replace the stale-generation early return with a `superseded` flag: the stored entry is always put right, and only the parts that drive the connection are skipped. #### Motivation for adding to Mudlet This is in response to [questions](https://discord.com/channels/279748146316312576/1393998251786768384/1534048607051841597) from @RahjIII on the MUD/coding/MUDstandards thread on Discord. The GMCP Char.Login 2 standard forbids a client from replaying a reconnect token that was rejected on the same connection, and in this race Mudlet did exactly that - then also left the dead token sitting in the keychain, so the next connection could loop on it. #### Other info (issues closed, discussion etc) Part of the Char.Login 2 authentication work in #9354. The race needs a `Char.Login.Default` to arrive while the keychain read is in flight. That happens either when a server holds the connection open and re-offers sign-in after rejecting a token - behaviour the spec is being extended to permit - or, against a server that closes the connection instead, on the next connection after Mudlet's own recovery reconnect. Out of scope, noted here because it turned up during testing: on the recovery reconnect the browser is not auto-opened, only the sign-in link is printed. That is the pre-existing `Host::userSentInputThisConnection()` guard in `GMCPAuthenticator::handleAuthUrl()`, which `cTelnet` clears on every new connection so a misbehaving server cannot pop a browser at an idle player. Since the recovery reconnect is client-initiated, the flag is false when `Char.Login.URL` arrives. Unchanged by this PR. **Test case:** Sign in to a Char.Login 2 server (StickMUD) via OAuth so a reconnect token is saved; confirm a later connect signs in silently. Invalidate the token server-side (`logout everywhere` on StickMUD), then reconnect. Expect: "Your saved sign-in has expired; reconnecting so you can sign in again", a single reconnect, and the same provider's sign-in resumed with no provider menu - not a repeated expiry loop, and not a provider menu. --------- Signed-off-by: Michael Conley --- src/GMCPAuthenticator.cpp | 197 +++++++++++++------- src/GMCPAuthenticator.h | 22 ++- test/functional_tests/GMCPCharLoginTest.cpp | 55 +++++- 3 files changed, 188 insertions(+), 86 deletions(-) diff --git a/src/GMCPAuthenticator.cpp b/src/GMCPAuthenticator.cpp index eb63c6043..8bc97635c 100644 --- a/src/GMCPAuthenticator.cpp +++ b/src/GMCPAuthenticator.cpp @@ -625,91 +625,144 @@ void GMCPAuthenticator::retryOrDropRejectedToken() QPointer safeHost = mpHost; QPointer credentialManager = new CredentialManager(); const auto attemptGeneration = mAuthAttemptGeneration; - credentialManager->retrievePassword(mpHost->getName(), qsl("reconnect"), [this, safeHost, credentialManager, attemptGeneration](bool success, QString value, const QString& errorMessage) { - if (credentialManager) { - credentialManager->deleteLater(); - } - if (!safeHost) { - return; - } - if (attemptGeneration != mAuthAttemptGeneration) { - return; - } - // A read failure (locked/denied/timed-out keychain) is not "no token": log it so a dropped - // token that was actually unreadable can be told apart from a genuinely dead one. The recovery - // below still proceeds - a fresh sign-in is the safe outcome either way. - if (!success) { - qWarning().noquote() << "GMCP Char.Login - could not read the stored sign-in while recovering a rejected token:" << errorMessage; - } + // Capture the per-connection facts this recovery needs before awaiting the keychain: a + // Char.Login.Default arriving while the read is in flight resets mConn, and the callback would then + // have no hash to recognise the rejected token by and no account or provider to keep a resume hint + // from - silently downgrading the drop below into discarding the whole entry. + const auto sentTokenHash = mConn.sentReconnectTokenHash; + const auto retriedRotatedToken = mConn.retriedRotatedToken; + const auto reconnectAccount = mConn.reconnectAccount; + const auto accountProvider = mConn.accountProvider; + // Latch synchronously rather than when the read returns; see mReconnectRejected's declaration. + mReconnectRejected = true; + credentialManager->retrievePassword( + mpHost->getName(), + qsl("reconnect"), + [this, safeHost, credentialManager, attemptGeneration, sentTokenHash, retriedRotatedToken, reconnectAccount, accountProvider](bool success, QString value, const QString& errorMessage) { + if (credentialManager) { + credentialManager->deleteLater(); + } + if (!safeHost) { + return; + } + // A newer sign-in attempt began while the read was in flight; it owns the connection now, so + // this recovery must not send anything or reconnect. It may still rewrite the stored entry, + // but only on positive evidence that the rejected token is the one stored - see the drop below. + const bool superseded = (attemptGeneration != mAuthAttemptGeneration); + // A read failure (locked/denied/timed-out keychain) is not "no token": log it so a dropped + // token that was actually unreadable can be told apart from a genuinely dead one. The recovery + // below still proceeds - a fresh sign-in is the safe outcome either way. + if (!success) { + qWarning().noquote() << "GMCP Char.Login - could not read the stored sign-in while recovering a rejected token:" << errorMessage; + } - // Shared-store rotation check: if the stored token no longer hashes to what this connection - // sent, another running instance rotated it (single-use) - replay the fresh one once, rather - // than discarding its token. A rejection whose stored token still matches (a genuinely dead - // token, or a non-rotation rejection) falls through to drop-and-re-sign-in below. - if (!mConn.retriedRotatedToken && success && !value.isEmpty()) { - // The stored JSON may hold a bearer token; parse from an owned buffer and scrub every owned - // copy - the QByteArray and the QString value (retrievePassword moved it in) - on all paths, - // including a corrupt entry that never parses. - QByteArray valueBytes = value.toUtf8(); - const auto doc = QJsonDocument::fromJson(valueBytes); - SecureStringUtils::secureByteArrayClear(valueBytes); - SecureStringUtils::secureStringClear(value); - if (doc.isObject()) { - const auto account = doc.object()[qsl("account")].toString(); - auto token = doc.object()[qsl("token")].toString(); - if (!account.isEmpty() && !token.isEmpty()) { - QByteArray tokenBytes = token.toUtf8(); - const QByteArray storedHash = QCryptographicHash::hash(tokenBytes, QCryptographicHash::Sha256); - SecureStringUtils::secureByteArrayClear(tokenBytes); - if (!mConn.sentReconnectTokenHash.isEmpty() && storedHash != mConn.sentReconnectTokenHash) { + bool rejectedTokenStillStored = false; + + // Shared-store rotation check: if the stored token no longer hashes to what this connection + // sent, another running instance rotated it (single-use) - replay the fresh one once, rather + // than discarding its token. A rejection whose stored token still matches (a genuinely dead + // token, or a non-rotation rejection) falls through to drop-and-re-sign-in below. + if (!retriedRotatedToken && success && !value.isEmpty()) { + // The stored JSON may hold a bearer token; parse from an owned buffer and scrub every owned + // copy - the QByteArray and the QString value (retrievePassword moved it in) - on all paths, + // including a corrupt entry that never parses. + QByteArray valueBytes = value.toUtf8(); + const auto doc = QJsonDocument::fromJson(valueBytes); + SecureStringUtils::secureByteArrayClear(valueBytes); + SecureStringUtils::secureStringClear(value); + if (doc.isObject()) { + const auto account = doc.object()[qsl("account")].toString(); + auto token = doc.object()[qsl("token")].toString(); + if (!account.isEmpty() && !token.isEmpty()) { + QByteArray tokenBytes = token.toUtf8(); + const QByteArray storedHash = QCryptographicHash::hash(tokenBytes, QCryptographicHash::Sha256); + SecureStringUtils::secureByteArrayClear(tokenBytes); + if (!sentTokenHash.isEmpty() && storedHash != sentTokenHash) { + if (superseded) { + // The newer attempt reads the store for itself, so leave the other + // instance's fresh token in place and let it decide. + SecureStringUtils::secureStringClear(token); + return; + } #if defined(DEBUG_GMCP_AUTHENTICATION) - qDebug() << "GMCP reconnect token was rotated by another instance; replaying the fresh token"; + qDebug() << "GMCP reconnect token was rotated by another instance; replaying the fresh token"; #endif - mConn.retriedRotatedToken = true; - mConn.sentReconnectTokenHash = storedHash; - mConn.reconnectingWithToken = true; - mConn.awaitingReconnectResult = true; - mConn.reconnectAccount = account; - sendReconnect(account, std::move(token)); - return; + mConn.retriedRotatedToken = true; + mConn.sentReconnectTokenHash = storedHash; + mConn.reconnectingWithToken = true; + mConn.awaitingReconnectResult = true; + mConn.reconnectAccount = account; + // This attempt is replaying a live token rather than recovering from a dead + // one, so release the latch: the next Char.Login.Default is an ordinary + // sign-in again and may use a stored token. + mReconnectRejected = false; + sendReconnect(account, std::move(token)); + return; + } + // Both branches above return, so reaching here means the stored token is not a + // rotation. That only counts as evidence the rejected token is still stored when + // this connection recorded what it sent; with no hash there is nothing to match. + rejectedTokenStillStored = !sentTokenHash.isEmpty(); + } + // Catch-all: scrub the parsed token on every path that did not move it into + // sendReconnect - including a stored entry with a token but an empty account - so a + // bearer secret is never dropped un-zeroed. Mirrors readStoredSignIn. + SecureStringUtils::secureStringClear(token); } } - // Catch-all: scrub the parsed token on every path that did not move it into - // sendReconnect - including a stored entry with a token but an empty account - so a - // bearer secret is never dropped un-zeroed. Mirrors readStoredSignIn. - SecureStringUtils::secureStringClear(token); - } - } - // Scrub the retrieved store copy on the fall-through too: when the rotation block was skipped - // (a second rejection, or an empty read) value may still hold token JSON. Idempotent when the - // block above already cleared it. - SecureStringUtils::secureStringClear(value); + // Scrub the retrieved store copy on the fall-through too: when the rotation block was skipped + // (a second rejection, or an empty read) value may still hold token JSON. Idempotent when the + // block above already cleared it. + SecureStringUtils::secureStringClear(value); - // The token really is dead. Keep the account+provider resume hint (dropping only the token) so - // the next attempt restarts the same provider's browser sign-in with no menu, then reconnect: - // servers commonly drop the connection right after rejecting a reconnect, so the fresh sign-in - // needs a fresh, stable connection. mReconnectRejected makes that next connection read the entry - // without replaying a possibly not-yet-rewritten token. - dropTokenKeepResumeHint(); - mReconnectRejected = true; - //: Shown when a saved password-less sign-in is no longer accepted; Mudlet reconnects so the user can sign in again. - mpHost->postMessage(tr("[ INFO ] - Your saved sign-in has expired; reconnecting so you can sign in again.")); - QTimer::singleShot(0ms, mpHost, [safeHost]() { - if (safeHost) { - safeHost->mTelnet.reconnect(); - } - }); - }); + // A superseded recovery rewrites the entry only when this read positively saw the rejected + // token still stored. Without that evidence - a failed read, an entry that never parsed, or a + // second rejection after a rotation replay - the newer attempt may already have saved its own + // fresh token (its Char.Login.Token can land while this read is in flight), and a token-less + // rewrite here would erase it and force another browser sign-in. Leaving the entry alone is + // self-correcting instead: the latch keeps the newer attempt from replaying a dead token, and + // if that attempt never completes, the next connection's rejection runs this recovery again + // un-superseded and drops it then. + if (superseded && !rejectedTokenStillStored) { + // Leaving the rejected token stored means re-arming the latch. The Char.Login.Default + // that superseded this recovery already consumed it in attemptReconnect(), so without + // this the *next* Char.Login.Default would be free to replay a token the server has + // already rejected - the very thing this whole path exists to prevent. Costs at most one + // extra resume on the connection after that. + mReconnectRejected = true; + return; + } + // The token really is dead. Keep the account+provider resume hint (dropping only the token) so + // the next attempt restarts the same provider's browser sign-in with no menu. The captured + // account and provider are used rather than mConn's, which a newer Char.Login.Default may have + // cleared - that would silently downgrade this to discarding the whole entry. + dropTokenKeepResumeHint(reconnectAccount, accountProvider); + if (superseded) { + // A newer attempt is already driving the sign-in; it consumes the latch set above and + // resumes (or hands off) without the dead token, so there is nothing left to do here. + return; + } + // Reconnect: servers commonly drop the connection right after rejecting a reconnect, so the + // fresh sign-in needs a fresh, stable connection. The latch set above makes that next + // connection read the entry without replaying a possibly not-yet-rewritten token. + //: Shown when a saved password-less sign-in is no longer accepted; Mudlet reconnects so the user can sign in again. + mpHost->postMessage(tr("[ INFO ] - Your saved sign-in has expired; reconnecting so you can sign in again.")); + QTimer::singleShot(0ms, mpHost, [safeHost]() { + if (safeHost) { + safeHost->mTelnet.reconnect(); + } + }); + }); } -void GMCPAuthenticator::dropTokenKeepResumeHint() +void GMCPAuthenticator::dropTokenKeepResumeHint(const QString& account, const QString& provider) { // Without a remembered provider there is nothing to resume, so remove the whole entry. - if (mConn.reconnectAccount.isEmpty() || mConn.accountProvider.isEmpty()) { + if (account.isEmpty() || provider.isEmpty()) { discardReconnectToken(); return; } - storeResumeHint(mConn.reconnectAccount, mConn.accountProvider); + storeResumeHint(account, provider); } // controller for GMCP authentication diff --git a/src/GMCPAuthenticator.h b/src/GMCPAuthenticator.h index 9ffcf2ccb..44cb16a5a 100644 --- a/src/GMCPAuthenticator.h +++ b/src/GMCPAuthenticator.h @@ -82,7 +82,9 @@ private: // replayed once instead of destroyed. Only a genuinely dead token is dropped, keeping the // account+provider resume hint so the next sign-in needs no provider menu. void retryOrDropRejectedToken(); - void dropTokenKeepResumeHint(); + // Takes the account and provider explicitly: the caller captures them before its keychain read, so + // a Char.Login.Default arriving mid-read cannot clear mConn and turn this into a full discard. + void dropTokenKeepResumeHint(const QString& account, const QString& provider); // Rewrites the stored entry as {account, provider} with no token: enough to resume later, nothing // any longer a bearer secret. void storeResumeHint(const QString& account, const QString& provider); @@ -144,11 +146,19 @@ private: }; PerConnectionState mConn; - // Set when a reconnect token is rejected and we reconnect for a clean sign-in. Deliberately NOT part - // of mConn: it is a one-shot latch consumed by attemptReconnect() on the very next connection, so it - // must survive the per-connection reset that the reconnect it triggers performs. The saved token is - // cleared asynchronously, so this makes that next connection skip a token replay rather than racing - // the keychain rewrite and looping back into another rejected reconnect. + // Set when a reconnect token is rejected, before the keychain read that decides what to do about it. + // Deliberately NOT part of mConn: attemptReconnect() consumes it on the next Char.Login.Default, so it + // must survive the per-connection reset that Default performs. The saved token is cleared + // asynchronously, so this makes the next attempt skip a token replay rather than racing the keychain + // rewrite and looping back into another rejected reconnect. That next Default usually arrives on the + // connection we reconnect to, but a server is also permitted to re-offer one on this connection + // instead, and Char.Login 2 forbids replaying a token rejected on it - hence latching synchronously at + // the rejection rather than when the read returns. + // + // Consumed in one place (attemptReconnect()) but cleared or re-armed in two others, so audit all three + // together: retryOrDropRejectedToken() clears it when it replays a live rotated token, and re-arms it + // when a superseded recovery leaves the rejected token stored - by then the superseding Default has + // already consumed the latch, so without re-arming the Default after that could replay the dead token. bool mReconnectRejected = false; // Incremented on every per-connection auth reset (each Char.Login.Default). The asynchronous // reconnect-token keychain read captures the value current when it started and re-checks it in its diff --git a/test/functional_tests/GMCPCharLoginTest.cpp b/test/functional_tests/GMCPCharLoginTest.cpp index 7d984c063..30da41939 100644 --- a/test/functional_tests/GMCPCharLoginTest.cpp +++ b/test/functional_tests/GMCPCharLoginTest.cpp @@ -530,6 +530,41 @@ private slots: QCOMPARE(mpServer->countReceived(qsl("Char.Login.Reconnect")), 0); } + void testRotationReplayClearsTheRejectionLatch() + { + Host* host = connectAndNegotiate(); + QVERIFY(host); + host->setLogin(QString()); + host->setPass(QString()); + const QString tokenJson = qsl("{\"account\": \"acct:char\", \"provider\": \"discord\", \"token\": \"token-A\"}"); + QVERIFY(CredentialManager::storeCredential(host->getName(), qsl("reconnect"), tokenJson)); + + mpServer->clearReceived(); + mpServer->sendGmcp(qsl("Char.Login.Default {\"version\": 2, \"type\": [\"oauth\", \"password-credentials\"]}")); + QJsonObject sent; + QVERIFY2(waitForClientGmcp(qsl("Char.Login.Reconnect"), sent), "client did not replay the saved token"); + QCOMPARE(sent.value(qsl("token")).toString(), qsl("token-A")); + + // Another instance rotates the token, so our replay of token-A is rejected and the client replays + // the fresh token-B rather than discarding it. + const QString rotatedJson = qsl("{\"account\": \"acct:char\", \"provider\": \"discord\", \"token\": \"token-B\"}"); + QVERIFY(CredentialManager::storeCredential(host->getName(), qsl("reconnect"), rotatedJson)); + mpServer->clearReceived(); + mpServer->sendGmcp(qsl("Char.Login.Result {\"success\": false, \"message\": \"Reconnect token expired\"}")); + QVERIFY2(waitForClientGmcp(qsl("Char.Login.Reconnect"), sent), "client did not replay the rotated token"); + QCOMPARE(sent.value(qsl("token")).toString(), qsl("token-B")); + + // Replaying a rotated token is an ordinary sign-in, not a recovery from a dead one, so the + // rejection latch must have been released again: a following Char.Login.Default may replay the + // stored token. Were the latch left set, this would come back as the token-less resume form and + // the player would face a browser sign-in despite holding a good token. + mpServer->clearReceived(); + mpServer->sendGmcp(qsl("Char.Login.Default {\"version\": 2, \"type\": [\"oauth\", \"password-credentials\"]}")); + QVERIFY2(waitForClientGmcp(qsl("Char.Login.Reconnect"), sent), "the rejection latch leaked past the rotation replay"); + QCOMPARE(sent.value(qsl("token")).toString(), qsl("token-B")); + QCOMPARE(mpServer->countReceived(qsl("Char.Login.Credentials")), 0); + } + void testCorruptStoredEntryFallsThroughToHandoff() { Host* host = connectAndNegotiate(); @@ -660,14 +695,18 @@ private slots: QCOMPARE(mpServer->countReceived(qsl("Char.Login.Reconnect")), 0); } - // NOTE: the stale-callback (mAuthAttemptGeneration) guard in readStoredSignIn/retryOrDropRejectedToken - // - which drops a reconnect-token keychain read whose connection was superseded by a newer - // Char.Login.Default before the async read resolved - is intentionally NOT covered here. It is not - // deterministically testable with the current harness: in test/portable mode CredentialManager reads - // credentials synchronously and inline (see CredentialManager::retrievePassword), so a read always - // completes before any superseding Char.Login.Default can arrive, and the guarded race never occurs. - // Exercising it would require an injectable, genuinely-asynchronous credential manager. Documented - // rather than covered by a test that would pass without ever reaching the guard. + // NOTE: the superseded-callback (mAuthAttemptGeneration) path in readStoredSignIn and + // retryOrDropRejectedToken - taken when a newer Char.Login.Default arrives before the reconnect-token + // keychain read resolves - is intentionally NOT covered here. It is not deterministically testable + // with the current harness: in test/portable mode CredentialManager reads credentials synchronously + // and inline (see CredentialManager::retrievePassword), so a read always completes before any + // superseding Char.Login.Default can arrive, and the race never occurs. Exercising it would require an + // injectable, genuinely-asynchronous credential manager. + // + // Worth the seam if anyone revisits this: in readStoredSignIn the path is a bare early return, but in + // retryOrDropRejectedToken it decides whether to rewrite the stored entry and whether to re-arm + // mReconnectRejected. Getting either wrong loses a player's freshly saved token or lets a rejected one + // be replayed, and neither failure is reachable by hand. // ---- Char.Login.Result -------------------------------------------------- From 7bb20fa2ceebaea60910601ec9cf6595ecf33631 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Wed, 5 Aug 2026 06:49:23 +0200 Subject: [PATCH 087/155] add: widget state getters for titles, stylesheets, tooltips and scroll bars (#9645) #### Brief overview of PR changes/additions - Seven state getters that are the inverse of setters we already ship: `getUserWindowTitle`, `getUserWindowStyleSheet`, `getCmdLineStyleSheet`, `getLabelToolTip`, `getScrollBarVisible`, `getMapWindowTitle` and `getMapWidgetGeometry` - Each returns nil plus a message when the window, label or map widget it names does not exist, reusing the matching setter's wording so the pair reports the same problems the same way - 39 specs added to the existing `UI_spec.lua` and `Mapper_spec.lua` #### Motivation for adding to Mudlet #9630's audit left 11 Geyser/UI rows untestable purely because the state those functions set could not be read back; this tranche unblocks them exactly as #9528's getters unblocked the geometry specs. Scripts get the same readback symmetry as a side effect. #### Other info (issues closed, discussion etc) One deliberate behaviour change: `enableScrollBar`/`disableScrollBar` now record what they were asked for, so `getScrollBarVisible` answers for a profile that is not the front tab (whose whole console Mudlet hides) instead of reporting every background profile's scroll bar as gone. Wiki pages for the seven functions to follow in Area 51. **Test case:** busted 1868 passed / 0 failed / 0 errors / 17 pending (baseline 1829), green twice on the same isolated profile, plus ctest; 31 of the new specs verified by breaking the getters - wrong return values fail 20, making the not-found branches succeed fails 7, and dropping the empty-name and nil handling fails 8 more. Assisted-by: Claude:claude-opus-5 --- src/Host.cpp | 23 ++ src/Host.h | 2 + src/TConsole.cpp | 14 + src/TConsole.h | 2 + src/TLuaInterpreter.cpp | 7 + src/TLuaInterpreter.h | 7 + src/TLuaInterpreterMapper.cpp | 16 ++ src/TLuaInterpreterUI.cpp | 92 +++++++ src/TMainConsole.cpp | 63 +++++ src/TMainConsole.h | 4 + src/mudlet-lua/tests/Mapper_spec.lua | 21 ++ src/mudlet-lua/tests/UI_spec.lua | 366 ++++++++++++++++++++++++++- 12 files changed, 611 insertions(+), 6 deletions(-) diff --git a/src/Host.cpp b/src/Host.cpp index e6de6a0d8..1b2d2e1dd 100644 --- a/src/Host.cpp +++ b/src/Host.cpp @@ -3486,6 +3486,15 @@ std::pair Host::setMapperTitle(const QString& title) return {true, QString()}; } +std::optional Host::getMapperTitle() const +{ + if (!mpConsole || !mpConsole->mpDockableMapWidget) { + return {}; + } + + return {mpConsole->mpDockableMapWidget->windowTitle()}; +} + std::pair Host::createMapView(int areaId) { if (!mpMap) { @@ -4250,6 +4259,20 @@ std::pair Host::openMapWidget(const QString& area, int x, int y, return {false, qsl(R"("docking option "%1" not available. available docking options are "t" top, "b" bottom, "r" right, "l" left and "f" floating")").arg(area)}; } +// The inverse of moveMapWidget()/resizeMapWidget(), which reach the dock widget +// through openMapWidget(). pos()/size() rather than geometry() for the same +// reason as Host::windowGeometry(): they are what move()/resize() were given, +// while a floating dock's geometry() reports the client area instead. +std::optional Host::mapWidgetGeometry() const +{ + if (!mpConsole || !mpConsole->mpDockableMapWidget) { + return {}; + } + + auto pM = mpConsole->mpDockableMapWidget; + return {QRect(pM->pos(), pM->size())}; +} + std::pair Host::closeMapWidget() { if (!mpConsole) { diff --git a/src/Host.h b/src/Host.h index 39c05a2ce..a20cc58a4 100644 --- a/src/Host.h +++ b/src/Host.h @@ -395,6 +395,7 @@ public: void setSearchOptions(const dlgTriggerEditor::SearchOptions); void setBufferSearchOptions(const TConsole::SearchOptions); std::pair setMapperTitle(const QString&); + std::optional getMapperTitle() const; // Multiple map views support std::pair createMapView(int areaId = 0); @@ -429,6 +430,7 @@ public: std::pair setWindow(const QString& windowname, const QString& name, int x1, int y1, bool show); std::pair openMapWidget(const QString& area, int x, int y, int width, int height); std::pair closeMapWidget(); + std::optional mapWidgetGeometry() const; bool closeWindow(const QString&); bool echoWindow(const QString&, const QString&); bool pasteWindow(const QString& name); diff --git a/src/TConsole.cpp b/src/TConsole.cpp index 081259f37..1327f292c 100644 --- a/src/TConsole.cpp +++ b/src/TConsole.cpp @@ -589,6 +589,10 @@ TConsole::TConsole(Host* pH, const QString& name, const ConsoleType type, QWidge mHScrollBarEnabled = true; } + // a Buffer is never displayed and the three types below start with their + // scroll bar hidden, so only the main and debug consoles begin with one + mScrollBarEnabled = !(mType & (ErrorConsole | SubConsole | UserWindow | Buffer)); + if (mType & (ErrorConsole | SubConsole | UserWindow)) { mpScrollBar->hide(); mLowerPane->hide(); @@ -1948,10 +1952,20 @@ void TConsole::setCommandFgColor(const QColor& newColor) void TConsole::setScrollBarVisible(bool isVisible) { if (mpScrollBar) { + mScrollBarEnabled = isVisible; mpScrollBar->setVisible(isVisible); } } +// Reports what enableScrollBar()/disableScrollBar() last asked for rather than +// QWidget::isVisible(): a profile that is not the front tab has its whole +// console hidden, which would otherwise make every background profile report +// its scroll bar as gone. +bool TConsole::getScrollBarVisible() const +{ + return mScrollBarEnabled; +} + void TConsole::setHorizontalScrollBar(bool isEnabled) { if (mpHScrollBar) { diff --git a/src/TConsole.h b/src/TConsole.h index 8a86b7b31..3e53d047f 100644 --- a/src/TConsole.h +++ b/src/TConsole.h @@ -252,6 +252,7 @@ public: void setCommandFgColor(const QColor&); void setCommandFgColor(int, int, int, int); void setScrollBarVisible(bool); + bool getScrollBarVisible() const; void setHorizontalScrollBar(bool); void setScrolling(const bool state); bool getScrolling() const { return mScrollingEnabled; } @@ -432,6 +433,7 @@ public: QString mWindowBgImagePath; QPixmap mWindowBgSourcePixmap; bool mHScrollBarEnabled = false; + bool mScrollBarEnabled = true; ControlCharacterMode mControlCharacter = ControlCharacterMode::AsIs; QVideoWidget* mpVideoWidget = nullptr; QSplitter* commandSplitter = nullptr; diff --git a/src/TLuaInterpreter.cpp b/src/TLuaInterpreter.cpp index 60f750f85..ee6e9f6dc 100644 --- a/src/TLuaInterpreter.cpp +++ b/src/TLuaInterpreter.cpp @@ -5371,6 +5371,7 @@ void TLuaInterpreter::initLuaGlobals() lua_register(pGlobalLua, "getFontSize", TLuaInterpreter::getFontSize); lua_register(pGlobalLua, "openUserWindow", TLuaInterpreter::openUserWindow); lua_register(pGlobalLua, "setUserWindowTitle", TLuaInterpreter::setUserWindowTitle); + lua_register(pGlobalLua, "getUserWindowTitle", TLuaInterpreter::getUserWindowTitle); lua_register(pGlobalLua, "echoUserWindow", TLuaInterpreter::echoUserWindow); lua_register(pGlobalLua, "enableTimer", TLuaInterpreter::enableTimer); lua_register(pGlobalLua, "disableTimer", TLuaInterpreter::disableTimer); @@ -5434,6 +5435,7 @@ void TLuaInterpreter::initLuaGlobals() lua_register(pGlobalLua, "setTextEditTabMovesFocus", TLuaInterpreter::setTextEditTabMovesFocus); lua_register(pGlobalLua, "deleteScrollBox", TLuaInterpreter::deleteScrollBox); lua_register(pGlobalLua, "setLabelToolTip", TLuaInterpreter::setLabelToolTip); + lua_register(pGlobalLua, "getLabelToolTip", TLuaInterpreter::getLabelToolTip); lua_register(pGlobalLua, "setLabelCursor", TLuaInterpreter::setLabelCursor); lua_register(pGlobalLua, "setLabelCustomCursor", TLuaInterpreter::setLabelCustomCursor); lua_register(pGlobalLua, "raiseWindow", TLuaInterpreter::raiseWindow); @@ -5463,6 +5465,7 @@ void TLuaInterpreter::initLuaGlobals() lua_register(pGlobalLua, "setCmdLineAction", TLuaInterpreter::setCmdLineAction); lua_register(pGlobalLua, "resetCmdLineAction", TLuaInterpreter::resetCmdLineAction); lua_register(pGlobalLua, "setCmdLineStyleSheet", TLuaInterpreter::setCmdLineStyleSheet); + lua_register(pGlobalLua, "getCmdLineStyleSheet", TLuaInterpreter::getCmdLineStyleSheet); lua_register(pGlobalLua, "setLabelClickCallback", TLuaInterpreter::setLabelClickCallback); lua_register(pGlobalLua, "setLabelDoubleClickCallback", TLuaInterpreter::setLabelDoubleClickCallback); lua_register(pGlobalLua, "setLabelReleaseCallback", TLuaInterpreter::setLabelReleaseCallback); @@ -5481,6 +5484,7 @@ void TLuaInterpreter::initLuaGlobals() lua_register(pGlobalLua, "setWindow", TLuaInterpreter::setWindow); lua_register(pGlobalLua, "openMapWidget", TLuaInterpreter::openMapWidget); lua_register(pGlobalLua, "closeMapWidget", TLuaInterpreter::closeMapWidget); + lua_register(pGlobalLua, "getMapWidgetGeometry", TLuaInterpreter::getMapWidgetGeometry); lua_register(pGlobalLua, "setTextFormat", TLuaInterpreter::setTextFormat); lua_register(pGlobalLua, "getMainWindowSize", TLuaInterpreter::getMainWindowSize); lua_register(pGlobalLua, "getUserWindowSize", TLuaInterpreter::getUserWindowSize); @@ -5555,6 +5559,7 @@ void TLuaInterpreter::initLuaGlobals() lua_register(pGlobalLua, "setConsoleBufferSize", TLuaInterpreter::setConsoleBufferSize); lua_register(pGlobalLua, "enableScrollBar", TLuaInterpreter::enableScrollBar); lua_register(pGlobalLua, "disableScrollBar", TLuaInterpreter::disableScrollBar); + lua_register(pGlobalLua, "getScrollBarVisible", TLuaInterpreter::getScrollBarVisible); lua_register(pGlobalLua, "enableHorizontalScrollBar", TLuaInterpreter::enableHorizontalScrollBar); lua_register(pGlobalLua, "disableHorizontalScrollBar", TLuaInterpreter::disableHorizontalScrollBar); lua_register(pGlobalLua, "enableCommandLine", TLuaInterpreter::enableCommandLine); @@ -5584,6 +5589,7 @@ void TLuaInterpreter::initLuaGlobals() lua_register(pGlobalLua, "killAlias", TLuaInterpreter::killAlias); lua_register(pGlobalLua, "setLabelStyleSheet", TLuaInterpreter::setLabelStyleSheet); lua_register(pGlobalLua, "setUserWindowStyleSheet", TLuaInterpreter::setUserWindowStyleSheet); + lua_register(pGlobalLua, "getUserWindowStyleSheet", TLuaInterpreter::getUserWindowStyleSheet); lua_register(pGlobalLua, "getTime", TLuaInterpreter::getTime); lua_register(pGlobalLua, "getEpoch", TLuaInterpreter::getEpoch); lua_register(pGlobalLua, "invokeFileDialog", TLuaInterpreter::invokeFileDialog); @@ -5876,6 +5882,7 @@ void TLuaInterpreter::initLuaGlobals() lua_register(pGlobalLua, "getConnectionInfo", TLuaInterpreter::getConnectionInfo); lua_register(pGlobalLua, "unzipAsync", TLuaInterpreter::unzipAsync); lua_register(pGlobalLua, "setMapWindowTitle", TLuaInterpreter::setMapWindowTitle); + lua_register(pGlobalLua, "getMapWindowTitle", TLuaInterpreter::getMapWindowTitle); lua_register(pGlobalLua, "getMudletInfo", TLuaInterpreter::getMudletInfo); lua_register(pGlobalLua, "getMapBackgroundColor", TLuaInterpreter::getMapBackgroundColor); lua_register(pGlobalLua, "setMapBackgroundColor", TLuaInterpreter::setMapBackgroundColor); diff --git a/src/TLuaInterpreter.h b/src/TLuaInterpreter.h index c6c23dbdb..d0c1f935d 100644 --- a/src/TLuaInterpreter.h +++ b/src/TLuaInterpreter.h @@ -371,6 +371,7 @@ public: static int getFontSize(lua_State*); static int openUserWindow(lua_State*); static int setUserWindowTitle(lua_State*); + static int getUserWindowTitle(lua_State*); static int echoUserWindow(lua_State*); static int clearUserWindow(lua_State*); static int enableTimer(lua_State*); @@ -464,12 +465,14 @@ public: static int setTextEditTabMovesFocus(lua_State*); static int deleteScrollBox(lua_State*); static int setLabelToolTip(lua_State*); + static int getLabelToolTip(lua_State*); static int setLabelCursor(lua_State*); static int setLabelCustomCursor(lua_State*); static int moveWindow(lua_State*); static int setWindow(lua_State*); static int openMapWidget(lua_State*); static int closeMapWidget(lua_State*); + static int getMapWidgetGeometry(lua_State*); static int setTextFormat(lua_State*); static int setBackgroundImage(lua_State*); static int resetBackgroundImage(lua_State*); @@ -486,6 +489,7 @@ public: static int setCmdLineAction(lua_State*); static int resetCmdLineAction(lua_State*); static int setCmdLineStyleSheet(lua_State*); + static int getCmdLineStyleSheet(lua_State*); static int getImageSize(lua_State*); static int setLabelDoubleClickCallback(lua_State*); static int setLabelReleaseCallback(lua_State*); @@ -560,6 +564,7 @@ public: static int getConsoleBufferSize(lua_State*); static int setConsoleBufferSize(lua_State*); static int enableScrollBar(lua_State*); + static int getScrollBarVisible(lua_State*); static int disableScrollBar(lua_State*); static int disableHorizontalScrollBar(lua_State*); static int enableHorizontalScrollBar(lua_State*); @@ -599,6 +604,7 @@ public: static int killAlias(lua_State*); static int permBeginOfLineStringTrigger(lua_State*); static int setUserWindowStyleSheet(lua_State*); + static int getUserWindowStyleSheet(lua_State*); static int getTime(lua_State*); static int getEpoch(lua_State*); static int invokeFileDialog(lua_State*); @@ -727,6 +733,7 @@ public: static int getConnectionInfo(lua_State*); static int unzipAsync(lua_State*); static int setMapWindowTitle(lua_State*); + static int getMapWindowTitle(lua_State*); static int getMudletInfo(lua_State*); static int getMapBackgroundColor(lua_State*); static int setMapBackgroundColor(lua_State*); diff --git a/src/TLuaInterpreterMapper.cpp b/src/TLuaInterpreterMapper.cpp index caba64e28..cd71e75a4 100644 --- a/src/TLuaInterpreterMapper.cpp +++ b/src/TLuaInterpreterMapper.cpp @@ -951,6 +951,22 @@ int TLuaInterpreter::closeMapWidget(lua_State* L) return 1; } +// Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#getMapWidgetGeometry +int TLuaInterpreter::getMapWidgetGeometry(lua_State* L) +{ + const Host& host = getHostFromLua(L); + + if (auto geometry = host.mapWidgetGeometry()) { + lua_pushnumber(L, geometry->x()); + lua_pushnumber(L, geometry->y()); + lua_pushnumber(L, geometry->width()); + lua_pushnumber(L, geometry->height()); + return 4; + } + + return warnArgumentValue(L, __func__, "no floating/dockable type map window found"); +} + // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#connectExitStub int TLuaInterpreter::connectExitStub(lua_State* L) { diff --git a/src/TLuaInterpreterUI.cpp b/src/TLuaInterpreterUI.cpp index 78bf7c312..ca75c686e 100644 --- a/src/TLuaInterpreterUI.cpp +++ b/src/TLuaInterpreterUI.cpp @@ -1117,6 +1117,15 @@ int TLuaInterpreter::enableScrollBar(lua_State* L) return 0; } +// Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#getScrollBarVisible +int TLuaInterpreter::getScrollBarVisible(lua_State* L) +{ + const QString windowName{WINDOW_NAME(L, 1)}; + auto console = CONSOLE(L, windowName); + lua_pushboolean(L, console->getScrollBarVisible()); + return 1; +} + // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#enableTimeStamps int TLuaInterpreter::enableTimeStamps(lua_State* L) { @@ -2982,6 +2991,27 @@ int TLuaInterpreter::setCmdLineStyleSheet(lua_State* L) return 1; } +// Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#getCmdLineStyleSheet +int TLuaInterpreter::getCmdLineStyleSheet(lua_State* L) +{ + // an explicit nil means "the main command line", as it does for the window + // name of every other getter that takes an optional one + const bool hasName = lua_gettop(L) > 0 && !lua_isnil(L, 1); + if (hasName && !checkStringArg(L, __func__, 1, "command line name")) { + return lua_error(L); + } + + const QString name = hasName ? QString{lua_tostring(L, 1)} : qsl("main"); + const Host& host = getHostFromLua(L); + + if (auto styleSheet = host.mpConsole->getCmdLineStyleSheet(name)) { + lua_pushstring(L, styleSheet->toUtf8().constData()); + return 1; + } + + return warnArgumentValue(L, __func__, qsl("command-line name '%1' not found").arg(name)); +} + // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setFont int TLuaInterpreter::setFont(lua_State* L) { @@ -3124,6 +3154,23 @@ int TLuaInterpreter::setLabelToolTip(lua_State* L) return 1; } +// Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#getLabelToolTip +int TLuaInterpreter::getLabelToolTip(lua_State* L) +{ + const QString labelName = getVerifiedString(L, __func__, 1, "label name"); + if (labelName.isEmpty()) { + return warnArgumentValue(L, __func__, "a label cannot have an empty string as its name"); + } + + const Host& host = getHostFromLua(L); + if (auto toolTip = host.mpConsole->getLabelToolTip(labelName)) { + lua_pushstring(L, toolTip->toUtf8().constData()); + return 1; + } + + return warnArgumentValue(L, __func__, qsl("label name '%1' not found").arg(labelName)); +} + // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setLabelClickCallback int TLuaInterpreter::setLabelClickCallback(lua_State* L) { @@ -3296,6 +3343,19 @@ int TLuaInterpreter::setMapWindowTitle(lua_State* L) return 1; } +// Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#getMapWindowTitle +int TLuaInterpreter::getMapWindowTitle(lua_State* L) +{ + const Host& host = getHostFromLua(L); + + if (auto title = host.getMapperTitle()) { + lua_pushstring(L, title->toUtf8().constData()); + return 1; + } + + return warnArgumentValue(L, __func__, "no floating/dockable type map window found"); +} + // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setMovie int TLuaInterpreter::setMovie(lua_State* L) { @@ -3595,6 +3655,21 @@ int TLuaInterpreter::setUserWindowTitle(lua_State* L) return 1; } +// Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#getUserWindowTitle +int TLuaInterpreter::getUserWindowTitle(lua_State* L) +{ + const QString name = getVerifiedString(L, __func__, 1, "name"); + const Host& host = getHostFromLua(L); + + auto [success, result] = host.mpConsole->getUserWindowTitle(name); + if (!success) { + return warnArgumentValue(L, __func__, result); + } + + lua_pushstring(L, result.toUtf8().constData()); + return 1; +} + // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setUserWindowStyleSheet int TLuaInterpreter::setUserWindowStyleSheet(lua_State* L) { @@ -3613,6 +3688,23 @@ int TLuaInterpreter::setUserWindowStyleSheet(lua_State* L) return 1; } +// Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#getUserWindowStyleSheet +int TLuaInterpreter::getUserWindowStyleSheet(lua_State* L) +{ + const QString userWindowName = getVerifiedString(L, __func__, 1, "userwindow name"); + if (userWindowName.isEmpty()) { + return warnArgumentValue(L, __func__, "a userwindow cannot have an empty string as its name"); + } + + const Host& host = getHostFromLua(L); + if (auto styleSheet = host.mpConsole->getUserWindowStyleSheet(userWindowName)) { + lua_pushstring(L, styleSheet->toUtf8().constData()); + return 1; + } + + return warnArgumentValue(L, __func__, qsl("userwindow name '%1' not found").arg(userWindowName)); +} + // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setWindow int TLuaInterpreter::setWindow(lua_State* L) { diff --git a/src/TMainConsole.cpp b/src/TMainConsole.cpp index 9cf79da15..113c88c41 100644 --- a/src/TMainConsole.cpp +++ b/src/TMainConsole.cpp @@ -145,6 +145,16 @@ std::optional TMainConsole::getLabelSizeHint(const QString& name) const return {}; } +std::optional TMainConsole::getLabelToolTip(const QString& name) const +{ + auto pL = mLabelMap.value(name); + if (!pL) { + return {}; + } + + return {pL->toolTip()}; +} + // NOLINTNEXTLINE(readability-make-member-function-const) std::pair TMainConsole::setUserWindowStyleSheet(const QString& name, const QString& userWindowStyleSheet) { @@ -160,6 +170,16 @@ std::pair TMainConsole::setUserWindowStyleSheet(const QString& na return {false, qsl("userwindow name '%1' not found").arg(name)}; } +std::optional TMainConsole::getUserWindowStyleSheet(const QString& name) const +{ + auto pW = mDockWidgetMap.value(name); + if (!pW) { + return {}; + } + + return {pW->styleSheet()}; +} + std::pair TMainConsole::setCmdLineStyleSheet(const QString& name, const QString& styleSheet) { if (name.isEmpty() || !name.compare(qsl("main"))) { @@ -175,6 +195,23 @@ std::pair TMainConsole::setCmdLineStyleSheet(const QString& name, return {false, qsl("command-line name '%1' not found").arg(name)}; } +std::optional TMainConsole::getCmdLineStyleSheet(const QString& name) const +{ + if (name.isEmpty() || !name.compare(qsl("main"))) { + if (auto pMain = mpHost->mpConsole->mpCommandLine) { + return {pMain->styleSheet()}; + } + return {}; + } + + auto pN = mSubCommandLineMap.value(name); + if (!pN) { + return {}; + } + + return {pN->styleSheet()}; +} + void TMainConsole::toggleLogging(bool isMessageEnabled) { const auto loggingPath = mudlet::getMudletPath(enums::profileDataItemPath, mpHost->getName(), qsl("autolog")); @@ -1375,6 +1412,32 @@ std::pair TMainConsole::setUserWindowTitle(const QString& name, c return {false, qsl("internal error: TConsole \"%1\" is marked as a user window but does not have a TDockWidget to contain it").arg(name)}; } +// The title is in .second when .first is true, otherwise .second is why there +// is none. Mirrors setUserWindowTitle's checks in the same order and words, so +// that a miniconsole sharing the name is not reported as a missing window. +std::pair TMainConsole::getUserWindowTitle(const QString& name) const +{ + if (name.isEmpty()) { + return {false, qsl("a user window cannot have an empty string as its name")}; + } + + auto pC = mSubConsoleMap.value(name); + if (!pC) { + return {false, qsl("user window name '%1' not found").arg(name)}; + } + + if (pC->getType() != UserWindow) { + return {false, qsl("\"%1\" is not a user window").arg(name)}; + } + + auto pD = mDockWidgetMap.value(name); + if (!pD) { + return {false, qsl("internal error: TConsole \"%1\" is marked as a user window but does not have a TDockWidget to contain it").arg(name)}; + } + + return {true, pD->windowTitle()}; +} + bool TMainConsole::setTextFormat(const QString& name, const QColor& fgColor, const QColor& bgColor, const TChar::AttributeFlags& flags) { if (name.isEmpty() || name.compare(qsl("main"), Qt::CaseSensitive) == 0) { diff --git a/src/TMainConsole.h b/src/TMainConsole.h index de16a42a5..29d3865e2 100644 --- a/src/TMainConsole.h +++ b/src/TMainConsole.h @@ -70,7 +70,9 @@ public: QString getCurrentLine(const std::string&); TConsole* createBuffer(const QString& name); std::pair setUserWindowStyleSheet(const QString& name, const QString& userWindowStyleSheet); + std::optional getUserWindowStyleSheet(const QString& name) const; std::pair setUserWindowTitle(const QString& name, const QString& text); + std::pair getUserWindowTitle(const QString& name) const; bool setTextFormat(const QString& name, const QColor& fgColor, const QColor& bgColor, const TChar::AttributeFlags& flags); TLabel* createLabel(const QString& windowname, const QString& name, int x, int y, int width, int height, bool fillBackground, bool clickThrough = false); std::pair createMapper(const QString& windowname, int, int, int, int); @@ -78,6 +80,7 @@ public: std::pair createTextBox(const QString& windowname, const QString& name, int, int, int, int); QSize getUserWindowSize(const QString& windowname) const; std::pair setCmdLineStyleSheet(const QString& name, const QString& styleSheet); + std::optional getCmdLineStyleSheet(const QString& name) const; std::pair setLabelStyleSheet(const QString& name, const QString& stylesheet); std::optional getLabelStyleSheet(const QString& name) const; std::optional getLabelSizeHint(const QString& name) const; @@ -87,6 +90,7 @@ public: std::pair deleteTextBox(const QString&); std::pair deleteScrollBox(const QString&); std::pair setLabelToolTip(const QString& name, const QString& text, double duration); + std::optional getLabelToolTip(const QString& name) const; std::pair setLabelCursor(const QString& name, int shape); std::pair setLabelCustomCursor(const QString& name, const QString& pixMapLocation, int hotX, int hotY); bool setBackgroundImage(const QString& name, const QString& path); diff --git a/src/mudlet-lua/tests/Mapper_spec.lua b/src/mudlet-lua/tests/Mapper_spec.lua index 572e8af8b..ff6a563cd 100644 --- a/src/mudlet-lua/tests/Mapper_spec.lua +++ b/src/mudlet-lua/tests/Mapper_spec.lua @@ -27,6 +27,27 @@ describe("Tests map events and menus before the map widget is opened", function( assert.is_nil(getMapMenus()["PreWidgetMenu"]) end) + -- nothing can destroy the map widget again once it exists, so a second + -- runTests in the same session inherits one and these two have nothing left + -- to observe + it("should report that there is no map widget to read a title from", function() + local title, err = getMapWindowTitle() + if title then + pending("the map widget is already open in this session") + return + end + assert.are.equal("no floating/dockable type map window found", err) + end) + + it("should report that there is no map widget to read a geometry from", function() + local x, err = getMapWidgetGeometry() + if x then + pending("the map widget is already open in this session") + return + end + assert.are.equal("no floating/dockable type map window found", err) + end) + it("should retain a registration for when the widget opens later", function() assert.is_true(addMapEvent("preWidgetKeptEvent", "myEvent", "", "Kept Event")) end) diff --git a/src/mudlet-lua/tests/UI_spec.lua b/src/mudlet-lua/tests/UI_spec.lua index efd1b6fbe..42c9af44a 100644 --- a/src/mudlet-lua/tests/UI_spec.lua +++ b/src/mudlet-lua/tests/UI_spec.lua @@ -2650,10 +2650,10 @@ describe("Window state getters", function() end) it("returns nil and a message naming an unknown window", function() - local result, err = getWindowGeometry("wsgNoSuchWindow") + local result, err = getWindowGeometry("wdgNoSuchWindow") assert.is_nil(result) assert.are.equal("string", type(err)) - assert.is_truthy(err:find("wsgNoSuchWindow", 1, true)) + assert.is_truthy(err:find("wdgNoSuchWindow", 1, true)) end) it("returns nil and a message for the main window", function() @@ -2721,10 +2721,10 @@ describe("Window state getters", function() end) it("returns nil and a message naming an unknown window", function() - local result, err = windowVisible("wsgNoSuchWindow") + local result, err = windowVisible("wdgNoSuchWindow") assert.is_nil(result) assert.are.equal("string", type(err)) - assert.is_truthy(err:find("wsgNoSuchWindow", 1, true)) + assert.is_truthy(err:find("wdgNoSuchWindow", 1, true)) end) it("returns nil and a message for the main window", function() @@ -2752,10 +2752,10 @@ describe("Window state getters", function() end) it("returns nil and a message naming an unknown label", function() - local result, err = getLabelText("wsgNoSuchLabel") + local result, err = getLabelText("wdgNoSuchLabel") assert.is_nil(result) assert.are.equal("string", type(err)) - assert.is_truthy(err:find("wsgNoSuchLabel", 1, true)) + assert.is_truthy(err:find("wdgNoSuchLabel", 1, true)) end) it("returns nil and a message for a non-label window", function() @@ -4089,3 +4089,357 @@ describe("Window and label state", function() end) end) end) + +-- Widget state getters: titles, stylesheets, tooltips, scroll bars and the map +-- widget's geometry, all of which could previously only be set. Self-contained +-- top-level block kept at the tail of the file; do not interleave it with the +-- blocks above. +describe("Widget state getters", function() + -- user windows and the map widget cannot be deleted from Lua, only hidden, + -- so keep the names unique per run + local suffix = ("-%d-%d"):format(os.time(), math.random(100000)) + local function name(base) + return base .. suffix + end + + local userWindow = name("wdgUserWindow") + local label = name("wdgLabel") + local console = name("wdgConsole") + local cmdLine = name("wdgCmdLine") + + setup(function() + -- loadLayout is off so a saved layout cannot move the window under us + openUserWindow(userWindow, false) + createLabel(label, 10, 20, 100, 50, 1) + createMiniConsole(console, 30, 40, 300, 150) + createCommandLine(cmdLine, 15, 25, 140, 35) + end) + + teardown(function() + deleteLabel(label) + deleteMiniConsole(console) + deleteCommandLine(cmdLine) + hideWindow(userWindow) + end) + + describe("getUserWindowTitle", function() + teardown(function() + resetUserWindowTitle(userWindow) + end) + + it("returns the title set by setUserWindowTitle", function() + assert.is_true(setUserWindowTitle(userWindow, "A user window title")) + assert.are.equal("A user window title", getUserWindowTitle(userWindow)) + end) + + it("round-trips an updated title", function() + setUserWindowTitle(userWindow, "first title") + assert.are.equal("first title", getUserWindowTitle(userWindow)) + setUserWindowTitle(userWindow, "second title") + assert.are.equal("second title", getUserWindowTitle(userWindow)) + end) + + it("reports the generated default title after resetUserWindowTitle", function() + setUserWindowTitle(userWindow, "not the default") + assert.is_true(resetUserWindowTitle(userWindow)) + local title = getUserWindowTitle(userWindow) + assert.are.equal("string", type(title)) + assert.is_truthy(title:find(getProfileName(), 1, true)) + assert.is_truthy(title:find(userWindow, 1, true)) + end) + + it("returns nil and a message naming an unknown user window", function() + local unknown = name("wdgNoSuchUserWindow") + local ok, err = getUserWindowTitle(unknown) + assert.is_nil(ok) + assert.are.equal(("user window name '%s' not found"):format(unknown), err) + end) + + it("says a miniconsole of that name is not a user window", function() + -- the same distinction setUserWindowTitle makes, so a script is not told + -- a name is free when it is already taken by something else + local ok, err = getUserWindowTitle(console) + assert.is_nil(ok) + assert.are.equal(('"%s" is not a user window'):format(console), err) + end) + + it("rejects an empty name the way setUserWindowTitle does", function() + local ok, err = getUserWindowTitle("") + assert.is_nil(ok) + assert.are.equal("a user window cannot have an empty string as its name", err) + end) + + it("errors when called without a name", function() + assert.has_error(function() getUserWindowTitle() end) + end) + end) + + describe("getUserWindowStyleSheet", function() + teardown(function() + setUserWindowStyleSheet(userWindow, "") + end) + + it("returns the stylesheet set by setUserWindowStyleSheet", function() + local css = "background-color: rgb(11,22,33);" + assert.is_true(setUserWindowStyleSheet(userWindow, css)) + assert.are.equal(css, getUserWindowStyleSheet(userWindow)) + end) + + it("round-trips an updated stylesheet", function() + setUserWindowStyleSheet(userWindow, "background-color: rgb(1,2,3);") + assert.are.equal("background-color: rgb(1,2,3);", getUserWindowStyleSheet(userWindow)) + setUserWindowStyleSheet(userWindow, "background-color: rgb(4,5,6);") + assert.are.equal("background-color: rgb(4,5,6);", getUserWindowStyleSheet(userWindow)) + end) + + it("reports an empty stylesheet once it is cleared", function() + setUserWindowStyleSheet(userWindow, "background-color: rgb(7,8,9);") + assert.is_true(setUserWindowStyleSheet(userWindow, "")) + assert.are.equal("", getUserWindowStyleSheet(userWindow)) + end) + + it("returns nil and a message naming an unknown user window", function() + local unknown = name("wdgNoSuchUserWindow") + local ok, err = getUserWindowStyleSheet(unknown) + assert.is_nil(ok) + assert.are.equal(("userwindow name '%s' not found"):format(unknown), err) + end) + + it("rejects an empty name the way setUserWindowStyleSheet does", function() + local ok, err = getUserWindowStyleSheet("") + assert.is_nil(ok) + assert.are.equal("a userwindow cannot have an empty string as its name", err) + end) + + it("errors when called without a name", function() + assert.has_error(function() getUserWindowStyleSheet() end) + end) + end) + + describe("getCmdLineStyleSheet", function() + local originalMainStyleSheet + + setup(function() + originalMainStyleSheet = getCmdLineStyleSheet() + end) + + teardown(function() + setCmdLineStyleSheet("main", originalMainStyleSheet) + setCmdLineStyleSheet(cmdLine, "") + end) + + it("returns the stylesheet set on a created command line", function() + local css = "color: rgb(12,34,56);" + assert.is_true(setCmdLineStyleSheet(cmdLine, css)) + assert.are.equal(css, getCmdLineStyleSheet(cmdLine)) + end) + + it("round-trips an updated stylesheet", function() + setCmdLineStyleSheet(cmdLine, "color: rgb(1,2,3);") + assert.are.equal("color: rgb(1,2,3);", getCmdLineStyleSheet(cmdLine)) + setCmdLineStyleSheet(cmdLine, "color: rgb(4,5,6);") + assert.are.equal("color: rgb(4,5,6);", getCmdLineStyleSheet(cmdLine)) + end) + + it("defaults to the main command line when given no name or nil", function() + -- the one-argument form of the setter targets "main" as well + local css = "color: rgb(9,9,9);" + assert.is_true(setCmdLineStyleSheet(css)) + assert.are.equal(css, getCmdLineStyleSheet()) + assert.are.equal(css, getCmdLineStyleSheet(nil)) + assert.are.equal(css, getCmdLineStyleSheet("main")) + end) + + it("returns nil and a message naming an unknown command line", function() + local unknown = name("wdgNoSuchCmdLine") + local ok, err = getCmdLineStyleSheet(unknown) + assert.is_nil(ok) + assert.are.equal(("command-line name '%s' not found"):format(unknown), err) + end) + end) + + describe("getLabelToolTip", function() + teardown(function() + resetLabelToolTip(label) + end) + + it("returns the tooltip set by setLabelToolTip", function() + assert.is_true(setLabelToolTip(label, "a tooltip")) + assert.are.equal("a tooltip", getLabelToolTip(label)) + end) + + -- only the text is read back: the setter's duration reaches Qt's own + -- tooltip timer, which reinterprets it, so it is not part of this getter + it("keeps the text when a display duration is given", function() + assert.is_true(setLabelToolTip(label, "a timed tooltip", 5)) + assert.are.equal("a timed tooltip", getLabelToolTip(label)) + end) + + it("round-trips a multi-byte tooltip unchanged", function() + assert.is_true(setLabelToolTip(label, "Ünïcödé tooltip - 日本語")) + assert.are.equal("Ünïcödé tooltip - 日本語", getLabelToolTip(label)) + end) + + it("reports an empty tooltip after resetLabelToolTip", function() + setLabelToolTip(label, "a tooltip to clear") + assert.is_true(resetLabelToolTip(label)) + assert.are.equal("", getLabelToolTip(label)) + end) + + it("returns nil and a message naming an unknown label", function() + local unknown = name("wdgNoSuchLabel") + local ok, err = getLabelToolTip(unknown) + assert.is_nil(ok) + assert.are.equal(("label name '%s' not found"):format(unknown), err) + end) + + it("rejects an empty name the way setLabelToolTip does", function() + local ok, err = getLabelToolTip("") + assert.is_nil(ok) + assert.are.equal("a label cannot have an empty string as its name", err) + end) + + it("errors when called without a label name", function() + assert.has_error(function() getLabelToolTip() end) + end) + end) + + describe("getScrollBarVisible", function() + local originalMainScrollBar + local freshConsole = name("wdgFreshConsole") + local bufferName = name("wdgBuffer") + + setup(function() + originalMainScrollBar = getScrollBarVisible("main") + end) + + teardown(function() + -- restore the shared main window even if a spec above bailed out early + if originalMainScrollBar then + enableScrollBar("main") + else + disableScrollBar("main") + end + showWindow(console) + deleteMiniConsole(freshConsole) + deleteMiniConsole(bufferName) + end) + + it("reflects enableScrollBar and disableScrollBar on a miniconsole", function() + enableScrollBar(console) + assert.is_true(getScrollBarVisible(console)) + disableScrollBar(console) + assert.is_false(getScrollBarVisible(console)) + enableScrollBar(console) + assert.is_true(getScrollBarVisible(console)) + end) + + it("reports a miniconsole's scroll bar as hidden until it is enabled", function() + createMiniConsole(freshConsole, 10, 10, 200, 100) + assert.is_false(getScrollBarVisible(freshConsole)) + enableScrollBar(freshConsole) + assert.is_true(getScrollBarVisible(freshConsole)) + end) + + it("keeps reporting an enabled scroll bar while the console is hidden", function() + -- the reason this reads back an intent rather than the widget: Mudlet + -- hides the whole console of any profile that is not the front tab + enableScrollBar(console) + hideWindow(console) + assert.is_true(getScrollBarVisible(console)) + showWindow(console) + assert.is_true(getScrollBarVisible(console)) + end) + + it("reports a buffer, which never has a scroll bar, as not having one", function() + createBuffer(bufferName) + assert.is_false(getScrollBarVisible(bufferName)) + end) + + it("reflects disableScrollBar and enableScrollBar on the main window", function() + disableScrollBar("main") + assert.is_false(getScrollBarVisible("main")) + enableScrollBar("main") + assert.is_true(getScrollBarVisible("main")) + end) + + it("defaults to the main window when given no name", function() + disableScrollBar("main") + assert.is_false(getScrollBarVisible()) + enableScrollBar("main") + assert.is_true(getScrollBarVisible()) + end) + + it("returns nil and a message naming an unknown window", function() + local unknown = name("wdgNoSuchWindow") + local ok, err = getScrollBarVisible(unknown) + assert.is_nil(ok) + assert.are.equal(('window "%s" not found'):format(unknown), err) + end) + end) + + -- The "no map widget" error path for these two is covered in Mapper_spec, + -- which runs first and whose opening spec is the only point in the session + -- where the widget does not exist yet. + describe("map widget getters", function() + setup(function() + assert.is_true(openMapWidget()) + end) + + teardown(function() + resetMapWindowTitle() + -- resizeMapWidget/moveMapWidget force the widget floating; put it back so + -- this block does not hand a floating map widget to whatever runs next + openMapWidget("r") + end) + + it("getMapWindowTitle returns the title set by setMapWindowTitle", function() + assert.is_true(setMapWindowTitle("A map title")) + assert.are.equal("A map title", getMapWindowTitle()) + end) + + it("getMapWindowTitle round-trips an updated title", function() + setMapWindowTitle("first map title") + assert.are.equal("first map title", getMapWindowTitle()) + setMapWindowTitle("second map title") + assert.are.equal("second map title", getMapWindowTitle()) + end) + + it("getMapWindowTitle reports the generated default after resetMapWindowTitle", function() + setMapWindowTitle("not the default") + assert.is_true(resetMapWindowTitle()) + local title = getMapWindowTitle() + assert.are.equal("string", type(title)) + assert.is_truthy(title:find(getProfileName(), 1, true)) + end) + + -- the sizes below are comfortably above the map widget's minimum size hint + -- so that a resize cannot come back clamped + it("getMapWidgetGeometry reflects resizeMapWidget", function() + -- size() is the exact inverse of the resize() resizeMapWidget makes and + -- does not depend on a window manager honouring a move + resizeMapWidget(640, 480) + local _, _, w, h = getMapWidgetGeometry() + assert.are.same({640, 480}, {w, h}) + resizeMapWidget(560, 440) + local _, _, w2, h2 = getMapWidgetGeometry() + assert.are.same({560, 440}, {w2, h2}) + end) + + it("getMapWidgetGeometry reflects moveMapWidget", function() + resizeMapWidget(600, 460) + moveMapWidget(120, 130) + local x1, y1 = getMapWidgetGeometry() + moveMapWidget(300, 350) + local x2, y2, w, h = getMapWidgetGeometry() + -- a window manager can add a constant frame offset to where a floating + -- dock lands, so the movement is asserted rather than the position + assert.are.same({180, 220}, {x2 - x1, y2 - y1}) + assert.are.same({600, 460}, {w, h}) + end) + + it("getMapWidgetGeometry returns exactly four values", function() + assert.are.equal(4, select("#", getMapWidgetGeometry())) + end) + end) +end) From c45f151385da0c9975a0902bd25a2bf23d4f1f31 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Wed, 5 Aug 2026 06:49:43 +0200 Subject: [PATCH 088/155] fix: Discord getters no longer treat presence text as a format string (#9660) #### Brief overview of PR changes/additions - The six Discord getters (`getDiscordDetail`, `getDiscordState`, `getDiscordLargeIcon`/`Text`, `getDiscordSmallIcon`/`Text`) passed the stored presence text to `lua_pushfstring()` as its *format* string, so every `%` in it was read as a printf specifier consuming an argument that was never passed: `"Level %d Mage"` came back as `"Level 3202416 Mage"`, `"%%"` was silently halved, and a text ending in `%` read past the end of the buffer and returned the bytes that followed it as part of the Lua string. - All six now push the text as data. Output is byte-identical to today's for any text without a `%`. - Five regression specs added to `Discord_spec.lua`, covering all six getters and the `%d`, `%s`, `%%` and trailing-`%` shapes; the `pending()` entry that recorded this defect is unpended. #### Motivation for adding to Mudlet Presence text arrives from the game server over GMCP (`Host::processDiscordGMCP`), so a game whose status line contains a stray `%` can garble - and, with a trailing `%` or a `%s`, crash or leak adjacent heap bytes into a Lua string - for any user whose script reads the presence back. There is no write primitive (Lua 5.1's `lua_pushfstring` has no `%n`), so the ceiling is a crash plus memory disclosure, not code execution. Stacks on #9631, whose Discord IPC fixture is what makes these specs possible; it retargets to `development` once that merges. **Test case:** all five new specs fail against the unfixed binary (`Level 3202416 Mage`, `100% health` for `100%% health`, and `mana at 50%` returned with trailing heap garbage) and pass with it; Lua suite 1853 successes / 0 failures / 0 errors / 40 pending twice with the fixture and 1829 / 0 / 0 / 64 without it, ctest 69/70 (only the known-environmental `TKeySequenceEditTest` Xvfb flake). Assisted-by: Claude:claude-opus-5 --- src/TLuaInterpreterDiscord.cpp | 15 +++--- src/mudlet-lua/tests/Discord_spec.lua | 75 +++++++++++++++++++++++---- 2 files changed, 73 insertions(+), 17 deletions(-) diff --git a/src/TLuaInterpreterDiscord.cpp b/src/TLuaInterpreterDiscord.cpp index e9ad46333..ee1fa255c 100644 --- a/src/TLuaInterpreterDiscord.cpp +++ b/src/TLuaInterpreterDiscord.cpp @@ -118,7 +118,10 @@ int TLuaInterpreter::getDiscordDetail(lua_State* L) return warnArgumentValue(L, __func__, result.second); } - lua_pushfstring(L, pMudlet->mDiscord.getDetailText(&host).toUtf8().constData()); + // Pushed as data, never as a format string: presence text can come from the + // game server, and a '%' in it would otherwise be taken as a printf + // specifier. The same holds for the five other Discord text getters below. + lua_pushstring(L, pMudlet->mDiscord.getDetailText(&host).toUtf8().constData()); return 1; } @@ -133,7 +136,7 @@ int TLuaInterpreter::getDiscordLargeIcon(lua_State* L) return warnArgumentValue(L, __func__, result.second); } - lua_pushfstring(L, pMudlet->mDiscord.getLargeImage(&host).toUtf8().constData()); + lua_pushstring(L, pMudlet->mDiscord.getLargeImage(&host).toUtf8().constData()); return 1; } @@ -148,7 +151,7 @@ int TLuaInterpreter::getDiscordLargeIconText(lua_State* L) return warnArgumentValue(L, __func__, result.second); } - lua_pushfstring(L, pMudlet->mDiscord.getLargeImageText(&host).toUtf8().constData()); + lua_pushstring(L, pMudlet->mDiscord.getLargeImageText(&host).toUtf8().constData()); return 1; } @@ -180,7 +183,7 @@ int TLuaInterpreter::getDiscordSmallIcon(lua_State* L) return warnArgumentValue(L, __func__, result.second); } - lua_pushfstring(L, pMudlet->mDiscord.getSmallImage(&host).toUtf8().constData()); + lua_pushstring(L, pMudlet->mDiscord.getSmallImage(&host).toUtf8().constData()); return 1; } @@ -195,7 +198,7 @@ int TLuaInterpreter::getDiscordSmallIconText(lua_State* L) return warnArgumentValue(L, __func__, result.second); } - lua_pushfstring(L, pMudlet->mDiscord.getSmallImageText(&host).toUtf8().constData()); + lua_pushstring(L, pMudlet->mDiscord.getSmallImageText(&host).toUtf8().constData()); return 1; } @@ -210,7 +213,7 @@ int TLuaInterpreter::getDiscordState(lua_State* L) return warnArgumentValue(L, __func__, result.second); } - lua_pushfstring(L, pMudlet->mDiscord.getStateText(&host).toUtf8().constData()); + lua_pushstring(L, pMudlet->mDiscord.getStateText(&host).toUtf8().constData()); return 1; } diff --git a/src/mudlet-lua/tests/Discord_spec.lua b/src/mudlet-lua/tests/Discord_spec.lua index e4d385b1d..db18cefea 100644 --- a/src/mudlet-lua/tests/Discord_spec.lua +++ b/src/mudlet-lua/tests/Discord_spec.lua @@ -344,9 +344,8 @@ describe("setDiscordDetail", function() if not readyForDiscord() then return end - -- What reaches Discord is fine; it is only the getter that mangles this, - -- which the pending spec at the end of this file covers. Reading it back - -- here would be the thing that misbehaves, so this one stops at the wire. + -- Only what reaches Discord is asserted on here; reading the same text back + -- is the other half, covered by the percent sequence specs below. local activity = activityFrom(function() setDiscordDetail("Level %d Mage") end, function(seen) return seen.details ~= nil end) assert.equals("Level %d Mage", activity.details) @@ -494,6 +493,68 @@ describe("setDiscordLargeIcon and setDiscordSmallIcon", function() end) end) +describe("presence text containing percent sequences", function() + -- The getters used to hand the stored text to lua_pushfstring() as its format + -- string, so every '%' in it was read as a printf specifier: "Level %d Mage" + -- came back with a garbage number where the %d was, and a "%s" dereferenced a + -- pointer that had never been passed. Presence text can arrive from the game + -- server over GMCP, so a status line with a stray percent sign in it was all + -- it took. All six getters are covered below rather than a sample of them, + -- so a seventh added the old way would be caught here too. + it("reports a detail text containing %d unchanged", function() + if not readyForDiscord() then + return + end + assert.is_true(setDiscordDetail("Level %d Mage")) + assert.equals("Level %d Mage", getDiscordDetail()) + end) + + it("reports a state text containing %s unchanged", function() + if not readyForDiscord() then + return + end + assert.is_true(setDiscordState("Wielding %s in the left hand")) + assert.equals("Wielding %s in the left hand", getDiscordState()) + end) + + it("reports an icon tooltip containing percent signs unchanged", function() + if not readyForDiscord() then + return + end + -- A doubled "%%" is the sequence the format-string path did not garble but + -- silently halved, and a bare "% " one it left alone - a caller could not + -- have escaped its way around either. + assert.is_true(setDiscordLargeIconText("100%% health, 50% mana")) + assert.equals("100%% health, 50% mana", getDiscordLargeIconText()) + end) + + it("reports a detail text ending in a percent sign unchanged", function() + if not readyForDiscord() then + return + end + -- The worst shape of the old bug rather than another spelling of the first + -- spec: on a trailing '%' the format-string path stepped one byte past the + -- terminator and scanned on, which ASan reports as a heap buffer overflow. + assert.is_true(setDiscordDetail("mana at 50%")) + assert.equals("mana at 50%", getDiscordDetail()) + end) + + it("reports the icon keys and the small icon tooltip unchanged", function() + if not readyForDiscord() then + return + end + -- The remaining three of the six getters. Icon keys come back lower-cased + -- because that is what Discord's asset names are, which is the only change + -- to them anyone should see. + assert.is_true(setDiscordLargeIcon("Level %d Mage")) + assert.equals("level %d mage", getDiscordLargeIcon()) + assert.is_true(setDiscordSmallIcon("Shield %s")) + assert.equals("shield %s", getDiscordSmallIcon()) + assert.is_true(setDiscordSmallIconText("100%% shielded, 50% rested")) + assert.equals("100%% shielded, 50% rested", getDiscordSmallIconText()) + end) +end) + describe("setDiscordElapsedStartTime and setDiscordRemainingEndTime", function() it("sends an elapsed start time and no end time", function() if not readyForDiscord() then @@ -751,14 +812,6 @@ describe("setDiscordApplicationID", function() end) describe("known Discord API defects", function() - it("returns a detail text containing a percent sequence unchanged", function() - pending("getDiscordDetail() and the other five Discord getters pass the stored text to " - .. "lua_pushfstring() as its format string, so a detail of 'Level %d Mage' comes back " - .. "with a garbage number in place of the %d and a '%s' would dereference a pointer " - .. "that was never passed - fix TLuaInterpreterDiscord.cpp to push the string as data, " - .. "then unpend this") - end) - it("truncates an overlong detail text on a character boundary", function() pending("localDiscordPresence cuts the text at 127 bytes without regard for UTF-8, so 64 " .. "two-byte characters reach Discord as 63 characters plus half of one - the frame is " From 7c49c94b11a5c0d9b0600f03df04dbb54e03f660 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Wed, 5 Aug 2026 06:50:01 +0200 Subject: [PATCH 089/155] fix: Mudlet freezing when a window is set to wrap too narrowly (#9623) #### Brief overview of PR changes/additions - line wrapping now always moves on: a width too narrow for a single glyph used to break the line at the character the scan was already on, looping forever on the main thread - `setWindowWrap()` refuses widths below 1 (the range Preferences offers) and answers `true` when it accepts one; Geyser's `setWrap()` passes a refusal on and its autoWrap never derives 0 columns - new `NarrowWindowWrapTest` (9 cases, 5 of them verified to hang without the fix) plus busted coverage of the Lua and Geyser contracts #### Motivation for adding to Mudlet `setWindowWrap(0)` froze Mudlet completely as soon as the next line was displayed, and so did an ordinary wrap width of 1 with East Asian text, or an indent that used the width up. #### Other info (issues closed, discussion etc) Fixes #9622 **Test case:** `lua setWindowWrap(0)` then `lua getWindowWrap()` - Mudlet used to freeze; now the first call reports "wrapAt must be greater than zero" and the client keeps running. Assisted-by: Claude:claude-opus-5 --- src/TBuffer.cpp | 18 +- src/TLuaInterpreterUI.cpp | 16 +- src/XMLimport.cpp | 4 +- src/mudlet-lua/lua/GUIUtils.lua | 1 + .../lua/geyser/GeyserMiniConsole.lua | 18 +- .../tests/GeyserMiniConsole_spec.lua | 20 + src/mudlet-lua/tests/UI_spec.lua | 10 + test/functional_tests/CMakeLists.txt | 4 + .../functional_tests/NarrowWindowWrapTest.cpp | 419 ++++++++++++++++++ 9 files changed, 495 insertions(+), 15 deletions(-) create mode 100644 test/functional_tests/NarrowWindowWrapTest.cpp diff --git a/src/TBuffer.cpp b/src/TBuffer.cpp index c25dbd8c2..2f19e9eb6 100644 --- a/src/TBuffer.cpp +++ b/src/TBuffer.cpp @@ -4987,7 +4987,7 @@ inline QList TBuffer::getWrapInfo(const QString& lineText, bool isNewl xPos = 0; continue; } - int nextBoundary = boundaryFinder.toNextBoundary(); + const int nextBoundary = boundaryFinder.toNextBoundary(); const QString grapheme = lineText.mid(indexOfChar, nextBoundary - indexOfChar); const uint unicode = graphemeInfo::getBaseCharacter(grapheme); // Safety check: during destruction, mpHost might be null @@ -5005,13 +5005,21 @@ inline QList TBuffer::getWrapInfo(const QString& lineText, bool isNewl const int firstNonIndentChar = firstChar + (needsIndent ? 0 : indentationHere); if (c == QChar::Space or lineBreakFinder.isAtBoundary() or lineBreakFinder.toPreviousBoundary() <= firstNonIndentChar) { boundaryFinder.setPosition(indexOfChar); - output.append(WrapInfo(isNewline, needsIndent, firstChar, indexOfChar)); } else { indexOfChar = lineBreakFinder.position(); - nextBoundary = lineBreakFinder.position(); - boundaryFinder.setPosition(nextBoundary); - output.append(WrapInfo(isNewline, needsIndent, firstChar, indexOfChar)); + boundaryFinder.setPosition(indexOfChar); } + if (indexOfChar <= firstChar) { + // no room for even one grapheme - either the wrap width is too + // narrow (or zero) or the indentation eats all of it. Breaking + // here would produce an empty segment and leave indexOfChar + // where it was, looping forever, so keep one grapheme on the + // line to guarantee the scan moves on + indexOfChar = (nextBoundary > firstChar) ? nextBoundary : firstChar + 1; + boundaryFinder.setPosition(indexOfChar); + totalWidth += charWidth; + } + output.append(WrapInfo(isNewline, needsIndent, firstChar, indexOfChar)); isNewline = false; needsIndent = true; xPos = 0; diff --git a/src/TLuaInterpreterUI.cpp b/src/TLuaInterpreterUI.cpp index ca75c686e..0f3e40f29 100644 --- a/src/TLuaInterpreterUI.cpp +++ b/src/TLuaInterpreterUI.cpp @@ -3746,10 +3746,17 @@ int TLuaInterpreter::setWindowWrap(lua_State* L) } const int luaFrom = getVerifiedInt(L, __func__, s, "wrapAt"); auto console = CONSOLE(L, QString{windowName}); + if (luaFrom < 1) { + // a width of zero or less cannot hold a single character, so nothing + // could be displayed in such a window - the preferences dialog does not + // offer these values either + return warnArgumentValue(L, __func__, qsl("wrapAt must be greater than zero, got %1").arg(luaFrom)); + } console->setWrapAt(luaFrom); - // only mirror values the preferences dialog itself accepts into the - // profile, otherwise an invalid width would reach NAWS and get saved - if (luaFrom >= 1 && console->getType() == TConsole::MainConsole) { + // only the main console's width belongs to the profile - it is what the + // preferences dialog shows, what NEW-ENVIRON reports as WORD_WRAP and what + // caps the width NAWS reports to the game + if (console->getType() == TConsole::MainConsole) { Host& host = getHostFromLua(L); const int priorWrapAt = host.mWrapAt; host.mWrapAt = luaFrom; @@ -3758,7 +3765,8 @@ int TLuaInterpreter::setWindowWrap(lua_State* L) } host.updateDisplayDimensions(); } - return 0; + lua_pushboolean(L, true); + return 1; } // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setWindowWrapIndent diff --git a/src/XMLimport.cpp b/src/XMLimport.cpp index 41b0d19ca..b2790d206 100644 --- a/src/XMLimport.cpp +++ b/src/XMLimport.cpp @@ -1138,7 +1138,9 @@ void XMLimport::readHost(Host* pHost) } else if (name() == qsl("commandLineMinimumHeight")) { pHost->commandLineMinimumHeight = readElementText().toInt(); } else if (name() == qsl("wrapAt")) { - pHost->mWrapAt = readElementText().toInt(); + // toInt() yields 0 for anything unparseable, and a profile that + // wraps at zero columns can show no text at all + pHost->mWrapAt = qMax(1, readElementText().toInt()); } else if (name() == qsl("wrapIndentCount")) { pHost->mWrapIndentCount = readElementText().toInt(); } else if (name() == qsl("wrapHangingIndentCount")) { diff --git a/src/mudlet-lua/lua/GUIUtils.lua b/src/mudlet-lua/lua/GUIUtils.lua index 4702cf990..dfcb33fbb 100644 --- a/src/mudlet-lua/lua/GUIUtils.lua +++ b/src/mudlet-lua/lua/GUIUtils.lua @@ -614,6 +614,7 @@ function createConsole(windowName, consoleName, fontSize, charsPerLine, numberOf assert(type(consoleName) == 'string', 'createConsole: invalid type for consoleName (expected string, got '..type(consoleName)..'!)') assert(type(fontSize) == 'number', 'createConsole: invalid type for fontSize (expected number, got '..type(fontSize)..'!)') assert(type(charsPerLine) == 'number', 'createConsole: invalid type for charsPerLine (expected number, got '..type(charsPerLine)..'!)') + assert(charsPerLine >= 1, 'createConsole: charsPerLine must be 1 or more, got '..charsPerLine..'!') assert(type(numberOfLines) == 'number', 'createConsole: invalid type for numberOfLines (expected number, got '..type(numberOfLines)..'!)') assert(type(Xpos) == 'number', 'createConsole: invalid type for Xpos (expected number, got '..type(Xpos)..'!)') assert(type(Ypos) == 'number', 'createConsole: invalid type for Ypos (expected number, got '..type(Ypos)..'!)') diff --git a/src/mudlet-lua/lua/geyser/GeyserMiniConsole.lua b/src/mudlet-lua/lua/geyser/GeyserMiniConsole.lua index f46ce4d51..0af4900cb 100644 --- a/src/mudlet-lua/lua/geyser/GeyserMiniConsole.lua +++ b/src/mudlet-lua/lua/geyser/GeyserMiniConsole.lua @@ -73,14 +73,20 @@ function Geyser.MiniConsole:getFont() end --- Sets the point at which text is wrapped in this miniconsole unless autoWrap is on --- @param wrapAt The number of characters to start wrapping. +-- @param wrapAt The number of characters to start wrapping. Must be 1 or more. +-- @return true, or nil and an error message if the wrap was not applied. function Geyser.MiniConsole:setWrap (wrapAt) if self.autoWrap then return nil, "autoWrap is enabled in this MiniConsole and that overrides manual wrapping" end - if wrapAt then - self.wrapAt = wrapAt + -- only record the new wrap once Mudlet has accepted it, or a refused width + -- would be re-sent (and refused again) by every later call + local newWrap = wrapAt or self.wrapAt + local ok, err = setWindowWrap(self.name, newWrap) + if not ok then + return nil, err end - setWindowWrap(self.name, self.wrapAt) + self.wrapAt = newWrap + return true end function Geyser.MiniConsole:resetFormat() @@ -431,7 +437,9 @@ function Geyser.MiniConsole:resetAutoWrap() if self.scrollBar then consoleWidth = consoleWidth - 15 end - local charactersWidth = math.floor(consoleWidth / fontWidth) + -- a console narrower than one character (or one the scroll bar leaves no + -- room in) works out as zero columns, which is not a width to wrap at + local charactersWidth = math.max(1, math.floor(consoleWidth / fontWidth)) self.wrapAt = charactersWidth setWindowWrap(self.name, self.wrapAt) diff --git a/src/mudlet-lua/tests/GeyserMiniConsole_spec.lua b/src/mudlet-lua/tests/GeyserMiniConsole_spec.lua index 4d4ad80a4..f3d7af4c7 100644 --- a/src/mudlet-lua/tests/GeyserMiniConsole_spec.lua +++ b/src/mudlet-lua/tests/GeyserMiniConsole_spec.lua @@ -130,6 +130,26 @@ describe("Tests functionality of Geyser.MiniConsole", function() assert.are.equal(17, getWindowWrap("gmcNoAutoWrap")) end) + -- a console too narrow for even one character works out as zero columns, + -- which Mudlet refuses (and which used to hang it, issue #9622) + it("never derives a wrap of less than one column", function() + local console = track(Geyser.MiniConsole:new({name = "gmcTinyAutoWrap", x = 0, y = 0, width = 4, height = 100, autoWrap = true})) + assert.are.equal(1, console.wrapAt) + assert.are.equal(1, getWindowWrap("gmcTinyAutoWrap")) + end) + + it("passes on a refused wrap width instead of recording it", function() + local console = track(Geyser.MiniConsole:new({name = "gmcZeroWrap", x = 0, y = 0, width = 300, height = 100})) + console:setWrap(30) + local result, message = console:setWrap(0) + assert.is_nil(result) + assert.is_truthy(message:find("greater than zero", 1, true)) + -- the refused width must not be remembered, or every later setWrap() + -- would re-send it and be refused as well + assert.are.equal(30, console.wrapAt) + assert.are.equal(30, getWindowWrap("gmcZeroWrap")) + end) + it("reports that resetAutoWrap has nothing to do when auto wrap is off", function() local console = track(Geyser.MiniConsole:new({name = "gmcResetWrap", x = 0, y = 0, width = 300, height = 100})) local result, message = console:resetAutoWrap() diff --git a/src/mudlet-lua/tests/UI_spec.lua b/src/mudlet-lua/tests/UI_spec.lua index 42c9af44a..a74f2afea 100644 --- a/src/mudlet-lua/tests/UI_spec.lua +++ b/src/mudlet-lua/tests/UI_spec.lua @@ -2325,7 +2325,17 @@ describe("Tests UI functions", function() end) it("setWindowWrap round-trips through getWindowWrap", function() + assert.is_true(setWindowWrap(win, 42)) + assert.are.equal(42, getWindowWrap(win)) + end) + + -- a window zero columns wide can show nothing, and used to hang Mudlet + -- as soon as the next line was displayed in it (issue #9622) + it("setWindowWrap refuses a wrap width below one and keeps the old width", function() setWindowWrap(win, 42) + local ok, err = setWindowWrap(win, 0) + assert.is_nil(ok) + assert.is_truthy(err:find("greater than zero", 1, true)) assert.are.equal(42, getWindowWrap(win)) end) diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index ab97cc0c7..457e697c7 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -35,6 +35,7 @@ set(FUNCTIONAL_TEST_SOURCES MapRoundTripTest.cpp MapProgressDialogSeamTest.cpp UndoServerWrapTest.cpp + NarrowWindowWrapTest.cpp HostWidgetDecouplingTest.cpp ActionSelfUninstallTest.cpp ProfileFolderNameTest.cpp @@ -136,6 +137,9 @@ set_tests_properties(ProfileRoundTripTest MapRoundTripTest MapProgressDialogSeam # HostWidgetDecouplingTest creates a fresh profile per test method, so it needs a longer timeout set_tests_properties(HostWidgetDecouplingTest PROPERTIES TIMEOUT 300) +# NarrowWindowWrapTest creates a fresh profile per test method, so it needs a longer timeout +set_tests_properties(NarrowWindowWrapTest PROPERTIES TIMEOUT 300) + # TDiscordModeTest drives the real discord-rpc library end-to-end. The library's # reconnect backoff is a process-global (60s ceiling) that the suite's # init/shutdown churn can inflate, so a fresh handshake can take a while (see diff --git a/test/functional_tests/NarrowWindowWrapTest.cpp b/test/functional_tests/NarrowWindowWrapTest.cpp new file mode 100644 index 000000000..d70ab334d --- /dev/null +++ b/test/functional_tests/NarrowWindowWrapTest.cpp @@ -0,0 +1,419 @@ +/*************************************************************************** + * Copyright (C) 2026 by Mudlet Makers * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +#include + +#include +#include +#include + +#include "Host.h" +#include "MudletInstanceCoordinator.h" +#include "TLuaInterpreter.h" +#include "TMainConsole.h" +#include "TelnetServerStub.h" +#include "ctelnet.h" +#include "dlgConnectionProfiles.h" +#include "mudlet.h" + +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); +void initializeQRCResources(); + +// A wrap width that cannot hold a single glyph - because it is zero, because +// the glyph is wider than the width, or because the indentation uses the width +// up - made TBuffer::getWrapInfo() break the line at the character it was +// already sitting on, so the scan never advanced and Mudlet hung (#9622). +// Every step that can reach the wrapping therefore runs under a watchdog: a +// regression is an endless loop on the main thread, so no assertion after it +// would ever be reached. +class NarrowWindowWrapTest : public QObject +{ + Q_OBJECT + +private: + TelnetServerStub* mpServer = nullptr; + const QString mHostname = "Test-NarrowWrap"; + QString mPort; // assigned the stub's actual loopback port in init() + const QString mLocalhost = "localhost"; + const QString mMiniConsole = "wrapTest"; + // U+6F22 U+5B57 - East Asian Wide, so two columns are needed per glyph + const QString mWideText = QString(QChar(0x6F22)) + QChar(0x5B57); + +private slots: + void initTestCase() { initializeQRCResources(); } + + void init() + { + mpServer = new TelnetServerStub(qApp); + // Port 0 asks the OS for an ephemeral port so parallel test runs do + // not collide on a hardcoded one + mpServer->start(mLocalhost, 0); + QVERIFY2(mpServer->isListening(), "TelnetServerStub failed to bind a loopback port"); + mPort = QString::number(mpServer->serverPort()); + mudlet::start(); + mudlet::self()->setupConfig(); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique("MudletInstanceCoordinator")); + mudlet::self()->init(); + mudlet::self()->setStorePasswordsSecurely(false); + deleteProfileDirectory(mHostname); + } + + // The report from #9622, at the level the Lua API no longer allows: + // TConsole::setWrapAt() is still reachable from C++, so the wrapping itself + // has to cope with a width of zero instead of spinning forever. + void test_zeroWrapWidthDoesNotHang() + { + startProfile(); + auto* console = createTestMiniConsole(); + QVERIFY(console); + console->setWrapAt(0); + + runWithWatchdog("echo at a wrap width of zero", [this]() { + runLua(qsl("echo('%1', 'abcdef\\n')").arg(mMiniConsole)); + }); + + // no width can hold a character, so every character ends up on a line + // of its own - and not one of them may be dropped or duplicated + QCOMPARE(nonEmptyLineCount(console), 6); + QCOMPARE(joinedText(console), qsl("abcdef")); + } + + // Newlines inside the echoed text take their own path through the wrapping + // scan, which has to keep its bookkeeping straight alongside the forced + // per-glyph breaks. + void test_embeddedNewlinesAtZeroWrapWidthDoNotHang() + { + startProfile(); + auto* console = createTestMiniConsole(); + QVERIFY(console); + console->setWrapAt(0); + + runWithWatchdog("echo of embedded newlines at a wrap width of zero", [this]() { + runLua(qsl("echo('%1', 'ab\\ncd\\n')").arg(mMiniConsole)); + }); + + QCOMPARE(joinedText(console), qsl("abcd")); + } + + // A width of one column with two-column glyphs is the same dead end, and + // unlike a width of zero it is a perfectly ordinary thing to ask for. + void test_wrapWidthNarrowerThanTheGlyphDoesNotHang() + { + startProfile(); + auto* console = createTestMiniConsole(); + QVERIFY(console); + runLua(qsl("setWindowWrap('%1', 1)").arg(mMiniConsole)); + + runWithWatchdog("echo of a wide glyph at a wrap width of one", [this]() { + runLua(qsl("echo('%1', '%2\\n')").arg(mMiniConsole, mWideText)); + }); + + QCOMPARE(nonEmptyLineCount(console), 2); + QCOMPARE(joinedText(console), mWideText); + } + + // Indentation is subtracted from the wrap width, so a legal width and a + // legal indent together can still leave less room than one glyph needs. + void test_indentEatingTheWrapWidthDoesNotHang() + { + startProfile(); + auto* console = createTestMiniConsole(); + QVERIFY(console); + runLua(qsl("setWindowWrap('%1', 5)").arg(mMiniConsole)); + // both, so that whichever of the two a line uses leaves a single column + runLua(qsl("setWindowWrapIndent('%1', 4)").arg(mMiniConsole)); + runLua(qsl("setWindowWrapHangingIndent('%1', 4)").arg(mMiniConsole)); + + runWithWatchdog("echo of a wide glyph with the indent using up the wrap width", [this]() { + runLua(qsl("echo('%1', '%2\\n')").arg(mMiniConsole, mWideText)); + }); + + QCOMPARE(textIgnoringIndentation(console), mWideText); + } + + // An indent at or beyond the wrap width is not range-checked anywhere. + // wrapLine() drops such an indent instead of leaving no room at all, and + // that is what keeps this case out of the trap the one above falls into. + void test_indentWiderThanTheWrapWidthDoesNotHang() + { + startProfile(); + auto* console = createTestMiniConsole(); + QVERIFY(console); + runLua(qsl("setWindowWrap('%1', 5)").arg(mMiniConsole)); + runLua(qsl("setWindowWrapIndent('%1', 10)").arg(mMiniConsole)); + runLua(qsl("setWindowWrapHangingIndent('%1', 10)").arg(mMiniConsole)); + + runWithWatchdog("echo with an indent wider than the wrap width", [this]() { + runLua(qsl("echo('%1', '%2%2\\n')").arg(mMiniConsole, mWideText)); + }); + + QCOMPARE(textIgnoringIndentation(console), mWideText + mWideText); + } + + // insertText() wraps against the screen width and the profile's own indent + // rather than the console's, so it reaches the wrapping by a different + // route than echo() does. + void test_insertTextIntoTheMainConsoleDoesNotHang() + { + mpServer->setWelcomeMessage(qsl("HELLO\r\n")); + startProfile(); + auto* host = mudlet::self()->getActiveHost(); + QVERIFY2(waitForMainConsoleText(qsl("HELLO")), "Welcome text never reached the buffer"); + + // leave a single column free of the screen width the insert wraps at - + // both indents, since only the first segment of a line uses the plain + // one and every segment after it uses the hanging one + const int indent = host->mScreenWidth - 1; + QVERIFY2(indent > 1, "the main console reported no usable screen width"); + runLua(qsl("setWindowWrapIndent('main', %1)").arg(indent)); + runLua(qsl("setWindowWrapHangingIndent('main', %1)").arg(indent)); + + // mid-line, so the insert goes through insertInLine() rather than the + // append path the cursor at the end of the buffer would take + const int welcomeLine = mainConsoleLineOf(qsl("HELLO")); + QVERIFY2(welcomeLine >= 0, "the welcome line went missing from the buffer"); + QVERIFY2(host->mpConsole->moveCursor(2, welcomeLine), "could not position the user cursor mid-line"); + + runWithWatchdog("insertText of a wide glyph with the indent using up the screen width", [this, host]() { + // the newline is what makes the insert re-wrap the line it landed in + host->mpConsole->insertText(mWideText + QChar::LineFeed + mWideText); + }); + + QVERIFY2(mainConsoleContains(mWideText), "the inserted text did not survive wrapping"); + } + + // Nothing can be shown in a window that is zero columns wide, so the Lua + // API turns such a width away rather than let it reach the wrapping. + void test_setWindowWrapRejectsWidthsBelowOne() + { + startProfile(); + auto* console = createTestMiniConsole(); + QVERIFY(console); + // wide enough that the reported result is not itself wrapped + runLua(qsl("setWindowWrap('%1', 200)").arg(mMiniConsole)); + + // under the watchdog as well: were the width to be accepted, the echo + // reporting the result would be the thing that hangs + runWithWatchdog("setWindowWrap() with a width of zero", [this]() { + runLua(qsl("local ok, err = setWindowWrap('%1', 0) echo('%1', 'RESULT:'..tostring(ok)..':'..tostring(err))").arg(mMiniConsole)); + }); + + const QString result = joinedText(console); + QVERIFY2(result.startsWith(qsl("RESULT:nil:")), qPrintable(qsl("setWindowWrap() did not refuse a wrap width of zero, it returned: %1").arg(result))); + QVERIFY2(result.contains(qsl("greater than zero")), qPrintable(qsl("the refusal did not say why: %1").arg(result))); + // the rejected call must not have changed the width either + QCOMPARE(console->getWrapAt(), 200); + } + + // An accepted width answers true, so that the usual `if not ok then` check + // does not read every successful call as a failure. + void test_setWindowWrapReportsSuccess() + { + startProfile(); + auto* console = createTestMiniConsole(); + QVERIFY(console); + + runLua(qsl("local ok = setWindowWrap('%1', 200) echo('%1', 'RESULT:'..tostring(ok))").arg(mMiniConsole)); + + QCOMPARE(joinedText(console), qsl("RESULT:true")); + QCOMPARE(console->getWrapAt(), 200); + } + + // The main console's width is mirrored into the profile and reported to the + // game, so a refused width must not reach either. + void test_rejectedMainConsoleWidthLeavesTheProfileUntouched() + { + startProfile(); + auto* host = mudlet::self()->getActiveHost(); + runLua(qsl("setWindowWrap(80)")); + QCOMPARE(host->mWrapAt, 80); + + runWithWatchdog("setWindowWrap() with a width of zero on the main console", [this]() { + runLua(qsl("setWindowWrap(0)")); + }); + + QCOMPARE(host->mWrapAt, 80); + QCOMPARE(host->mpConsole->getWrapAt(), 80); + } + + void cleanup() + { + const QString profilePath = mudlet::getMudletPath(enums::profileHomePath, mHostname); + + // Tear down Mudlet (and with it the live cTelnet connection) before the + // stub server it is talking to, so the socket is closed from the client + // side rather than being yanked out from under an active connection. + delete mudlet::self(); + delete mpServer; + mpServer = nullptr; + deleteDirectory(profilePath); + } + +private: + // Runs work on the main thread with a hard deadline: should the wrapping + // regress into an endless loop, kill the test process with a useful message + // rather than leave the whole ctest run to sit until its own timeout. + void runWithWatchdog(const char* what, const std::function& work, int timeoutSeconds = 10) + { + std::atomic_bool finished{false}; + std::thread watchdog([&finished, what, timeoutSeconds]() { + for (int i = 0; i < timeoutSeconds * 10 && !finished.load(); ++i) { + QThread::msleep(100); + } + if (!finished.load()) { + qFatal("%s did not finish within %d seconds - the wrapping is stuck in a loop", what, timeoutSeconds); + } + }); + work(); + finished.store(true); + watchdog.join(); + } + + void runLua(const QString& script) + { + auto host = mudlet::self()->getActiveHost(); + host->getLuaInterpreter()->compileAndExecuteScript(script); + } + + // a miniconsole keeps the assertions free of the main console's connection + // messages, and wraps its text through exactly the same code + TConsole* createTestMiniConsole() + { + runLua(qsl("createMiniConsole('%1', 0, 0, 300, 300)").arg(mMiniConsole)); + return mudlet::self()->getActiveHost()->mpConsole->mSubConsoleMap.value(mMiniConsole); + } + + void startProfile() + { + QTimer::singleShot(0, qApp, [this]() { + mudlet::self()->startAutoLogin({}); + QTest::qWait(100); + QTest::mouseClick(mudlet::self()->mpConnectionDialog->new_profile_button, Qt::LeftButton); + QTest::qWait(100); + QTest::keyClicks(QApplication::focusWidget(), mHostname); + QTest::qWait(100); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100); + QTest::keyClicks(QApplication::focusWidget(), mLocalhost); + QTest::qWait(100); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100); + QTest::keyClicks(QApplication::focusWidget(), mPort); + QTest::qWait(100); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Return); + }); + + QSignalSpy spy(mudlet::self(), &mudlet::signal_profileLoaded); + if (!spy.wait(5000)) { + QFAIL("Profile took too long to load."); + } + auto host = mudlet::self()->getActiveHost(); + if (!host) { + QFAIL("No active host available for the test."); + } + + QSignalSpy connectedSpy(&(host->mTelnet), &cTelnet::signal_connected); + if (!connectedSpy.wait(2000)) { + QFAIL("Could not connect with the host."); + } + } + + // the buffer carries empty lines of its own (one is always kept ready for + // the next text), so only the lines with something in them are counted + static int nonEmptyLineCount(TConsole* console) + { + int count = 0; + for (int i = 0, total = console->buffer.getLastLineNumber(); i <= total; ++i) { + if (!console->buffer.line(i).isEmpty()) { + ++count; + } + } + return count; + } + + // every line of the console joined back together - the wrapping only breaks + // lines, so this has to come back out exactly as it went in + static QString joinedText(TConsole* console) + { + QString text; + for (int i = 0, total = console->buffer.getLastLineNumber(); i <= total; ++i) { + text.append(console->buffer.line(i)); + } + return text; + } + + // as joinedText(), but with every space dropped, for the cases where the + // wrapping pads lines out with indentation. Spaces in the text itself are + // lost along with it, so these cases echo text that has none. + static QString textIgnoringIndentation(TConsole* console) { return joinedText(console).remove(QChar::Space); } + + static int mainConsoleLineOf(const QString& text) + { + auto console = mudlet::self()->getActiveHost()->mpConsole; + for (int i = 0, total = console->buffer.getLastLineNumber(); i <= total; ++i) { + if (console->buffer.line(i).contains(text)) { + return i; + } + } + return -1; + } + + static bool mainConsoleContains(const QString& text) { return mainConsoleLineOf(text) >= 0; } + + bool waitForMainConsoleText(const QString& text, int timeoutMs = 5000) + { + return QTest::qWaitFor( + [this, &text]() { + return mainConsoleContains(text); + }, + timeoutMs); + } + + void deleteProfileDirectory(const QString& profileName) { deleteDirectory(mudlet::getMudletPath(enums::profileHomePath, profileName)); } + + void deleteDirectory(const QString& path) + { + QDir dir(path); + if (dir.exists()) { + dir.removeRecursively(); + } + } +}; + +void initializeQRCResources() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +#include "NarrowWindowWrapTest.moc" +QTEST_MAIN(NarrowWindowWrapTest) From e91b8596fd1b862f7e4d9a0079a0b1bc086a40fd Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Wed, 5 Aug 2026 06:50:27 +0200 Subject: [PATCH 090/155] infrastructure: MMCP effect specs against a scripted chat peer (#9629) #### Brief overview of PR changes/additions - Adds `CI/mmcp-peer.py`, a scripted MMCP chat peer: it accepts the call `mmcp.call()` places, completes the MudMaster handshake, records every protocol command Mudlet sends and sends chat traffic back when a spec asks it to. Its ports are ephemeral and reach Mudlet through `MUDLET_TEST_MMCP_DIR`, so parallel CI jobs and worktrees cannot collide on MMCP's default 4050. - Adds 45 MMCP effect specs to `Networking_spec.lua` covering 18 of the 25 `mmcp.*` entry points, in both directions: the bytes Mudlet puts on the wire (chat, personal chat, emote, group, side channel, snoop, ping, name change, per-peer flags) and what it does with what arrives (`sysMMCPChatMessage`, `sysMMCPSideChannelMessage`, `sysMMCPIncomingSnoopMessage`, snoop permission gating, connection lists it is asked to dial, commands split across reads or batched into one, ignore, rename, disconnect). - Starts the peer in the Linux/macOS Lua test steps of both build workflows, mirroring the HTTP fixture immediately above it, with a `MUDLET_TEST_REQUIRE_MMCP_PEER` gate so a fixture that fails to start fails CI instead of quietly pending. #### Motivation for adding to Mudlet The `mmcp.*` family had no effect coverage at all: its behaviour only exists once a peer is on the other end of a socket, so the existing specs could only check the offline nil+message contracts. Nothing would have caught a change to what Mudlet actually sends, or to how it handles what it is sent. **Test case:** 1890 successes / 0 failures / 1 pending with the peer (green twice), 1846 / 0 / 45 pending without it; 11 sabotages of the MMCP C++ (chat payloads, group field width, flag order, ping reply, side channel separator and regex, snoop request, unchanged-name short circuit, partial-command buffering) failed 14 specs and nothing else. #### Other info (issues closed, discussion etc) The other 7 entry points cannot be reached at all: `mmcp.accept`, `mmcp.deny`, `setDoNotDisturb`, `startServer`, `stopServer`, `request` and `peek` have their registration into the Lua `mmcp` table commented out in `TLuaInterpreter.cpp`. Without `startServer` Mudlet cannot listen either, so no incoming call can be staged. That is left as a pending spec rather than worked around - worth a look on its own, since Mudlet's pending-call message tells the user to run `mmcp.accept(id)`, which today does not exist. The peer holds one call at a time, so effects that need two connected peers (`setPrivate`'s filtering, `serve`'s forwarding, a non-empty peek list) are still uncovered. Windows runs the Lua suite but starts fixtures inside the test shell rather than in a step of their own, so the block pends there by design. Assisted-by: Claude:claude-opus-5 --- .github/workflows/build-mudlet-pr.yml | 28 + .github/workflows/build-mudlet.yml | 28 + CI/mmcp-peer.py | 387 ++++++++++ src/mudlet-lua/tests/Networking_spec.lua | 907 ++++++++++++++++++++++- 4 files changed, 1345 insertions(+), 5 deletions(-) create mode 100644 CI/mmcp-peer.py diff --git a/.github/workflows/build-mudlet-pr.yml b/.github/workflows/build-mudlet-pr.yml index 9fb032592..d0c46b570 100644 --- a/.github/workflows/build-mudlet-pr.yml +++ b/.github/workflows/build-mudlet-pr.yml @@ -554,6 +554,32 @@ jobs: echo "MUDLET_TEST_DISCORD_LIB_PATH=${{github.workspace}}/3rdparty/discord/rpc/lib${LD_LIBRARY_PATH:+:${LD_LIBRARY_PATH}}" >> "${GITHUB_ENV}" echo "fake Discord IPC server ready in ${runtime_dir}" + - name: (Linux/macOS) Start MMCP peer fixture for Lua tests + if: matrix.run_tests == 'true' + shell: bash + run: | + peer_dir="${{runner.temp}}/mudlet-mmcp-peer" + rm -rf "${peer_dir}" + mkdir -p "${peer_dir}" + MUDLET_TEST_MMCP_DIR="${peer_dir}" nohup python3 "${{github.workspace}}/CI/mmcp-peer.py" > "${{runner.temp}}/mmcp-peer.log" 2>&1 & + for _ in $(seq 1 50); do + [ -s "${peer_dir}/port" ] && break + sleep 0.1 + done + if [ ! -s "${peer_dir}/port" ]; then + echo "MMCP peer fixture failed to start" >&2 + cat "${{runner.temp}}/mmcp-peer.log" 2>/dev/null || true + exit 1 + fi + port="$(cat "${peer_dir}/port")" + if ! python3 -c "import socket, sys; socket.create_connection(('127.0.0.1', int(sys.argv[1])), 5).close()" "${port}"; then + echo "MMCP peer fixture is not accepting connections" >&2 + cat "${{runner.temp}}/mmcp-peer.log" 2>/dev/null || true + exit 1 + fi + echo "MUDLET_TEST_MMCP_DIR=${peer_dir}" >> "${GITHUB_ENV}" + echo "MMCP peer fixture ready on 127.0.0.1:$(cat "${peer_dir}/port")" + - name: (Linux) Run Lua tests if: matrix.run_tests == 'true' && runner.os == 'Linux' # Longer than the other platforms': this leg also drives the real @@ -565,6 +591,7 @@ jobs: MUDLET_TEST_MODE: 1 MUDLET_TEST_REQUIRE_TTS_MOCK: 1 MUDLET_TEST_REQUIRE_HTTP_FIXTURE: 1 + MUDLET_TEST_REQUIRE_MMCP_PEER: 1 # Qt Multimedia runs a player here even without an audio device, so a # media effect spec that cannot play is a regression rather than an # environment quirk. macOS runners start no player at all, so the gate @@ -597,6 +624,7 @@ jobs: MUDLET_TEST_MODE: 1 MUDLET_TEST_REQUIRE_TTS_MOCK: 1 MUDLET_TEST_REQUIRE_HTTP_FIXTURE: 1 + MUDLET_TEST_REQUIRE_MMCP_PEER: 1 # No MUDLET_TEST_REQUIRE_MEDIA: Qt Multimedia starts no player on the # macOS runners, so the media effect specs pend here by design. TESTS_DIRECTORY: ${{github.workspace}}/src/mudlet-lua/tests diff --git a/.github/workflows/build-mudlet.yml b/.github/workflows/build-mudlet.yml index 4825bfcba..7301071b4 100644 --- a/.github/workflows/build-mudlet.yml +++ b/.github/workflows/build-mudlet.yml @@ -565,6 +565,32 @@ jobs: echo "MUDLET_TEST_DISCORD_LIB_PATH=${{github.workspace}}/3rdparty/discord/rpc/lib${LD_LIBRARY_PATH:+:${LD_LIBRARY_PATH}}" >> "${GITHUB_ENV}" echo "fake Discord IPC server ready in ${runtime_dir}" + - name: (Linux/macOS) Start MMCP peer fixture for Lua tests + if: matrix.run_tests == 'true' + shell: bash + run: | + peer_dir="${{runner.temp}}/mudlet-mmcp-peer" + rm -rf "${peer_dir}" + mkdir -p "${peer_dir}" + MUDLET_TEST_MMCP_DIR="${peer_dir}" nohup python3 "${{github.workspace}}/CI/mmcp-peer.py" > "${{runner.temp}}/mmcp-peer.log" 2>&1 & + for _ in $(seq 1 50); do + [ -s "${peer_dir}/port" ] && break + sleep 0.1 + done + if [ ! -s "${peer_dir}/port" ]; then + echo "MMCP peer fixture failed to start" >&2 + cat "${{runner.temp}}/mmcp-peer.log" 2>/dev/null || true + exit 1 + fi + port="$(cat "${peer_dir}/port")" + if ! python3 -c "import socket, sys; socket.create_connection(('127.0.0.1', int(sys.argv[1])), 5).close()" "${port}"; then + echo "MMCP peer fixture is not accepting connections" >&2 + cat "${{runner.temp}}/mmcp-peer.log" 2>/dev/null || true + exit 1 + fi + echo "MUDLET_TEST_MMCP_DIR=${peer_dir}" >> "${GITHUB_ENV}" + echo "MMCP peer fixture ready on 127.0.0.1:$(cat "${peer_dir}/port")" + - name: (Linux) Run Lua tests if: matrix.run_tests == 'true' && runner.os == 'Linux' # Longer than the other platforms': this leg also drives the real @@ -576,6 +602,7 @@ jobs: MUDLET_TEST_MODE: 1 MUDLET_TEST_REQUIRE_TTS_MOCK: 1 MUDLET_TEST_REQUIRE_HTTP_FIXTURE: 1 + MUDLET_TEST_REQUIRE_MMCP_PEER: 1 # Qt Multimedia runs a player here even without an audio device, so a # media effect spec that cannot play is a regression rather than an # environment quirk. macOS runners start no player at all, so the gate @@ -608,6 +635,7 @@ jobs: MUDLET_TEST_MODE: 1 MUDLET_TEST_REQUIRE_TTS_MOCK: 1 MUDLET_TEST_REQUIRE_HTTP_FIXTURE: 1 + MUDLET_TEST_REQUIRE_MMCP_PEER: 1 # No MUDLET_TEST_REQUIRE_MEDIA: Qt Multimedia starts no player on the # macOS runners, so the media effect specs pend here by design. TESTS_DIRECTORY: ${{github.workspace}}/src/mudlet-lua/tests diff --git a/CI/mmcp-peer.py b/CI/mmcp-peer.py new file mode 100644 index 000000000..43c9773d2 --- /dev/null +++ b/CI/mmcp-peer.py @@ -0,0 +1,387 @@ +#!/usr/bin/env python3 +"""Scripted MMCP chat peer for Mudlet's busted networking specs. + +Mudlet's mmcp.* Lua API only has observable effects when a chat peer is on the +other end of a socket, so the specs need a real peer rather than a mock. This is +that peer: it accepts the call Mudlet places with mmcp.call(), completes the +MudMaster handshake, records every protocol command Mudlet sends, and sends +commands back when the specs ask it to. + +It lives in its own file rather than inside http-fixture-server.py because the +two share nothing: that one is a stock static file server, this one is a +stateful binary protocol peer. A single process would also mean one fixture +failing takes the other down with it. + +Three channels, all inside the directory named by ``MUDLET_TEST_MMCP_DIR`` (one +environment variable, read by both this process and Mudlet): + + port the OS-assigned listening port, written once the socket is + accepting. Ephemeral rather than MMCP's default 4050: CI jobs + and parallel local worktrees would collide on a fixed port. + capture.json everything this peer has seen, rewritten atomically after every + change so a reader never gets a torn file. + commands/ one JSON file per instruction from the specs, picked up in + numeric order and deleted once carried out. + +Only one call is held at a time: a new one replaces the old. Effects that need +two peers at once (mmcp.setPrivate's filtering, mmcp.serve's forwarding, a +non-empty connection or peek list) are out of reach until this grows a second +listening port. + +Wire format, from src/MMCP.h and src/MMCPClient.cpp: + + Mudlet -> peer on connect: "CHAT:\\n
" + peer -> Mudlet, accepting: "YES:\\n" (or "NO:\\n" to refuse) + either direction after: <0xff> +""" + +import json +import os +import selectors +import socket +import sys + +# Command bytes, from the MMCPChatCommand enum in src/MMCP.h. Commands not +# listed here are still recorded, by their numeric code. +COMMAND_NAMES = { + 1: "NameChange", + 2: "RequestConnections", + 3: "ConnectionList", + 4: "TextEveryone", + 5: "TextPersonal", + 6: "TextGroup", + 7: "Message", + 8: "DoNotDisturb", + 19: "Version", + 26: "PingRequest", + 27: "PingResponse", + 28: "PeekConnections", + 29: "PeekList", + 30: "Snoop", + 31: "SnoopData", + 32: "SnoopColor", + 40: "SideChannel", +} + +END = 0xFF +PING_REQUEST = 26 +PING_RESPONSE = 27 +VERSION = 19 + +# Mudlet only sends side channel data to peers whose version string says they +# are Mudlet (MMCPServer::sendSideChannel), so claim to be one. +PEER_VERSION = "Mudlet 0.0.0-busted-peer" +PEER_NAME = "BustedPeer" + +# Enough history for a spec to look back over a few steps without the capture +# file growing without bound over a whole suite run. +MAX_EVENTS = 200 +POLL_SECONDS = 0.01 + + +class MMCPPeer: + def __init__(self, directory): + self.directory = directory + self.commands_dir = os.path.join(directory, "commands") + self.capture_path = os.path.join(directory, "capture.json") + self.port_path = os.path.join(directory, "port") + + self.events = [] + self.seq = 0 + self.connections = 0 + self.caller = None + self.name = PEER_NAME + self.version = PEER_VERSION + self.accept_calls = True + + self.selector = selectors.DefaultSelector() + self.connection = None + self.state = "idle" + self.buffer = bytearray() + + self.listener = self.listen() + self.port = self.listener.getsockname()[1] + # A second address that only ever records who dialled it and hangs up. + # It is how a spec sees that Mudlet acted on an address a peer handed it + # (a connection list), which is otherwise reported to the console alone. + self.sink = self.listen() + self.dial_port = self.sink.getsockname()[1] + + @staticmethod + def listen(): + server = socket.socket(socket.AF_INET, socket.SOCK_STREAM) + server.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1) + server.bind(("127.0.0.1", 0)) + server.listen(4) + server.setblocking(False) + return server + + # -- capture ------------------------------------------------------------ + + def record(self, event): + self.seq += 1 + event["seq"] = self.seq + self.events.append(event) + del self.events[:-MAX_EVENTS] + self.write_capture() + + def write_capture(self): + payload = { + "seq": self.seq, + "port": self.port, + "dial_port": self.dial_port, + "connections": self.connections, + "connected": self.connection is not None, + "accepting": self.accept_calls, + "name": self.name, + "version": self.version, + "caller": self.caller, + "events": self.events, + } + # Write then rename so a spec reading mid-update sees the old file + # rather than half of the new one. + tmp_path = self.capture_path + ".tmp" + with open(tmp_path, "w", encoding="utf-8") as handle: + json.dump(payload, handle) + os.replace(tmp_path, self.capture_path) + + # -- connection --------------------------------------------------------- + + def accept(self): + connection, address = self.listener.accept() + connection.setblocking(False) + connection.setsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1) + if self.connection is not None: + # Only one call at a time: an earlier caller that never went away + # would otherwise keep receiving what the specs meant for this one. + self.close_connection("replaced by a new call") + self.connection = connection + self.selector.register(connection, selectors.EVENT_READ) + self.state = "handshake" + self.buffer.clear() + self.caller = None + self.connections += 1 + self.record({"type": "connect", "from": "%s:%d" % address}) + + def accept_sink(self): + connection, address = self.sink.accept() + connection.close() + self.record({"type": "dialled", "from": "%s:%d" % address}) + + def close_connection(self, reason): + if self.connection is None: + return + try: + self.selector.unregister(self.connection) + except (KeyError, ValueError): + pass + try: + self.connection.close() + except OSError: + pass + self.connection = None + self.state = "idle" + self.buffer.clear() + self.record({"type": "disconnect", "reason": reason}) + + def send(self, data): + if self.connection is None: + self.record({"type": "send_failed", "reason": "no connection"}) + return False + try: + self.connection.sendall(data) + except OSError as error: + self.record({"type": "send_failed", "reason": str(error)}) + return False + return True + + def send_command(self, code, payload): + return self.send(bytes([code]) + payload + bytes([END])) + + def read(self): + try: + chunk = self.connection.recv(4096) + except BlockingIOError: + # BlockingIOError is an OSError, so it has to be let through before + # the catch-all below turns a socket error into an end of call. + return + except OSError: + chunk = b"" + if not chunk: + self.close_connection("closed by Mudlet") + return + self.buffer.extend(chunk) + if self.state == "handshake": + self.handle_handshake() + if self.state == "connected": + self.handle_commands() + + def handle_handshake(self): + newline = self.buffer.find(b"\n") + if newline == -1: + return + if not self.buffer.startswith(b"CHAT:"): + self.record({"type": "bad_handshake", "raw": self.buffer.decode("latin-1")}) + self.close_connection("handshake did not start with CHAT:") + return + # The address and port that follow the newline have no terminator of + # their own; Mudlet writes them in the same call as the name and parses + # an incoming call the same way, taking the last 5 bytes as the port. + rest = bytes(self.buffer[newline + 1:]) + if len(rest) < 5: + return + + caller_name = bytes(self.buffer[5:newline]).decode("latin-1") + raw = bytes(self.buffer).decode("latin-1") + self.buffer.clear() + self.caller = { + "name": caller_name, + "address": rest[:-5].decode("latin-1"), + "port": rest[-5:].decode("latin-1").strip(), + "raw": raw, + } + self.record({"type": "handshake", "caller": self.caller}) + + if not self.accept_calls: + self.send(("NO:%s\n" % self.name).encode("latin-1")) + self.close_connection("call refused") + return + + self.state = "connected" + # One write: Mudlet reads whatever has arrived when it handles the + # acceptance, and only understands a command tacked onto the end of it + # if the command is complete. + self.send(("YES:%s\n" % self.name).encode("latin-1") + + bytes([VERSION]) + self.version.encode("latin-1") + bytes([END])) + + def handle_commands(self): + while True: + end = self.buffer.find(bytes([END])) + if end == -1: + return + code = self.buffer[0] + payload = bytes(self.buffer[1:end]) + del self.buffer[:end + 1] + self.on_command(code, payload) + + def on_command(self, code, payload): + self.record({ + "type": "command", + "code": code, + "name": COMMAND_NAMES.get(code, "Unknown"), + "text": payload.decode("latin-1"), + "hex": payload.hex(), + }) + if code == PING_REQUEST: + # What a real peer does, and what lets a spec watch a full ping + # round trip rather than only the outgoing half. + self.send_command(PING_RESPONSE, payload) + + # -- commands from the specs ------------------------------------------- + + def poll_commands(self): + try: + names = os.listdir(self.commands_dir) + except OSError: + return + queued = [] + for name in names: + stem, extension = os.path.splitext(name) + # Specs write ".json.tmp" and rename it into place, so a partly + # written command is never picked up. + if extension == ".json" and stem.isdigit(): + queued.append((int(stem), name)) + for _, name in sorted(queued): + path = os.path.join(self.commands_dir, name) + try: + with open(path, encoding="utf-8") as handle: + command = json.load(handle) + except (OSError, ValueError) as error: + command = None + self.record({"type": "command_error", "file": name, "error": str(error)}) + try: + os.remove(path) + except OSError: + pass + if command is not None: + self.run_command(command) + + def run_command(self, command): + try: + self.dispatch_command(command) + except (OSError, TypeError, ValueError) as error: + # A malformed command is one spec's problem. Dying over it would + # leave every later spec waiting on a peer that is no longer there. + self.record({"type": "command_error", "error": str(error)}) + + def dispatch_command(self, command): + action = command.get("action") + if action == "send": + text = command.get("text", "") + self.send_command(int(command.get("code", 0)), text.encode("latin-1", "replace")) + elif action == "send_hex": + self.send(bytes.fromhex(command.get("hex", ""))) + elif action == "close": + self.close_connection("closed on request") + elif action == "accept": + self.accept_calls = bool(command.get("accept", True)) + else: + self.record({"type": "command_error", "error": "unknown action: %r" % (action,)}) + return + self.record({"type": "command_done", "action": action}) + + # -- main loop ---------------------------------------------------------- + + def run(self): + os.makedirs(self.commands_dir, exist_ok=True) + self.selector.register(self.listener, selectors.EVENT_READ) + self.selector.register(self.sink, selectors.EVENT_READ) + self.write_capture() + self.write_port() + print("MMCP peer '%s' listening on 127.0.0.1:%d, sink on %d" + % (self.name, self.port, self.dial_port), flush=True) + while True: + for key, _ in self.selector.select(POLL_SECONDS): + if key.fileobj is self.listener: + self.accept() + elif key.fileobj is self.sink: + self.accept_sink() + elif key.fileobj is self.connection: + self.read() + self.poll_commands() + + def write_port(self): + # Written last, and atomically, so its presence means the peer is + # already accepting connections. + tmp_path = self.port_path + ".tmp" + with open(tmp_path, "w", encoding="utf-8") as handle: + handle.write(str(self.port)) + os.replace(tmp_path, self.port_path) + + def forget_port(self): + # The specs read the port file to decide whether there is a peer worth + # talking to, so a peer that is going away has to take it with it: + # otherwise every spec waits out its handshake timeout against a socket + # nobody is listening on. + try: + os.remove(self.port_path) + except OSError: + pass + + +def main(): + directory = os.environ.get("MUDLET_TEST_MMCP_DIR") + if not directory: + print("MUDLET_TEST_MMCP_DIR is not set", file=sys.stderr) + return 1 + os.makedirs(directory, exist_ok=True) + peer = MMCPPeer(directory) + try: + peer.run() + finally: + peer.forget_port() + return 0 + + +if __name__ == "__main__": + sys.exit(main()) diff --git a/src/mudlet-lua/tests/Networking_spec.lua b/src/mudlet-lua/tests/Networking_spec.lua index 43d4deb7b..5043c3be5 100644 --- a/src/mudlet-lua/tests/Networking_spec.lua +++ b/src/mudlet-lua/tests/Networking_spec.lua @@ -8,11 +8,13 @@ -- function returns when its precondition (a connection, a peer, an enabled -- protocol, an available API) is not met. -- --- The download and HTTP families are the exception: their infrastructure can be --- stood up locally, so their real effects are checked against the fixture --- server in CI/http-fixture-server.py, whose ephemeral port arrives in --- MUDLET_TEST_HTTP_PORT. They skip cleanly when it is absent so the suite still --- passes without a server. Nothing here mocks a real API function. +-- The download, HTTP and MMCP families are the exception: their infrastructure +-- can be stood up locally, so their real effects are checked against the +-- fixture server in CI/http-fixture-server.py (ephemeral port in +-- MUDLET_TEST_HTTP_PORT) and the scripted chat peer in CI/mmcp-peer.py +-- (handover directory in MUDLET_TEST_MMCP_DIR). Both skip cleanly when absent +-- so the suite still passes without them. Nothing here mocks a real API +-- function. local function contains(haystack, needle) return type(haystack) == "string" and haystack:find(needle, 1, true) ~= nil @@ -780,6 +782,901 @@ describe("MMCP chat commands report the absence of a session", function() end) end) +-- The MMCP specs above check the no-peer contracts. These drive the real +-- protocol against the scripted peer in CI/mmcp-peer.py: it accepts the call +-- mmcp.call() places, records the bytes Mudlet sends and sends chat traffic +-- back when a spec asks it to. Nothing is mocked - each assertion is either a +-- byte the peer received, an event Mudlet raised in response to real socket +-- traffic, or a value read back through the mmcp API. +-- +-- The peer's port is ephemeral (MMCP's default 4050 would collide between CI +-- jobs and parallel worktrees) and is handed over through the directory named +-- by MUDLET_TEST_MMCP_DIR. Without a peer these specs skip, unless +-- MUDLET_TEST_REQUIRE_MMCP_PEER is set, which is how CI turns a fixture that +-- failed to start into a failure rather than a green skip. Linux and macOS +-- start one; the Windows job does not, so the block pends there. +-- +-- The specs share one connection and run in the order they are declared, after +-- the no-peer contracts above them. Anything that shuffles the suite would +-- need them made independent first. +describe("MMCP effects against a scripted chat peer", function() + -- Both of these are what CI/mmcp-peer.py calls itself + local PEER_NAME = "BustedPeer" + local PEER_VERSION = "Mudlet 0.0.0-busted-peer" + local CHAT_NAME = "MudletBustedTester" + local mmcpDir = os.getenv("MUDLET_TEST_MMCP_DIR") + local peerRequired = os.getenv("MUDLET_TEST_REQUIRE_MMCP_PEER") + local commandCounter = 0 + local originalChatName + + local function readFile(path) + local handle = io.open(path, "r") + if not handle then + return nil + end + local contents = handle:read("*a") + handle:close() + return contents + end + + -- The peer writes its port only once it is accepting, so a readable port file + -- means the fixture is up. + local function peerPort() + if not mmcpDir then + return nil + end + local raw = readFile(mmcpDir .. "/port") + return raw and tonumber(raw:match("%d+")) + end + + -- Returns true when the caller should stop because the fixture cannot be + -- talked to and skipping is allowed. + local function peerUnavailable() + local reason + if not peerPort() then + reason = "MMCP peer fixture not running (run CI/mmcp-peer.py with MUDLET_TEST_MMCP_DIR set)" + elseif type(yajl) ~= "table" then + -- yajl is loaded as an optional module, and both channels to the peer are + -- JSON, so say so rather than dying on a nil index further down. + reason = "the yajl Lua module is unavailable, so the peer's JSON channels cannot be used" + else + return false + end + if peerRequired then + assert.is_true(false, "MUDLET_TEST_REQUIRE_MMCP_PEER is set but " .. reason .. " (MUDLET_TEST_MMCP_DIR=" .. tostring(mmcpDir) .. ")") + end + pending(reason) + return true + end + + -- Lets Mudlet's event loop run for ms without blocking it: waiting on an + -- event nothing raises is how a spec gives sockets and timers time to work. + local function pump(ms) + waitForEvent("mmcpFixtureIdleEvent", ms) + end + + local function waitUntil(predicate, timeoutMs) + local step = 20 + for _ = 1, math.ceil((timeoutMs or 2000) / step) do + if predicate() then + return true + end + pump(step) + end + return predicate() + end + + local function capture() + local raw = readFile(mmcpDir .. "/capture.json") + if not raw or raw == "" then + return nil + end + local ok, decoded = pcall(yajl.to_value, raw) + if not ok then + return nil + end + return decoded + end + + -- How far the peer's history has got, so a spec can disregard what earlier + -- specs left behind and look only at what its own action produced. An + -- unreadable capture would silently widen that to the whole history, so it + -- fails here instead. + local function captureSeq() + local decoded = capture() + assert.is_table(decoded) + assert.is_number(decoded.seq) + return decoded.seq + end + + local function waitForPeerEvent(afterSeq, matches, timeoutMs) + local found + waitUntil(function() + local decoded = capture() + found = nil + for _, event in ipairs(decoded and decoded.events or {}) do + if event.seq > afterSeq and matches(event) then + found = event + break + end + end + return found ~= nil + end, timeoutMs) + return found + end + + -- Waits for a protocol command of this name to reach the peer and returns it, + -- or nil if none arrived in time. + local function waitForCommand(name, afterSeq, timeoutMs) + return waitForPeerEvent(afterSeq, function(event) + return event.type == "command" and event.name == name + end, timeoutMs) + end + + -- Instructs the peer. Written as ".json.tmp" and renamed into place so the + -- peer never picks up a half-written command. + local function tellPeer(command) + commandCounter = commandCounter + 1 + local path = mmcpDir .. "/commands/" .. commandCounter .. ".json" + local handle = assert(io.open(path .. ".tmp", "w")) + handle:write(yajl.to_string(command)) + handle:close() + assert(os.rename(path .. ".tmp", path)) + end + + local function peerSends(code, text) + tellPeer({action = "send", code = code, text = text}) + end + + -- The command channel is JSON, so bytes that are not valid UTF-8 - the 0xff + -- terminator above all - have to travel as hex. + local function peerSendsRaw(bytes) + tellPeer({action = "send_hex", hex = (bytes:gsub(".", function(char) + return string.format("%02x", char:byte()) + end))}) + end + + local function peerClient() + local clients = mmcp.getClientList() + if type(clients) ~= "table" then + return nil + end + for _, client in ipairs(clients) do + if client.name == PEER_NAME then + return client + end + end + return nil + end + + -- Set once the peer has failed to answer a call. Every spec calls ensurePeer, + -- so without this a peer that died mid-run would cost each of them the full + -- handshake wait and blow the workflow's one-minute cap before busted could + -- report anything. + local peerNotAnswering + + -- Places a call to the fixture peer unless one is already up, and returns the + -- peer's entry in mmcp.getClientList(). + local function ensurePeer() + local client = peerClient() + if client then + return client + end + if peerNotAnswering then + assert.is_true(false, peerNotAnswering) + end + -- A peer under some other name is one an earlier spec renamed and did not + -- rename back; drop it so this call is not refused as a duplicate. + local stale = mmcp.getClientList() + if type(stale) == "table" then + for _, entry in ipairs(stale) do + mmcp.disconnect(entry.name) + end + waitUntil(function() return mmcp.getClientList() == nil end, 2000) + end + originalChatName = originalChatName or mmcp.chatName() + -- A fixed name, so the bytes the peer records are predictable. + mmcp.chatName(CHAT_NAME) + assert.is_true(mmcp.call("127.0.0.1", peerPort())) + -- A peer joins the client list only once it has accepted the call, and that + -- is what raises sysMMCPPeerUpdateEvent. + if waitForEvent("sysMMCPPeerUpdateEvent", 3000) ~= "sysMMCPPeerUpdateEvent" then + peerNotAnswering = "the MMCP peer fixture never answered a call on port " .. tostring(peerPort()) + assert.is_true(false, peerNotAnswering) + end + client = peerClient() + assert.is_table(client) + return client + end + + -- Runs action with a handler armed for eventName and returns the argument + -- lists it saw. Events Mudlet raises inside an mmcp.* call are raised before + -- that call returns, so they have to be watched for, not waited on. + local function collectEvents(eventName, action) + local seen = {} + local handlerId = registerAnonymousEventHandler(eventName, function(_, ...) + seen[#seen + 1] = {...} + end) + local ok, err = pcall(action) + killAnonymousEventHandler(handlerId) + if not ok then + error(err, 0) + end + return seen + end + + -- Every spec below leaves the peer's flags as it found them, so this does + -- nothing on a passing run. It matters when one does fail: an assertion that + -- stops a spec halfway through a toggle would otherwise leave the peer + -- ignored or private and take the specs after it down as well. + after_each(function() + if not peerClient() then + return + end + local flags = mmcp.getClientFlags(PEER_NAME) + if type(flags) ~= "string" then + return + end + if flags:sub(3, 3) ~= " " then mmcp.setPrivate(PEER_NAME) end + if flags:sub(4, 4) ~= " " then mmcp.ignore(PEER_NAME) end + if flags:sub(5, 5) ~= " " then mmcp.serve(PEER_NAME) end + if flags:sub(7, 7) ~= " " then mmcp.allowSnoop(PEER_NAME) end + end) + + describe("mmcp.call", function() + it("completes the MudMaster handshake with the peer", function() + if peerUnavailable() then return end + ensurePeer() + local decoded = capture() + assert.is_table(decoded.caller) + -- "CHAT:\n
", asserted + -- whole: the port's padding is part of the format a MudMaster peer reads + -- back, and only the exact string keeps it honest. + local port = tostring(peerPort()) + local padded = port .. string.rep(" ", math.max(0, 5 - #port)) + assert.equals("CHAT:" .. CHAT_NAME .. "\n127.0.0.1" .. padded, decoded.caller.raw) + end) + + it("announces itself as Mudlet once the call is accepted", function() + if peerUnavailable() then return end + ensurePeer() + local sent = waitForPeerEvent(0, function(event) + return event.type == "command" and event.name == "Version" + end, 2000) + assert.is_table(sent) + -- Peers switch behaviour on this string - a Mudlet peer only forwards side + -- channel data to versions saying "Mudlet", and picks the snoop colour + -- format from "MudMaster" - so the prefix is load-bearing, not cosmetic. + assert.equals("Mudlet ", sent.text:sub(1, 7)) + end) + + it("lists the accepted peer with its address, port and version", function() + if peerUnavailable() then return end + local client = ensurePeer() + assert.equals(1, client.id) + assert.equals(PEER_NAME, client.name) + assert.equals("127.0.0.1", client.host) + assert.equals(peerPort(), client.port) + -- The peer's version arrives just after its acceptance, which is what + -- releases ensurePeer, so give it its own wait rather than assuming the + -- two landed in the same read. + assert.is_true(waitUntil(function() + local entry = peerClient() + return entry ~= nil and entry.version == PEER_VERSION + end, 2000), tostring(peerClient() and peerClient().version)) + end) + + it("refuses to place a second call to a peer it is already talking to", function() + if peerUnavailable() then return end + ensurePeer() + local before = capture().connections + local ok, err = mmcp.call("127.0.0.1", peerPort()) + assert.is_nil(ok) + assert.is_true(contains(err, "already connected to that client")) + pump(200) + assert.equals(before, capture().connections) + end) + + it("leaves no client behind when nothing answers the port", function() + if peerUnavailable() then return end + ensurePeer() + -- Port 1 on loopback refuses rather than listens. The call is placed + -- (that much is asynchronous), but the client it creates has to be + -- disposed of on the error rather than lingering in the session. + assert.is_true(mmcp.call("127.0.0.1", 1)) + pump(500) + assert.equals(1, #mmcp.getClientList()) + assert.is_table(peerClient()) + end) + + it("leaves no client behind when the peer refuses the call", function() + if peerUnavailable() then return end + if peerClient() then + mmcp.disconnect(PEER_NAME) + waitUntil(function() return peerClient() == nil end, 2000) + end + tellPeer({action = "accept", accept = false}) + waitUntil(function() + local decoded = capture() + return decoded ~= nil and decoded.accepting == false + end, 1000) + + local mark = captureSeq() + assert.is_true(mmcp.call("127.0.0.1", peerPort())) + -- The peer answers "NO:" and hangs up, so the call never reaches + -- the connected state and nothing is added to the client list. + assert.is_table(waitForPeerEvent(mark, function(event) + return event.type == "handshake" + end, 2000)) + pump(300) + assert.is_nil(mmcp.getClientList()) + + tellPeer({action = "accept", accept = true}) + waitUntil(function() + local decoded = capture() + return decoded ~= nil and decoded.accepting == true + end, 1000) + end) + end) + + describe("outgoing chat", function() + it("chatAll sends the message to the peer and echoes it locally", function() + if peerUnavailable() then return end + ensurePeer() + local mark = captureSeq() + local echoes = collectEvents("sysMMCPChatMessage", function() + assert.is_true(mmcp.chatAll("hello everyone")) + end) + local sent = waitForCommand("TextEveryone", mark) + assert.is_table(sent) + assert.equals(CHAT_NAME .. " chats to everybody, 'hello everyone'\n", sent.text) + -- One echo, attributed to "System" because it was addressed to no-one in + -- particular. + assert.equals(1, #echoes) + assert.equals("System", echoes[1][1]) + assert.is_true(contains(echoes[1][2], "You chat to everybody, 'hello everyone'"), tostring(echoes[1][2])) + end) + + it("chatTo sends a personal message to the named peer", function() + if peerUnavailable() then return end + ensurePeer() + local mark = captureSeq() + local echoes = collectEvents("sysMMCPChatMessage", function() + assert.is_true(mmcp.chatTo(PEER_NAME, "just for you")) + end) + local sent = waitForCommand("TextPersonal", mark) + assert.is_table(sent) + assert.equals(CHAT_NAME .. " chats to you, 'just for you'\n", sent.text) + -- Unlike chatAll's echo this one is attributed to the peer it was + -- addressed to, not to "System", even though we are the ones speaking. + assert.equals(1, #echoes) + assert.equals(PEER_NAME, echoes[1][1]) + assert.is_true(contains(echoes[1][2], "You chat to " .. PEER_NAME .. ", 'just for you'"), tostring(echoes[1][2])) + end) + + it("emoteAll sends an unquoted emote to everyone", function() + if peerUnavailable() then return end + ensurePeer() + local mark = captureSeq() + local echoes = collectEvents("sysMMCPChatMessage", function() + assert.is_true(mmcp.emoteAll("waves at the room")) + end) + local sent = waitForCommand("TextEveryone", mark) + assert.is_table(sent) + assert.equals(CHAT_NAME .. " waves at the room\n", sent.text) + assert.equals(1, #echoes) + assert.equals("System", echoes[1][1]) + -- The profile default leaves emotes unprefixed, so the echo is the bare + -- emote and not the "You emote to everyone: '...'" wording. + assert.is_true(contains(echoes[1][2], CHAT_NAME .. " waves at the room"), tostring(echoes[1][2])) + assert.is_false(contains(echoes[1][2], "You emote to everyone"), tostring(echoes[1][2])) + end) + end) + + describe("mmcp.setGroup and mmcp.chatGroup", function() + it("reports an empty group and sends nothing until a peer is assigned", function() + if peerUnavailable() then return end + ensurePeer() + local mark = captureSeq() + local ok, err = mmcp.chatGroup("testers", "nobody there") + assert.is_nil(ok) + assert.is_true(contains(err, "nobody in group 'testers' now")) + assert.is_nil(waitForCommand("TextGroup", mark, 500)) + end) + + it("reaches the peer once it has been assigned to the group", function() + if peerUnavailable() then return end + ensurePeer() + assert.is_true(mmcp.setGroup(PEER_NAME, "testers")) + local mark = captureSeq() + assert.is_true(mmcp.chatGroup("testers", "group hello")) + local sent = waitForCommand("TextGroup", mark) + assert.is_table(sent) + -- MudMaster's group field is a fixed 15 characters wide + assert.equals("testers ", sent.text:sub(1, 15)) + assert.is_true(contains(sent.text, " chats to the group, 'group hello'"), sent.text) + end) + + it("reads back a group chat of its own making", function() + if peerUnavailable() then return end + ensurePeer() + assert.is_true(mmcp.setGroup(PEER_NAME, "testers")) + local mark = captureSeq() + assert.is_true(mmcp.chatGroup("testers", "round trip")) + local sent = waitForCommand("TextGroup", mark) + assert.is_table(sent) + -- Hand Mudlet's own bytes straight back: sender and parser have to agree + -- about where the 15 character group field ends, or a Mudlet peer would + -- render another Mudlet's group chat wrongly. + local received = collectEvents("sysMMCPChatMessage", function() + peerSendsRaw(string.char(6) .. sent.text .. string.char(255)) + pump(500) + end) + assert.equals(1, #received) + assert.equals(PEER_NAME, received[1][1]) + assert.is_true(contains(received[1][2], "(testers)"), tostring(received[1][2])) + assert.is_true(contains(received[1][2], "'round trip'"), tostring(received[1][2])) + end) + + it("stops reaching the peer once it is removed from the group", function() + if peerUnavailable() then return end + ensurePeer() + assert.is_true(mmcp.setGroup(PEER_NAME, "none")) + local mark = captureSeq() + local ok, err = mmcp.chatGroup("testers", "still there?") + assert.is_nil(ok) + assert.is_true(contains(err, "nobody in group 'testers' now")) + assert.is_nil(waitForCommand("TextGroup", mark, 500)) + end) + end) + + describe("per-peer flags", function() + -- getClientFlags returns a fixed 8 character field: two spaces, then + -- Private, Ignored, Served, Firewalled, the snoop state and a trailing + -- space. + it("are all clear while nothing has been toggled", function() + if peerUnavailable() then return end + ensurePeer() + assert.equals(" ", mmcp.getClientFlags(PEER_NAME)) + end) + + it("setPrivate toggles the P flag", function() + if peerUnavailable() then return end + ensurePeer() + assert.is_true(mmcp.setPrivate(PEER_NAME)) + assert.equals(" P ", mmcp.getClientFlags(PEER_NAME)) + assert.is_true(mmcp.setPrivate(PEER_NAME)) + assert.equals(" ", mmcp.getClientFlags(PEER_NAME)) + end) + + it("ignore toggles the I flag", function() + if peerUnavailable() then return end + ensurePeer() + assert.is_true(mmcp.ignore(PEER_NAME)) + assert.equals(" I ", mmcp.getClientFlags(PEER_NAME)) + assert.is_true(mmcp.ignore(PEER_NAME)) + assert.equals(" ", mmcp.getClientFlags(PEER_NAME)) + end) + + it("serve toggles the S flag and tells the peer both times", function() + if peerUnavailable() then return end + ensurePeer() + local mark = captureSeq() + assert.is_true(mmcp.serve(PEER_NAME)) + assert.equals(" S ", mmcp.getClientFlags(PEER_NAME)) + local told = waitForCommand("Message", mark) + assert.is_table(told) + assert.equals(" You are now being served by " .. CHAT_NAME .. ".", told.text) + + mark = captureSeq() + assert.is_true(mmcp.serve(PEER_NAME)) + assert.equals(" ", mmcp.getClientFlags(PEER_NAME)) + told = waitForCommand("Message", mark) + assert.is_table(told) + assert.equals(" You are no longer being served by " .. CHAT_NAME .. ".", told.text) + end) + + it("allowSnoop toggles the n flag and tells the peer both times", function() + if peerUnavailable() then return end + ensurePeer() + local mark = captureSeq() + assert.is_true(mmcp.allowSnoop(PEER_NAME)) + assert.equals(" n ", mmcp.getClientFlags(PEER_NAME)) + local told = waitForCommand("Message", mark) + assert.is_table(told) + assert.equals(" You are now allowed to snoop " .. CHAT_NAME .. ".", told.text) + + mark = captureSeq() + assert.is_true(mmcp.allowSnoop(PEER_NAME)) + assert.equals(" ", mmcp.getClientFlags(PEER_NAME)) + told = waitForCommand("Message", mark) + assert.is_table(told) + assert.equals(" You are no longer allowed to snoop " .. CHAT_NAME .. ".", told.text) + end) + end) + + describe("incoming chat", function() + it("raises sysMMCPChatMessage for a chat to everyone", function() + if peerUnavailable() then return end + ensurePeer() + peerSends(4, PEER_NAME .. " chats to everybody, 'peer speaking'\n") + local name, from, message = waitForEvent("sysMMCPChatMessage", 2000) + assert.equals("sysMMCPChatMessage", name) + assert.equals(PEER_NAME, from) + assert.is_true(contains(message, PEER_NAME .. " chats to everybody, 'peer speaking'"), tostring(message)) + end) + + it("raises sysMMCPChatMessage for a personal chat", function() + if peerUnavailable() then return end + ensurePeer() + peerSends(5, PEER_NAME .. " chats to you, 'just between us'\n") + local _, from, message = waitForEvent("sysMMCPChatMessage", 2000) + assert.equals(PEER_NAME, from) + assert.is_true(contains(message, "chats to you, 'just between us'"), tostring(message)) + end) + + it("names the group an incoming group chat arrived on", function() + if peerUnavailable() then return end + ensurePeer() + -- MudMaster's format: a 15 character group field, then the message. + -- Mudlet's own sender adds a newline after that field, which the + -- round-trip spec above covers. + peerSends(6, "testers " .. PEER_NAME .. " chats to the group, 'group inbound'") + local _, from, message = waitForEvent("sysMMCPChatMessage", 2000) + assert.equals(PEER_NAME, from) + assert.is_true(contains(message, "(testers)"), tostring(message)) + assert.is_true(contains(message, "'group inbound'"), tostring(message)) + end) + + it("displays a plain protocol message from the peer", function() + if peerUnavailable() then return end + ensurePeer() + peerSends(7, " the peer has something to say") + local _, from, message = waitForEvent("sysMMCPChatMessage", 2000) + assert.equals(PEER_NAME, from) + assert.is_true(contains(message, "the peer has something to say"), tostring(message)) + end) + + it("waits for the rest of a command that arrives in two pieces", function() + if peerUnavailable() then return end + ensurePeer() + -- Commands are only complete at their 0xff terminator, and TCP is free to + -- deliver one in as many reads as it likes. Mudlet has to hold the first + -- half rather than displaying a truncated line or dropping it. + peerSendsRaw(string.char(4) .. PEER_NAME .. " chats to everybody, 'split ") + pump(150) + peerSendsRaw("message'\n" .. string.char(255)) + local _, from, message = waitForEvent("sysMMCPChatMessage", 2000) + assert.equals(PEER_NAME, from) + assert.is_true(contains(message, "'split message'"), tostring(message)) + end) + + it("handles two commands that arrive in a single write", function() + if peerUnavailable() then return end + ensurePeer() + -- The parser walks the buffer command by command, so a write carrying + -- two of them has to produce two messages rather than one or none. + local received = collectEvents("sysMMCPChatMessage", function() + peerSendsRaw(string.char(7) .. " first of two" .. string.char(255) + .. string.char(7) .. " second of two" .. string.char(255)) + pump(500) + end) + assert.equals(2, #received) + assert.is_true(contains(received[1][2], "first of two"), tostring(received[1][2])) + assert.is_true(contains(received[2][2], "second of two"), tostring(received[2][2])) + end) + + it("skips a command it does not know without losing the next one", function() + if peerUnavailable() then return end + ensurePeer() + -- An unknown command byte must be skipped up to its terminator; consuming + -- the wrong number of bytes would swallow whatever followed it. + local received = collectEvents("sysMMCPChatMessage", function() + peerSendsRaw(string.char(99) .. "nonsense" .. string.char(255) + .. string.char(7) .. " after the unknown" .. string.char(255)) + pump(500) + end) + assert.equals(1, #received) + assert.is_true(contains(received[1][2], "after the unknown"), tostring(received[1][2])) + end) + + it("drops chat from an ignored peer and resumes when un-ignored", function() + if peerUnavailable() then return end + ensurePeer() + assert.is_true(mmcp.ignore(PEER_NAME)) + peerSends(4, PEER_NAME .. " chats to everybody, 'ignored line'\n") + assert.is_nil(waitForEvent("sysMMCPChatMessage", 500)) + + assert.is_true(mmcp.ignore(PEER_NAME)) + peerSends(4, PEER_NAME .. " chats to everybody, 'heard line'\n") + local _, _, message = waitForEvent("sysMMCPChatMessage", 2000) + assert.is_true(contains(message, "'heard line'"), tostring(message)) + end) + end) + + describe("connection lists a peer sends", function() + -- A connection list makes Mudlet dial the addresses in it, so this is the + -- one incoming command that has a peer reaching outside the session. The + -- fixture's second port answers nothing and hangs up, which is enough to + -- record that Mudlet dialled it. + local function dialPort() + return capture().dial_port + end + + local function dialled(afterSeq, timeoutMs) + return waitForPeerEvent(afterSeq, function(event) + return event.type == "dialled" + end, timeoutMs) + end + + it("dials an address the peer hands over", function() + if peerUnavailable() then return end + ensurePeer() + local mark = captureSeq() + peerSends(3, "127.0.0.1," .. dialPort()) + assert.is_table(dialled(mark, 2000)) + -- Nothing answered, so no peer joined the session over it. + pump(300) + assert.is_table(peerClient()) + assert.equals(1, #mmcp.getClientList()) + end) + + it("dials nothing when the list has a host without a port", function() + if peerUnavailable() then return end + ensurePeer() + local mark = captureSeq() + -- An odd number of fields is rejected as badly formatted rather than + -- being half-parsed into a connection attempt. + peerSends(3, "127.0.0.1," .. dialPort() .. ",127.0.0.1") + assert.is_nil(dialled(mark, 600)) + end) + end) + + describe("mmcp.sendSideChannel", function() + it("sends channel and message to the peer as one comma separated payload", function() + if peerUnavailable() then return end + ensurePeer() + local mark = captureSeq() + assert.is_true(mmcp.sendSideChannel("TestChannel", "payload here")) + local sent = waitForCommand("SideChannel", mark) + assert.is_table(sent) + assert.equals("TestChannel,payload here", sent.text) + end) + + it("raises sysMMCPSideChannelMessage for incoming side channel data", function() + if peerUnavailable() then return end + ensurePeer() + peerSends(40, "TestChannel,inbound payload") + local name, from, channel, message = waitForEvent("sysMMCPSideChannelMessage", 2000) + assert.equals("sysMMCPSideChannelMessage", name) + assert.equals(PEER_NAME, from) + assert.equals("TestChannel", channel) + assert.equals("inbound payload", message) + end) + end) + + describe("mmcp.snoop", function() + it("asks the peer for a snoop feed", function() + if peerUnavailable() then return end + ensurePeer() + local mark = captureSeq() + assert.is_true(mmcp.snoop(PEER_NAME)) + local sent = waitForCommand("Snoop", mark) + assert.is_table(sent) + assert.equals("", sent.text) + -- Asking a second time is what stops a snoop, since the command is a + -- toggle at the far end. That is not asserted here: the local "am I + -- snooping them" flag is never set (nothing calls setSnooped(true)), so + -- MMCPServer::snoop's stop branch cannot be reached and asserting either + -- way would freeze the defect in place. + end) + + it("refuses a snoop from a peer that has not been allowed one", function() + if peerUnavailable() then return end + ensurePeer() + local mark = captureSeq() + -- An incoming Snoop with the n flag clear: the peer is told no, and never + -- starts receiving what the game sends us. + peerSends(30, "") + local told = waitForCommand("Message", mark) + assert.is_table(told) + assert.equals(" You do not have permission to snoop " .. CHAT_NAME .. ".", told.text) + assert.equals(" ", mmcp.getClientFlags(PEER_NAME)) + end) + + it("starts and stops snooping for a peer that has been allowed one", function() + if peerUnavailable() then return end + ensurePeer() + local mark = captureSeq() + assert.is_true(mmcp.allowSnoop(PEER_NAME)) + -- Granting permission sends a Message of its own; let it land before + -- marking, so what is waited for below cannot be that one. + assert.is_table(waitForCommand("Message", mark)) + + mark = captureSeq() + peerSends(30, "") + local told = waitForCommand("Message", mark) + assert.is_table(told) + assert.equals(" You have begun snooping " .. CHAT_NAME .. ".", told.text) + -- N, not n: the peer is snooping us now rather than merely permitted to. + assert.equals(" N ", mmcp.getClientFlags(PEER_NAME)) + + mark = captureSeq() + peerSends(30, "") + told = waitForCommand("Message", mark) + assert.is_table(told) + assert.equals(" You have stopped snooping " .. CHAT_NAME .. ".", told.text) + assert.equals(" n ", mmcp.getClientFlags(PEER_NAME)) + assert.is_true(mmcp.allowSnoop(PEER_NAME)) + end) + + it("raises sysMMCPIncomingSnoopMessage for snooped output", function() + if peerUnavailable() then return end + ensurePeer() + peerSends(31, "You see a snooped line of game output") + local name, from, message = waitForEvent("sysMMCPIncomingSnoopMessage", 2000) + assert.equals("sysMMCPIncomingSnoopMessage", name) + assert.equals(PEER_NAME, from) + assert.is_true(contains(message, "a snooped line of game output"), tostring(message)) + end) + + it("keeps the colour of a snooped line", function() + if peerUnavailable() then return end + ensurePeer() + -- Snoop data is where the other end's colour arrives, and Mudlet tracks + -- it across lines, so the escape sequences have to survive into the event + -- rather than being stripped or reordered away from their text. + peerSendsRaw(string.char(31) .. "\27[1;32ma green snooped line\27[0m" .. string.char(255)) + local _, _, message = waitForEvent("sysMMCPIncomingSnoopMessage", 2000) + assert.is_true(contains(message, "\27[1;32ma green snooped line"), tostring(message)) + end) + end) + + describe("mmcp.ping", function() + it("sends a timestamped ping the peer can answer", function() + if peerUnavailable() then return end + ensurePeer() + local mark = captureSeq() + assert.is_true(mmcp.ping(PEER_NAME)) + local sent = waitForCommand("PingRequest", mark) + assert.is_table(sent) + -- the payload is milliseconds since the epoch, which is what comes back + assert.is_number(tonumber(sent.text)) + end) + + it("answers an incoming ping with the same payload", function() + if peerUnavailable() then return end + ensurePeer() + local mark = captureSeq() + peerSends(26, "1234567890123") + local answered = waitForCommand("PingResponse", mark) + assert.is_table(answered) + assert.equals("1234567890123", answered.text) + end) + end) + + describe("mmcp.chatName", function() + it("announces a new name to connected peers and reads it back", function() + if peerUnavailable() then return end + ensurePeer() + local mark = captureSeq() + assert.is_true(mmcp.chatName("RenamedTester")) + local sent = waitForCommand("NameChange", mark) + assert.is_table(sent) + assert.equals("RenamedTester", sent.text) + assert.equals("RenamedTester", mmcp.chatName()) + + mark = captureSeq() + assert.is_true(mmcp.chatName(CHAT_NAME)) + local restored = waitForCommand("NameChange", mark) + assert.is_table(restored) + assert.equals(CHAT_NAME, restored.text) + end) + + it("does not announce a name that has not changed", function() + if peerUnavailable() then return end + ensurePeer() + assert.is_true(mmcp.chatName(CHAT_NAME)) + local mark = captureSeq() + assert.is_true(mmcp.chatName(CHAT_NAME)) + assert.is_nil(waitForCommand("NameChange", mark, 500)) + end) + + it("does not announce a rejected name", function() + if peerUnavailable() then return end + ensurePeer() + local mark = captureSeq() + local ok, err = mmcp.chatName("bad,name") + assert.is_nil(ok) + assert.is_true(contains(err, "comma")) + assert.is_nil(waitForCommand("NameChange", mark, 500)) + assert.equals(CHAT_NAME, mmcp.chatName()) + end) + + it("follows the peer when it renames itself", function() + if peerUnavailable() then return end + ensurePeer() + peerSends(1, "RenamedPeer") + assert.is_true(waitUntil(function() + local clients = mmcp.getClientList() + return type(clients) == "table" and clients[1] ~= nil and clients[1].name == "RenamedPeer" + end, 2000)) + -- and the new name is what addresses it from then on + assert.is_true(mmcp.chatTo("RenamedPeer", "hello again")) + + peerSends(1, PEER_NAME) + assert.is_true(waitUntil(function() return peerClient() ~= nil end, 2000)) + end) + end) + + describe("mmcp.displayClientList", function() + it("prints the connected peer with its address and port", function() + if peerUnavailable() then return end + ensurePeer() + local printed = collectEvents("sysMMCPChatMessage", function() + assert.is_true(mmcp.displayClientList()) + end) + -- The whole table goes out as one message, attributed to nobody in + -- particular. + assert.equals(1, #printed) + assert.equals("System", printed[1][1]) + local text = printed[1][2] + assert.is_true(contains(text, PEER_NAME), text) + assert.is_true(contains(text, "127.0.0.1"), text) + assert.is_true(contains(text, tostring(peerPort())), text) + end) + end) + + describe("mmcp.accept and mmcp.deny", function() + -- No peer needed: this is about what the mmcp table contains. + it("are not reachable from Lua, so incoming calls cannot be covered", function() + -- Mudlet's pending-call notice tells the user to run mmcp.accept(id) or + -- mmcp.deny(id), but neither is in the mmcp table: their registration in + -- TLuaInterpreter.cpp is commented out, along with setDoNotDisturb, + -- startServer, stopServer, request and peek. Without startServer Mudlet + -- cannot listen either, so no incoming call can be staged here at all. + -- Left pending rather than asserted so the gap is not locked in place - + -- but registering them has to be noticed, hence the failure below. + if mmcp.accept ~= nil or mmcp.deny ~= nil then + assert.is_true(false, "mmcp.accept/mmcp.deny are registered now - replace this spec with real accept and deny coverage") + end + pending("mmcp.accept/mmcp.deny are not registered in the Lua mmcp table") + end) + end) + + describe("disconnection", function() + it("notices when the peer closes the connection", function() + if peerUnavailable() then return end + ensurePeer() + tellPeer({action = "close"}) + assert.equals("sysMMCPPeerUpdateEvent", waitForEvent("sysMMCPPeerUpdateEvent", 2000)) + assert.is_nil(peerClient()) + end) + + it("mmcp.disconnect closes the connection from this end", function() + if peerUnavailable() then return end + ensurePeer() + local mark = captureSeq() + assert.is_true(mmcp.disconnect(PEER_NAME)) + assert.equals("sysMMCPPeerUpdateEvent", waitForEvent("sysMMCPPeerUpdateEvent", 2000)) + assert.is_nil(mmcp.getClientList()) + assert.is_table(waitForPeerEvent(mark, function(event) + return event.type == "disconnect" + end, 2000)) + assert.is_false(capture().connected) + end) + + end) + + -- Restores whatever chat name the profile was carrying before these specs + -- ran, so nothing that follows sees a name this file chose. + teardown(function() + if originalChatName then + mmcp.chatName(originalChatName) + end + end) +end) + describe("Discord Lua API availability contract", function() -- Every rich-presence function is gated on the Discord API being available -- (the discord-rpc library loaded and Discord enabled for this profile). In From c1d1f1aec88aa16d2aa7e887f960748816fc1f73 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Wed, 5 Aug 2026 14:06:45 +0200 Subject: [PATCH 091/155] fix: stop the telnet reader writing a NUL past the data it was given (#9677) #### Brief overview of PR changes/additions * `cTelnet::processSocketData()` terminated its input at `in_buffer[amount + 1]`, one byte past the data it was given, and did so *before* checking the `-1`/`0` returns from `QIODevice::read()`. It now guards first, then terminates at `in_buffer[amount]`. * The guard is `amount <= 0` rather than `== -1`, because `loopbackTest()` narrows a `qsizetype` into an `int` and can produce a negative that is not `-1`. * Adds `cTelnetBufferTest` (5 slots) and drops the `reserve(size + 16)` slack that three existing telnet tests carried purely to absorb the stray write, which turns them into regression guards too. #### Motivation for adding to Mudlet The socket path survived this because `slot_socketReadyToBeRead()` over-allocates its stack buffer, but the same function is reached from Lua's `feedTelnet()` via `loopbackTest()`, which passes a `QByteArray` sized exactly to its contents - so the stray NUL landed one byte past a heap allocation. That is a real out-of-bounds write reachable from any script, and the workarounds already sitting in our test suite show it has been quietly worked around rather than fixed. #### Other info (issues closed, discussion etc) Closes #1065. Supersedes the closed #8438, which carried the same fix under 19 commits of unrelated history and had CI red on a faulty assertion in its own test. **Test case:** reverting the `src/ctelnet.cpp` hunk makes 3 of the 5 new slots fail and AddressSanitizer report `heap-buffer-overflow ... in cTelnet::processSocketData(char*, int, bool)`; restoring it gives 7 passed / 0 failed, and the full suite is 72/72 serially. One thing to flag for review: this adds `friend class cTelnetBufferTest;` to `cTelnet`, since `processSocketData()` is private and the public `loopbackTest()` cannot express a caller-laid-out buffer. It sits beside the existing `friend class TelnetTlsPromptTest;`, so there is precedent, but it is a test name in a shipped header and worth a second opinion. Three review findings were deliberately left out of scope. The MCCP decompression path hit the same overflow, via the re-entry that passes `remainingData`/`remainingAmount` back into `processSocketData()` - the fix covers it, but nothing under `test/` exercises compression at all, so it is fixed-but-unguarded and a dedicated MCCP test belongs in its own PR. The other two are pre-existing and orthogonal: a read error (`amount == -1`) is still silent, because `slot_socketError()` has been commented out as unused since 2017; and `mDecompressionRecursionDepth` is hand-balanced across four decrements rather than held by a scope guard (verified balanced today, but fragile). Happy to do any of them as a follow-up. Assisted-by: Claude:claude-opus-5 --- src/ctelnet.cpp | 16 +- src/ctelnet.h | 4 + test/functional_tests/CMakeLists.txt | 1 + test/functional_tests/PipelineBenchmark.cpp | 6 - .../TelnetSubnegotiationTest.cpp | 4 - test/functional_tests/TelnetTlsPromptTest.cpp | 12 - test/functional_tests/cTelnetBufferTest.cpp | 273 ++++++++++++++++++ 7 files changed, 286 insertions(+), 30 deletions(-) create mode 100644 test/functional_tests/cTelnetBufferTest.cpp diff --git a/src/ctelnet.cpp b/src/ctelnet.cpp index 39961caa4..2bb176db2 100644 --- a/src/ctelnet.cpp +++ b/src/ctelnet.cpp @@ -5050,17 +5050,17 @@ void cTelnet::processSocketData(char* in_buffer, int amount, const bool loopback // TODO: https://github.com/Mudlet/Mudlet/issues/5780 (3 of 7) - investigate switching from using `char[]` to `std::array` char out_buffer[BUFFER_SIZE + 10]; - in_buffer[amount + 1] = '\0'; - - if (amount == -1) { - --mDecompressionRecursionDepth; - return; - } - - if (amount == 0) { + // read() reports -1 on error and 0 when nothing was available; loopbackTest() + // narrows a qsizetype into this int, so treat every non-positive value the + // same rather than testing for -1 exactly. Terminating before this point is + // what wrote a NUL outside the caller's buffer - see issue #1065. + if (amount <= 0) { --mDecompressionRecursionDepth; return; } + // Restates the input contract for decompressBuffer() below, which may swap + // `buffer` over to out_buffer before the terminator is written again. + in_buffer[amount] = '\0'; std::string cleandata; // Pre-allocate for worst case: decompressed data can be much larger than input diff --git a/src/ctelnet.h b/src/ctelnet.h index b554147e5..f6375f59a 100644 --- a/src/ctelnet.h +++ b/src/ctelnet.h @@ -325,6 +325,10 @@ private: // the in-flight reply, reproducing the dialog-swap cancellation cascade. friend class TelnetTlsPromptTest; + // Needs to call processSocketData() with a buffer it laid out itself, which + // the public loopbackTest() cannot express - see issue #1065. + friend class cTelnetBufferTest; + #if defined(QT_NO_SSL) void abortLosingSocket(QTcpSocket* losingSocket); #else diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index 457e697c7..70ec0b6a0 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -9,6 +9,7 @@ set(FUNCTIONAL_TEST_SOURCES TelnetSgrDefaultColorTest.cpp TelnetTlsPromptTest.cpp TelnetBenchmark.cpp + cTelnetBufferTest.cpp DefaultGameDeleteTest.cpp ResetProfileTest.cpp TOscTest.cpp diff --git a/test/functional_tests/PipelineBenchmark.cpp b/test/functional_tests/PipelineBenchmark.cpp index 7c65e16d3..7612a1c1d 100644 --- a/test/functional_tests/PipelineBenchmark.cpp +++ b/test/functional_tests/PipelineBenchmark.cpp @@ -271,8 +271,6 @@ private: return n; } - // loopbackTest() writes NUL bytes up to two past the data end, so the corpus - // is over-reserved in initTestCase(). double feedCorpusBestPass(Host* host, int passes) { double best = std::numeric_limits::max(); @@ -333,9 +331,6 @@ private slots: initializeQRCResources(); mCorpus = generateCorpus(kCorpusLines, mCorpusLines); mCorpusBytes = mCorpus.size(); - // loopbackTest() writes NUL bytes past the data end; reserve slack so that - // stays within the allocation. - mCorpus.reserve(mCorpus.size() + 16); // An invariant, emitted here so it is present regardless of which bench // slots run: the compare script rejects an ASan-vs-release comparison. emitMetric("build_asan", static_cast(BENCH_BUILD_ASAN)); @@ -408,7 +403,6 @@ private slots: QVERIFY(sentinel->setScript(qsl("benchSentinelFired = true"))); QVERIFY(sentinel->state()); QByteArray probe{"__bench_sentinel__\r\n"}; - probe.reserve(probe.size() + 16); host->mTelnet.loopbackTest(probe); QVERIFY2(host->getLuaInterpreter()->compileAndExecuteScript(qsl("assert(benchSentinelFired)")), "sentinel trigger did not fire - the trigger engine is not seeing pipeline data"); diff --git a/test/functional_tests/TelnetSubnegotiationTest.cpp b/test/functional_tests/TelnetSubnegotiationTest.cpp index 40abf5cb6..479952a23 100644 --- a/test/functional_tests/TelnetSubnegotiationTest.cpp +++ b/test/functional_tests/TelnetSubnegotiationTest.cpp @@ -88,10 +88,6 @@ private slots: data.append(TN_IAC); data.append(TN_SE); data.append("SUBNEG_RECOVERED\r\n"); - // processSocketData() writes a NUL at in_buffer[size + 1], so give the - // backing buffer a little slack before handing it its data pointer. - data.reserve(data.size() + 16); - host->mTelnet.loopbackTest(data); QVERIFY2(waitForBufferToContain("SUBNEG_RECOVERED"), "Ordinary text after an oversized subnegotiation was not displayed - recovery failed."); diff --git a/test/functional_tests/TelnetTlsPromptTest.cpp b/test/functional_tests/TelnetTlsPromptTest.cpp index 315c61ea9..10640ebd3 100644 --- a/test/functional_tests/TelnetTlsPromptTest.cpp +++ b/test/functional_tests/TelnetTlsPromptTest.cpp @@ -112,10 +112,6 @@ private slots: data.append(tlsPort); data.append(TN_IAC); data.append(TN_SE); - // processSocketData() writes a NUL at in_buffer[size + 1], so give the - // backing buffer a little slack before handing it its data pointer. - data.reserve(data.size() + 16); - host->mTelnet.loopbackTest(data); // The signal is emitted synchronously inside loopbackTest(), so it has @@ -160,7 +156,6 @@ private slots: // Advertise a secure port so mMSSPTlsPort is populated (the handler is // detached, so nothing pops up). QByteArray advertise = msspTlsPayload("48000"); - advertise.reserve(advertise.size() + 16); host->mTelnet.loopbackTest(advertise); // The user answers No; the reconnect that follows must complete. @@ -176,7 +171,6 @@ private slots: // the user has declined (don't-ask-again is sticky for the session). QSignalSpy promptSpy(&host->mTelnet, &cTelnet::signal_promptTlsAvailable); QByteArray advertiseAgain = msspTlsPayload("48000"); - advertiseAgain.reserve(advertiseAgain.size() + 16); host->mTelnet.loopbackTest(advertiseAgain); QCOMPARE(promptSpy.count(), 0); #endif @@ -204,7 +198,6 @@ private slots: // Advertise the second stub's port as the secure port. QByteArray advertise = msspTlsPayload(QByteArray::number(securePort)); - advertise.reserve(advertise.size() + 16); host->mTelnet.loopbackTest(advertise); QCOMPARE(host->mMSSPTlsPort, static_cast(securePort)); @@ -243,7 +236,6 @@ private slots: QVERIFY(spy.isValid()); QByteArray advertise = msspTlsPayload("48000"); - advertise.reserve(advertise.size() + 16); host->mTelnet.loopbackTest(advertise); if (spy.isEmpty()) { QVERIFY2(spy.wait(2s), "cTelnet did not emit signal_promptTlsAvailable for the first advertisement."); @@ -253,7 +245,6 @@ private slots: // Nobody has answered, so the prompt is still in flight: a repeated // advertisement (as a hostile server could spam) must be swallowed. QByteArray advertiseAgain = msspTlsPayload("48000"); - advertiseAgain.reserve(advertiseAgain.size() + 16); host->mTelnet.loopbackTest(advertiseAgain); QCOMPARE(spy.count(), 1); #endif @@ -277,7 +268,6 @@ private slots: // Advertise so the port is recorded and the latch is set, mirroring a // real pending prompt. QByteArray advertise = msspTlsPayload("48000"); - advertise.reserve(advertise.size() + 16); host->mTelnet.loopbackTest(advertise); const int originalPort = host->getPort(); @@ -314,12 +304,10 @@ private slots: QSignalSpy bellSpy(&host->mTelnet, &cTelnet::signal_bell); QByteArray oneBell("\a"); - oneBell.reserve(oneBell.size() + 16); host->mTelnet.loopbackTest(oneBell); QCOMPARE(bellSpy.count(), 1); QByteArray twoBells("\a\a"); - twoBells.reserve(twoBells.size() + 16); host->mTelnet.loopbackTest(twoBells); QCOMPARE(bellSpy.count(), 3); } diff --git a/test/functional_tests/cTelnetBufferTest.cpp b/test/functional_tests/cTelnetBufferTest.cpp new file mode 100644 index 000000000..c920e9905 --- /dev/null +++ b/test/functional_tests/cTelnetBufferTest.cpp @@ -0,0 +1,273 @@ +/*************************************************************************** + * Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +/* + * Tests for the off-by-one write in cTelnet::processSocketData() - + * https://github.com/Mudlet/Mudlet/issues/1065 + * + * processSocketData() used to terminate its input with + * "in_buffer[amount + 1] = '\0'", one byte further along than the data it was + * given. The socket path survived it because slot_socketReadyToBeRead() over- + * allocates its stack buffer, but the same function is also reached from Lua's + * feedTelnet() via cTelnet::loopbackTest(), which hands it a QByteArray sized + * exactly to its contents - so the stray NUL landed one byte past the end of a + * heap allocation. + * + * The discriminating tests are nulTerminatorLandsAtTheDataEnd(), its every-size + * sibling, and emptyAndErroredReadsLeaveTheBufferAlone(): a sentinel is planted + * at [amount + 1] and must still be there afterwards. Those fail on the unfixed + * code without needing a sanitizer, which matters because Windows CI builds + * without one. Note that the byte at [amount] is written by the later + * "buffer[datalen] = '\0'" too, so asserting on it only proves the call ran - + * the sentinel one byte further along is what catches the bug. + * + * Run with: ctest -R cTelnetBufferTest -V + */ + +#include +#include +#include +#include + +#include "MudletInstanceCoordinator.h" +#include "TMainConsole.h" +#include "TelnetServerStub.h" +#include "ctelnet.h" +#include "dlgConnectionProfiles.h" +#include "mudlet.h" + +using namespace std::chrono_literals; + +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); +void initializeQRCResourcesForBufferTest(); + +class cTelnetBufferTest : public QObject +{ + Q_OBJECT + +private: + TelnetServerStub* mpServer = nullptr; + Host* mpHost = nullptr; + const QString mHostname = qsl("BufferTest-Host"); + QString mPort; // assigned the stub's actual ephemeral port in initTestCase() + const QString mLocalhost = qsl("localhost"); + + // The byte processSocketData() is entitled to overwrite with its NUL, and + // the one immediately after it that it must leave alone. + static constexpr char scmTerminatorSlot = '\x7b'; + static constexpr char scmPastTheEnd = '\x7c'; + + // True if any line in the main console buffer contains the given substring + bool bufferContains(const QString& text) const + { + TMainConsole* console = mpHost->mpConsole; + for (int i = 0; i <= console->buffer.getLastLineNumber(); ++i) { + if (console->buffer.line(i).contains(text)) { + return true; + } + } + return false; + } + +private slots: + void initTestCase() + { + initializeQRCResourcesForBufferTest(); + + mpServer = new TelnetServerStub(qApp); + mpServer->start(mLocalhost, 0); // ephemeral OS-assigned port avoids collisions across concurrent test runs + mPort = QString::number(mpServer->serverPort()); + mudlet::start(); + mudlet::self()->setupConfig(); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique("MudletInstanceCoordinator")); + mudlet::self()->init(); + mudlet::self()->setStorePasswordsSecurely(false); + + const QString path = mudlet::getMudletPath(enums::profileHomePath, mHostname); + QDir(path).removeRecursively(); + + QTimer::singleShot(0ms, qApp, [this]() { + mudlet::self()->startAutoLogin({}); + QTest::qWait(100ms); + QTest::mouseClick(mudlet::self()->mpConnectionDialog->new_profile_button, Qt::LeftButton); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), mHostname); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), mLocalhost); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), mPort); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Return); + }); + + QSignalSpy spy(mudlet::self(), &mudlet::signal_profileLoaded); + if (!spy.wait(1000)) { + QFAIL("Profile took too long to load."); + } + mpHost = mudlet::self()->getActiveHost(); + if (!mpHost) { + QFAIL("No active host available for the test."); + } + + QSignalSpy spy2(&(mpHost->mTelnet), &cTelnet::signal_connected); + if (!spy2.wait(500)) { + QFAIL("Could not connect with the host."); + } + } + + void init() + { + QVERIFY(mpHost); + QVERIFY(mpHost->mpConsole); + mpHost->mpConsole->buffer.clear(); + // A leaked recursion level is permanent for the profile and eventually + // turns processSocketData() into a silent no-op, which would make the + // "nothing was written" assertions below pass for the wrong reason. + QCOMPARE(mpHost->mTelnet.mDecompressionRecursionDepth, 0); + } + + void cleanup() { QCOMPARE(mpHost->mTelnet.mDecompressionRecursionDepth, 0); } + + // The regression test for #1065. processSocketData() is handed `payloadSize` + // bytes inside a buffer that has two spare bytes after them. It may write + // its NUL over the first spare byte; the second must come back untouched. + void nulTerminatorLandsAtTheDataEnd() + { + constexpr int payloadSize = 8; + QByteArray backing(payloadSize + 2, '\0'); + std::memset(backing.data(), 'A', payloadSize); + backing[payloadSize] = scmTerminatorSlot; + backing[payloadSize + 1] = scmPastTheEnd; + + mpHost->mTelnet.processSocketData(backing.data(), payloadSize, true); + + QCOMPARE(backing.at(payloadSize), '\0'); + QVERIFY2(backing.at(payloadSize + 1) == scmPastTheEnd, + "processSocketData() wrote its NUL terminator one byte past the data it was given " + "- the off-by-one of issue #1065 is back."); + } + + // The same off-by-one across the sizes a read can plausibly return, so a + // future rewrite cannot reintroduce it for only some lengths. + void nulTerminatorLandsAtTheDataEndAtEverySize() + { + for (const int payloadSize : {1, 2, 4, 8, 15, 16, 31, 32, 33, 63, 64, 1024}) { + QByteArray backing(payloadSize + 2, '\0'); + std::memset(backing.data(), 'A', payloadSize); + backing[payloadSize] = scmTerminatorSlot; + backing[payloadSize + 1] = scmPastTheEnd; + + mpHost->mTelnet.processSocketData(backing.data(), payloadSize, true); + + // The terminator check proves the call actually ran, so the + // past-the-end check below cannot pass by the function bailing out. + QVERIFY2(backing.at(payloadSize) == '\0', qPrintable(qsl("processSocketData() did not terminate a %1 byte payload at all.").arg(payloadSize))); + QVERIFY2(backing.at(payloadSize + 1) == scmPastTheEnd, qPrintable(qsl("processSocketData() wrote past the end of a %1 byte payload.").arg(payloadSize))); + } + } + + // The production route from Lua: feedTelnet() -> loopbackTest() -> + // processSocketData(). loopbackTest() takes a non-const QByteArray and calls + // data(), which detaches, so the allocation shape is Qt's choice rather than + // ours - this is a "the pipeline still works" check, not a bounds check. + void feedTelnetPathDisplaysItsDataIntact() + { + QByteArray payload = QByteArrayLiteral("BUFFER_TEST_MARKER\r\n"); + payload.squeeze(); + + mpHost->mTelnet.loopbackTest(payload); + QVERIFY2(QTest::qWaitFor( + [this]() { + return bufferContains(qsl("BUFFER_TEST_MARKER")); + }, + QDeadlineTimer(5s)), + "Text fed through loopbackTest() did not reach the console."); + } + + // A closed or errored socket reports -1 and an empty read reports 0. Neither + // may touch the caller's buffer, which for amount == 0 can legitimately have + // no writable byte at all. -2 stands in for the qsizetype narrowing in + // loopbackTest(), which can produce a negative that is not -1. + void emptyAndErroredReadsLeaveTheBufferAlone() + { + for (const int amount : {0, -1, -2}) { + QByteArray backing(2, '\0'); + backing[0] = scmTerminatorSlot; + backing[1] = scmPastTheEnd; + + mpHost->mTelnet.processSocketData(backing.data(), amount, true); + + QVERIFY2(backing.at(0) == scmTerminatorSlot, qPrintable(qsl("processSocketData() wrote into the buffer for a read of %1.").arg(amount))); + QVERIFY2(backing.at(1) == scmPastTheEnd, qPrintable(qsl("processSocketData() wrote past the buffer for a read of %1.").arg(amount))); + } + } + + // Declared last on purpose: on the unfixed code this trips AddressSanitizer, + // which aborts the process, so anything after it would never report. The + // sentinels give it teeth on Windows too, where CI builds without ASan. + void exactlySizedHeapAllocationIsNotOverrun() + { + const QByteArray payload = QByteArrayLiteral("heap probe\r\n"); + const auto size = static_cast(payload.size()); + // Exactly the shape QByteArray allocates: the data plus its terminator. + auto buffer = std::make_unique(size + 1); + std::memcpy(buffer.get(), payload.constData(), size); + buffer[size] = scmTerminatorSlot; + + mpHost->mTelnet.processSocketData(buffer.get(), size, true); + + QCOMPARE(buffer[size], '\0'); + } + + void cleanupTestCase() + { + mpHost = nullptr; + delete mpServer; + mpServer = nullptr; + const QString path = mudlet::getMudletPath(enums::profileHomePath, mHostname); + QDir(path).removeRecursively(); + delete mudlet::self(); + } +}; + +void initializeQRCResourcesForBufferTest() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +#include "cTelnetBufferTest.moc" +QTEST_MAIN(cTelnetBufferTest) From f65323b759bc9d38d3da22e20a5547139777d6fd Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Wed, 5 Aug 2026 19:51:48 +0200 Subject: [PATCH 092/155] fix: four Lua API corrections - colours, room name offsets, map window state and printTable (#9678) #### Brief overview of PR changes/additions - `PadHexNum()` prepends its zero and pads by width rather than by value, so `RGB2Hex()` stops mangling any colour component below 16 and `setGaugeText()` stops emitting a broken ``. The worst case was silent: `RGB2Hex(200, 11, 12)` returned the well-formed but wrong `C8B0C0`, painting (200, 176, 192) instead of (200, 11, 12). - `getRoomNameOffset()` matches a leading minus, so a negative offset reads back negative - the map renderer already draws it that way. - The map window functions now answer for the map widget that is actually on screen. `setMapWindowTitle()`, `getMapWindowTitle()` and `getMapWidgetGeometry()` report `no floating/dockable type map window found` after `closeMapWidget()` instead of acting on a widget the script put away. They go through a new `Host::mapWidget()`, which reads the dock's own hidden state, so the dock's close button and the map toolbar button move it too. Reopening is unaffected: the dock is still only hidden, so its title and geometry survive. - `printTable()` and `listPrint()` `tostring()` their keys and values instead of raising `attempt to concatenate` on a table, boolean or function, and now name themselves when handed a non-table. #### Motivation for adding to Mudlet All four fail quietly: a wrong-but-valid colour string, an offset that comes back with the wrong sign, a map window function that reports success against a widget that is not on screen, and a debug printer that errors on exactly the tables you would want to inspect. #### Other info (issues closed, discussion etc) Closes #9641, closes #9644, closes #9662, closes #9663. - #9641 PadHexNum pads hex digits on the wrong side, so RGB2Hex mangles any colour component below 16 - #9644 getRoomNameOffset drops the minus sign, so negative room name offsets read back positive - #9662 closeMapWidget() only hides the map widget, so open and closed cannot be told apart - #9663 printTable() errors on any table holding a value that is not a string or number Test case: `lua print(RGB2Hex(200, 11, 12))` prints `C80B0C`, not `C8B0C0`. `__printTable()` is kept (#9663 "printTable() errors on any table holding a value that is not a string or number" asked for a decision): it is a reachable global with its own specs, and wiring it into `printTable()` would change `printTable()`'s output format. Its inaccurate "supporting function for printTable()" comment is corrected instead. `Geyser.Mapper:show()` now reapplies a title that was set while the mapper was hidden, which the map widget change would otherwise have dropped. Specs added to `GUIUtils_spec`, `TableUtils_spec`, `Mapper_spec` and `GeyserMapper_spec`; the four `pending()` guards that recorded these bugs are gone. All of the new assertions fail on development and pass here. Before and after for #9662 "closeMapWidget() only hides the map widget, so open and closed cannot be told apart": https://github.com/user-attachments/assets/1bf72811-4f79-492f-b449-9013f13984a8 Assisted-by: Claude:claude-opus-5 --- src/Host.cpp | 50 ++++++-- src/Host.h | 2 + src/TMainConsole.h | 3 + src/mudlet-lua/lua/GUIUtils.lua | 24 ++-- src/mudlet-lua/lua/TableUtils.lua | 10 +- src/mudlet-lua/lua/geyser/GeyserMapper.lua | 20 ++- src/mudlet-lua/tests/GUIUtils_spec.lua | 53 ++++++-- src/mudlet-lua/tests/GeyserMapper_spec.lua | 56 +++++++- src/mudlet-lua/tests/Mapper_spec.lua | 142 ++++++++++++++++++--- src/mudlet-lua/tests/TableUtils_spec.lua | 50 +++++++- src/mudlet-lua/tests/UI_spec.lua | 3 +- 11 files changed, 349 insertions(+), 64 deletions(-) diff --git a/src/Host.cpp b/src/Host.cpp index 1b2d2e1dd..187df0292 100644 --- a/src/Host.cpp +++ b/src/Host.cpp @@ -3471,16 +3471,36 @@ void Host::setBufferSearchOptions(const TConsole::SearchOptions optionsState) mBufferSearchOptions = optionsState; } +// The single answer to "does this profile have a map widget on screen right +// now" - null both for a profile that has never opened one and for one that put +// it away again, which a script cannot tell apart and does not need to. +// +// isHidden() rather than a flag of our own, because the dock gets hidden by +// paths that would never think to update one: its own title bar close button, +// mudlet::slot_showMapperDialog() handing the map over to a main window dock, +// and QMainWindow::restoreState() replaying a saved layout. It is also not +// !isVisible(), which would additionally answer "no map widget" whenever the +// main window itself is hidden, e.g. minimised to the system tray. +QDockWidget* Host::mapWidget() const +{ + if (!mpConsole || !mpConsole->mpDockableMapWidget || mpConsole->mpDockableMapWidget->isHidden()) { + return nullptr; + } + + return mpConsole->mpDockableMapWidget; +} + std::pair Host::setMapperTitle(const QString& title) { - if (!mpConsole || !mpConsole->mpDockableMapWidget) { - return {false, "no floating/dockable type map window found"}; + auto pM = mapWidget(); + if (!pM) { + return {false, qsl("no floating/dockable type map window found")}; } if (title.isEmpty()) { - mpConsole->mpDockableMapWidget->setWindowTitle(tr("Map - %1").arg(mHostName)); + pM->setWindowTitle(tr("Map - %1").arg(mHostName)); } else { - mpConsole->mpDockableMapWidget->setWindowTitle(title); + pM->setWindowTitle(title); } return {true, QString()}; @@ -3488,11 +3508,12 @@ std::pair Host::setMapperTitle(const QString& title) std::optional Host::getMapperTitle() const { - if (!mpConsole || !mpConsole->mpDockableMapWidget) { + auto pM = mapWidget(); + if (!pM) { return {}; } - return {mpConsole->mpDockableMapWidget->windowTitle()}; + return {pM->windowTitle()}; } std::pair Host::createMapView(int areaId) @@ -4200,7 +4221,7 @@ std::pair Host::setWindow(const QString& windowname, const QStrin std::pair Host::openMapWidget(const QString& area, int x, int y, int width, int height) { if (!mpConsole) { - return {false, QString()}; + return {false, qsl("no console for this profile - it may be closing")}; } auto pM = mpConsole->mpDockableMapWidget; @@ -4265,28 +4286,29 @@ std::pair Host::openMapWidget(const QString& area, int x, int y, // while a floating dock's geometry() reports the client area instead. std::optional Host::mapWidgetGeometry() const { - if (!mpConsole || !mpConsole->mpDockableMapWidget) { + auto pM = mapWidget(); + if (!pM) { return {}; } - auto pM = mpConsole->mpDockableMapWidget; return {QRect(pM->pos(), pM->size())}; } std::pair Host::closeMapWidget() { if (!mpConsole) { - return {false, QString()}; + return {false, qsl("no console for this profile - it may be closing")}; } - auto pM = mpConsole->mpDockableMapWidget; - if (!pM) { + // Test the raw pointer first so that a profile which never made a map widget + // is told apart from one that has put its widget away. + if (!mpConsole->mpDockableMapWidget) { return {false, qsl("no map widget found to close")}; } - if (!pM->isVisible()) { + if (!mapWidget()) { return {false, qsl("map widget already closed")}; } - pM->hide(); + mpConsole->mpDockableMapWidget->hide(); return {true, QString()}; } diff --git a/src/Host.h b/src/Host.h index a20cc58a4..b506ec12d 100644 --- a/src/Host.h +++ b/src/Host.h @@ -57,6 +57,7 @@ #include "TMxpProcessor.h" #include "TMxpFrameManager.h" +class QDockWidget; class QJsonObject; class QKeyEvent; @@ -396,6 +397,7 @@ public: void setBufferSearchOptions(const TConsole::SearchOptions); std::pair setMapperTitle(const QString&); std::optional getMapperTitle() const; + QDockWidget* mapWidget() const; // Multiple map views support std::pair createMapView(int areaId = 0); diff --git a/src/TMainConsole.h b/src/TMainConsole.h index 29d3865e2..956104cb1 100644 --- a/src/TMainConsole.h +++ b/src/TMainConsole.h @@ -149,6 +149,9 @@ public: bool mLogToLogFile = false; QPointer mpPackageDownloadProgressDialog; QPointer mpMapProgressDialog; + // Outlives Host::closeMapWidget(), which only hides it, so this being + // non-null says the profile has made a map widget at some point, not that it + // has one on screen - see Host::mapWidget() for the latter. QPointer mpDockableMapWidget; QPointer mpUnpackingDialog; diff --git a/src/mudlet-lua/lua/GUIUtils.lua b/src/mudlet-lua/lua/GUIUtils.lua index dfcb33fbb..5aa6c0602 100644 --- a/src/mudlet-lua/lua/GUIUtils.lua +++ b/src/mudlet-lua/lua/GUIUtils.lua @@ -413,22 +413,21 @@ end --- Pads a hex number to ensure a minimum of 2 digits. --- ---- @usage Following command will returns "F0". +--- @usage Following command will return "0F". --- 
 ---   PadHexNum("F")
 ---
function PadHexNum(incString) assert(type(incString) == 'string', 'PadHexNum: bad argument #1 type (expected string, got '..type(incString)..'!)') - local l_Return = incString - if tonumber(incString, 16) < 16 then - if tonumber(incString, 16) < 10 then - l_Return = "0" .. l_Return - elseif tonumber(incString, 16) > 10 then - l_Return = l_Return .. "0" - end + assert(tonumber(incString, 16) ~= nil, 'PadHexNum: bad argument #1 value (hex number as string expected, got "'..incString..'"!)') + + -- the pad goes on the front, and it is the width that decides whether one is + -- needed: "00" is already two digits wide even though its value is below 16 + if #incString < 2 then + return "0" .. incString end - return l_Return + return incString end @@ -2380,7 +2379,12 @@ function getRoomNameOffset(room) local d = getRoomUserData(room, "room.ui_nameOffset") if d == nil or d == "" then return 0,0 end local split = {} - for w in string.gfind(d, '[%.%d]+') do split[#split+1] = tonumber(w) end + -- the minus has to be part of the match: T2DMap parses the same user data with + -- QString::toDouble(), so a negative offset the renderer honours must read + -- back negative here too. This still only scrapes numbers out of the string, + -- so malformed user data reads back as a plausible pair the renderer will not + -- draw - unchanged by the sign fix + for w in string.gfind(d, '%-?[%.%d]+') do split[#split+1] = tonumber(w) end if #split == 1 then return 0,split[1] end if #split >= 2 then return split[1],split[2] end return 0,0 diff --git a/src/mudlet-lua/lua/TableUtils.lua b/src/mudlet-lua/lua/TableUtils.lua index fd1e271b3..9fd9596e1 100644 --- a/src/mudlet-lua/lua/TableUtils.lua +++ b/src/mudlet-lua/lua/TableUtils.lua @@ -50,9 +50,10 @@ end --- --- @see display function printTable( map ) + assert(type(map) == 'table', 'printTable: bad argument #1 type (table expected, got '..type(map)..'!)') echo("-------------------------------------------------------\n"); for k, v in pairs( map ) do - echo( "key=" .. k .. " value=" .. v .. "\n" ) + echo( "key=" .. tostring(k) .. " value=" .. tostring(v) .. "\n" ) end echo("-------------------------------------------------------\n"); end @@ -60,7 +61,9 @@ end -- NOT LUADOC --- This is supporting function for printTable(). +-- Prints a single key/value pair into the main console at the cursor. Named as +-- a helper for printTable(), but printTable() has never called it and formats +-- its own lines; kept because it is reachable from scripts. function __printTable( k, v ) insertText("\nkey = " .. tostring(k) .. " value = " .. tostring( v ) ) end @@ -135,9 +138,10 @@ end --- @see display --- @see printTable function listPrint( map ) + assert(type(map) == 'table', 'listPrint: bad argument #1 type (table expected, got '..type(map)..'!)') echo("-------------------------------------------------------\n"); for k, v in ipairs( map ) do - echo( k .. ". ) " .. v .. "\n" ); + echo( k .. ". ) " .. tostring(v) .. "\n" ); end echo("-------------------------------------------------------\n"); end diff --git a/src/mudlet-lua/lua/geyser/GeyserMapper.lua b/src/mudlet-lua/lua/geyser/GeyserMapper.lua index de438c83e..b559a7cc1 100644 --- a/src/mudlet-lua/lua/geyser/GeyserMapper.lua +++ b/src/mudlet-lua/lua/geyser/GeyserMapper.lua @@ -59,6 +59,16 @@ function Geyser.Mapper:show_impl() createMapper(self.windowname, self:get_x(), self:get_y(), self:get_width(), self:get_height()) else openMapWidget() + -- A title only reaches a map window that is on screen, so one this mapper + -- set while it was hidden has to be applied now instead. Only one that did + -- not land: an unconditional apply here would overwrite a title set through + -- setMapWindowTitle() directly every time any mapper is shown. An empty + -- titleText is a reset rather than "no title", which is why this tracks + -- whether the call failed instead of whether the text is empty. + if self.titlePending then + self.titlePending = false + setMapWindowTitle(self.titleText) + end end end @@ -79,12 +89,18 @@ end function Geyser.Mapper:setTitle(text) self.titleText = text - return setMapWindowTitle(text) + local applied, message = setMapWindowTitle(text) + self.titlePending = not applied + return applied, message end function Geyser.Mapper:resetTitle() self.titleText = "" - return resetMapWindowTitle() + -- resetMapWindowTitle() is setMapWindowTitle(""), so show_impl applying + -- titleText covers a reset as well + local applied, message = resetMapWindowTitle() + self.titlePending = not applied + return applied, message end -- Overridden constructor diff --git a/src/mudlet-lua/tests/GUIUtils_spec.lua b/src/mudlet-lua/tests/GUIUtils_spec.lua index 255cf7ead..fe3fe53cf 100644 --- a/src/mudlet-lua/tests/GUIUtils_spec.lua +++ b/src/mudlet-lua/tests/GUIUtils_spec.lua @@ -1079,21 +1079,37 @@ describe("Tests the GUI utilities as far as possible without mudlet", function() assert.equals("FF", PadHexNum("FF")) assert.equals("0A", PadHexNum("0A")) assert.equals("10", PadHexNum("10")) + -- "00" is worth its own assertion: its value is below sixteen, so a pad + -- driven by value rather than by width grows it to three digits + assert.equals("00", PadHexNum("00")) end) it("Should error when not given a string", function() assert.has_error(function() PadHexNum(15) end) end) + it("Should error when the string is not a hex number", function() + -- the message matters: the old code reached the same outcome by accident, + -- comparing a nil tonumber() result against a number + assert.has_error(function() PadHexNum("zz") end, + 'PadHexNum: bad argument #1 value (hex number as string expected, got "zz"!)') + assert.has_error(function() PadHexNum("") end, + 'PadHexNum: bad argument #1 value (hex number as string expected, got ""!)') + end) + it("Should zero-pad single hex digits above nine as well", function() - -- BUG: for values 11..15 the zero is appended instead of prepended, so - -- PadHexNum("B") is "B0" (176) rather than "0B" (11); the value 10 hits - -- neither branch and comes back as the unpadded, single character "A" - pending("PadHexNum pads on the wrong side above nine - see the Wave 3d report") assert.equals("0A", PadHexNum("A")) assert.equals("0B", PadHexNum("B")) assert.equals("0F", PadHexNum("F")) end) + + it("Should pad every single digit to the same width", function() + for value = 0, 15 do + local padded = PadHexNum(string.format("%X", value)) + assert.equals(2, #padded) + assert.equals(value, tonumber(padded, 16)) + end + end) end) describe("Tests the functionality of RGB2Hex", function() @@ -1114,11 +1130,27 @@ describe("Tests the GUI utilities as far as possible without mudlet", function() end) it("Should produce six hex digits for every component below sixteen", function() - -- BUG: RGB2Hex inherits PadHexNum's wrong-side padding, so a component - -- of 11 becomes "B0" (176) and one of 10 contributes a single "A", - -- yielding the malformed five character string "AB00C" here - pending("RGB2Hex mis-encodes components below sixteen - see the Wave 3d report") assert.equals("0A0B0C", RGB2Hex(10, 11, 12)) + assert.equals("0A0A0A", RGB2Hex(10, 10, 10)) + end) + + it("Should encode a small component as its own value, not a shifted one", function() + -- the damaging case: a well formed six digit string that names the wrong + -- colour, so nothing downstream can notice. 11 must not become 0xB0 (176) + assert.equals("C80B0C", RGB2Hex(200, 11, 12)) + assert.equals("FF0000", RGB2Hex(255, 0, 0)) + end) + + -- in 0-255 only: RGB2Hex range-checks nothing, so an out of range component + -- still produces a longer string. That is a separate defect from the padding + it("Should return six hex digits for every component value in 0-255", function() + for _, component in ipairs({0, 1, 9, 10, 15, 16, 17, 128, 255}) do + local hex = RGB2Hex(component, component, component) + assert.equals(6, #hex) + for position = 1, 5, 2 do + assert.equals(component, tonumber(hex:sub(position, position + 1), 16)) + end + end end) end) @@ -1357,6 +1389,11 @@ describe("Tests the GUI utilities as far as possible without mudlet", function() assert.equals([[hurt]], gaugesTable[gaugeName].text) end) + it("Should emit a six digit colour for components below sixteen", function() + setGaugeText(gaugeName, "dim", 10, 11, 12) + assert.equals([[dim]], gaugesTable[gaugeName].text) + end) + it("Should clear the caption when no text is given", function() setGaugeText(gaugeName, "something") setGaugeText(gaugeName) diff --git a/src/mudlet-lua/tests/GeyserMapper_spec.lua b/src/mudlet-lua/tests/GeyserMapper_spec.lua index 08d04f528..30c53e1ed 100644 --- a/src/mudlet-lua/tests/GeyserMapper_spec.lua +++ b/src/mudlet-lua/tests/GeyserMapper_spec.lua @@ -8,13 +8,14 @@ -- is the map widget rather than a mapper drawn into the main console: see the -- pending below for why the embedded form cannot be exercised in this suite. -- --- Opening the map widget is a one way door for the profile - Host::closeMapWidget --- only hides it - and busted runs its files in sorted order, so this file is --- now the first to open it, ahead of Mapper_spec.lua. That costs Mapper_spec's --- opening block its "registered before the widget was opened" premise; nothing --- there fails, but the deferred registration path it meant to cover is no --- longer reached from here on. Restoring it means moving that block into an --- earlier sorting file of its own. +-- Host::closeMapWidget() hides the dock widget and records the close, so the map +-- window functions answer as they do for a profile that never opened one; what +-- it does not do is destroy the dock. busted runs its files in sorted order, so +-- this file opens the widget ahead of Mapper_spec.lua and its opening block +-- therefore keeps its "there is no map widget" premise but loses its "registered +-- before the widget was opened" one. Nothing there fails, but the deferred +-- registration path that block meant to cover is no longer reached from here on. +-- Restoring it means moving it into an earlier sorting file of its own. -- Reports whether the map widget is currently on screen, without leaving it in -- a different state than it was found in. @@ -219,6 +220,47 @@ describe("Tests functionality of Geyser.Mapper", function() assert.are.equal("", mapper.titleText) end) + it("applies a title that was set while the mapper was hidden", function() + local mapper = track(Geyser.Mapper:new({name = "gmpHiddenTitle", x = 10, y = 20, width = 300, height = 200, embedded = false})) + mapper:hide() + -- the map widget is off screen, so setMapWindowTitle has nothing to retitle + assert.is_nil(mapper:setTitle("Named while hidden")) + assert.are.equal("Named while hidden", mapper.titleText) + mapper:show() + assert.are.equal("Named while hidden", getMapWindowTitle()) + end) + + it("applies a reset that was made while the mapper was hidden", function() + local mapper = track(Geyser.Mapper:new({ + name = "gmpHiddenReset", + x = 10, y = 20, width = 300, height = 200, + embedded = false, + titleText = "Named before hiding", + })) + mapper:hide() + assert.is_nil(mapper:resetTitle()) + assert.are.equal("", mapper.titleText) + mapper:show() + -- an empty titleText is a reset, not "no title to apply", so the map + -- window has to come back with its generated default rather than the + -- title it carried before the hide + local title = getMapWindowTitle() + assert.is_truthy(title:find(getProfileName(), 1, true)) + assert.are_not.equal("Named before hiding", title) + end) + + it("does not overwrite a directly set title when a mapper is shown", function() + local mapper = track(Geyser.Mapper:new({name = "gmpNoClobber", x = 10, y = 20, width = 300, height = 200, embedded = false})) + mapper:hide() + openMapWidget() + assert.is_true(setMapWindowTitle("Set without Geyser")) + mapper:show() + -- this mapper never had a title of its own, so showing it has nothing to + -- reapply and must leave the map window titled as it was found + assert.are.equal("Set without Geyser", getMapWindowTitle()) + resetMapWindowTitle() + end) + it("starts with an empty title when it was not given one", function() local mapper = track(Geyser.Mapper:new({name = "gmpNoTitle", x = 10, y = 20, width = 300, height = 200, embedded = false})) assert.are.equal("", mapper.titleText) diff --git a/src/mudlet-lua/tests/Mapper_spec.lua b/src/mudlet-lua/tests/Mapper_spec.lua index ff6a563cd..7ead97749 100644 --- a/src/mudlet-lua/tests/Mapper_spec.lua +++ b/src/mudlet-lua/tests/Mapper_spec.lua @@ -27,24 +27,20 @@ describe("Tests map events and menus before the map widget is opened", function( assert.is_nil(getMapMenus()["PreWidgetMenu"]) end) - -- nothing can destroy the map widget again once it exists, so a second - -- runTests in the same session inherits one and these two have nothing left - -- to observe + -- the dock widget itself outlives closeMapWidget(), but a closed one answers + -- the map window functions exactly as a never-opened profile does, so these + -- two reach the same branch whether or not an earlier file opened it it("should report that there is no map widget to read a title from", function() + closeMapWidget() local title, err = getMapWindowTitle() - if title then - pending("the map widget is already open in this session") - return - end + assert.is_nil(title) assert.are.equal("no floating/dockable type map window found", err) end) it("should report that there is no map widget to read a geometry from", function() + closeMapWidget() local x, err = getMapWidgetGeometry() - if x then - pending("the map widget is already open in this session") - return - end + assert.is_nil(x) assert.are.equal("no floating/dockable type map window found", err) end) @@ -1460,13 +1456,32 @@ describe("Tests mapper functions against a shared fixture", function() end) it("getRoomNameOffset keeps the sign of a negative shift", function() - -- BUG: setRoomNameOffset stores the offset as "x y", but - -- getRoomNameOffset reads it back with the pattern '[%.%d]+', which - -- cannot match a minus sign, so every negative shift comes back positive - pending("getRoomNameOffset drops the sign of a stored offset - see the Wave 3d report") setRoomNameOffset(rSandA, -3, -4) + assert.are.equal("-3 -4", getRoomUserData(rSandA, "room.ui_nameOffset")) assert.are.same({-3, -4}, {getRoomNameOffset(rSandA)}) end) + + it("getRoomNameOffset keeps the sign of a mixed pair", function() + setRoomNameOffset(rSandA, -3, 4) + assert.are.same({-3, 4}, {getRoomNameOffset(rSandA)}) + setRoomNameOffset(rSandA, 3, -4) + assert.are.same({3, -4}, {getRoomNameOffset(rSandA)}) + end) + + it("getRoomNameOffset keeps the sign of a lone negative y shift", function() + -- x == 0 makes setRoomNameOffset store the y shift on its own, which is + -- the one-value branch of the reader + setRoomNameOffset(rSandA, 0, -5) + assert.are.equal("-5", getRoomUserData(rSandA, "room.ui_nameOffset")) + assert.are.same({0, -5}, {getRoomNameOffset(rSandA)}) + end) + + it("getRoomNameOffset keeps the sign of a fractional offset", function() + -- T2DMap reads the same user data with QString::toDouble(), so the Lua + -- getter has to accept everything the renderer does + setRoomUserData(rSandA, "room.ui_nameOffset", "-1.5 -2.5") + assert.are.same({-1.5, -2.5}, {getRoomNameOffset(rSandA)}) + end) end) describe("Tests area user data", function() @@ -1804,6 +1819,103 @@ describe("Tests mapper functions against a shared fixture", function() end) +-- closeMapWidget() has to leave the profile in a state that is distinguishable +-- from "the map widget is open", or every map window function keeps answering +-- for a widget the script just put away. +-- +-- The map dock has no window name, so windowVisible() cannot reach it and these +-- specs read the state through the map window functions instead. That works +-- because Host::mapWidget() derives its answer from the dock's own hidden +-- state: drop the hide() out of Host::closeMapWidget() and the two specs below +-- that assert the closed answers fail. +describe("Tests the open and closed states of the map widget", function() + setup(function() + assert.is_true(openMapWidget()) + end) + + teardown(function() + -- back to a right-docked, open widget: the position loop below leaves it + -- docked at the bottom otherwise, which shrinks the main console for + -- everything that runs after this file + openMapWidget("r") + resetMapWindowTitle() + end) + + before_each(function() + openMapWidget() + end) + + -- companion guard rather than a guard for the bug: closeMapWidget() reported + -- "already closed" before this was fixed too. It is here so that a fix which + -- stopped distinguishing the two calls would be caught. + it("reports the widget as closed once, and as already closed after that", function() + assert.is_true(closeMapWidget()) + local closed, message = closeMapWidget() + assert.is_nil(closed) + assert.are.equal("map widget already closed", message) + end) + + it("stops setMapWindowTitle from retitling a widget that was closed", function() + assert.is_true(setMapWindowTitle("still open")) + assert.is_true(closeMapWidget()) + local set, message = setMapWindowTitle("closed already") + assert.is_nil(set) + assert.are.equal("no floating/dockable type map window found", message) + end) + + it("makes the map window getters agree with setMapWindowTitle", function() + assert.is_true(closeMapWidget()) + local title, titleMessage = getMapWindowTitle() + assert.is_nil(title) + local x, geometryMessage = getMapWidgetGeometry() + assert.is_nil(x) + -- same wording from all three, so a script can test one and trust the rest + assert.are.equal("no floating/dockable type map window found", titleMessage) + assert.are.equal("no floating/dockable type map window found", geometryMessage) + end) + + it("hands the widget back on reopen", function() + setMapWindowTitle("before the close") + assert.is_true(closeMapWidget()) + assert.is_true(openMapWidget()) + -- the same dock comes back rather than a fresh one, so its title survives + assert.are.equal("before the close", getMapWindowTitle()) + assert.are.equal(4, select("#", getMapWidgetGeometry())) + assert.is_true(setMapWindowTitle("after the reopen")) + assert.are.equal("after the reopen", getMapWindowTitle()) + end) + + it("reopens from every docking position", function() + for _, position in ipairs({"f", "l", "r", "t", "b"}) do + assert.is_true(closeMapWidget()) + assert.is_true(openMapWidget(position), "could not reopen the map widget at " .. position) + assert.is_string(getMapWindowTitle()) + end + end) + + -- moveMapWidget/resizeMapWidget are openMapWidget in disguise, so they reopen + -- a closed widget rather than failing the way the getters do. Pinned because + -- it is the one place where the map functions do not agree about the state. + it("lets moveMapWidget and resizeMapWidget reopen a closed widget", function() + assert.is_true(closeMapWidget()) + resizeMapWidget(640, 480) + local _, _, width, height = getMapWidgetGeometry() + assert.are.same({640, 480}, {width, height}) + + assert.is_true(closeMapWidget()) + moveMapWidget(120, 130) + assert.are.equal(4, select("#", getMapWidgetGeometry())) + end) + + -- Neither of these can be reached from Lua, so they are recorded rather than + -- covered: the dock's own title bar close button and mudlet's map toolbar + -- button both hide the same dock, and Host::mapWidget() reads the dock's + -- hidden state so that it follows them without either having to know. + pending("the map dock's title bar close button leaves the map window functions reporting no map window - needs GUI automation") + + pending("the map toolbar button handing the map to a main window dock leaves the map window functions reporting no map window - needs GUI automation") +end) + -- deleteMap wipes the whole map, so it lives in its own block that runs after -- the shared-fixture tests and builds its own throwaway rooms. describe("Tests deleteMap", function() diff --git a/src/mudlet-lua/tests/TableUtils_spec.lua b/src/mudlet-lua/tests/TableUtils_spec.lua index 14cd9aac0..0e871d866 100644 --- a/src/mudlet-lua/tests/TableUtils_spec.lua +++ b/src/mudlet-lua/tests/TableUtils_spec.lua @@ -105,9 +105,8 @@ describe("Tests TableUtils.lua functions", function() end) end) - -- __printTable is an internal helper of printTable and is not tested directly; - -- printTable, listPrint, listAdd and listRemove are covered near the end of - -- this file. + -- printTable, listPrint, __printTable, listAdd and listRemove are covered + -- near the end of this file. describe("Tests the functionality of table.size", function() @@ -952,6 +951,41 @@ describe("Tests TableUtils.lua functions", function() assert.spy(echo).was.called_with("key=alpha value=one\n") assert.spy(echo).was.called_with("key=beta value=two\n") end) + + it("should render a value that is neither a string nor a number", function() + local echo = spy.on(_G, "echo") + finally(function() echo:revert() end) + local nested = {} + printTable({ flag = true, nested = nested, fn = print }) + assert.spy(echo).was.called(5) + assert.spy(echo).was.called_with("key=flag value=true\n") + assert.spy(echo).was.called_with("key=nested value=" .. tostring(nested) .. "\n") + assert.spy(echo).was.called_with("key=fn value=" .. tostring(print) .. "\n") + end) + + it("should render a key that is neither a string nor a number", function() + local echo = spy.on(_G, "echo") + finally(function() echo:revert() end) + local key = {} + printTable({ [key] = "one", [true] = "two" }) + assert.spy(echo).was.called(4) + assert.spy(echo).was.called_with("key=" .. tostring(key) .. " value=one\n") + assert.spy(echo).was.called_with("key=true value=two\n") + end) + + it("should not raise on a table of mixed value types", function() + local echo = spy.on(_G, "echo") + finally(function() echo:revert() end) + assert.has_no.errors(function() printTable({ 1, "two", true, {}, print }) end) + assert.has_no.errors(function() printTable({}) end) + end) + + it("should name itself when it is not given a table", function() + assert.has_error(function() printTable(nil) end, + 'printTable: bad argument #1 type (table expected, got nil!)') + assert.has_error(function() listPrint("not a table") end, + 'listPrint: bad argument #1 type (table expected, got string!)') + end) end) describe("Tests the contract of listPrint", function() @@ -964,6 +998,16 @@ describe("Tests TableUtils.lua functions", function() assert.spy(echo).was.called_with("1. ) first\n") assert.spy(echo).was.called_with("2. ) second\n") end) + + it("should render entries that are neither strings nor numbers", function() + local echo = spy.on(_G, "echo") + finally(function() echo:revert() end) + local nested = {} + listPrint({ true, nested }) + assert.spy(echo).was.called(4) + assert.spy(echo).was.called_with("1. ) true\n") + assert.spy(echo).was.called_with("2. ) " .. tostring(nested) .. "\n") + end) end) describe("Tests the contract of __printTable", function() diff --git a/src/mudlet-lua/tests/UI_spec.lua b/src/mudlet-lua/tests/UI_spec.lua index a74f2afea..2343ca793 100644 --- a/src/mudlet-lua/tests/UI_spec.lua +++ b/src/mudlet-lua/tests/UI_spec.lua @@ -4389,8 +4389,7 @@ describe("Widget state getters", function() end) -- The "no map widget" error path for these two is covered in Mapper_spec, - -- which runs first and whose opening spec is the only point in the session - -- where the widget does not exist yet. + -- which runs first and reaches it by closing the widget. describe("map widget getters", function() setup(function() assert.is_true(openMapWidget()) From 6d0958a75abb22e232b14f4878ff5b8c558ec939 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Wed, 5 Aug 2026 19:55:03 +0200 Subject: [PATCH 093/155] Fix eight Geyser layout and container bugs (#9680) #### Brief overview of PR changes/additions - **Layout**: `HBox`/`VBox` lay themselves out again when a child leaves (delete, `remove`, `changeContainer`); a `ScrollBox` made inside a hidden container stays hidden instead of coming up on screen unhideable; `Geyser.UserWindow:show()` passes the `auto` flag on, so a container-hidden user window can be shown again. - **Lifetime and identity**: deleting a `Geyser.UserWindow` takes the `Container` root container Geyser made for it, which otherwise answers every layout pass with the main window's size; `Adjustable.Container`'s border registry no longer lets two same-named containers silently clobber each other's reservation; a user window that is going to float is no longer docked first, so its percentage constraints are measured against the whole main window. - **Gauge CSS**: `setGaugeWindow` honours `show = false`; the spacing parser reads unitless zeros, negative lengths, `!important`, longhands like `margin-left` and `border-width`, and upper case `PX`, stops at block braces and comments, no longer mistakes `qproperty-margin` for a margin, and says through `debugc` when a spacing has no pixel reading. #### Motivation for adding to Mudlet Each of these leaves a Geyser UI visibly wrong with no way for a script to put it right: a box with a permanent hole in it, a scroll box that cannot be hidden, a user window stuck off screen for the session, a gauge whose fill bar looks empty or broken, and orphaned containers that claim 100% x 100% in every layout pass. #### Other info (issues closed, discussion etc) Closes #9642 - setGaugeWindow ignores show = false and always shows the gauge Closes #9656 - Geyser gauge CSS spacing parser ignores unitless zeros, negative values and longhand properties Closes #9657 - Geyser HBox/VBox never re-organize when a child is removed Closes #9658 - Adjustable.Container:detach() unregisters by name, so same-named containers clobber each other Closes #9666 - Geyser.ScrollBox created in a hidden container comes up on screen and cannot be hidden Closes #9667 - Geyser.UserWindow:show() drops the auto flag, so a user window can get stuck hidden for good Closes #9668 - Deleting a Geyser.UserWindow leaks the Container root container Geyser made for it Closes #9669 - Geyser.UserWindow percentage constraints are measured against a main window its own dock just shrank Test case: `Geyser.HBox:new{name="b",x=0,y=0,width=600,height=50}` with three labels, then delete one - the survivors now split the box instead of leaving the last third empty. 47 new busted specs across seven spec files, each proven to fail without its fix; the full suite runs 2269 passing, 0 failures. Assisted-by: Claude:claude-opus-5 --- src/mudlet-lua/lua/GUIUtils.lua | 6 +- .../lua/geyser/GeyserAdjustableContainer.lua | 15 +- src/mudlet-lua/lua/geyser/GeyserContainer.lua | 3 + src/mudlet-lua/lua/geyser/GeyserGauge.lua | 226 ++++++++++++++---- src/mudlet-lua/lua/geyser/GeyserHBox.lua | 11 +- src/mudlet-lua/lua/geyser/GeyserScrollBox.lua | 7 + .../lua/geyser/GeyserUserWindow.lua | 35 ++- src/mudlet-lua/lua/geyser/GeyserVBox.lua | 11 +- src/mudlet-lua/tests/GUIUtils_spec.lua | 11 +- .../tests/GeyserAdjustableContainer_spec.lua | 83 +++++++ src/mudlet-lua/tests/GeyserGauge_spec.lua | 179 ++++++++++++++ src/mudlet-lua/tests/GeyserHBox_spec.lua | 63 +++++ src/mudlet-lua/tests/GeyserScrollBox_spec.lua | 50 +++- .../tests/GeyserUserWindow_spec.lua | 143 +++++++++-- src/mudlet-lua/tests/GeyserVBox_spec.lua | 63 +++++ 15 files changed, 815 insertions(+), 91 deletions(-) diff --git a/src/mudlet-lua/lua/GUIUtils.lua b/src/mudlet-lua/lua/GUIUtils.lua index 5aa6c0602..7c7633cab 100644 --- a/src/mudlet-lua/lua/GUIUtils.lua +++ b/src/mudlet-lua/lua/GUIUtils.lua @@ -332,7 +332,11 @@ function setGaugeWindow(windowName, gaugeName, x, y, show) windowName = windowName or "main" x = x or 0 y = y or 0 - show = show or true + -- `show or true` would turn an explicit false into true, since false is the + -- one value the `x or default` idiom cannot carry + if show == nil then + show = true + end assert(gaugesTable[gaugeName], "setGaugeWindow: no such gauge exists.") setWindow(windowName, gaugeName .. "_back", x, y, show) setWindow(windowName, gaugeName .. "_front", x, y, show) diff --git a/src/mudlet-lua/lua/geyser/GeyserAdjustableContainer.lua b/src/mudlet-lua/lua/geyser/GeyserAdjustableContainer.lua index 0dfa769cb..dee8c8fc4 100644 --- a/src/mudlet-lua/lua/geyser/GeyserAdjustableContainer.lua +++ b/src/mudlet-lua/lua/geyser/GeyserAdjustableContainer.lua @@ -409,6 +409,14 @@ end function Adjustable.Container:attachToBorder(border) if self.attached then self:detach() end Adjustable.Container.Attached[border] = Adjustable.Container.Attached[border] or {} + -- the registry is keyed by name, so a still live container of the same name + -- has to be taken off the border properly instead of being dropped from it: + -- it would otherwise go on believing it is attached while nothing reserves + -- a border for it, and its own detach() would then delete our entry + local superseded = Adjustable.Container.Attached[border][self.name] + if superseded and superseded ~= self then + superseded:detach() + end Adjustable.Container.Attached[border][self.name] = self self.attached = border self:adjustBorder() @@ -419,8 +427,11 @@ end --- detaches the given container -- this means the mudlet main window border will be reset function Adjustable.Container:detach() - if Adjustable.Container.Attached and Adjustable.Container.Attached[self.attached] then - Adjustable.Container.Attached[self.attached][self.name] = nil + -- a container of the same name may have taken over the registration, so + -- only unregister while it is still ours - the same guard type_delete uses + local attachedTo = Adjustable.Container.Attached and Adjustable.Container.Attached[self.attached] + if attachedTo and attachedTo[self.name] == self then + attachedTo[self.name] = nil end self.borderSize = nil self:resetBorder(self.attached) diff --git a/src/mudlet-lua/lua/geyser/GeyserContainer.lua b/src/mudlet-lua/lua/geyser/GeyserContainer.lua index 710eb5f01..9f3b88fc0 100644 --- a/src/mudlet-lua/lua/geyser/GeyserContainer.lua +++ b/src/mudlet-lua/lua/geyser/GeyserContainer.lua @@ -372,6 +372,9 @@ function Geyser.Container:new(cons, container) local w, h = getUserWindowSize(me.windowname) return h end + -- so the user window can take this container with it when it is deleted + -- without having to guess at the container by its name + me.rootContainer = container end end diff --git a/src/mudlet-lua/lua/geyser/GeyserGauge.lua b/src/mudlet-lua/lua/geyser/GeyserGauge.lua index 3aaba1b46..47062c186 100644 --- a/src/mudlet-lua/lua/geyser/GeyserGauge.lua +++ b/src/mudlet-lua/lua/geyser/GeyserGauge.lua @@ -21,50 +21,153 @@ Geyser.Gauge = Geyser.Container:new({ strict = false, orientation = "horizontal" }) ---- Helper function to extract spacing values (margin/border/padding) from CSS --- @param css The CSS string to parse --- @param property The property name to extract (e.g., "margin", "border", "padding") --- @return left, right, top, bottom spacing values in pixels, or 0 if not found -local function extractCSSSpacing(css, property) - if not css then return 0, 0, 0, 0 end - - -- Look for the property (e.g., "margin: 10px 30px;") - local pattern = property .. "%s*:%s*([^;]+)" - local value = css:match(pattern) - - if not value then return 0, 0, 0, 0 end - - -- Parse the values - CSS can have 1-4 values - local values = {} - for num in value:gmatch("(%d+%.?%d*)px") do - table.insert(values, tonumber(num)) +-- Reads one CSS token as a length in pixels. Qt reads a bare number as pixels +-- and a negative length is meaningful, so both are taken; a unit that has no +-- pixel value without knowing the font or the parent - em, %, pt - has none to +-- give here, and neither has a keyword such as "solid". +-- @param token The token to read +-- @return the length in pixels, or nil if the token is not a pixel length +local function pixelLength(token) + local number, unit = token:match("^([+-]?%d*%.?%d+)(.*)$") + if not number then + return nil end - - -- Handle border specially - extract width from "border: 2px solid color" - if property == "border" and #values == 0 then - local borderWidth = value:match("(%d+%.?%d*)px") - if borderWidth then - values = {tonumber(borderWidth)} + unit = unit:lower() + if unit ~= "" and unit ~= "px" then + return nil + end + return tonumber(number) +end + +-- Takes CSS comments out, so a commented out declaration is not read as a live +-- one. +-- @param css The CSS string to clean +-- @return the string without its comments +local function withoutComments(css) + return (css:gsub("/%*.-%*/", "")) +end + +-- Finds the value of a CSS declaration. The property has to start a word of its +-- own, or "qproperty-margin" would be read as a margin, and the value ends at a +-- block brace as well as at a semicolon, so an unterminated +-- "QLabel { margin: 4px }" does not carry the brace into the value. +-- Only the first declaration of a property is read, so a stylesheet that sets +-- one twice, or sets one inside a state block such as ":hover", is read from +-- whichever comes first rather than by the CSS cascade. +-- @param css The CSS string to search, with its comments already taken out +-- @param property The property name +-- @return the value, lower cased and trimmed, or nil +local function cssValue(css, property) + local value = css:match("%f[%w%-]" .. property:gsub("%-", "%%-") .. "%s*:%s*([^;{}]+)") + if not value then + return nil + end + -- "!important" marks the declaration's priority and is not part of its value. + -- Lower casing lets an upper case unit be read and costs nothing else: every + -- part of these values that is kept is a number or a unit. + value = value:lower():gsub("!%s*important", "") + return value:match("^%s*(.-)%s*$") +end + +-- Reads a one to four value CSS box shorthand into its four sides. +-- @param value The declaration value, or nil +-- @return top, right, bottom, left, or nil if any part of the value is not a +-- pixel length: half a shorthand is worse than none, because the +-- lengths that are left would be read in the wrong positions +local function boxShorthand(value) + if not value then + return nil + end + local lengths = {} + for token in value:gmatch("%S+") do + local length = pixelLength(token) + if not length then + return nil + end + lengths[#lengths + 1] = length + end + if #lengths == 0 or #lengths > 4 then + return nil + end + local top, right = lengths[1], lengths[2] or lengths[1] + return top, right, lengths[3] or top, lengths[4] or right +end + +-- Reads the width out of a CSS border shorthand such as "2px solid red", where +-- only the first length is a width and the rest describes the line. +-- @param value The declaration value, or nil +-- @return the width in pixels, or nil +local function borderWidth(value) + if not value then + return nil + end + for token in value:gmatch("%S+") do + local length = pixelLength(token) + if length then + return length end end - - if #values == 0 then - return 0, 0, 0, 0 - elseif #values == 1 then - -- All sides same - return values[1], values[1], values[1], values[1] - elseif #values == 2 then - -- top/bottom, left/right - return values[2], values[2], values[1], values[1] - elseif #values == 3 then - -- top, left/right, bottom - return values[2], values[2], values[1], values[3] - elseif #values == 4 then - -- top, right, bottom, left - return values[4], values[2], values[1], values[3] - else - return 0, 0, 0, 0 + return nil +end + +--- Helper function to extract spacing values (margin/border/padding) from CSS +-- Shorthands are read first and longhands over the top of them, so +-- "margin: 5px; margin-left: 20px" gives 20 on the left and 5 elsewhere. This +-- is not the CSS cascade: a longhand wins over a shorthand whichever order they +-- are written in. +-- @param css The CSS string to parse +-- @param property The property name to extract ("margin", "border" or "padding") +-- @return left, right, top, bottom spacing values in pixels, 0 for each side +-- the stylesheet says nothing measurable about, and the text of the +-- first declaration that held a length with no pixel reading +local function extractCSSSpacing(css, property) + if not css then return 0, 0, 0, 0 end + css = withoutComments(css) + local spacing = {top = 0, right = 0, bottom = 0, left = 0} + local border = property == "border" + local unreadable + + -- Reads one declaration. reportsUnreadable says whether a value the reader + -- could make nothing of is worth telling the user about: it is for a length, + -- and it is not for a border shorthand, where "border: none" legitimately + -- names no width at all. + local function read(declaration, reader, reportsUnreadable) + local value = cssValue(css, declaration) + if not value then + return nil + end + local first, right, bottom, left = reader(value) + if not first and reportsUnreadable then + unreadable = unreadable or (declaration .. ": " .. value) + end + return first, right, bottom, left end + + if border then + local width = read("border", borderWidth, false) + if width then + spacing.top, spacing.right, spacing.bottom, spacing.left = width, width, width, width + end + end + + local top, right, bottom, left = read(border and "border-width" or property, boxShorthand, true) + if top then + spacing.top, spacing.right, spacing.bottom, spacing.left = top, right, bottom, left + end + + for _, side in ipairs({"top", "right", "bottom", "left"}) do + local length + if border then + length = read("border-" .. side, borderWidth, false) or read("border-" .. side .. "-width", pixelLength, true) + else + length = read(property .. "-" .. side, pixelLength, true) + end + if length then + spacing[side] = length + end + end + + return spacing.left, spacing.right, spacing.top, spacing.bottom, unreadable end --- Sets the gauge amount. @@ -108,24 +211,39 @@ function Geyser.Gauge:setValue (currentValue, maxValue, text) local leftOffset, rightOffset, topOffset, bottomOffset = 0, 0, 0, 0 if self.backCSS then - local ml, mr, mt, mb = extractCSSSpacing(self.backCSS, "margin") - local bl, br, bt, bb = extractCSSSpacing(self.backCSS, "border") - local pl, pr, pt, pb = extractCSSSpacing(self.backCSS, "padding") - + local ml, mr, mt, mb, marginUnreadable = extractCSSSpacing(self.backCSS, "margin") + local bl, br, bt, bb, borderUnreadable = extractCSSSpacing(self.backCSS, "border") + local pl, pr, pt, pb, paddingUnreadable = extractCSSSpacing(self.backCSS, "padding") + leftOffset = ml + bl + pl rightOffset = mr + br + pr topOffset = mt + bt + pt bottomOffset = mb + bb + pb + + -- Qt still applies a spacing Geyser cannot measure, so the fill bar ends up + -- laid out against the wrong box and spills past the gauge's frame. Say so + -- rather than leave it looking like a Geyser bug - latched, because setValue + -- runs on every prompt. + local unreadable = marginUnreadable or borderUnreadable or paddingUnreadable + if unreadable and not self.warnedUnreadableCSS then + self.warnedUnreadableCSS = true + debugc(string.format( + "Geyser.Gauge: gauge '%s' has a stylesheet spacing Geyser cannot measure in pixels (%s), so it is left out of the fill bar's position - use px or unitless lengths", + self.name, unreadable)) + end end -- Update gauge in the requested orientation -- Note: We use function-based constraints for dynamic sizing that accounts for margins -- The front label can have its own borders and padding (margins are stripped in setStyleSheet) -- Qt applies border/padding outside the widget's content area, so we don't need to compensate for them - + -- The offsets are given as functions rather than as "px": a negative pixel + -- constraint is measured from the opposite edge, which is not what a negative + -- margin asks for + if self.orientation == "horizontal" then -- Position the front label inside the back's content area - self.front:move(leftOffset .. "px", topOffset .. "px") + self.front:move(function() return leftOffset end, function() return topOffset end) -- For width: we want value% of the CONTENT width (back label's content area) -- Content width = back_label_width - leftOffset - rightOffset local totalBackOffset = leftOffset + rightOffset @@ -141,7 +259,7 @@ function Geyser.Gauge:setValue (currentValue, maxValue, text) local totalBackOffset = topOffset + bottomOffset local gaugeValue = self.value self.front:move( - leftOffset .. "px", + function() return leftOffset end, function() return topOffset + math.floor((self.back.get_height() - totalBackOffset) * (1 - gaugeValue / 100) + 0.5) end ) self.front:resize( @@ -156,14 +274,14 @@ function Geyser.Gauge:setValue (currentValue, maxValue, text) local gaugeValue = self.value self.front:move( function() return leftOffset + math.floor((self.back.get_width() - totalBackOffset) * (1 - gaugeValue / 100) + 0.5) end, - topOffset .. "px" + function() return topOffset end ) self.front:resize( function() return math.floor((self.back.get_width() - totalBackOffset) * (gaugeValue / 100) + 0.5) end, function() return math.floor(self.back.get_height() - topOffset - bottomOffset + 0.5) end ) else -- batty (top to bottom) - self.front:move(leftOffset .. "px", topOffset .. "px") + self.front:move(function() return leftOffset end, function() return topOffset end) local totalBackOffset = topOffset + bottomOffset local gaugeValue = self.value self.front:resize( @@ -281,15 +399,23 @@ function Geyser.Gauge:setStyleSheet(css, cssback, cssText) self.frontCSS = css self.backCSS = cssback or css self.textCSS = cssText + self.warnedUnreadableCSS = nil -- Apply back stylesheet normally (this has margins/borders/padding) self.back:setStyleSheet(self.backCSS) -- For the front label, strip ONLY margins (borders and padding are safe and allow styling) -- Margins on the front label cause positioning issues, but borders/padding are fine + -- the trailing semicolon is optional: the last declaration in a stylesheet + -- usually carries none, and a margin left on the front label is applied on + -- top of the offset already worked out from the back label, doubling it. + -- The frontier keeps qproperty-margin, which is not a margin, out of it, and + -- the excluded braces and star stop a declaration that carries no semicolon + -- from eating the end of its block or of a comment, which would leave Qt an + -- unparseable sheet and the front label with no styling at all. local frontCSSStripped = css if frontCSSStripped then - frontCSSStripped = frontCSSStripped:gsub("%s*margin[^;]*;", "") + frontCSSStripped = frontCSSStripped:gsub("%s*%f[%w%-]margin[^;{}%*]*;?", "") end self.front:setStyleSheet(frontCSSStripped) diff --git a/src/mudlet-lua/lua/geyser/GeyserHBox.lua b/src/mudlet-lua/lua/geyser/GeyserHBox.lua index 4a6bb8391..02a24c812 100644 --- a/src/mudlet-lua/lua/geyser/GeyserHBox.lua +++ b/src/mudlet-lua/lua/geyser/GeyserHBox.lua @@ -38,8 +38,17 @@ function Geyser.HBox:add2 (window, cons, passAdd2, exclude) organizeOrDefer(self) end +-- The base remove only edits the bookkeeping, so without this the survivors +-- keep the geometry that was worked out for the old child count and the box is +-- left with a hole. Every removal path - delete, changeContainer, adding a +-- child to another container - comes through here. +function Geyser.HBox:remove (window) + Geyser.remove(self, window) + organizeOrDefer(self) +end + --- Responsible for organizing the elements inside the HBox --- Called when a new element is added +-- Called when an element is added or removed function Geyser.HBox:organize() local self_height = self:get_height() local self_width = self:get_width() diff --git a/src/mudlet-lua/lua/geyser/GeyserScrollBox.lua b/src/mudlet-lua/lua/geyser/GeyserScrollBox.lua index 7d3202c9c..9edac2f64 100644 --- a/src/mudlet-lua/lua/geyser/GeyserScrollBox.lua +++ b/src/mudlet-lua/lua/geyser/GeyserScrollBox.lua @@ -51,6 +51,13 @@ function Geyser.ScrollBox:new (cons, container) createScrollBox(me.windowname, me.name, me:get_x(), me:get_y(), me:get_width(), me:get_height()) + -- add2 asks a new widget to hide itself from inside Geyser.Container:new, + -- which runs before there is a widget to hide, so the hide has to be made + -- good here - as every other Geyser widget constructor does + if me.hidden or me.auto_hidden then + hideWindow(me.name) + end + --ScrollBox needs a special windowname handling as it by itself is a "window" --the given windowname will be saved to the parentWindowName variable me.parentWindowName = me.windowname diff --git a/src/mudlet-lua/lua/geyser/GeyserUserWindow.lua b/src/mudlet-lua/lua/geyser/GeyserUserWindow.lua index 0ea2e1a49..c48dcbe2d 100644 --- a/src/mudlet-lua/lua/geyser/GeyserUserWindow.lua +++ b/src/mudlet-lua/lua/geyser/GeyserUserWindow.lua @@ -49,8 +49,10 @@ function Geyser.UserWindow:resetWindow() end --Override show to keep the dimensions of the UserWindow -function Geyser.UserWindow:show() - self.Parent.show(self) +--@param auto passed on by a container showing its children, and used by the +-- base class to pick which of the two hidden flags to clear +function Geyser.UserWindow:show(auto) + self.Parent.show(self, auto) end --- Your UserWindow will be docked at position (pos): @@ -94,6 +96,30 @@ function Geyser.UserWindow:setStyleSheet(css) self.stylesheet = css end +--- Deletes the UserWindow, along with the root container Geyser made for it +function Geyser.UserWindow:type_delete() + local root = self.rootContainer + Geyser.MiniConsole.type_delete(self) + -- Geyser.Container:new gives every user window a "Container" root + -- container. Left behind it is not inert: its get_width/get_height ask + -- getUserWindowSize for a window that is gone, which answers with the main + -- window's size, so the orphan claims all of it in every layout pass. + -- Unregistering it rather than calling delete() on it keeps this safe when + -- the user window is being deleted by that very container. + if not root or not root.container then + return + end + if table.is_empty(root.windowList) then + root.container:remove(root) + else + -- anything else put in the root container by hand is still using it, so it + -- has to stay - but it measures a user window that is about to be gone + debugc(string.format( + "Geyser.UserWindow: the root container of '%s' still holds other objects, so it is being left in place - it will report the main window's size from now on, because the user window it measured has been deleted", + self.name)) + end +end + Geyser.UserWindow.Parent = Geyser.Window --- Geyser UserWindow constructor @@ -128,6 +154,11 @@ function Geyser.UserWindow:new(cons) if me.restoreLayout then openUserWindow(me.name, me.restoreLayout, me.autoDock) + elseif me.docked == false then + -- this window is floated a few lines further down anyway, and docking it + -- first takes the dock's size off the main window straight away - which is + -- what the percentage constraints below would then be resolved against + openUserWindow(me.name, me.restoreLayout, me.autoDock, "floating") else openUserWindow(me.name, me.restoreLayout, me.autoDock, me.dockPosition) end diff --git a/src/mudlet-lua/lua/geyser/GeyserVBox.lua b/src/mudlet-lua/lua/geyser/GeyserVBox.lua index ea4263fa5..26f7c0828 100644 --- a/src/mudlet-lua/lua/geyser/GeyserVBox.lua +++ b/src/mudlet-lua/lua/geyser/GeyserVBox.lua @@ -39,8 +39,17 @@ function Geyser.VBox:add2 (window, cons, passAdd2, exclude) organizeOrDefer(self) end +-- The base remove only edits the bookkeeping, so without this the survivors +-- keep the geometry that was worked out for the old child count and the box is +-- left with a hole. Every removal path - delete, changeContainer, adding a +-- child to another container - comes through here. +function Geyser.VBox:remove (window) + Geyser.remove(self, window) + organizeOrDefer(self) +end + --- Responsible for organizing the elements inside the VBox --- Called when a new element is added +-- Called when an element is added or removed function Geyser.VBox:organize() local self_height = self:get_height() local self_width = self:get_width() diff --git a/src/mudlet-lua/tests/GUIUtils_spec.lua b/src/mudlet-lua/tests/GUIUtils_spec.lua index fe3fe53cf..00c5a3b7f 100644 --- a/src/mudlet-lua/tests/GUIUtils_spec.lua +++ b/src/mudlet-lua/tests/GUIUtils_spec.lua @@ -1497,11 +1497,16 @@ describe("Tests the GUI utilities as far as possible without mudlet", function() end) it("Should keep the gauge hidden when show is passed as false", function() - -- BUG: setGaugeWindow does `show = show or true`, so an explicit false - -- is turned into true and the gauge is shown anyway - pending("setGaugeWindow cannot be told not to show the gauge - see the Wave 3d report") setGaugeWindow(userWindow, gaugeName, 0, 0, false) assert.is_false(windowVisible(gaugeName .. "_back")) + assert.is_false(windowVisible(gaugeName .. "_front")) + assert.is_false(windowVisible(gaugeName .. "_text")) + end) + + it("Should still show the gauge when show is left out", function() + hideGauge(gaugeName) + setGaugeWindow(userWindow, gaugeName, 0, 0) + assert.is_true(windowVisible(gaugeName .. "_back")) end) end) end) diff --git a/src/mudlet-lua/tests/GeyserAdjustableContainer_spec.lua b/src/mudlet-lua/tests/GeyserAdjustableContainer_spec.lua index c80571fe8..8061eda63 100644 --- a/src/mudlet-lua/tests/GeyserAdjustableContainer_spec.lua +++ b/src/mudlet-lua/tests/GeyserAdjustableContainer_spec.lua @@ -357,4 +357,87 @@ describe("Tests functionality of Adjustable.Container", function() other:delete() end) end) + + -- Adjustable.Container.Attached is keyed by container name, so two live + -- containers sharing a name land on the same key. resetBorder/adjustBorder + -- walk those entries to work out how much border to reserve, so a container + -- that is still attached but no longer registered loses its reservation and + -- the main console is drawn underneath it. + describe("Tests the functionality of Adjustable.Container:attachToBorder/detach", function() + local containers + local borderBefore + + local function make(name, width) + local container = Adjustable.Container:new({ + name = name, + x = 0, y = 0, width = width, height = 100, + autoLoad = false, + autoSave = false, + }) + containers[#containers + 1] = container + return container + end + + before_each(function() + containers = {} + borderBefore = getBorderLeft() + end) + + -- Deliberately same named containers share their children's names too, so + -- the one that still holds the registration is deleted first and takes the + -- widgets with it; the superseded one is then deleted for its own event + -- handlers and bookkeeping, which nothing else would clear. + after_each(function() + for index = #containers, 1, -1 do + local container = containers[index] + if container.attached then + container:detach() + end + container:delete() + end + containers = {} + setBorderLeft(borderBefore) + assert.is_nil(Adjustable.Container.Attached.left.gasAttachPlain) + assert.is_nil(Adjustable.Container.Attached.left.gasAttachName) + assert.is_nil(Adjustable.Container.Attached.left.gasDetachName) + end) + + it("reserves a border while attached and gives it back on detach", function() + local container = make("gasAttachPlain", 200) + container:attachToBorder("left") + assert.are.equal("left", container.attached) + assert.are.equal(container.borderSize, getBorderLeft()) + assert.are.equal(container, Adjustable.Container.Attached.left.gasAttachPlain) + container:detach() + assert.is_false(container.attached) + assert.is_nil(Adjustable.Container.Attached.left.gasAttachPlain) + assert.are.equal(0, getBorderLeft()) + end) + + it("detaches a same named container it takes the registration from", function() + local first = make("gasAttachName", 200) + local second = make("gasAttachName", 400) + first:attachToBorder("left") + assert.are.equal(first.borderSize, getBorderLeft()) + second:attachToBorder("left") + assert.are.equal(second, Adjustable.Container.Attached.left.gasAttachName) + assert.are.equal(second.borderSize, getBorderLeft()) + -- the superseded container must not be left believing it is attached + -- while nothing reserves a border for it any more + assert.is_false(first.attached) + assert.is_nil(first.borderSize) + end) + + it("leaves a same named container's reservation alone when a superseded one detaches", function() + local first = make("gasDetachName", 200) + local second = make("gasDetachName", 400) + first:attachToBorder("left") + second:attachToBorder("left") + local reserved = getBorderLeft() + first:detach() + assert.are.equal(second, Adjustable.Container.Attached.left.gasDetachName) + assert.are.equal("left", second.attached) + assert.are.equal(reserved, getBorderLeft()) + end) + end) end) diff --git a/src/mudlet-lua/tests/GeyserGauge_spec.lua b/src/mudlet-lua/tests/GeyserGauge_spec.lua index c1a54a2c7..d917c0fc3 100644 --- a/src/mudlet-lua/tests/GeyserGauge_spec.lua +++ b/src/mudlet-lua/tests/GeyserGauge_spec.lua @@ -194,6 +194,175 @@ describe("Tests functionality of Geyser.Gauge", function() assert.are.same({x = 6, y = 4, width = 188, height = 88}, geometry("ggsThreePadding_front")) end) + -- A unitless zero is the ordinary way to write "no margin on this axis". + -- Counting only the px tokens dropped it, so what is left reads as a + -- shorter shorthand and every component shifts. + it("counts a unitless zero as a margin value", function() + local gauge = track(Geyser.Gauge:new({name = "ggsZero", x = 0, y = 0, width = 200, height = 100})) + gauge:setStyleSheet("margin: 0 10px;", "margin: 0 10px;") + assert.are.same({x = 10, y = 0, width = 180, height = 100}, geometry("ggsZero_front")) + end) + + it("counts a unitless zero in a four value margin", function() + local gauge = track(Geyser.Gauge:new({name = "ggsZeroFour", x = 0, y = 0, width = 200, height = 100})) + gauge:setStyleSheet("margin: 10px 0 10px 0;", "margin: 10px 0 10px 0;") + assert.are.same({x = 0, y = 10, width = 200, height = 80}, geometry("ggsZeroFour_front")) + end) + + it("keeps the sign of a negative margin", function() + local gauge = track(Geyser.Gauge:new({name = "ggsNegative", x = 20, y = 20, width = 200, height = 100})) + gauge:setStyleSheet("margin: -5px;", "margin: -5px;") + assert.are.same({x = 15, y = 15, width = 210, height = 110}, geometry("ggsNegative_front")) + end) + + it("reads a margin longhand", function() + local gauge = track(Geyser.Gauge:new({name = "ggsLonghand", x = 0, y = 0, width = 200, height = 100})) + gauge:setStyleSheet("margin-left: 10px;", "margin-left: 10px;") + assert.are.same({x = 10, y = 0, width = 190, height = 100}, geometry("ggsLonghand_front")) + end) + + it("lets a margin longhand override the shorthand it follows", function() + local gauge = track(Geyser.Gauge:new({name = "ggsOverride", x = 0, y = 0, width = 200, height = 100})) + gauge:setStyleSheet("margin: 5px; margin-left: 20px;", "margin: 5px; margin-left: 20px;") + assert.are.same({x = 20, y = 5, width = 175, height = 90}, geometry("ggsOverride_front")) + end) + + it("reads a border-width longhand", function() + local gauge = track(Geyser.Gauge:new({name = "ggsBorderWidth", x = 0, y = 0, width = 200, height = 100})) + gauge:setStyleSheet("border-width: 2px;", "border-width: 2px;") + assert.are.same({x = 2, y = 2, width = 196, height = 96}, geometry("ggsBorderWidth_front")) + end) + + it("reads an upper case px unit", function() + local gauge = track(Geyser.Gauge:new({name = "ggsUpperCase", x = 0, y = 0, width = 200, height = 100})) + gauge:setStyleSheet("margin: 10PX;", "margin: 10PX;") + assert.are.same({x = 10, y = 10, width = 180, height = 80}, geometry("ggsUpperCase_front")) + end) + + -- em and % cannot be turned into pixels here, so the whole declaration is + -- left alone rather than half of it being read as zero + it("leaves a margin it cannot measure in pixels alone", function() + local gauge = track(Geyser.Gauge:new({name = "ggsEm", x = 0, y = 0, width = 200, height = 100})) + gauge:setStyleSheet("margin: 1em;", "margin: 1em;") + assert.are.same({x = 0, y = 0, width = 200, height = 100}, geometry("ggsEm_front")) + gauge:setStyleSheet("margin: 5% 10px;", "margin: 5% 10px;") + assert.are.same({x = 0, y = 0, width = 200, height = 100}, geometry("ggsEm_front")) + end) + + -- qproperty-margin is a Qt property, not a margin, and used to be picked up + -- by the unanchored property pattern - both when working out the offset and + -- when stripping margins off the front label, where it left "qproperty-" + -- behind and Qt threw the whole sheet out + it("does not read qproperty-margin as a margin", function() + local gauge = track(Geyser.Gauge:new({name = "ggsQProperty", x = 0, y = 0, width = 200, height = 100})) + gauge:setStyleSheet("qproperty-margin: 5px; color: red;", "qproperty-margin: 5px;") + assert.are.same({x = 0, y = 0, width = 200, height = 100}, geometry("ggsQProperty_front")) + assert.is_truthy(getLabelStyleSheet("ggsQProperty_front"):find("qproperty-margin: 5px;", 1, true)) + end) + + -- Qt takes !important on a declaration; it marks priority and is not one of + -- the box's sides + it("reads a margin that carries !important", function() + local gauge = track(Geyser.Gauge:new({name = "ggsImportant", x = 0, y = 0, width = 200, height = 100})) + gauge:setStyleSheet("margin: 10px !important;", "margin: 10px !important;") + assert.are.same({x = 10, y = 10, width = 180, height = 80}, geometry("ggsImportant_front")) + gauge:setStyleSheet("margin-left: 10px !important;", "margin-left: 10px !important;") + assert.are.same({x = 10, y = 0, width = 190, height = 100}, geometry("ggsImportant_front")) + end) + + -- a declaration written inside a selector block usually carries no + -- semicolon, and the closing brace is neither part of the value nor + -- something the front label's margin strip may swallow + it("reads a margin inside a selector block without wrecking the sheet", function() + local gauge = track(Geyser.Gauge:new({name = "ggsBlock", x = 0, y = 0, width = 200, height = 100})) + gauge:setStyleSheet("QLabel { background-color: red; margin: 4px }", "QLabel { background-color: blue; margin: 4px }") + assert.are.same({x = 4, y = 4, width = 192, height = 92}, geometry("ggsBlock_front")) + local front = getLabelStyleSheet("ggsBlock_front") + assert.is_nil(front:find("margin", 1, true)) + assert.is_truthy(front:find("background-color: red;", 1, true)) + assert.is_truthy(front:find("}", 1, true)) + end) + + it("does not read a commented out margin, and leaves the comment whole", function() + local gauge = track(Geyser.Gauge:new({name = "ggsComment", x = 0, y = 0, width = 200, height = 100})) + gauge:setStyleSheet("background-color: red; /* margin: 20px */ padding: 3px;", "background-color: blue; /* margin: 20px */ padding: 3px;") + assert.are.same({x = 3, y = 3, width = 194, height = 94}, geometry("ggsComment_front")) + local front = getLabelStyleSheet("ggsComment_front") + assert.is_truthy(front:find("background-color: red;", 1, true)) + assert.is_nil(front:find("20px", 1, true)) + -- whatever is left of the comment, it must still be closed + assert.are.equal(select(2, front:gsub("/%*", "")), select(2, front:gsub("%*/", ""))) + end) + + it("reads a length written without a leading digit", function() + local gauge = track(Geyser.Gauge:new({name = "ggsLeadingDot", x = 0, y = 0, width = 200, height = 100})) + gauge:setStyleSheet("margin: .5px;", "margin: .5px;") + -- .5px used to match the "5px" inside it and inset the gauge tenfold; half + -- a pixel each side comes off the size and rounds away on the position + assert.are.same({x = 0, y = 0, width = 199, height = 99}, geometry("ggsLeadingDot_front")) + end) + + it("reads border longhands", function() + local gauge = track(Geyser.Gauge:new({name = "ggsBorderLong", x = 0, y = 0, width = 200, height = 100})) + gauge:setStyleSheet("border-top: 3px solid red;", "border-top: 3px solid red;") + assert.are.same({x = 0, y = 3, width = 200, height = 97}, geometry("ggsBorderLong_front")) + gauge:setStyleSheet("border-left-width: 4px;", "border-left-width: 4px;") + assert.are.same({x = 4, y = 0, width = 196, height = 100}, geometry("ggsBorderLong_front")) + gauge:setStyleSheet("border-width: 1px 2px 3px 4px;", "border-width: 1px 2px 3px 4px;") + assert.are.same({x = 4, y = 1, width = 194, height = 96}, geometry("ggsBorderLong_front")) + end) + + it("reads a padding longhand", function() + local gauge = track(Geyser.Gauge:new({name = "ggsPaddingLong", x = 0, y = 0, width = 200, height = 100})) + gauge:setStyleSheet("padding-bottom: 7px;", "padding-bottom: 7px;") + assert.are.same({x = 0, y = 0, width = 200, height = 93}, geometry("ggsPaddingLong_front")) + end) + + -- the offsets reach the front label through a different branch per + -- orientation, and a negative one has to stay negative in each + it("keeps a negative margin in every orientation", function() + local expected = { + vertical = {x = 15, y = 15, width = 210, height = 110}, + goofy = {x = 15, y = 15, width = 210, height = 110}, + batty = {x = 15, y = 15, width = 210, height = 110}, + } + for orientation, geometryWanted in pairs(expected) do + local name = "ggsNegative" .. orientation + local gauge = track(Geyser.Gauge:new({name = name, x = 20, y = 20, width = 200, height = 100, orientation = orientation})) + gauge:setStyleSheet("margin: -5px;", "margin: -5px;") + gauge:setValue(100) + assert.are.same(geometryWanted, geometry(name .. "_front"), orientation .. " gauge") + end + end) + + -- Qt applies a spacing Geyser cannot measure, so the fill bar is laid out + -- against the wrong box: that has to be said rather than left looking like + -- a Geyser bug + it("says so when it cannot measure a spacing in pixels", function() + local debugMessage = spy.on(_G, "debugc") + finally(function() debugMessage:revert() end) + local gauge = track(Geyser.Gauge:new({name = "ggsUnreadable", x = 0, y = 0, width = 200, height = 100})) + gauge:setStyleSheet("margin: 1em;", "margin: 1em;") + assert.spy(debugMessage).was.called() + local said = debugMessage.calls[#debugMessage.calls].vals[1] + assert.is_truthy(said:find("ggsUnreadable", 1, true)) + assert.is_truthy(said:find("margin: 1em", 1, true)) + -- and it is latched, so a gauge updated every prompt does not flood + local saidOnce = #debugMessage.calls + gauge:setValue(50) + gauge:setValue(75) + assert.are.equal(saidOnce, #debugMessage.calls) + end) + + it("says nothing about an ordinary borderless stylesheet", function() + local debugMessage = spy.on(_G, "debugc") + finally(function() debugMessage:revert() end) + local gauge = track(Geyser.Gauge:new({name = "ggsQuiet", x = 0, y = 0, width = 200, height = 100})) + gauge:setStyleSheet("border: none; background-color: red; margin: 0;", "border: none; background-color: blue; margin: 0;") + assert.spy(debugMessage).was_not.called() + assert.are.same({x = 0, y = 0, width = 200, height = 100}, geometry("ggsQuiet_front")) + end) + it("reads a four value margin as top, right, bottom, left", function() local gauge = track(Geyser.Gauge:new({name = "ggsFourValue", x = 0, y = 0, width = 200, height = 100})) gauge:setStyleSheet("margin: 1px 2px 3px 4px;", "margin: 1px 2px 3px 4px;") @@ -228,6 +397,16 @@ describe("Tests functionality of Geyser.Gauge", function() assert.are.equal("margin: 5px; background-color: blue;", gauge.backCSS) end) + -- the last declaration in a stylesheet carries no semicolon, and a margin + -- left on the front label is applied on top of the offset computed from the + -- back label, doubling it + it("strips a margin that carries no trailing semicolon", function() + local gauge = track(Geyser.Gauge:new({name = "ggsNoSemicolon", x = 0, y = 0, width = 200, height = 40})) + gauge:setStyleSheet("background-color: red; margin: 5px", "margin: 5px;") + assert.is_nil(getLabelStyleSheet("ggsNoSemicolon_front"):find("margin", 1, true)) + assert.are.same({x = 5, y = 5, width = 190, height = 30}, geometry("ggsNoSemicolon_front")) + end) + it("uses the front stylesheet for the back when only one is given", function() local gauge = track(Geyser.Gauge:new({name = "ggsOneCss", x = 0, y = 0, width = 100, height = 20})) gauge:setStyleSheet("background-color: green;") diff --git a/src/mudlet-lua/tests/GeyserHBox_spec.lua b/src/mudlet-lua/tests/GeyserHBox_spec.lua index b0bd836fd..1529964cd 100644 --- a/src/mudlet-lua/tests/GeyserHBox_spec.lua +++ b/src/mudlet-lua/tests/GeyserHBox_spec.lua @@ -116,6 +116,69 @@ describe("Tests functionality of Geyser.HBox", function() end) end) + -- The box lays itself out when a child arrives, and has to do the same when + -- one leaves: without it the survivors keep the geometry computed for the old + -- child count and the box is left with a permanent hole. contains_fixed is + -- false for a box of plain labels, so reposition() does not heal it either. + describe("Geyser.HBox:remove", function() + local box + + before_each(function() + box = track(Geyser.HBox:new({name = "ghbShrink", x = 0, y = 0, width = 600, height = 50})) + track(Geyser.Label:new({name = "ghbShrinkA"}, box)) + track(Geyser.Label:new({name = "ghbShrinkB"}, box)) + end) + + it("re-splits the row when a child is deleted", function() + local third = track(Geyser.Label:new({name = "ghbShrinkC"}, box)) + third:delete() + assert.are.same({"ghbShrinkA", "ghbShrinkB"}, box.windows) + assert.are.same({x = 0, y = 0, width = 300, height = 50}, geometry("ghbShrinkA")) + assert.are.same({x = 300, y = 0, width = 300, height = 50}, geometry("ghbShrinkB")) + end) + + it("re-splits the row when a child is removed by hand", function() + box:remove(box.windowList.ghbShrinkB) + assert.are.same({"ghbShrinkA"}, box.windows) + assert.are.same({x = 0, y = 0, width = 600, height = 50}, geometry("ghbShrinkA")) + end) + + it("re-splits the row a child left for another container", function() + local elsewhere = track(Geyser.Container:new({name = "ghbElsewhere", x = 0, y = 100, width = 100, height = 100})) + box.windowList.ghbShrinkB:changeContainer(elsewhere) + assert.are.same({"ghbShrinkA"}, box.windows) + assert.are.same({x = 0, y = 0, width = 600, height = 50}, geometry("ghbShrinkA")) + end) + + -- an emptied box has no children to divide its width between, and organize() + -- still has to come through that without raising + it("survives losing its last child", function() + assert.has_no.errors(function() + box:remove(box.windowList.ghbShrinkA) + box:remove(box.windowList.ghbShrinkB) + end) + assert.are.same({}, box.windows) + end) + + it("holds the layout back while updates are deferred", function() + local third = track(Geyser.Label:new({name = "ghbShrinkDeferred"}, box)) + local widthOfThree = geometry("ghbShrinkA").width + box.defer_updates = true + third:delete() + assert.are.equal(widthOfThree, geometry("ghbShrinkA").width) + box.defer_updates = false + box:reposition() + assert.are.equal(300, geometry("ghbShrinkA").width) + end) + + it("deletes a box that still holds children", function() + assert.has_no.errors(function() box:delete() end) + assert.is_nil(getWindowGeometry("ghbShrinkA")) + assert.is_nil(getWindowGeometry("ghbShrinkB")) + assert.is_nil(Geyser.windowList.ghbShrink) + end) + end) + describe("Geyser.HBox:reposition", function() local box diff --git a/src/mudlet-lua/tests/GeyserScrollBox_spec.lua b/src/mudlet-lua/tests/GeyserScrollBox_spec.lua index 988e76bd3..a7f076f3f 100644 --- a/src/mudlet-lua/tests/GeyserScrollBox_spec.lua +++ b/src/mudlet-lua/tests/GeyserScrollBox_spec.lua @@ -178,13 +178,49 @@ describe("Tests functionality of Geyser.ScrollBox", function() end) -- Geyser:add2 runs from inside Geyser.Container:new, so the hide it asks for - -- lands before createScrollBox has made the widget. Every other Geyser widget - -- constructor hides itself again afterwards (GeyserCommandLine.lua:89, - -- GeyserMiniConsole.lua:605, GeyserLabel.lua:998, GeyserTextEdit.lua:70, - -- GeyserMapper.lua:133); Geyser.ScrollBox:new is the one that does not, so it - -- comes up on screen with auto_hidden already true. A Geyser.MiniConsole - -- built the same way stays hidden, which is the behaviour this asks for. - pending("Geyser.ScrollBox created in a hidden add2 container stays hidden - Geyser.ScrollBox:new never re-hides the widget it just created") + -- lands before createScrollBox has made the widget. Every Geyser widget + -- constructor therefore hides itself again afterwards + -- (GeyserCommandLine.lua:89, GeyserMiniConsole.lua:605, GeyserLabel.lua:998, + -- GeyserTextEdit.lua:70, GeyserMapper.lua:133), and a Geyser.MiniConsole + -- built the same way is the reference behaviour asserted alongside. + describe("Geyser.ScrollBox created in a hidden container", function() + it("stays off screen, and comes back when the container is shown", function() + local parent = track(Geyser.Container:new2({name = "gsbHiddenParent", x = 0, y = 0, width = 300, height = 200})) + parent:hide() + local scrollBox = track(Geyser.ScrollBox:new2({name = "gsbBornHidden", x = 0, y = 0, width = "100%", height = "50%"}, parent)) + local console = track(Geyser.MiniConsole:new2({name = "gsbBornHiddenConsole", x = 0, y = "50%", width = "100%", height = "50%"}, parent)) + assert.is_true(scrollBox.auto_hidden) + assert.is_true(console.auto_hidden) + assert.is_false(windowVisible("gsbBornHiddenConsole")) + assert.is_false(windowVisible("gsbBornHidden")) + parent:show() + assert.is_true(windowVisible("gsbBornHidden")) + assert.is_true(windowVisible("gsbBornHiddenConsole")) + end) + + -- a scroll box that came up on screen while its bookkeeping said hidden + -- could not be taken off it again: Geyser.Container:hide skips hide_impl + -- for anything that already believes itself hidden, so neither an explicit + -- hide nor another parent:hide() reached it + it("can be taken off screen by hand without being shown first", function() + local parent = track(Geyser.Container:new2({name = "gsbHideParent", x = 0, y = 0, width = 300, height = 200})) + parent:hide() + local scrollBox = track(Geyser.ScrollBox:new2({name = "gsbHideByHand", x = 0, y = 0, width = "100%", height = "100%"}, parent)) + scrollBox:hide() + assert.is_false(windowVisible("gsbHideByHand")) + parent:hide() + assert.is_false(windowVisible("gsbHideByHand")) + end) + + -- add2 carries a hidden constraint through as well as an inherited one + it("stays off screen when it was asked to start hidden", function() + local scrollBox = track(Geyser.ScrollBox:new2({name = "gsbBornHiddenFlag", x = 0, y = 0, width = 100, height = 100, hidden = true})) + assert.is_true(scrollBox.hidden) + assert.is_false(windowVisible("gsbBornHiddenFlag")) + scrollBox:show() + assert.is_true(windowVisible("gsbBornHiddenFlag")) + end) + end) describe("Geyser.ScrollBox scroll bars", function() -- A scroll box scrolls by being a QScrollArea (TScrollBox.h), not by being diff --git a/src/mudlet-lua/tests/GeyserUserWindow_spec.lua b/src/mudlet-lua/tests/GeyserUserWindow_spec.lua index 088f6f303..7bf1b8241 100644 --- a/src/mudlet-lua/tests/GeyserUserWindow_spec.lua +++ b/src/mudlet-lua/tests/GeyserUserWindow_spec.lua @@ -49,25 +49,12 @@ describe("Tests functionality of Geyser.UserWindow", function() created = {} end) - -- Deleting a user window leaves its "Container" root container behind - -- (see the pending below), so sweep those out by hand to keep repeat runs of - -- this file against the same profile identical. after_each(function() - local names = {} for _, object in ipairs(created) do - if object.type == "userwindow" then - names[#names + 1] = object.name .. "Container" - end if alive(object) then object:delete() end end - for _, name in ipairs(names) do - local orphan = Geyser.windowList[name] - if orphan then - orphan:delete() - end - end created = {} end) @@ -181,6 +168,37 @@ describe("Tests functionality of Geyser.UserWindow", function() assert.is_true(windowVisible("guwDocked")) end) + -- A window that is about to be floated must not be docked on the way there: + -- docking takes the dock's size off the main window, and the percentage + -- constraints the constructor resolves straight afterwards are measured + -- against the main window. Which dock position was asked for is what says + -- so; how much the main window shrinks by, and when, is Qt's business and + -- is not the same on every platform. + it("opens a window it is going to float as floating, not docked first", function() + local openWindow = spy.on(_G, "openUserWindow") + finally(function() openWindow:revert() end) + local mainWidth, mainHeight = getMainWindowSize() + track(Geyser.UserWindow:new({name = "guwPercent", x = "25%", y = "10%", width = "30%", height = "30%"})) + assert.spy(openWindow).was.called_with("guwPercent", false, true, "floating") + assert.are.same({ + x = math.floor(mainWidth * 0.25), + y = math.floor(mainHeight * 0.1), + width = math.floor(mainWidth * 0.3), + height = math.floor(mainHeight * 0.3), + }, geometry("guwPercent")) + end) + + it("still docks a window that was asked to start docked", function() + local openWindow = spy.on(_G, "openUserWindow") + finally(function() openWindow:revert() end) + local userWindow = track(Geyser.UserWindow:new({name = "guwStaysDocked", x = 10, y = 10, width = 300, height = 200, docked = true, dockPosition = "left"})) + assert.spy(openWindow).was.called_with("guwStaysDocked", false, true, "left") + -- a docked window keeps the position it was opened with, where a floated + -- one has its dockPosition rewritten to "floating" + assert.are.equal("left", userWindow.dockPosition) + assert.is_true(windowVisible("guwStaysDocked")) + end) + it("new2 marks the user window as using add2", function() local userWindow = track(Geyser.UserWindow:new2({name = "guwNew2", x = 10, y = 10, width = 200, height = 150})) assert.is_true(userWindow.useAdd2) @@ -308,12 +326,31 @@ describe("Tests functionality of Geyser.UserWindow", function() end) end) - -- Geyser.UserWindow:show() (GeyserUserWindow.lua:52) forwards to its parent - -- without the `auto` flag its container passes down, so an automatic show - -- clears self.hidden as if the user had asked for it. A user window hidden by - -- hand therefore reappears the moment its root container is shown, where a - -- Geyser.MiniConsole in the same position correctly stays hidden. - pending("Geyser.UserWindow stays hidden when its root container is shown - Geyser.UserWindow:show() drops the auto flag") + -- Geyser.UserWindow:show() forwards to its parent, and has to pass on the + -- `auto` flag its container hands down: the base class picks which of the two + -- hidden bits to clear from it. Without the flag an automatic show clears + -- self.hidden as if the user had asked for it, and never clears auto_hidden. + describe("Geyser.UserWindow show cascade", function() + it("stays hidden when its root container is shown after a hand hide", function() + local userWindow = track(Geyser.UserWindow:new({name = "guwHandHidden", x = 10, y = 20, width = 200, height = 150})) + userWindow:hide() + assert.is_true(userWindow.hidden) + assert.is_false(windowVisible("guwHandHidden")) + userWindow.container:show() + assert.is_true(userWindow.hidden) + assert.is_false(windowVisible("guwHandHidden")) + end) + + it("comes back when the container that hid it is shown again", function() + local userWindow = track(Geyser.UserWindow:new({name = "guwAutoHidden", x = 10, y = 20, width = 200, height = 150})) + userWindow.container:hide() + assert.is_true(userWindow.auto_hidden) + assert.is_false(windowVisible("guwAutoHidden")) + userWindow.container:show() + assert.is_false(userWindow.auto_hidden) + assert.is_true(windowVisible("guwAutoHidden")) + end) + end) describe("Geyser.UserWindow:setTitle/resetTitle", function() -- setUserWindowTitle answers nil and a message rather than raising when it @@ -388,9 +425,67 @@ describe("Tests functionality of Geyser.UserWindow", function() end) end) - -- Geyser.Container:new (GeyserContainer.lua:361) makes the "Container" - -- root container for a user window, but Geyser.Container:delete only unhooks - -- the user window from it, so the container is left registered in - -- Geyser.windowList and Geyser.windows for the rest of the session. - pending("deleting a Geyser.UserWindow also removes the root container it created") + -- Geyser.Container:new makes the "Container" root container for a user + -- window. An orphaned one is not inert: its get_width/get_height ask + -- getUserWindowSize for a window that is gone, which falls back to the main + -- window size, so every leftover claims the whole main window in every + -- layout pass. + describe("Geyser.UserWindow root container cleanup", function() + it("removes the root container it created", function() + local trackedWindows = #Geyser.windows + local userWindow = track(Geyser.UserWindow:new({name = "guwRootGone", x = 10, y = 20, width = 200, height = 150})) + assert.are.equal(userWindow.container, Geyser.windowList.guwRootGoneContainer) + userWindow:delete() + assert.is_nil(Geyser.windowList.guwRootGoneContainer) + assert.is_nil(table.index_of(Geyser.windows, "guwRootGoneContainer")) + assert.are.equal(trackedWindows, #Geyser.windows) + end) + + it("leaves nothing behind over repeated create and delete cycles", function() + local trackedWindows = #Geyser.windows + for index = 1, 5 do + Geyser.UserWindow:new({name = "guwCycle" .. index, x = 10, y = 20, width = 200, height = 150}):delete() + end + assert.are.equal(trackedWindows, #Geyser.windows) + end) + + -- anything else the user put in the root container is still using it, so it + -- has to survive the user window being deleted out of it + it("leaves a root container that still holds something else", function() + local userWindow = track(Geyser.UserWindow:new({name = "guwRootShared", x = 10, y = 20, width = 200, height = 150})) + local root = userWindow.container + local lodger = track(Geyser.Label:new({name = "guwRootLodger", x = 0, y = 0, width = 20, height = 20}, root)) + userWindow:delete() + assert.are.equal(root, Geyser.windowList.guwRootSharedContainer) + assert.are.equal(lodger, root.windowList.guwRootLodger) + root:delete() + assert.is_nil(Geyser.windowList.guwRootSharedContainer) + end) + + -- a user window moved out of the root container Geyser made for it still + -- has to take that container with it, and the container is no longer the + -- one the user window reports as its own + it("removes the root container even after the user window was moved out of it", function() + local elsewhere = track(Geyser.Container:new({name = "guwNewHome", x = 0, y = 0, width = 200, height = 200})) + local userWindow = track(Geyser.UserWindow:new({name = "guwMovedOut", x = 10, y = 20, width = 200, height = 150})) + userWindow:changeContainer(elsewhere) + assert.are.equal(elsewhere, userWindow.container) + userWindow:delete() + assert.is_nil(Geyser.windowList.guwMovedOutContainer) + end) + + -- deleting the root container deletes the user window inside it, which + -- reaches back for the root container it is being deleted by, so that + -- cascade has to come apart cleanly rather than recursing + it("comes apart cleanly when the root container is the one deleted", function() + local userWindow = track(Geyser.UserWindow:new({name = "guwRootKept", x = 10, y = 20, width = 200, height = 150})) + local root = userWindow.container + track(Geyser.Label:new({name = "guwRootKeptLabel", x = 0, y = 0, width = 20, height = 20}, userWindow)) + assert.are.equal(root, Geyser.windowList.guwRootKeptContainer) + root:delete() + assert.is_nil(Geyser.windowList.guwRootKeptContainer) + assert.is_nil(windowType("guwRootKept")) + assert.is_nil(windowType("guwRootKeptLabel")) + end) + end) end) diff --git a/src/mudlet-lua/tests/GeyserVBox_spec.lua b/src/mudlet-lua/tests/GeyserVBox_spec.lua index 13de26edc..6e08feb0a 100644 --- a/src/mudlet-lua/tests/GeyserVBox_spec.lua +++ b/src/mudlet-lua/tests/GeyserVBox_spec.lua @@ -128,6 +128,69 @@ describe("Tests functionality of Geyser.VBox", function() end) end) + -- The box lays itself out when a child arrives, and has to do the same when + -- one leaves: without it the survivors keep the geometry computed for the old + -- child count and the box is left with a permanent hole. contains_fixed is + -- false for a box of plain labels, so reposition() does not heal it either. + describe("Geyser.VBox:remove", function() + local box + + before_each(function() + box = track(Geyser.VBox:new({name = "gvbShrink", x = 0, y = 0, width = 50, height = 600})) + track(Geyser.Label:new({name = "gvbShrinkA"}, box)) + track(Geyser.Label:new({name = "gvbShrinkB"}, box)) + end) + + it("re-stacks the column when a child is deleted", function() + local third = track(Geyser.Label:new({name = "gvbShrinkC"}, box)) + third:delete() + assert.are.same({"gvbShrinkA", "gvbShrinkB"}, box.windows) + assert.are.same({x = 0, y = 0, width = 50, height = 300}, geometry("gvbShrinkA")) + assert.are.same({x = 0, y = 300, width = 50, height = 300}, geometry("gvbShrinkB")) + end) + + it("re-stacks the column when a child is removed by hand", function() + box:remove(box.windowList.gvbShrinkB) + assert.are.same({"gvbShrinkA"}, box.windows) + assert.are.same({x = 0, y = 0, width = 50, height = 600}, geometry("gvbShrinkA")) + end) + + it("re-stacks the column a child left for another container", function() + local elsewhere = track(Geyser.Container:new({name = "gvbElsewhere", x = 100, y = 0, width = 100, height = 100})) + box.windowList.gvbShrinkB:changeContainer(elsewhere) + assert.are.same({"gvbShrinkA"}, box.windows) + assert.are.same({x = 0, y = 0, width = 50, height = 600}, geometry("gvbShrinkA")) + end) + + -- an emptied box has no children to divide its height between, and + -- organize() still has to come through that without raising + it("survives losing its last child", function() + assert.has_no.errors(function() + box:remove(box.windowList.gvbShrinkA) + box:remove(box.windowList.gvbShrinkB) + end) + assert.are.same({}, box.windows) + end) + + it("holds the layout back while updates are deferred", function() + local third = track(Geyser.Label:new({name = "gvbShrinkDeferred"}, box)) + local heightOfThree = geometry("gvbShrinkA").height + box.defer_updates = true + third:delete() + assert.are.equal(heightOfThree, geometry("gvbShrinkA").height) + box.defer_updates = false + box:reposition() + assert.are.equal(300, geometry("gvbShrinkA").height) + end) + + it("deletes a box that still holds children", function() + assert.has_no.errors(function() box:delete() end) + assert.is_nil(getWindowGeometry("gvbShrinkA")) + assert.is_nil(getWindowGeometry("gvbShrinkB")) + assert.is_nil(Geyser.windowList.gvbShrink) + end) + end) + describe("Geyser.VBox:reposition", function() local box From d0fa11f23e2e66eefe25a895bbd5b4550f615a53 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Wed, 5 Aug 2026 19:55:28 +0200 Subject: [PATCH 094/155] Fix temporary trigger/alias/key/timer cleanup evicting same-named items (#9682) #### Brief overview of PR changes/additions - An expired trigger is deactivated before it is queued for deletion, so a nested `feedTriggers()` pass cannot fire it again while the deferred delete is still pending. - Deleting a temporary trigger, alias, key or timer unlinks only that item from the by-name lookup table instead of every item filed under the same name, and `killAlias()`/`killKey()`/`killTimer()` scan past a same-named item they cannot kill rather than report failure over it. - `AliasUnit` and `KeyUnit` gain the double-free guards `TriggerUnit` and `TimerUnit` already had; `stopAllNamedTriggers()` and `IDMgr:emergencyStop()` now stop named regex triggers too. #### Motivation for adding to Mudlet The four lookup tables are `QMultiMap`s, so names are not unique, but the temporary-item branch used the single-argument `remove(key)` and evicted live same-named items with it: a permanent trigger could stay alive yet become invisible to `enableTrigger()`, `killTrigger()` and `exists()` for the rest of the session. The kill-by-name asymmetry is the same defect one level up - a permanent item restored from the profile precedes this session's temporaries in the root node list, so it stranded the temporary behind it. #### Other info (issues closed, discussion etc) Closes #9646, closes #9648, closes #9649, closes #9650 Test case: `permRegexTrigger("Health", "", {"^permanent$"}, [[echo("permanent fired\n")]])`, then `tempComplexRegexTrigger("Health", "^temp$", [[]], 0,0,0,0,0,0,0,0,0,0)`, `killTrigger("Health")` and `feedTriggers("permanent\n")` - `exists("Health", "trigger")` still finds the permanent trigger. New coverage: `test/functional_tests/UnitDeferredDeleteTest.cpp` (17 cases across all four units) plus additions to `Trigger_spec.lua`, `Alias_spec.lua`, `KeyBinds_spec.lua` and `IDManager_spec.lua`, three of which were `pending()` markers for these bugs. Review turned up an adjacent defect deliberately **not** fixed here: expiry is accounted for after `execute()` runs, so a trigger whose *own* script re-feeds the matching line overshoots its `expireAfter`. Fixing that means moving the expiry accounting ahead of `execute()` while keeping the "return true to extend" contract, so it is left for a follow-up and recorded as a `pending()` spec in `Trigger_spec.lua`. Assisted-by: Claude:claude-opus-5 --- src/AliasUnit.cpp | 66 ++- src/KeyUnit.cpp | 66 ++- src/TTrigger.cpp | 9 + src/TimerUnit.cpp | 65 +- src/TimerUnit.h | 2 +- src/TriggerUnit.cpp | 25 +- src/mudlet-lua/lua/IDManager.lua | 9 +- src/mudlet-lua/tests/Alias_spec.lua | 37 ++ src/mudlet-lua/tests/IDManager_spec.lua | 40 +- src/mudlet-lua/tests/KeyBinds_spec.lua | 37 ++ src/mudlet-lua/tests/Trigger_spec.lua | 85 +++ test/functional_tests/CMakeLists.txt | 1 + .../UnitDeferredDeleteTest.cpp | 553 ++++++++++++++++++ 13 files changed, 878 insertions(+), 117 deletions(-) create mode 100644 test/functional_tests/UnitDeferredDeleteTest.cpp diff --git a/src/AliasUnit.cpp b/src/AliasUnit.cpp index 5e3879e9c..e77b111ec 100644 --- a/src/AliasUnit.cpp +++ b/src/AliasUnit.cpp @@ -89,6 +89,9 @@ void AliasUnit::uninstall(const QString& packageName) return; } for (auto& alias : uninstallList) { + // in case the alias was also queued for the markCleanup()/doCleanup() + // path - deleting it here would otherwise leave a dangling pointer there: + mCleanupSet.remove(alias); delete alias; } uninstallList.clear(); @@ -177,11 +180,12 @@ void AliasUnit::removeAliasRootNode(TAlias* pT) if (!pT) { return; } - if (!pT->isTemporary()) { - mLookupTable.remove(pT->mName, pT); - } else { - mLookupTable.remove(pT->getName()); - } + // Names are not unique - the lookup table is a QMultiMap - so drop this one + // alias' entry rather than every entry filed under the name. The + // single-argument remove() used to be taken for temporary aliases, which + // evicted live same-named aliases and left them unreachable by name for the + // rest of the session + mLookupTable.remove(pT->getName(), pT); mAliasMap.remove(pT->getID()); mAliasRootNodeList.remove(pT); } @@ -257,11 +261,8 @@ void AliasUnit::removeAlias(TAlias* pT) if (!pT) { return; } - if (!pT->isTemporary()) { - mLookupTable.remove(pT->mName, pT); - } else { - mLookupTable.remove(pT->getName()); - } + // see removeAliasRootNode(): one entry, not every same-named one + mLookupTable.remove(pT->getName(), pT); mAliasMap.remove(pT->getID()); } @@ -380,23 +381,27 @@ bool AliasUnit::disableAlias(const QString& name) bool AliasUnit::killAlias(const QString& name) { for (auto alias : mAliasRootNodeList) { - if (alias->getName() == name) { - // only temporary Aliases can be killed - if (!alias->isTemporary()) { - return false; - } - // An already killed alias is only unlinked from this list once - // doCleanup() gets to free it, which cannot happen while an alias - // script is on the call stack - so until then it is still findable by - // name. Killing it a second time achieves nothing and must be reported - // as the failure it is: - if (mCleanupSet.contains(alias)) { - return false; - } - alias->setIsActive(false); - markCleanup(alias); - return true; + if (alias->getName() != name) { + continue; } + // Names are not unique, so keep looking rather than give up on the first + // same-named alias that cannot be killed - a permanent alias loaded from + // the profile precedes this session's temporaries in this list, and + // reporting a failure over it would strand a killable alias + if (!alias->isTemporary()) { + // only temporary Aliases can be killed + continue; + } + // An already killed alias is only unlinked from this list once doCleanup() + // gets to free it, which cannot happen while an alias script is on the + // call stack - so until then it is still findable by name. Killing it a + // second time achieves nothing: + if (mCleanupSet.contains(alias)) { + continue; + } + alias->setIsActive(false); + markCleanup(alias); + return true; } return false; } @@ -441,17 +446,22 @@ void AliasUnit::doCleanup() return; } + QSet deletedAliases; QMutableSetIterator itAlias(mCleanupSet); while (itAlias.hasNext()) { auto pAlias = itAlias.next(); itAlias.remove(); + deletedAliases.insert(pAlias); delete pAlias; } // Flush the deletes uninstall() deferred (#9337). uninstallList is ordered // children-before-parents and each ~Tree unlinks from its parent, so deleting // children first empties the parent's child list (no double free); the seen - // set guards a node queued twice by re-entrant uninstalls. - QSet deletedAliases; + // set guards a node queued twice by re-entrant uninstalls and is shared with + // the mCleanupSet loop above so an object that ended up in both containers is + // freed once. It matches on pointer identity only: a node freed indirectly, as + // a child of a queued parent, is not in the set (not reachable today - only + // temporary root nodes are ever queued, and those have no children). for (auto alias : uninstallList) { if (!deletedAliases.contains(alias)) { deletedAliases.insert(alias); diff --git a/src/KeyUnit.cpp b/src/KeyUnit.cpp index 86c940fd4..cacee3b18 100644 --- a/src/KeyUnit.cpp +++ b/src/KeyUnit.cpp @@ -98,6 +98,9 @@ void KeyUnit::uninstall(const QString& packageName) return; } for (auto& key : uninstallList) { + // in case the key was also queued for the markCleanup()/doCleanup() + // path - deleting it here would otherwise leave a dangling pointer there: + mCleanupSet.remove(key); delete key; } uninstallList.clear(); @@ -228,23 +231,27 @@ bool KeyUnit::disableKey(const QString& name) bool KeyUnit::killKey(QString& name) { for (auto pChild : mKeyRootNodeList) { - if (pChild->getName() == name) { - // only temporary Keys can be killed - if (!pChild->isTemporary()) { - return false; - } - // An already killed key is only unlinked from this list once - // doCleanup() gets to free it, which cannot happen while a key script - // is on the call stack - so until then it is still findable by name. - // Killing it a second time achieves nothing and must be reported as - // the failure it is: - if (mCleanupSet.contains(pChild)) { - return false; - } - pChild->setIsActive(false); - markCleanup(pChild); - return true; + if (pChild->getName() != name) { + continue; } + // Names are not unique, so keep looking rather than give up on the first + // same-named key that cannot be killed - a permanent key loaded from the + // profile precedes this session's temporaries in this list, and reporting + // a failure over it would strand a killable key + if (!pChild->isTemporary()) { + // only temporary Keys can be killed + continue; + } + // An already killed key is only unlinked from this list once doCleanup() + // gets to free it, which cannot happen while a key script is on the call + // stack - so until then it is still findable by name. Killing it a second + // time achieves nothing: + if (mCleanupSet.contains(pChild)) { + continue; + } + pChild->setIsActive(false); + markCleanup(pChild); + return true; } return false; } @@ -324,11 +331,12 @@ void KeyUnit::removeKeyRootNode(TKey* pT) if (!pT) { return; } - if (!pT->isTemporary()) { - mLookupTable.remove(pT->getName(), pT); - } else { - mLookupTable.remove(pT->getName()); - } + // Names are not unique - the lookup table is a QMultiMap - so drop this one + // key's entry rather than every entry filed under the name. The + // single-argument remove() used to be taken for temporary keys, which evicted + // live same-named keys and left them unreachable by name for the rest of the + // session + mLookupTable.remove(pT->getName(), pT); mKeyMap.remove(pT->getID()); mKeyRootNodeList.remove(pT); } @@ -390,11 +398,8 @@ void KeyUnit::removeKey(TKey* pT) if (!pT) { return; } - if (!pT->isTemporary()) { - mLookupTable.remove(pT->getName(), pT); - } else { - mLookupTable.remove(pT->getName()); - } + // see removeKeyRootNode(): one entry, not every same-named one + mLookupTable.remove(pT->getName(), pT); mKeyMap.remove(pT->getID()); } @@ -477,17 +482,22 @@ void KeyUnit::doCleanup() return; } + QSet deletedKeys; QMutableSetIterator itKey(mCleanupSet); while (itKey.hasNext()) { auto pKey = itKey.next(); itKey.remove(); + deletedKeys.insert(pKey); delete pKey; } // Flush the deletes uninstall() deferred (#9337). uninstallList is ordered // children-before-parents and each ~Tree unlinks from its parent, so deleting // children first empties the parent's child list (no double free); the seen - // set guards a node queued twice by re-entrant uninstalls. - QSet deletedKeys; + // set guards a node queued twice by re-entrant uninstalls and is shared with + // the mCleanupSet loop above so an object that ended up in both containers is + // freed once. It matches on pointer identity only: a node freed indirectly, as + // a child of a queued parent, is not in the set (not reachable today - only + // temporary root nodes are ever queued, and those have no children). for (auto key : uninstallList) { if (!deletedKeys.contains(key)) { deletedKeys.insert(key); diff --git a/src/TTrigger.cpp b/src/TTrigger.cpp index 87d8a4a43..4ff502dbf 100644 --- a/src/TTrigger.cpp +++ b/src/TTrigger.cpp @@ -1098,6 +1098,15 @@ bool TTrigger::match(char* haystackC, const QString& haystack, int line, int pos mExpiryCount--; if (mExpiryCount == 0) { + // The delete is deferred until the outermost processDataStream() + // pass ends, so an expired trigger that is still active would fire + // again from any pass that re-enters in the meantime (a later + // trigger's script calling feedTriggers(), most commonly). + // setIsActive(false) rather than deactivate(), matching + // TriggerUnit::killTrigger(): it also clears the user-active state, + // so an enableTrigger() before the deferred free cannot resurrect a + // trigger that has already spent its last fire. + setIsActive(false); mpHost->getTriggerUnit()->markCleanup(this); if (mudlet::smDebugMode) { diff --git a/src/TimerUnit.cpp b/src/TimerUnit.cpp index fd6ecfa28..8715eca82 100644 --- a/src/TimerUnit.cpp +++ b/src/TimerUnit.cpp @@ -210,13 +210,13 @@ void TimerUnit::_removeTimerRootNode(TTimer* pT) if (!pT) { return; } - // temp timers do not need to check for names referring to multiple different - // objects as names=ID -> much faster tempTimer creation - if (!pT->isTemporary()) { - mLookupTable.remove(pT->mName, pT); - } else { - mLookupTable.remove(pT->getName()); - } + // Names are not unique - the lookup table is a QMultiMap - so drop this one + // timer's entry rather than every entry filed under the name. The + // single-argument remove() used to be taken for temporary timers on the + // grounds that their name is their id, but a permanent timer named after + // that id was evicted with it and left unreachable by name for the rest of + // the session + mLookupTable.remove(pT->getName(), pT); mTimerMap.remove(pT->getID()); mTimerRootNodeList.remove(pT); } @@ -296,13 +296,8 @@ void TimerUnit::_removeTimer(TTimer* pT) return; } - // temp timers do not need to check for names referring to multiple different - // objects as names=ID -> much faster tempTimer creation - if (!pT->isTemporary()) { - mLookupTable.remove(pT->mName, pT); - } else { - mLookupTable.remove(pT->getName()); - } + // see _removeTimerRootNode(): one entry, not every same-named one + mLookupTable.remove(pT->getName(), pT); mTimerMap.remove(pT->getID()); } @@ -397,23 +392,27 @@ std::vector TimerUnit::findItems(const QString& name, const bool exactMatch bool TimerUnit::killTimer(const QString& name) { for (auto timer : mTimerRootNodeList) { - if (timer->getName() == name) { - // only temporary timers can be killed - if (!timer->isTemporary()) { - return false; - } - // An already killed timer is only unlinked from this list once - // doCleanup() gets to free it, which cannot happen while a timer - // script is on the call stack - so until then it is still findable - // by name. Killing it a second time achieves nothing and must be - // reported as the failure it is: - if (mCleanupSet.contains(timer)) { - return false; - } - timer->killTimer(); - markCleanup(timer); - return true; + if (timer->getName() != name) { + continue; } + // Names are not unique, so keep looking rather than give up on the first + // same-named timer that cannot be killed - a permanent timer loaded from + // the profile precedes this session's temporaries in this list, and + // reporting a failure over it would strand a killable timer + if (!timer->isTemporary()) { + // only temporary timers can be killed + continue; + } + // An already killed timer is only unlinked from this list once doCleanup() + // gets to free it, which cannot happen while a timer script is on the call + // stack - so until then it is still findable by name. Killing it a second + // time achieves nothing: + if (mCleanupSet.contains(timer)) { + continue; + } + timer->killTimer(); + markCleanup(timer); + return true; } return false; } @@ -463,8 +462,10 @@ void TimerUnit::doCleanup() // children-before-parents and each ~Tree unlinks from its parent, so deleting // children first empties the parent's child list (no double free); the seen // set guards a node queued twice by re-entrant uninstalls and is shared with - // the mCleanupSet loop above so an object that somehow ended up in both - // containers cannot be freed twice. + // the mCleanupSet loop above so an object that ended up in both containers is + // freed once. It matches on pointer identity only: a node freed indirectly, as + // a child of a queued parent, is not in the set (not reachable today - only + // temporary root nodes are ever queued, and those have no children). for (auto timer : uninstallList) { if (!deletedTimers.contains(timer)) { deletedTimers.insert(timer); diff --git a/src/TimerUnit.h b/src/TimerUnit.h index 332a9eb5b..da6894403 100644 --- a/src/TimerUnit.h +++ b/src/TimerUnit.h @@ -90,6 +90,7 @@ public: QMultiMap mLookupTable; QList uninstallList; + QSet mCleanupSet; // This will contain all the QTimers associated with the TTimer instances // it is needed so that should mpHost be renamed we can update them to have @@ -114,7 +115,6 @@ private: std::list mTimerRootNodeList; int mMaxID = 0; bool mModuleMember = false; - QSet mCleanupSet; // > 0 whilst a TTimer::execute() is on the call stack; uninstall() and // doCleanup() must not delete timers then - see the note above the class: int mProcessingDepth = 0; diff --git a/src/TriggerUnit.cpp b/src/TriggerUnit.cpp index be75654f7..dfc82ccca 100644 --- a/src/TriggerUnit.cpp +++ b/src/TriggerUnit.cpp @@ -194,11 +194,13 @@ void TriggerUnit::removeTriggerRootNode(TTrigger* pT) if (!pT) { return; } - if (!pT->isTemporary()) { - mLookupTable.remove(pT->mName, pT); - } else { - mLookupTable.remove(pT->getName()); - } + // Names are not unique - the lookup table is a QMultiMap - so drop this one + // trigger's entry rather than every entry filed under the name. The + // single-argument remove() used to be taken for temporary triggers, which + // evicted live same-named triggers and left them unreachable by name for the + // rest of the session (tempComplexRegexTrigger() takes a user-supplied name, + // so a collision needs no coincidence) + mLookupTable.remove(pT->getName(), pT); mTriggerMap.remove(pT->getID()); mTriggerRootNodeList.remove(pT); // A node can be removed and deleted mid-pass without going through the @@ -274,11 +276,8 @@ void TriggerUnit::removeTrigger(TTrigger* pT) if (!pT) { return; } - if (!pT->isTemporary()) { - mLookupTable.remove(pT->mName, pT); - } else { - mLookupTable.remove(pT->getName()); - } + // see removeTriggerRootNode(): one entry, not every same-named one + mLookupTable.remove(pT->getName(), pT); mTriggerMap.remove(pT->getID()); } @@ -544,8 +543,10 @@ void TriggerUnit::doCleanup() // children-before-parents and each ~Tree unlinks from its parent, so deleting // children first empties the parent's child list (no double free); the seen // set guards a node queued twice by re-entrant uninstalls and is shared with - // the mCleanupSet loop above so an object that somehow ended up in both - // containers cannot be freed twice. + // the mCleanupSet loop above so an object that ended up in both containers is + // freed once. It matches on pointer identity only: a node freed indirectly, as + // a child of a queued parent, is not in the set (not reachable today - only + // temporary root nodes are ever queued, and those have no children). for (auto trigger : uninstallList) { if (!deletedTriggers.contains(trigger)) { deletedTriggers.insert(trigger); diff --git a/src/mudlet-lua/lua/IDManager.lua b/src/mudlet-lua/lua/IDManager.lua index 74be6af37..441310e4f 100644 --- a/src/mudlet-lua/lua/IDManager.lua +++ b/src/mudlet-lua/lua/IDManager.lua @@ -93,7 +93,12 @@ function IDMgr:stopAllTimers() end function IDMgr:stopAllTriggers() - return self:stopAll("triggers") + -- named triggers live in two stores - registerNamedTrigger() fills "triggers" + -- and registerNamedRegexTrigger() fills "regexTriggers" - so stopping them all + -- has to walk both, exactly as deleteAllTriggers() does + local regex = self:stopAll("regexTriggers") + local substring = self:stopAll("triggers") + return regex and substring end function IDMgr:deleteAllEvents() @@ -175,7 +180,7 @@ end function IDMgr:emergencyStop() self:stopAll("events") self:stopAll("timers") - self:stopAll("triggers") + self:stopAllTriggers() return true end diff --git a/src/mudlet-lua/tests/Alias_spec.lua b/src/mudlet-lua/tests/Alias_spec.lua index b093e7de1..c4e2494d5 100644 --- a/src/mudlet-lua/tests/Alias_spec.lua +++ b/src/mudlet-lua/tests/Alias_spec.lua @@ -326,5 +326,42 @@ describe("Alias processing", function() killAlias(id) end) + it("freeing a temporary alias leaves a same-named permanent one reachable", function() + -- tempAlias names its alias after its id, so a permanent alias called + -- after that number shares the name - and the name lookup table holds + -- several aliases per name + local tempId = tempAlias("^spec_evicted_temp$", [[]]) + local sharedName = tostring(tempId) + -- permanent aliases cannot be deleted from Lua, so earlier local runs + -- can leave same-named ones behind: work from a relative baseline + local before = exists(sharedName, "alias") + assert.is_true(permAlias(sharedName, "", "^spec_evicted_perm$", [[]]) > 0) + finally(function() disableAlias(sharedName) end) + assert.are.equal(before + 1, exists(sharedName, "alias")) + + assert.is_true(killAlias(tempId), "the temporary alias is the one that can be killed") + -- an incoming line runs every unit's deferred cleanup, which frees it + feedTriggers("\nspec_alias_eviction_flush\n") + + assert.are.equal(before, exists(sharedName, "alias"), "only the temporary alias should leave the lookup table") + assert.is_true(enableAlias(sharedName), "the permanent alias must still be reachable by name") + end) + + it("killAlias finds a temporary alias behind a same-named permanent one", function() + -- killAlias walks the root node list in creation order, so a permanent + -- alias restored from the profile sits in front of this session's + -- temporaries: it must be scanned past, not reported as a failure + local seed = tempAlias("^spec_kill_order_seed$", [[]]) + killAlias(seed) + -- permAlias itself takes seed + 1, so the next temporary takes seed + 2 + local sharedName = tostring(seed + 2) + assert.is_true(permAlias(sharedName, "", "^spec_kill_order_perm$", [[]]) > 0) + finally(function() disableAlias(sharedName) end) + + local tempId = tempAlias("^spec_kill_order_temp$", [[]]) + assert.are.equal(seed + 2, tempId, "ids should still be handed out in sequence") + assert.is_true(killAlias(tempId), "killAlias must scan past the permanent alias") + end) + end) end) diff --git a/src/mudlet-lua/tests/IDManager_spec.lua b/src/mudlet-lua/tests/IDManager_spec.lua index e3cfef6aa..89ac8d6bc 100644 --- a/src/mudlet-lua/tests/IDManager_spec.lua +++ b/src/mudlet-lua/tests/IDManager_spec.lua @@ -517,20 +517,32 @@ describe("Tests the functionality of IDMgr", function() end) it("Should stop regex named triggers too", function() - -- BUG: stopAllNamedTriggers reaches IDMgr:stopAllTriggers, which only - -- walks the substring store; regex named triggers keep firing. Compare - -- deleteAllNamedTriggers, which clears both stores. - pending("stopAllNamedTriggers ignores regex named triggers - see the Wave 3d report") _G.StopAllTrigFire = 0 registerNamedRegexTrigger(user, "re", "^stop_all_re$", function() _G.StopAllTrigFire = _G.StopAllTrigFire + 1 end) feedTriggers("\nstop_all_re\n") assert.is_true(_G.StopAllTrigFire >= 1) stopAllNamedTriggers(user) + -- killTrigger deactivates synchronously, so not one more fire is allowed + local atStop = _G.StopAllTrigFire feedTriggers("\nstop_all_re\n") - local afterFlush = _G.StopAllTrigFire feedTriggers("\nstop_all_re\n") - assert.is_equal(afterFlush, _G.StopAllTrigFire, "a stopped regex named trigger must not keep firing") + assert.is_equal(atStop, _G.StopAllTrigFire, "a stopped regex named trigger must not keep firing") + -- stopped, not deleted + assert.are.same({"re"}, getNamedTriggers(user)) + end) + + it("Should let a stopped regex named trigger be resumed", function() + _G.StopAllTrigFire = 0 + registerNamedRegexTrigger(user, "re", "^stop_all_resume_re$", function() _G.StopAllTrigFire = _G.StopAllTrigFire + 1 end) + stopAllNamedTriggers(user) + local atStop = _G.StopAllTrigFire + feedTriggers("\nstop_all_resume_re\n") + assert.is_equal(atStop, _G.StopAllTrigFire, "the regex named trigger should be stopped") + + assert.is_true(resumeNamedTrigger(user, "re"), "a stopped regex named trigger must be resumable") + feedTriggers("\nstop_all_resume_re\n") + assert.is_true(_G.StopAllTrigFire > atStop, "the resumed regex named trigger should fire again") end) it("Should raise an error if the userName is missing or wrong type", function() @@ -692,12 +704,13 @@ describe("Tests the functionality of IDMgr", function() end) it("Should stop regex triggers as well", function() - -- BUG: stopAllTriggers only calls stopAll("triggers"), so entries in - -- the regexTriggers store keep their live handlerID and keep firing - pending("IDMgr:stopAllTriggers ignores the regex store - see the Wave 3d report") + mgr:registerTrigger("sub", "private_mgr_stopall_sub", function() end) mgr:registerRegexTrigger("re", "^private_mgr_stopall_re$", function() end) - mgr:stopAllTriggers() + assert.is_true(mgr:stopAllTriggers()) assert.is_equal(-1, mgr.regexTriggers["re"].handlerID) + -- the substring store must not regress while the regex one is added + assert.is_equal(-1, mgr.triggers["sub"].handlerID) + assert.are.same({"re", "sub"}, mgr:getTriggers()) end) end) @@ -718,12 +731,11 @@ describe("Tests the functionality of IDMgr", function() end) it("Should stop regex triggers too", function() - -- BUG: emergencyStop shares IDMgr:stopAllTriggers' blind spot and never - -- touches the regexTriggers store, so those triggers survive it - pending("IDMgr:emergencyStop leaves regex triggers running - see the Wave 3d report") mgr:registerRegexTrigger("re", "^private_mgr_emergency_re$", function() end) - mgr:emergencyStop() + assert.is_true(mgr:emergencyStop()) assert.is_equal(-1, mgr.regexTriggers["re"].handlerID) + -- stopped, not deleted, so it can still be resumed + assert.are.same({"re"}, mgr:getTriggers()) end) end) end) diff --git a/src/mudlet-lua/tests/KeyBinds_spec.lua b/src/mudlet-lua/tests/KeyBinds_spec.lua index 00f6e64d4..cf24605ea 100644 --- a/src/mudlet-lua/tests/KeyBinds_spec.lua +++ b/src/mudlet-lua/tests/KeyBinds_spec.lua @@ -252,6 +252,43 @@ describe("Tests keybind-related functions", function() assert.are.equal(exists("SpecDupKeys", "keybind"), isActive("SpecDupKeys", "keybind"), "enabling by name must reactivate every duplicate") end) + it("freeing a temporary key leaves a same-named permanent one reachable", function() + -- tempKey names its key after its id, so a permanent key called after that + -- number shares the name - and the name lookup table holds several keys per + -- name + local tempId = tempKey(mudlet.key.F11, [[echo("x")]]) + local sharedName = tostring(tempId) + -- permanent keys cannot be deleted from Lua, so earlier local runs can leave + -- same-named ones behind: work from a relative baseline + local before = exists(sharedName, "keybind") + assert.is_true(permKey(sharedName, "", mudlet.key.F12, [[echo("x")]]) > 0) + finally(function() disableKey(sharedName) end) + assert.are.equal(before + 1, exists(sharedName, "keybind")) + + assert.is_true(killKey(tempId), "the temporary key is the one that can be killed") + -- an incoming line runs every unit's deferred cleanup, which frees it + feedTriggers("\nspec_key_eviction_flush\n") + + assert.are.equal(before, exists(sharedName, "keybind"), "only the temporary key should leave the lookup table") + assert.is_true(enableKey(sharedName), "the permanent key must still be reachable by name") + end) + + it("killKey finds a temporary key behind a same-named permanent one", function() + -- killKey walks the root node list in creation order, so a permanent key + -- restored from the profile sits in front of this session's temporaries: it + -- must be scanned past, not reported as a failure + local seed = tempKey(mudlet.key.F9, [[echo("x")]]) + killKey(seed) + -- permKey itself takes seed + 1, so the next temporary takes seed + 2 + local sharedName = tostring(seed + 2) + assert.is_true(permKey(sharedName, "", mudlet.key.F10, [[echo("x")]]) > 0) + finally(function() disableKey(sharedName) end) + + local tempId = tempKey(mudlet.key.F11, [[echo("x")]]) + assert.are.equal(seed + 2, tempId, "ids should still be handed out in sequence") + assert.is_true(killKey(tempId), "killKey must scan past the permanent key") + end) + end) end) diff --git a/src/mudlet-lua/tests/Trigger_spec.lua b/src/mudlet-lua/tests/Trigger_spec.lua index b01dfd728..4255dbca2 100644 --- a/src/mudlet-lua/tests/Trigger_spec.lua +++ b/src/mudlet-lua/tests/Trigger_spec.lua @@ -934,4 +934,89 @@ describe("Trigger processing", function() end) end) + + -- The delete of an expired or killed trigger is deferred until the outermost + -- processDataStream() pass ends, so everything between the queueing and the + -- free has to behave as if the trigger were already gone. + describe("deferred deletion", function() + + it("does not let an expired trigger fire again from a nested feed", function() + local fires = 0 + -- expireAfter = 1, so this must fire exactly once no matter how many + -- lines reach it + tempRegexTrigger("^expiry_reentry$", function() fires = fires + 1 end, 1) + + local nestedFed = false + local reentrantId = tempRegexTrigger("^expiry_reentry$", function() + if not nestedFed then + nestedFed = true + -- re-enters trigger processing while the expired trigger is + -- still queued for deletion + feedTriggers("\nexpiry_reentry\n") + end + end) + finally(function() killTrigger(reentrantId) end) + + feedTriggers("\nexpiry_reentry\n") + + assert.is_true(nestedFed, "the re-entrant trigger should have fed a nested line") + assert.are.equal(1, fires, "a trigger with expireAfter = 1 must not fire a second time") + end) + + it("does not let an expiring trigger fire again from its own nested feed", function() + -- A separate defect from the one above, found while fixing it: the + -- expiry count is decremented at the end of match(), after execute() + -- has run, so a trigger whose own script re-feeds the matching line is + -- still at its old count and still active when the nested pass reaches + -- it. Fixing that means moving the expiry accounting ahead of + -- execute(), which also has to keep the "return true to extend the + -- expiry" contract working - out of scope for the deactivate() fix. + pending("expiry is accounted after execute(), so a self-refeeding trigger overshoots expireAfter") + local fires = 0 + local nestedFed = false + tempRegexTrigger("^self_expiry_reentry$", function() + fires = fires + 1 + if not nestedFed then + nestedFed = true + feedTriggers("\nself_expiry_reentry\n") + end + end, 1) + + feedTriggers("\nself_expiry_reentry\n") + + assert.is_true(nestedFed) + assert.are.equal(1, fires, "a trigger with expireAfter = 1 must not fire a second time") + end) + + it("keeps a same-named permanent trigger in the lookup table", function() + local name = "Spec Name Eviction" + _G.NameEvictionSpec = 0 + finally(function() + disableTrigger(name) + _G.NameEvictionSpec = nil + end) + + -- permanent triggers cannot be deleted from Lua, so earlier local runs + -- leave same-named ones behind: work from a relative baseline + assert.is_true(permRegexTrigger(name, "", {"^name_eviction_perm$"}, [[_G.NameEvictionSpec = (_G.NameEvictionSpec or 0) + 1]]) > 0) + local permanents = exists(name, "trigger") + assert.is_true(permanents >= 1) + + -- tempComplexRegexTrigger is the one temporary-trigger API that takes a + -- user-supplied name, so sharing one with a permanent trigger is easy. + -- Note it copies the pattern list of the trigger it finds under that + -- name, so this temporary also carries ^name_eviction_perm$ - harmless + -- here, since it is killed before anything is fed + tempComplexRegexTrigger(name, "^name_eviction_temp$", [[]], 0, 0, 0, 0, 0, 0, 0, 0, 0, 0) + assert.are.equal(permanents + 1, exists(name, "trigger")) + + killTrigger(name) -- only the temporary one can be killed + feedTriggers("\nname_eviction_perm\n") -- the pass ends, flushing the deferred delete + + assert.are.equal(permanents, exists(name, "trigger"), "only the temporary trigger should leave the lookup table") + assert.is_true(_G.NameEvictionSpec >= 1, "the permanent trigger should still fire") + assert.is_true(disableTrigger(name), "the permanent trigger must still be reachable by name") + end) + + end) end) diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index 70ec0b6a0..e47057d36 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -22,6 +22,7 @@ set(FUNCTIONAL_TEST_SOURCES TDiscordModeTest.cpp MainConsoleSelectionTest.cpp EnableDisableByNameTest.cpp + UnitDeferredDeleteTest.cpp ColorTriggerFilterChildTest.cpp GMCPCharLoginTest.cpp InsertTextCapTest.cpp diff --git a/test/functional_tests/UnitDeferredDeleteTest.cpp b/test/functional_tests/UnitDeferredDeleteTest.cpp new file mode 100644 index 000000000..60ad34549 --- /dev/null +++ b/test/functional_tests/UnitDeferredDeleteTest.cpp @@ -0,0 +1,553 @@ +/*************************************************************************** + * Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +/* + * TriggerUnit, AliasUnit, KeyUnit and TimerUnit each defer the deletion of an + * item until no script is on the call stack. Two properties of that machinery + * are checked here for all four units: + * + * - freeing a temporary item must unlink only that item from the by-name lookup + * table, not every item filed under the same name (#9649). The lookup table is + * a QMultiMap and names are not unique + * - killing by name must keep scanning past same-named items it cannot kill, + * rather than report failure over the first one (#9649) + * - the two deferred-delete containers, mCleanupSet and uninstallList, must never + * free the same object twice, whichever order it lands in them (#9650) + * + * The timer half of #9649 cannot be reached from the busted Lua suite - that runs + * inside a tempTimer, so TimerUnit's cleanup stays deferred for the whole run - + * which is why it lives here. The trigger, alias and key halves are covered from + * Lua as well, in Trigger_spec.lua, Alias_spec.lua and KeyBinds_spec.lua. + * + * Note on the ...ContainersStayDisjoint cases: a regression there is a double + * free, which has no post-condition to read back - the assertions below hold + * either way and the run aborts instead. That is a real signal because the + * functional tests always build with the address sanitizer on non-Windows + * (test/functional_tests/CMakeLists.txt includes EnableSanitizers.cmake, whose + * USE_SANITIZER defaults to "address"), but it does mean these four cases carry + * no weight in a build with sanitizers switched off. The trigger and timer + * variants are pure regression guards: those two units already had the guards on + * development, and only AliasUnit and KeyUnit gain them here. + * + * Run with: ctest -R UnitDeferredDeleteTest -V + */ + +#include +#include + +#include "AliasUnit.h" +#include "Host.h" +#include "KeyUnit.h" +#include "MudletInstanceCoordinator.h" +#include "TAlias.h" +#include "TKey.h" +#include "TLuaInterpreter.h" +#include "TTimer.h" +#include "TTrigger.h" +#include "TelnetServerStub.h" +#include "TimerUnit.h" +#include "TriggerUnit.h" +#include "ctelnet.h" +#include "dlgConnectionProfiles.h" +#include "mudlet.h" + +using namespace std::chrono_literals; + +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); +void initializeQRCResourcesForUnitDeferredDeleteTest(); + +class UnitDeferredDeleteTest : public QObject +{ + Q_OBJECT + +private: + TelnetServerStub* mpServer = nullptr; + Host* mpHost = nullptr; + const QString mHostname = "UnitDeferredDelete-Test"; + QString mPort; // assigned the stub's actual ephemeral port in initTestCase() + const QString mLocalhost = "localhost"; + const QString mPackageName = "unit deferred delete package"; + + // QMultiMap::count() is a qsizetype; narrow it so QCOMPARE reports a plain + // number against the int literals below + static int lookupCount(qsizetype count) { return static_cast(count); } + +private slots: + void initTestCase() + { + initializeQRCResourcesForUnitDeferredDeleteTest(); + + mpServer = new TelnetServerStub(qApp); + mpServer->start(mLocalhost, 0); // ephemeral OS-assigned port avoids collisions across concurrent test runs + mPort = QString::number(mpServer->serverPort()); + mudlet::start(); + mudlet::self()->setupConfig(); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique("MudletInstanceCoordinator")); + mudlet::self()->init(); + mudlet::self()->setStorePasswordsSecurely(false); + deleteProfileDirectory(mHostname); + + startProfile(mHostname, mLocalhost, mPort); + mpHost = mudlet::self()->getActiveHost(); + QVERIFY2(mpHost, "No active host after profile creation"); + } + + void cleanupTestCase() + { + mpHost = nullptr; + delete mpServer; + mpServer = nullptr; + deleteProfileDirectory(mHostname); + delete mudlet::self(); + } + + // #9649: temporary items are named after their id, so a permanent item called + // after that number shares the name. tempComplexRegexTrigger() makes the + // trigger case even easier - it takes a user-supplied name - and that variant + // is covered from Lua in Trigger_spec.lua. + void test_triggerLookupKeepsSameNamedPermanent() + { + auto* unit = mpHost->getTriggerUnit(); + const int tempId = mpHost->mLuaInterpreter.startTempTrigger(qsl("lookup_evict_trigger_temp"), QString()); + QVERIFY(tempId > 0); + const QString sharedName = QString::number(tempId); + + const QStringList permPatterns{qsl("lookup_evict_trigger_perm")}; + auto [permId, message] = mpHost->mLuaInterpreter.startPermSubstringTrigger(sharedName, QString(), permPatterns, QString()); + QVERIFY2(permId > 0, qPrintable(message)); + QCOMPARE(lookupCount(unit->mLookupTable.count(sharedName)), 2); + + QVERIFY2(unit->killTrigger(sharedName), "the temporary trigger should be the one killed"); + unit->doCleanup(); + + QCOMPARE(lookupCount(unit->mLookupTable.count(sharedName)), 1); + QCOMPARE(unit->mLookupTable.value(sharedName), unit->getTrigger(permId)); + QVERIFY2(unit->enableTrigger(sharedName), "the permanent trigger must still be reachable by name"); + } + + void test_aliasLookupKeepsSameNamedPermanent() + { + auto* unit = mpHost->getAliasUnit(); + const int tempId = mpHost->mLuaInterpreter.startTempAlias(qsl("^lookup_evict_alias$"), QString()); + QVERIFY(tempId > 0); + const QString sharedName = QString::number(tempId); + + auto [permId, message] = mpHost->mLuaInterpreter.startPermAlias(sharedName, QString(), qsl("^lookup_evict_alias_perm$"), QString()); + QVERIFY2(permId > 0, qPrintable(message)); + QCOMPARE(lookupCount(unit->mLookupTable.count(sharedName)), 2); + + QVERIFY2(unit->killAlias(sharedName), "the temporary alias should be the one killed"); + unit->doCleanup(); + + QCOMPARE(lookupCount(unit->mLookupTable.count(sharedName)), 1); + QCOMPARE(unit->mLookupTable.value(sharedName), unit->getAlias(permId)); + QVERIFY2(unit->enableAlias(sharedName), "the permanent alias must still be reachable by name"); + } + + void test_timerLookupKeepsSameNamedPermanent() + { + auto* unit = mpHost->getTimerUnit(); + auto [tempId, tempMessage] = mpHost->mLuaInterpreter.startTempTimer(60.0, QString(), false); + QVERIFY2(tempId > 0, qPrintable(tempMessage)); + const QString sharedName = QString::number(tempId); + + auto [permId, message] = mpHost->mLuaInterpreter.startPermTimer(sharedName, QString(), 60.0, QString()); + QVERIFY2(permId > 0, qPrintable(message)); + QCOMPARE(lookupCount(unit->mLookupTable.count(sharedName)), 2); + + QVERIFY2(unit->killTimer(sharedName), "the temporary timer should be the one killed"); + unit->doCleanup(); + + QCOMPARE(lookupCount(unit->mLookupTable.count(sharedName)), 1); + QCOMPARE(unit->mLookupTable.value(sharedName), unit->getTimer(permId)); + QVERIFY2(unit->enableTimer(sharedName), "the permanent timer must still be reachable by name"); + } + + void test_keyLookupKeepsSameNamedPermanent() + { + auto* unit = mpHost->getKeyUnit(); + QString emptyScript; + int tempModifier = Qt::NoModifier; + int tempKeyCode = Qt::Key_F5; + const int tempId = mpHost->mLuaInterpreter.startTempKey(tempModifier, tempKeyCode, emptyScript); + QVERIFY(tempId > 0); + QString sharedName = QString::number(tempId); + + QString parent; + int permModifier = Qt::NoModifier; + int permKeyCode = Qt::Key_F6; + auto [permId, message] = mpHost->mLuaInterpreter.startPermKey(sharedName, parent, permKeyCode, permModifier, emptyScript); + QVERIFY2(permId > 0, qPrintable(message)); + QCOMPARE(lookupCount(unit->mLookupTable.count(sharedName)), 2); + + QVERIFY2(unit->killKey(sharedName), "the temporary key should be the one killed"); + unit->doCleanup(); + + QCOMPARE(lookupCount(unit->mLookupTable.count(sharedName)), 1); + QCOMPARE(unit->mLookupTable.value(sharedName), unit->getKey(permId)); + QVERIFY2(unit->enableKey(sharedName), "the permanent key must still be reachable by name"); + } + + // #9649, the kill-by-name half: killX(name) walks the root node list, which + // holds items in creation order, so a permanent item restored from the profile + // at startup precedes this session's temporaries. Giving up on the first + // same-named item that cannot be killed strands the killable one and reports a + // bare false. Each case below renames a freshly created permanent item to the + // id the next temporary will take, which is exactly the collision a saved + // profile produces; the QCOMPARE on the temporary's id makes the test fail + // loudly rather than silently stop testing anything if ids stop being handed + // out in sequence. + void test_triggerKillByNameScansPastPermanent() + { + auto* unit = mpHost->getTriggerUnit(); + const QStringList permPatterns{qsl("kill_order_trigger_perm")}; + auto [permId, message] = mpHost->mLuaInterpreter.startPermSubstringTrigger(qsl("kill order placeholder"), QString(), permPatterns, QString()); + QVERIFY2(permId > 0, qPrintable(message)); + const QString sharedName = QString::number(permId + 1); + unit->getTrigger(permId)->setName(sharedName); + + const int tempId = mpHost->mLuaInterpreter.startTempTrigger(qsl("kill_order_trigger_temp"), QString()); + QCOMPARE(tempId, permId + 1); + QCOMPARE(lookupCount(unit->mLookupTable.count(sharedName)), 2); + + QVERIFY2(unit->killTrigger(sharedName), "killTrigger must scan past the permanent trigger to the temporary one"); + unit->doCleanup(); + QVERIFY2(!unit->getTrigger(tempId), "the temporary trigger should have been freed"); + QVERIFY(unit->getTrigger(permId)); + } + + void test_aliasKillByNameScansPastPermanent() + { + auto* unit = mpHost->getAliasUnit(); + auto [permId, message] = mpHost->mLuaInterpreter.startPermAlias(qsl("kill order placeholder"), QString(), qsl("^kill_order_alias_perm$"), QString()); + QVERIFY2(permId > 0, qPrintable(message)); + const QString sharedName = QString::number(permId + 1); + unit->getAlias(permId)->setName(sharedName); + + const int tempId = mpHost->mLuaInterpreter.startTempAlias(qsl("^kill_order_alias_temp$"), QString()); + QCOMPARE(tempId, permId + 1); + QCOMPARE(lookupCount(unit->mLookupTable.count(sharedName)), 2); + + QVERIFY2(unit->killAlias(sharedName), "killAlias must scan past the permanent alias to the temporary one"); + unit->doCleanup(); + QVERIFY2(!unit->getAlias(tempId), "the temporary alias should have been freed"); + QVERIFY(unit->getAlias(permId)); + } + + void test_timerKillByNameScansPastPermanent() + { + auto* unit = mpHost->getTimerUnit(); + auto [permId, message] = mpHost->mLuaInterpreter.startPermTimer(qsl("kill order placeholder"), QString(), 60.0, QString()); + QVERIFY2(permId > 0, qPrintable(message)); + const QString sharedName = QString::number(permId + 1); + unit->getTimer(permId)->setName(sharedName); + + auto [tempId, tempMessage] = mpHost->mLuaInterpreter.startTempTimer(60.0, QString(), false); + QVERIFY2(tempId > 0, qPrintable(tempMessage)); + QCOMPARE(tempId, permId + 1); + QCOMPARE(lookupCount(unit->mLookupTable.count(sharedName)), 2); + + QVERIFY2(unit->killTimer(sharedName), "killTimer must scan past the permanent timer to the temporary one"); + unit->doCleanup(); + QVERIFY2(!unit->getTimer(tempId), "the temporary timer should have been freed"); + QVERIFY(unit->getTimer(permId)); + } + + void test_keyKillByNameScansPastPermanent() + { + auto* unit = mpHost->getKeyUnit(); + QString emptyScript; + QString parent; + QString placeholder = qsl("kill order placeholder"); + int permModifier = Qt::NoModifier; + int permKeyCode = Qt::Key_F7; + auto [permId, message] = mpHost->mLuaInterpreter.startPermKey(placeholder, parent, permKeyCode, permModifier, emptyScript); + QVERIFY2(permId > 0, qPrintable(message)); + QString sharedName = QString::number(permId + 1); + unit->getKey(permId)->setName(sharedName); + + int tempModifier = Qt::NoModifier; + int tempKeyCode = Qt::Key_F8; + const int tempId = mpHost->mLuaInterpreter.startTempKey(tempModifier, tempKeyCode, emptyScript); + QCOMPARE(tempId, permId + 1); + QCOMPARE(lookupCount(unit->mLookupTable.count(sharedName)), 2); + + QVERIFY2(unit->killKey(sharedName), "killKey must scan past the permanent key to the temporary one"); + unit->doCleanup(); + QVERIFY2(!unit->getKey(tempId), "the temporary key should have been freed"); + QVERIFY(unit->getKey(permId)); + } + + // #9649 again, on the non-root removal path: a temporary child goes through + // removeTrigger() rather than removeTriggerRootNode(), and both got the same + // exact-match fix. + void test_temporaryChildTriggerLeavesSameNamedSiblingAlone() + { + auto* unit = mpHost->getTriggerUnit(); + const QStringList parentPatterns{qsl("child_evict_parent")}; + auto [parentId, message] = mpHost->mLuaInterpreter.startPermSubstringTrigger(qsl("Child Eviction Parent"), QString(), parentPatterns, QString()); + QVERIFY2(parentId > 0, qPrintable(message)); + auto* pParent = unit->getTrigger(parentId); + QVERIFY(pParent); + + const QString sharedName = qsl("Child Eviction Shared"); + const QStringList childPatterns{qsl("child_evict_perm")}; + auto [permChildId, childMessage] = mpHost->mLuaInterpreter.startPermSubstringTrigger(sharedName, qsl("Child Eviction Parent"), childPatterns, QString()); + QVERIFY2(permChildId > 0, qPrintable(childMessage)); + + auto* pTempChild = new TTrigger(pParent, mpHost); + pTempChild->setRegexCodeList(QStringList{qsl("child_evict_temp")}, QList{REGEX_SUBSTRING}); + pTempChild->setIsFolder(false); + pTempChild->setIsActive(true); + pTempChild->setTemporary(true); + pTempChild->registerTrigger(); + pTempChild->setName(sharedName); + QCOMPARE(lookupCount(unit->mLookupTable.count(sharedName)), 2); + + QVERIFY2(unit->killTrigger(sharedName), "the temporary child should be the one killed"); + unit->doCleanup(); + + QCOMPARE(lookupCount(unit->mLookupTable.count(sharedName)), 1); + QCOMPARE(unit->mLookupTable.value(sharedName), unit->getTrigger(permChildId)); + } + + // #9650: an item can be queued in mCleanupSet and in uninstallList at the same + // time - uninstall() at a non-zero processing depth leaves its items in + // uninstallList and drops them from mCleanupSet, and a script killing one of + // them afterwards puts it back. doCleanup() has to free such an item exactly + // once. Both containers are populated directly here because reaching the + // overlap from Lua needs a package-owned temporary item, which no current + // import path produces. + void test_triggerDeferredDeleteContainersStayDisjoint() + { + auto* unit = mpHost->getTriggerUnit(); + const int id = mpHost->mLuaInterpreter.startTempTrigger(qsl("double_free_trigger"), QString(), -1); + QVERIFY(id > 0); + auto* pTrigger = unit->getTrigger(id); + QVERIFY(pTrigger); + + unit->uninstallList.append(pTrigger); + unit->markCleanup(pTrigger); + unit->doCleanup(); + + QVERIFY(unit->mCleanupSet.isEmpty()); + QVERIFY(unit->uninstallList.isEmpty()); + QVERIFY2(!unit->getTrigger(id), "the trigger should have been freed exactly once"); + } + + // #9650: uninstall() at depth 0 deletes straight away, so it also has to drop + // the item from mCleanupSet - otherwise the next doCleanup() frees a dangling + // pointer. + void test_triggerUninstallAtDepthZeroClearsCleanupSet() + { + auto* unit = mpHost->getTriggerUnit(); + const int id = mpHost->mLuaInterpreter.startTempTrigger(qsl("uninstall_trigger"), QString(), -1); + QVERIFY(id > 0); + auto* pTrigger = unit->getTrigger(id); + QVERIFY(pTrigger); + pTrigger->mPackageName = mPackageName; + + unit->markCleanup(pTrigger); + unit->uninstall(mPackageName); + + // pTrigger is freed by now, so read the set's size rather than look the + // dangling pointer up in it + QVERIFY2(unit->mCleanupSet.isEmpty(), "uninstall() must take the trigger it freed out of the cleanup set"); + unit->doCleanup(); + QVERIFY2(!unit->getTrigger(id), "the trigger should have been freed exactly once"); + } + + void test_aliasDeferredDeleteContainersStayDisjoint() + { + auto* unit = mpHost->getAliasUnit(); + const int id = mpHost->mLuaInterpreter.startTempAlias(qsl("^double_free_alias$"), QString()); + QVERIFY(id > 0); + auto* pAlias = unit->getAlias(id); + QVERIFY(pAlias); + + unit->uninstallList.append(pAlias); + unit->markCleanup(pAlias); + unit->doCleanup(); + + QVERIFY(unit->mCleanupSet.isEmpty()); + QVERIFY(unit->uninstallList.isEmpty()); + QVERIFY2(!unit->getAlias(id), "the alias should have been freed exactly once"); + } + + void test_aliasUninstallAtDepthZeroClearsCleanupSet() + { + auto* unit = mpHost->getAliasUnit(); + const int id = mpHost->mLuaInterpreter.startTempAlias(qsl("^uninstall_alias$"), QString()); + QVERIFY(id > 0); + auto* pAlias = unit->getAlias(id); + QVERIFY(pAlias); + pAlias->mPackageName = mPackageName; + + unit->markCleanup(pAlias); + unit->uninstall(mPackageName); + + QVERIFY2(unit->mCleanupSet.isEmpty(), "uninstall() must take the alias it freed out of the cleanup set"); + unit->doCleanup(); + QVERIFY2(!unit->getAlias(id), "the alias should have been freed exactly once"); + } + + void test_timerDeferredDeleteContainersStayDisjoint() + { + auto* unit = mpHost->getTimerUnit(); + auto [id, message] = mpHost->mLuaInterpreter.startTempTimer(60.0, QString(), false); + QVERIFY2(id > 0, qPrintable(message)); + auto* pTimer = unit->getTimer(id); + QVERIFY(pTimer); + + unit->uninstallList.append(pTimer); + unit->markCleanup(pTimer); + unit->doCleanup(); + + QVERIFY(unit->mCleanupSet.isEmpty()); + QVERIFY(unit->uninstallList.isEmpty()); + QVERIFY2(!unit->getTimer(id), "the timer should have been freed exactly once"); + } + + void test_timerUninstallAtDepthZeroClearsCleanupSet() + { + auto* unit = mpHost->getTimerUnit(); + auto [id, message] = mpHost->mLuaInterpreter.startTempTimer(60.0, QString(), false); + QVERIFY2(id > 0, qPrintable(message)); + auto* pTimer = unit->getTimer(id); + QVERIFY(pTimer); + pTimer->mPackageName = mPackageName; + + unit->markCleanup(pTimer); + unit->uninstall(mPackageName); + + QVERIFY2(unit->mCleanupSet.isEmpty(), "uninstall() must take the timer it freed out of the cleanup set"); + unit->doCleanup(); + QVERIFY2(!unit->getTimer(id), "the timer should have been freed exactly once"); + } + + void test_keyDeferredDeleteContainersStayDisjoint() + { + auto* unit = mpHost->getKeyUnit(); + QString emptyScript; + int modifier = Qt::NoModifier; + int keyCode = Qt::Key_F10; + const int id = mpHost->mLuaInterpreter.startTempKey(modifier, keyCode, emptyScript); + QVERIFY(id > 0); + auto* pKey = unit->getKey(id); + QVERIFY(pKey); + + unit->uninstallList.append(pKey); + unit->markCleanup(pKey); + unit->doCleanup(); + + QVERIFY(unit->mCleanupSet.isEmpty()); + QVERIFY(unit->uninstallList.isEmpty()); + QVERIFY2(!unit->getKey(id), "the key should have been freed exactly once"); + } + + void test_keyUninstallAtDepthZeroClearsCleanupSet() + { + auto* unit = mpHost->getKeyUnit(); + QString emptyScript; + int modifier = Qt::NoModifier; + int keyCode = Qt::Key_F11; + const int id = mpHost->mLuaInterpreter.startTempKey(modifier, keyCode, emptyScript); + QVERIFY(id > 0); + auto* pKey = unit->getKey(id); + QVERIFY(pKey); + pKey->mPackageName = mPackageName; + + unit->markCleanup(pKey); + unit->uninstall(mPackageName); + + QVERIFY2(unit->mCleanupSet.isEmpty(), "uninstall() must take the key it freed out of the cleanup set"); + unit->doCleanup(); + QVERIFY2(!unit->getKey(id), "the key should have been freed exactly once"); + } + + // Helpers (reused from the ResetProfileTest pattern) + + void startProfile(const QString& hostname, const QString& address, const QString& port) + { + QTimer::singleShot(0ms, qApp, [hostname, address, port]() { + mudlet::self()->startAutoLogin({}); + QTest::qWait(100ms); + QTest::mouseClick(mudlet::self()->mpConnectionDialog->new_profile_button, Qt::LeftButton); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), hostname); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), address); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), port); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Return); + }); + + QSignalSpy spy(mudlet::self(), &mudlet::signal_profileLoaded); + if (!spy.wait(1000)) { + QFAIL("Profile took too long to load."); + } + auto host = mudlet::self()->getActiveHost(); + if (!host) { + QFAIL("No active host available for the test."); + } + + QSignalSpy spy2(&(host->mTelnet), &cTelnet::signal_connected); + if (!spy2.wait(500)) { + QFAIL("Could not connect with the host."); + } + } + + void deleteProfileDirectory(const QString& profileName) + { + const QString path = mudlet::getMudletPath(enums::profileHomePath, profileName); + QDir dir(path); + + if (!dir.exists()) { + return; + } + dir.removeRecursively(); + } +}; + +void initializeQRCResourcesForUnitDeferredDeleteTest() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +#include "UnitDeferredDeleteTest.moc" +QTEST_MAIN(UnitDeferredDeleteTest) From a140261d687a2e2ce4e6e88b182186f7864e7241 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Wed, 5 Aug 2026 19:55:44 +0200 Subject: [PATCH 095/155] Fix six command line and console bugs (#9683) #### Brief overview of PR changes/additions - Deleting the window that owns a command line no longer leaves a dangling `TCommandLine*` behind in `mSubCommandLineMap`. A new `TMainConsole::registerSubCommandLine()` is the single place that map is written, and it hooks `destroyed()` so the entry goes when the widget does. - Seven command line Lua functions located their mandatory string at `lua_gettop(L)`, which is index `0` when they are called with no arguments - not a valid Lua stack index, so they silently operated on whatever an earlier call had left on the stack. The index is now clamped, and `selectCmdLineText` pushes a real result instead of handing back a stack leftover. - `scrollUp`/`scrollDown` report an unknown window instead of raising, and `prefix()`/`suffix()` only colour the text they add - `suffix()` also puts it after the last character of the line rather than before it. #### Motivation for adding to Mudlet The dangling pointer is the serious one. The command line is a child widget of the miniconsole, user window or scroll box it lives in, so Qt frees it along with that parent while the map entry survives. `TConsole::setFont()` walks the whole map, and that walk is reached from `Host::setDisplayFont()` - so once any package has created and then deleted a window carrying a command line, simply changing the display font, its size or its antialiasing in Settings reads freed memory. No Lua is involved, and most dereferences land in Qt's text internals, so crashes from this are likely being filed as unrelated Qt text-layout bugs. The rest are Lua API correctness: calls that quietly act on unrelated data, a return value that is really the C function object, a guard that never fires, and colour and insert positions that land on the wrong text. #### Other info (issues closed, discussion etc) Closes #9643, closes #9647, closes #9651, closes #9652, closes #9661, closes #9674 `selectCmdLineText` now returns `true`; its wiki entry needs updating to match. **Test case:** with the fix reverted, the new `SubCommandLineLifetimeTest` fails three assertions and then aborts on an AddressSanitizer heap-use-after-free in `TCommandLine::console()` from `TConsole::setFont()`, and 17 of the 20 new and un-pended Lua specs fail too. With it, busted is 2246/0 twice over and ctest is 72/72 serially. Assisted-by: Claude:claude-opus-5 --- src/TConsole.cpp | 2 +- src/TLuaInterpreter.cpp | 14 +- src/TLuaInterpreterMudletObjects.cpp | 18 +- src/TLuaInterpreterUI.cpp | 9 +- src/TMainConsole.cpp | 63 +++- src/TMainConsole.h | 2 + src/mudlet-lua/lua/GUIUtils.lua | 23 +- src/mudlet-lua/tests/GUIUtils_spec.lua | 82 ++++- .../tests/GeyserCommandLine_spec.lua | 17 +- .../tests/GeyserMiniConsole_spec.lua | 4 - src/mudlet-lua/tests/UI_spec.lua | 96 +++++ test/functional_tests/CMakeLists.txt | 1 + .../SubCommandLineLifetimeTest.cpp | 340 ++++++++++++++++++ 13 files changed, 631 insertions(+), 40 deletions(-) create mode 100644 test/functional_tests/SubCommandLineLifetimeTest.cpp diff --git a/src/TConsole.cpp b/src/TConsole.cpp index 1327f292c..92eba15e4 100644 --- a/src/TConsole.cpp +++ b/src/TConsole.cpp @@ -1679,7 +1679,7 @@ void TConsole::setCmdVisible(bool isVisible) mpCommandLine->setFont(font()); // put this CommandLine in the mainConsoles SubCommandLineMap // name is the console name - mpHost->mpConsole->mSubCommandLineMap[mConsoleName] = mpCommandLine; + mpHost->mpConsole->registerSubCommandLine(mConsoleName, mpCommandLine); layoutLayer2->addWidget(mpCommandLine); } if (mType == MainConsole) { diff --git a/src/TLuaInterpreter.cpp b/src/TLuaInterpreter.cpp index ee6e9f6dc..c4670805d 100644 --- a/src/TLuaInterpreter.cpp +++ b/src/TLuaInterpreter.cpp @@ -2802,15 +2802,19 @@ int TLuaInterpreter::getEpoch(lua_State* L) int TLuaInterpreter::addCmdLineBlacklist(lua_State* L) { const int n = lua_gettop(L); + // The mandatory text is last, but with no arguments at all that would be + // index 0 - not a valid Lua stack index, and Lua 5.1 hands back the first + // free slot for it rather than complaining: + const int textIndex = qMax(n, 1); const char* name = "main"; if (n > 1) { name = CMDLINE_NAME(L, 1); } - if (!checkStringArg(L, __func__, n, "suggestion text")) { + if (!checkStringArg(L, __func__, textIndex, "suggestion text")) { return lua_error(L); } auto pN = COMMANDLINE(L, QString{name}); - pN->addBlacklist(QString{lua_tostring(L, n)}); + pN->addBlacklist(QString{lua_tostring(L, textIndex)}); return 0; } @@ -2818,15 +2822,17 @@ int TLuaInterpreter::addCmdLineBlacklist(lua_State* L) int TLuaInterpreter::removeCmdLineBlacklist(lua_State* L) { const int n = lua_gettop(L); + // See addCmdLineBlacklist() on why the index is clamped: + const int textIndex = qMax(n, 1); const char* name = "main"; if (n > 1) { name = CMDLINE_NAME(L, 1); } - if (!checkStringArg(L, __func__, n, "suggestion text")) { + if (!checkStringArg(L, __func__, textIndex, "suggestion text")) { return lua_error(L); } auto pN = COMMANDLINE(L, QString{name}); - pN->removeBlacklist(QString{lua_tostring(L, n)}); + pN->removeBlacklist(QString{lua_tostring(L, textIndex)}); return 0; } diff --git a/src/TLuaInterpreterMudletObjects.cpp b/src/TLuaInterpreterMudletObjects.cpp index c5db03b67..e3ccd425a 100644 --- a/src/TLuaInterpreterMudletObjects.cpp +++ b/src/TLuaInterpreterMudletObjects.cpp @@ -203,11 +203,15 @@ static bool timerDelayFits(const double time) int TLuaInterpreter::addCmdLineSuggestion(lua_State* L) { const int n = lua_gettop(L); + // The mandatory text is last, but with no arguments at all that would be + // index 0 - not a valid Lua stack index, and Lua 5.1 hands back the first + // free slot for it rather than complaining: + const int textIndex = qMax(n, 1); const char* name = "main"; if (n > 1) { name = CMDLINE_NAME(L, 1); } - const QString text = getVerifiedString(L, __func__, n, "suggestion text"); + const QString text = getVerifiedString(L, __func__, textIndex, "suggestion text"); auto pN = COMMANDLINE(L, QString{name}); pN->addSuggestion(text); return 0; @@ -242,12 +246,14 @@ int TLuaInterpreter::adjustStopWatch(lua_State* L) int TLuaInterpreter::appendCmdLine(lua_State* L) { const int n = lua_gettop(L); + // See addCmdLineSuggestion() on why the index is clamped: + const int textIndex = qMax(n, 1); const char* name = "main"; if (n > 1) { name = CMDLINE_NAME(L, 1); } - const QString text = getVerifiedString(L, __func__, n, "text to set on command line"); + const QString text = getVerifiedString(L, __func__, textIndex, "text to set on command line"); auto pN = COMMANDLINE(L, QString{name}); const QString curText = pN->toPlainText(); @@ -357,11 +363,13 @@ int TLuaInterpreter::deleteStopWatch(lua_State* L) int TLuaInterpreter::removeCmdLineSuggestion(lua_State* L) { const int n = lua_gettop(L); + // See addCmdLineSuggestion() on why the index is clamped: + const int textIndex = qMax(n, 1); const char* name = "main"; if (n > 1) { name = CMDLINE_NAME(L, 1); } - const QString text = getVerifiedString(L, __func__, n, "suggestion text"); + const QString text = getVerifiedString(L, __func__, textIndex, "suggestion text"); auto pN = COMMANDLINE(L, QString{name}); pN->removeSuggestion(text); return 0; @@ -1473,11 +1481,13 @@ int TLuaInterpreter::permKey(lua_State* L) int TLuaInterpreter::printCmdLine(lua_State* L) { const int n = lua_gettop(L); + // See addCmdLineSuggestion() on why the index is clamped: + const int textIndex = qMax(n, 1); const char* name = "main"; if (n > 1) { name = CMDLINE_NAME(L, 1); } - const QString text = getVerifiedString(L, __func__, n, "text to set on command line"); + const QString text = getVerifiedString(L, __func__, textIndex, "text to set on command line"); auto pN = COMMANDLINE(L, QString{name}); pN->setPlainText(text); diff --git a/src/TLuaInterpreterUI.cpp b/src/TLuaInterpreterUI.cpp index 0f3e40f29..79e51dbdf 100644 --- a/src/TLuaInterpreterUI.cpp +++ b/src/TLuaInterpreterUI.cpp @@ -2477,6 +2477,7 @@ int TLuaInterpreter::selectCmdLineText(lua_State* L) } auto commandline = COMMANDLINE(L, name); commandline->selectAll(); + lua_pushboolean(L, true); return 1; } @@ -2972,15 +2973,19 @@ int TLuaInterpreter::setCmdLineAction(lua_State* L) int TLuaInterpreter::setCmdLineStyleSheet(lua_State* L) { const int n = lua_gettop(L); + // The mandatory stylesheet is last, but with no arguments at all that would + // be index 0 - not a valid Lua stack index, and Lua 5.1 hands back the first + // free slot for it rather than complaining: + const int styleSheetIndex = qMax(n, 1); if (n > 1 && !checkStringArg(L, __func__, 1, "command line name", true)) { return lua_error(L); } - if (!checkStringArg(L, __func__, n, "StyleSheet")) { + if (!checkStringArg(L, __func__, styleSheetIndex, "StyleSheet")) { return lua_error(L); } const QString name = (n > 1) ? QString{lua_tostring(L, 1)} : qsl("main"); - const QString styleSheet{lua_tostring(L, n)}; + const QString styleSheet{lua_tostring(L, styleSheetIndex)}; const Host& host = getHostFromLua(L); if (auto [success, message] = host.mpConsole->setCmdLineStyleSheet(name, styleSheet); !success) { diff --git a/src/TMainConsole.cpp b/src/TMainConsole.cpp index 113c88c41..ae9eec23d 100644 --- a/src/TMainConsole.cpp +++ b/src/TMainConsole.cpp @@ -87,6 +87,21 @@ TMainConsole::TMainConsole(Host* pH, QWidget* parent) TMainConsole::~TMainConsole() { + // There is one window in which a command line's destroyed() handler is unsafe: + // after this console's members - mSubCommandLineMap among them - have been + // destroyed, but before ~QObject severs incoming connections. The only command + // lines that can be destroyed inside it are the ones QWidget::~QWidget deletes, + // i.e. this console's own children, so sweeping those is enough. Command lines + // created into a user window belong to a TDockWidget reparented onto the main + // window instead, and can only die after ~QObject has already dropped the + // connection. Children rather than map entries, because deleteCommandLine() and + // resetMainConsole() drop the entry while the widget lives on until its + // deferred delete is delivered. + for (auto commandLine : findChildren()) { + disconnect(commandLine, &QObject::destroyed, this, nullptr); + } + mSubCommandLineMap.clear(); + // Neither is a child of this console: the map dock is reparented onto the main // window by addDockWidget(), and the unpacking dialog is parentless. So neither // dies with the console automatically. @@ -520,11 +535,10 @@ void TMainConsole::resetMainConsole() itDockWidget.remove(); } - QMutableMapIterator itCommandLine(mSubCommandLineMap); - while (itCommandLine.hasNext()) { - itCommandLine.next(); - itCommandLine.value()->deleteLater(); - itCommandLine.remove(); + const QList commandLines = mSubCommandLineMap.values(); + for (auto commandLine : commandLines) { + deregisterSubCommandLine(commandLine); + commandLine->deleteLater(); } // Remaining SubConsole/Buffer entries (UserWindow ones were already removed above) @@ -739,8 +753,12 @@ std::pair TMainConsole::deleteCommandLine(const QString& name) return {false, QLatin1String("a command line cannot have an empty string as its name")}; } - auto pCmdLine = mSubCommandLineMap.take(name); + auto pCmdLine = mSubCommandLineMap.value(name); if (pCmdLine) { + // Deregister rather than just take() the entry: the widget outlives this + // call until its deferred delete is delivered, and its destroyed() handler + // must not be left armed for a console that may be gone by then. + deregisterSubCommandLine(pCmdLine); // Using deleteLater() rather than delete as it seems a safer option // given that this item is likely to be linked to some events and // suchlike: @@ -960,7 +978,7 @@ std::pair TMainConsole::createCommandLine(const QString& windowna } else { pN = new TCommandLine(mpHost, name, TCommandLine::SubCommandLine, this, mpMainFrame); } - mSubCommandLineMap[name] = pN; + registerSubCommandLine(name, pN); pN->resize(width, height); pN->move(x, y); pN->show(); @@ -969,6 +987,37 @@ std::pair TMainConsole::createCommandLine(const QString& windowna return {false, QLatin1String("couldn't create commandLine")}; } +void TMainConsole::registerSubCommandLine(const QString& name, TCommandLine* pCommandLine) +{ + if (auto pDisplaced = mSubCommandLineMap.value(name); pDisplaced && pDisplaced != pCommandLine) { + // Would otherwise be left connected but unreachable by name + deregisterSubCommandLine(pDisplaced); + } + mSubCommandLineMap[name] = pCommandLine; + + // A TCommandLine is always a child widget of something else - the miniconsole + // it is embedded in, or the user window / scroll box it was created into - so + // it can be destroyed without deleteCommandLine() ever being called, and this + // map does not hold QPointers. Without this the entry outlives the widget and + // every later lookup of the name reads freed memory; TConsole::setFont() walks + // the whole map, so even changing the display font in Preferences hits it. + connect(pCommandLine, &QObject::destroyed, this, [this, pCommandLine]() { + deregisterSubCommandLine(pCommandLine); + }); +} + +void TMainConsole::deregisterSubCommandLine(TCommandLine* pCommandLine) +{ + // This is the only destroyed() connection made from a command line to this + // console, so severing all of them is severing just that one. + disconnect(pCommandLine, &QObject::destroyed, this, nullptr); + // Erase by value rather than by name: a replacement command line may have been + // registered under the same name in the meantime and must be left in place. + mSubCommandLineMap.removeIf([pCommandLine](const auto& it) { + return it.value() == pCommandLine; + }); +} + std::pair TMainConsole::createTextBox(const QString& windowname, const QString& name, int x, int y, int width, int height) { if (name.isEmpty()) { diff --git a/src/TMainConsole.h b/src/TMainConsole.h index 956104cb1..403f16906 100644 --- a/src/TMainConsole.h +++ b/src/TMainConsole.h @@ -77,6 +77,8 @@ public: TLabel* createLabel(const QString& windowname, const QString& name, int x, int y, int width, int height, bool fillBackground, bool clickThrough = false); std::pair createMapper(const QString& windowname, int, int, int, int); std::pair createCommandLine(const QString& windowname, const QString& name, int, int, int, int); + void registerSubCommandLine(const QString& name, TCommandLine* pCommandLine); + void deregisterSubCommandLine(TCommandLine* pCommandLine); std::pair createTextBox(const QString& windowname, const QString& name, int, int, int, int); QSize getUserWindowSize(const QString& windowname) const; std::pair setCmdLineStyleSheet(const QString& name, const QString& styleSheet); diff --git a/src/mudlet-lua/lua/GUIUtils.lua b/src/mudlet-lua/lua/GUIUtils.lua index 7c7633cab..f60928a6e 100644 --- a/src/mudlet-lua/lua/GUIUtils.lua +++ b/src/mudlet-lua/lua/GUIUtils.lua @@ -2208,7 +2208,10 @@ function suffix(what, func, fgc, bgc, window) window = window or "main" func = insertFuncs[func] or func or insertText local length = utf8.len(getCurrentLine(window)) - moveCursor(window, length - 1, getLineNumber(window)) + moveCursor(window, length, getLineNumber(window)) + -- fg()/bg() also repaint whatever is selected in the window, so drop any + -- live selection first - only the text being added is meant to be coloured + deselect(window) if fgc then fg(window,fgc) end if bgc then bg(window,bgc) end func(window,what) @@ -2230,6 +2233,8 @@ function prefix(what, func, fgc, bgc, window) window = window or "main" func = insertFuncs[func] or func or insertText moveCursor(window, 0, getLineNumber(window)) + -- see suffix() - colouring must not leak onto the current selection + deselect(window) if fgc then fg(window,fgc) end if bgc then bg(window,bgc) end func(window,what) @@ -2243,7 +2248,7 @@ end function moveCursorUp(window, lines, keep_horizontal) if type(window) ~= "string" then lines, window, keep_horizontal = window, "main", lines end lines = tonumber(lines) or 1 - if not type(keep_horizontal) == "boolean" then keep_horizontal = false end + if type(keep_horizontal) ~= "boolean" then keep_horizontal = false end local curLine = getLineNumber(window) if not curLine then return nil, "window does not exist" end local x = 0 @@ -2258,7 +2263,7 @@ end function moveCursorDown(window, lines, keep_horizontal) if type(window) ~= "string" then lines, window, keep_horizontal = window, "main", lines end lines = tonumber(lines) or 1 - if not type(keep_horizontal) == "boolean" then keep_horizontal = false end + if type(keep_horizontal) ~= "boolean" then keep_horizontal = false end local curLine = getLineNumber(window) if not curLine then return nil, "window does not exist" end local x = 0 @@ -2677,9 +2682,10 @@ end function scrollUp(window, lines) if type(window) ~= "string" then window, lines = "main", window end lines = tonumber(lines) or 1 - local numLines = getLastLineNumber(window) - if not numLines then return nil, "window does not exist" end + -- getScroll() is what actually answers nil for an unknown window; + -- getLastLineNumber() answers -1, so guarding on it never fires local curScroll = getScroll(window) + if not curScroll then return nil, "window does not exist" end scrollTo(window, math.max(curScroll - lines, 0)) end @@ -2689,10 +2695,11 @@ end function scrollDown(window, lines) if type(window) ~= "string" then window, lines = "main", window end lines = tonumber(lines) or 1 - local numLines = getLastLineNumber(window) - if not numLines then return nil, "window does not exist" end + -- see scrollUp() on why the guard is on getScroll() rather than on the line count local curScroll = getScroll(window) - scrollTo(window, math.min(curScroll + lines, numLines)) + if not curScroll then return nil, "window does not exist" end + -- getScroll() having answered means the window exists, so this cannot fail + scrollTo(window, math.min(curScroll + lines, getLastLineNumber(window))) end --[[ diff --git a/src/mudlet-lua/tests/GUIUtils_spec.lua b/src/mudlet-lua/tests/GUIUtils_spec.lua index 00c5a3b7f..06facb385 100644 --- a/src/mudlet-lua/tests/GUIUtils_spec.lua +++ b/src/mudlet-lua/tests/GUIUtils_spec.lua @@ -2003,6 +2003,67 @@ describe("Tests the GUI utilities as far as possible without mudlet", function() assert.has_error(function() prefix(5) end) assert.has_error(function() suffix(5) end) end) + + -- A line that has been finished off with a newline is the ordinary trigger + -- case, and the only one where landing a column short is visible: on the + -- unfinished line the block above uses, an insert past the last character + -- is appended either way. + local function completedLine() + clearWindow(windowName) + moveCursor(windowName, 0, 0) + echo(windowName, "PROBE has a TARGET word\n") + moveCursor(windowName, 0, 0) + end + + it("Should put text after the last character of a completed line", function() + completedLine() + suffix(" SUF", nil, nil, nil, windowName) + assert.equals("PROBE has a TARGET word SUF", currentLine()) + end) + + it("Should put text after the last character of a completed line when colouring it", function() + completedLine() + suffix(" SUF", nil, "red", nil, windowName) + assert.equals("PROBE has a TARGET word SUF", currentLine()) + end) + + it("Should not recolour the current selection when prefixing", function() + selectSection(windowName, 0, 6) + prefix("[", nil, "red", nil, windowName) + -- "middle" now starts one column along, and must have kept its colour + selectSection(windowName, 1, 6) + assert.are_not.same(color_table["red"], getTextFormat(windowName).foreground) + end) + + it("Should not recolour the current selection when suffixing", function() + selectSection(windowName, 0, 6) + suffix("]", nil, "red", nil, windowName) + selectSection(windowName, 0, 6) + assert.are_not.same(color_table["red"], getTextFormat(windowName).foreground) + end) + + it("Should not repaint the background of the current selection either", function() + selectSection(windowName, 0, 6) + prefix("[", nil, nil, "blue", windowName) + selectSection(windowName, 1, 6) + assert.are_not.same(color_table["blue"], getTextFormat(windowName).background) + end) + + it("Should suffix onto an empty line", function() + clearWindow(windowName) + moveCursor(windowName, 0, 0) + echo(windowName, "\n") + moveCursor(windowName, 0, 0) + suffix("added", nil, nil, nil, windowName) + assert.equals("added", currentLine()) + end) + + it("Should still colour what it adds when something is selected", function() + selectSection(windowName, 0, 6) + prefix("[", nil, "red", nil, windowName) + selectSection(windowName, 0, 1) + assert.are.same(color_table["red"], getTextFormat(windowName).foreground) + end) end) describe("Tests the functionality of moveCursorDown", function() @@ -2048,6 +2109,23 @@ describe("Tests the GUI utilities as far as possible without mudlet", function() assert.is_nil(ok) assert.equals("window does not exist", err) end) + + it("Should treat a non-boolean keep_horizontal as false", function() + moveCursor(windowName, 2, 0) + moveCursorDown(windowName, 1, "yes") + assert.equals(0, getColumnNumber(windowName)) + moveCursor(windowName, 2, 1) + moveCursorUp(windowName, 1, "yes") + assert.equals(0, getColumnNumber(windowName)) + end) + + -- pairs with the assertion above: without this, "coerced to false" and + -- "keep_horizontal ignored entirely" would look the same for moveCursorUp + it("Should let moveCursorUp keep the column when asked with a boolean", function() + moveCursor(windowName, 2, 1) + moveCursorUp(windowName, 1, true) + assert.equals(2, getColumnNumber(windowName)) + end) end) describe("Tests the functionality of creplace, dreplace and hreplace", function() @@ -2196,10 +2274,6 @@ describe("Tests the GUI utilities as far as possible without mudlet", function() end) it("Should report an unknown window rather than raising", function() - -- BUG: the guard reads getLastLineNumber, which answers -1 rather than - -- nil for a window it does not know, so the documented nil + message - -- never happens and getScroll's nil blows up in the arithmetic below it - pending("scrollUp/scrollDown raise on an unknown window - see the Wave 3d report") local ok, err = scrollUp("guiUtilsNoSuchWindow", 1) assert.is_nil(ok) assert.equals("window does not exist", err) diff --git a/src/mudlet-lua/tests/GeyserCommandLine_spec.lua b/src/mudlet-lua/tests/GeyserCommandLine_spec.lua index f5cf6c9e5..c815da818 100644 --- a/src/mudlet-lua/tests/GeyserCommandLine_spec.lua +++ b/src/mudlet-lua/tests/GeyserCommandLine_spec.lua @@ -112,12 +112,17 @@ describe("Tests functionality of Geyser.CommandLine", function() end) end) - -- Two things are in the way. The selection itself has no getter; and - -- selectCmdLineText (TLuaInterpreterUI.cpp) declares one return value without - -- pushing one, so it hands back whatever was left on the Lua stack - the - -- window name it was passed - rather than a result. Asserting either of those - -- as they stand would freeze the defect in place. - pending("Geyser.CommandLine:selectText selects every character - the selection is not readable from Lua and needs a getCmdLineSelection getter, and selectCmdLineText returns the window name instead of a result") + describe("Geyser.CommandLine:selectText", function() + it("reports success", function() + local commandLine = track(Geyser.CommandLine:new({name = "gclSelect", x = 0, y = 0, width = 100, height = 30})) + commandLine:print("select me") + assert.is_true(commandLine:selectText()) + -- selecting must not disturb what is typed + assert.are.equal("select me", commandLine:getText()) + end) + end) + + pending("Geyser.CommandLine:selectText selects every character - the selection itself is not readable from Lua and needs a getCmdLineSelection getter") describe("Geyser.CommandLine:setStyleSheet", function() it("reuses the remembered stylesheet when called without one", function() diff --git a/src/mudlet-lua/tests/GeyserMiniConsole_spec.lua b/src/mudlet-lua/tests/GeyserMiniConsole_spec.lua index f3d7af4c7..8e9d81d12 100644 --- a/src/mudlet-lua/tests/GeyserMiniConsole_spec.lua +++ b/src/mudlet-lua/tests/GeyserMiniConsole_spec.lua @@ -240,10 +240,6 @@ describe("Tests functionality of Geyser.MiniConsole", function() end) it("selectCmdLinetext reports success after selecting the typed text", function() - -- BUG: the C++ selectCmdLineText declares one return value but pushes - -- nothing, so Lua hands back whatever was left on the stack - here the - -- window name that was passed in - pending("selectCmdLineText returns a stack leftover, not a result - see the Wave 3d report") console:printCmd("select me") assert.is_true(console:selectCmdLinetext()) end) diff --git a/src/mudlet-lua/tests/UI_spec.lua b/src/mudlet-lua/tests/UI_spec.lua index 2343ca793..118dda5f9 100644 --- a/src/mudlet-lua/tests/UI_spec.lua +++ b/src/mudlet-lua/tests/UI_spec.lua @@ -4452,3 +4452,99 @@ describe("Widget state getters", function() end) end) end) + +-- https://wiki.mudlet.org/w/Manual:UI_Functions +describe("Command line argument handling", function() + local cmdLine = "cmdArgHandlingLine" + + setup(function() + createCommandLine(cmdLine, 10, 10, 150, 30) + end) + + teardown(function() + deleteCommandLine(cmdLine) + clearCmdLine() + end) + + -- These seven take an optional leading window name and used to locate their + -- mandatory string at lua_gettop(L). Called with no arguments at all that is + -- index 0, which Lua 5.1 resolves to the first free stack slot instead of + -- rejecting - so the type check ran against whatever an earlier call had left + -- there, and a leftover string made the call quietly succeed on it. + local zeroArgumentFunctions = { + "addCmdLineSuggestion", + "appendCmdLine", + "removeCmdLineSuggestion", + "printCmdLine", + "setCmdLineStyleSheet", + "addCmdLineBlacklist", + "removeCmdLineBlacklist", + } + + -- leaves its argument in the stack slot the next call in the same function + -- body starts from, which is exactly the slot index 0 used to resolve to + local function leaveOnStack() end + + for _, functionName in ipairs(zeroArgumentFunctions) do + it(functionName .. " reports its missing argument as #1", function() + local ok, err = pcall(function() + leaveOnStack("cmdArgHandlingLeftover") + _G[functionName]() + end) + assert.is_false(ok) + assert.is_truthy(tostring(err):find("bad argument #1", 1, true)) + end) + end + + it("printCmdLine with no arguments does not print unrelated stack data", function() + local functionName = "printCmdLine" + printCmdLine("kept text") + pcall(function() + leaveOnStack("cmdArgHandlingLeftover") + _G[functionName]() + end) + assert.are.equal("kept text", getCmdLine()) + end) + + it("appendCmdLine with no arguments does not append unrelated stack data", function() + local functionName = "appendCmdLine" + printCmdLine("kept text") + pcall(function() + leaveOnStack("cmdArgHandlingLeftover") + _G[functionName]() + end) + assert.are.equal("kept text", getCmdLine()) + end) + + it("setCmdLineStyleSheet with no arguments does not apply unrelated stack data", function() + local functionName = "setCmdLineStyleSheet" + setCmdLineStyleSheet("color: rgb(12,34,56);") + pcall(function() + leaveOnStack("cmdArgHandlingLeftover") + _G[functionName]() + end) + assert.are.equal("color: rgb(12,34,56);", getCmdLineStyleSheet()) + setCmdLineStyleSheet("") + end) + + describe("selectCmdLineText", function() + it("returns true for the main command line", function() + printCmdLine("select me") + assert.is_true(selectCmdLineText()) + -- selecting must not disturb what is typed + assert.are.equal("select me", getCmdLine()) + end) + + it("returns true for a named command line", function() + printCmdLine(cmdLine, "select me too") + assert.is_true(selectCmdLineText(cmdLine)) + assert.are.equal("select me too", getCmdLine(cmdLine)) + end) + + it("returns nil and a message naming an unknown command line", function() + local ok, err = selectCmdLineText("cmdArgHandlingNoSuchLine") + assert.is_nil(ok) + assert.is_truthy(tostring(err):find("cmdArgHandlingNoSuchLine", 1, true)) + end) + end) +end) diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index e47057d36..932520bbe 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -14,6 +14,7 @@ set(FUNCTIONAL_TEST_SOURCES ResetProfileTest.cpp TOscTest.cpp TUserWindowTest.cpp + SubCommandLineLifetimeTest.cpp TriggerEditorTest.cpp TFeedTriggersRecursionTest.cpp TriggerSameLineMatchTest.cpp diff --git a/test/functional_tests/SubCommandLineLifetimeTest.cpp b/test/functional_tests/SubCommandLineLifetimeTest.cpp new file mode 100644 index 000000000..d3010cca9 --- /dev/null +++ b/test/functional_tests/SubCommandLineLifetimeTest.cpp @@ -0,0 +1,340 @@ +/*************************************************************************** + * Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +/* + * Regression test for a dangling TCommandLine* left behind in + * TMainConsole::mSubCommandLineMap when the widget that owns the command line + * is deleted. + * + * A TCommandLine is always a child widget of some other widget (the miniconsole + * it is embedded in, or the user window / scroll box it was created into), so + * Qt's parent-child ownership frees it along with that parent. The map entry + * registered in TConsole::setCmdVisible() / TMainConsole::createCommandLine() + * survived, leaving a non-null pointer to freed memory that every later lookup + * of that name dereferenced. + * + * The last test here is the one that needs no Lua at all: TConsole::setFont() + * walks the whole map and calls console() on every entry, and that walk is + * reached from Host::setDisplayFont(), i.e. from changing the display font in + * Preferences. + * + * Bootstrap mirrors the other functional tests (e.g. TUserWindowTest). + */ + +#include +#include +#include + +#include "Host.h" +#include "MudletInstanceCoordinator.h" +#include "TCommandLine.h" +#include "TConsole.h" +#include "TMainConsole.h" +#include "TelnetServerStub.h" +#include "ctelnet.h" +#include "dlgConnectionProfiles.h" +#include "mudlet.h" + +using namespace std::chrono_literals; + +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); +void initializeQRCResourcesForSubCommandLineTest(); + +class SubCommandLineLifetimeTest : public QObject +{ + Q_OBJECT + +private: + TelnetServerStub* mpServer = nullptr; + Host* mpHost = nullptr; + const QString mHostname = "SubCommandLine-Test-Host"; + QString mPort; // assigned the stub's actual ephemeral port in initTestCase() + const QString mLocalhost = "localhost"; + + // The free happens through deleteLater(), so it only lands once control + // returns to the event loop - which is exactly what makes the stale entry + // point at freed memory rather than at a doomed but still live widget. + void runDeferredDeletes() + { + QTest::qWait(50ms); + QCoreApplication::sendPostedEvents(nullptr, QEvent::DeferredDelete); + QCoreApplication::processEvents(); + } + +private slots: + // Start mudlet and create a profile once for all tests. + void initTestCase() + { + initializeQRCResourcesForSubCommandLineTest(); + + mpServer = new TelnetServerStub(qApp); + mpServer->start(mLocalhost, 0); // ephemeral OS-assigned port avoids collisions across concurrent test runs + mPort = QString::number(mpServer->serverPort()); + mudlet::start(); + mudlet::self()->setupConfig(); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique("MudletInstanceCoordinator")); + mudlet::self()->init(); + mudlet::self()->setStorePasswordsSecurely(false); + + const QString path = mudlet::getMudletPath(enums::profileHomePath, mHostname); + QDir(path).removeRecursively(); + + QTimer::singleShot(0ms, qApp, [this]() { + mudlet::self()->startAutoLogin({}); + QTest::qWait(100ms); + QTest::mouseClick(mudlet::self()->mpConnectionDialog->new_profile_button, Qt::LeftButton); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), mHostname); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), mLocalhost); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), mPort); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Return); + }); + + QSignalSpy spy(mudlet::self(), &mudlet::signal_profileLoaded); + if (!spy.wait(1000)) { + QFAIL("Profile took too long to load."); + } + mpHost = mudlet::self()->getActiveHost(); + if (!mpHost) { + QFAIL("No active host available for the test."); + } + + QSignalSpy spy2(&(mpHost->mTelnet), &cTelnet::signal_connected); + if (!spy2.wait(500)) { + QFAIL("Could not connect with the host."); + } + } + + void cleanupTestCase() + { + delete mpServer; + mpServer = nullptr; + mpHost = nullptr; + const QString path = mudlet::getMudletPath(enums::profileHomePath, mHostname); + QDir(path).removeRecursively(); + delete mudlet::self(); + } + + void init() + { + QVERIFY(mpHost); + QVERIFY(mpHost->mpConsole); + } + + // Route 1: enableCommandLine() on a miniconsole, then deleteMiniConsole(). + // The command line is a child of the miniconsole, so the miniconsole's + // destruction frees it. + void test_miniConsoleCommandLineDeregistersWhenConsoleDeleted() + { + TMainConsole* console = mpHost->mpConsole; + const QString name = qsl("doomedMiniConsole"); + + TConsole* miniConsole = console->createMiniConsole(QString(), name, 0, 0, 300, 100); + QVERIFY2(miniConsole, "could not create the miniconsole"); + miniConsole->setCmdVisible(true); // what Lua enableCommandLine(name) does + QVERIFY2(console->mSubCommandLineMap.contains(name), "command line not registered after enabling it"); + + auto [deleted, deleteMsg] = console->deleteMiniConsole(name); + QVERIFY2(deleted, qPrintable(deleteMsg)); + runDeferredDeletes(); + + QVERIFY2(!console->mSubCommandLineMap.contains(name), "stale command line entry left behind after deleting the miniconsole that owned it"); + + // The observable non-crashing symptom of the stale entry: the name still + // looks taken, so a fresh command line of that name cannot be made. + auto [created, createMsg] = console->createCommandLine(QString(), name, 0, 0, 100, 30); + QVERIFY2(created, qPrintable(createMsg)); + console->deleteCommandLine(name); + runDeferredDeletes(); + } + + // Route 2: createCommandLine() into a scroll box, then deleteScrollBox(). + void test_scrollBoxCommandLineDeregistersWhenScrollBoxDeleted() + { + TMainConsole* console = mpHost->mpConsole; + const QString scrollBoxName = qsl("doomedScrollBox"); + const QString cmdLineName = qsl("scrollBoxCmdLine"); + + QVERIFY2(console->createScrollBox(QString(), scrollBoxName, 0, 0, 300, 200), "could not create the scroll box"); + auto [created, createMsg] = console->createCommandLine(scrollBoxName, cmdLineName, 0, 0, 100, 30); + QVERIFY2(created, qPrintable(createMsg)); + QVERIFY(console->mSubCommandLineMap.contains(cmdLineName)); + + auto [deleted, deleteMsg] = console->deleteScrollBox(scrollBoxName); + QVERIFY2(deleted, qPrintable(deleteMsg)); + runDeferredDeletes(); + + QVERIFY2(!console->mSubCommandLineMap.contains(cmdLineName), "stale command line entry left behind after deleting the scroll box that owned it"); + + // Observable consequence: the name is free again. + auto [recreated, recreateMsg] = console->createCommandLine(QString(), cmdLineName, 0, 0, 100, 30); + QVERIFY2(recreated, qPrintable(recreateMsg)); + console->deleteCommandLine(cmdLineName); + runDeferredDeletes(); + } + + // Route 3: createCommandLine() into a user window, then deleteMiniConsole() + // on that user window - the dock owns the command line's parent widget. + void test_userWindowCommandLineDeregistersWhenWindowDeleted() + { + TMainConsole* console = mpHost->mpConsole; + const QString windowName = qsl("doomedUserWindow"); + const QString cmdLineName = qsl("userWindowCmdLine"); + + auto [opened, openMsg] = mpHost->openWindow(windowName, /*loadLayout=*/false, /*autoDock=*/true, qsl("l")); + QVERIFY2(opened, qPrintable(openMsg)); + auto [created, createMsg] = console->createCommandLine(windowName, cmdLineName, 0, 0, 100, 30); + QVERIFY2(created, qPrintable(createMsg)); + QVERIFY(console->mSubCommandLineMap.contains(cmdLineName)); + + auto [deleted, deleteMsg] = console->deleteMiniConsole(windowName); + QVERIFY2(deleted, qPrintable(deleteMsg)); + runDeferredDeletes(); + + QVERIFY2(!console->mSubCommandLineMap.contains(cmdLineName), "stale command line entry left behind after deleting the user window that owned it"); + + auto [recreated, recreateMsg] = console->createCommandLine(QString(), cmdLineName, 0, 0, 100, 30); + QVERIFY2(recreated, qPrintable(recreateMsg)); + console->deleteCommandLine(cmdLineName); + runDeferredDeletes(); + } + + // deleteCommandLine() must not leave the entry behind either - it takes the + // entry itself, so the destructor has to cope with the name already gone. + void test_deleteCommandLineDeregisters() + { + TMainConsole* console = mpHost->mpConsole; + const QString name = qsl("explicitlyDeletedCmdLine"); + + auto [created, createMsg] = console->createCommandLine(QString(), name, 0, 0, 100, 30); + QVERIFY2(created, qPrintable(createMsg)); + auto [deleted, deleteMsg] = console->deleteCommandLine(name); + QVERIFY2(deleted, qPrintable(deleteMsg)); + runDeferredDeletes(); + + QVERIFY2(!console->mSubCommandLineMap.contains(name), "command line entry left behind after deleteCommandLine()"); + + // Recreating under the same name must work. + auto [recreated, recreateMsg] = console->createCommandLine(QString(), name, 0, 0, 100, 30); + QVERIFY2(recreated, qPrintable(recreateMsg)); + console->deleteCommandLine(name); + runDeferredDeletes(); + } + + // The no-Lua route: changing the display font in Preferences ends up in + // Host::setDisplayFont() -> TConsole::setFont(), which walks the whole + // mSubCommandLineMap and calls console() on every entry. With a stale entry + // present that is a read of freed memory (a clean heap-use-after-free under + // AddressSanitizer). Kept last so the cheaper assertions above report first. + void test_changingDisplayFontAfterDeletedWindowIsSafe() + { + TMainConsole* console = mpHost->mpConsole; + const QString name = qsl("fontWalkMiniConsole"); + + TConsole* miniConsole = console->createMiniConsole(QString(), name, 0, 0, 300, 100); + QVERIFY2(miniConsole, "could not create the miniconsole"); + miniConsole->setCmdVisible(true); + QVERIFY(console->mSubCommandLineMap.contains(name)); + + auto [deleted, deleteMsg] = console->deleteMiniConsole(name); + QVERIFY2(deleted, qPrintable(deleteMsg)); + runDeferredDeletes(); + + QFont changedFont = mpHost->getDisplayFont(); + changedFont.setPointSize(changedFont.pointSize() == 12 ? 14 : 12); + auto [fontSet, fontMsg] = mpHost->setDisplayFont(changedFont); + QVERIFY2(fontSet, qPrintable(fontMsg)); + + QVERIFY2(!console->mSubCommandLineMap.contains(name), "stale command line entry survived into the setFont() walk"); + + auto [recreated, recreateMsg] = console->createCommandLine(QString(), name, 0, 0, 100, 30); + QVERIFY2(recreated, qPrintable(recreateMsg)); + console->deleteCommandLine(name); + runDeferredDeletes(); + } + + // Erasure has to be by value, not by name: a replacement registered under the + // same name before the old widget's deferred delete has run must survive it. + void test_recreatingBeforeTheDeferredDeleteKeepsTheNewCommandLine() + { + TMainConsole* console = mpHost->mpConsole; + const QString name = qsl("reusedCmdLineName"); + + auto [created, createMsg] = console->createCommandLine(QString(), name, 0, 0, 100, 30); + QVERIFY2(created, qPrintable(createMsg)); + auto [deleted, deleteMsg] = console->deleteCommandLine(name); + QVERIFY2(deleted, qPrintable(deleteMsg)); + + // Deliberately no event loop turn here - the old widget is still alive. + auto [recreated, recreateMsg] = console->createCommandLine(QString(), name, 0, 0, 100, 30); + QVERIFY2(recreated, qPrintable(recreateMsg)); + TCommandLine* replacement = console->mSubCommandLineMap.value(name); + QVERIFY(replacement); + + runDeferredDeletes(); + + QVERIFY2(console->mSubCommandLineMap.value(name) == replacement, "the old command line's deregistration took the replacement with it"); + console->deleteCommandLine(name); + runDeferredDeletes(); + } + + // Kept last on purpose: it leaves a registered command line behind, so that + // cleanupTestCase()'s teardown destroys the console with one still in its + // widget tree. ~TMainConsole has to drop its destroyed() handler first - that + // handler runs from ~QWidget, which is after the console's own members, + // mSubCommandLineMap included, have already been destroyed. + void test_destroyingTheConsoleWithALiveCommandLineIsSafe() + { + TMainConsole* console = mpHost->mpConsole; + const QString name = qsl("outlivesTheConsole"); + + auto [created, createMsg] = console->createCommandLine(QString(), name, 0, 0, 100, 30); + QVERIFY2(created, qPrintable(createMsg)); + QVERIFY(console->mSubCommandLineMap.contains(name)); + } +}; + +void initializeQRCResourcesForSubCommandLineTest() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +#include "SubCommandLineLifetimeTest.moc" +QTEST_MAIN(SubCommandLineLifetimeTest) From 5dd5b14ee1f761810b79edc4e2a2bf4730d5f231 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Wed, 5 Aug 2026 19:55:59 +0200 Subject: [PATCH 096/155] fix: package lifecycle - queued save outliving the profile, unremovable archives, module priority (#9684) #### Brief overview of PR changes/additions - The profile save that installing or uninstalling a package owes is now held in a member `QTimer` that the profile close and `~Host()` stop, instead of a `QTimer::singleShot()` queued on the `Host`: that call was still delivered after `HostManager::deleteHost()` had destroyed the profile, and `Host::saveProfile()` then read freed members. - `installPackage()` refuses an archive it could read no package out of and takes the folder it unpacked back off disk - but only a folder inside the profile, since the name can be whatever an untrusted `config.lua` says. It answered `true` for such an archive before, leaving something registered nowhere that could never be uninstalled. - `getModulePriority()` asks `mInstalledModules` whether the module exists, the same list `setModulePriority()` uses, and reports the default priority of 0 for one nobody has prioritised yet. #### Motivation for adding to Mudlet Uninstall a package, close Mudlet, and the queued save runs against the destroyed profile - a heap use-after-free on the way out, which is what a "Mudlet crashed when I closed it" report looks like. Reproduced under AddressSanitizer, clean afterwards. The other two are smaller but user-visible: picking the wrong zip in the package manager reported success and left a folder behind that nothing could remove, and a script could not tell "module not installed" from "installed, never prioritised". #### Other info (issues closed, discussion etc) Closes #9653, closes #9654, closes #9655. Test case: `installPackage("something.mpackage")`, `uninstallPackage("something")`, then close Mudlet straight away - it exits cleanly; `installPackage()` on a zip with no package XML in it now answers `nil` plus a message and leaves nothing behind; `getModulePriority()` on a freshly installed module answers `0`. The package lifecycle specs carried the last two as `pending()`; both are flipped to real specs, and a new `PackageUninstallSaveTeardownTest` covers the save deferral, its coalescing, the profile close, and that a refused archive can only take its own folder with it. Assisted-by: Claude:claude-opus-5 --- src/Host.cpp | 116 ++++- src/Host.h | 15 +- src/TLuaInterpreter.cpp | 13 +- src/mudlet-lua/tests/Package_spec.lua | 62 ++- src/mudlet.cpp | 4 +- test/functional_tests/CMakeLists.txt | 1 + .../HostWidgetDecouplingTest.cpp | 41 +- .../PackageUninstallSaveTeardownTest.cpp | 403 ++++++++++++++++++ 8 files changed, 590 insertions(+), 65 deletions(-) create mode 100644 test/functional_tests/PackageUninstallSaveTeardownTest.cpp diff --git a/src/Host.cpp b/src/Host.cpp index 187df0292..7fd73fe67 100644 --- a/src/Host.cpp +++ b/src/Host.cpp @@ -412,6 +412,8 @@ Host::Host(int port, const QString& hostname, const QString& login, const QStrin } }); connect(&purgeTimer, &QTimer::timeout, this, &Host::slot_purgeTemps); + mDeferredSaveTimer.setSingleShot(true); + connect(&mDeferredSaveTimer, &QTimer::timeout, this, &Host::slot_saveProfileAfterPackageChange); connect(this, &Host::signal_forceMXPProcessorOnChanged, this, [this](bool enabled) { if (enabled) { if (!mMxpProcessor.isEnabled()) { @@ -449,6 +451,11 @@ Host::~Host() // Mark the host as closing down to prevent keybinding processing during destruction mIsClosingDown = true; + // closeChildren() normally does this, but a Host whose console has already + // gone never gets there - and a package save left to fire from a Host that + // is being taken apart runs against freed members (#9653): + mDeferredSaveTimer.stop(); + // This needs to be cleared here while the Host object is still valid, // otherwise it'll be cleared when the Host object is being destroyed, // which can lead to a crash when closing multiple profiles at once. @@ -514,6 +521,14 @@ bool Host::requestClose() void Host::closeChildren() { mIsClosingDown = true; + // Drop the profile save a package install/uninstall put off: the close path + // has already saved the profile with that change in it (or the user declined + // to save at all), and a save that outlives the profile runs on a destroyed + // Host (#9653). + if (mDeferredSaveTimer.isActive()) { + qDebug().nospace().noquote() << "Host::closeChildren() INFO - dropping the profile save that a package change owed \"" << getName() << "\": the close saves the profile itself."; + mDeferredSaveTimer.stop(); + } const auto hostToolBarMap = getActionUnit()->getToolBarList(); // disconnect before removing objects from memory as sysDisconnectionEvent needs that stuff. mTelnet.terminateConnection(); @@ -1846,6 +1861,30 @@ void Host::slot_purgeTemps() mScriptUnit.doCleanup(); } +// The profile save that installPackage()/uninstallPackage() put off to the next +// event loop pass - see mDeferredSaveTimer. +void Host::slot_saveProfileAfterPackageChange() +{ + if (currentlySavingProfile()) { + // saveProfile() would refuse outright, and this is the only save the + // package change has coming: ask again once the one in flight is out of + // the way rather than leaving the change unwritten until something else + // happens to save. The profile close stops this timer, so the retries + // cannot outlive the profile. + mDeferredSaveTimer.start(100ms); + return; + } + // If a package's own script uninstalled it mid-compile (from a script + // reached outside the compileAll()/editor/raiseEvent flush points, e.g. a + // permScript() run from an alias or key), the script deletes were deferred + // and are still registered. Flush them now, at depth 0, before saving so + // the save below does not serialize the just-uninstalled scripts back in: + mScriptUnit.doCleanup(); + if (auto [ok, filename, error] = saveProfile(); !ok) { + qWarning() << qsl("Host::slot_saveProfileAfterPackageChange() WARNING - couldn't save '%1' to '%2' because: %3").arg(getName(), filename, error); + } +} + void Host::registerEventHandler(const QString& name, TScript* pScript) { if (mEventHandlerMap.contains(name)) { @@ -2095,10 +2134,17 @@ std::pair Host::installPackage(const QString& fileName, enums::Pa // home directory for the PROFILE const QDir _tmpDir(_home); // directory to store the expanded archive file contents + // Noted before it is made: the only folder this install may ever delete + // again is one it made itself. The package name is the archive's own file + // name, and then whatever its config.lua says, so it can just as well name + // a folder of the profile's that was already here ("map", "log", + // "current") - see the refusal further down. + const bool destinationAlreadyExisted = QDir(_dest).exists(); const bool mkpathSuccessful = _tmpDir.mkpath(_dest); if (!mkpathSuccessful) { return {false, qsl("could not create destination folder")}; } + QString folderThisInstallMade = destinationAlreadyExisted ? QString() : QDir(_dest).absolutePath(); // Skip the unpacking dialog for modules created from UI, and for // script-initiated installs (passed via quiet) to avoid stealing @@ -2146,18 +2192,26 @@ std::pair Host::installPackage(const QString& fileName, enums::Pa } // continuing, so update the folder name on disk const QString newpath(qsl("%1/%2").arg(_home, packageName)); - _dir.rename(_dir.absolutePath(), newpath); + // A rename onto a folder that is already there fails, and then the + // folder this install made is still at its old name while _dir goes + // on to the folder that was already here - which is not ours to + // delete, whatever the archive would like. + if (_dir.rename(_dir.absolutePath(), newpath) && !folderThisInstallMade.isEmpty()) { + folderThisInstallMade = QDir(newpath).absolutePath(); + } _dir = QDir(newpath); } QStringList _filterList; _filterList << qsl("*.xml") << qsl("*.trigger"); const QFileInfoList entries = _dir.entryInfoList(_filterList, QDir::Files); + bool registeredFromArchive = false; for (auto& entry : entries) { file2.setFileName(entry.absoluteFilePath()); if (!file2.open(QFile::ReadOnly | QFile::Text)) { qWarning() << "Host: failed to open file for reading:" << entry.absoluteFilePath() << file2.errorString(); continue; } + registeredFromArchive = true; XMLimport reader(this); if (thing != enums::PackageModuleType::Package) { QStringList moduleEntry; @@ -2179,6 +2233,31 @@ std::pair Host::installPackage(const QString& fileName, enums::Pa } file2.close(); } + + // Registering the package is this loop's job, so an archive that holds no + // package XML that could be read is not installed anywhere: it would be + // missing from getPackages()/getModules(), uninstallPackage() would refuse + // it, and the folder it was just unpacked into would stay in the profile + // for good (#9654). Take that folder away again and say so. Asking the + // loop whether it registered anything, rather than asking + // mInstalledPackages/mInstalledModules afterwards, is what makes this hold + // for a module whose name is already in mInstalledModules on the way in + // (profile loading, and installModule() over a stale entry, both do that). + if (!registeredFromArchive) { + // Only ever remove the folder this install made, and only if it is + // inside the profile: the package name can come out empty (a file + // called ".mpackage"), name a folder of the user's ("map"), or be + // whatever an untrusted archive's config.lua says (".." - the folder + // holding every profile), and removeDir() takes everything below what + // it is given. + const QString profileHome = QDir(mudlet::getMudletPath(enums::profileHomePath, getName())).absolutePath(); + if (!folderThisInstallMade.isEmpty() && folderThisInstallMade.startsWith(profileHome + QLatin1Char('/'))) { + removeDir(folderThisInstallMade, folderThisInstallMade); + } else { + qWarning() << "Host::installPackage() WARNING - refused" << fileName << "as package" << packageName << "but leaving" << _dir.absolutePath() << "alone: this install did not make it"; + } + return {false, qsl("no package found in %1 - no Mudlet package file in it could be read").arg(fileName)}; + } } else { file2.setFileName(fileName); if (!file2.open(QFile::ReadOnly | QFile::Text)) { @@ -2223,7 +2302,15 @@ std::pair Host::installPackage(const QString& fileName, enums::Pa // Defer raising install events until the next event loop iteration // This ensures all package installation is complete (including variable loading) // before event handlers execute, preventing Lua state corruption - QTimer::singleShot(0ms, this, [this, thing, packageName, fileName]() { + QTimer::singleShot(0ms, this, [this, guard = QPointer(this), thing, packageName, fileName]() { + // The queued call can still be delivered once this Host has been + // destroyed - the profile save queued the same way was #9653 - and the + // isClosingDown() check below would then be read off freed memory. The + // guard lives in the queued call rather than in the Host, so it is safe + // to ask and is null by then: + if (!guard) { + return; + } // Don't raise events if Host is shutting down to avoid handlers executing during teardown if (isClosingDown()) { return; @@ -2277,9 +2364,7 @@ std::pair Host::installPackage(const QString& fileName, enums::Pa // Save profile to ensure modules persist and appear in module manager if (thing != enums::PackageModuleType::Package) { // Use a timer to save profile after module installation completes - QTimer::singleShot(100ms, this, [this]() { - saveProfile(); - }); + mDeferredSaveTimer.start(100ms); } return {true, QString()}; @@ -2442,24 +2527,9 @@ bool Host::uninstallPackage(const QString& packageName, enums::PackageModuleType const QString dest = mudlet::getMudletPath(enums::profilePackagePath, getName(), packageName); removeDir(dest, dest); - // ensure only one timer is running in case multiple modules are uninstalled at once - if (!mSaveTimer.has_value() || !mSaveTimer.value()) { - mSaveTimer = true; - // save the profile on the next Qt main loop cycle in order for the asyncronous save mechanism - // not to try to write to disk a package/module that just got uninstalled and removed from memory - QTimer::singleShot(0ms, this, [this]() { - mSaveTimer = false; - // If a package's own script uninstalled it mid-compile (from a script - // reached outside the compileAll()/editor/raiseEvent flush points, e.g. a - // permScript() run from an alias or key), the script deletes were deferred - // and are still registered. Flush them now, at depth 0, before saving so - // the save below does not serialize the just-uninstalled scripts back in: - mScriptUnit.doCleanup(); - if (auto [ok, filename, error] = saveProfile(); !ok) { - qDebug() << qsl("Host::uninstallPackage: Couldn't save '%1' to '%2' because: %3").arg(getName(), filename, error); - } - }); - } + // save the profile on the next Qt main loop cycle in order for the asyncronous save mechanism + // not to try to write to disk a package/module that just got uninstalled and removed from memory + mDeferredSaveTimer.start(0ms); //NOW we reset if we're uninstalling a module if (mpEditorDialog && thing == enums::PackageModuleType::ModuleFromScript) { diff --git a/src/Host.h b/src/Host.h index b506ec12d..bd41e12d9 100644 --- a/src/Host.h +++ b/src/Host.h @@ -352,6 +352,9 @@ public: QString readProfileIniData(const QString& item); void xmlSaved(const QString& xmlName); bool currentlySavingProfile(); + // Whether a package install or uninstall still owes the profile a save - see + // mDeferredSaveTimer. + bool hasPendingProfileSave() const { return mDeferredSaveTimer.isActive(); } void processDiscordGMCP(const QString& packageMessage, const QString& data); void waitForProfileSave(); void clearDiscordData(); @@ -890,6 +893,7 @@ signals: private slots: void slot_purgeTemps(); + void slot_saveProfileAfterPackageChange(); private: void setBorders(const QMargins); @@ -956,8 +960,15 @@ private: ActionUnit mActionUnit; KeyUnit mKeyUnit; GifTracker mGifTracker; - // ensures that only one saveProfile call is active when multiple modules are being uninstalled in one go - std::optional mSaveTimer; + // The profile save that a package/module install or uninstall owes is put off + // to the next event loop pass, so that the asynchronous save mechanism is not + // asked to write out something that was just taken out of memory. Restarting + // this timer also folds a batch of installs/uninstalls into a single save. + // It has to be a member timer rather than a QTimer::singleShot(): a call + // queued on the Host is still delivered after the Host has been destroyed, + // and the save then reads freed members - closeChildren() and ~Host() stop + // this one instead (#9653). + QTimer mDeferredSaveTimer; QFile mErrorLogFile; diff --git a/src/TLuaInterpreter.cpp b/src/TLuaInterpreter.cpp index c4670805d..e2ec23072 100644 --- a/src/TLuaInterpreter.cpp +++ b/src/TLuaInterpreter.cpp @@ -1340,12 +1340,15 @@ int TLuaInterpreter::getModulePriority(lua_State* L) { const QString moduleName = getVerifiedString(L, __func__, 1, "module name"); Host& host = getHostFromLua(L); - if (host.mModulePriorities.contains(moduleName)) { - const int priority = host.mModulePriorities[moduleName]; - lua_pushnumber(L, priority); - return 1; + // Installing a module does not seed mModulePriorities, so whether the module + // exists has to be asked of mInstalledModules - the same list + // setModulePriority() checks. A module nobody has set a priority on has the + // default of 0 that the module manager and the saved profile use (#9655). + if (!host.mInstalledModules.contains(moduleName)) { + return warnArgumentValue(L, __func__, "module doesn't exist"); } - return warnArgumentValue(L, __func__, "module doesn't exist"); + lua_pushnumber(L, host.mModulePriorities.value(moduleName)); + return 1; } // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#setModulePriority diff --git a/src/mudlet-lua/tests/Package_spec.lua b/src/mudlet-lua/tests/Package_spec.lua index 6769fbea7..319a89110 100644 --- a/src/mudlet-lua/tests/Package_spec.lua +++ b/src/mudlet-lua/tests/Package_spec.lua @@ -713,15 +713,19 @@ describe("Tests the module accessors", function() -- alone), so once one has been set for this module the default this spec is -- about can never be observed again. it("reports the default priority of a freshly installed module", function() - -- BUG: a module nobody has called setModulePriority() on has no entry in - -- the priority map, so getModulePriority() answers nil and "module - -- doesn't exist" for a module that plainly does exist. The module manager - -- reads the same map with operator[] and so shows 0, which is what this - -- should return. Left pending rather than pinning the wrong answer. - pending("getModulePriority() reports an installed module as non-existent until a priority is set") - + requireWorkingInstalls() + -- Installing a module seeds no priority for it, so this is the default the + -- module manager displays and the profile exporter writes out, rather than + -- the "module doesn't exist" that reading the priority map as an existence + -- check used to answer here. assert.equals(0, getModulePriority(moduleName)) end) + + it("returns nil+msg for a module that is not installed", function() + local ok, err = getModulePriority("mudlet-spec-never-installed") + assert.is_nil(ok) + assert.is_true(contains(err, "module doesn't exist"), tostring(err)) + end) end) describe("Tests the functionality of setModulePriority", function() @@ -866,6 +870,19 @@ describe("Tests the functionality of reloadModule", function() end) end) +-- Runs once the block above has uninstalled the module it shares, which is what +-- this is about - it installs nothing of its own. +describe("Tests reading the priority of a module that has been uninstalled", function() + it("stops answering for it, even though the priority it was given is remembered", function() + assert.is_false(moduleInstalled(moduleName), "the module accessor specs left their module installed") + -- Uninstalling leaves the module's entry in the priority map behind, so + -- reading that map is not a way to tell whether the module is there. + local ok, err = getModulePriority(moduleName) + assert.is_nil(ok) + assert.is_true(contains(err, "module doesn't exist"), tostring(err)) + end) +end) + describe("Tests a package that uninstalls itself", function() -- Regression #9557: a package whose event handler uninstalls its own package -- used to free the TScript objects that Host::raiseEvent() was still @@ -928,22 +945,28 @@ end) describe("Tests installing an archive with nothing in it for Mudlet", function() it("refuses an archive that holds neither a config.lua nor a package XML", function() - -- BUG: such an archive is unpacked into the profile and answered with true, - -- but nothing is registered: it is missing from getPackages(), so - -- uninstallPackage() will not take it and the unpacked folder stays in the - -- profile for good. Left pending rather than pinning a success that - -- installs nothing and cannot be undone. - pending("installPackage() answers true for an archive with no package in it, and leaves it unremovable") - -- uninstallPackage() will not take a package it never registered, so the - -- unpacked folder has to go by hand + requireWorkingInstalls() + -- Nothing in such an archive registers the package, so answering true would + -- leave a name that getPackages() does not list, that uninstallPackage() + -- refuses, and a folder in the profile that only a file manager can take + -- away. If the refusal ever regresses, this puts the folder back by hand. defer(function() - os.remove(getMudletHomeDir() .. "/mudlet-spec-emptyarchive/readme.txt") - lfs.rmdir(getMudletHomeDir() .. "/mudlet-spec-emptyarchive") + if fileExists(getMudletHomeDir() .. "/mudlet-spec-emptyarchive") then + os.remove(getMudletHomeDir() .. "/mudlet-spec-emptyarchive/readme.txt") + lfs.rmdir(getMudletHomeDir() .. "/mudlet-spec-emptyarchive") + end end) + -- an install asked for while a save is running is postponed and answered + -- with a bare true, which would read here as the refusal not happening + assert.is_true(waitForProfileSaveToPass(), "a profile save was still running") + local ok, err = installPackage(fixtureDirectory .. "/mudlet-spec-emptyarchive.mpackage") assert.is_nil(ok) - assert.is_string(err) + -- the message matters: "could not unzip package" here would mean the fixture + -- has rotted and the spec is passing for the wrong reason + assert.is_true(contains(err, "no package found in"), tostring(err)) + assert.is_false(packageInstalled("mudlet-spec-emptyarchive")) assert.is_false(fileExists(getMudletHomeDir() .. "/mudlet-spec-emptyarchive")) end) end) @@ -977,8 +1000,7 @@ describe("The package specs clean up after themselves", function() end -- Let the profile save that the last uninstall queued run while the profile - -- is still up: it dereferences the profile when it fires, and Mudlet may be - -- shutting down by the time it would otherwise get its turn. + -- is still up, rather than leaving it to be stopped by the profile close. pumpEventLoop(1500) end) end) diff --git a/src/mudlet.cpp b/src/mudlet.cpp index 54a074245..2c0b69acf 100644 --- a/src/mudlet.cpp +++ b/src/mudlet.cpp @@ -2423,8 +2423,8 @@ void mudlet::slot_timerFires() // on the stack (a timer script uninstalling its own package). Doing it // here - after the last use of pTT - keeps the window in which the // "uninstalled" timers linger down to this event loop iteration, before - // the profile save that Host::uninstallPackage() queues with a 0ms - // single-shot can serialize them back into the profile: + // the profile save that Host::uninstallPackage() queues for the next + // event loop pass can serialize them back into the profile: pHost->getTimerUnit()->doCleanup(); // Okay now we've found it we are done: diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index 932520bbe..88111b145 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -35,6 +35,7 @@ set(FUNCTIONAL_TEST_SOURCES ProfileRoundTripTest.cpp ProfileLoadTempFileTest.cpp PackageSelfUninstallTest.cpp + PackageUninstallSaveTeardownTest.cpp MapRoundTripTest.cpp MapProgressDialogSeamTest.cpp UndoServerWrapTest.cpp diff --git a/test/functional_tests/HostWidgetDecouplingTest.cpp b/test/functional_tests/HostWidgetDecouplingTest.cpp index f1862cceb..a256495f4 100644 --- a/test/functional_tests/HostWidgetDecouplingTest.cpp +++ b/test/functional_tests/HostWidgetDecouplingTest.cpp @@ -35,6 +35,8 @@ #include #include +#include + extern void qInitResources_mudlet(); extern void qInitResources_qm(); extern void qInitResources_additional_splash_screens(); @@ -218,8 +220,9 @@ private slots: QTemporaryDir packageDir; QVERIFY2(packageDir.isValid(), "Could not create a temporary directory for the test package."); - const QString packagePath = packageDir.filePath(qsl("HostWidgetDecouplingPackage.zip")); - QVERIFY2(writeEmptyZipArchive(packagePath), "Could not write the test package archive."); + const QString packageName = qsl("HostWidgetDecouplingPackage"); + const QString packagePath = packageDir.filePath(qsl("%1.zip").arg(packageName)); + QVERIFY2(writePackageArchive(packagePath, packageName), "Could not write the test package archive."); // installPackage() postpones the whole install (and so emits nothing) if a // profile save is still in flight from loading the profile. @@ -323,20 +326,32 @@ private slots: } } - // Utility function producing the smallest valid zip archive there is: a lone - // end-of-central-directory record holding no entries. installPackage() only - // has to find a real archive to unpack for the dialog wiring to be exercised; - // what is inside it is beside the point here. - bool writeEmptyZipArchive(const QString& path) + // Utility function producing the smallest package archive that installs: a + // zip holding one Mudlet package XML with nothing in it. An archive with no + // package XML at all is refused (it would install nowhere and could never be + // uninstalled), so the dialog wiring this test is about needs a real one. + bool writePackageArchive(const QString& path, const QString& packageName) { - static const char endOfCentralDirectoryRecord[22] = {'P', 'K', '\x05', '\x06'}; - QFile archive(path); - if (!archive.open(QIODevice::WriteOnly)) { + static const char packageXml[] = "\n" + "\n" + "\n" + "\n" + "\n" + "\n"; + + int errorCode = 0; + zip* archive = zip_open(path.toUtf8().constData(), ZIP_CREATE | ZIP_TRUNCATE, &errorCode); + if (!archive) { return false; } - const bool written = archive.write(endOfCentralDirectoryRecord, sizeof(endOfCentralDirectoryRecord)) == static_cast(sizeof(endOfCentralDirectoryRecord)); - archive.close(); - return written; + // sizeof - 1 to leave the terminating null out of the archived file + zip_source* source = zip_source_buffer(archive, packageXml, sizeof(packageXml) - 1, 0); + if (!source || zip_file_add(archive, qsl("%1.xml").arg(packageName).toUtf8().constData(), source, ZIP_FL_ENC_UTF_8) < 0) { + zip_source_free(source); + zip_discard(archive); + return false; + } + return zip_close(archive) == 0; } // Utility function diff --git a/test/functional_tests/PackageUninstallSaveTeardownTest.cpp b/test/functional_tests/PackageUninstallSaveTeardownTest.cpp new file mode 100644 index 000000000..dfc438714 --- /dev/null +++ b/test/functional_tests/PackageUninstallSaveTeardownTest.cpp @@ -0,0 +1,403 @@ +/*************************************************************************** + * Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +/* + * Regression test for the profile save that uninstalling a package puts off to + * the next event loop pass outliving the profile (#9653). + * + * Uninstalling a package cannot save the profile there and then - the + * asynchronous save mechanism would be handed a package that has just been + * taken out of memory - so the save is deferred. Closing Mudlet right after an + * uninstall then destroys the Host while that save is still owed, and the save + * ran anyway: against a freed Host, reading its writer map. Under + * AddressSanitizer that is a heap-use-after-free at + * Host::pendingXmlSaveFutures(); in a release build it is a crash or silent + * memory corruption on the way out, i.e. a "Mudlet crashed when I closed it" + * report. + * + * The two tests here pin both halves of what the fix has to hold true: the + * deferred save still happens for a profile that stays up, and nothing of it is + * left to run once the profile has been closed and its Host destroyed. The + * report itself needs the whole application to shut down (the queued call is + * delivered by the event loop pass after mudlet::closeEvent() has returned), + * which is what the busted package specs arrange; what this file adds is the + * contract the fix rests on, and a sanitizer run over the uninstall/close/ + * destroy/pump sequence itself. + * + * Run with: ctest -R PackageUninstallSaveTeardownTest -V + */ + +#include + +#include +#include +#include + +#include "Host.h" +#include "AliasUnit.h" +#include "HostManager.h" +#include "MudletInstanceCoordinator.h" +#include "TelnetServerStub.h" +#include "dlgConnectionProfiles.h" +#include "mudlet.h" + +using namespace std::chrono_literals; + +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); +void initializeQRCResourcesForPackageUninstallSaveTeardownTest(); + +class PackageUninstallSaveTeardownTest : public QObject +{ + Q_OBJECT + +private: + TelnetServerStub* mpServer = nullptr; + Host* mpHost = nullptr; + const QString mProfileName = qsl("PackageUninstallSaveTeardown-Test"); + const QString mLocalhost = qsl("localhost"); + QString mPort; // the stub's actual ephemeral port, assigned in initTestCase() + // The refusal test below installs an archive that names itself ".." - that + // has to happen nowhere near the developer's own profiles. + QTemporaryDir mConfigDir; + QByteArray mSavedXdg; + + static void deleteProfileDirectory(const QString& profileName) + { + QDir dir(mudlet::getMudletPath(enums::profileHomePath, profileName)); + if (dir.exists()) { + dir.removeRecursively(); + } + } + + static QStringList savedProfileFiles(const QString& profileName) { return QDir(mudlet::getMudletPath(enums::profileXmlFilesPath, profileName)).entryList(QStringList{qsl("*.xml")}, QDir::Files); } + + // Whether needle appears in the profile that was saved last - what actually + // landed on disk, rather than what a save signal says was attempted. + static bool lastSavedProfileContains(const QString& profileName, const QString& needle) + { + const QDir directory(mudlet::getMudletPath(enums::profileXmlFilesPath, profileName)); + const QStringList saved = directory.entryList(QStringList{qsl("*.xml")}, QDir::Files, QDir::Name); + if (saved.isEmpty()) { + return false; + } + QFile file(directory.absoluteFilePath(saved.last())); + if (!file.open(QFile::ReadOnly | QFile::Text)) { + return false; + } + return QString::fromUtf8(file.readAll()).contains(needle); + } + + // Utility function to manually start a profile like a user would do via the GUI + void startProfile(const QString& profileName, const QString& address, const QString& port) + { + QTimer::singleShot(0ms, qApp, [profileName, address, port]() { + mudlet::self()->startAutoLogin({}); + QTest::qWait(100ms); + QTest::mouseClick(mudlet::self()->mpConnectionDialog->new_profile_button, Qt::LeftButton); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), profileName); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), address); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), port); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Return); + }); + + QSignalSpy spy(mudlet::self(), &mudlet::signal_profileLoaded); + if (!spy.wait(5000)) { + QFAIL("Profile took too long to load."); + } + + mpHost = mudlet::self()->getActiveHost(); + if (!mpHost) { + QFAIL("No active host available for the test."); + } + } + + // The package itself is beside the point here - what matters is that + // uninstallPackage() has something to take away, and so owes the profile a + // save afterwards. + void uninstallPackageOwingASave(const QString& packageName) + { + mpHost->waitForProfileSave(); + mpHost->mInstalledPackages << packageName; + QVERIFY2(mpHost->uninstallPackage(packageName, enums::PackageModuleType::Package), "The package could not be uninstalled"); + QVERIFY2(!mpHost->mInstalledPackages.contains(packageName), "The package is still installed"); + QVERIFY2(mpHost->hasPendingProfileSave(), "Uninstalling a package left the profile no save to do"); + } + + // Writes an archive holding one file, i.e. one installPackage() unpacks and + // then refuses, having registered nothing from it. + static bool writeArchive(const QString& path, const QString& entryName, const QByteArray& contents) + { + int errorCode = 0; + zip* archive = zip_open(path.toUtf8().constData(), ZIP_CREATE | ZIP_TRUNCATE, &errorCode); + if (!archive) { + return false; + } + zip_source* source = zip_source_buffer(archive, contents.constData(), contents.size(), 0); + if (!source || zip_file_add(archive, entryName.toUtf8().constData(), source, ZIP_FL_ENC_UTF_8) < 0) { + zip_source_free(source); + zip_discard(archive); + return false; + } + return zip_close(archive) == 0; + } + + // ...specifically one whose config.lua renames the package to declaredName. + static bool writeConfigOnlyArchive(const QString& path, const QString& declaredName) { return writeArchive(path, qsl("config.lua"), qsl("mpackage = \"%1\"\n").arg(declaredName).toUtf8()); } + + QString profileFilePath(const QString& relativePath) const { return qsl("%1/%2").arg(mudlet::getMudletPath(enums::profileHomePath, mProfileName), relativePath); } + +private slots: + void initTestCase() + { + initializeQRCResourcesForPackageUninstallSaveTeardownTest(); + + // Keep the test hermetic: point the config dir resolution at a temporary + // directory instead of the user's real profiles - one of the tests below + // drives an archive that tries to have the profiles folder deleted. + QVERIFY(mConfigDir.isValid()); + mSavedXdg = qgetenv("XDG_CONFIG_HOME"); + QVERIFY(QDir().mkpath(qsl("%1/mudlet/profiles").arg(mConfigDir.path()))); + qputenv("XDG_CONFIG_HOME", mConfigDir.path().toUtf8()); + + mpServer = new TelnetServerStub(qApp); + mpServer->start(mLocalhost, 0); // ephemeral OS-assigned port avoids collisions across concurrent test runs + mPort = QString::number(mpServer->serverPort()); + mudlet::start(); + mudlet::self()->setupConfig(); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique(qsl("MudletInstanceCoordinator"))); + mudlet::self()->init(); + mudlet::self()->setStorePasswordsSecurely(false); + deleteProfileDirectory(mProfileName); + + startProfile(mProfileName, mLocalhost, mPort); + QVERIFY2(mpHost, "No active host after profile creation"); + } + + void cleanupTestCase() + { + mpHost = nullptr; + delete mpServer; + mpServer = nullptr; + deleteProfileDirectory(mProfileName); + delete mudlet::self(); + mSavedXdg.isNull() ? qunsetenv("XDG_CONFIG_HOME") : qputenv("XDG_CONFIG_HOME", mSavedXdg); + } + + // The save is deferred, not dropped: a profile that stays up has to end up + // with the uninstall written out. Without this the test below could be + // passed by never saving at all. + void test_deferredSaveRunsWhileTheProfileIsUp() + { + QSignalSpy saveSpy(mpHost, &Host::profileSaveStarted); + uninstallPackageOwingASave(qsl("uninstall-save-deferred")); + QCOMPARE(saveSpy.count(), 0); // the point of the deferral: not saved on the spot + + QTRY_VERIFY_WITH_TIMEOUT(saveSpy.count() >= 1, 5000); + mpHost->waitForProfileSave(); + } + + // A batch of uninstalls owes the profile one save between them, not one + // each: restarting the timer is what the old "only one timer is running" + // flag did, and a profile save is expensive enough that the package specs + // are shaped around how many of them a run does. + void test_aBatchOfUninstallsOwesOneSave() + { + QSignalSpy saveSpy(mpHost, &Host::profileSaveStarted); + uninstallPackageOwingASave(qsl("uninstall-save-batch-one")); + // no pumping in between, so all three land in the same event loop pass + mpHost->mInstalledPackages << qsl("uninstall-save-batch-two") << qsl("uninstall-save-batch-three"); + QVERIFY(mpHost->uninstallPackage(qsl("uninstall-save-batch-two"), enums::PackageModuleType::Package)); + QVERIFY(mpHost->uninstallPackage(qsl("uninstall-save-batch-three"), enums::PackageModuleType::Package)); + + QTRY_VERIFY_WITH_TIMEOUT(saveSpy.count() >= 1, 5000); + mpHost->waitForProfileSave(); + QCOMPARE(saveSpy.count(), 1); + } + + // Refusing an archive that installed nothing takes the folder it unpacked + // away again (#9654) - and nothing else. The package name can be whatever an + // untrusted archive's config.lua says, and ".." names the folder that holds + // every profile the user has. + void test_refusingAnArchiveOnlyRemovesItsOwnFolder() + { + QTemporaryDir archiveDir; + QVERIFY2(archiveDir.isValid(), "Could not create a temporary directory for the test archive"); + const QString archivePath = archiveDir.filePath(qsl("uninstall-save-escape.mpackage")); + QVERIFY2(writeConfigOnlyArchive(archivePath, qsl("..")), "Could not write the test archive"); + + mpHost->waitForProfileSave(); // an install during a save is postponed and answered with a bare true + const QString profileHome = mudlet::getMudletPath(enums::profileHomePath, mProfileName); + const QString profilesDirectory = QFileInfo(profileHome).absolutePath(); + + auto [ok, message] = mpHost->installPackage(archivePath, enums::PackageModuleType::Package, true); + QVERIFY2(!ok, "An archive holding no package was installed"); + QVERIFY2(QDir(profilesDirectory).exists(), "Refusing the archive took the folder holding every profile with it"); + QVERIFY2(QDir(profileHome).exists(), "Refusing the archive took the profile with it"); + QVERIFY2(!savedProfileFiles(mProfileName).isEmpty(), "Refusing the archive took the saved profile with it"); + } + + // ...and it may only remove a folder it made itself. The package name is the + // archive's own file name, and then whatever its config.lua says, so it can + // just as well be "map" - the folder the profile keeps the user's maps in. + void test_refusingAnArchiveLeavesFoldersItDidNotMake() + { + const QString mapFolder = profileFilePath(qsl("map")); + const QString mapFile = qsl("%1/spec-map.dat").arg(mapFolder); + QVERIFY2(QDir().mkpath(mapFolder), "Could not create the map folder the profile would have"); + QFile map(mapFile); + QVERIFY2(map.open(QFile::WriteOnly), "Could not write the map file this test is about"); + map.write("map data that was here before any package was installed"); + map.close(); + + QTemporaryDir archiveDir; + QVERIFY2(archiveDir.isValid(), "Could not create a temporary directory for the test archives"); + mpHost->waitForProfileSave(); // an install during a save is postponed and answered with a bare true + + // named through config.lua, from an archive called something harmless + const QString viaConfig = archiveDir.filePath(qsl("uninstall-save-mapgrab.mpackage")); + QVERIFY2(writeConfigOnlyArchive(viaConfig, qsl("map")), "Could not write the test archive"); + auto [configOk, configMessage] = mpHost->installPackage(viaConfig, enums::PackageModuleType::Package, true); + QVERIFY2(!configOk, "An archive holding no package was installed"); + QVERIFY2(QFile::exists(mapFile), "Refusing the archive took the profile's map folder with it"); + // the folder the install did make is this one, and it does have to go + QVERIFY2(!QDir(profileFilePath(qsl("uninstall-save-mapgrab"))).exists(), "Refusing the archive left the folder it unpacked behind"); + + // ...and the same through the archive's file name alone, no config.lua + mpHost->waitForProfileSave(); + const QString viaFileName = archiveDir.filePath(qsl("map.mpackage")); + QVERIFY2(writeArchive(viaFileName, qsl("readme.txt"), QByteArray("no package in here")), "Could not write the test archive"); + auto [fileNameOk, fileNameMessage] = mpHost->installPackage(viaFileName, enums::PackageModuleType::Package, true); + QVERIFY2(!fileNameOk, "An archive holding no package was installed"); + QVERIFY2(QFile::exists(mapFile), "Refusing the archive took the profile's map folder with it"); + } + + // The refusal is about archives nothing could be read out of, not about + // archives whose XML turns out to be no good - those are a different case, + // and one this deliberately leaves alone. + void test_anArchiveWithABadXmlIsStillARemovablePackage() + { + QTemporaryDir archiveDir; + QVERIFY2(archiveDir.isValid(), "Could not create a temporary directory for the test archives"); + + // 1. well-formed XML that is not a Mudlet package at all. XMLimport only + // reports the XML reader's own errors, so the import of this one + // SUCCEEDS - checking the import result would not refuse it either. + mpHost->waitForProfileSave(); + const QString notAPackage = archiveDir.filePath(qsl("spec-notapackage.mpackage")); + QVERIFY2(writeArchive(notAPackage, qsl("spec-notapackage.xml"), QByteArray("\n\n")), "Could not write the test archive"); + auto [notAPackageOk, notAPackageMessage] = mpHost->installPackage(notAPackage, enums::PackageModuleType::Package, true); + QVERIFY2(notAPackageOk, qPrintable(notAPackageMessage)); + QVERIFY2(mpHost->mInstalledPackages.contains(qsl("spec-notapackage")), "The package was not registered"); + mpHost->waitForProfileSave(); // installing a package saves, and an uninstall during a save is refused + QVERIFY2(mpHost->uninstallPackage(qsl("spec-notapackage"), enums::PackageModuleType::Package), "The package could not be uninstalled"); + QVERIFY2(!QDir(profileFilePath(qsl("spec-notapackage"))).exists(), "Uninstalling left the package folder behind"); + + // 2. XML the reader does fail on, after it has already read items out of + // it. The import answers false, but the alias it created is in the + // profile - refusing the archive here would delete the folder and + // strand what was imported, and the package is registered either way, + // so it is listed and can be uninstalled. That is what #9654 was about. + mpHost->waitForProfileSave(); + const QString truncated = archiveDir.filePath(qsl("spec-truncatedxml.mpackage")); + const QByteArray truncatedXml = QByteArray("\n" + "\n" + "\n" + "\n" + "\n" + "spec-truncatedxml alias\n" + "\n" + "\n" + "\n" + "^spec-truncatedxml$\n" + "\n" + "\n" + "installPackage(truncated, enums::PackageModuleType::Package, true); + QVERIFY2(truncatedOk, qPrintable(truncatedMessage)); + QVERIFY2(mpHost->getAliasUnit()->findFirstAlias(qsl("spec-truncatedxml alias")), "The alias read before the XML gave out was not created"); + QVERIFY2(mpHost->mInstalledPackages.contains(qsl("spec-truncatedxml")), "The package was not registered"); + mpHost->waitForProfileSave(); + QVERIFY2(mpHost->uninstallPackage(qsl("spec-truncatedxml"), enums::PackageModuleType::Package), "The package could not be uninstalled"); + QVERIFY2(!QDir(profileFilePath(qsl("spec-truncatedxml"))).exists(), "Uninstalling left the package folder behind"); + } + + // ...and closing the profile straight after an uninstall must leave nothing + // of that save behind: it would run on a destroyed Host. + void test_deferredSaveDoesNotOutliveTheProfile() + { + const QString packageName = qsl("uninstall-save-teardown"); + QSignalSpy saveSpy(mpHost, &Host::profileSaveStarted); + uninstallPackageOwingASave(packageName); + + // The close path Mudlet takes when the application is closed + // (mudlet::closeEvent): forceClose() keeps TMainConsole::closeEvent() + // from asking whether to save, which would block on a modal dialog. + // deleteHost() is the step of the mudlet::closeHost() that follows which + // destroys the Host - the rest of it is tab and dock bookkeeping, and is + // private to mudlet. + mpHost->forceClose(); + QVERIFY2(mpHost->requestClose(), "Closing the profile was refused"); + QVERIFY2(!mpHost->hasPendingProfileSave(), "Closing the profile left a package save still owed"); + // Dropping that save is only right because the uninstall reached the disk + // on the way out - by the close's own save, or by the deferred one going + // first. Assert the profile that was written, not that a save was tried: + QVERIFY2(saveSpy.count() >= 1, "Closing the profile after an uninstall saved it nowhere"); + QVERIFY2(!lastSavedProfileContains(mProfileName, packageName), "The saved profile still carries the uninstalled package"); + mpHost = nullptr; + mudlet::self()->getHostManager().deleteHost(mProfileName); + + // Nothing the uninstall queued may reach the destroyed Host now. Under + // AddressSanitizer a queued save that does reach it aborts the run here; + // without the sanitizer, the save it writes is what gives it away. + const QStringList savedBefore = savedProfileFiles(mProfileName); + QTest::qWait(500ms); + QCOMPARE(savedProfileFiles(mProfileName), savedBefore); + } +}; + +void initializeQRCResourcesForPackageUninstallSaveTeardownTest() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +#include "PackageUninstallSaveTeardownTest.moc" +QTEST_MAIN(PackageUninstallSaveTeardownTest) From 49dd25f106ee3691fc13d2138c2c0a489f67e923 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Thu, 6 Aug 2026 06:05:42 +0200 Subject: [PATCH 097/155] infrastructure: take re-entrancy depth counts off with scope guards (#9687) #### Brief overview of PR changes/additions - Converts the hand-balanced re-entrancy depth counters to `qScopeGuard`, matching the pattern already used by `TTimer`, `TAction`, `TScript` and `Host`: `cTelnet::mDecompressionRecursionDepth` (four exits across a ~290-line function), `cTelnet::mLoopbackProcessingDepth`, and `mProcessingDepth` in `AliasUnit`, `TriggerUnit` and `KeyUnit`. - Strictly behaviour-preserving. Each guard fires exactly where the manual decrement did, `Q_ASSERT` and the depth-0 drain (`doCleanup()`, `mRootNodesAddedWhileProcessing.clear()`) included, and the over-limit cap still trips on the same value and reports the same message. The recursion cap moves from a file-local constant to `cTelnet::scmMaxDecompressionRecursion` next to its sibling so a test can pin the threshold. - Adds `AliasUnit::processingDepth()` and `KeyUnit::processingDepth()` (mirroring `TriggerUnit` and `ActionUnit`), a new `UnitProcessingDepthTest` and a new slot in `cTelnetBufferTest` that drive each converted exit and assert the count comes back - including an item that deletes itself mid-pass, so the drain step is covered too. #### Motivation for adding to Mudlet The counters are members, so a level leaked by a future early `return` is permanent for that object rather than for that call. Eight leaks in `cTelnet::mDecompressionRecursionDepth` and the connection refuses all further data for the rest of the session, endlessly printing "Too much data to process at once, some may have been lost" - a sticky, crash-free hang that no test or sanitizer would catch. `KeyUnit::processDataStream()` had the same hazard in miniature: it returned from inside its match loop, so a second copy of the decrement-assert-drain block had to be kept in step by hand (and it ran `doCleanup()` while the range-`for` over the list it deletes from was still in scope). All of these are balanced correctly today; this makes it impossible for them not to be. #### Other info (issues closed, discussion etc) Follows up a review note on PR #9677 ("fix: telnet NUL terminator heap overflow"). No behaviour change, so nothing to demo. **Test case:** full `ctest` 72/73 and busted twice (2158 successes / 1 failure), the two failures being `TKeySequenceEditTest` and `UI_spec` `getMainWindowSize`, both reproduced with `src/` reverted to development so neither is from this change; sabotage check - restoring the hand-balanced form with the over-limit decrement omitted, the `KeyUnit` match-exit decrement omitted, and the `AliasUnit` drain omitted turned `cTelnetBufferTest` and `UnitProcessingDepthTest` red on exactly those three points ("a recursion level was leaked", "the drain did not run"), and restoring the guards turned them green. Assisted-by: Claude:claude-opus-5 --- src/AliasUnit.cpp | 15 +- src/AliasUnit.h | 1 + src/KeyUnit.cpp | 20 +- src/KeyUnit.h | 1 + src/TriggerUnit.cpp | 21 +- src/ctelnet.cpp | 25 +- src/ctelnet.h | 16 +- test/functional_tests/CMakeLists.txt | 1 + .../UnitProcessingDepthTest.cpp | 253 ++++++++++++++++++ test/functional_tests/cTelnetBufferTest.cpp | 60 +++++ 10 files changed, 373 insertions(+), 40 deletions(-) create mode 100644 test/functional_tests/UnitProcessingDepthTest.cpp diff --git a/src/AliasUnit.cpp b/src/AliasUnit.cpp index e77b111ec..3ef4aeb7a 100644 --- a/src/AliasUnit.cpp +++ b/src/AliasUnit.cpp @@ -26,6 +26,8 @@ #include "Host.h" #include "TAlias.h" +#include + #include /* We need an explicit constructor in this file as the Host class is forward @@ -282,6 +284,13 @@ bool AliasUnit::processDataStream(const QString& data) auto copyOfNodeList = mAliasRootNodeList; mProcessingDepth++; + const auto processingGuard = qScopeGuard([this] { + mProcessingDepth--; + Q_ASSERT(mProcessingDepth >= 0); + if (mProcessingDepth == 0) { + doCleanup(); + } + }); for (auto alias : copyOfNodeList) { if (!alias->isActive() && !alias->shouldBeActive()) { @@ -293,12 +302,6 @@ bool AliasUnit::processDataStream(const QString& data) } } - mProcessingDepth--; - Q_ASSERT(mProcessingDepth >= 0); - if (mProcessingDepth == 0) { - doCleanup(); - } - // the idea to get "command" after alias processing is finished and send its value // was too difficult for users because if multiple alias change the value of command it becomes too difficult to handle for many users // it's easier if we simply intercepts the command and hand responsibility for diff --git a/src/AliasUnit.h b/src/AliasUnit.h index 6f5b4df15..c4e1ca006 100644 --- a/src/AliasUnit.h +++ b/src/AliasUnit.h @@ -67,6 +67,7 @@ public: int getNewID(); void markCleanup(TAlias* pT); void doCleanup(); + int processingDepth() const { return mProcessingDepth; } QMultiMap mLookupTable; QSet mCleanupSet; diff --git a/src/KeyUnit.cpp b/src/KeyUnit.cpp index cacee3b18..688ea997a 100644 --- a/src/KeyUnit.cpp +++ b/src/KeyUnit.cpp @@ -27,6 +27,8 @@ #include "Host.h" #include "TKey.h" +#include + #include KeyUnit::KeyUnit(Host* pHost) @@ -111,6 +113,13 @@ bool KeyUnit::processDataStream(const Qt::Key key, const Qt::KeyboardModifiers m bool isMatchFound = false; mProcessingDepth++; + const auto processingGuard = qScopeGuard([this] { + mProcessingDepth--; + Q_ASSERT(mProcessingDepth >= 0); + if (mProcessingDepth == 0) { + doCleanup(); + } + }); for (auto keyObject : mKeyRootNodeList) { // Skip null or invalid key objects during profile closing/destruction @@ -120,23 +129,12 @@ bool KeyUnit::processDataStream(const Qt::Key key, const Qt::KeyboardModifiers m if (keyObject->match(key, modifiers, mRunAllKeyMatches)) { if (!mRunAllKeyMatches) { - mProcessingDepth--; - Q_ASSERT(mProcessingDepth >= 0); - if (mProcessingDepth == 0) { - doCleanup(); - } return true; } isMatchFound = true; } } - mProcessingDepth--; - Q_ASSERT(mProcessingDepth >= 0); - if (mProcessingDepth == 0) { - doCleanup(); - } - return isMatchFound; } diff --git a/src/KeyUnit.h b/src/KeyUnit.h index 0c2302583..74b07e5ec 100644 --- a/src/KeyUnit.h +++ b/src/KeyUnit.h @@ -71,6 +71,7 @@ public: bool processDataStream(const Qt::Key, const Qt::KeyboardModifiers); void markCleanup(TKey* pT); void doCleanup(); + int processingDepth() const { return mProcessingDepth; } void stopAllTriggers(); void reenableAllTriggers(); diff --git a/src/TriggerUnit.cpp b/src/TriggerUnit.cpp index dfc82ccca..09532e348 100644 --- a/src/TriggerUnit.cpp +++ b/src/TriggerUnit.cpp @@ -28,6 +28,8 @@ #include "TConsole.h" #include "TTrigger.h" +#include + #include #include @@ -323,6 +325,16 @@ void TriggerUnit::processDataStream(const QString& data, int line) subject[utf8Length] = '\0'; mProcessingDepth++; + const auto processingGuard = qScopeGuard([this] { + mProcessingDepth--; + Q_ASSERT(mProcessingDepth >= 0); + if (mProcessingDepth == 0) { + // Deletion is deferred while any pass runs, so these pointers stayed + // valid; drop them before doCleanup() frees the underlying triggers. + mRootNodesAddedWhileProcessing.clear(); + doCleanup(); + } + }); // Iterate a snapshot of the root list: a trigger's Lua script can call // uninstallPackage()/installPackage() and mutate mTriggerRootNodeList @@ -355,15 +367,6 @@ void TriggerUnit::processDataStream(const QString& data, int line) trigger->match(subject, data, line); } free(subject); - - mProcessingDepth--; - Q_ASSERT(mProcessingDepth >= 0); - if (mProcessingDepth == 0) { - // Deletion is deferred while any pass runs, so these pointers stayed - // valid; drop them before doCleanup() frees the underlying triggers. - mRootNodesAddedWhileProcessing.clear(); - doCleanup(); - } } void TriggerUnit::compileAll() diff --git a/src/ctelnet.cpp b/src/ctelnet.cpp index 2bb176db2..e56c62687 100644 --- a/src/ctelnet.cpp +++ b/src/ctelnet.cpp @@ -61,6 +61,7 @@ #include #include #include +#include #include #include #include @@ -85,13 +86,6 @@ constexpr size_t BUFFER_SIZE = 100000L; // accumulation buffer without bound across reads. constexpr size_t MAX_TELNET_SUBNEGOTIATION_LENGTH = 5_MB; -// How many times processSocketData() may re-enter itself to drain data left -// over after a decompression pass (compressed input that did not fit in one -// output buffer, or plain data following the compressed stream). Each level -// puts ~100 KB (out_buffer) on the stack, so this also caps decompressed -// output at ~MAX_DECOMPRESSION_RECURSION * BUFFER_SIZE per socket read, which -// bounds a decompression bomb. -constexpr int MAX_DECOMPRESSION_RECURSION = 8; // TODO: https://github.com/Mudlet/Mudlet/issues/5780 (1 of 7) - investigate switching from using `char[]` to `std::array` char loadBuffer[BUFFER_SIZE + 1]; int loadedBytes; @@ -5039,11 +5033,21 @@ void cTelnet::processSocketData(char* in_buffer, int amount, const bool loopback // each level allocates ~100 KB on the stack for out_buffer. Per-connection // (a member, not thread-wide) so one profile's drain - or a re-entrant // feedTelnet() - cannot spend another connection's budget. - if (++mDecompressionRecursionDepth > MAX_DECOMPRESSION_RECURSION) { + // Being a member, a level leaked by an early return would be permanent: + // scmMaxDecompressionRecursion of them and the connection refuses all further + // data, so the count comes off in a guard rather than at each return. + ++mDecompressionRecursionDepth; + const auto recursionGuard = qScopeGuard([this] { + --mDecompressionRecursionDepth; + // A second decrement reinstated on any of the exits below would drive + // the count negative and quietly disable the cap altogether: + Q_ASSERT(mDecompressionRecursionDepth >= 0); + }); + + if (mDecompressionRecursionDepth > scmMaxDecompressionRecursion) { qWarning() << "cTelnet::processSocketData(...) WARNING - recursion depth exceeded, dropping remaining data"; //: Shown when too much data expands out of one compressed read (e.g. a decompression bomb) to process safely. postMessage(tr("[ WARN ] - Too much data to process at once, some may have been lost.")); - --mDecompressionRecursionDepth; return; } @@ -5055,7 +5059,6 @@ void cTelnet::processSocketData(char* in_buffer, int amount, const bool loopback // same rather than testing for -1 exactly. Terminating before this point is // what wrote a NUL outside the caller's buffer - see issue #1065. if (amount <= 0) { - --mDecompressionRecursionDepth; return; } // Restates the input contract for decompressBuffer() below, which may swap @@ -5312,7 +5315,6 @@ Some data loss is likely - please mention this problem to the game admins.)", // compressed stream). finalize() runs only at the deepest level. if (remainingData && remainingAmount > 0) { processSocketData(remainingData, remainingAmount, loopbackTesting); - --mDecompressionRecursionDepth; return; } @@ -5321,7 +5323,6 @@ Some data loss is likely - please mention this problem to the game admins.)", } mRecordLastChunkMSecTimeOffset = mRecordingChunkTimer.elapsed(); - --mDecompressionRecursionDepth; } void cTelnet::raiseProtocolEvent(const QString& name, const QString& protocol) diff --git a/src/ctelnet.h b/src/ctelnet.h index f6375f59a..32d3c52eb 100644 --- a/src/ctelnet.h +++ b/src/ctelnet.h @@ -36,6 +36,7 @@ #include #include #include +#include #include #if defined(QT_NO_SSL) #include @@ -242,14 +243,23 @@ public: void loopbackTest(QByteArray& data) { ++mLoopbackProcessingDepth; + const auto loopbackGuard = qScopeGuard([this] { + --mLoopbackProcessingDepth; + }); processSocketData(data.data(), data.size(), true); - --mLoopbackProcessingDepth; } int loopbackProcessingDepth() const { return mLoopbackProcessingDepth; } // Each nested processSocketData() puts ~100KB of buffers on the stack, so a // self-feeding feedTelnet() loop overflows a 1MB (Windows) stack in only ~8 // levels - hence a much lower cap than TriggerUnit::scmMaxProcessingDepth. inline static const int scmMaxLoopbackProcessingDepth = 5; + // How many times processSocketData() may re-enter itself to drain data left + // over after a decompression pass (compressed input that did not fit in one + // output buffer, or plain data following the compressed stream). Each level + // puts ~100 KB (out_buffer) on the stack, so this also caps decompressed + // output at ~scmMaxDecompressionRecursion * BUFFER_SIZE per socket read, + // which bounds a decompression bomb. + inline static const int scmMaxDecompressionRecursion = 8; void cancelLoginTimers(); void terminateConnection(); bool currentlySecure() const @@ -326,7 +336,9 @@ private: friend class TelnetTlsPromptTest; // Needs to call processSocketData() with a buffer it laid out itself, which - // the public loopbackTest() cannot express - see issue #1065. + // the public loopbackTest() cannot express - see issue #1065 - and to seed + // mDecompressionRecursionDepth so the over-limit refusal can be reached + // without a real decompression bomb. friend class cTelnetBufferTest; #if defined(QT_NO_SSL) diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index 88111b145..12f7ae6af 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -35,6 +35,7 @@ set(FUNCTIONAL_TEST_SOURCES ProfileRoundTripTest.cpp ProfileLoadTempFileTest.cpp PackageSelfUninstallTest.cpp + UnitProcessingDepthTest.cpp PackageUninstallSaveTeardownTest.cpp MapRoundTripTest.cpp MapProgressDialogSeamTest.cpp diff --git a/test/functional_tests/UnitProcessingDepthTest.cpp b/test/functional_tests/UnitProcessingDepthTest.cpp new file mode 100644 index 000000000..faa8fbeb1 --- /dev/null +++ b/test/functional_tests/UnitProcessingDepthTest.cpp @@ -0,0 +1,253 @@ +/*************************************************************************** + * Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +/* + * AliasUnit and KeyUnit count how deeply their processDataStream() is nested so + * that an item deleted mid-pass (the #9337 self-uninstall pattern) is only freed + * once the outermost pass has finished - see the deferral added in #9383. + * + * The count is a member, so a pass that returns without taking its level back + * off leaves the unit permanently "busy": every later doCleanup() declines to + * run and the deferred deletes are never flushed. Nothing crashes and nothing + * warns, which is why these paths are asserted directly. KeyUnit is the one that + * matters most: it returns from inside its match loop as soon as a key fires, + * which is exactly the shape of exit a hand-written decrement gets forgotten on. + * + * Run with: ctest -R UnitProcessingDepthTest -V + */ + +#include + +#include +#include + +#include "AliasUnit.h" +#include "Host.h" +#include "HostManager.h" +#include "KeyUnit.h" +#include "MudletInstanceCoordinator.h" +#include "TKey.h" +#include "TLuaInterpreter.h" +#include "mudlet.h" + +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); +void initializeQRCResourcesForUnitProcessingDepthTest(); + +class UnitProcessingDepthTest : public QObject +{ + Q_OBJECT + +private: + const QString mProfileName = qsl("UnitProcessingDepth-Test"); + QTemporaryDir mConfigDir; + QByteArray mSavedXdg; + Host* mpHost = nullptr; + + // Reads back Lua state through the return value rather than getLuaString(), + // which reports an absolute stack slot and so only answers correctly for the + // first call in a process. + bool luaHolds(const QString& condition) { return mpHost->mLuaInterpreter.compileAndExecuteScript(qsl("assert(%1)").arg(condition)); } + +private slots: + void initTestCase() + { + initializeQRCResourcesForUnitProcessingDepthTest(); + + // Keep the test hermetic: resolve the config dir to a temporary + // directory rather than the user's real profiles. + QVERIFY(mConfigDir.isValid()); + mSavedXdg = qgetenv("XDG_CONFIG_HOME"); + QVERIFY(QDir().mkpath(qsl("%1/mudlet/profiles").arg(mConfigDir.path()))); + qputenv("XDG_CONFIG_HOME", mConfigDir.path().toUtf8()); + + mudlet::start(); + mudlet::self()->setupConfig(); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique("MudletInstanceCoordinator")); + mudlet::self()->init(); + mudlet::self()->setStorePasswordsSecurely(false); + + QVERIFY2(mudlet::self()->getHostManager().addHost(mProfileName, QString(), QString(), QString()), "failed to create the Host"); + mpHost = mudlet::self()->getHostManager().getHost(mProfileName); + QVERIFY(mpHost); + // A bare Host blocks script compilation until the full profile boot + // would normally clear this; the items below need to compile: + mpHost->mBlockScriptCompile = false; + } + + // Applies to every slot, including any added later: a level left on after a + // pass is what silently wedges the unit, so no slot gets to end holding one. + void cleanup() + { + QCOMPARE(mpHost->getKeyUnit()->processingDepth(), 0); + QCOMPARE(mpHost->getAliasUnit()->processingDepth(), 0); + } + + void cleanupTestCase() + { + mpHost = nullptr; + delete mudlet::self(); + mSavedXdg.isNull() ? qunsetenv("XDG_CONFIG_HOME") : qputenv("XDG_CONFIG_HOME", mSavedXdg); + } + + // A key that fires returns from the middle of the match loop; one that does + // not runs the loop out. Both exits owe the unit its level back, and the + // repeat is what makes a leak visible - one leaked level looks like nothing, + // an accumulating count is what actually wedges cleanup. + void keyProcessingDepthIsHandedBackOnEveryExit() + { + auto* keyUnit = mpHost->getKeyUnit(); + QCOMPARE(keyUnit->processingDepth(), 0); + // The exit under test is only taken when this is false, and a match + // reports true either way - so without pinning it, a changed default + // would quietly move this slot onto the fall-through path instead. + QCOMPARE(keyUnit->mRunAllKeyMatches, false); + + QString name = qsl("depthProbeKey"); + QString parent; + QString script = qsl("keyFireCount = (keyFireCount or 0) + 1"); + int keycode = Qt::Key_F7; + int modifier = Qt::NoModifier; + auto [id, message] = mpHost->mLuaInterpreter.startPermKey(name, parent, keycode, modifier, script); + QVERIFY2(id > 0, qPrintable(message)); + + constexpr int passes = 5; + for (int pass = 1; pass <= passes; ++pass) { + QVERIFY2(keyUnit->processDataStream(Qt::Key_F7, Qt::NoModifier), "the probe key did not match, so the return-from-the-loop exit went untested"); + QCOMPARE(keyUnit->processingDepth(), 0); + + QVERIFY2(!keyUnit->processDataStream(Qt::Key_F8, Qt::NoModifier), "an unbound key reported a match"); + QCOMPARE(keyUnit->processingDepth(), 0); + } + + // Proves the matching calls really did run the key's script, so the + // depth assertions above are not passing on a loop that never matched. + QVERIFY2(luaHolds(qsl("keyFireCount == %1").arg(passes)), "the probe key matched but its script did not run once per pass"); + } + + // With mRunAllKeyMatches set, a match no longer returns early and every key + // gets a turn - the other way through the same function. + void keyProcessingDepthIsHandedBackWhenRunningAllMatches() + { + auto* keyUnit = mpHost->getKeyUnit(); + QCOMPARE(keyUnit->processingDepth(), 0); + + QList probeIds; + const bool savedRunAllKeyMatches = keyUnit->mRunAllKeyMatches; + keyUnit->mRunAllKeyMatches = true; + // Hands the unit back exactly as it was found - the flag is global to + // the profile and the F9 probes would otherwise fire in later slots. + const auto restoreGuard = qScopeGuard([keyUnit, savedRunAllKeyMatches, &probeIds] { + keyUnit->mRunAllKeyMatches = savedRunAllKeyMatches; + for (const int probeId : probeIds) { + if (auto* pKey = keyUnit->getKey(probeId)) { + pKey->setIsActive(false); + } + } + }); + + QString parent; + QString script = qsl("allMatchCount = (allMatchCount or 0) + 1"); + int keycode = Qt::Key_F9; + int modifier = Qt::NoModifier; + for (const auto& keyName : {qsl("allMatchProbeA"), qsl("allMatchProbeB")}) { + QString name = keyName; + auto [id, message] = mpHost->mLuaInterpreter.startPermKey(name, parent, keycode, modifier, script); + QVERIFY2(id > 0, qPrintable(message)); + probeIds.append(id); + } + + QVERIFY(keyUnit->processDataStream(Qt::Key_F9, Qt::NoModifier)); + QCOMPARE(keyUnit->processingDepth(), 0); + QVERIFY2(luaHolds(qsl("allMatchCount == 2")), "only one of the two keys bound to F9 ran, so the loop did not carry on past the first match"); + } + + // AliasUnit has the single exit, but the same permanence applies: the level + // has to be back off before the unit is asked to process anything else. + void aliasProcessingDepthIsHandedBackOnEveryExit() + { + auto* aliasUnit = mpHost->getAliasUnit(); + QCOMPARE(aliasUnit->processingDepth(), 0); + + auto [id, message] = mpHost->mLuaInterpreter.startPermAlias(qsl("depthProbeAlias"), QString(), qsl("^probe$"), qsl("aliasFireCount = (aliasFireCount or 0) + 1")); + QVERIFY2(id > 0, qPrintable(message)); + + constexpr int passes = 5; + for (int pass = 1; pass <= passes; ++pass) { + QVERIFY2(aliasUnit->processDataStream(qsl("probe")), "the probe alias did not match"); + QCOMPARE(aliasUnit->processingDepth(), 0); + + QVERIFY2(!aliasUnit->processDataStream(qsl("nothing matches this")), "an unmatched command reported a match"); + QCOMPARE(aliasUnit->processingDepth(), 0); + } + + QVERIFY2(luaHolds(qsl("aliasFireCount == %1").arg(passes)), "the probe alias matched but its script did not run once per pass"); + } + + // What the count is actually for. Both items delete themselves from their + // own script, which the unit has to defer while the pass is on the stack and + // then flush - and the flush is the drain step the guard runs at depth 0. + // Nothing else pumps cleanup here: Host::slot_purgeTemps() needs an event + // loop this test never spins, so if the drain does not run the item survives. + void anItemThatKillsItselfMidPassIsFreedByTheDrain() + { + auto* aliasUnit = mpHost->getAliasUnit(); + const int aliasId = mpHost->mLuaInterpreter.startTempAlias(qsl("^selfkill$"), qsl("killAlias(tostring(selfKillAliasId))")); + QVERIFY(aliasId > 0); + QVERIFY(mpHost->mLuaInterpreter.compileAndExecuteScript(qsl("selfKillAliasId = %1").arg(aliasId))); + QVERIFY2(aliasUnit->getAlias(aliasId), "the temp alias was not registered"); + + QVERIFY2(aliasUnit->processDataStream(qsl("selfkill")), "the self-killing alias did not match"); + QCOMPARE(aliasUnit->processingDepth(), 0); + QVERIFY2(!aliasUnit->getAlias(aliasId), "the alias killed itself mid-pass but was never freed - the drain did not run"); + + auto* keyUnit = mpHost->getKeyUnit(); + int keycode = Qt::Key_F10; + int modifier = Qt::NoModifier; + const int keyId = mpHost->mLuaInterpreter.startTempKey(modifier, keycode, qsl("killKey(tostring(selfKillKeyId))")); + QVERIFY(keyId > 0); + QVERIFY(mpHost->mLuaInterpreter.compileAndExecuteScript(qsl("selfKillKeyId = %1").arg(keyId))); + QVERIFY2(keyUnit->getKey(keyId), "the temp key was not registered"); + + QVERIFY2(keyUnit->processDataStream(Qt::Key_F10, Qt::NoModifier), "the self-killing key did not match"); + QCOMPARE(keyUnit->processingDepth(), 0); + QVERIFY2(!keyUnit->getKey(keyId), "the key killed itself mid-pass but was never freed - the drain did not run"); + } +}; + +void initializeQRCResourcesForUnitProcessingDepthTest() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +#include "UnitProcessingDepthTest.moc" +QTEST_MAIN(UnitProcessingDepthTest) diff --git a/test/functional_tests/cTelnetBufferTest.cpp b/test/functional_tests/cTelnetBufferTest.cpp index c920e9905..134a1e41d 100644 --- a/test/functional_tests/cTelnetBufferTest.cpp +++ b/test/functional_tests/cTelnetBufferTest.cpp @@ -41,6 +41,9 @@ */ #include + +#include + #include #include #include @@ -226,6 +229,63 @@ private slots: } } + // Every exit from processSocketData() has to hand back the recursion level it + // took, including the one that refuses the read outright. That refusal is the + // only exit no other test here reaches, and a level leaked there would be + // permanent for the profile: once enough have piled up the connection stops + // accepting data altogether. Seeding the counter reaches the refusal without + // needing a real decompression bomb to recurse. + // + // Whether the refusal happened is read off the caller's buffer rather than + // the warning text: the refusal returns before the NUL terminator is written, + // so an untouched sentinel means the read was dropped. That also pins the + // threshold exactly, and unlike the posted message it does not depend on the + // interface language. + void recursionDepthIsHandedBackOnEveryExit() + { + constexpr int payloadSize = 12; + const int seededDepthLimit = cTelnet::scmMaxDecompressionRecursion + 3; + // A failed QVERIFY2 below aborts the slot mid-sweep, so put the counter + // back from here rather than at the end - otherwise the seeded value + // survives into cleanup() and the next slot's init(), and one real + // failure reports as three with two of them pointing at the wrong place. + const auto depthRestoreGuard = qScopeGuard([this] { + mpHost->mTelnet.mDecompressionRecursionDepth = 0; + }); + + for (int seededDepth = 0; seededDepth <= seededDepthLimit; ++seededDepth) { + // This read takes the level to seededDepth + 1, which is the value + // the cap is tested against. + const bool expectRefusal = (seededDepth + 1) > cTelnet::scmMaxDecompressionRecursion; + + // A full payload takes the ordinary fall-through exit, 0 and -1 the + // nothing-to-read one; past the cap all three take the refusal. + for (const int amount : {payloadSize, 0, -1}) { + QByteArray backing(payloadSize + 1, 'A'); + backing[payloadSize] = scmTerminatorSlot; + mpHost->mTelnet.mDecompressionRecursionDepth = seededDepth; + + mpHost->mTelnet.processSocketData(backing.data(), amount, true); + + QVERIFY2(mpHost->mTelnet.mDecompressionRecursionDepth == seededDepth, + qPrintable(qsl("processSocketData() came back from a %1 byte read at depth %2 with the depth at %3 - a recursion level was leaked.") + .arg(amount) + .arg(seededDepth) + .arg(mpHost->mTelnet.mDecompressionRecursionDepth))); + + if (amount != payloadSize) { + continue; // a non-positive read never terminates the buffer either way + } + const bool wasRefused = backing.at(payloadSize) == scmTerminatorSlot; + QVERIFY2(wasRefused == expectRefusal, + qPrintable(qsl("at depth %1 of %2 the read was %3 - the over-limit cap moved.") + .arg(seededDepth + 1) + .arg(cTelnet::scmMaxDecompressionRecursion) + .arg(wasRefused ? qsl("dropped") : qsl("processed")))); + } + } + } + // Declared last on purpose: on the unfixed code this trips AddressSanitizer, // which aborts the process, so anything after it would never report. The // sentinels give it teeth on Windows too, where CI builds without ASan. From a099a20aee3072acafd6dedbfaf14d293d743688 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin Date: Thu, 6 Aug 2026 06:07:10 +0200 Subject: [PATCH 098/155] infrastructure: fix milestone assignment, unbreak the key sequence tests (#9679) #### Brief overview of PR changes/additions - `add-milestone` resolves the milestone by exact title first and then by version prefix, so `5.0.0` finds `5.0.0 next release` again, and fails loudly instead of assigning nothing. 191 PRs merged since 4.22.0 have no milestone. - `TKeySequenceEditTest`'s two focus traversal cases no longer fail under a bare Xvfb: ctest pins the offscreen platform on X11, and a direct run without a window manager skips with a message instead of burning the activation timeout twice. #### Motivation for adding to Mudlet Both were failing silently. The milestone step matched a title that no longer exists and exited 0; and the traversal tests were the one red mark in an otherwise green local suite, which everybody had to re-derive as environmental. The milestone lookup is now a script under `.github/scripts/`, covered by a new `MilestoneResolutionTest` that runs it against a stubbed `gh`. Re-introducing the original bug makes that test fail. Worth knowing: `add-milestone` on this PR still assigned nothing, because `pull_request_target` runs the copy of the workflow that is on the base branch. It takes effect for pull requests opened after this merges. #### Other info (issues closed, discussion etc) - Closes #9671 - CI: add-milestone silently assigns nothing - metadata says "4.23.0" but the milestone is titled "4.23.0 next release" - Closes #9575 - TKeySequenceEditTest: two traversal tests fail under bare Xvfb (no window manager) Test case: `ctest -R 'MilestoneResolutionTest|TKeySequenceEditTest'`, plus `xvfb-run --auto-servernum ctest -R TKeySequenceEditTest` for the case #9575 is about. Assisted-by: Claude:claude-opus-5 --- .github/repo-metadata.yml | 2 +- .github/scripts/resolve-milestone.sh | 50 +++++++ .github/workflows/tag-pull-requests.yml | 68 +++++++--- test/CMakeLists.txt | 25 ++++ test/TKeySequenceEditTest.cpp | 31 ++++- test/ci/milestone-resolution-test.sh | 170 ++++++++++++++++++++++++ 6 files changed, 323 insertions(+), 23 deletions(-) create mode 100755 .github/scripts/resolve-milestone.sh create mode 100755 test/ci/milestone-resolution-test.sh diff --git a/.github/repo-metadata.yml b/.github/repo-metadata.yml index 0224a3dd6..0bcb19ce1 100644 --- a/.github/repo-metadata.yml +++ b/.github/repo-metadata.yml @@ -2,4 +2,4 @@ milestones: # assign new PRs to this milestone - next-milestone: 4.23.0 + next-milestone: 5.0.0 diff --git a/.github/scripts/resolve-milestone.sh b/.github/scripts/resolve-milestone.sh new file mode 100755 index 000000000..ccb65c02c --- /dev/null +++ b/.github/scripts/resolve-milestone.sh @@ -0,0 +1,50 @@ +#!/usr/bin/env bash +# +# Turns the version in .github/repo-metadata.yml into the number of the matching +# open milestone, and prints " ". +# +# Milestone titles carry a suffix in practice - "4.23.0 next release" for a +# metadata value of "4.23.0" - so the exact-title match this replaces found +# nothing, set an empty number, and exited 0, leaving every pull request in the +# repository unassigned without ever failing (#9671). Anything short of exactly +# one match is now an error, so a renamed milestone cannot go unnoticed again. +# +# Diagnostics go to stderr, because stdout is this script's answer. +# +# Inputs, all from the environment: +# REPO owner/name of the repository (required) +# NEXT_MILESTONE version to look for (required) +# GH_TOKEN token for the gh call + +set -euo pipefail + +: "${REPO:?REPO must be set}" +: "${NEXT_MILESTONE:?NEXT_MILESTONE must be set}" + +if ! milestones=$(gh api "repos/${REPO}/milestones?state=open&per_page=100"); then + echo "::error::Could not read the open milestones of ${REPO}" >&2 + exit 1 +fi + +# An exact title wins outright; otherwise the version has to be the leading word +# of exactly one title, so a genuinely ambiguous set is refused rather than +# guessed at +matches=$(jq -c --arg wanted "${NEXT_MILESTONE}" '[.[] | select(.title == $wanted)]' <<< "${milestones}") +if [ "$(jq 'length' <<< "${matches}")" -eq 0 ]; then + matches=$(jq -c --arg wanted "${NEXT_MILESTONE}" \ + '[.[] | select(.title | startswith($wanted + " "))]' <<< "${milestones}") +fi + +match_count=$(jq 'length' <<< "${matches}") + +if [ "${match_count}" -eq 0 ]; then + echo "::error::No open milestone matches '${NEXT_MILESTONE}' from .github/repo-metadata.yml. Open milestones: $(jq -r '[.[].title] | join(", ")' <<< "${milestones}")" >&2 + exit 1 +fi + +if [ "${match_count}" -gt 1 ]; then + echo "::error::'${NEXT_MILESTONE}' matches several open milestones, so which one to use is not clear: $(jq -r '[.[].title] | join(", ")' <<< "${matches}")" >&2 + exit 1 +fi + +jq -r '"\(.[0].number) \(.[0].title)"' <<< "${matches}" diff --git a/.github/workflows/tag-pull-requests.yml b/.github/workflows/tag-pull-requests.yml index 7ab75a4a0..379fcd128 100644 --- a/.github/workflows/tag-pull-requests.yml +++ b/.github/workflows/tag-pull-requests.yml @@ -5,13 +5,17 @@ on: permissions: contents: read + issues: read jobs: add-milestone: runs-on: ubuntu-latest + if: ${{ github.repository_owner == 'Mudlet' }} steps: - uses: actions/checkout@v7 + with: + persist-credentials: false - name: Get next milestone id: next-milestone-string @@ -20,30 +24,56 @@ jobs: cmd: yq eval '.milestones.next-milestone' '.github/repo-metadata.yml' - name: 'Convert milestone to Github #' - id: next-milestone-number + env: + # authenticated so this does not share the per-IP anonymous rate limit + # with every other job on the runner's address + GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} + REPO: ${{ github.repository }} + NEXT_MILESTONE: ${{ steps.next-milestone-string.outputs.result }} run: | - MILESTONE_NUMBER=$(curl --silent --request GET \ - --url https://api.github.com/repos/Mudlet/Mudlet/milestones \ - -H "Accept: application/vnd.github.v3+json" | \ - jq '.[] | select(.title == "${{ steps.next-milestone-string.outputs.result }}").number') + set -euo pipefail - echo "MILESTONE_NUMBER=$MILESTONE_NUMBER" >> "$GITHUB_ENV" + # Plain assignment, not a process substitution, so a failure to resolve + # the milestone stops the job instead of being read as an empty answer + if ! resolved=$(.github/scripts/resolve-milestone.sh); then + exit 1 + fi + + read -r number title <<< "${resolved}" + echo "Milestone: ${title}" + echo "MILESTONE_NUMBER=${number}" >> "$GITHUB_ENV" + echo "MILESTONE_TITLE=${title}" >> "$GITHUB_ENV" - name: Assign PR to milestone env: - TOKEN: ${{ secrets.GH_PAT_UPDATE_PULL_REQUESTS }} + GH_TOKEN: ${{ secrets.GH_PAT_UPDATE_PULL_REQUESTS }} + REPO: ${{ github.repository }} + PR_NUMBER: ${{ github.event.pull_request.number }} run: | - # Fetch pull request details - PR_DETAILS=$(curl -s --request GET \ - -H "Accept: application/vnd.github.v3+json" \ - --url ${{ github.event.pull_request.issue_url }} \ - --header "authorization: token $TOKEN") + set -euo pipefail - # Check if the pull request has a milestone already - if [ $(echo "$PR_DETAILS" | jq '.milestone == null') == "true" ]; then - curl -s --request PATCH \ - -H "Accept: application/vnd.github.v3+json" \ - --url ${{ github.event.pull_request.issue_url }} \ - --header "authorization: token $TOKEN" \ - --data '{"milestone": '"$MILESTONE_NUMBER"'}' + if [ -z "${GH_TOKEN:-}" ]; then + echo "::error::GH_PAT_UPDATE_PULL_REQUESTS is not available, so the milestone cannot be set" + exit 1 fi + + if [ -z "${MILESTONE_NUMBER:-}" ]; then + echo "::error::No milestone number was resolved by the previous step" + exit 1 + fi + + # Captured rather than tested inline, because a failed read inside the + # test would look identical to "has no milestone" and overwrite one that + # somebody set on purpose + if ! existing=$(gh api "repos/${REPO}/issues/${PR_NUMBER}" --jq '.milestone.number // empty'); then + echo "::error::Could not read the current milestone of #${PR_NUMBER}" + exit 1 + fi + + if [ -n "${existing}" ]; then + echo "#${PR_NUMBER} is already on milestone ${existing}, leaving it as it is" + exit 0 + fi + + gh api --method PATCH "repos/${REPO}/issues/${PR_NUMBER}" -F "milestone=${MILESTONE_NUMBER}" --silent + echo "Assigned #${PR_NUMBER} to milestone ${MILESTONE_TITLE}" diff --git a/test/CMakeLists.txt b/test/CMakeLists.txt index 7f3e95178..ea08cd842 100644 --- a/test/CMakeLists.txt +++ b/test/CMakeLists.txt @@ -50,6 +50,22 @@ foreach(test_name ${UNIT_TESTS}) ) endforeach() +# TKeySequenceEditTest's focus traversal cases need an active window, which an X +# server with no window manager never gives them, so a plain `xvfb-run ctest` +# reported two failures that meant nothing and cost the activation timeout twice +# (#9575). The offscreen platform synthesises activation, and is already how the +# Linux CI job runs the whole suite. Only on X11: macOS and Windows have a real +# window manager, and running there natively is the only coverage of platform +# focus traversal there is. APPEND so the sanitizer setting above survives. +if(UNIX AND NOT APPLE) + set_property(TEST TKeySequenceEditTest APPEND PROPERTY ENVIRONMENT "QT_QPA_PLATFORM=offscreen") +endif() + +# Every ctest run has a display that can activate a window, one way or the other, +# so a skipped traversal case there is a regression and not an environment. Only +# somebody running the binary by hand on a bare X server is allowed the skip. +set_property(TEST TKeySequenceEditTest APPEND PROPERTY ENVIRONMENT "MUDLET_REQUIRE_WINDOW_ACTIVATION=1") + # DiscordTest checks the Lua API permission gating contract by scanning the source target_compile_definitions(DiscordTest PRIVATE MUDLET_SRC_DIR="${CMAKE_SOURCE_DIR}/src") @@ -86,4 +102,13 @@ if(NOT WIN32) ) endif() +# Checks the milestone lookup that add-milestone runs - the one that matched a +# title that no longer existed and assigned nothing for months, without ever +# failing. gh is stubbed, so there is no network and no token +if(NOT WIN32) + add_test(NAME MilestoneResolutionTest + COMMAND bash ${CMAKE_CURRENT_SOURCE_DIR}/ci/milestone-resolution-test.sh + ) +endif() + add_subdirectory(functional_tests) diff --git a/test/TKeySequenceEditTest.cpp b/test/TKeySequenceEditTest.cpp index b9e006555..e90020032 100644 --- a/test/TKeySequenceEditTest.cpp +++ b/test/TKeySequenceEditTest.cpp @@ -25,6 +25,26 @@ #include <QVBoxLayout> #include <QtTest/QtTest> +static constexpr const char* activationUnavailableMessage = "the window never became active, so focus traversal cannot be exercised - this " + "display has no window manager. Run the suite through ctest, or set " + "QT_QPA_PLATFORM=offscreen, or start a window manager such as openbox."; + +// Shared by the two traversal cases, because QSKIP and QFAIL only work from the +// test function itself and the two must not drift apart. ctest sets +// MUDLET_REQUIRE_WINDOW_ACTIVATION because every display it runs against can +// activate a window, so a skip there would be hiding a regression rather than +// reporting an environment - the same floor MUDLET_MEDIA_TESTS_REQUIRE_PLAYBACK +// puts under the media tests. +#define REQUIRE_WINDOW_ACTIVATION(window) \ + do { \ + if (!QTest::qWaitForWindowActive(&(window))) { \ + if (qEnvironmentVariableIsSet("MUDLET_REQUIRE_WINDOW_ACTIVATION")) { \ + QFAIL(activationUnavailableMessage); \ + } \ + QSKIP(activationUnavailableMessage); \ + } \ + } while (false) + // Pins the accessibility behaviour that TKeySequenceEdit adds on top of the // stock QKeySequenceEdit (#8873). Key events are sent to the inner QLineEdit // because that is where keyboard focus lives via the focus proxy. @@ -155,7 +175,12 @@ private slots: // The traversal tests need real focus movement: the capture is committed // by the focus-out that the traversal causes, mirroring how the stock - // widget commits in focusOutEvent() when Tab moves focus away. + // widget commits in focusOutEvent() when Tab moves focus away. Qt only + // delivers those focus events while the window is active, and nothing + // activates a window on an X server without a window manager, so on such a + // display these two cases are skipped rather than failed (#9575). Under + // ctest they never get that far: the offscreen platform is pinned there, + // and it synthesises activation. void shiftBacktabCommitsCaptureAndMovesFocusBackwards() { QWidget window; @@ -165,7 +190,7 @@ private slots: layout->addWidget(neighbour); layout->addWidget(edit); window.show(); - QVERIFY(QTest::qWaitForWindowActive(&window)); + REQUIRE_WINDOW_ACTIVATION(window); edit->setFocus(); auto* lineEdit = edit->findChild<QLineEdit*>(); @@ -191,7 +216,7 @@ private slots: layout->addWidget(edit); layout->addWidget(neighbour); window.show(); - QVERIFY(QTest::qWaitForWindowActive(&window)); + REQUIRE_WINDOW_ACTIVATION(window); edit->setFocus(); auto* lineEdit = edit->findChild<QLineEdit*>(); diff --git a/test/ci/milestone-resolution-test.sh b/test/ci/milestone-resolution-test.sh new file mode 100755 index 000000000..44c9f261e --- /dev/null +++ b/test/ci/milestone-resolution-test.sh @@ -0,0 +1,170 @@ +#!/bin/bash +# Tests .github/scripts/resolve-milestone.sh, whose whole job is to not fail +# quietly. +# +# It replaces a jq filter that matched a milestone title exactly. The real title +# had picked up a suffix, so it matched nothing, produced an empty milestone +# number and exited 0 - every pull request in the repository went unassigned for +# months without one red check (#9671). +# +# gh is stubbed from GH_STUB_DIR, so this needs no network and no token. + +set -uo pipefail + +SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" +SCRIPTS_DIR="$(cd "${SCRIPT_DIR}/../../.github/scripts" && pwd)" + +WORK_DIR="$(mktemp -d)" +trap 'rm -rf "${WORK_DIR}"' EXIT + +FAILURES=0 + +start_test() { + echo "=== $1" +} + +fail() { + echo " FAIL: $*" >&2 + FAILURES=$((FAILURES + 1)) +} + +assert_status() { + local expected="$1" actual="$2" + if [ "${actual}" -ne "${expected}" ]; then + fail "expected exit ${expected}, got ${actual}" + fi +} + +assert_contains() { + local file="$1" needle="$2" + if ! grep -qF -- "${needle}" "${file}"; then + fail "expected '${needle}' in ${file}:" + sed 's/^/ /' "${file}" >&2 + fi +} + +assert_absent() { + local file="$1" needle="$2" + if grep -qF -- "${needle}" "${file}"; then + fail "did not expect '${needle}' in ${file}:" + sed 's/^/ /' "${file}" >&2 + fi +} + +# A stand-in for the gh CLI that answers from files, so the script can be handed +# a milestone listing without a network call or a token +new_stub() { + local dir="${WORK_DIR}/$1" + rm -rf "${dir}" + mkdir -p "${dir}/bin" + cat > "${dir}/bin/gh" <<'STUB' +#!/usr/bin/env bash +set -u + +key=unknown +for arg in "$@"; do + case "${arg}" in + *milestones*) key=milestones ;; + esac +done + +if [ -f "${GH_STUB_DIR}/${key}.fail" ]; then + echo "gh: simulated API failure for ${key}" >&2 + exit 1 +fi +if [ -f "${GH_STUB_DIR}/${key}.out" ]; then + cat "${GH_STUB_DIR}/${key}.out" +fi +exit 0 +STUB + chmod +x "${dir}/bin/gh" + STUB_DIR="${dir}" +} + +# The script takes every input from the environment, so the environment is built +# from nothing rather than inherited: `env -i`, and not a bare assignment prefix, +# so that nothing the surrounding CI job exported can reach it. +run_resolve_milestone() { + env -i \ + PATH="${STUB_DIR}/bin:${PATH}" \ + HOME="${WORK_DIR}" \ + GH_STUB_DIR="${STUB_DIR}" \ + REPO=Mudlet/Mudlet \ + NEXT_MILESTONE="$1" \ + bash "${SCRIPTS_DIR}/resolve-milestone.sh" > "${STUB_DIR}/out.log" 2>&1 +} + +#----------------------------------------------------------------------------- +# The repository's real open milestones. "5.0 beginner-friendly" sitting next to +# "5.0.0 next release" is the reason the prefix match is anchored on a following +# space rather than being a bare startswith +MILESTONES='[{"number":18,"title":"5.0 beginner-friendly"}, + {"number":62,"title":"future release"}, + {"number":64,"title":"5.0.0 next release"}]' + +start_test "a suffixed milestone title still matches the bare version (#9671)" +new_stub milestone-prefix +printf '%s\n' "${MILESTONES}" > "${STUB_DIR}/milestones.out" +run_resolve_milestone 5.0.0 +assert_status 0 $? +assert_contains "${STUB_DIR}/out.log" '64 5.0.0 next release' + +#----------------------------------------------------------------------------- +start_test "a shorter milestone that shares a prefix is not swept in" +new_stub milestone-shared-prefix +printf '%s\n' "${MILESTONES}" > "${STUB_DIR}/milestones.out" +run_resolve_milestone 5.0 +assert_status 0 $? +assert_contains "${STUB_DIR}/out.log" '18 5.0 beginner-friendly' +assert_absent "${STUB_DIR}/out.log" '5.0.0 next release' + +#----------------------------------------------------------------------------- +start_test "an exact title wins over a longer one that also starts with it" +new_stub milestone-exact +printf '%s\n' '[{"number":64,"title":"5.0.0 next release"},{"number":70,"title":"5.0.0"}]' \ + > "${STUB_DIR}/milestones.out" +run_resolve_milestone 5.0.0 +assert_status 0 $? +assert_contains "${STUB_DIR}/out.log" '70 5.0.0' + +#----------------------------------------------------------------------------- +start_test "a version that matches no milestone fails and says what is open" +new_stub milestone-none +printf '%s\n' "${MILESTONES}" > "${STUB_DIR}/milestones.out" +run_resolve_milestone 4.99.0 +assert_status 1 $? +assert_contains "${STUB_DIR}/out.log" '::error::No open milestone matches' +assert_contains "${STUB_DIR}/out.log" '5.0.0 next release' + +#----------------------------------------------------------------------------- +start_test "a version that matches several milestones is refused, not guessed" +new_stub milestone-ambiguous +printf '%s\n' '[{"number":64,"title":"5.0.0 next release"},{"number":71,"title":"5.0.0 stretch goals"}]' \ + > "${STUB_DIR}/milestones.out" +run_resolve_milestone 5.0.0 +assert_status 1 $? +assert_contains "${STUB_DIR}/out.log" 'matches several open milestones' + +#----------------------------------------------------------------------------- +start_test "a near miss on the version does not match" +new_stub milestone-nearmiss +printf '%s\n' "${MILESTONES}" > "${STUB_DIR}/milestones.out" +run_resolve_milestone 5.0.1 +assert_status 1 $? +assert_contains "${STUB_DIR}/out.log" '::error::No open milestone matches' + +#----------------------------------------------------------------------------- +start_test "a failed milestone read is loud" +new_stub milestone-fails +touch "${STUB_DIR}/milestones.fail" +run_resolve_milestone 5.0.0 +assert_status 1 $? +assert_contains "${STUB_DIR}/out.log" '::error::Could not read the open milestones' + +#----------------------------------------------------------------------------- +echo +if [ "${FAILURES}" -gt 0 ]; then + echo "${FAILURES} check(s) FAILED" + exit 1 +fi +echo "All checks passed" From 887b930e4746bf044cce726fdc0c3d759ceb7c16 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Thu, 6 Aug 2026 06:08:40 +0200 Subject: [PATCH 099/155] fix: module save reaching into the profile after it is destroyed (#9690) #### Brief overview of PR changes/additions - A profile save hands the modules that are set to sync to a thread pool task and returns. Two closes wait for nothing - answering "No" to "Save profile?", and any close that finds the main console already gone - so the `Host` is destroyed with the write still going, and the write went on reading it: its `XMLexport`, and then its name. The job now carries its own copy of each module's document plus every path it needs, and `writeModuleFiles()`/`updateModuleZip()` are static, so nothing it touches belongs to the profile. - Both save watchers are now owned by the profile that made them. They were unparented, and the `deleteLater()` they are wired to needs an event loop that is still running to be delivered - which on the way out there is not, and for a destroyed `Host` there is no owner left either. - The unpacked module folder is created before the write that goes into it rather than after, so a module whose folder the user removed no longer fails to write and then loses its stale XML from its archive with no replacement going in. #### Motivation for adding to Mudlet Save a profile that has a module set to sync - Lua `saveProfile()`, the editor's autosave, a package install - then close the profile without saving. That is a crash or a half-rewritten `.mpackage` on the way out, i.e. another "Mudlet crashed when I closed it". Same shape as #9653, and it survived 850 sanitizer runs only because no test profile had a module in it: with none installed the save's module list comes out empty and the write returns at its first line, so the entire path was unreachable in the fixtures. #### Other info (issues closed, discussion etc) Test case: install a module, `enableModuleSync()` it, `saveProfile()`, then close the profile answering "No" - Mudlet exits cleanly and the module still lands on disk and in its archive. New `ModuleSaveTeardownTest` is the module coverage that was missing anywhere in the tree - no C++ test installed a module at all. It holds the thread pool so the write is provably still queued when the `Host` is destroyed, then lets it run: without the fix that kills the run under AddressSanitizer inside `Host::writeModuleFiles()`. The watcher half is pinned by asserting the watchers are owned by the profile and gone with it, because LSan cannot see this one (a pending `QFutureCallOutEvent` keeps it reachable at exit) and the functional tests run with `detect_leaks=0` anyway. `Package_spec.lua` gains a synced-module save so the write also runs under the busted job's leak-checked ASan. Assisted-by: Claude:claude-opus-5 --- src/Host.cpp | 91 +-- src/Host.h | 38 +- src/XMLexport.cpp | 38 +- src/XMLexport.h | 4 +- src/mudlet-lua/tests/Package_spec.lua | 34 ++ test/functional_tests/CMakeLists.txt | 1 + .../ModuleSaveTeardownTest.cpp | 523 ++++++++++++++++++ 7 files changed, 661 insertions(+), 68 deletions(-) create mode 100644 test/functional_tests/ModuleSaveTeardownTest.cpp diff --git a/src/Host.cpp b/src/Host.cpp index 7fd73fe67..eaf76eb3c 100644 --- a/src/Host.cpp +++ b/src/Host.cpp @@ -667,10 +667,12 @@ QList<Host::ModuleWriteJob> Host::prepareModuleSaves(bool backup) { // Runs on the main thread so it can safely read the live trigger/timer/... lists // (via writeModuleXML) and mutate the `writers`/`mModulesToSync`/`modulesToWrite` - // bookkeeping. The returned jobs carry everything writeModuleFiles() needs, so the - // background task never touches any of that shared state. + // bookkeeping. The returned jobs carry everything writeModuleFiles() needs - the + // document and every path - so the background task touches neither that shared + // state nor the Host, which may well be destroyed before the task even starts. QList<ModuleWriteJob> jobs; mModulesToSync.clear(); + const QString backupPath = backup ? mudlet::getMudletPath(enums::moduleBackupsPath) : QString(); QMapIterator<QString, QStringList> it(modulesToWrite); while (it.hasNext()) { it.next(); @@ -685,42 +687,53 @@ QList<Host::ModuleWriteJob> Host::prepareModuleSaves(bool backup) QString xmlFilename = filename; if (filename.endsWith(qsl("mpackage"), Qt::CaseInsensitive) || filename.endsWith(qsl("zip"), Qt::CaseInsensitive)) { xmlFilename = mudlet::getMudletPath(enums::profilePackagePathFileName, mHostName, moduleName); + // The write below goes into this folder, so it has to exist before the + // write and not - as it used to - after it: a module whose unpacked folder + // the user has removed would otherwise fail to write, and then have its + // now-stale XML dropped from its archive without a replacement going in. + const QString packagePath = mudlet::getMudletPath(enums::profilePackagePath, mHostName, moduleName); + if (auto packageDir = QDir(packagePath); !packageDir.exists()) { + packageDir.mkpath(packagePath); + } } auto writer = std::make_shared<XMLexport>(this); writer->writeModuleXML(moduleName); - // `writers` is the sole owner; the job carries a non-owning pointer so the - // XMLexport is only ever destroyed on the main thread (via xmlSaved()). + // The writer stays in `writers` purely as the save-in-progress token that + // xmlSaved() retires on the main thread, so the XMLexport - a QObject with + // main-thread affinity - is only ever destroyed there. What gets written out + // is the job's own copy of the document, which outlives both of them. writers.insert(xmlFilename, writer); - jobs.append({writer.get(), moduleName, filename, xmlFilename, backup}); + jobs.append({writer->cloneExportDocument(), moduleName, filename, xmlFilename, backup ? backupPath + moduleName : QString()}); if (entry.at(1).toInt()) { mModulesToSync << moduleName; } } modulesToWrite.clear(); + if (!backupPath.isEmpty() && !jobs.isEmpty()) { + auto backupDir = QDir(backupPath); + if (!backupDir.exists()) { + backupDir.mkpath(backupPath); + } + } return jobs; } void Host::writeModuleFiles(const QList<ModuleWriteJob>& jobs) { - // Runs on a background thread: pure file I/O, no access to shared save-bookkeeping. - if (jobs.isEmpty()) { - return; - } - const QString savePath = mudlet::getMudletPath(enums::moduleBackupsPath); - auto savePathDir = QDir(savePath); - if (!savePathDir.exists()) { - savePathDir.mkpath(savePath); - } + // Pure file I/O over self-contained jobs, usually on a thread pool thread. It is + // static because a close that answers "No" to "Save profile?", and one that finds + // the main console already gone, wait for nothing: the Host that ordered these + // writes can be, and regularly is, destroyed while they are still queued. for (const auto& job : jobs) { - if (job.backup) { - createModuleBackup(job.filename, savePath + job.moduleName); + if (!job.backupName.isEmpty()) { + createModuleBackup(job.filename, job.backupName); } - if (!job.writer->saveModuleXml(job.xmlFilename)) { + if (!XMLexport::saveXmlDocToFile(job.xmlFilename, *job.document)) { qWarning().noquote().nospace() << "Host::writeModuleFiles() WARNING - failed to write module \"" << job.moduleName << "\" to \"" << job.xmlFilename << "\"."; } - updateModuleZips(job.filename, job.moduleName); + updateModuleZip(job); } } @@ -754,14 +767,17 @@ void Host::reloadModules() mModulesToSync.clear(); } -void Host::updateModuleZips(const QString& zipName, const QString& moduleName) +void Host::updateModuleZip(const ModuleWriteJob& job) { + // Static for the same reason writeModuleFiles() is: every path it needs was + // resolved, and every folder it needs created, on the main thread beforehand. + const QString zipName = job.filename; + const QString moduleName = job.moduleName; if (!(zipName.endsWith(qsl("mpackage"), Qt::CaseInsensitive) || zipName.endsWith(qsl("zip"), Qt::CaseInsensitive))) { return; } zip* zipFile = nullptr; - const QString packagePathName = mudlet::getMudletPath(enums::profilePackagePath, mHostName, moduleName); - const QString filename_xml = mudlet::getMudletPath(enums::profilePackagePathFileName, mHostName, moduleName); + const QString filename_xml = job.xmlFilename; int err = 0; zipFile = zip_open(zipName.toStdString().c_str(), ZIP_CREATE, &err); if (!zipFile) { @@ -774,15 +790,11 @@ void Host::updateModuleZips(const QString& zipName, const QString& moduleName) existing file that is to be overwritten may be a source of problems here. */ - qWarning().noquote().nospace() << "Host::updateModuleZips(\"" << zipName << "\", \"" << moduleName << "\") WARNING - failed to open module to update it, error: \"" + qWarning().noquote().nospace() << "Host::updateModuleZip(\"" << zipName << "\", \"" << moduleName << "\") WARNING - failed to open module to update it, error: \"" << zip_error_strerror(&zipError) << "\""; zip_error_fini(&zipError); return; } - const QDir packageDir = QDir(packagePathName); - if (!packageDir.exists()) { - packageDir.mkpath(packagePathName); - } const int xmlIndex = zip_name_locate(zipFile, qsl("%1.xml").arg(moduleName).toUtf8().constData(), ZIP_FL_ENC_GUESS); zip_delete(zipFile, xmlIndex); struct zip_source* s = zip_source_file(zipFile, filename_xml.toUtf8().constData(), 0, -1); @@ -1064,15 +1076,28 @@ std::tuple<bool, QString, QString> Host::saveProfile(const QString& saveFolder, // pendingXmlSaveFutures(): the background task must not read `writers`/`saveFutures` // itself, as the main thread mutates them whenever a save starts or finishes. const QList<QFuture<bool>> xmlSaveFutures = pendingXmlSaveFutures(); - auto watcher = new QFutureWatcher<void>; - mModuleFuture = QtConcurrent::run([this, xmlSaveFutures, moduleJobs]() { + // Parented so the profile owns the watcher outright. The deleteLater() below only + // arrives if the event loop lives long enough to deliver `finished` and then the + // deferred delete, which on the way out it does not - and a Host destroyed while + // the write is still queued would leave the watcher with no owner at all. + auto watcher = new QFutureWatcher<void>(this); + // Captures values only, never `this`: no wait for this task is guaranteed, so the + // Host can be destroyed while it is still queued or running. + mModuleFuture = QtConcurrent::run([xmlSaveFutures, moduleJobs]() { // wait for the host xml to be ready before writing the modules out for (auto future : xmlSaveFutures) { future.waitForFinished(); } - writeModuleFiles(moduleJobs); + Host::writeModuleFiles(moduleJobs); }); - connect(watcher, &QFutureWatcher<void>::finished, this, [this, watcher, moduleJobs, syncModules]() { + // Only the names: holding the whole jobs would keep every module's document in + // memory until this runs, and all it needs is what to retire from `writers`. + QStringList savedModuleXmlNames; + savedModuleXmlNames.reserve(moduleJobs.size()); + for (const auto& job : moduleJobs) { + savedModuleXmlNames << job.xmlFilename; + } + connect(watcher, &QFutureWatcher<void>::finished, this, [this, savedModuleXmlNames, syncModules]() { // Finish on the main thread: the module documents are now on disk. Consume // mModulesToSync via reloadModules() *before* the xmlSaved() loop below empties // `writers` and emits profileSaveFinished(): that signal fires synchronously, @@ -1085,11 +1110,11 @@ std::tuple<bool, QString, QString> Host::saveProfile(const QString& saveFolder, mWritingHostAndModules = false; // Drop each module writer from `writers`; the last removal emits // profileSaveFinished() once the profile writer is gone too. - for (const auto& job : moduleJobs) { - xmlSaved(job.xmlFilename); + for (const auto& xmlFilename : savedModuleXmlNames) { + xmlSaved(xmlFilename); } - watcher->deleteLater(); }); + connect(watcher, &QFutureWatcher<void>::finished, watcher, &QObject::deleteLater); watcher->setFuture(mModuleFuture); return {true, filename_xml, QString()}; } diff --git a/src/Host.h b/src/Host.h index bd41e12d9..d5716f849 100644 --- a/src/Host.h +++ b/src/Host.h @@ -57,6 +57,10 @@ #include "TMxpProcessor.h" #include "TMxpFrameManager.h" +namespace pugi { +class xml_document; +} + class QDockWidget; class QJsonObject; class QKeyEvent; @@ -908,33 +912,37 @@ private: void createMapper(const bool); void removePackageInfo(const QString& packageName, const bool); static void createModuleBackup(const QString& filename, const QString& saveName); - // A single module queued to be written out during a profile save. Its XML - // document is built on the main thread (writer->writeModuleXML()); serializing - // it to disk is deferred to a background task so that no shared save-bookkeeping - // is touched off the main thread. `writer` is a non-owning pointer: the owning - // std::shared_ptr lives only in `writers` (removed on the main thread), so the - // XMLexport - a QObject with main-thread affinity - is always destroyed there. + // A single module queued to be written out during a profile save. Its XML document + // is built on the main thread (XMLexport::writeModuleXML()); serializing it to disk + // is deferred to a background task. The job is a complete, self-contained order: + // its own copy of the document plus every path the write needs, so it holds nothing + // whose lifetime the Host controls. It has to: a close that answers "No" to "Save + // profile?", and one that finds the main console already gone, wait for nothing, so + // the Host can be destroyed while the write is still queued. struct ModuleWriteJob { - XMLexport* writer = nullptr; + std::shared_ptr<pugi::xml_document> document; QString moduleName; QString filename; QString xmlFilename; - bool backup = false; + // Empty when this save is not to be backed up first. + QString backupName; }; - // Main thread only: builds every to-be-synced module's XML document and registers - // its writer in `writers`, returning the jobs a background task should serialize. + // Main thread only: builds every to-be-synced module's XML document, registers its + // writer in `writers`, resolves every path and creates the directories the write + // needs, returning the jobs a background task should serialize. QList<ModuleWriteJob> prepareModuleSaves(bool backup); - // Background thread: writes the prepared module documents (and updates their zips) - // to disk. Touches no shared save-bookkeeping (not `writers`, `modulesToWrite` nor - // `mModulesToSync`). - void writeModuleFiles(const QList<ModuleWriteJob>& jobs); + // Writes the prepared module documents (and updates their zips) to disk. Static on + // purpose: it must keep working after the Host that ordered it has been destroyed, + // so it may not reach for any member. Usually a thread pool task, but a waiter in + // waitForProfileSave() can steal it onto the main thread, so it must suit either. + static void writeModuleFiles(const QList<ModuleWriteJob>& jobs); + static void updateModuleZip(const ModuleWriteJob& job); // Main thread only: snapshot of the still-pending profile-save futures, so a // background task never reads `writers`/`saveFutures` while the main thread mutates // them (that concurrent access is a heap-corrupting data race). QList<QFuture<bool>> pendingXmlSaveFutures() const; void waitForAsyncXmlSave(); - void updateModuleZips(const QString& zipName, const QString& moduleName); void reloadModules(); void startMapAutosave(const int interval); void timerEvent(QTimerEvent* event) override; diff --git a/src/XMLexport.cpp b/src/XMLexport.cpp index 66354b5f6..8bc9fb287 100644 --- a/src/XMLexport.cpp +++ b/src/XMLexport.cpp @@ -85,7 +85,8 @@ XMLexport::XMLexport(TKey* pT) // Builds the module's XML document into mExportDoc. This reads the live // trigger/timer/alias/action/script/key lists, so it must run on the main thread; -// serialization to disk (saveModuleXml()) can then happen on a background thread. +// serializing a copy of it (cloneExportDocument()) to disk can then happen on a +// background thread. void XMLexport::writeModuleXML(const QString& moduleName) { auto pHost = mpHost; @@ -160,13 +161,17 @@ void XMLexport::writeModuleXML(const QString& moduleName) } } -// Serializes the document previously built by writeModuleXML() to disk. Kept -// separate from writeModuleXML() so the document build (main thread only) and the -// file write (safe on a background thread as the document is not modified once -// built) can run on different threads. -bool XMLexport::saveModuleXml(const QString& fileName) +// Deep copy of the document built so far, so the write can outlive both this XMLexport +// and the Host it belongs to. The copy is made while the main thread is already +// quiescent, and each document owns its own tree, so the clone can be serialized off +// the main thread without touching anything shared. +std::shared_ptr<pugi::xml_document> XMLexport::cloneExportDocument() const { - return saveXml(fileName); + auto clone = std::make_shared<pugi::xml_document>(); + for (pugi::xml_node child = mExportDoc.first_child(); child; child = child.next_sibling()) { + clone->append_copy(child); + } + return clone; } bool XMLexport::exportHost(const QString& filename_pugi_xml) @@ -187,19 +192,16 @@ bool XMLexport::exportHost(const QString& filename_pugi_xml) // notify host when complete void XMLexport::runAsyncSave(const QString& fileName, const QString& xmlSavedKey) { - // Clone XML document on main thread, then serialize and save on background thread. - // Cloning is fast and safe; each document owns its own tree, so the clone can be - // serialized on a background thread without thread-safety issues. + // Clone the XML document on the main thread, then serialize and save it on a + // background thread that owns the clone outright. QPointer<Host> host = mpHost; - pugi::xml_document docClone; - // Deep copy the entire document tree - for (pugi::xml_node child = mExportDoc.first_child(); child; child = child.next_sibling()) { - docClone.append_copy(child); - } - auto future = QtConcurrent::run([fileName, docClone = std::move(docClone)]() mutable { - return XMLexport::saveXmlDocToFile(fileName, docClone); + auto future = QtConcurrent::run([fileName, docClone = cloneExportDocument()]() { + return XMLexport::saveXmlDocToFile(fileName, *docClone); }); - auto watcher = new QFutureWatcher<bool>; + // Parented to the profile for the same reason the module save's watcher is: the + // deleteLater() below needs an event loop that is still running to be delivered, + // and the save that matters most here is the one on the way out. + auto watcher = new QFutureWatcher<bool>(host); connect(watcher, &QFutureWatcher<bool>::finished, host, [host, xmlSavedKey]() { if (!host) { return; diff --git a/src/XMLexport.h b/src/XMLexport.h index fcedd0564..0477b247d 100644 --- a/src/XMLexport.h +++ b/src/XMLexport.h @@ -67,7 +67,8 @@ public: void writeKey(TKey*, pugi::xml_node xmlParent); void writeVariable(TVar*, LuaInterface*, VarUnit*, pugi::xml_node xmlParent, bool insideSavedTable = false); void writeModuleXML(const QString& moduleName); - bool saveModuleXml(const QString& fileName); + std::shared_ptr<pugi::xml_document> cloneExportDocument() const; + static bool saveXmlDocToFile(const QString& fileName, const pugi::xml_document& doc); bool exportHost(const QString& filename_pugi_xml); bool writeGenericPackage(Host* pHost, pugi::xml_node& mMudletPackage, bool ignoreModuleMember = true, bool ignoreVariables = false); @@ -111,7 +112,6 @@ private: static inline void replaceAll(std::string& source, const std::string& from, const std::string& to); bool saveXmlFile(QSaveFile& file); bool saveXml(const QString&); - static bool saveXmlDocToFile(const QString& fileName, const pugi::xml_document& doc); pugi::xml_node writeXmlHeader(); static void sanitizeForQxml(std::string& output); void runAsyncSave(const QString& fileName, const QString& xmlSavedKey); diff --git a/src/mudlet-lua/tests/Package_spec.lua b/src/mudlet-lua/tests/Package_spec.lua index 319a89110..33fac641f 100644 --- a/src/mudlet-lua/tests/Package_spec.lua +++ b/src/mudlet-lua/tests/Package_spec.lua @@ -811,6 +811,40 @@ describe("Tests the module accessors", function() assert.is_false(getModuleSync(moduleName)) end) end) + + -- A synced module is the only thing that makes a profile save do any module + -- work at all: with none installed the save's module list comes out empty and + -- the background write returns at its first line. The write itself and + -- everything it touches - the module documents, the backup, the archive + -- rewrite - therefore go unseen by the sanitizers this suite runs under + -- unless a spec puts a synced module in the profile first. + describe("Tests saving a profile that has a module to write", function() + it("writes the synced module out again", function() + requireWorkingInstalls() + -- rewriting this module's own .mpackage is only safe because + -- installFixtureModule() installed a scratch copy, not the committed one + defer(function() disableModuleSync(moduleName) end) + assert.is_true(enableModuleSync(moduleName)) + assert.is_true(waitForProfileSaveToPass(), "a profile save was still running") + + -- taking the unpacked XML away is what makes "the save wrote the module + -- out" a plain yes or no rather than a guess about file timestamps + local moduleXml = getMudletHomeDir() .. "/" .. moduleName .. "/" .. moduleName .. ".xml" + os.remove(moduleXml) + assert.is_nil(lfs.attributes(moduleXml), "the module's unpacked XML could not be cleared") + + assert.is_true(saveProfile()) + assert.is_true(waitUntil(function() return lfs.attributes(moduleXml) ~= nil end, 10000), "the profile save never wrote the synced module out") + assert.is_true(waitForProfileSaveToPass(), "a profile save was still running") + + -- a file that merely exists could be an empty or half-written one + local written = io.open(moduleXml, "rb") + assert.is_not_nil(written, "the module's XML could not be read back") + local contents = written:read("*a") + written:close() + assert.is_true(contains(contents, "<MudletPackage"), "the module's XML was written without a package in it") + end) + end) end) describe("Tests the functionality of reloadModule", function() diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index 12f7ae6af..e0b222981 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -37,6 +37,7 @@ set(FUNCTIONAL_TEST_SOURCES PackageSelfUninstallTest.cpp UnitProcessingDepthTest.cpp PackageUninstallSaveTeardownTest.cpp + ModuleSaveTeardownTest.cpp MapRoundTripTest.cpp MapProgressDialogSeamTest.cpp UndoServerWrapTest.cpp diff --git a/test/functional_tests/ModuleSaveTeardownTest.cpp b/test/functional_tests/ModuleSaveTeardownTest.cpp new file mode 100644 index 000000000..1b9ab6a1b --- /dev/null +++ b/test/functional_tests/ModuleSaveTeardownTest.cpp @@ -0,0 +1,523 @@ +/*************************************************************************** + * Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +/* + * Coverage for the background half of a profile save that has modules to write, + * and for that write outliving the profile that ordered it. + * + * A profile save hands the modules that are set to sync to a thread pool task and + * returns. Two ways of closing a profile then wait for nothing: answering "No" to + * "Save profile?", and any close that finds the main console already gone. Either + * destroys the Host with the write still going, and the write went on reading the + * Host it was queued from - its XMLexport, and then its name. Under + * AddressSanitizer that kills the run inside Host::writeModuleFiles(); in a + * release build it is a crash or a corrupted .mpackage on the way out. The watcher + * that reports the write finished was unowned in the same window, so nothing was + * left to delete it once the profile it reported to had gone. + * + * This is the same shape as #9653 "uninstalling a package then quitting is a + * use-after-free", but it stayed hidden because no test profile had a module in + * it: with none installed the save's module list comes out empty and the write + * returns at its first line. So the point of this file is a profile that genuinely + * carries a synced module, which is what makes the hazardous path run at all. + * + * test_aSyncedModuleIsWrittenOutOnSave() is that coverage - the module really is + * serialized and its archive really is rewritten. The teardown test after it is + * the regression: it holds the thread pool so the write is provably still queued + * when the Host is destroyed, and then lets it run. + * + * Run with: ctest -R ModuleSaveTeardownTest -V + */ + +#include <QtTest/QtTest> + +#include <QFutureWatcher> +#include <QMessageBox> +#include <QRunnable> +#include <QScopeGuard> +#include <QSemaphore> +#include <QTemporaryDir> +#include <QThreadPool> +#include <chrono> +#include <zip.h> + +#include "Host.h" +#include "HostManager.h" +#include "MudletInstanceCoordinator.h" +#include "TelnetServerStub.h" +#include "dlgConnectionProfiles.h" +#include "mudlet.h" + +using namespace std::chrono_literals; + +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); +void initializeQRCResourcesForModuleSaveTeardownTest(); + +class ModuleSaveTeardownTest : public QObject +{ + Q_OBJECT + +private: + TelnetServerStub* mpServer = nullptr; + Host* mpHost = nullptr; + const QString mProfileName = qsl("ModuleSaveTeardown-Test"); + const QString mModuleName = qsl("module-save-teardown"); + const QString mLocalhost = qsl("localhost"); + QString mPort; // the stub's actual ephemeral port, assigned in initTestCase() + QTemporaryDir mConfigDir; + QByteArray mSavedXdg; + // A synced module has its own archive rewritten by every profile save, so it + // lives in a scratch directory rather than anywhere the repository can see. + QTemporaryDir mArchiveDir; + QString mModuleArchivePath; + int mHeldPoolThreads = 0; + int mOriginalMaxPoolThreads = 0; + QSemaphore mPoolBlockersStarted; + QSemaphore mPoolRelease; + + static void deleteProfileDirectory(const QString& profileName) + { + QDir dir(mudlet::getMudletPath(enums::profileHomePath, profileName)); + if (dir.exists()) { + dir.removeRecursively(); + } + } + + // What the module archive is built from. Deliberately nothing like the module + // XML Mudlet writes: that one carries a <HelpPackage> element and this one does + // not, which is how the tests below tell "the module has been written out" from + // "this is still the file the archive was unpacked with". + static QByteArray sourceModuleXml() + { + return QByteArray("<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" + "<!DOCTYPE MudletPackage>\n" + "<MudletPackage version=\"1.001\">\n" + "<AliasPackage>\n" + "<Alias isActive=\"yes\" isFolder=\"no\">\n" + "<name>module-save-teardown alias</name>\n" + "<script>send(\"hello\")</script>\n" + "<command></command>\n" + "<packageName></packageName>\n" + "<regex>^module-save-teardown$</regex>\n" + "</Alias>\n" + "</AliasPackage>\n" + "</MudletPackage>\n"); + } + + static bool writeArchive(const QString& path, const QString& entryName, const QByteArray& contents) + { + int errorCode = 0; + zip* archive = zip_open(path.toUtf8().constData(), ZIP_CREATE | ZIP_TRUNCATE, &errorCode); + if (!archive) { + return false; + } + zip_source* source = zip_source_buffer(archive, contents.constData(), contents.size(), 0); + if (!source || zip_file_add(archive, entryName.toUtf8().constData(), source, ZIP_FL_ENC_UTF_8) < 0) { + zip_source_free(source); + zip_discard(archive); + return false; + } + return zip_close(archive) == 0; + } + + static QByteArray archiveEntry(const QString& path, const QString& entryName) + { + int errorCode = 0; + zip* archive = zip_open(path.toUtf8().constData(), ZIP_RDONLY, &errorCode); + if (!archive) { + return {}; + } + zip_stat_t entryStat; + QByteArray contents; + if (zip_stat(archive, entryName.toUtf8().constData(), 0, &entryStat) == 0) { + if (zip_file* file = zip_fopen(archive, entryName.toUtf8().constData(), 0); file) { + contents.resize(static_cast<qsizetype>(entryStat.size)); + if (zip_fread(file, contents.data(), entryStat.size) != static_cast<zip_int64_t>(entryStat.size)) { + contents.clear(); + } + zip_fclose(file); + } + } + zip_discard(archive); + return contents; + } + + QString moduleXmlPath() const { return mudlet::getMudletPath(enums::profilePackagePathFileName, mProfileName, mModuleName); } + + static QByteArray readFile(const QString& path) + { + QFile file(path); + if (!file.open(QFile::ReadOnly)) { + return {}; + } + return file.readAll(); + } + + static bool moduleWasWrittenOut(const QByteArray& xml) { return xml.contains("<HelpPackage"); } + + // Puts the module back the way installing it left it - both the unpacked XML and + // the archive - so that "has the module been written out yet?" has an answer again + // after an earlier save. Resetting only the unpacked XML would leave the archive + // carrying the previous save's work, and every assertion about it vacuously true. + bool resetModuleOnDisk() const + { + if (!writeArchive(mModuleArchivePath, qsl("%1.xml").arg(mModuleName), sourceModuleXml())) { + return false; + } + QFile file(moduleXmlPath()); + if (!file.open(QFile::WriteOnly | QFile::Truncate)) { + return false; + } + const QByteArray xml = sourceModuleXml(); + const bool written = file.write(xml) == xml.size(); + file.close(); + return written; + } + + QStringList moduleBackupFiles() const { return QDir(mudlet::getMudletPath(enums::moduleBackupsPath)).entryList(QStringList{qsl("%1*").arg(mModuleName)}, QDir::Files); } + + // A backup is named after the second it was taken in, and QFile::copy() will not + // overwrite, so counting backups across two saves in the same second proves + // nothing. Clearing them first makes "was one taken?" a plain yes or no. + void clearModuleBackups() const + { + QDir backups(mudlet::getMudletPath(enums::moduleBackupsPath)); + for (const auto& backup : moduleBackupFiles()) { + backups.remove(backup); + } + } + + int profileOwnedWatchers() const { return mpHost->findChildren<QFutureWatcherBase*>(QString(), Qt::FindDirectChildrenOnly).count(); } + + // Occupies every thread the global pool has until it is let go. QThreadPool's own + // reserveThread() is not enough - a thread woken by a newly queued task takes it + // regardless of the reservation - so this holds the threads with actual work. + class PoolBlocker : public QRunnable + { + public: + PoolBlocker(QSemaphore* started, QSemaphore* release) + : mpStarted(started) + , mpRelease(release) + { + setAutoDelete(true); + } + void run() override + { + mpStarted->release(); + mpRelease->acquire(); + } + + private: + QSemaphore* mpStarted = nullptr; + QSemaphore* mpRelease = nullptr; + }; + + // Holds the pool so that a task queued after this cannot start until releasePool(). + // That is what turns "the profile was destroyed while the module write was still + // going" from a race into something a test can state plainly. + bool holdPool() + { + auto* pool = QThreadPool::globalInstance(); + mOriginalMaxPoolThreads = pool->maxThreadCount(); + // The module write waits on the profile XML save before it starts, so leave the + // pool room to run both once they are let go. The count goes back only after + // the pool has drained, so that room is actually there when they run. + mHeldPoolThreads = qMax(4, mOriginalMaxPoolThreads); + pool->setMaxThreadCount(mHeldPoolThreads); + for (int i = 0; i < mHeldPoolThreads; ++i) { + pool->start(new PoolBlocker(&mPoolBlockersStarted, &mPoolRelease)); + } + // Every thread has to be taken before anything else is queued, or the save + // below could still find one free. Bounded so that a pool thread left busy by + // something else fails the test rather than wedging it until ctest's timeout. + return mPoolBlockersStarted.tryAcquire(mHeldPoolThreads, 10000); + } + + void releasePoolBlockers() + { + mPoolRelease.release(mHeldPoolThreads); + mHeldPoolThreads = 0; + } + + void restorePoolThreadCount() + { + if (mOriginalMaxPoolThreads) { + QThreadPool::globalInstance()->setMaxThreadCount(mOriginalMaxPoolThreads); + mOriginalMaxPoolThreads = 0; + } + } + + // Installs the fixture module and turns syncing on for it - only a synced module + // is written out by a profile save, so only a synced one reaches the background + // write this file is about. + bool installSyncedModule() + { + if (!mArchiveDir.isValid()) { + return false; + } + mModuleArchivePath = mArchiveDir.filePath(qsl("%1.mpackage").arg(mModuleName)); + if (!writeArchive(mModuleArchivePath, qsl("%1.xml").arg(mModuleName), sourceModuleXml())) { + return false; + } + mpHost->waitForProfileSave(); // an install during a save is postponed and answered with a bare true + auto [installed, message] = mpHost->installPackage(mModuleArchivePath, enums::PackageModuleType::ModuleFromScript, true); + if (!installed) { + qWarning().noquote() << "installing the fixture module failed:" << message; + return false; + } + if (!mpHost->mModulesLoadedOk.contains(mModuleName)) { + return false; + } + auto [synced, syncMessage] = mpHost->changeModuleSync(mModuleName, QLatin1String("1")); + if (!synced) { + qWarning().noquote() << "enabling sync on the fixture module failed:" << syncMessage; + return false; + } + return true; + } + + // Closes the profile the way a user does who has turned the "save profile on + // exit" preference off and then answers "No" to "Save profile?". That branch of + // TMainConsole::closeEvent() waits for nothing - which is the point: a module + // write queued beforehand is still going once the close is over. (The close that + // finds the main console already gone waits for nothing either, and needs no + // dialog at all, but a profile can only be closed once, so one test gets one of + // the two.) + bool closeProfileWithoutSaving() + { + mpHost->mFORCE_SAVE_ON_EXIT = false; + QTimer answerNo; + int ticks = 0; + connect(&answerNo, &QTimer::timeout, qApp, [&ticks]() { + auto* modal = QApplication::activeModalWidget(); + if (!modal) { + return; + } + if (auto* box = qobject_cast<QMessageBox*>(modal); box) { + if (auto* no = box->button(QMessageBox::No); no) { + no->click(); + return; + } + } + // Whatever this dialog is, it is not the one expected, and requestClose() + // is blocked in its event loop: shut it so the test can fail and say so + // rather than hang until ctest gives up on it. + if (++ticks > 40) { + modal->close(); + } + }); + answerNo.start(50ms); + const bool closed = mpHost->requestClose(); + answerNo.stop(); + return closed; + } + + // Utility function to manually start a profile like a user would do via the GUI + void startProfile(const QString& profileName, const QString& address, const QString& port) + { + QTimer::singleShot(0ms, qApp, [profileName, address, port]() { + mudlet::self()->startAutoLogin({}); + QTest::qWait(100ms); + QTest::mouseClick(mudlet::self()->mpConnectionDialog->new_profile_button, Qt::LeftButton); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), profileName); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), address); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), port); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Return); + }); + + QSignalSpy spy(mudlet::self(), &mudlet::signal_profileLoaded); + if (!spy.wait(5000)) { + QFAIL("Profile took too long to load."); + } + + mpHost = mudlet::self()->getActiveHost(); + if (!mpHost) { + QFAIL("No active host available for the test."); + } + } + +private slots: + void initTestCase() + { + initializeQRCResourcesForModuleSaveTeardownTest(); + + // Keep the test hermetic: point the config dir resolution at a temporary + // directory instead of the user's real profiles. + QVERIFY(mConfigDir.isValid()); + mSavedXdg = qgetenv("XDG_CONFIG_HOME"); + QVERIFY(QDir().mkpath(qsl("%1/mudlet/profiles").arg(mConfigDir.path()))); + qputenv("XDG_CONFIG_HOME", mConfigDir.path().toUtf8()); + + mpServer = new TelnetServerStub(qApp); + mpServer->start(mLocalhost, 0); // ephemeral OS-assigned port avoids collisions across concurrent test runs + mPort = QString::number(mpServer->serverPort()); + mudlet::start(); + mudlet::self()->setupConfig(); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique<MudletInstanceCoordinator>(qsl("MudletInstanceCoordinator"))); + mudlet::self()->init(); + mudlet::self()->setStorePasswordsSecurely(false); + deleteProfileDirectory(mProfileName); + + startProfile(mProfileName, mLocalhost, mPort); + QVERIFY2(mpHost, "No active host after profile creation"); + QVERIFY2(installSyncedModule(), "The fixture module could not be installed"); + // installing a module owes the profile a save; let it come and go + QTRY_VERIFY_WITH_TIMEOUT(!mpHost->hasPendingProfileSave(), 5000); + mpHost->waitForProfileSave(); + } + + void cleanupTestCase() + { + mpHost = nullptr; + delete mpServer; + mpServer = nullptr; + deleteProfileDirectory(mProfileName); + delete mudlet::self(); + mSavedXdg.isNull() ? qunsetenv("XDG_CONFIG_HOME") : qputenv("XDG_CONFIG_HOME", mSavedXdg); + } + + // The coverage this file exists for: with a synced module installed, a profile + // save really does serialize it and really does rewrite its archive. Without a + // module in the profile the whole background write returns immediately, and + // nothing below it can go wrong in a way a test would notice. + void test_aSyncedModuleIsWrittenOutOnSave() + { + QVERIFY2(resetModuleOnDisk(), "Could not put the module back the way it was installed"); + QVERIFY2(!moduleWasWrittenOut(readFile(moduleXmlPath())), "The module XML looked written out before the save"); + clearModuleBackups(); + + auto [ok, filename, error] = mpHost->saveProfile(); + QVERIFY2(ok, qPrintable(error)); + mpHost->waitForProfileSave(); + + const QByteArray writtenXml = readFile(moduleXmlPath()); + QVERIFY2(moduleWasWrittenOut(writtenXml), "The profile save did not write the module out"); + // The document handed to the background write is a copy taken element by + // element, so check the parts that live outside the root element survived it - + // a module XML without them is not one Mudlet can read back in. + QVERIFY2(writtenXml.startsWith("<?xml"), "The written module XML lost its declaration"); + QVERIFY2(writtenXml.contains("<!DOCTYPE MudletPackage>"), "The written module XML lost its doctype"); + QVERIFY2(moduleWasWrittenOut(archiveEntry(mModuleArchivePath, qsl("%1.xml").arg(mModuleName))), "The profile save did not update the module's archive"); + QVERIFY2(!moduleBackupFiles().isEmpty(), "The profile save did not back the module up before overwriting it"); + // The watcher the save made has to go once it has reported, or a long-lived + // profile collects one per save. + QTRY_COMPARE(profileOwnedWatchers(), 0); + } + + // ...and an autosave deliberately does not back the module up, or every autosave + // tick would leave another timestamped copy of every synced module behind. + void test_anAutosaveWritesTheModuleWithoutBackingItUp() + { + QVERIFY2(resetModuleOnDisk(), "Could not put the module back the way it was installed"); + clearModuleBackups(); + + auto [ok, filename, error] = mpHost->saveProfile(QString(), qsl("autosave")); + QVERIFY2(ok, qPrintable(error)); + mpHost->waitForProfileSave(); + + QVERIFY2(moduleWasWrittenOut(readFile(moduleXmlPath())), "The autosave did not write the module out"); + QVERIFY2(moduleBackupFiles().isEmpty(), "The autosave backed the module up, which every tick of it would then do"); + } + + // ...and closing the profile while that write is still going may neither reach + // the destroyed Host nor abandon the write. This one destroys the Host, so it has + // to stay last: anything after it would run without a profile. + void test_theModuleWriteOutlivesTheProfile() + { + QVERIFY2(resetModuleOnDisk(), "Could not put the module back the way it was installed"); + + QVERIFY2(holdPool(), "The thread pool could not be held - a pool thread was busy with something else"); + auto releaseGuard = qScopeGuard([this]() { + if (mHeldPoolThreads) { + releasePoolBlockers(); + } + restorePoolThreadCount(); + }); + + auto [ok, filename, error] = mpHost->saveProfile(); + QVERIFY2(ok, qPrintable(error)); + + // Checked after the teardown below, but they have to be taken hold of here. + // Every watcher this save made is expected to belong to the profile, so that + // destroying it takes them too; before the fix none of them did. + QList<QPointer<QObject>> watcherGuards; + for (auto* watcher : mpHost->findChildren<QFutureWatcherBase*>(QString(), Qt::FindDirectChildrenOnly)) { + watcherGuards.append(QPointer<QObject>(watcher)); + } + + // If this fails the pool was not actually held, and there is no teardown + // race left for the rest of the test to be about. + QVERIFY2(!moduleWasWrittenOut(readFile(moduleXmlPath())), "The module write ran before the profile was closed - the thread pool was not held"); + + QVERIFY2(closeProfileWithoutSaving(), "Closing the profile was refused"); + QVERIFY2(!moduleWasWrittenOut(readFile(moduleXmlPath())), "Closing the profile waited for the module write - this test needs a close that does not"); + + mpHost = nullptr; + mudlet::self()->getHostManager().deleteHost(mProfileName); + + // Now let the write run against a profile that is gone. Before the fix this + // kills the run under AddressSanitizer, reaching through the destroyed Host + // for its XMLexport and then reading its name. + releasePoolBlockers(); + QThreadPool::globalInstance()->waitForDone(); + + // Abandoning the write instead would be no fix: the module's changes would + // be lost, and its archive left half-rewritten. + QVERIFY2(moduleWasWrittenOut(readFile(moduleXmlPath())), "The module write was dropped when the profile went away"); + QVERIFY2(moduleWasWrittenOut(archiveEntry(mModuleArchivePath, qsl("%1.xml").arg(mModuleName))), "The module's archive was left un-updated when the profile went away"); + + // Nothing but the profile owns these, so destroying it has to have taken them: + // the deleteLater() they are also wired to needs an event loop that is still + // running to be delivered, and on the way out there is not one. + QVERIFY2(!watcherGuards.isEmpty(), "The save made no watcher the profile owns"); + for (const auto& watcherGuard : watcherGuards) { + QVERIFY2(watcherGuard.isNull(), "A save watcher outlived the profile it belongs to, with nothing left to delete it"); + } + } +}; + +void initializeQRCResourcesForModuleSaveTeardownTest() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +#include "ModuleSaveTeardownTest.moc" +QTEST_MAIN(ModuleSaveTeardownTest) From c2d3561c0b5163bc70e8cceb72b804f8e837d0f3 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Thu, 6 Aug 2026 08:14:12 +0200 Subject: [PATCH 100/155] infrastructure: assign milestones with the built-in token, not a PAT (#9696) #### Brief overview of PR changes/additions - The add-milestone check now fails on every PR: the Mudlet org forbids fine-grained PATs with a lifetime over 366 days, so every API call made with `GH_PAT_UPDATE_PULL_REQUESTS` returns HTTP 403. The old workflow swallowed this with unchecked `curl -s`; the strict error handling from #9679 (infrastructure: fix milestone assignment, unbreak the key sequence tests) surfaced it - first failure 25 minutes after that merge. - Switches the "Assign PR to milestone" step to the built-in `GITHUB_TOKEN`, which already works in this workflow (the milestone-resolving step uses it and succeeded in the failing runs). `pull_request_target` runs in the base repository, so it has write access with `issues: write` / `pull-requests: write` granted. - Removes the dependency on the `GH_PAT_UPDATE_PULL_REQUESTS` secret entirely, so no PAT needs re-minting and no future expiry can break this again. Note: because this runs on `pull_request_target`, the default-branch copy of the workflow executes - the fix only takes effect after merge, so the add-milestone check on this PR itself will still fail. #### Test case The failing run's own log shows `GITHUB_TOKEN` succeeding at the milestone-read step while the PAT step 403s, confirming the built-in token works where the PAT does not. Assisted-by: Claude:claude-fable-5 --- .github/workflows/tag-pull-requests.yml | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/.github/workflows/tag-pull-requests.yml b/.github/workflows/tag-pull-requests.yml index 379fcd128..6b46f764f 100644 --- a/.github/workflows/tag-pull-requests.yml +++ b/.github/workflows/tag-pull-requests.yml @@ -3,9 +3,13 @@ name: Pull request on: pull_request_target: +# issues covers reading the milestone list and setting the milestone on the +# pull request, which the REST API treats as an issue; pull-requests is granted +# as well because GitHub gates issue endpoints on it when the target is a PR permissions: contents: read - issues: read + issues: write + pull-requests: write jobs: add-milestone: @@ -46,17 +50,15 @@ jobs: - name: Assign PR to milestone env: - GH_TOKEN: ${{ secrets.GH_PAT_UPDATE_PULL_REQUESTS }} + # The built-in token has write access here because pull_request_target + # runs in the base repository; the fine-grained PAT this replaces was + # blocked by the organisation's 366-day token lifetime policy + GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} REPO: ${{ github.repository }} PR_NUMBER: ${{ github.event.pull_request.number }} run: | set -euo pipefail - if [ -z "${GH_TOKEN:-}" ]; then - echo "::error::GH_PAT_UPDATE_PULL_REQUESTS is not available, so the milestone cannot be set" - exit 1 - fi - if [ -z "${MILESTONE_NUMBER:-}" ]; then echo "::error::No milestone number was resolved by the previous step" exit 1 From f07e50708be55817520374bde71add96a1cb0335 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Thu, 6 Aug 2026 12:09:52 +0200 Subject: [PATCH 101/155] fix: stop treating long-time Mudlet users as brand new players (#9695) #### Brief overview of PR changes/additions - `experiencedMudletPlayer()` decided veteran status from profile **directory** mtimes. The per-profile data writes (url, port, password, `profile.ini`, command history) all land straight in that directory and bump its mtime every session, so only a profile *abandoned* for six months ever looked old - the more you use Mudlet, the more certainly it called you new. All 13 profiles on the maintainer's machine classified as "brand new player". - Mudlet renewed those timestamps itself: the connection dialog rewrites `url`/`port`/`description` for the selected profile at startup, so merely launching Mudlet reset the value the gate read. - Replaced with a `firstLaunchDate` key recorded in QSettings on a genuinely fresh install (written in `init()`, before anything can create a profile or save a setting). An installation with any trace of earlier use - a profile, or any other setting already on file - has no recoverable start date and is treated as experienced; timestamps cannot recover one, since a copied or restored profile keeps its modification times only if the tool used happened to preserve them, and loses its birth time regardless. #### Motivation for adding to Mudlet In 4.22.0 this gate only suppressed three one-line hints, but 5.0 hung the full-window "Welcome to Mudlet! New here?" tour (#9385, 69d7d4169 "Add: UI tour to complement the Mudlet tutorial") and the starter UI package (#9454, 69cd06b1c "add: starter interface with health bars, map and chat for new players") off it, so essentially every active 4.22.0 user upgrading to 5.0 would get a beginner tour dropped on top of their session. #### Other info (issues closed, discussion etc) The heuristic dates back to ae0564e6e "Improve: revise splitscreen tutorial (try 2)" (#7341); the two 5.0 consumers above are what turned it into a release blocker. New `ExperiencedPlayerGateTest` (18 cases) covers fresh install, upgrader with freshly-written profiles, settings restored without profiles, the six-month boundary, a profile restored from backup, future-dated, unparseable and unwritable records, and two live-singleton cases that pin the `init()` call site and the memoised read. Both directions were mutation-tested: dropping the `init()` call and restoring the old mtime heuristic each fail the suite. When in doubt the gate errs towards *experienced* - a veteran shown a new-user tour is a much worse outcome than a newcomer who misses it. **Test case:** Seed a HOME that looks like an existing user (one profile, `Mudlet.ini` without `uiTourShown`), launch Mudlet and connect - before, the 6-step "Welcome to Mudlet!" tour appears; after, it does not. A HOME whose `Mudlet.ini` has a recent `firstLaunchDate` still gets the tour, and a genuinely empty HOME records one. Assisted-by: Claude:claude-opus-5 --- src/mudlet.cpp | 121 +++++- src/mudlet.h | 8 + test/functional_tests/CMakeLists.txt | 1 + test/functional_tests/DefaultPackagesTest.cpp | 3 + .../ExperiencedPlayerGateTest.cpp | 392 ++++++++++++++++++ 5 files changed, 511 insertions(+), 14 deletions(-) create mode 100644 test/functional_tests/ExperiencedPlayerGateTest.cpp diff --git a/src/mudlet.cpp b/src/mudlet.cpp index 2c0b69acf..480e8a345 100644 --- a/src/mudlet.cpp +++ b/src/mudlet.cpp @@ -176,6 +176,11 @@ mudlet::mudlet() void mudlet::init() { smFirstLaunch = !QFile::exists(mudlet::getMudletPath(enums::profilesPath)); + // Has to happen after setupConfig() has created mpSettings and before + // anything can create a profile, which is only true here. Note this asks a + // slightly different question to smFirstLaunch above: an existing but empty + // profiles directory still counts as a first launch. See rememberFirstLaunch() + rememberFirstLaunch(*mpSettings, mudlet::getMudletPath(enums::profilesPath), QDateTime::currentDateTime()); QFile gitShaFile(":/app-build.txt"); if (!gitShaFile.open(QIODevice::ReadOnly | QIODevice::Text)) { @@ -7545,8 +7550,98 @@ void mudlet::showedCharacterModeWarning() mCharacterModeWarningsShown = std::min(mCharacterModeWarningsShown + 1, mCharacterModeWarningsMax); } -// returns true if the Mudlet player is considered 'experienced' and doesn't need to be shown the basic -// tutorial tips, such as splitscreen cancel shortcut +// When Mudlet was first used on this installation, as UTC ISO-8601. Absent on +// installations that predate the key - see rememberFirstLaunch(). +static const QLatin1String settingsKeyFirstLaunch("firstLaunchDate"); +static constexpr int experiencedPlayerMonths = 6; + +static bool anyProfilesExist(const QString& profilesPath) +{ + const QDir profiles(profilesPath); + if (!profiles.exists()) { + return false; + } + if (!QFileInfo(profilesPath).isReadable()) { + // An unlistable directory looks exactly like an empty one, and reading + // it as empty would stamp a long-time user with today's date as their + // first launch - permanently, since that is only ever written once. + qWarning() << "anyProfilesExist() WARNING - the profiles directory exists but cannot be read:" << profilesPath + << "- assuming it holds profiles, so an existing user is not mistaken for a new one."; + return true; + } + return !profiles.entryList(QDir::Dirs | QDir::NoDotAndDotDot).isEmpty(); +} + +// Evidence that Mudlet has run here before the first-launch key existed: a +// profile, or any other setting already on file. Either rules out a first-ever +// run, including for someone who kept their settings but not their profiles - +// a restored backup, or a move to a new machine. +static bool mudletUsedBefore(const QSettings& settings, const QString& profilesPath) +{ + return anyProfilesExist(profilesPath) || !settings.allKeys().isEmpty(); +} + +// Intended to be called exactly once, from init(), after setupConfig() has made +// the settings available and before any profile or setting of this run can be +// written - only then does "no trace of earlier use" really mean the user is +// starting today. +// +// Where there is such a trace the start date is not recoverable, so nothing is +// recorded and evaluateExperiencedPlayer() falls back instead. No timestamp can +// stand in: Mudlet's own writes refresh them, and whether a copied or restored +// profile keeps its modification times depends entirely on the tool used, while +// its birth time is reset either way. +/*static*/ void mudlet::rememberFirstLaunch(QSettings& settings, const QString& profilesPath, const QDateTime& now) +{ + // The parse is deliberately not consulted: re-recording an unreadable value + // would restart the six month clock today, which is the harmful direction. + if (settings.contains(settingsKeyFirstLaunch) || mudletUsedBefore(settings, profilesPath)) { + return; + } + + settings.setValue(settingsKeyFirstLaunch, now.toUTC().toString(Qt::ISODate)); + settings.sync(); + if (settings.status() != QSettings::NoError) { + // Worth saying out loud: the write is never retried, because by the next + // run the user has a profile and is indistinguishable from an upgrader. + // A newcomer who hits this loses their onboarding for good. + qWarning() << "mudlet::rememberFirstLaunch() WARNING - could not record the first launch date in" << settings.fileName() << "- QSettings status:" << settings.status() + << "- this installation will later be taken for an experienced user's."; + } +} + +// Returns true if the player has been using Mudlet long enough that first-time +// guidance - the interface tour, the starter UI, the one-line hints - would be +// an interruption rather than a help. +// +// This used to be inferred from profile directory modification times, which +// measured the opposite of what was wanted: the per-profile data writes (url, +// port, password, profile.ini, command history) all land directly in the +// profile directory and bump its mtime on every session, so only a profile left +// untouched for the whole window ever looked old. An active player of ten +// years' standing classified as brand new. +/*static*/ bool mudlet::evaluateExperiencedPlayer(const QSettings& settings, const QString& profilesPath, const QDateTime& now) +{ + const QString recorded = settings.value(settingsKeyFirstLaunch).toString(); + const QDateTime firstLaunch = QDateTime::fromString(recorded, Qt::ISODate); + if (firstLaunch.isValid()) { + return firstLaunch <= now.addMonths(-experiencedPlayerMonths); + } + if (!recorded.isEmpty()) { + // The value is meant to be legible and hand-editable, so say when a + // hand-edit did not take rather than ignoring it in silence. + qWarning().nospace().noquote() << "evaluateExperiencedPlayer() WARNING - \"" << settingsKeyFirstLaunch << "\" holds \"" << recorded + << "\", which is not ISO 8601 - falling back to looking for signs of earlier use."; + } + + // No usable record: an installation that predates the key, or one whose + // record was lost or corrupted. Either way the only signal left is whether + // Mudlet has been used here before. Erring towards 'experienced' is + // deliberate - interrupting a veteran with a beginner tour is far worse + // than a newcomer missing one. + return mudletUsedBefore(settings, profilesPath); +} + bool mudlet::experiencedMudletPlayer() { static std::optional<bool> cachedResult; @@ -7554,19 +7649,17 @@ bool mudlet::experiencedMudletPlayer() return cachedResult.value(); } - // crude metric to check if the player is experienced in Mudlet: see if any of the profiles is more than 6mo old - QDir profilesDir(mudlet::getMudletPath(enums::profilesPath)); - QFileInfoList entries = profilesDir.entryInfoList(QDir::Dirs | QDir::NoDotAndDotDot); - QDateTime sixMonthsAgo = QDateTime::currentDateTime().addMonths(-6); - - for (const QFileInfo& entry : std::as_const(entries)) { - if (entry.lastModified() < sixMonthsAgo) { - cachedResult = true; - return true; - } + const auto* settings = getQSettings(); + if (!settings) { + // setupConfig() has not created them yet, so answer 'experienced', + // which shows nothing. Deliberately not cached: the answer is a guess, + // and caching it would pin every gate for the rest of the process. + qWarning() << "mudlet::experiencedMudletPlayer() WARNING - called before setupConfig(), so assuming an experienced player and showing no first-run guidance."; + return true; } - cachedResult = false; - return false; + + cachedResult = evaluateExperiencedPlayer(*settings, getMudletPath(enums::profilesPath), QDateTime::currentDateTime()); + return cachedResult.value(); } dlgTriggerEditor* mudlet::createMudletEditor() diff --git a/src/mudlet.h b/src/mudlet.h index f40826bd2..0f3e30659 100644 --- a/src/mudlet.h +++ b/src/mudlet.h @@ -60,6 +60,7 @@ class QAction; class QCloseEvent; +class QDateTime; class QDir; class QMediaDevices; class QMediaPlayer; @@ -327,7 +328,14 @@ public: void showedMuteAllMediaTutorial(); bool showCharacterModeWarning(); void showedCharacterModeWarning(); + // True if the player has used Mudlet long enough not to need the basic + // tutorial tips, the interface tour or the starter UI. Memoised. bool experiencedMudletPlayer(); + // Records the first launch. Must be called exactly once, from init(), + // before any profile can exist - public only so it can be tested. + static void rememberFirstLaunch(QSettings& settings, const QString& profilesPath, const QDateTime& now); + // The uncached body of experiencedMudletPlayer() - public only for testing. + static bool evaluateExperiencedPlayer(const QSettings& settings, const QString& profilesPath, const QDateTime& now); // Telnet URI handling void handleTelnetUri(const QString& uri); diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index e0b222981..9e7d8d8ce 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -48,6 +48,7 @@ set(FUNCTIONAL_TEST_SOURCES DialogTeardownTest.cpp TMediaLoopTest.cpp DefaultPackagesTest.cpp + ExperiencedPlayerGateTest.cpp ) # The updater sources are only built with USE_UPDATER, and on macOS the diff --git a/test/functional_tests/DefaultPackagesTest.cpp b/test/functional_tests/DefaultPackagesTest.cpp index 8abe45915..c55e87bdc 100644 --- a/test/functional_tests/DefaultPackagesTest.cpp +++ b/test/functional_tests/DefaultPackagesTest.cpp @@ -135,8 +135,11 @@ private slots: // Games that install an interface of their own get a loader instead of the // starter UI, which would otherwise fight it for the same screen space. + // Every other game gets it, as long as the player is new to Mudlet - this + // config dir has no profiles and no recorded history, so they are. void test_gamesWithTheirOwnUiSkipTheStarterUi() { + QVERIFY(preinstallsFor(qsl("example.com")).contains(qsl(":/packages/mudlet-base-ui/mudlet-base-ui.mpackage"))); QVERIFY(!preinstallsFor(qsl("mg.mud.de")).contains(qsl(":/packages/mudlet-base-ui/mudlet-base-ui.mpackage"))); QVERIFY(preinstallsFor(qsl("mg.mud.de")).contains(qsl(":/packages/mg-loader/mg-loader.mpackage"))); } diff --git a/test/functional_tests/ExperiencedPlayerGateTest.cpp b/test/functional_tests/ExperiencedPlayerGateTest.cpp new file mode 100644 index 000000000..2c60a0748 --- /dev/null +++ b/test/functional_tests/ExperiencedPlayerGateTest.cpp @@ -0,0 +1,392 @@ +/*************************************************************************** + * Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +/* + * Locks in who Mudlet considers an experienced player. That decision gates all + * of the first-time guidance - the interface tour, the starter UI package and + * the one-line hints - so getting it wrong either buries a newcomer's + * onboarding or drops a beginner tour on top of a ten-year veteran's session. + * + * The heuristic this replaced read profile *directory* mtimes, which record + * when a profile was last written rather than how long it has existed; see + * mudlet::evaluateExperiencedPlayer() for why that is backwards. + * test_upgraderWithFreshlyWrittenProfilesIsExperienced is that exact shape and + * is the regression this file exists for. + * + * mudlet::rememberFirstLaunch() and mudlet::evaluateExperiencedPlayer() take + * their settings, profiles path and "now" as arguments, so the cases below run + * without a mudlet instance. The last two drive a real init() instead, to pin + * the production wiring: that init() records the date, and that the memoised + * experiencedMudletPlayer() reads back the same key from the same path. + * + * Run with: ctest -R ExperiencedPlayerGateTest -V + */ + +#include <QtTest/QtTest> +#include <QTimeZone> + +#include "MudletInstanceCoordinator.h" +#include "mudlet.h" + +// init() reads compiled-in resources, which are not registered automatically in +// a test binary that links mudlet_core statically +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); +void initializeQRCResourcesForExperiencedPlayerGateTest(); + +class ExperiencedPlayerGateTest : public QObject +{ + Q_OBJECT + +private: + QByteArray mSavedXdg; + // Outlives the two live-singleton cases, which share one mudlet instance + QTemporaryDir mLiveConfig; + // Fixed, so the six month arithmetic is not at the mercy of the day the + // suite happens to run on + const QDateTime mNow = QDateTime(QDate(2026, 8, 5), QTime(12, 0), QTimeZone::UTC); + const QString mKey = qsl("firstLaunchDate"); + + QString profilesPathIn(const QString& configDir) const { return qsl("%1/profiles").arg(configDir); } + + QString iniIn(const QString& configDir) const { return qsl("%1/Mudlet.ini").arg(configDir); } + + QString makeProfile(const QString& configDir, const QString& name) const + { + const QString path = qsl("%1/%2").arg(profilesPathIn(configDir), name); + return QDir().mkpath(path) ? path : QString(); + } + + void setFirstLaunch(QSettings& settings, const QDateTime& when) const { settings.setValue(mKey, when.toUTC().toString(Qt::ISODate)); } + + // setupConfig() consults portable.txt before the XDG logic, so the + // live-singleton cases skip rather than report a baffling failure + bool portableMarkerPresent() const + { + return QFileInfo::exists(qsl("%1/portable.txt").arg(QCoreApplication::applicationDirPath())) || QFileInfo::exists(qsl("%1/.config/mudlet/portable.txt").arg(QDir::homePath())); + } + +private slots: + void initTestCase() { mSavedXdg = qgetenv("XDG_CONFIG_HOME"); } + + void cleanupTestCase() + { + if (mudlet::self()) { + delete mudlet::self(); + } + mSavedXdg.isNull() ? qunsetenv("XDG_CONFIG_HOME") : qputenv("XDG_CONFIG_HOME", mSavedXdg); + } + + // --- a brand new installation -------------------------------------------- + + void test_freshInstallRecordsTodayAndIsNew() + { + QTemporaryDir config; + QVERIFY(config.isValid()); + QSettings settings(iniIn(config.path()), QSettings::IniFormat); + QVERIFY(!QDir(profilesPathIn(config.path())).exists()); + + mudlet::rememberFirstLaunch(settings, profilesPathIn(config.path()), mNow); + + QCOMPARE(settings.value(mKey).toString(), mNow.toString(Qt::ISODate)); + QVERIFY2(!mudlet::evaluateExperiencedPlayer(settings, profilesPathIn(config.path()), mNow), "a first-ever launch must be treated as a new player"); + } + + // A profiles directory that exists but holds nothing is still a first run - + // an aborted earlier launch must not cost the user their onboarding. + void test_emptyProfilesDirectoryIsStillAFirstRun() + { + QTemporaryDir config; + QVERIFY(config.isValid()); + QVERIFY(QDir().mkpath(profilesPathIn(config.path()))); + QSettings settings(iniIn(config.path()), QSettings::IniFormat); + + mudlet::rememberFirstLaunch(settings, profilesPathIn(config.path()), mNow); + + QVERIFY(settings.contains(mKey)); + QVERIFY(!mudlet::evaluateExperiencedPlayer(settings, profilesPathIn(config.path()), mNow)); + } + + // --- the recorded date, once there is one -------------------------------- + + void test_recentlyRecordedFirstLaunchIsNew() + { + QTemporaryDir config; + QVERIFY(config.isValid()); + QSettings settings(iniIn(config.path()), QSettings::IniFormat); + setFirstLaunch(settings, mNow.addMonths(-1)); + QVERIFY(!makeProfile(config.path(), qsl("Achaea")).isEmpty()); + + QVERIFY2(!mudlet::evaluateExperiencedPlayer(settings, profilesPathIn(config.path()), mNow), "a month of use is not enough to be experienced, even with a profile in hand"); + } + + void test_oldRecordedFirstLaunchIsExperienced() + { + QTemporaryDir config; + QVERIFY(config.isValid()); + QSettings settings(iniIn(config.path()), QSettings::IniFormat); + setFirstLaunch(settings, mNow.addYears(-3)); + + QVERIFY(mudlet::evaluateExperiencedPlayer(settings, profilesPathIn(config.path()), mNow)); + } + + void test_sixMonthBoundary() + { + QTemporaryDir config; + QVERIFY(config.isValid()); + QSettings settings(iniIn(config.path()), QSettings::IniFormat); + const QString profiles = profilesPathIn(config.path()); + + setFirstLaunch(settings, mNow.addMonths(-6).addDays(1)); + QVERIFY2(!mudlet::evaluateExperiencedPlayer(settings, profiles, mNow), "one day short of six months is not yet experienced"); + + setFirstLaunch(settings, mNow.addMonths(-6)); + QVERIFY2(mudlet::evaluateExperiencedPlayer(settings, profiles, mNow), "exactly six months of use is experienced"); + + setFirstLaunch(settings, mNow.addMonths(-6).addDays(-1)); + QVERIFY(mudlet::evaluateExperiencedPlayer(settings, profiles, mNow)); + } + + // A clock set forward and back, or settings carried between machines, can + // leave a first launch in the future. That is not tenure. + void test_futureDatedFirstLaunchIsNotExperienced() + { + QTemporaryDir config; + QVERIFY(config.isValid()); + QSettings settings(iniIn(config.path()), QSettings::IniFormat); + setFirstLaunch(settings, mNow.addYears(1)); + + QVERIFY(!mudlet::evaluateExperiencedPlayer(settings, profilesPathIn(config.path()), mNow)); + } + + // --- upgrading users, who have no recorded first launch ------------------ + + // The regression: profiles written seconds ago by an installation that has + // been in use for years. The old directory-mtime heuristic classified this + // player as brand new, handing a veteran the beginner tour. + void test_upgraderWithFreshlyWrittenProfilesIsExperienced() + { + QTemporaryDir config; + QVERIFY(config.isValid()); + QSettings settings(iniIn(config.path()), QSettings::IniFormat); + for (const auto& name : {qsl("Achaea"), qsl("StickMUD"), qsl("Legends of the Jedi")}) { + const QString profile = makeProfile(config.path(), name); + QVERIFY(!profile.isEmpty()); + QFile url(qsl("%1/url").arg(profile)); + QVERIFY(url.open(QIODevice::WriteOnly)); + url.write("achaea.com"); + url.close(); + QVERIFY2(QFileInfo(profile).lastModified() > mNow.addMonths(-6), "the fixture is only meaningful while the profile directory looks brand new"); + } + + QVERIFY2(mudlet::evaluateExperiencedPlayer(settings, profilesPathIn(config.path()), mNow), "an installation with profiles but no recorded first launch predates the key, so it is experienced"); + } + + // Timestamps are not consulted at all, which is what makes a profile copied + // to a new machine or restored from a backup come out right: whether the + // modification times survive depends entirely on the tool used, and the + // birth time is reset either way. + void test_restoredFromBackupIsExperienced() + { + QTemporaryDir config; + QVERIFY(config.isValid()); + QSettings settings(iniIn(config.path()), QSettings::IniFormat); + QVERIFY(!makeProfile(config.path(), qsl("Restored")).isEmpty()); + + QVERIFY(mudlet::evaluateExperiencedPlayer(settings, profilesPathIn(config.path()), mNow)); + } + + // Settings restored without their profiles - a move to a new machine, or a + // user who deleted their last profile. Mudlet has clearly run here before, + // so they must not be stamped with today as their first launch. + void test_settingsWithoutProfilesStillCountAsEarlierUse() + { + QTemporaryDir config; + QVERIFY(config.isValid()); + QSettings settings(iniIn(config.path()), QSettings::IniFormat); + settings.setValue(qsl("pos"), QPoint(120, 80)); + QVERIFY(!QDir(profilesPathIn(config.path())).exists()); + + mudlet::rememberFirstLaunch(settings, profilesPathIn(config.path()), mNow); + + QVERIFY2(!settings.contains(mKey), "an installation with settings on file is not on its first run"); + QVERIFY(mudlet::evaluateExperiencedPlayer(settings, profilesPathIn(config.path()), mNow)); + } + + // A profiles directory that cannot be listed is indistinguishable from an + // empty one, so it must be read the safe way round - otherwise a home + // directory that mounted late would brand a veteran as a newcomer, for six + // months, with no way back. + void test_unreadableProfilesDirectoryIsTakenAsPopulated() + { + QTemporaryDir config; + QVERIFY(config.isValid()); + QSettings settings(iniIn(config.path()), QSettings::IniFormat); + const QString profiles = profilesPathIn(config.path()); + QVERIFY(!makeProfile(config.path(), qsl("Achaea")).isEmpty()); + QVERIFY(QFile::setPermissions(profiles, QFileDevice::WriteOwner | QFileDevice::ExeOwner)); + if (QFileInfo(profiles).isReadable()) { + QVERIFY(QFile::setPermissions(profiles, QFileDevice::ReadOwner | QFileDevice::WriteOwner | QFileDevice::ExeOwner)); + QSKIP("the profiles directory is readable despite the permissions - running as root?"); + } + + const bool experienced = mudlet::evaluateExperiencedPlayer(settings, profiles, mNow); + // Restore before asserting, so a failure does not leave QTemporaryDir + // unable to clean up after itself + QVERIFY(QFile::setPermissions(profiles, QFileDevice::ReadOwner | QFileDevice::WriteOwner | QFileDevice::ExeOwner)); + QVERIFY(experienced); + } + + // Upgrading must not invent a first launch date - that would start the six + // month clock now and hand the veteran a tour six months from today. + void test_upgradeDoesNotRecordAFirstLaunch() + { + QTemporaryDir config; + QVERIFY(config.isValid()); + QSettings settings(iniIn(config.path()), QSettings::IniFormat); + QVERIFY(!makeProfile(config.path(), qsl("Achaea")).isEmpty()); + + mudlet::rememberFirstLaunch(settings, profilesPathIn(config.path()), mNow); + + QVERIFY(!settings.contains(mKey)); + QVERIFY(mudlet::evaluateExperiencedPlayer(settings, profilesPathIn(config.path()), mNow.addYears(1))); + } + + void test_existingRecordIsNeverOverwritten() + { + QTemporaryDir config; + QVERIFY(config.isValid()); + QSettings settings(iniIn(config.path()), QSettings::IniFormat); + const QDateTime original = mNow.addMonths(-3); + setFirstLaunch(settings, original); + + mudlet::rememberFirstLaunch(settings, profilesPathIn(config.path()), mNow); + + QCOMPARE(settings.value(mKey).toString(), original.toString(Qt::ISODate)); + } + + // A corrupted or mistyped value must not be trusted as a date; it falls + // through to the earlier-use check, exactly like an upgrade does. It is also + // left alone rather than re-recorded, since re-recording would restart the + // six month clock today. + void test_unparseableRecordFallsBackToTheEarlierUseCheck() + { + QTemporaryDir config; + QVERIFY(config.isValid()); + QSettings settings(iniIn(config.path()), QSettings::IniFormat); + settings.setValue(mKey, qsl("not a date")); + + QVERIFY(mudlet::evaluateExperiencedPlayer(settings, profilesPathIn(config.path()), mNow)); + + mudlet::rememberFirstLaunch(settings, profilesPathIn(config.path()), mNow); + QCOMPARE(settings.value(mKey).toString(), qsl("not a date")); + } + + void test_recordedValueSurvivesAQSettingsRoundTrip() + { + QTemporaryDir config; + QVERIFY(config.isValid()); + { + QSettings writer(iniIn(config.path()), QSettings::IniFormat); + mudlet::rememberFirstLaunch(writer, profilesPathIn(config.path()), mNow.addYears(-2)); + } + + QSettings reader(iniIn(config.path()), QSettings::IniFormat); + QVERIFY2(mudlet::evaluateExperiencedPlayer(reader, profilesPathIn(config.path()), mNow), "the recorded date must be readable back out of Mudlet.ini"); + + QFile ini(iniIn(config.path())); + QVERIFY(ini.open(QIODevice::ReadOnly | QIODevice::Text)); + QVERIFY2(QString::fromUtf8(ini.readAll()).contains(qsl("firstLaunchDate=2024-08-05T12:00:00Z")), "the date is stored as plain ISO 8601, so it can be read and edited by hand"); + } + + // --- the live singleton -------------------------------------------------- + + // The whole fix rests on init() recording the date at a point where no + // profile can exist yet. Nothing else in the suite would notice that call + // being moved or dropped, and if it were, every fresh install would take + // the "used before" fallback and be classified experienced - silently + // killing the onboarding for exactly the people it is for. + void test_initRecordsTheFirstLaunchOnAFreshInstall() + { + if (portableMarkerPresent()) { + QSKIP("portable.txt present - setupConfig() takes the portable branch"); + } + QVERIFY(mLiveConfig.isValid()); + // An empty $XDG_CONFIG_HOME/mudlet is the opt-in marker; on a machine + // with a legacy ~/.config/mudlet, setupConfig() would otherwise keep + // using that + const QString configDir = qsl("%1/mudlet").arg(mLiveConfig.path()); + QVERIFY(QDir().mkpath(configDir)); + qputenv("XDG_CONFIG_HOME", mLiveConfig.path().toUtf8()); + + initializeQRCResourcesForExperiencedPlayerGateTest(); + mudlet::start(); + mudlet::self()->setupConfig(); + QCOMPARE(mudlet::getMudletPath(enums::mainPath), configDir); + QVERIFY(!QDir(mudlet::getMudletPath(enums::profilesPath)).exists()); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique<MudletInstanceCoordinator>("MudletInstanceCoordinator")); + + mudlet::self()->init(); + + QVERIFY2(mudlet::getQSettings()->contains(mKey), "init() must record the first launch date"); + QCOMPARE(QDateTime::fromString(mudlet::getQSettings()->value(mKey).toString(), Qt::ISODate).isValid(), true); + } + + // The direction that actually broke, through the memoised production path: + // an installation with a profile and no recorded date must come out + // experienced. Pins the key name and the profiles path that + // experiencedMudletPlayer() picks for itself, which the case above cannot - + // there, both branches would answer "new". + // + // Runs last: experiencedMudletPlayer() memoises for the life of the process. + void test_experiencedThroughTheRealSettings() + { + if (portableMarkerPresent()) { + QSKIP("portable.txt present - setupConfig() takes the portable branch"); + } + QVERIFY(mudlet::self()); + auto* settings = mudlet::getQSettings(); + QVERIFY(settings); + settings->remove(mKey); + QVERIFY(!makeProfile(mudlet::getMudletPath(enums::mainPath), qsl("Achaea")).isEmpty()); + + QVERIFY2(mudlet::self()->experiencedMudletPlayer(), "a profile with no recorded first launch must read as an experienced player"); + } +}; + +void initializeQRCResourcesForExperiencedPlayerGateTest() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +#include "ExperiencedPlayerGateTest.moc" +QTEST_MAIN(ExperiencedPlayerGateTest) From ca1648ae302a2c518792b1ad111549f9ee11ac69 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Thu, 6 Aug 2026 12:18:33 +0200 Subject: [PATCH 102/155] fix: a trigger that re-creates itself freezes Mudlet (#9697) #### Brief overview of PR changes/additions - A trigger whose script creates another trigger matching the same line kept extending the list `TriggerUnit::processDataStream()` walks, so the line never finished: 100% CPU and RSS climbing 1.7 GB to 5.9 GB in 44 seconds, from one ordinary line of game text. Same-line matching for triggers created mid-pass now has a budget (100 per line); when it runs out the offending trigger is named in an error and what the loop created during that line is stopped - temporary ones removed, permanent ones switched off for the session only, so nothing is saved to the profile. - `enableTrigger()` could resurrect a killed or expired temporary trigger during the window before its deferred delete runs, so a one-shot fired twice and a `killTrigger()`ed trigger fired 49 more times. It now skips anything queued for cleanup, which is what makes the guarantee `TTrigger::match()` states actually true. - The behaviour restored by #9458 ("fix: triggers created by other triggers react to the current line again") is kept: triggers created while a line is being processed still match that line, chained creation included. 10 new tests, and the 6 that pin that behaviour still pass. #### Motivation for adding to Mudlet Release blocker for 5.0 - the freeze is reachable from ordinary server text with the standard "one-shot trigger that re-arms itself" idiom, and 4.22.0 was not affected. #### Other info (issues closed, discussion etc) 5.0 QA findings C11 (hang) and C12. C11 was introduced by eb2627383 (#9458), which deliberately restored pre-#9267 same-line semantics without bounding them; #9368's depth guard cannot see it, because nothing recurses. The budget is deliberately its own constant rather than the `feedTriggers()` recursion depth: the two measure different resources, and sharing one made a pass entered deep in nested `feedTriggers()` abort before running anything. **Test case:** run `function arm() tempRegexTrigger("^HP: 100/100$", [[arm()]], 1) end arm()` then `feedTriggers("HP: 100/100\n")` - on development Mudlet freezes for good; here it reports the trigger and carries on. Assisted-by: Claude:claude-opus-5 --- src/TTrigger.cpp | 9 +- src/TriggerUnit.cpp | 100 +++++++++- src/TriggerUnit.h | 15 ++ src/mudlet-lua/tests/Trigger_spec.lua | 19 ++ test/functional_tests/CMakeLists.txt | 11 ++ .../TriggerSameLineMatchTest.cpp | 186 ++++++++++++++++++ .../UnitDeferredDeleteTest.cpp | 123 ++++++++++++ 7 files changed, 459 insertions(+), 4 deletions(-) diff --git a/src/TTrigger.cpp b/src/TTrigger.cpp index 4ff502dbf..5d7dd8b1c 100644 --- a/src/TTrigger.cpp +++ b/src/TTrigger.cpp @@ -1103,9 +1103,12 @@ bool TTrigger::match(char* haystackC, const QString& haystack, int line, int pos // again from any pass that re-enters in the meantime (a later // trigger's script calling feedTriggers(), most commonly). // setIsActive(false) rather than deactivate(), matching - // TriggerUnit::killTrigger(): it also clears the user-active state, - // so an enableTrigger() before the deferred free cannot resurrect a - // trigger that has already spent its last fire. + // TriggerUnit::killTrigger(): it also clears the user-active state. + // What stops an enableTrigger() before the deferred free from + // resurrecting a trigger that has spent its last fire is the + // markCleanup() below: TriggerUnit::enableTrigger() skips anything + // in mCleanupSet, as clearing the user-active state alone would + // not - enableTrigger() sets it straight back. setIsActive(false); mpHost->getTriggerUnit()->markCleanup(this); diff --git a/src/TriggerUnit.cpp b/src/TriggerUnit.cpp index 09532e348..54b720fc2 100644 --- a/src/TriggerUnit.cpp +++ b/src/TriggerUnit.cpp @@ -307,6 +307,82 @@ int TriggerUnit::getNewID() return ++mMaxID; } +// Ends a run of same-line trigger creation that has spent its budget, and tells +// the user which trigger to go and fix. +// +// Stopping the pass is not enough on its own: everything the loop created is a +// live root trigger matching the same pattern, so the next line would start with +// a budget's worth of them and each would spawn a budget's worth again. Measured +// while trying that (with a smaller budget): 50 fires on the first such line, +// 2600 on the second, so the freeze would only be postponed. The pass therefore +// disowns what it created, from firstNodeAddedThisPass to the end of the list. +// +// That range is every root trigger registered while this pass ran, not only the +// loop's own offspring - the list records no lineage, so a capture trigger armed +// by an unrelated script earlier on the same line is caught too. It is a +// deliberate trade: on a line that has hit this budget the profile is producing +// triggers faster than it can process them, and one missed capture beats a +// frozen client. Temporary triggers go the way killTrigger() sends them +// (deactivated now, freed once no script is on the stack); permanent ones are +// only deactivated, and with deactivate() rather than setIsActive(false), +// because the latter clears the user-active state that XMLexport writes to the +// profile - the user would find them switched off after a restart. +void TriggerUnit::stopSameLineCreationLoop(const qsizetype firstNodeAddedThisPass) +{ + QString triggerName; + int killedCount = 0; + int deactivatedCount = 0; + for (qsizetype i = firstNodeAddedThisPass; i < mRootNodesAddedWhileProcessing.size(); ++i) { + auto trigger = mRootNodesAddedWhileProcessing.at(i); + if (!trigger) { + continue; + } + // The last trigger created is the newest link in the chain, and its + // creator runs the same script in every looping shape seen so far + triggerName = trigger->getName(); + if (trigger->isTemporary()) { + trigger->setIsActive(false); + markCleanup(trigger); + ++killedCount; + } else { + trigger->deactivate(); + ++deactivatedCount; + } + } + + qWarning().nospace() << "TriggerUnit::processDataStream(...) aborting: triggers created while processing one line reached the limit of " << scmMaxSameLineCreations + << " - probably a trigger that re-creates itself. Profile: " << (mpHost ? mpHost->getName() : QString()) << ", triggers removed: " << killedCount + << ", deactivated: " << deactivatedCount << ", last one created: " << triggerName; + if (!mpHost) { + return; + } + // A runaway whose creator outlives the line trips again on every matching + // line, and this message is long enough to bury the game text if it is + // repeated. Say it, then hold off; the qWarning() above is not throttled, so + // a log or a crash report still has every occurrence. + constexpr qint64 reportIntervalMs = 10000; + if (mSameLineLoopReportTimer.isValid() && mSameLineLoopReportTimer.elapsed() < reportIntervalMs) { + return; + } + mSameLineLoopReportTimer.start(); + + //: %n is a count of triggers. Shown in the game window when a trigger keeps creating new triggers that match the same line, which would otherwise never end + const QString created = tr("%n trigger(s) created while processing this line have been stopped: temporary ones removed, permanent ones switched off until the profile is reloaded.", + nullptr, + killedCount + deactivatedCount); + if (triggerName.isEmpty()) { + //: %1 is the sentence above, about the triggers that were stopped + mpHost->postMessage(tr("[ ERROR ] - Trigger processing stopped to prevent a freeze: a trigger (or another trigger it creates) keeps creating new triggers that match the line being " + "processed, so that line never finishes. %1 Create the trigger once, outside its own script, or give it a pattern that does not match the line it is created on.") + .arg(created)); + return; + } + //: %1 is the name of a trigger - the name of a trigger made by tempTrigger() and friends is its id number - and %2 is the sentence above, about the triggers that were stopped + mpHost->postMessage(tr("[ ERROR ] - Trigger processing stopped to prevent a freeze: trigger '%1' (or another trigger it creates) keeps creating new triggers that match the line being " + "processed, so that line never finishes. %2 Create the trigger once, outside its own script, or give it a pattern that does not match the line it is created on.") + .arg(triggerName, created)); +} + void TriggerUnit::processDataStream(const QString& data, int line) { if (data.isEmpty()) { @@ -358,8 +434,18 @@ void TriggerUnit::processDataStream(const QString& data, int line) } // Index-based loop: a match here can register yet more triggers, growing // the list; they too get a shot at the current line, just as with the - // live-list iteration. + // live-list iteration. That growth needs a ceiling, or a trigger that + // re-creates itself extends the list in front of the loop for ever and the + // line never finishes - 100% CPU and unbounded memory from one line of game + // text (#9458 restored the same-line match without bounding it). Nothing + // else catches it: no C++ frame recurses, so mProcessingDepth stays put and + // the feedTriggers() depth guard never sees it. + const qsizetype sameLineCreationBudget = firstNodeAddedThisPass + scmMaxSameLineCreations; for (qsizetype i = firstNodeAddedThisPass; i < mRootNodesAddedWhileProcessing.size(); ++i) { + if (i >= sameLineCreationBudget) { + stopSameLineCreationLoop(firstNodeAddedThisPass); + break; + } auto trigger = mRootNodesAddedWhileProcessing.at(i); if (!trigger || !trigger->isActive()) { continue; @@ -429,6 +515,18 @@ bool TriggerUnit::enableTrigger(const QString& name) // start mid-run and skip duplicates on some QMultiMap implementations const auto [begin, end] = mLookupTable.equal_range(name); for (auto it = begin; it != end; ++it) { + // A trigger waiting to be freed is only unlinked from the lookup table + // once doCleanup() gets to it, which does not happen while a pass is + // running - so it is still findable by name for the rest of the line. + // Re-activating that corpse resurrects it: a one-shot trigger fires a + // second time, killTrigger() is undone from another script, and a trigger + // whose package a script uninstalled mid-pass (uninstallList, filled by + // uninstall() at a non-zero depth) starts firing again. This skip is what + // makes the guarantee TTrigger::match() states where it expires a trigger + // true; killTrigger() below skips mCleanupSet too, for its own reason. + if (mCleanupSet.contains(it.value()) || uninstallList.contains(it.value())) { + continue; + } it.value()->setIsActive(true); found = true; } diff --git a/src/TriggerUnit.h b/src/TriggerUnit.h index 487244d45..a7f355667 100644 --- a/src/TriggerUnit.h +++ b/src/TriggerUnit.h @@ -26,6 +26,8 @@ #include "utils.h" +#include <QCoreApplication> +#include <QElapsedTimer> #include <QMultiMap> #include <QPointer> #include <QSet> @@ -38,6 +40,7 @@ class TTrigger; class TriggerUnit { + Q_DECLARE_TR_FUNCTIONS(TriggerUnit) // Needed so we can use tr() even though TriggerUnit is NOT derived from QObject friend class XMLexport; friend class XMLimport; @@ -86,6 +89,14 @@ public: // Windows, where the original crash hit before Lua's own 200-C-call guard): // a few times any legitimate nesting, comfortably below the native limit. inline static const int scmMaxProcessingDepth = 50; + // How many triggers created while one line is being processed may match that + // same line - see processDataStream(). A separate budget from the recursion + // depth above, which measures the C stack: this one measures how far a script + // can grow the list the pass is walking, and nothing recurses while it does. + // The behaviour it bounds (a room-capture script arming a catch-all trigger + // from the room title line) needs a handful; 100 leaves two orders of + // magnitude of headroom while keeping a runaway to a few milliseconds. + inline static const qsizetype scmMaxSameLineCreations = 100; QList<TTrigger*> uninstallList; @@ -97,6 +108,7 @@ private: void addTrigger(TTrigger* pT); void removeTriggerRootNode(TTrigger* pT); void removeTrigger(TTrigger*); + void stopSameLineCreationLoop(const qsizetype firstNodeAddedThisPass); QPointer<Host> mpHost; QMap<int, TTrigger*> mTriggerMap; @@ -115,6 +127,9 @@ private: // pass can match the ones created during it against the line being // processed - see processDataStream(). Cleared once the outermost pass ends. QList<TTrigger*> mRootNodesAddedWhileProcessing; + // Throttles the same-line creation loop report: a runaway whose creator + // survives the line trips again on every matching line thereafter. + QElapsedTimer mSameLineLoopReportTimer; }; #endif // MUDLET_TRIGGERUNIT_H diff --git a/src/mudlet-lua/tests/Trigger_spec.lua b/src/mudlet-lua/tests/Trigger_spec.lua index 4255dbca2..13a585377 100644 --- a/src/mudlet-lua/tests/Trigger_spec.lua +++ b/src/mudlet-lua/tests/Trigger_spec.lua @@ -988,6 +988,25 @@ describe("Trigger processing", function() assert.are.equal(1, fires, "a trigger with expireAfter = 1 must not fire a second time") end) + it("does not let enableTrigger revive a trigger that is waiting to be freed", function() + -- a killed temporary trigger stays in the by-name lookup table until + -- the deferred delete runs, so it is still findable by name - but + -- enabling it again would resurrect a trigger already killed, and the + -- same window reopens a one-shot trigger that has spent its last fire + local name = "Spec Enable Resurrection" + _G.EnableResurrectionSpec = 0 + finally(function() _G.EnableResurrectionSpec = nil end) + + tempComplexRegexTrigger(name, "^enable_resurrection$", + [[_G.EnableResurrectionSpec = _G.EnableResurrectionSpec + 1]], 0, 0, 0, 0, 0, 0, 0, 0, 0, 0) + assert.is_true(killTrigger(name)) + assert.is_false(enableTrigger(name), "a killed trigger must not be re-enabled before it is freed") + + feedTriggers("\nenable_resurrection\n") + + assert.are.equal(0, _G.EnableResurrectionSpec, "a killed trigger must not fire, whatever enableTrigger was told") + end) + it("keeps a same-named permanent trigger in the lookup table", function() local name = "Spec Name Eviction" _G.NameEvictionSpec = 0 diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index 9e7d8d8ce..ed211f064 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -110,6 +110,17 @@ set_tests_properties(ResetProfileTest PROPERTIES TIMEOUT 300) # Undo/redo tests need a longer timeout due to large batch operations set_tests_properties(dlgTriggerEditorUndoRedoTest PROPERTIES TIMEOUT 300) +# TriggerSameLineMatchTest creates a fresh profile per test method, so it needs a +# longer timeout. Its self-re-creating-trigger cases do not fail on a regression, +# they hang and grow the heap by ~110MB/s, so the two backstops below are what +# turn that into a reported failure: an RSS ceiling that aborts in seconds rather +# than letting a runner's OOM killer pick a victim, and the timeout behind it. +# The ENVIRONMENT here replaces the one the loop above sets, so it repeats +# QT_QPA_PLATFORM. +set_tests_properties(TriggerSameLineMatchTest PROPERTIES + ENVIRONMENT "QT_QPA_PLATFORM=offscreen;ASAN_OPTIONS=detect_leaks=0:hard_rss_limit_mb=3000" + TIMEOUT 300) + # GMCPCharLoginTest creates a fresh profile per test method, so it needs a longer timeout set_tests_properties(GMCPCharLoginTest PROPERTIES TIMEOUT 300) diff --git a/test/functional_tests/TriggerSameLineMatchTest.cpp b/test/functional_tests/TriggerSameLineMatchTest.cpp index 8343ecac7..c741b346f 100644 --- a/test/functional_tests/TriggerSameLineMatchTest.cpp +++ b/test/functional_tests/TriggerSameLineMatchTest.cpp @@ -204,6 +204,192 @@ private slots: QVERIFY2(bufferContains(qsl("NESTED=inner,outer#")), "Expected the mid-pass trigger to match the nested line first, then the outer line it was created on"); } + // The counterweight to all of the above: giving mid-pass triggers the current + // line means a trigger that re-creates itself keeps extending the list the + // pass is walking, so the line never finishes - 100% CPU and unbounded memory + // on the first matching line, from ordinary game text. The naive "one-shot + // that re-arms itself at the end of its own handler" shape is the one users + // write, so it is the one pinned here. Without the generation budget in + // TriggerUnit::processDataStream() this test does not fail, it hangs, and only + // the ctest TIMEOUT ends it. + void test_selfRecreatingTriggerIsStopped() + { + startProfile(mpHostname, mpLocalhost, mpPort); + auto* host = mudlet::self()->getActiveHost(); + QVERIFY(host); + host->mEchoLuaErrors = true; + + host->getLuaInterpreter()->compileAndExecuteScript(qsl("loopFires = 0\n" + "function arm()\n" + " tempRegexTrigger('^hploop$', [[loopFires = loopFires + 1; arm()]], 1)\n" + "end\n" + "arm()\n" + "feedTriggers('hploop\\n')\n" + "echo('LOOPFIRES=' .. loopFires .. '#\\n')\n")); + + QCOMPARE(host->getTriggerUnit()->processingDepth(), 0); + QVERIFY2(bufferContains(qsl("Trigger processing stopped to prevent a freeze")), "Expected the same-line re-creation abort error in the console buffer"); + // One fire from the trigger that was already there when the line arrived, + // then one per trigger the budget lets the re-arming chain add to it. The + // trailing # anchors the count: without it the check also passes on ten + // times the number. + const int expectedFires = 1 + static_cast<int>(TriggerUnit::scmMaxSameLineCreations); + QVERIFY2(bufferContains(qsl("LOOPFIRES=%1#").arg(expectedFires)), qPrintable(qsl("Expected the re-arming trigger to fire exactly %1 times").arg(expectedFires))); + } + + // The abort has to name the trigger to be actionable - the user has to know + // which of their scripts to change. + void test_selfRecreatingTriggerAbortNamesTheTrigger() + { + startProfile(mpHostname, mpLocalhost, mpPort); + auto* host = mudlet::self()->getActiveHost(); + QVERIFY(host); + host->mEchoLuaErrors = true; + + host->getLuaInterpreter()->compileAndExecuteScript(qsl("function armNamed()\n" + " tempComplexRegexTrigger('hpWatcher', '^hpnamed$', [[armNamed()]], 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1)\n" + "end\n" + "armNamed()\n" + "feedTriggers('hpnamed\\n')\n")); + + QCOMPARE(host->getTriggerUnit()->processingDepth(), 0); + QVERIFY2(bufferContains(qsl("trigger 'hpWatcher'")), "Expected the abort message to name the trigger that keeps re-creating itself"); + } + + // A chain that ends on its own must not be cut short: only the runaway case + // may hit the budget, and legitimate chains are a handful of generations deep. + void test_finiteCreationChainIsUnaffected() + { + startProfile(mpHostname, mpLocalhost, mpPort); + auto* host = mudlet::self()->getActiveHost(); + QVERIFY(host); + host->mEchoLuaErrors = true; + + host->getLuaInterpreter()->compileAndExecuteScript(qsl("chainFires = 0\n" + "function chainStep()\n" + " chainFires = chainFires + 1\n" + " if chainFires < 10 then\n" + " tempRegexTrigger('^chain$', [[chainStep()]], 1)\n" + " end\n" + "end\n" + "tempRegexTrigger('^chain$', [[chainStep()]], 1)\n" + "feedTriggers('chain\\n')\n" + "echo('CHAINFIRES=' .. chainFires .. '#\\n')\n")); + + QCOMPARE(host->getTriggerUnit()->processingDepth(), 0); + QVERIFY2(bufferContains(qsl("CHAINFIRES=10#")), "Expected all ten generations of the finite chain to match the current line"); + QVERIFY2(!bufferContains(qsl("Trigger processing stopped to prevent a freeze")), "A chain that ends on its own must not trip the same-line generation budget"); + } + + // Stopping the line is only half of it. A re-arming trigger with no expiry + // leaves everything it created still active, so the next line would start + // with a budget's worth of them and each would spawn a budget's worth again: + // measured at 50 fires on the first line and 2600 on the second (with an + // earlier, smaller budget), i.e. the freeze merely postponed. The abort + // therefore stops what was created during the line, which holds the cost at + // one budget per line for ever. + void test_selfRecreatingTriggerDoesNotAccumulateAcrossLines() + { + startProfile(mpHostname, mpLocalhost, mpPort); + auto* host = mudlet::self()->getActiveHost(); + QVERIFY(host); + host->mEchoLuaErrors = true; + + host->getLuaInterpreter()->compileAndExecuteScript(qsl("keptFires = 0\n" + "function armKept()\n" + " tempRegexTrigger('^kept$', [[keptFires = keptFires + 1; armKept()]])\n" + "end\n" + "armKept()\n" + "feedTriggers('kept\\n')\n" + "feedTriggers('kept\\n')\n" + "echo('KEPTFIRES=' .. keptFires .. '#\\n')\n")); + + QCOMPARE(host->getTriggerUnit()->processingDepth(), 0); + const int firesPerLine = 1 + static_cast<int>(TriggerUnit::scmMaxSameLineCreations); + QVERIFY2(bufferContains(qsl("KEPTFIRES=%1#").arg(2 * firesPerLine)), + qPrintable(qsl("Expected the second line to cost the same %1 fires as the first, not a multiple of them").arg(firesPerLine))); + } + + // permRegexTrigger() from a trigger's script loops the same way, and those + // objects are saved with the profile. They must be stopped like the temporary + // ones, but not deleted (the user owns them, and they are visible in the + // editor) and not switched off in a way that survives a save: deactivate() + // leaves the user-active state XMLexport writes alone, so a restart brings + // them back rather than confronting the user with a tree of unticked + // triggers they never touched. + void test_selfRecreatingPermanentTriggerIsStoppedButNotDeleted() + { + startProfile(mpHostname, mpLocalhost, mpPort); + auto* host = mudlet::self()->getActiveHost(); + QVERIFY(host); + host->mEchoLuaErrors = true; + + host->getLuaInterpreter()->compileAndExecuteScript(qsl("permFires = 0\n" + "function armPerm()\n" + " permRegexTrigger('Perm Loop', '', {'^permloop$'}, [[permFires = permFires + 1; armPerm()]])\n" + "end\n" + "armPerm()\n" + "feedTriggers('permloop\\n')\n" + "echo('PERMFIRES=' .. permFires .. '#\\n')\n" + "echo('PERMACTIVE=' .. isActive('Perm Loop', 'trigger') .. '#\\n')\n" + "echo('PERMEXISTS=' .. exists('Perm Loop', 'trigger') .. '#\\n')\n")); + + const int expectedFires = 1 + static_cast<int>(TriggerUnit::scmMaxSameLineCreations); + QCOMPARE(host->getTriggerUnit()->processingDepth(), 0); + QVERIFY2(bufferContains(qsl("Trigger processing stopped to prevent a freeze")), "Expected a permanent trigger re-creating itself to be stopped too"); + QVERIFY2(bufferContains(qsl("PERMFIRES=%1#").arg(expectedFires)), qPrintable(qsl("Expected the re-arming permanent trigger to fire exactly %1 times").arg(expectedFires))); + QVERIFY2(bufferContains(qsl("PERMACTIVE=1#")), "Expected only the trigger that predates the line to still be active"); + QVERIFY2(bufferContains(qsl("PERMEXISTS=%1#").arg(expectedFires + 1)), "Expected the stopped permanent triggers to still exist - stopping them is not deleting them"); + } + + // A runaway inside a nested feedTriggers() pass must stop that pass only: the + // outer line's own mid-pass triggers were registered before the nested pass + // began, so they stay live and still match the outer line afterwards. + void test_nestedPassAbortLeavesTheOuterLineAlone() + { + startProfile(mpHostname, mpLocalhost, mpPort); + auto* host = mudlet::self()->getActiveHost(); + QVERIFY(host); + host->mEchoLuaErrors = true; + + host->getLuaInterpreter()->compileAndExecuteScript(qsl("seen = {}\n" + "function armInner()\n" + " tempRegexTrigger('^inner$', [[armInner()]], 1)\n" + "end\n" + "armInner()\n" + "tempRegexTrigger('^outer$', [=[\n" + " tempRegexTrigger('^(.*)$', [[table.insert(seen, matches[2])]], 10)\n" + " feedTriggers('inner\\n')\n" + "]=], 1)\n" + "feedTriggers('outer\\n')\n" + "echo('SEEN=' .. table.concat(seen, ',') .. '#\\n')\n")); + + QCOMPARE(host->getTriggerUnit()->processingDepth(), 0); + QVERIFY2(bufferContains(qsl("Trigger processing stopped to prevent a freeze")), "Expected the runaway in the nested pass to be stopped"); + QVERIFY2(bufferContains(qsl("SEEN=inner,outer#")), "Expected the capture trigger created by the outer line to survive the nested pass's abort and still match the outer line"); + } + + // The loop is not a feedTriggers() curiosity: an ordinary line arriving from + // the game reaches processDataStream() the same way, and froze Mudlet on the + // login banner. Driving it from the socket also proves the abort leaves the + // event loop running rather than wedging the connection. + void test_selfRecreatingTriggerFromServerTextIsStopped() + { + startProfile(mpHostname, mpLocalhost, mpPort); + auto* host = mudlet::self()->getActiveHost(); + QVERIFY(host); + host->mEchoLuaErrors = true; + + host->getLuaInterpreter()->compileAndExecuteScript(qsl("function armFromServer()\n" + " tempRegexTrigger('^HP: 100/100$', [[armFromServer()]], 1)\n" + "end\n" + "armFromServer()\n")); + + mpServer->sendRaw(QByteArray("HP: 100/100\r\n")); + QTRY_VERIFY2_WITH_TIMEOUT(bufferContains(qsl("Trigger processing stopped to prevent a freeze")), "Expected server text to reach the same-line generation budget and be stopped", 10000); + QCOMPARE(host->getTriggerUnit()->processingDepth(), 0); + } + void cleanup() { delete mpServer; diff --git a/test/functional_tests/UnitDeferredDeleteTest.cpp b/test/functional_tests/UnitDeferredDeleteTest.cpp index 60ad34549..a770c1eaf 100644 --- a/test/functional_tests/UnitDeferredDeleteTest.cpp +++ b/test/functional_tests/UnitDeferredDeleteTest.cpp @@ -485,8 +485,131 @@ private slots: QVERIFY2(!unit->getKey(id), "the key should have been freed exactly once"); } + // The other half of the corpse-is-still-findable-by-name premise: killTrigger() + // skips an item that is only waiting to be freed, but enableTrigger() used to + // re-activate every same-named entry unconditionally. That resurrects the + // corpse, contradicting the guarantee TTrigger::match() states where it expires + // a trigger ("an enableTrigger() before the deferred free cannot resurrect a + // trigger that has already spent its last fire"). + void test_triggerEnableByNameCannotReviveKilled() + { + auto* unit = mpHost->getTriggerUnit(); + const int id = mpHost->mLuaInterpreter.startTempTrigger(qsl("resurrect_trigger"), QString(), -1); + QVERIFY(id > 0); + auto* pTrigger = unit->getTrigger(id); + QVERIFY(pTrigger); + const QString name = QString::number(id); + QVERIFY(pTrigger->isActive()); + + QVERIFY2(unit->killTrigger(name), "the temporary trigger should be killable by name"); + QVERIFY2(!pTrigger->isActive(), "killTrigger() must deactivate as well as queue the delete"); + QVERIFY2(unit->mCleanupSet.contains(pTrigger), "the killed trigger should be waiting to be freed"); + + QVERIFY2(!unit->enableTrigger(name), "enableTrigger() must not report success for a trigger that is only waiting to be freed"); + QVERIFY2(!pTrigger->isActive(), "a killed trigger must stay dead until it is freed"); + + unit->doCleanup(); + QVERIFY2(!unit->getTrigger(id), "the killed trigger should still have been freed"); + } + + // The same thing as a user meets it: a one-shot trigger has spent its single + // fire on this line, and a script running later on the same line enables it by + // name. It must not fire a second time when the line is fed again. + void test_triggerEnableByNameCannotReviveExpiredOneShot() + { + mpHost->mLuaInterpreter.compileAndExecuteScript(qsl("oneShotFires = 0\n" + "reviverRan = false\n" + "tempComplexRegexTrigger('watchOnce', '^ONESHOT$', [[oneShotFires = oneShotFires + 1]], 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1)\n" + "tempRegexTrigger('^ONESHOT$', [[\n" + " if not reviverRan then\n" + " reviverRan = true\n" + " enableTrigger('watchOnce')\n" + " feedTriggers('ONESHOT\\n')\n" + " end\n" + "]], 1)\n" + "feedTriggers('ONESHOT\\n')\n")); + + QCOMPARE(mpHost->getTriggerUnit()->processingDepth(), 0); + QVERIFY2(readGlobalBool(qsl("reviverRan")), "the script that calls enableTrigger() has to have run for this to test anything"); + QCOMPARE(readGlobalInt(qsl("oneShotFires")), 1); + } + + // The other deferred-delete container needs the same treatment: uninstall() + // at a non-zero processing depth deactivates its package's triggers, drops + // them from mCleanupSet to keep the two paths disjoint, and leaves them in + // uninstallList to be freed at depth 0. They stay in the lookup table for + // that window, so enableTrigger() would otherwise bring a trigger belonging + // to an already-uninstalled package back to life. The container is populated + // directly, as the cases below do: reaching this state from Lua needs a + // package-owned temporary item, which no current import path produces. + void test_triggerEnableByNameCannotReviveAnUninstalledTrigger() + { + auto* unit = mpHost->getTriggerUnit(); + const int id = mpHost->mLuaInterpreter.startTempTrigger(qsl("uninstall_revive_trigger"), QString(), -1); + QVERIFY(id > 0); + auto* pTrigger = unit->getTrigger(id); + QVERIFY(pTrigger); + const QString name = QString::number(id); + + pTrigger->setIsActive(false); + unit->uninstallList.append(pTrigger); + QVERIFY2(!unit->mCleanupSet.contains(pTrigger), "uninstall() keeps the two deferred-delete containers disjoint"); + + QVERIFY2(!unit->enableTrigger(name), "enableTrigger() must not report success for a trigger an uninstall is waiting to free"); + QVERIFY2(!pTrigger->isActive(), "a trigger whose package has been uninstalled must stay inactive"); + + unit->doCleanup(); + QVERIFY2(!unit->getTrigger(id), "the uninstalled trigger should still have been freed"); + } + + // The skip must not stop the walk: a corpse and a live trigger can share a + // name (tempComplexRegexTrigger() takes a user-supplied one), and #9366's + // guarantee that enable-by-name reaches every same-named trigger still holds + // for the ones that are actually alive. + void test_triggerEnableByNameStillReachesALiveSameNamedTrigger() + { + auto* unit = mpHost->getTriggerUnit(); + const QStringList permPatterns{qsl("mixed_corpse_perm")}; + auto [permId, message] = mpHost->mLuaInterpreter.startPermSubstringTrigger(qsl("mixed corpse placeholder"), QString(), permPatterns, QString()); + QVERIFY2(permId > 0, qPrintable(message)); + const QString sharedName = QString::number(permId + 1); + unit->getTrigger(permId)->setName(sharedName); + + const int tempId = mpHost->mLuaInterpreter.startTempTrigger(qsl("mixed_corpse_temp"), QString()); + QCOMPARE(tempId, permId + 1); + QCOMPARE(lookupCount(unit->mLookupTable.count(sharedName)), 2); + + QVERIFY2(unit->killTrigger(sharedName), "the temporary trigger should be the one killed"); + unit->getTrigger(permId)->setIsActive(false); + + QVERIFY2(unit->enableTrigger(sharedName), "enableTrigger must walk past the corpse to the live trigger filed under the same name"); + QVERIFY2(unit->getTrigger(permId)->isActive(), "the live same-named trigger should have been enabled"); + QVERIFY2(!unit->getTrigger(tempId)->isActive(), "the killed trigger must stay dead"); + + unit->doCleanup(); + QVERIFY(!unit->getTrigger(tempId)); + } + // Helpers (reused from the ResetProfileTest pattern) + int readGlobalInt(const QString& name) + { + lua_State* L = mpHost->mLuaInterpreter.getLuaGlobalState(); + lua_getglobal(L, name.toUtf8().constData()); + const int value = static_cast<int>(lua_tointeger(L, -1)); + lua_pop(L, 1); + return value; + } + + bool readGlobalBool(const QString& name) + { + lua_State* L = mpHost->mLuaInterpreter.getLuaGlobalState(); + lua_getglobal(L, name.toUtf8().constData()); + const bool value = lua_toboolean(L, -1); + lua_pop(L, 1); + return value; + } + void startProfile(const QString& hostname, const QString& address, const QString& port) { QTimer::singleShot(0ms, qApp, [hostname, address, port]() { From dbf88336edd8973bb18b6aa079eb942fe29fb34a Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Thu, 6 Aug 2026 13:33:06 +0200 Subject: [PATCH 103/155] Fix user key bindings on Ctrl+1 to Ctrl+9 and Ctrl+Tab (#9703) #### Brief overview of PR changes/additions - The profile tab switching shortcuts added in #9460 "add: keyboard shortcuts to switch between game tabs" (`b649b60f0`) are `QShortcut`s on the main window, and Qt's `QShortcutMap` consumes a matching key inside `QApplication::notify` before the `KeyPress` ever reaches the command line. `TCommandLine::handleCtrlTabChange()`'s "let user-defined Ctrl+# keys match first" branch became unreachable, so user key bindings on Ctrl+1..Ctrl+9, Ctrl+Tab and Ctrl+Shift+Tab silently stopped working. - `TCommandLine::event()` now claims `QEvent::ShortcutOverride` for exactly those key sequences when a user binding matches, which is the same escape hatch the accessibility caret shortcut already uses. Asking needs a non-executing query, hence `TKey`/`KeyUnit::wouldMatch()` - `keybindingMatched()` runs the binding and would fire it on every override probe. The match reproduces `QShortcutMap`'s own retries, so Ctrl and a numpad digit, and Ctrl+Shift and a digit on layouts that need Shift for the top row (French AZERTY), are covered too. - Precedence, stated explicitly: a user binding wins over the built-in tab switch, which is what that comment always intended. A binding that is disabled, or sits in a disabled group, does not claim the key, and every other application shortcut is unaffected. #### Motivation for adding to Mudlet Ctrl+1 to Ctrl+9 is a common combat/target hotkey range and the one Mudlet's own key editor offers. Upgrading silently broke those bindings with no error and no warning, and the escape hatch (clearing the shortcut in Preferences) is undiscoverable. #### Other info (issues closed, discussion etc) Test case: `ctest -R ProfileSwitchShortcutTest` - 15 cases covering the claim, the no-claim controls, disabled bindings and groups, the keypad and shifted-digit spellings, Ctrl+Shift+Tab's `Key_Backtab` spelling, a cleared shortcut not claiming every key, and that a claimed binding runs exactly once. Verified to fail without the fix. Not fixed here, reported instead: the caret-mode Ctrl+Tab toggle lives on `Host::mCaretShortcut` rather than `ShortcutsManager`, so #9449's shortcut clash warning still cannot see its collision with the "Next profile" default. Assisted-by: Claude:claude-opus-5 --- src/KeyUnit.cpp | 15 + src/KeyUnit.h | 3 + src/TCommandLine.cpp | 34 ++ src/TCommandLine.h | 1 + src/TKey.cpp | 23 + src/TKey.h | 3 + src/mudlet.cpp | 60 +++ src/mudlet.h | 2 + test/functional_tests/CMakeLists.txt | 1 + .../ProfileSwitchShortcutTest.cpp | 451 ++++++++++++++++++ 10 files changed, 593 insertions(+) create mode 100644 test/functional_tests/ProfileSwitchShortcutTest.cpp diff --git a/src/KeyUnit.cpp b/src/KeyUnit.cpp index 688ea997a..4a7fde13e 100644 --- a/src/KeyUnit.cpp +++ b/src/KeyUnit.cpp @@ -138,6 +138,21 @@ bool KeyUnit::processDataStream(const Qt::Key key, const Qt::KeyboardModifiers m return isMatchFound; } +bool KeyUnit::wouldMatch(const Qt::Key key, const Qt::KeyboardModifiers modifiers) const +{ + for (auto keyObject : mKeyRootNodeList) { + if (!keyObject || !keyObject->isActive() || (keyObject->mpHost && keyObject->mpHost->isClosingDown())) { + continue; + } + + if (keyObject->wouldMatch(key, modifiers)) { + return true; + } + } + + return false; +} + void KeyUnit::compileAll() { for (auto key : mKeyRootNodeList) { diff --git a/src/KeyUnit.h b/src/KeyUnit.h index 74b07e5ec..db73e5907 100644 --- a/src/KeyUnit.h +++ b/src/KeyUnit.h @@ -69,6 +69,9 @@ public: void uninstall(const QString&); void _uninstall(TKey* pChild, const QString& packageName); bool processDataStream(const Qt::Key, const Qt::KeyboardModifiers); + // Reports whether processDataStream() would find a binding for this key + // combination, without running any of them + bool wouldMatch(const Qt::Key, const Qt::KeyboardModifiers) const; void markCleanup(TKey* pT); void doCleanup(); int processingDepth() const { return mProcessingDepth; } diff --git a/src/TCommandLine.cpp b/src/TCommandLine.cpp index b99605d2f..0d8629b2f 100644 --- a/src/TCommandLine.cpp +++ b/src/TCommandLine.cpp @@ -163,6 +163,20 @@ bool TCommandLine::keybindingMatched(QKeyEvent* keyEvent) return false; } +bool TCommandLine::keybindingWouldMatchProfileSwitchShortcut(const QKeyEvent* keyEvent) const +{ + if (!mpKeyUnit || (mpHost && mpHost->isClosingDown())) { + return false; + } + + auto* pMudlet = mudlet::self(); + if (!pMudlet || !pMudlet->profileSwitchShortcutMatches(keyEvent)) { + return false; + } + + return mpKeyUnit->wouldMatch(static_cast<Qt::Key>(keyEvent->key()), keyEvent->modifiers()); +} + // This function overrides the QWidget::event() and should return true if the // event was recognized, otherwise it should return false. If the recognized // event was accepted (see QEvent::accepted), any further processing such as @@ -186,6 +200,18 @@ bool TCommandLine::event(QEvent* event) ke->accept(); return true; } + + // A user's own key binding beats the profile tab switching shortcuts, + // the precedence handleCtrlTabChange() below describes - but those are + // QShortcuts on the main window, and QShortcutMap consumes a matching + // key before the KeyPress is ever delivered here, so the binding has to + // be spotted now. Only the keys those shortcuts occupy are asked about, + // and asked without running anything - the binding runs when the + // KeyPress that this claim lets through arrives: + if (keybindingWouldMatchProfileSwitchShortcut(ke)) { + ke->accept(); + return true; + } } const Qt::KeyboardModifiers allModifiers = Qt::ShiftModifier | Qt::ControlModifier | Qt::AltModifier | Qt::MetaModifier | Qt::KeypadModifier | Qt::GroupSwitchModifier; @@ -1331,6 +1357,14 @@ bool TCommandLine::handleCtrlTabChange(QKeyEvent* ke, int tabNumber) // hasn't created one then we fallback to tab switching - however // since some locales need the SHIFT modifier to enter numbers from the // top keyboard row (e.g. French AZERTY) we must ignore that one! + // + // Since the "Switch to profile N" QShortcuts were added this branch is + // no longer where that precedence is decided: whenever such a shortcut + // is set, the key only arrives here at all because event() claimed the + // ShortcutOverride for a matching binding, so the binding always wins + // and the tab switch below runs through the shortcut instead. The + // fallback still matters for Ctrl+0, which has no shortcut, and for + // shortcuts the user has cleared or remapped. if (keybindingMatched(ke)) { // Ah the user HAS created a matching binding: return true; diff --git a/src/TCommandLine.h b/src/TCommandLine.h index 99a519a3c..97b06804f 100644 --- a/src/TCommandLine.h +++ b/src/TCommandLine.h @@ -116,6 +116,7 @@ private: void enterCommand(QKeyEvent*); void processNormalKey(QEvent*); bool keybindingMatched(QKeyEvent*); + bool keybindingWouldMatchProfileSwitchShortcut(const QKeyEvent*) const; void spellCheckWord(QTextCursor& c); bool handleCtrlTabChange(QKeyEvent* key, int tabNumber); void restoreHistory(); diff --git a/src/TKey.cpp b/src/TKey.cpp index c0c22b167..6a2bff9fa 100644 --- a/src/TKey.cpp +++ b/src/TKey.cpp @@ -103,6 +103,29 @@ bool TKey::match(const Qt::Key key, const Qt::KeyboardModifiers modifier, const } +bool TKey::wouldMatch(const Qt::Key key, const Qt::KeyboardModifiers modifier) const +{ + // isActive() is also false for a half-destroyed key, so this covers the + // dereference below. Nothing runs during this walk, so unlike match() there + // is no re-entrancy to guard against: + if (!isActive()) { + return false; + } + + if (!isFolder() && (mKeyCode == key) && (mKeyModifier == modifier)) { + return true; + } + + for (auto childKey : *mpMyChildrenList) { + if (childKey->wouldMatch(key, modifier)) { + return true; + } + } + + return false; +} + + bool TKey::registerKey() { if (!mpHost) { diff --git a/src/TKey.h b/src/TKey.h index 715cefa49..265e6ea5c 100644 --- a/src/TKey.h +++ b/src/TKey.h @@ -64,6 +64,9 @@ public: bool match(const Qt::Key, const Qt::KeyboardModifiers, const bool); + // Same walk as match() but without running anything - for asking whether a + // key press is spoken for before deciding to let it through: + bool wouldMatch(const Qt::Key, const Qt::KeyboardModifiers) const; bool registerKey(); void validateKeyBinding(); diff --git a/src/mudlet.cpp b/src/mudlet.cpp index 480e8a345..30927effb 100644 --- a/src/mudlet.cpp +++ b/src/mudlet.cpp @@ -65,6 +65,7 @@ #include <QFileDialog> #include <QJsonDocument> #include <QImage> +#include <QKeyEvent> #include <QJsonObject> #include <QJsonValue> #include <QNetworkDiskCache> @@ -2120,6 +2121,65 @@ void mudlet::switchToProfileTab(int index) } } +// Whether this key press would activate one of the profile tab switching +// shortcuts. Has to reproduce QShortcutMap's matching rather than compare the +// key press literally, because a shortcut can be spelt differently to the key +// press that activates it: +bool mudlet::profileSwitchShortcutMatches(const QKeyEvent* ke) const +{ + if (!ke) { + return false; + } + + const auto key = static_cast<Qt::Key>(ke->key()); + const Qt::KeyboardModifiers modifiers = ke->modifiers(); + + // QShortcutMap retries the match with the modifiers the platform consumed + // producing the character stripped off, so a shortcut fires for presses + // spelt differently to itself. Both retries that reach these shortcuts land + // on the digits: Ctrl and a numpad digit activates Ctrl+1, and on layouts + // that need Shift for a top-row digit (French AZERTY) so does Ctrl+Shift+1 - + // which is the same reason handleCtrlTabChange() ignores Shift. + QList<QKeySequence> candidates; + const Qt::KeyboardModifiers strippable[] = {Qt::NoModifier, Qt::KeypadModifier, Qt::ShiftModifier, Qt::ShiftModifier | Qt::KeypadModifier}; + for (const auto stripped : strippable) { + // Only single key combinations are ever produced here, so a shortcut + // remapped to a multi-step sequence would never be matched - none of + // the defaults are, and the shortcut editor cannot record one: + const QKeySequence candidate(QKeyCombination(modifiers & ~stripped, key)); + if (!candidates.contains(candidate)) { + candidates.append(candidate); + } + } + + if (key == Qt::Key_Backtab) { + // The other direction: Shift+Tab produces the Backtab keysym, while the + // sequences are spelt with Key_Tab (see mudlet::mudlet(), where they are + // defined). Shift is normally still set on such an event, but Qt's own + // Backtab handling does not rely on that, so put it back rather than + // assume it is there: + candidates.append(QKeySequence(QKeyCombination(modifiers | Qt::ShiftModifier, Qt::Key_Tab))); + } + + auto shadows = [&candidates](const QKeySequence& sequence) { + // A shortcut the user cleared in the preferences is an empty sequence, + // and comparing it would match any candidate that was also empty: + return !sequence.isEmpty() && candidates.contains(sequence); + }; + + if (shadows(mKeySequenceNextProfile) || shadows(mKeySequencePreviousProfile)) { + return true; + } + + for (const auto& sequence : mKeySequencesSwitchToProfile) { + if (shadows(sequence)) { + return true; + } + } + + return false; +} + // Moved as much as possible to activateProfile()... void mudlet::slot_tabChanged(int tabID) { diff --git a/src/mudlet.h b/src/mudlet.h index 0f3e30659..193f34791 100644 --- a/src/mudlet.h +++ b/src/mudlet.h @@ -62,6 +62,7 @@ class QAction; class QCloseEvent; class QDateTime; class QDir; +class QKeyEvent; class QMediaDevices; class QMediaPlayer; class QMenu; @@ -201,6 +202,7 @@ public: void setupConfig(); void activateProfile(Host*); void switchToProfileTab(int index); + bool profileSwitchShortcutMatches(const QKeyEvent*) const; void takeOwnershipOfInstanceCoordinator(std::unique_ptr<MudletInstanceCoordinator>); MudletInstanceCoordinator* getInstanceCoordinator(); void addConsoleForNewHost(Host*); diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index ed211f064..4f2cd6a08 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -48,6 +48,7 @@ set(FUNCTIONAL_TEST_SOURCES DialogTeardownTest.cpp TMediaLoopTest.cpp DefaultPackagesTest.cpp + ProfileSwitchShortcutTest.cpp ExperiencedPlayerGateTest.cpp ) diff --git a/test/functional_tests/ProfileSwitchShortcutTest.cpp b/test/functional_tests/ProfileSwitchShortcutTest.cpp new file mode 100644 index 000000000..fd8489aed --- /dev/null +++ b/test/functional_tests/ProfileSwitchShortcutTest.cpp @@ -0,0 +1,451 @@ +/*************************************************************************** + * Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +/* + * The profile tab switching shortcuts (Ctrl+1 to Ctrl+9, Ctrl+Tab) are + * QShortcuts on the main window. Qt resolves a QShortcut by first sending a + * QEvent::ShortcutOverride to the focus widget and, unless that widget accepts + * it, running the shortcut and never delivering the KeyPress. A user's own key + * binding on one of those keys therefore only survives if the command line + * claims the override. + * + * The invariant under test: the command line claims the override exactly when + * a live user key binding matches a key press that would otherwise activate a + * profile switching shortcut - including the presses QShortcutMap matches to a + * differently spelt shortcut - and never otherwise. + * + * Run with: ctest -R ProfileSwitchShortcutTest -V + */ + +#include <QtTest/QtTest> +#include <chrono> + +#include "Host.h" +#include "KeyUnit.h" +#include "MudletInstanceCoordinator.h" +#include "TCommandLine.h" +#include "TKey.h" +#include "TLuaInterpreter.h" +#include "ShortcutsManager.h" +#include "TMainConsole.h" +#include "TelnetServerStub.h" +#include "ctelnet.h" +#include "dlgConnectionProfiles.h" +#include "mudlet.h" + +#include <QShortcut> + +extern "C" { +#if defined(INCLUDE_VERSIONED_LUA_HEADERS) +#include <lua5.1/lauxlib.h> +#include <lua5.1/lua.h> +#include <lua5.1/lualib.h> +#else +#include <lauxlib.h> +#include <lua.h> +#include <lualib.h> +#endif +} + +using namespace std::chrono_literals; + +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); +void initializeQRCResourcesForProfileSwitchShortcutTest(); + +// Qt::CTRL is the Cmd key on macOS, where the "next profile" shortcut uses the +// physical Control key (Qt::META) instead - mirrors mudlet::mudlet(): +#if defined(Q_OS_MACOS) +static constexpr Qt::KeyboardModifier nextProfileModifier = Qt::MetaModifier; +#else +static constexpr Qt::KeyboardModifier nextProfileModifier = Qt::ControlModifier; +#endif + +class ProfileSwitchShortcutTest : public QObject +{ + Q_OBJECT + +private: + TelnetServerStub* mpServer = nullptr; + Host* mpHost = nullptr; + const QString mHostname = "ProfileSwitchShortcut-Test"; + QString mPort; // assigned the stub's actual ephemeral port in initTestCase() + const QString mLocalhost = "localhost"; + + TCommandLine* commandLine() const + { + if (!mpHost || !mpHost->mpConsole) { + return nullptr; + } + return mpHost->mpConsole->mpCommandLine; + } + + // Replays what QShortcutMap does before it runs a shortcut: it offers the + // key to the focus widget as an ignored ShortcutOverride and only runs the + // shortcut if nobody accepted it. + bool overrideClaimed(int key, Qt::KeyboardModifiers modifiers) const + { + QKeyEvent event(QEvent::ShortcutOverride, key, modifiers); + event.ignore(); + QApplication::sendEvent(commandLine(), &event); + return event.isAccepted(); + } + + void sendKeyPress(int key, Qt::KeyboardModifiers modifiers) const + { + QKeyEvent event(QEvent::KeyPress, key, modifiers); + QApplication::sendEvent(commandLine(), &event); + } + + // A claim is only worth asserting if a shortcut is actually competing for + // the key, so every test that asserts one first proves the collision is + // real - otherwise a mis-mapped sequence would look like a code failure. + bool shortcutInstalledFor(const QKeySequence& sequence) const + { + const auto shortcuts = mudlet::self()->findChildren<QShortcut*>(); + for (auto* shortcut : shortcuts) { + if (shortcut->key() == sequence && shortcut->isEnabled()) { + return true; + } + } + return false; + } + + // Read from the shortcuts manager rather than hard coded, since it is + // Alt+E on Linux and Windows but Ctrl+E on macOS. + std::pair<int, Qt::KeyboardModifiers> scriptEditorShortcut() const + { + auto* sequence = mudlet::self()->shortcutsManager()->getSequence(qsl("Script editor")); + if (!sequence || sequence->isEmpty()) { + return {Qt::Key_unknown, Qt::NoModifier}; + } + const QKeyCombination combination = (*sequence)[0]; + return {combination.key(), combination.keyboardModifiers()}; + } + + int luaCounter(const QString& globalName) const + { + lua_State* L = mpHost->mLuaInterpreter.getLuaGlobalState(); + lua_getglobal(L, globalName.toUtf8().constData()); + const int value = static_cast<int>(lua_tointeger(L, -1)); + lua_pop(L, 1); + return value; + } + + // Creates a permanent key binding whose script counts its own invocations + // into a Lua global, and returns its id. + int createCountingKey(const QString& name, int keycode, int modifier, const QString& counterName, const QString& parent = QString()) + { + QString keyName = name; + QString parentName = parent; + QString script = qsl("%1 = (%1 or 0) + 1").arg(counterName); + auto [id, message] = mpHost->mLuaInterpreter.startPermKey(keyName, parentName, keycode, modifier, script); + if (id <= 0) { + qWarning() << "createCountingKey failed:" << message; + } + return id; + } + + // Deleting the roots outright is only safe because every key here is + // permanent and none is killed or uninstalled, so KeyUnit's deferred-delete + // set is always empty. Add a temporary key or a killKey() call to this file + // and this has to go through markCleanup()/doCleanup() instead. + void removeAllKeys() + { + auto* keyUnit = mpHost->getKeyUnit(); + const auto rootKeys = keyUnit->getKeyRootNodeList(); // by value: ~TKey mutates the real list + for (auto* key : rootKeys) { + delete key; + } + } + +private slots: + void initTestCase() + { + initializeQRCResourcesForProfileSwitchShortcutTest(); + + mpServer = new TelnetServerStub(qApp); + mpServer->start(mLocalhost, 0); // ephemeral OS-assigned port avoids collisions across concurrent test runs + mPort = QString::number(mpServer->serverPort()); + mudlet::start(); + mudlet::self()->setupConfig(); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique<MudletInstanceCoordinator>("MudletInstanceCoordinator")); + mudlet::self()->init(); + mudlet::self()->setStorePasswordsSecurely(false); + deleteProfileDirectory(mHostname); + + startProfile(mHostname, mLocalhost, mPort); + mpHost = mudlet::self()->getActiveHost(); + QVERIFY2(mpHost, "No active host after profile creation"); + QVERIFY2(commandLine(), "No command line available for the test"); + + // The caret shortcut is checked before this code in TCommandLine::event() + // and CtrlTab would claim Ctrl+Tab itself, so pin it to the default + // rather than let an unrelated feature decide what these tests measure: + mpHost->mCaretShortcut = Host::CaretShortcut::None; + } + + void cleanupTestCase() + { + mpHost = nullptr; + delete mpServer; + mpServer = nullptr; + deleteProfileDirectory(mHostname); + delete mudlet::self(); + } + + void cleanup() { removeAllKeys(); } + + // The regression itself: a user binding on Ctrl+1 must beat "Switch to + // profile 1". + void test_userBindingOnCtrlNumberClaimsTheShortcut() + { + QVERIFY2(shortcutInstalledFor(QKeySequence(Qt::CTRL | Qt::Key_1)), "No profile switching shortcut is installed for Ctrl+1, so this test proves nothing"); + + QVERIFY(createCountingKey(qsl("Ctrl+1 binding"), Qt::Key_1, Qt::ControlModifier, qsl("_testCtrl1")) > 0); + + QVERIFY2(overrideClaimed(Qt::Key_1, Qt::ControlModifier), "A user key binding on Ctrl+1 did not claim the key, so the profile switch shortcut swallows it"); + } + + // Without a binding the key has to be left alone so the tab switch happens. + void test_withoutUserBindingTheShortcutKeepsTheKey() + { + QVERIFY2(!overrideClaimed(Qt::Key_1, Qt::ControlModifier), "Ctrl+1 was claimed even though no user key binding matches it - profile switching would stop working"); + } + + // A binding on a key that no profile switching shortcut uses needs no + // claim - Ctrl+0 is the control case that always worked, because only nine + // shortcuts (Ctrl+1 to Ctrl+9) are installed. + void test_bindingOnAnUnshadowedKeyIsNotClaimed() + { + QVERIFY(createCountingKey(qsl("Ctrl+0 binding"), Qt::Key_0, Qt::ControlModifier, qsl("_testCtrl0")) > 0); + + QVERIFY2(!overrideClaimed(Qt::Key_0, Qt::ControlModifier), "Ctrl+0 is not a profile switching shortcut, so the command line must not claim it"); + } + + // A disabled binding is not a binding, so it must not steal the key from + // the tab switch. Disabled through KeyUnit::disableKey(), which is the path + // the editor and the Lua disableKey() take - it clears mActive, not the + // mUserActiveState that setIsActive() writes. + void test_disabledUserBindingDoesNotClaimTheShortcut() + { + const QString name = qsl("Disabled Ctrl+2 binding"); + QVERIFY(createCountingKey(name, Qt::Key_2, Qt::ControlModifier, qsl("_testCtrl2")) > 0); + QVERIFY(overrideClaimed(Qt::Key_2, Qt::ControlModifier)); + + QVERIFY(mpHost->getKeyUnit()->disableKey(name)); + + QVERIFY2(!overrideClaimed(Qt::Key_2, Qt::ControlModifier), "A disabled key binding still claimed Ctrl+2"); + } + + // The nine switch-to-profile shortcuts are generated in a loop, so check + // the far end of it too. + void test_userBindingOnCtrlNineClaimsTheShortcut() + { + QVERIFY2(shortcutInstalledFor(QKeySequence(Qt::CTRL | Qt::Key_9)), "No profile switching shortcut is installed for Ctrl+9, so this test proves nothing"); + + QVERIFY(createCountingKey(qsl("Ctrl+9 binding"), Qt::Key_9, Qt::ControlModifier, qsl("_testCtrl9")) > 0); + + QVERIFY2(overrideClaimed(Qt::Key_9, Qt::ControlModifier), "A user key binding on Ctrl+9 did not claim the key"); + } + + // Same for an active binding sitting inside a disabled group. + void test_userBindingInDisabledGroupDoesNotClaimTheShortcut() + { + const int groupId = createCountingKey(qsl("Key Group"), -1, 0, qsl("_testGroup")); + QVERIFY(groupId > 0); + auto* group = mpHost->getKeyUnit()->getKey(groupId); + QVERIFY(group); + group->setIsActive(true); + + QVERIFY(createCountingKey(qsl("Grouped Ctrl+3 binding"), Qt::Key_3, Qt::ControlModifier, qsl("_testCtrl3"), qsl("Key Group")) > 0); + QVERIFY2(overrideClaimed(Qt::Key_3, Qt::ControlModifier), "A binding in an enabled group should claim Ctrl+3"); + + group->setIsActive(false); + QVERIFY2(!overrideClaimed(Qt::Key_3, Qt::ControlModifier), "A binding inside a disabled group still claimed Ctrl+3"); + } + + // Ctrl+Tab ("Next profile") is shadowed the same way and needs the same + // treatment, in both directions. + void test_userBindingOnCtrlTabClaimsTheShortcut() + { + QVERIFY2(shortcutInstalledFor(QKeySequence(nextProfileModifier | Qt::Key_Tab)), "No 'Next profile' shortcut is installed for Ctrl+Tab, so this test proves nothing"); + QVERIFY2(!overrideClaimed(Qt::Key_Tab, nextProfileModifier), "Ctrl+Tab was claimed with no user key binding present"); + + QVERIFY(createCountingKey(qsl("Ctrl+Tab binding"), Qt::Key_Tab, nextProfileModifier, qsl("_testCtrlTab")) > 0); + + QVERIFY2(overrideClaimed(Qt::Key_Tab, nextProfileModifier), "A user key binding on Ctrl+Tab did not claim the key"); + } + + // "Previous profile" is Ctrl+Shift+Tab, but Shift+Tab reaches the widget as + // Key_Backtab with the Shift modifier kept, so the sequence (spelt with + // Key_Tab) and the key press disagree on the spelling and the match has to + // bridge that. + void test_userBindingOnCtrlShiftTabClaimsTheShortcut() + { + const auto modifiers = nextProfileModifier | Qt::ShiftModifier; + QVERIFY2(!overrideClaimed(Qt::Key_Backtab, modifiers), "Ctrl+Shift+Tab was claimed with no user key binding present"); + + QVERIFY(createCountingKey(qsl("Ctrl+Shift+Tab binding"), Qt::Key_Backtab, modifiers, qsl("_testCtrlShiftTab")) > 0); + + QVERIFY2(overrideClaimed(Qt::Key_Backtab, modifiers), "A user key binding on Ctrl+Shift+Tab did not claim the key"); + } + + // Only the profile switching shortcuts are overridden. Every other + // application shortcut keeps its key, so a binding on the script editor + // shortcut must not be claimed. + void test_bindingOnAnotherApplicationShortcutIsNotClaimed() + { + auto [key, modifiers] = scriptEditorShortcut(); + QVERIFY2(key != Qt::Key_unknown, "Could not read the script editor shortcut"); + + QVERIFY(createCountingKey(qsl("Script editor shortcut binding"), key, modifiers, qsl("_testEditor")) > 0); + + QVERIFY2(!overrideClaimed(key, modifiers), "A key binding claimed the script editor shortcut, which is outside the profile switching set"); + } + + // Guards the "empty sequence matches everything" failure mode. A key press + // that is not Backtab has no alternative spelling to compare against, so + // without the isEmpty() guard a shortcut the user has cleared in + // Preferences would compare equal to every key and claim the lot. + void test_aClearedProfileShortcutDoesNotClaimEveryKey() + { + auto* sequence = mudlet::self()->shortcutsManager()->getSequence(qsl("Switch to profile 1")); + QVERIFY2(sequence, "'Switch to profile 1' is not registered with the shortcuts manager"); + const QKeySequence saved = *sequence; + *sequence = QKeySequence(); + + auto [key, modifiers] = scriptEditorShortcut(); + QVERIFY(createCountingKey(qsl("Script editor shortcut binding"), key, modifiers, qsl("_testEditorCleared")) > 0); + QVERIFY(createCountingKey(qsl("F5 binding"), Qt::Key_F5, Qt::NoModifier, qsl("_testF5")) > 0); + + const bool editorClaimed = overrideClaimed(key, modifiers); + const bool f5Claimed = overrideClaimed(Qt::Key_F5, Qt::NoModifier); + *sequence = saved; + + QVERIFY2(!editorClaimed, "A cleared profile switching shortcut made an unrelated bound key claim the override"); + QVERIFY2(!f5Claimed, "A cleared profile switching shortcut made an unrelated bound key claim the override"); + } + + // QShortcutMap retries a match with the keypad modifier stripped, so Ctrl + // and a numpad digit activates the plain Ctrl+1 shortcut even though the + // two key combinations differ. Verified against the real thing: without the + // claim, Ctrl+numpad-2 switches profile and the binding never runs. + void test_userBindingOnAKeypadDigitClaimsTheShortcut() + { + const auto modifiers = Qt::ControlModifier | Qt::KeypadModifier; + QVERIFY(createCountingKey(qsl("Ctrl+keypad 1 binding"), Qt::Key_1, modifiers, qsl("_testKeypad1")) > 0); + + QVERIFY2(overrideClaimed(Qt::Key_1, modifiers), "A user key binding on Ctrl and a keypad digit did not claim the key"); + } + + // Layouts that need Shift for a top-row digit (French AZERTY) record the + // binding with Shift and still activate the plain Ctrl+1 shortcut, because + // QShortcutMap drops the Shift that was consumed producing the digit. + void test_userBindingOnAShiftedDigitClaimsTheShortcut() + { + const auto modifiers = Qt::ControlModifier | Qt::ShiftModifier; + QVERIFY(createCountingKey(qsl("Ctrl+Shift+1 binding"), Qt::Key_1, modifiers, qsl("_testShift1")) > 0); + + QVERIFY2(overrideClaimed(Qt::Key_1, modifiers), "A user key binding on Ctrl+Shift and a digit did not claim the key"); + } + + // Claiming the override only defers the key - the binding must then run + // exactly once, off the KeyPress that the claim let through, and not a + // second time from the probe itself. + void test_claimedBindingRunsExactlyOnce() + { + QVERIFY(createCountingKey(qsl("Ctrl+4 binding"), Qt::Key_4, Qt::ControlModifier, qsl("_testCtrl4")) > 0); + QCOMPARE(luaCounter(qsl("_testCtrl4")), 0); + + QVERIFY(overrideClaimed(Qt::Key_4, Qt::ControlModifier)); + QCOMPARE(luaCounter(qsl("_testCtrl4")), 0); // the probe must not execute anything + + sendKeyPress(Qt::Key_4, Qt::ControlModifier); + QCOMPARE(luaCounter(qsl("_testCtrl4")), 1); + } + +private: + void startProfile(const QString& hostname, const QString& address, const QString& port) + { + QTimer::singleShot(0ms, qApp, [hostname, address, port]() { + mudlet::self()->startAutoLogin({}); + QTest::qWait(100ms); + QTest::mouseClick(mudlet::self()->mpConnectionDialog->new_profile_button, Qt::LeftButton); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), hostname); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), address); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), port); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Return); + }); + + QSignalSpy spy(mudlet::self(), &mudlet::signal_profileLoaded); + if (!spy.wait(5000)) { + QFAIL("Profile took too long to load."); + } + auto host = mudlet::self()->getActiveHost(); + if (!host) { + QFAIL("No active host available for the test."); + } + + QSignalSpy connectionSpy(&(host->mTelnet), &cTelnet::signal_connected); + if (!connectionSpy.wait(2000)) { + QFAIL("Could not connect with the host."); + } + } + + void deleteProfileDirectory(const QString& profileName) + { + const QString path = mudlet::getMudletPath(enums::profileHomePath, profileName); + QDir dir(path); + + if (!dir.exists()) { + return; + } + dir.removeRecursively(); + } +}; + +void initializeQRCResourcesForProfileSwitchShortcutTest() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +#include "ProfileSwitchShortcutTest.moc" +QTEST_MAIN(ProfileSwitchShortcutTest) From 260c450d18b4de2ab0a2e9c03782b6fbd8b3a33a Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Thu, 6 Aug 2026 14:51:37 +0200 Subject: [PATCH 104/155] infrastructure: trim the comments around the experienced-player gate (#9707) #### Brief overview of PR changes/additions - Comment-only follow-up to #9695 "fix: stop treating long-time Mudlet users as brand new players" - no code line changes at all. - Removes every passage describing what the gate used to do; git history and the #9695 body carry that, and in source it goes stale the moment someone touches the line. - Cuts what remains to the constraints a reader cannot derive from the code: the `init()` ordering requirement, why no filesystem timestamp can substitute for the recorded date, and why the fallback deliberately errs towards 'experienced'. #### Motivation for adding to Mudlet Applies the house comment standard to code that landed a few hours earlier: 112 comment lines out, 33 shorter ones in. #### Other info (issues closed, discussion etc) Test names carry the intent in `ExperiencedPlayerGateTest`, so per-assertion narration went; the `QVERIFY2` failure messages already say what each case is asserting. What was kept there: the permissions restore-before-assert ordering, the `$XDG_CONFIG_HOME/mudlet` opt-in marker, and the note that the live-singleton case must run last because `experiencedMudletPlayer()` memoises. **Test case:** `ctest --output-on-failure` - 79/79, unchanged. Assisted-by: Claude:claude-opus-5 --- src/mudlet.cpp | 60 +++------------ src/mudlet.h | 8 +- test/functional_tests/DefaultPackagesTest.cpp | 3 +- .../ExperiencedPlayerGateTest.cpp | 74 +++++-------------- 4 files changed, 33 insertions(+), 112 deletions(-) diff --git a/src/mudlet.cpp b/src/mudlet.cpp index 30927effb..4cb199cf5 100644 --- a/src/mudlet.cpp +++ b/src/mudlet.cpp @@ -177,10 +177,7 @@ mudlet::mudlet() void mudlet::init() { smFirstLaunch = !QFile::exists(mudlet::getMudletPath(enums::profilesPath)); - // Has to happen after setupConfig() has created mpSettings and before - // anything can create a profile, which is only true here. Note this asks a - // slightly different question to smFirstLaunch above: an existing but empty - // profiles directory still counts as a first launch. See rememberFirstLaunch() + // Must be after setupConfig() created mpSettings and before anything of this run is written rememberFirstLaunch(*mpSettings, mudlet::getMudletPath(enums::profilesPath), QDateTime::currentDateTime()); QFile gitShaFile(":/app-build.txt"); @@ -7610,8 +7607,6 @@ void mudlet::showedCharacterModeWarning() mCharacterModeWarningsShown = std::min(mCharacterModeWarningsShown + 1, mCharacterModeWarningsMax); } -// When Mudlet was first used on this installation, as UTC ISO-8601. Absent on -// installations that predate the key - see rememberFirstLaunch(). static const QLatin1String settingsKeyFirstLaunch("firstLaunchDate"); static constexpr int experiencedPlayerMonths = 6; @@ -7622,9 +7617,7 @@ static bool anyProfilesExist(const QString& profilesPath) return false; } if (!QFileInfo(profilesPath).isReadable()) { - // An unlistable directory looks exactly like an empty one, and reading - // it as empty would stamp a long-time user with today's date as their - // first launch - permanently, since that is only ever written once. + // Unlistable reads as empty, which would stamp an existing user with today as their first launch qWarning() << "anyProfilesExist() WARNING - the profiles directory exists but cannot be read:" << profilesPath << "- assuming it holds profiles, so an existing user is not mistaken for a new one."; return true; @@ -7632,29 +7625,20 @@ static bool anyProfilesExist(const QString& profilesPath) return !profiles.entryList(QDir::Dirs | QDir::NoDotAndDotDot).isEmpty(); } -// Evidence that Mudlet has run here before the first-launch key existed: a -// profile, or any other setting already on file. Either rules out a first-ever -// run, including for someone who kept their settings but not their profiles - -// a restored backup, or a move to a new machine. +// Settings count as well as profiles: someone who kept their Mudlet.ini but not +// their profiles is still not on their first run. static bool mudletUsedBefore(const QSettings& settings, const QString& profilesPath) { return anyProfilesExist(profilesPath) || !settings.allKeys().isEmpty(); } -// Intended to be called exactly once, from init(), after setupConfig() has made -// the settings available and before any profile or setting of this run can be -// written - only then does "no trace of earlier use" really mean the user is -// starting today. -// -// Where there is such a trace the start date is not recoverable, so nothing is -// recorded and evaluateExperiencedPlayer() falls back instead. No timestamp can -// stand in: Mudlet's own writes refresh them, and whether a copied or restored -// profile keeps its modification times depends entirely on the tool used, while -// its birth time is reset either way. +// Called only from init(), before anything of this run has been written. Where +// there is a trace of earlier use the start date is unrecoverable - no timestamp +// survives Mudlet's own writes, nor a copy to another machine - so nothing is +// recorded and evaluateExperiencedPlayer() falls back. /*static*/ void mudlet::rememberFirstLaunch(QSettings& settings, const QString& profilesPath, const QDateTime& now) { - // The parse is deliberately not consulted: re-recording an unreadable value - // would restart the six month clock today, which is the harmful direction. + // Not conditioned on the value parsing: re-recording would restart the clock today if (settings.contains(settingsKeyFirstLaunch) || mudletUsedBefore(settings, profilesPath)) { return; } @@ -7662,24 +7646,11 @@ static bool mudletUsedBefore(const QSettings& settings, const QString& profilesP settings.setValue(settingsKeyFirstLaunch, now.toUTC().toString(Qt::ISODate)); settings.sync(); if (settings.status() != QSettings::NoError) { - // Worth saying out loud: the write is never retried, because by the next - // run the user has a profile and is indistinguishable from an upgrader. - // A newcomer who hits this loses their onboarding for good. qWarning() << "mudlet::rememberFirstLaunch() WARNING - could not record the first launch date in" << settings.fileName() << "- QSettings status:" << settings.status() << "- this installation will later be taken for an experienced user's."; } } -// Returns true if the player has been using Mudlet long enough that first-time -// guidance - the interface tour, the starter UI, the one-line hints - would be -// an interruption rather than a help. -// -// This used to be inferred from profile directory modification times, which -// measured the opposite of what was wanted: the per-profile data writes (url, -// port, password, profile.ini, command history) all land directly in the -// profile directory and bump its mtime on every session, so only a profile left -// untouched for the whole window ever looked old. An active player of ten -// years' standing classified as brand new. /*static*/ bool mudlet::evaluateExperiencedPlayer(const QSettings& settings, const QString& profilesPath, const QDateTime& now) { const QString recorded = settings.value(settingsKeyFirstLaunch).toString(); @@ -7688,17 +7659,12 @@ static bool mudletUsedBefore(const QSettings& settings, const QString& profilesP return firstLaunch <= now.addMonths(-experiencedPlayerMonths); } if (!recorded.isEmpty()) { - // The value is meant to be legible and hand-editable, so say when a - // hand-edit did not take rather than ignoring it in silence. qWarning().nospace().noquote() << "evaluateExperiencedPlayer() WARNING - \"" << settingsKeyFirstLaunch << "\" holds \"" << recorded << "\", which is not ISO 8601 - falling back to looking for signs of earlier use."; } - // No usable record: an installation that predates the key, or one whose - // record was lost or corrupted. Either way the only signal left is whether - // Mudlet has been used here before. Erring towards 'experienced' is - // deliberate - interrupting a veteran with a beginner tour is far worse - // than a newcomer missing one. + // Erring towards 'experienced' is deliberate: interrupting a veteran with a + // beginner tour is worse than a newcomer missing one. return mudletUsedBefore(settings, profilesPath); } @@ -7711,9 +7677,7 @@ bool mudlet::experiencedMudletPlayer() const auto* settings = getQSettings(); if (!settings) { - // setupConfig() has not created them yet, so answer 'experienced', - // which shows nothing. Deliberately not cached: the answer is a guess, - // and caching it would pin every gate for the rest of the process. + // Not cached: a guess, and caching it would pin every gate for the process qWarning() << "mudlet::experiencedMudletPlayer() WARNING - called before setupConfig(), so assuming an experienced player and showing no first-run guidance."; return true; } diff --git a/src/mudlet.h b/src/mudlet.h index 193f34791..1cdfc5c8b 100644 --- a/src/mudlet.h +++ b/src/mudlet.h @@ -330,13 +330,11 @@ public: void showedMuteAllMediaTutorial(); bool showCharacterModeWarning(); void showedCharacterModeWarning(); - // True if the player has used Mudlet long enough not to need the basic - // tutorial tips, the interface tour or the starter UI. Memoised. + // True if the player has used Mudlet long enough not to need the tutorial + // tips, the interface tour or the starter UI. Memoised. bool experiencedMudletPlayer(); - // Records the first launch. Must be called exactly once, from init(), - // before any profile can exist - public only so it can be tested. + // The two below are public only so they can be tested static void rememberFirstLaunch(QSettings& settings, const QString& profilesPath, const QDateTime& now); - // The uncached body of experiencedMudletPlayer() - public only for testing. static bool evaluateExperiencedPlayer(const QSettings& settings, const QString& profilesPath, const QDateTime& now); // Telnet URI handling diff --git a/test/functional_tests/DefaultPackagesTest.cpp b/test/functional_tests/DefaultPackagesTest.cpp index c55e87bdc..eeac66e98 100644 --- a/test/functional_tests/DefaultPackagesTest.cpp +++ b/test/functional_tests/DefaultPackagesTest.cpp @@ -135,8 +135,7 @@ private slots: // Games that install an interface of their own get a loader instead of the // starter UI, which would otherwise fight it for the same screen space. - // Every other game gets it, as long as the player is new to Mudlet - this - // config dir has no profiles and no recorded history, so they are. + // This config dir has no profiles, so the player counts as new to Mudlet. void test_gamesWithTheirOwnUiSkipTheStarterUi() { QVERIFY(preinstallsFor(qsl("example.com")).contains(qsl(":/packages/mudlet-base-ui/mudlet-base-ui.mpackage"))); diff --git a/test/functional_tests/ExperiencedPlayerGateTest.cpp b/test/functional_tests/ExperiencedPlayerGateTest.cpp index 2c60a0748..6aee13dd5 100644 --- a/test/functional_tests/ExperiencedPlayerGateTest.cpp +++ b/test/functional_tests/ExperiencedPlayerGateTest.cpp @@ -23,17 +23,10 @@ * the one-line hints - so getting it wrong either buries a newcomer's * onboarding or drops a beginner tour on top of a ten-year veteran's session. * - * The heuristic this replaced read profile *directory* mtimes, which record - * when a profile was last written rather than how long it has existed; see - * mudlet::evaluateExperiencedPlayer() for why that is backwards. - * test_upgraderWithFreshlyWrittenProfilesIsExperienced is that exact shape and - * is the regression this file exists for. - * * mudlet::rememberFirstLaunch() and mudlet::evaluateExperiencedPlayer() take - * their settings, profiles path and "now" as arguments, so the cases below run + * their settings, profiles path and "now" as arguments, so most cases run * without a mudlet instance. The last two drive a real init() instead, to pin - * the production wiring: that init() records the date, and that the memoised - * experiencedMudletPlayer() reads back the same key from the same path. + * the production wiring. * * Run with: ctest -R ExperiencedPlayerGateTest -V */ @@ -61,8 +54,7 @@ private: QByteArray mSavedXdg; // Outlives the two live-singleton cases, which share one mudlet instance QTemporaryDir mLiveConfig; - // Fixed, so the six month arithmetic is not at the mercy of the day the - // suite happens to run on + // Fixed, so the six month arithmetic does not depend on the day the suite runs const QDateTime mNow = QDateTime(QDate(2026, 8, 5), QTime(12, 0), QTimeZone::UTC); const QString mKey = qsl("firstLaunchDate"); @@ -78,8 +70,7 @@ private: void setFirstLaunch(QSettings& settings, const QDateTime& when) const { settings.setValue(mKey, when.toUTC().toString(Qt::ISODate)); } - // setupConfig() consults portable.txt before the XDG logic, so the - // live-singleton cases skip rather than report a baffling failure + // setupConfig() consults portable.txt before the XDG logic bool portableMarkerPresent() const { return QFileInfo::exists(qsl("%1/portable.txt").arg(QCoreApplication::applicationDirPath())) || QFileInfo::exists(qsl("%1/.config/mudlet/portable.txt").arg(QDir::homePath())); @@ -96,7 +87,7 @@ private slots: mSavedXdg.isNull() ? qunsetenv("XDG_CONFIG_HOME") : qputenv("XDG_CONFIG_HOME", mSavedXdg); } - // --- a brand new installation -------------------------------------------- + // --- a brand new installation --- void test_freshInstallRecordsTodayAndIsNew() { @@ -111,8 +102,6 @@ private slots: QVERIFY2(!mudlet::evaluateExperiencedPlayer(settings, profilesPathIn(config.path()), mNow), "a first-ever launch must be treated as a new player"); } - // A profiles directory that exists but holds nothing is still a first run - - // an aborted earlier launch must not cost the user their onboarding. void test_emptyProfilesDirectoryIsStillAFirstRun() { QTemporaryDir config; @@ -126,7 +115,7 @@ private slots: QVERIFY(!mudlet::evaluateExperiencedPlayer(settings, profilesPathIn(config.path()), mNow)); } - // --- the recorded date, once there is one -------------------------------- + // --- the recorded date, once there is one --- void test_recentlyRecordedFirstLaunchIsNew() { @@ -166,8 +155,6 @@ private slots: QVERIFY(mudlet::evaluateExperiencedPlayer(settings, profiles, mNow)); } - // A clock set forward and back, or settings carried between machines, can - // leave a first launch in the future. That is not tenure. void test_futureDatedFirstLaunchIsNotExperienced() { QTemporaryDir config; @@ -178,11 +165,8 @@ private slots: QVERIFY(!mudlet::evaluateExperiencedPlayer(settings, profilesPathIn(config.path()), mNow)); } - // --- upgrading users, who have no recorded first launch ------------------ + // --- upgrading users, who have no recorded first launch --- - // The regression: profiles written seconds ago by an installation that has - // been in use for years. The old directory-mtime heuristic classified this - // player as brand new, handing a veteran the beginner tour. void test_upgraderWithFreshlyWrittenProfilesIsExperienced() { QTemporaryDir config; @@ -201,10 +185,8 @@ private slots: QVERIFY2(mudlet::evaluateExperiencedPlayer(settings, profilesPathIn(config.path()), mNow), "an installation with profiles but no recorded first launch predates the key, so it is experienced"); } - // Timestamps are not consulted at all, which is what makes a profile copied - // to a new machine or restored from a backup come out right: whether the - // modification times survive depends entirely on the tool used, and the - // birth time is reset either way. + // A restored profile may or may not keep its modification times, and never + // keeps its birth time, so no timestamp is consulted void test_restoredFromBackupIsExperienced() { QTemporaryDir config; @@ -215,9 +197,6 @@ private slots: QVERIFY(mudlet::evaluateExperiencedPlayer(settings, profilesPathIn(config.path()), mNow)); } - // Settings restored without their profiles - a move to a new machine, or a - // user who deleted their last profile. Mudlet has clearly run here before, - // so they must not be stamped with today as their first launch. void test_settingsWithoutProfilesStillCountAsEarlierUse() { QTemporaryDir config; @@ -232,10 +211,6 @@ private slots: QVERIFY(mudlet::evaluateExperiencedPlayer(settings, profilesPathIn(config.path()), mNow)); } - // A profiles directory that cannot be listed is indistinguishable from an - // empty one, so it must be read the safe way round - otherwise a home - // directory that mounted late would brand a veteran as a newcomer, for six - // months, with no way back. void test_unreadableProfilesDirectoryIsTakenAsPopulated() { QTemporaryDir config; @@ -250,14 +225,11 @@ private slots: } const bool experienced = mudlet::evaluateExperiencedPlayer(settings, profiles, mNow); - // Restore before asserting, so a failure does not leave QTemporaryDir - // unable to clean up after itself + // Restore before asserting, or a failure leaves QTemporaryDir unable to clean up QVERIFY(QFile::setPermissions(profiles, QFileDevice::ReadOwner | QFileDevice::WriteOwner | QFileDevice::ExeOwner)); QVERIFY(experienced); } - // Upgrading must not invent a first launch date - that would start the six - // month clock now and hand the veteran a tour six months from today. void test_upgradeDoesNotRecordAFirstLaunch() { QTemporaryDir config; @@ -284,10 +256,6 @@ private slots: QCOMPARE(settings.value(mKey).toString(), original.toString(Qt::ISODate)); } - // A corrupted or mistyped value must not be trusted as a date; it falls - // through to the earlier-use check, exactly like an upgrade does. It is also - // left alone rather than re-recorded, since re-recording would restart the - // six month clock today. void test_unparseableRecordFallsBackToTheEarlierUseCheck() { QTemporaryDir config; @@ -318,22 +286,18 @@ private slots: QVERIFY2(QString::fromUtf8(ini.readAll()).contains(qsl("firstLaunchDate=2024-08-05T12:00:00Z")), "the date is stored as plain ISO 8601, so it can be read and edited by hand"); } - // --- the live singleton -------------------------------------------------- + // --- the live singleton --- - // The whole fix rests on init() recording the date at a point where no - // profile can exist yet. Nothing else in the suite would notice that call - // being moved or dropped, and if it were, every fresh install would take - // the "used before" fallback and be classified experienced - silently - // killing the onboarding for exactly the people it is for. + // Nothing else in the suite notices the init() call being moved or dropped, + // which would make every fresh install take the "used before" fallback void test_initRecordsTheFirstLaunchOnAFreshInstall() { if (portableMarkerPresent()) { QSKIP("portable.txt present - setupConfig() takes the portable branch"); } QVERIFY(mLiveConfig.isValid()); - // An empty $XDG_CONFIG_HOME/mudlet is the opt-in marker; on a machine - // with a legacy ~/.config/mudlet, setupConfig() would otherwise keep - // using that + // An empty $XDG_CONFIG_HOME/mudlet is the opt-in marker, without which + // setupConfig() keeps using a legacy ~/.config/mudlet const QString configDir = qsl("%1/mudlet").arg(mLiveConfig.path()); QVERIFY(QDir().mkpath(configDir)); qputenv("XDG_CONFIG_HOME", mLiveConfig.path().toUtf8()); @@ -351,12 +315,8 @@ private slots: QCOMPARE(QDateTime::fromString(mudlet::getQSettings()->value(mKey).toString(), Qt::ISODate).isValid(), true); } - // The direction that actually broke, through the memoised production path: - // an installation with a profile and no recorded date must come out - // experienced. Pins the key name and the profiles path that - // experiencedMudletPlayer() picks for itself, which the case above cannot - - // there, both branches would answer "new". - // + // Pins the key and profiles path experiencedMudletPlayer() picks for itself, + // which the case above cannot - there both branches would answer "new". // Runs last: experiencedMudletPlayer() memoises for the life of the process. void test_experiencedThroughTheRealSettings() { From 930ea5af5caf771c2b84c69e3d3048ee55bdc43f Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Thu, 6 Aug 2026 17:43:35 +0200 Subject: [PATCH 105/155] infrastructure: trim the comments left behind by two merged QA fixes (#9708) #### Brief overview of PR changes/additions - Comment-only. `git diff origin/development...HEAD` changes no statement, expression or declaration - every added and removed line is a comment. 238 comment lines become 98. - Applies the house standard to the comments added by "fix: a trigger that re-creates itself freezes Mudlet" (#9697) and "Fix user key bindings on Ctrl+1 to Ctrl+9 and Ctrl+Tab" (#9703): no historical passages, and the rest cut to what a reader cannot derive from the code. - Corrects four claims that were wrong, two of them inherited from those PRs: a fires-per-line measurement taken with a smaller budget than the one that shipped, an over-general note on `shortcutInstalledFor()`, a `KeyUnit::disableKey()` note that had the mechanism backwards, and a test comment crediting the `isEmpty()` guard for a result it does not produce. #### Motivation for adding to Mudlet Both PRs merged while their comment-reduction pass was still in flight, so the trim never landed with them. #### Other info (issues closed, discussion etc) The gotchas worth keeping survive in shorter form: why the same-line creation budget is counted per pass rather than sharing the `feedTriggers()` depth counter, why permanent triggers get `deactivate()` and not `setIsActive(false)`, why `mCleanupSet` rather than the deactivation is what stops `enableTrigger()` resurrecting a spent trigger, that `QShortcutMap` retries with consumed modifiers stripped, and the `Key_Backtab` versus `Shift+Tab` spelling. The matching trim for "fix: stop treating long-time Mudlet users as brand new players" (#9695) already landed separately as #9707, so it is not repeated here. No demo video: a comment-only change is not observable on screen. **Test case:** `ctest` in the build directory - 79/80, with `TelnetBenchmark` timing out only under parallel load (31s standalone against a 60s limit) on a path this PR does not touch. `TriggerSameLineMatchTest`, `UnitDeferredDeleteTest`, `ProfileSwitchShortcutTest` and `ExperiencedPlayerGateTest` all pass. Assisted-by: Claude:claude-opus-5 --- src/KeyUnit.h | 3 +- src/TCommandLine.cpp | 19 +--- src/TKey.cpp | 4 +- src/TKey.h | 3 +- src/TTrigger.cpp | 16 ++-- src/TriggerUnit.cpp | 63 +++++-------- src/TriggerUnit.h | 13 +-- src/mudlet-lua/tests/Trigger_spec.lua | 6 +- src/mudlet.cpp | 29 +++--- test/functional_tests/CMakeLists.txt | 11 +-- .../ProfileSwitchShortcutTest.cpp | 90 +++++-------------- .../TriggerSameLineMatchTest.cpp | 50 +++-------- .../UnitDeferredDeleteTest.cpp | 29 ++---- 13 files changed, 98 insertions(+), 238 deletions(-) diff --git a/src/KeyUnit.h b/src/KeyUnit.h index db73e5907..c3f46dae4 100644 --- a/src/KeyUnit.h +++ b/src/KeyUnit.h @@ -69,8 +69,7 @@ public: void uninstall(const QString&); void _uninstall(TKey* pChild, const QString& packageName); bool processDataStream(const Qt::Key, const Qt::KeyboardModifiers); - // Reports whether processDataStream() would find a binding for this key - // combination, without running any of them + // Query-only counterpart to processDataStream(), which executes what it matches bool wouldMatch(const Qt::Key, const Qt::KeyboardModifiers) const; void markCleanup(TKey* pT); void doCleanup(); diff --git a/src/TCommandLine.cpp b/src/TCommandLine.cpp index 0d8629b2f..60d2482b9 100644 --- a/src/TCommandLine.cpp +++ b/src/TCommandLine.cpp @@ -201,13 +201,10 @@ bool TCommandLine::event(QEvent* event) return true; } - // A user's own key binding beats the profile tab switching shortcuts, - // the precedence handleCtrlTabChange() below describes - but those are - // QShortcuts on the main window, and QShortcutMap consumes a matching - // key before the KeyPress is ever delivered here, so the binding has to - // be spotted now. Only the keys those shortcuts occupy are asked about, - // and asked without running anything - the binding runs when the - // KeyPress that this claim lets through arrives: + // QShortcutMap consumes a key matching one of the profile switching + // shortcuts before the KeyPress ever reaches here, so a user binding on + // one has to be spotted now - and only spotted, since the binding runs + // off the KeyPress this claim lets through: if (keybindingWouldMatchProfileSwitchShortcut(ke)) { ke->accept(); return true; @@ -1357,14 +1354,6 @@ bool TCommandLine::handleCtrlTabChange(QKeyEvent* ke, int tabNumber) // hasn't created one then we fallback to tab switching - however // since some locales need the SHIFT modifier to enter numbers from the // top keyboard row (e.g. French AZERTY) we must ignore that one! - // - // Since the "Switch to profile N" QShortcuts were added this branch is - // no longer where that precedence is decided: whenever such a shortcut - // is set, the key only arrives here at all because event() claimed the - // ShortcutOverride for a matching binding, so the binding always wins - // and the tab switch below runs through the shortcut instead. The - // fallback still matters for Ctrl+0, which has no shortcut, and for - // shortcuts the user has cleared or remapped. if (keybindingMatched(ke)) { // Ah the user HAS created a matching binding: return true; diff --git a/src/TKey.cpp b/src/TKey.cpp index 6a2bff9fa..98aa83fb8 100644 --- a/src/TKey.cpp +++ b/src/TKey.cpp @@ -105,9 +105,7 @@ bool TKey::match(const Qt::Key key, const Qt::KeyboardModifiers modifier, const bool TKey::wouldMatch(const Qt::Key key, const Qt::KeyboardModifiers modifier) const { - // isActive() is also false for a half-destroyed key, so this covers the - // dereference below. Nothing runs during this walk, so unlike match() there - // is no re-entrancy to guard against: + // Also covers the dereference below - isActive() is false once mpMyChildrenList is gone if (!isActive()) { return false; } diff --git a/src/TKey.h b/src/TKey.h index 265e6ea5c..8f61f4deb 100644 --- a/src/TKey.h +++ b/src/TKey.h @@ -64,8 +64,7 @@ public: bool match(const Qt::Key, const Qt::KeyboardModifiers, const bool); - // Same walk as match() but without running anything - for asking whether a - // key press is spoken for before deciding to let it through: + // Query-only counterpart to match(), which executes what it matches bool wouldMatch(const Qt::Key, const Qt::KeyboardModifiers) const; bool registerKey(); void validateKeyBinding(); diff --git a/src/TTrigger.cpp b/src/TTrigger.cpp index 5d7dd8b1c..5be23fa53 100644 --- a/src/TTrigger.cpp +++ b/src/TTrigger.cpp @@ -1098,17 +1098,11 @@ bool TTrigger::match(char* haystackC, const QString& haystack, int line, int pos mExpiryCount--; if (mExpiryCount == 0) { - // The delete is deferred until the outermost processDataStream() - // pass ends, so an expired trigger that is still active would fire - // again from any pass that re-enters in the meantime (a later - // trigger's script calling feedTriggers(), most commonly). - // setIsActive(false) rather than deactivate(), matching - // TriggerUnit::killTrigger(): it also clears the user-active state. - // What stops an enableTrigger() before the deferred free from - // resurrecting a trigger that has spent its last fire is the - // markCleanup() below: TriggerUnit::enableTrigger() skips anything - // in mCleanupSet, as clearing the user-active state alone would - // not - enableTrigger() sets it straight back. + // The delete is deferred to the end of the outermost pass, so an + // expired trigger left active would fire again from any pass that + // re-enters meanwhile. What stops enableTrigger() resurrecting it + // in that window is the markCleanup() below, not the deactivation: + // enableTrigger() skips anything in mCleanupSet. setIsActive(false); mpHost->getTriggerUnit()->markCleanup(this); diff --git a/src/TriggerUnit.cpp b/src/TriggerUnit.cpp index 54b720fc2..0b7af2dad 100644 --- a/src/TriggerUnit.cpp +++ b/src/TriggerUnit.cpp @@ -307,26 +307,14 @@ int TriggerUnit::getNewID() return ++mMaxID; } -// Ends a run of same-line trigger creation that has spent its budget, and tells -// the user which trigger to go and fix. -// -// Stopping the pass is not enough on its own: everything the loop created is a -// live root trigger matching the same pattern, so the next line would start with -// a budget's worth of them and each would spawn a budget's worth again. Measured -// while trying that (with a smaller budget): 50 fires on the first such line, -// 2600 on the second, so the freeze would only be postponed. The pass therefore -// disowns what it created, from firstNodeAddedThisPass to the end of the list. -// -// That range is every root trigger registered while this pass ran, not only the -// loop's own offspring - the list records no lineage, so a capture trigger armed -// by an unrelated script earlier on the same line is caught too. It is a -// deliberate trade: on a line that has hit this budget the profile is producing -// triggers faster than it can process them, and one missed capture beats a -// frozen client. Temporary triggers go the way killTrigger() sends them -// (deactivated now, freed once no script is on the stack); permanent ones are -// only deactivated, and with deactivate() rather than setIsActive(false), -// because the latter clears the user-active state that XMLexport writes to the -// profile - the user would find them switched off after a restart. +// Stopping the pass is not enough: what the loop created is still live and still +// matching, so the next line would start with a budget's worth of them and each +// would spawn a budget's worth again, costing a multiple of the line before it. +// Everything registered during the pass is disowned, not just the loop's +// offspring: the list records no lineage, so an unrelated capture trigger armed +// on the same line is caught too. Permanent triggers get deactivate() and +// not setIsActive(false), which would clear the user-active state XMLexport saves +// and leave them switched off after a restart. void TriggerUnit::stopSameLineCreationLoop(const qsizetype firstNodeAddedThisPass) { QString triggerName; @@ -337,8 +325,7 @@ void TriggerUnit::stopSameLineCreationLoop(const qsizetype firstNodeAddedThisPas if (!trigger) { continue; } - // The last trigger created is the newest link in the chain, and its - // creator runs the same script in every looping shape seen so far + // keeps the last: the newest link in the chain names the culprit triggerName = trigger->getName(); if (trigger->isTemporary()) { trigger->setIsActive(false); @@ -356,10 +343,8 @@ void TriggerUnit::stopSameLineCreationLoop(const qsizetype firstNodeAddedThisPas if (!mpHost) { return; } - // A runaway whose creator outlives the line trips again on every matching - // line, and this message is long enough to bury the game text if it is - // repeated. Say it, then hold off; the qWarning() above is not throttled, so - // a log or a crash report still has every occurrence. + // A runaway whose creator outlives the line trips on every matching line and + // would bury the game text; the qWarning() above is not throttled. constexpr qint64 reportIntervalMs = 10000; if (mSameLineLoopReportTimer.isValid() && mSameLineLoopReportTimer.elapsed() < reportIntervalMs) { return; @@ -432,14 +417,11 @@ void TriggerUnit::processDataStream(const QString& data, int line) } trigger->match(subject, data, line); } - // Index-based loop: a match here can register yet more triggers, growing - // the list; they too get a shot at the current line, just as with the - // live-list iteration. That growth needs a ceiling, or a trigger that - // re-creates itself extends the list in front of the loop for ever and the - // line never finishes - 100% CPU and unbounded memory from one line of game - // text (#9458 restored the same-line match without bounding it). Nothing - // else catches it: no C++ frame recurses, so mProcessingDepth stays put and - // the feedTriggers() depth guard never sees it. + // A match here can register more triggers, which also get a shot at the + // current line - so the list grows in front of the loop, and a trigger that + // re-creates itself never lets the line finish. Nothing else catches that: no + // C++ frame recurses, so mProcessingDepth stays put and the feedTriggers() + // depth guard never sees it. const qsizetype sameLineCreationBudget = firstNodeAddedThisPass + scmMaxSameLineCreations; for (qsizetype i = firstNodeAddedThisPass; i < mRootNodesAddedWhileProcessing.size(); ++i) { if (i >= sameLineCreationBudget) { @@ -515,15 +497,10 @@ bool TriggerUnit::enableTrigger(const QString& name) // start mid-run and skip duplicates on some QMultiMap implementations const auto [begin, end] = mLookupTable.equal_range(name); for (auto it = begin; it != end; ++it) { - // A trigger waiting to be freed is only unlinked from the lookup table - // once doCleanup() gets to it, which does not happen while a pass is - // running - so it is still findable by name for the rest of the line. - // Re-activating that corpse resurrects it: a one-shot trigger fires a - // second time, killTrigger() is undone from another script, and a trigger - // whose package a script uninstalled mid-pass (uninstallList, filled by - // uninstall() at a non-zero depth) starts firing again. This skip is what - // makes the guarantee TTrigger::match() states where it expires a trigger - // true; killTrigger() below skips mCleanupSet too, for its own reason. + // A trigger queued for deletion stays in the lookup table until + // doCleanup() frees it, which cannot run mid-pass - re-activating one + // resurrects a spent one-shot, a killTrigger()ed trigger, or a trigger + // whose package was uninstalled mid-pass. if (mCleanupSet.contains(it.value()) || uninstallList.contains(it.value())) { continue; } diff --git a/src/TriggerUnit.h b/src/TriggerUnit.h index a7f355667..e8adbdeaa 100644 --- a/src/TriggerUnit.h +++ b/src/TriggerUnit.h @@ -89,13 +89,10 @@ public: // Windows, where the original crash hit before Lua's own 200-C-call guard): // a few times any legitimate nesting, comfortably below the native limit. inline static const int scmMaxProcessingDepth = 50; - // How many triggers created while one line is being processed may match that - // same line - see processDataStream(). A separate budget from the recursion - // depth above, which measures the C stack: this one measures how far a script - // can grow the list the pass is walking, and nothing recurses while it does. - // The behaviour it bounds (a room-capture script arming a catch-all trigger - // from the room title line) needs a handful; 100 leaves two orders of - // magnitude of headroom while keeping a runaway to a few milliseconds. + // How many triggers created while one line is processed may match that same + // line. Separate from the depth above, which measures the C stack: nothing + // recurses here, it is the list processDataStream() walks that grows. A + // room-capture script needs a handful, so 100 is ample. inline static const qsizetype scmMaxSameLineCreations = 100; QList<TTrigger*> uninstallList; @@ -127,8 +124,6 @@ private: // pass can match the ones created during it against the line being // processed - see processDataStream(). Cleared once the outermost pass ends. QList<TTrigger*> mRootNodesAddedWhileProcessing; - // Throttles the same-line creation loop report: a runaway whose creator - // survives the line trips again on every matching line thereafter. QElapsedTimer mSameLineLoopReportTimer; }; diff --git a/src/mudlet-lua/tests/Trigger_spec.lua b/src/mudlet-lua/tests/Trigger_spec.lua index 13a585377..9ac67c2bf 100644 --- a/src/mudlet-lua/tests/Trigger_spec.lua +++ b/src/mudlet-lua/tests/Trigger_spec.lua @@ -989,10 +989,8 @@ describe("Trigger processing", function() end) it("does not let enableTrigger revive a trigger that is waiting to be freed", function() - -- a killed temporary trigger stays in the by-name lookup table until - -- the deferred delete runs, so it is still findable by name - but - -- enabling it again would resurrect a trigger already killed, and the - -- same window reopens a one-shot trigger that has spent its last fire + -- a killed trigger stays findable by name until the deferred delete + -- runs, so enabling it again would resurrect it local name = "Spec Enable Resurrection" _G.EnableResurrectionSpec = 0 finally(function() _G.EnableResurrectionSpec = nil end) diff --git a/src/mudlet.cpp b/src/mudlet.cpp index 4cb199cf5..e4cbca125 100644 --- a/src/mudlet.cpp +++ b/src/mudlet.cpp @@ -2119,9 +2119,8 @@ void mudlet::switchToProfileTab(int index) } // Whether this key press would activate one of the profile tab switching -// shortcuts. Has to reproduce QShortcutMap's matching rather than compare the -// key press literally, because a shortcut can be spelt differently to the key -// press that activates it: +// shortcuts. Comparing it to them literally is not enough - a shortcut can be +// spelt differently to the press that activates it: bool mudlet::profileSwitchShortcutMatches(const QKeyEvent* ke) const { if (!ke) { @@ -2131,18 +2130,13 @@ bool mudlet::profileSwitchShortcutMatches(const QKeyEvent* ke) const const auto key = static_cast<Qt::Key>(ke->key()); const Qt::KeyboardModifiers modifiers = ke->modifiers(); - // QShortcutMap retries the match with the modifiers the platform consumed - // producing the character stripped off, so a shortcut fires for presses - // spelt differently to itself. Both retries that reach these shortcuts land - // on the digits: Ctrl and a numpad digit activates Ctrl+1, and on layouts - // that need Shift for a top-row digit (French AZERTY) so does Ctrl+Shift+1 - - // which is the same reason handleCtrlTabChange() ignores Shift. + // QShortcutMap retries with the modifiers the platform consumed producing + // the character stripped off, so Ctrl and a numpad digit activates Ctrl+1, + // and so does Ctrl+Shift+1 on layouts needing Shift for a top-row digit + // (French AZERTY) - the same reason handleCtrlTabChange() ignores Shift. QList<QKeySequence> candidates; const Qt::KeyboardModifiers strippable[] = {Qt::NoModifier, Qt::KeypadModifier, Qt::ShiftModifier, Qt::ShiftModifier | Qt::KeypadModifier}; for (const auto stripped : strippable) { - // Only single key combinations are ever produced here, so a shortcut - // remapped to a multi-step sequence would never be matched - none of - // the defaults are, and the shortcut editor cannot record one: const QKeySequence candidate(QKeyCombination(modifiers & ~stripped, key)); if (!candidates.contains(candidate)) { candidates.append(candidate); @@ -2150,17 +2144,14 @@ bool mudlet::profileSwitchShortcutMatches(const QKeyEvent* ke) const } if (key == Qt::Key_Backtab) { - // The other direction: Shift+Tab produces the Backtab keysym, while the - // sequences are spelt with Key_Tab (see mudlet::mudlet(), where they are - // defined). Shift is normally still set on such an event, but Qt's own - // Backtab handling does not rely on that, so put it back rather than - // assume it is there: + // Shift+Tab produces the Backtab keysym while the sequences are spelt + // with Key_Tab. Shift is normally still set here, but Qt's own Backtab + // handling does not rely on that, so put it back rather than assume: candidates.append(QKeySequence(QKeyCombination(modifiers | Qt::ShiftModifier, Qt::Key_Tab))); } auto shadows = [&candidates](const QKeySequence& sequence) { - // A shortcut the user cleared in the preferences is an empty sequence, - // and comparing it would match any candidate that was also empty: + // A shortcut cleared in the preferences is empty, and would match any candidate that was too return !sequence.isEmpty() && candidates.contains(sequence); }; diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index 4f2cd6a08..478213ab5 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -111,13 +111,10 @@ set_tests_properties(ResetProfileTest PROPERTIES TIMEOUT 300) # Undo/redo tests need a longer timeout due to large batch operations set_tests_properties(dlgTriggerEditorUndoRedoTest PROPERTIES TIMEOUT 300) -# TriggerSameLineMatchTest creates a fresh profile per test method, so it needs a -# longer timeout. Its self-re-creating-trigger cases do not fail on a regression, -# they hang and grow the heap by ~110MB/s, so the two backstops below are what -# turn that into a reported failure: an RSS ceiling that aborts in seconds rather -# than letting a runner's OOM killer pick a victim, and the timeout behind it. -# The ENVIRONMENT here replaces the one the loop above sets, so it repeats -# QT_QPA_PLATFORM. +# A regression in the self-re-creating-trigger cases does not fail, it hangs and +# grows the heap by ~110MB/s: the RSS ceiling and the timeout are what turn that +# into a reported failure. ENVIRONMENT replaces the loop's, hence QT_QPA_PLATFORM +# again. set_tests_properties(TriggerSameLineMatchTest PROPERTIES ENVIRONMENT "QT_QPA_PLATFORM=offscreen;ASAN_OPTIONS=detect_leaks=0:hard_rss_limit_mb=3000" TIMEOUT 300) diff --git a/test/functional_tests/ProfileSwitchShortcutTest.cpp b/test/functional_tests/ProfileSwitchShortcutTest.cpp index fd8489aed..68cf216e1 100644 --- a/test/functional_tests/ProfileSwitchShortcutTest.cpp +++ b/test/functional_tests/ProfileSwitchShortcutTest.cpp @@ -18,17 +18,12 @@ ***************************************************************************/ /* - * The profile tab switching shortcuts (Ctrl+1 to Ctrl+9, Ctrl+Tab) are - * QShortcuts on the main window. Qt resolves a QShortcut by first sending a - * QEvent::ShortcutOverride to the focus widget and, unless that widget accepts - * it, running the shortcut and never delivering the KeyPress. A user's own key - * binding on one of those keys therefore only survives if the command line - * claims the override. - * - * The invariant under test: the command line claims the override exactly when - * a live user key binding matches a key press that would otherwise activate a - * profile switching shortcut - including the presses QShortcutMap matches to a - * differently spelt shortcut - and never otherwise. + * The command line must claim the ShortcutOverride exactly when a live user key + * binding matches a press that would otherwise activate a profile switching + * shortcut (Ctrl+1 to Ctrl+9, Ctrl+Tab) - including presses QShortcutMap + * matches to a differently spelt shortcut - and never otherwise. Claiming it is + * the only way the binding survives, since QShortcutMap otherwise runs the + * shortcut and never delivers the KeyPress. * * Run with: ctest -R ProfileSwitchShortcutTest -V */ @@ -72,8 +67,7 @@ extern void qInitResources_mudlet_fonts_common(); extern void qInitResources_mudlet_fonts_posix(); void initializeQRCResourcesForProfileSwitchShortcutTest(); -// Qt::CTRL is the Cmd key on macOS, where the "next profile" shortcut uses the -// physical Control key (Qt::META) instead - mirrors mudlet::mudlet(): +// Qt::CTRL is Cmd on macOS, where "next profile" uses Qt::META - see mudlet::mudlet() #if defined(Q_OS_MACOS) static constexpr Qt::KeyboardModifier nextProfileModifier = Qt::MetaModifier; #else @@ -99,9 +93,8 @@ private: return mpHost->mpConsole->mpCommandLine; } - // Replays what QShortcutMap does before it runs a shortcut: it offers the - // key to the focus widget as an ignored ShortcutOverride and only runs the - // shortcut if nobody accepted it. + // QShortcutMap offers the key as an ignored ShortcutOverride and only runs + // the shortcut if nobody accepted it bool overrideClaimed(int key, Qt::KeyboardModifiers modifiers) const { QKeyEvent event(QEvent::ShortcutOverride, key, modifiers); @@ -116,9 +109,8 @@ private: QApplication::sendEvent(commandLine(), &event); } - // A claim is only worth asserting if a shortcut is actually competing for - // the key, so every test that asserts one first proves the collision is - // real - otherwise a mis-mapped sequence would look like a code failure. + // Asserted where a claim is expected, so a mis-mapped sequence cannot + // masquerade as a code failure bool shortcutInstalledFor(const QKeySequence& sequence) const { const auto shortcuts = mudlet::self()->findChildren<QShortcut*>(); @@ -130,8 +122,7 @@ private: return false; } - // Read from the shortcuts manager rather than hard coded, since it is - // Alt+E on Linux and Windows but Ctrl+E on macOS. + // Alt+E on Linux and Windows, Ctrl+E on macOS std::pair<int, Qt::KeyboardModifiers> scriptEditorShortcut() const { auto* sequence = mudlet::self()->shortcutsManager()->getSequence(qsl("Script editor")); @@ -151,8 +142,6 @@ private: return value; } - // Creates a permanent key binding whose script counts its own invocations - // into a Lua global, and returns its id. int createCountingKey(const QString& name, int keycode, int modifier, const QString& counterName, const QString& parent = QString()) { QString keyName = name; @@ -165,10 +154,9 @@ private: return id; } - // Deleting the roots outright is only safe because every key here is - // permanent and none is killed or uninstalled, so KeyUnit's deferred-delete - // set is always empty. Add a temporary key or a killKey() call to this file - // and this has to go through markCleanup()/doCleanup() instead. + // Safe only while every key here is permanent and none is killed or + // uninstalled, leaving KeyUnit's deferred-delete set empty; otherwise this + // has to go through markCleanup()/doCleanup() void removeAllKeys() { auto* keyUnit = mpHost->getKeyUnit(); @@ -198,9 +186,8 @@ private slots: QVERIFY2(mpHost, "No active host after profile creation"); QVERIFY2(commandLine(), "No command line available for the test"); - // The caret shortcut is checked before this code in TCommandLine::event() - // and CtrlTab would claim Ctrl+Tab itself, so pin it to the default - // rather than let an unrelated feature decide what these tests measure: + // Checked ahead of the claim in TCommandLine::event(), so CtrlTab here + // would take Ctrl+Tab out of these tests' hands mpHost->mCaretShortcut = Host::CaretShortcut::None; } @@ -215,8 +202,6 @@ private slots: void cleanup() { removeAllKeys(); } - // The regression itself: a user binding on Ctrl+1 must beat "Switch to - // profile 1". void test_userBindingOnCtrlNumberClaimsTheShortcut() { QVERIFY2(shortcutInstalledFor(QKeySequence(Qt::CTRL | Qt::Key_1)), "No profile switching shortcut is installed for Ctrl+1, so this test proves nothing"); @@ -226,15 +211,12 @@ private slots: QVERIFY2(overrideClaimed(Qt::Key_1, Qt::ControlModifier), "A user key binding on Ctrl+1 did not claim the key, so the profile switch shortcut swallows it"); } - // Without a binding the key has to be left alone so the tab switch happens. void test_withoutUserBindingTheShortcutKeepsTheKey() { QVERIFY2(!overrideClaimed(Qt::Key_1, Qt::ControlModifier), "Ctrl+1 was claimed even though no user key binding matches it - profile switching would stop working"); } - // A binding on a key that no profile switching shortcut uses needs no - // claim - Ctrl+0 is the control case that always worked, because only nine - // shortcuts (Ctrl+1 to Ctrl+9) are installed. + // Only nine shortcuts are installed, so Ctrl+0 has nothing to beat void test_bindingOnAnUnshadowedKeyIsNotClaimed() { QVERIFY(createCountingKey(qsl("Ctrl+0 binding"), Qt::Key_0, Qt::ControlModifier, qsl("_testCtrl0")) > 0); @@ -242,10 +224,6 @@ private slots: QVERIFY2(!overrideClaimed(Qt::Key_0, Qt::ControlModifier), "Ctrl+0 is not a profile switching shortcut, so the command line must not claim it"); } - // A disabled binding is not a binding, so it must not steal the key from - // the tab switch. Disabled through KeyUnit::disableKey(), which is the path - // the editor and the Lua disableKey() take - it clears mActive, not the - // mUserActiveState that setIsActive() writes. void test_disabledUserBindingDoesNotClaimTheShortcut() { const QString name = qsl("Disabled Ctrl+2 binding"); @@ -257,8 +235,6 @@ private slots: QVERIFY2(!overrideClaimed(Qt::Key_2, Qt::ControlModifier), "A disabled key binding still claimed Ctrl+2"); } - // The nine switch-to-profile shortcuts are generated in a loop, so check - // the far end of it too. void test_userBindingOnCtrlNineClaimsTheShortcut() { QVERIFY2(shortcutInstalledFor(QKeySequence(Qt::CTRL | Qt::Key_9)), "No profile switching shortcut is installed for Ctrl+9, so this test proves nothing"); @@ -268,7 +244,6 @@ private slots: QVERIFY2(overrideClaimed(Qt::Key_9, Qt::ControlModifier), "A user key binding on Ctrl+9 did not claim the key"); } - // Same for an active binding sitting inside a disabled group. void test_userBindingInDisabledGroupDoesNotClaimTheShortcut() { const int groupId = createCountingKey(qsl("Key Group"), -1, 0, qsl("_testGroup")); @@ -284,8 +259,6 @@ private slots: QVERIFY2(!overrideClaimed(Qt::Key_3, Qt::ControlModifier), "A binding inside a disabled group still claimed Ctrl+3"); } - // Ctrl+Tab ("Next profile") is shadowed the same way and needs the same - // treatment, in both directions. void test_userBindingOnCtrlTabClaimsTheShortcut() { QVERIFY2(shortcutInstalledFor(QKeySequence(nextProfileModifier | Qt::Key_Tab)), "No 'Next profile' shortcut is installed for Ctrl+Tab, so this test proves nothing"); @@ -296,10 +269,8 @@ private slots: QVERIFY2(overrideClaimed(Qt::Key_Tab, nextProfileModifier), "A user key binding on Ctrl+Tab did not claim the key"); } - // "Previous profile" is Ctrl+Shift+Tab, but Shift+Tab reaches the widget as - // Key_Backtab with the Shift modifier kept, so the sequence (spelt with - // Key_Tab) and the key press disagree on the spelling and the match has to - // bridge that. + // Shift+Tab reaches the widget as Key_Backtab while the sequence is spelt + // with Key_Tab, so the match has to bridge the two spellings void test_userBindingOnCtrlShiftTabClaimsTheShortcut() { const auto modifiers = nextProfileModifier | Qt::ShiftModifier; @@ -310,9 +281,6 @@ private slots: QVERIFY2(overrideClaimed(Qt::Key_Backtab, modifiers), "A user key binding on Ctrl+Shift+Tab did not claim the key"); } - // Only the profile switching shortcuts are overridden. Every other - // application shortcut keeps its key, so a binding on the script editor - // shortcut must not be claimed. void test_bindingOnAnotherApplicationShortcutIsNotClaimed() { auto [key, modifiers] = scriptEditorShortcut(); @@ -323,10 +291,6 @@ private slots: QVERIFY2(!overrideClaimed(key, modifiers), "A key binding claimed the script editor shortcut, which is outside the profile switching set"); } - // Guards the "empty sequence matches everything" failure mode. A key press - // that is not Backtab has no alternative spelling to compare against, so - // without the isEmpty() guard a shortcut the user has cleared in - // Preferences would compare equal to every key and claim the lot. void test_aClearedProfileShortcutDoesNotClaimEveryKey() { auto* sequence = mudlet::self()->shortcutsManager()->getSequence(qsl("Switch to profile 1")); @@ -346,10 +310,8 @@ private slots: QVERIFY2(!f5Claimed, "A cleared profile switching shortcut made an unrelated bound key claim the override"); } - // QShortcutMap retries a match with the keypad modifier stripped, so Ctrl - // and a numpad digit activates the plain Ctrl+1 shortcut even though the - // two key combinations differ. Verified against the real thing: without the - // claim, Ctrl+numpad-2 switches profile and the binding never runs. + // QShortcutMap retries with the keypad modifier stripped, so Ctrl and a + // numpad digit activates the plain Ctrl+1 shortcut void test_userBindingOnAKeypadDigitClaimsTheShortcut() { const auto modifiers = Qt::ControlModifier | Qt::KeypadModifier; @@ -358,9 +320,8 @@ private slots: QVERIFY2(overrideClaimed(Qt::Key_1, modifiers), "A user key binding on Ctrl and a keypad digit did not claim the key"); } - // Layouts that need Shift for a top-row digit (French AZERTY) record the - // binding with Shift and still activate the plain Ctrl+1 shortcut, because - // QShortcutMap drops the Shift that was consumed producing the digit. + // Layouts needing Shift for a top-row digit (French AZERTY) record the + // binding with Shift, and QShortcutMap drops the Shift it consumed void test_userBindingOnAShiftedDigitClaimsTheShortcut() { const auto modifiers = Qt::ControlModifier | Qt::ShiftModifier; @@ -369,9 +330,6 @@ private slots: QVERIFY2(overrideClaimed(Qt::Key_1, modifiers), "A user key binding on Ctrl+Shift and a digit did not claim the key"); } - // Claiming the override only defers the key - the binding must then run - // exactly once, off the KeyPress that the claim let through, and not a - // second time from the probe itself. void test_claimedBindingRunsExactlyOnce() { QVERIFY(createCountingKey(qsl("Ctrl+4 binding"), Qt::Key_4, Qt::ControlModifier, qsl("_testCtrl4")) > 0); diff --git a/test/functional_tests/TriggerSameLineMatchTest.cpp b/test/functional_tests/TriggerSameLineMatchTest.cpp index c741b346f..cdc81d135 100644 --- a/test/functional_tests/TriggerSameLineMatchTest.cpp +++ b/test/functional_tests/TriggerSameLineMatchTest.cpp @@ -204,14 +204,8 @@ private slots: QVERIFY2(bufferContains(qsl("NESTED=inner,outer#")), "Expected the mid-pass trigger to match the nested line first, then the outer line it was created on"); } - // The counterweight to all of the above: giving mid-pass triggers the current - // line means a trigger that re-creates itself keeps extending the list the - // pass is walking, so the line never finishes - 100% CPU and unbounded memory - // on the first matching line, from ordinary game text. The naive "one-shot - // that re-arms itself at the end of its own handler" shape is the one users - // write, so it is the one pinned here. Without the generation budget in - // TriggerUnit::processDataStream() this test does not fail, it hangs, and only - // the ctest TIMEOUT ends it. + // The naive "one-shot that re-arms itself at the end of its own handler" is + // the shape users write. Without the budget this does not fail, it hangs. void test_selfRecreatingTriggerIsStopped() { startProfile(mpHostname, mpLocalhost, mpPort); @@ -229,16 +223,12 @@ private slots: QCOMPARE(host->getTriggerUnit()->processingDepth(), 0); QVERIFY2(bufferContains(qsl("Trigger processing stopped to prevent a freeze")), "Expected the same-line re-creation abort error in the console buffer"); - // One fire from the trigger that was already there when the line arrived, - // then one per trigger the budget lets the re-arming chain add to it. The - // trailing # anchors the count: without it the check also passes on ten - // times the number. + // one fire from the trigger already there, then one per budgeted creation; + // the trailing # keeps the check from also passing on ten times the number const int expectedFires = 1 + static_cast<int>(TriggerUnit::scmMaxSameLineCreations); QVERIFY2(bufferContains(qsl("LOOPFIRES=%1#").arg(expectedFires)), qPrintable(qsl("Expected the re-arming trigger to fire exactly %1 times").arg(expectedFires))); } - // The abort has to name the trigger to be actionable - the user has to know - // which of their scripts to change. void test_selfRecreatingTriggerAbortNamesTheTrigger() { startProfile(mpHostname, mpLocalhost, mpPort); @@ -256,8 +246,6 @@ private slots: QVERIFY2(bufferContains(qsl("trigger 'hpWatcher'")), "Expected the abort message to name the trigger that keeps re-creating itself"); } - // A chain that ends on its own must not be cut short: only the runaway case - // may hit the budget, and legitimate chains are a handful of generations deep. void test_finiteCreationChainIsUnaffected() { startProfile(mpHostname, mpLocalhost, mpPort); @@ -281,13 +269,8 @@ private slots: QVERIFY2(!bufferContains(qsl("Trigger processing stopped to prevent a freeze")), "A chain that ends on its own must not trip the same-line generation budget"); } - // Stopping the line is only half of it. A re-arming trigger with no expiry - // leaves everything it created still active, so the next line would start - // with a budget's worth of them and each would spawn a budget's worth again: - // measured at 50 fires on the first line and 2600 on the second (with an - // earlier, smaller budget), i.e. the freeze merely postponed. The abort - // therefore stops what was created during the line, which holds the cost at - // one budget per line for ever. + // Without disowning what the loop created, each line costs a multiple of the + // one before it, so the freeze is postponed rather than prevented. void test_selfRecreatingTriggerDoesNotAccumulateAcrossLines() { startProfile(mpHostname, mpLocalhost, mpPort); @@ -310,13 +293,9 @@ private slots: qPrintable(qsl("Expected the second line to cost the same %1 fires as the first, not a multiple of them").arg(firesPerLine))); } - // permRegexTrigger() from a trigger's script loops the same way, and those - // objects are saved with the profile. They must be stopped like the temporary - // ones, but not deleted (the user owns them, and they are visible in the - // editor) and not switched off in a way that survives a save: deactivate() - // leaves the user-active state XMLexport writes alone, so a restart brings - // them back rather than confronting the user with a tree of unticked - // triggers they never touched. + // Permanent triggers are saved with the profile, so they are stopped without + // being deleted and with deactivate(), which leaves the user-active state + // XMLexport writes alone. void test_selfRecreatingPermanentTriggerIsStoppedButNotDeleted() { startProfile(mpHostname, mpLocalhost, mpPort); @@ -342,9 +321,8 @@ private slots: QVERIFY2(bufferContains(qsl("PERMEXISTS=%1#").arg(expectedFires + 1)), "Expected the stopped permanent triggers to still exist - stopping them is not deleting them"); } - // A runaway inside a nested feedTriggers() pass must stop that pass only: the - // outer line's own mid-pass triggers were registered before the nested pass - // began, so they stay live and still match the outer line afterwards. + // The outer line's own mid-pass triggers were registered before the nested + // pass began, so its abort must not take them. void test_nestedPassAbortLeavesTheOuterLineAlone() { startProfile(mpHostname, mpLocalhost, mpPort); @@ -369,10 +347,8 @@ private slots: QVERIFY2(bufferContains(qsl("SEEN=inner,outer#")), "Expected the capture trigger created by the outer line to survive the nested pass's abort and still match the outer line"); } - // The loop is not a feedTriggers() curiosity: an ordinary line arriving from - // the game reaches processDataStream() the same way, and froze Mudlet on the - // login banner. Driving it from the socket also proves the abort leaves the - // event loop running rather than wedging the connection. + // Not a feedTriggers() curiosity - real socket text takes the same path - and + // driving it from the socket also proves the abort leaves the event loop running. void test_selfRecreatingTriggerFromServerTextIsStopped() { startProfile(mpHostname, mpLocalhost, mpPort); diff --git a/test/functional_tests/UnitDeferredDeleteTest.cpp b/test/functional_tests/UnitDeferredDeleteTest.cpp index a770c1eaf..d6e99cb1d 100644 --- a/test/functional_tests/UnitDeferredDeleteTest.cpp +++ b/test/functional_tests/UnitDeferredDeleteTest.cpp @@ -485,12 +485,8 @@ private slots: QVERIFY2(!unit->getKey(id), "the key should have been freed exactly once"); } - // The other half of the corpse-is-still-findable-by-name premise: killTrigger() - // skips an item that is only waiting to be freed, but enableTrigger() used to - // re-activate every same-named entry unconditionally. That resurrects the - // corpse, contradicting the guarantee TTrigger::match() states where it expires - // a trigger ("an enableTrigger() before the deferred free cannot resurrect a - // trigger that has already spent its last fire"). + // killTrigger() skips an item that is only waiting to be freed; enableTrigger() + // has to as well, or it resurrects the corpse. void test_triggerEnableByNameCannotReviveKilled() { auto* unit = mpHost->getTriggerUnit(); @@ -512,9 +508,8 @@ private slots: QVERIFY2(!unit->getTrigger(id), "the killed trigger should still have been freed"); } - // The same thing as a user meets it: a one-shot trigger has spent its single - // fire on this line, and a script running later on the same line enables it by - // name. It must not fire a second time when the line is fed again. + // As a user meets it: a one-shot has spent its fire and a script later on the + // same line enables it by name. void test_triggerEnableByNameCannotReviveExpiredOneShot() { mpHost->mLuaInterpreter.compileAndExecuteScript(qsl("oneShotFires = 0\n" @@ -534,14 +529,10 @@ private slots: QCOMPARE(readGlobalInt(qsl("oneShotFires")), 1); } - // The other deferred-delete container needs the same treatment: uninstall() - // at a non-zero processing depth deactivates its package's triggers, drops - // them from mCleanupSet to keep the two paths disjoint, and leaves them in - // uninstallList to be freed at depth 0. They stay in the lookup table for - // that window, so enableTrigger() would otherwise bring a trigger belonging - // to an already-uninstalled package back to life. The container is populated - // directly, as the cases below do: reaching this state from Lua needs a - // package-owned temporary item, which no current import path produces. + // uninstall() at a non-zero processing depth leaves its package's triggers in + // uninstallList rather than mCleanupSet, still in the lookup table. Populated + // directly: reaching that state from Lua needs a package-owned temporary item, + // which no current import path produces. void test_triggerEnableByNameCannotReviveAnUninstalledTrigger() { auto* unit = mpHost->getTriggerUnit(); @@ -563,9 +554,7 @@ private slots: } // The skip must not stop the walk: a corpse and a live trigger can share a - // name (tempComplexRegexTrigger() takes a user-supplied one), and #9366's - // guarantee that enable-by-name reaches every same-named trigger still holds - // for the ones that are actually alive. + // name, and enable-by-name still has to reach every live one. void test_triggerEnableByNameStillReachesALiveSameNamedTrigger() { auto* unit = mpHost->getTriggerUnit(); From 3af5ed02d56880872844d77f2d7c5e9021625ca3 Mon Sep 17 00:00:00 2001 From: mudlet-machine-account <39947211+mudlet-machine-account@users.noreply.github.com> Date: Fri, 7 Aug 2026 04:38:22 +0200 Subject: [PATCH 106/155] Infrastructure: Update text for translation in Crowdin (#9718) #### Brief overview of PR changes/additions :crown: An automated PR to make new text available for translation in Crowdin from refs/heads/development (930ea5af5caf771c2b84c69e3d3048ee55bdc43f). #### Motivation for adding to Mudlet So translators can translate the new text before the upcoming release. Co-authored-by: mudlet-machine-account <mudlet-machine-account@users.noreply.github.com> --- translations/mudlet.ts | 3612 +++++++++++++++++++++------------------- 1 file changed, 1861 insertions(+), 1751 deletions(-) diff --git a/translations/mudlet.ts b/translations/mudlet.ts index 76f6df61f..6457cbfc1 100644 --- a/translations/mudlet.ts +++ b/translations/mudlet.ts @@ -130,13 +130,13 @@ <translation type="unfinished"></translation> </message> <message> - <location filename="../src/GMCPAuthenticator.cpp" line="696"/> + <location filename="../src/GMCPAuthenticator.cpp" line="749"/> <source>[ INFO ] - Your saved sign-in has expired; reconnecting so you can sign in again.</source> <extracomment>Shown when a saved password-less sign-in is no longer accepted; Mudlet reconnects so the user can sign in again.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/GMCPAuthenticator.cpp" line="791"/> + <location filename="../src/GMCPAuthenticator.cpp" line="844"/> <source>[ INFO ] - You'll be signed in automatically next time. Manage this under Preferences, Connection.</source> <extracomment>Shown once after a browser/OAuth sign-in whose reconnect token was saved, so future connects need no sign-in.</extracomment> <translation type="unfinished"></translation> @@ -145,104 +145,104 @@ <context> <name>Host</name> <message> - <location filename="../src/Host.cpp" line="385"/> + <location filename="../src/Host.cpp" line="387"/> <source>Text to send to the game</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/Host.cpp" line="481"/> + <location filename="../src/Host.cpp" line="485"/> <source>[ ALERT ] - This profile will now save and close.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/Host.cpp" line="779"/> + <location filename="../src/Host.cpp" line="803"/> <source>Failed to open xml file "%1" inside module %2 to update it. Error message was: "%3".</source> <extracomment>This error message will appear when the xml file inside the module zip cannot be updated for some reason.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/Host.cpp" line="792"/> + <location filename="../src/Host.cpp" line="816"/> <source>Failed to save "%1" to module "%2". Error message was: "%3".</source> <extracomment>This error message will appear when a module is saved as package but cannot be done for some reason.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/Host.cpp" line="1027"/> + <location filename="../src/Host.cpp" line="1051"/> <source>the profile is no longer available</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/Host.cpp" line="1201"/> + <location filename="../src/Host.cpp" line="1238"/> <source>[ OK ] - %1 Thanks a lot for using the Public Test Build!</source> <comment>%1 will be a random happy emoji</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/Host.cpp" line="1202"/> + <location filename="../src/Host.cpp" line="1239"/> <source>[ OK ] - %1 Help us make Mudlet better by reporting any problems.</source> <comment>%1 will be a random happy emoji</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/Host.cpp" line="2028"/> + <location filename="../src/Host.cpp" line="2072"/> <source>[ ERROR ] - Package install failed for "%1": %2</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/Host.cpp" line="2100"/> + <location filename="../src/Host.cpp" line="2141"/> <source>Module "%1" is already installed. Please uninstall it first or choose a different name.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/Host.cpp" line="2146"/> + <location filename="../src/Host.cpp" line="2180"/> <source>Unpacking module: "%1" please wait...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/Host.cpp" line="2148"/> + <location filename="../src/Host.cpp" line="2180"/> <source>Unpacking package: "%1" please wait...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/Host.cpp" line="2152"/> + <location filename="../src/Host.cpp" line="2181"/> <source>Unpacking</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/Host.cpp" line="2225"/> - <location filename="../src/Host.cpp" line="2252"/> + <location filename="../src/Host.cpp" line="2256"/> + <location filename="../src/Host.cpp" line="2308"/> <source>[ WARN ] - Failed to load module "%1": %2</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/Host.cpp" line="3021"/> + <location filename="../src/Host.cpp" line="3068"/> <source>Playing %1</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/Host.cpp" line="3026"/> - <location filename="../src/Host.cpp" line="3035"/> + <location filename="../src/Host.cpp" line="3073"/> + <location filename="../src/Host.cpp" line="3082"/> <source>%1 at %2:%3</source> <extracomment>%1 is the game name and %2:%3 is game server address like: mudlet.org:23</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/Host.cpp" line="3529"/> - <location filename="../src/Host.cpp" line="4775"/> + <location filename="../src/Host.cpp" line="3596"/> + <location filename="../src/Host.cpp" line="4871"/> <source>Map - %1</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/Host.cpp" line="4787"/> + <location filename="../src/Host.cpp" line="4882"/> <source>Pre-Map loading(3) report</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/Host.cpp" line="4797"/> + <location filename="../src/Host.cpp" line="4892"/> <source>Loading map(3) at %1 report</source> <translation type="unfinished"></translation> </message> @@ -250,13 +250,13 @@ please wait...</source> <context> <name>KeyUnit</name> <message> - <location filename="../src/KeyUnit.cpp" line="409"/> + <location filename="../src/KeyUnit.cpp" line="435"/> <source>no key chosen</source> <extracomment>Displayed when no key binding has been set</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/KeyUnit.cpp" line="416"/> + <location filename="../src/KeyUnit.cpp" line="442"/> <source>%1undefined key (code: 0x%2)</source> <comment>%1 is a string describing the modifier keys (e.g. "shift" or "control") used with the key, whose 'code' number, in %2 is not one that we have a name for. This is probably one of those extra keys around the edge of the keyboard that some people have.</comment> <translation type="unfinished"></translation> @@ -1226,7 +1226,7 @@ always see whole lines and wrapping follows your window size instead:</source> </message> <message> <location filename="../src/TBuffer.cpp" line="3947"/> - <location filename="../src/TBuffer.cpp" line="7454"/> + <location filename="../src/TBuffer.cpp" line="7462"/> <source>Click to reveal</source> <translation type="unfinished"></translation> </message> @@ -1477,7 +1477,7 @@ always see whole lines and wrapping follows your window size instead:</source> </message> <message> <location filename="../src/EditorModifyPropertyCommand.cpp" line="284"/> - <source>modify button "%1"</source> + <source>modify button/menu/toolbar "%1"</source> <extracomment>Undo/redo menu text for modifying a button's properties</extracomment> <translation type="unfinished"></translation> </message> @@ -1620,7 +1620,7 @@ always see whole lines and wrapping follows your window size instead:</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TKey.cpp" line="204"/> + <location filename="../src/TKey.cpp" line="225"/> <source>No key binding set. Click "Grab New Key" to assign one.</source> <extracomment>Error shown in the editor when a key item has no key binding assigned</extracomment> <translation type="unfinished"></translation> @@ -2350,60 +2350,60 @@ factor of:</source> <name>TCommandLine</name> <message> <location filename="../src/TCommandLine.cpp" line="71"/> - <location filename="../src/TCommandLine.cpp" line="1849"/> + <location filename="../src/TCommandLine.cpp" line="1872"/> <source>Show password</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TCommandLine.cpp" line="757"/> + <location filename="../src/TCommandLine.cpp" line="780"/> <source>Add to user dictionary</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TCommandLine.cpp" line="759"/> + <location filename="../src/TCommandLine.cpp" line="782"/> <source>Remove from user dictionary</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TCommandLine.cpp" line="772"/> + <location filename="../src/TCommandLine.cpp" line="795"/> <source>▼Mudlet▼ │ dictionary suggestions │ ▲User▲</source> <extracomment>This line is shown in the list of spelling suggestions on the profile's command line context menu to clearly divide up where the suggestions for correct spellings are coming from. The precise format might be modified as long as it is clear that the entries below this line in the menu come from the spelling dictionary that the user has chosen in the profile setting which we have bundled with Mudlet; the entries about this line are the ones that the user has personally added.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TCommandLine.cpp" line="783"/> + <location filename="../src/TCommandLine.cpp" line="806"/> <source>▼System▼ │ dictionary suggestions │ ▲User▲</source> <extracomment>This line is shown in the list of spelling suggestions on the profile's command line context menu to clearly divide up where the suggestions for correct spellings are coming from. The precise format might be modified as long as it is clear that the entries below this line in the menu come from the spelling dictionary that the user has chosen in the profile setting which is provided as part of the OS; the entries about this line are the ones that the user has personally added.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TCommandLine.cpp" line="852"/> + <location filename="../src/TCommandLine.cpp" line="875"/> <source>no suggestions (system)</source> <extracomment>Used when the command spelling checker using the selected system dictionary has no words to suggest.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TCommandLine.cpp" line="881"/> + <location filename="../src/TCommandLine.cpp" line="904"/> <source>no suggestions (shared)</source> <extracomment>Used when the command spelling checker using the dictionary shared between profile has no words to suggest.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TCommandLine.cpp" line="887"/> + <location filename="../src/TCommandLine.cpp" line="910"/> <source>no suggestions (profile)</source> <extracomment>Used when the command spelling checker using the profile's own dictionary has no words to suggest.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TCommandLine.cpp" line="1463"/> + <location filename="../src/TCommandLine.cpp" line="1486"/> <source>Input line for "%1" profile.</source> <extracomment>Accessibility-friendly name to describe the main command line for a Mudlet profile when more than one profile is loaded, %1 is the profile name. Because this is likely to be used often it should be kept as short as possible.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TCommandLine.cpp" line="1470"/> - <location filename="../src/TCommandLine.cpp" line="1503"/> - <location filename="../src/TCommandLine.cpp" line="1537"/> + <location filename="../src/TCommandLine.cpp" line="1493"/> + <location filename="../src/TCommandLine.cpp" line="1526"/> + <location filename="../src/TCommandLine.cpp" line="1560"/> <source>Type in text to send to the game server for the "%1" profile, or enter an alias to run commands locally.</source> <extracomment>Accessibility-friendly description for the main command line for a Mudlet profile when more than one profile is loaded, %1 is the profile name. Because this is likely to be used often it should be kept as short as possible. ---------- @@ -2413,15 +2413,15 @@ Accessibility-friendly description for the built-in command line of a console/wi <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TCommandLine.cpp" line="1479"/> + <location filename="../src/TCommandLine.cpp" line="1502"/> <source>Input line.</source> <extracomment>Accessibility-friendly name to describe the main command line for a Mudlet profile when only one profile is loaded. Because this is likely to be used often it should be kept as short as possible.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TCommandLine.cpp" line="1485"/> - <location filename="../src/TCommandLine.cpp" line="1518"/> - <location filename="../src/TCommandLine.cpp" line="1552"/> + <location filename="../src/TCommandLine.cpp" line="1508"/> + <location filename="../src/TCommandLine.cpp" line="1541"/> + <location filename="../src/TCommandLine.cpp" line="1575"/> <source>Type in text to send to the game server, or enter an alias to run commands locally.</source> <extracomment>Accessibility-friendly description for the main command line for a Mudlet profile when only one profile is loaded. Because this is likely to be used often it should be kept as short as possible. ---------- @@ -2431,31 +2431,31 @@ Accessibility-friendly description for the built-in command line of a console/wi <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TCommandLine.cpp" line="1497"/> + <location filename="../src/TCommandLine.cpp" line="1520"/> <source>Additional input line "%1" on "%2" window of "%3"profile.</source> <extracomment>Accessibility-friendly name to describe an extra command line on top of console/window when more than one profile is loaded, %1 is the command line name, %2 is the name of the window/console that it is on and %3 is the name of the profile.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TCommandLine.cpp" line="1513"/> + <location filename="../src/TCommandLine.cpp" line="1536"/> <source>Additional input line "%1" on "%2" window.</source> <extracomment>Accessibility-friendly name to describe an extra command line on top of console/window when only one profile is loaded, %1 is the command line name and %2 is the name of the window/console that it is on.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TCommandLine.cpp" line="1531"/> + <location filename="../src/TCommandLine.cpp" line="1554"/> <source>Input line of "%1" window of "%2" profile.</source> <extracomment>Accessibility-friendly name to describe the built-in command line of a console/window other than the main one, when more than one profile is loaded, %1 is the name of the window/console and %2 is the name of the profile.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TCommandLine.cpp" line="1546"/> + <location filename="../src/TCommandLine.cpp" line="1569"/> <source>Input line of "%1" window.</source> <extracomment>Accessibility-friendly name to describe the built-in command line of a console/window other than the main one, when only one profile is loaded, %1 is the name of the window/console.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TCommandLine.cpp" line="1845"/> + <location filename="../src/TCommandLine.cpp" line="1868"/> <source>Hide password</source> <translation type="unfinished"></translation> </message> @@ -2480,81 +2480,81 @@ Accessibility-friendly description for the built-in command line of a console/wi <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2068"/> + <location filename="../src/TConsole.cpp" line="2082"/> <source>System Message: %1</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="1218"/> + <location filename="../src/TConsole.cpp" line="1222"/> <source>[ INFO ] - Split-screen scrollback activated. Press <⌘>+<ENTER> to cancel.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="1220"/> + <location filename="../src/TConsole.cpp" line="1224"/> <source>[ INFO ] - Split-screen scrollback activated. Press <CTRL>+<ENTER> to cancel.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2497"/> + <location filename="../src/TConsole.cpp" line="2511"/> <source>Debug messages from all profiles are shown here.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2500"/> + <location filename="../src/TConsole.cpp" line="2514"/> <source>Central debug console past content.</source> <extracomment>accessibility-friendly name to describe the upper half of the Mudlet central debug window when you've scrolled up</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2502"/> + <location filename="../src/TConsole.cpp" line="2516"/> <source>Central debug console live content.</source> <extracomment>accessibility-friendly name to describe the lower half of the Mudlet central debug when you've scrolled up</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2505"/> + <location filename="../src/TConsole.cpp" line="2519"/> <source>Central debug console.</source> <extracomment>accessibility-friendly name to describe the upper half of the Mudlet central debug window when it is not scrolled up</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2514"/> + <location filename="../src/TConsole.cpp" line="2528"/> <source>Editor's error window for profile "%1", past content.</source> <extracomment>accessibility-friendly name to describe the upper half of the Mudlet profile's editor error window when you've scrolled up, %1 is the name of the profile when more than one is loaded.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2516"/> + <location filename="../src/TConsole.cpp" line="2530"/> <source>Editor's error window for profile "%1", live content.</source> <extracomment>accessibility-friendly name to describe the lower half of the Mudlet profile's editor error window when you've scrolled up, %1 is the name of the profile when more than one is loaded.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2519"/> + <location filename="../src/TConsole.cpp" line="2533"/> <source>Editor's error window past content.</source> <extracomment>accessibility-friendly name to describe the upper half of the Mudlet profile's editor error window when you've scrolled up and only one profile is loaded.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2521"/> + <location filename="../src/TConsole.cpp" line="2535"/> <source>Editor's error window live content.</source> <extracomment>accessibility-friendly name to describe the lower half of the Mudlet profile's editor error window when you've scrolled up and only one profile is loaded.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2527"/> + <location filename="../src/TConsole.cpp" line="2541"/> <source>Editor's error window for profile "%1".</source> <extracomment>accessibility-friendly name to describe the upper half of the Mudlet profile's editor error window when it is not scrolled up, %1 is the name of the profile when more than one is loaded.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2530"/> + <location filename="../src/TConsole.cpp" line="2544"/> <source>Editor's error window</source> <extracomment>accessibility-friendly name to describe the upper half of the Mudlet profile's editor error window when it is not scrolled up and only one profile is loaded.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2537"/> + <location filename="../src/TConsole.cpp" line="2551"/> <source>Game content is shown here. It may contain subconsoles and a mapper window.</source> <translation type="unfinished"></translation> </message> @@ -2565,7 +2565,7 @@ Accessibility-friendly description for the built-in command line of a console/wi </message> <message> <location filename="../src/TConsole.cpp" line="403"/> - <location filename="../src/TConsole.cpp" line="1022"/> + <location filename="../src/TConsole.cpp" line="1026"/> <source>Start recording of replay</source> <extracomment>Button tooltip for the replay recording toggle button</extracomment> <translation type="unfinished"></translation> @@ -2620,155 +2620,155 @@ Accessibility-friendly description for the built-in command line of a console/wi <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="1001"/> + <location filename="../src/TConsole.cpp" line="1005"/> <source>Failed to open replay recording file for writing.</source> <extracomment>Informational message displayed when replay recording file could not be opened</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="1009"/> + <location filename="../src/TConsole.cpp" line="1013"/> <source>Replay recording has started. File: %1</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="1011"/> + <location filename="../src/TConsole.cpp" line="1015"/> <source>Stop recording of replay</source> <extracomment>Button tooltip for the replay recording toggle button</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="1016"/> + <location filename="../src/TConsole.cpp" line="1020"/> <source>Replay recording has been stopped, but couldn't be saved.</source> <extracomment>Informational message displayed when replay recording is stopped but could not be saved</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="1019"/> + <location filename="../src/TConsole.cpp" line="1023"/> <source>Replay recording has been stopped. File: %1</source> <extracomment>Informational message displayed when replay recording is stopped</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2208"/> - <location filename="../src/TConsole.cpp" line="2251"/> + <location filename="../src/TConsole.cpp" line="2222"/> + <location filename="../src/TConsole.cpp" line="2265"/> <source>No search results, sorry!</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2496"/> + <location filename="../src/TConsole.cpp" line="2510"/> <source>Debug Console.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2546"/> + <location filename="../src/TConsole.cpp" line="2560"/> <source>Profile "%1" main window past content.</source> <extracomment>accessibility-friendly name to describe the upper half of a Mudlet profile's main window when you've scrolled up, %1 is the name of the profile when more than one is loaded.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2548"/> + <location filename="../src/TConsole.cpp" line="2562"/> <source>Profile "%1" main window live content.</source> <extracomment>accessibility-friendly name to describe the lower half of a Mudlet profile's main window when you've scrolled up, %1 is the name of the profile when more than one is loaded.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2551"/> + <location filename="../src/TConsole.cpp" line="2565"/> <source>Profile main window past content.</source> <extracomment>accessibility-friendly name to describe the upper half of a Mudlet profile's main window when you've scrolled up and only one profile is loaded.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2553"/> + <location filename="../src/TConsole.cpp" line="2567"/> <source>Profile main window live content.</source> <extracomment>accessibility-friendly name to describe the lower half of a Mudlet profile's main window when you've scrolled up and only one profile is loaded.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2558"/> + <location filename="../src/TConsole.cpp" line="2572"/> <source>Profile "%1" main window.</source> <extracomment>accessibility-friendly name to describe the upper half of a Mudlet profile's main window when it is not scrolled up, %1 is the name of the profile when more than one is loaded.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2561"/> + <location filename="../src/TConsole.cpp" line="2575"/> <source>Profile main window.</source> <extracomment>accessibility-friendly name to describe the upper half of a Mudlet profile's main window when it is not scrolled up and only one profile is loaded.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2576"/> + <location filename="../src/TConsole.cpp" line="2590"/> <source>Profile "%1" embedded window "%2" past content.</source> <extracomment>accessibility-friendly name to describe the upper half of a Mudlet profile's sub-console window when you've scrolled up, %1 is the name of the profile when more than one is loaded and %2 is the name of the window.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2578"/> + <location filename="../src/TConsole.cpp" line="2592"/> <source>Profile "%1" embedded window "%2" live content.</source> <extracomment>accessibility-friendly name to describe the lower half of a Mudlet profile's sub-console window when you've scrolled up, %1 is the name of the profile when more than one is loaded and %2 is the name of the window.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2581"/> + <location filename="../src/TConsole.cpp" line="2595"/> <source>Profile embedded window "%1" past content.</source> <extracomment>accessibility-friendly name to describe the upper half of a Mudlet profile's sub-console window when you've scrolled up, %1 is the name of the window.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2583"/> + <location filename="../src/TConsole.cpp" line="2597"/> <source>Profile embedded window "%1" live content.</source> <extracomment>accessibility-friendly name to describe the lower half of a Mudlet profile's sub-console window when you've scrolled up, %1 is the name of the window.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2588"/> + <location filename="../src/TConsole.cpp" line="2602"/> <source>Profile "%1" embedded window "%2".</source> <extracomment>accessibility-friendly name to describe the upper half of a Mudlet profile's sub-console window when it is not scrolled up, %1 is the name of the profile when more than one is loaded and %2 is the name of the window.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2591"/> + <location filename="../src/TConsole.cpp" line="2605"/> <source>Profile embedded window "%1".</source> <extracomment>accessibility-friendly name to describe the upper half of a Mudlet profile's sub-console window when it is not scrolled up, %1 is the name of the window.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2607"/> + <location filename="../src/TConsole.cpp" line="2621"/> <source>Profile "%1" user window "%2" past content.</source> <extracomment>accessibility-friendly name to describe the upper half of a Mudlet profile's floating/dockable user window when you've scrolled up, %1 is the name of the profile when more than one is loaded and %2 is the name of the window.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2609"/> + <location filename="../src/TConsole.cpp" line="2623"/> <source>Profile "%1" user window "%2" live content.</source> <extracomment>accessibility-friendly name to describe the lower half of a Mudlet profile's floating/dockable user window window when you've scrolled up, %1 is the name of the profile when more than one is loaded and %2 is the name of the window.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2612"/> + <location filename="../src/TConsole.cpp" line="2626"/> <source>Profile user window "%1" past content.</source> <extracomment>accessibility-friendly name to describe the upper half of a Mudlet profile's sub-console window when you've scrolled up, %1 is the name of the window.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2614"/> + <location filename="../src/TConsole.cpp" line="2628"/> <source>Profile user window "%1" live content.</source> <extracomment>accessibility-friendly name to describe the lower half of a Mudlet profile's sub-console window when you've scrolled up, %1 is the name of the window.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2619"/> + <location filename="../src/TConsole.cpp" line="2633"/> <source>Profile "%1" user window "%2".</source> <extracomment>accessibility-friendly name to describe the upper half of a Mudlet profile's floating/dockable user window window when it is not scrolled up, %1 is the name of the profile when more than one is loaded and %2 is the name of the window.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2622"/> + <location filename="../src/TConsole.cpp" line="2636"/> <source>Profile user window "%1".</source> <extracomment>accessibility-friendly name to describe the upper half of a Mudlet profile's floating/dockable user window window when it is not scrolled up, %1 is the name of the window.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2510"/> + <location filename="../src/TConsole.cpp" line="2524"/> <source>Error Console in editor.</source> <translation type="unfinished"></translation> </message> @@ -2783,52 +2783,52 @@ Accessibility-friendly description for the built-in command line of a console/wi <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2523"/> + <location filename="../src/TConsole.cpp" line="2537"/> <source>Error messages for the "%1" profile are shown here in the editor.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2533"/> + <location filename="../src/TConsole.cpp" line="2547"/> <source>Error messages are shown here in the editor.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2539"/> + <location filename="../src/TConsole.cpp" line="2553"/> <source>Main Window for "%1" profile.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2541"/> + <location filename="../src/TConsole.cpp" line="2555"/> <source>Main Window.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2568"/> + <location filename="../src/TConsole.cpp" line="2582"/> <source>Embedded window "%1" for "%2" profile.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2570"/> + <location filename="../src/TConsole.cpp" line="2584"/> <source>Embedded window "%1".</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2572"/> + <location filename="../src/TConsole.cpp" line="2586"/> <source>Game content or locally generated text may be sent here.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2598"/> + <location filename="../src/TConsole.cpp" line="2612"/> <source>User window "%1" for "%2" profile.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2600"/> + <location filename="../src/TConsole.cpp" line="2614"/> <source>User window "%1".</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TConsole.cpp" line="2603"/> + <location filename="../src/TConsole.cpp" line="2617"/> <source>Game content or locally generated text may be sent to this window that may be floated away from the Mudlet application or docked within the main application window.</source> <translation type="unfinished"></translation> </message> @@ -3653,7 +3653,7 @@ This is a checkable toggle item in the context menu shown when right-clicking th <context> <name>TEasyButtonBar</name> <message> - <location filename="../src/TEasyButtonBar.cpp" line="65"/> + <location filename="../src/TEasyButtonBar.cpp" line="63"/> <source>Easybutton Bar - %1 - %2</source> <translation type="unfinished"></translation> </message> @@ -3702,115 +3702,115 @@ This is a checkable toggle item in the context menu shown when right-clicking th <context> <name>TLuaInterpreter</name> <message> - <location filename="../src/TLuaInterpreterDiscord.cpp" line="345"/> + <location filename="../src/TLuaInterpreterDiscord.cpp" line="348"/> <source>Playing %1</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="4193"/> - <location filename="../src/TLuaInterpreter.cpp" line="4234"/> + <location filename="../src/TLuaInterpreter.cpp" line="4409"/> + <location filename="../src/TLuaInterpreter.cpp" line="4450"/> <source>ERROR</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5060"/> + <location filename="../src/TLuaInterpreter.cpp" line="5282"/> <source>No error message available from Lua</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="4197"/> - <location filename="../src/TLuaInterpreter.cpp" line="4220"/> + <location filename="../src/TLuaInterpreter.cpp" line="4413"/> + <location filename="../src/TLuaInterpreter.cpp" line="4436"/> <source>object</source> <extracomment>object is the Mudlet alias/trigger/script, used in this sample message: object:<Alias1> function:<cure_me></extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="4200"/> - <location filename="../src/TLuaInterpreter.cpp" line="4223"/> + <location filename="../src/TLuaInterpreter.cpp" line="4416"/> + <location filename="../src/TLuaInterpreter.cpp" line="4439"/> <source>function</source> <extracomment>function is the Lua function, used in this sample message: object:<Alias1> function:<cure_me></extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5062"/> + <location filename="../src/TLuaInterpreter.cpp" line="5284"/> <source>Lua error: %1</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5071"/> + <location filename="../src/TLuaInterpreter.cpp" line="5293"/> <source>[ ERROR ] - Cannot find Lua module %1.%2%3%4</source> <extracomment>%1 is the name of the module; %2 will be a line-feed inserted to put the next argument on a new line; %3 is the error message from the lua sub-system; %4 can be an additional message about the expected effect (but may be blank).</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5842"/> + <location filename="../src/TLuaInterpreter.cpp" line="6071"/> <source>Probably will not be able to access Mudlet Lua code.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5860"/> + <location filename="../src/TLuaInterpreter.cpp" line="6089"/> <source>Some regular expression functions may not be available.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5867"/> + <location filename="../src/TLuaInterpreter.cpp" line="6096"/> <source>Database support will not be available.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5874"/> + <location filename="../src/TLuaInterpreter.cpp" line="6103"/> <source>utf8.* Lua functions won't be available.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5880"/> + <location filename="../src/TLuaInterpreter.cpp" line="6109"/> <source>yajl.* Lua functions won't be available.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5885"/> + <location filename="../src/TLuaInterpreter.cpp" line="6114"/> <source>lpeg.* Lua functions won't be available.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="6071"/> + <location filename="../src/TLuaInterpreter.cpp" line="6300"/> <source>No error message available from Lua.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="6073"/> + <location filename="../src/TLuaInterpreter.cpp" line="6302"/> <source>Lua error: %1.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="6075"/> + <location filename="../src/TLuaInterpreter.cpp" line="6304"/> <source>[ ERROR ] - Cannot load code formatter, indenting functionality won't be available.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="6167"/> + <location filename="../src/TLuaInterpreter.cpp" line="6396"/> <source>%1 (doesn't exist)</source> <comment>This file doesn't exist</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="6172"/> + <location filename="../src/TLuaInterpreter.cpp" line="6401"/> <source>%1 (isn't a file or symlink to a file)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="6185"/> + <location filename="../src/TLuaInterpreter.cpp" line="6414"/> <source>%1 (isn't a readable file or symlink to a readable file)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="6207"/> + <location filename="../src/TLuaInterpreter.cpp" line="6436"/> <source>%1 (couldn't read file)</source> <comment>This file could not be read for some reason (for example, no permission)</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="6219"/> + <location filename="../src/TLuaInterpreter.cpp" line="6448"/> <source>[ ERROR ] - Couldn't find, load and successfully run LuaGlobal.lua - your Mudlet is broken! Tried these locations: %1</source> @@ -3820,151 +3820,151 @@ Tried these locations: <context> <name>TMainConsole</name> <message> - <location filename="../src/TMainConsole.cpp" line="273"/> + <location filename="../src/TMainConsole.cpp" line="339"/> <source>Mudlet MUD Client version: %1%2</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="275"/> + <location filename="../src/TMainConsole.cpp" line="341"/> <source>Mudlet, log from %1 profile</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="346"/> + <location filename="../src/TMainConsole.cpp" line="412"/> <source>Stop logging game output to log file.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="233"/> + <location filename="../src/TMainConsole.cpp" line="299"/> <source>Logging has started. Log file is %1</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="191"/> + <location filename="../src/TMainConsole.cpp" line="257"/> <source>logfile</source> <extracomment>Must be a valid default filename for a log-file and is used if the user does not enter any other value (Ensure all instances have the same translation {one of two copies}).</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="243"/> + <location filename="../src/TMainConsole.cpp" line="309"/> <source>Logging has been stopped. Log file is %1</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="321"/> - <location filename="../src/TMainConsole.cpp" line="344"/> + <location filename="../src/TMainConsole.cpp" line="387"/> + <location filename="../src/TMainConsole.cpp" line="410"/> <source>'Log session starting at 'hh:mm:ss' on 'dddd', 'd' 'MMMM' 'yyyy'.</source> <extracomment>This is the format argument to QDateTime::toString(...) and needs to follow the rules for that function {literal text must be single quoted} as well as being suitable for the translation locale</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="351"/> + <location filename="../src/TMainConsole.cpp" line="417"/> <source>'Log session ending at 'hh:mm:ss' on 'dddd', 'd' 'MMMM' 'yyyy'.</source> <extracomment>This is the format argument to QDateTime::toString(...) and needs to follow the rules for that function {literal text must be single quoted} as well as being suitable for the translation locale</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="362"/> + <location filename="../src/TMainConsole.cpp" line="428"/> <source>Start logging game output to log file.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="854"/> + <location filename="../src/TMainConsole.cpp" line="923"/> <source>Pre-Map loading(2) report</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="865"/> + <location filename="../src/TMainConsole.cpp" line="934"/> <source>Loading map(2) at %1 report</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1349"/> + <location filename="../src/TMainConsole.cpp" line="1449"/> <source>User window - %1 - %2</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1416"/> + <location filename="../src/TMainConsole.cpp" line="1542"/> <source>N:%1 S:%2</source> <extracomment>The first argument 'N' represents the 'N'etwork latency; the second 'S' the 'S'ystem (processing) time</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1423"/> + <location filename="../src/TMainConsole.cpp" line="1549"/> <source><no GA> S:%1</source> <extracomment>The argument 'S' represents the 'S'ystem (processing) time, in this situation the Game Server is not sending "GoAhead" signals so we cannot deduce the network latency...</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1526"/> + <location filename="../src/TMainConsole.cpp" line="1652"/> <source>Pre-Map loading(1) report</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1544"/> + <location filename="../src/TMainConsole.cpp" line="1670"/> <source>Loading map(1) at %1 report</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1546"/> + <location filename="../src/TMainConsole.cpp" line="1672"/> <source>Loading map(1) "%1" at %2 report</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1590"/> + <location filename="../src/TMainConsole.cpp" line="1716"/> <source>Pre-Map importing(1) report</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1613"/> + <location filename="../src/TMainConsole.cpp" line="1739"/> <source>[ ERROR ] - Map file not found, path and name used was: %1.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1619"/> + <location filename="../src/TMainConsole.cpp" line="1745"/> <source>loadMap: bad argument #1 value (filename used: "%1" was not found).</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1628"/> + <location filename="../src/TMainConsole.cpp" line="1754"/> <source>[ INFO ] - Map file located and opened, now parsing it...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1635"/> + <location filename="../src/TMainConsole.cpp" line="1761"/> <source>Importing map(1) "%1" at %2 report</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1638"/> + <location filename="../src/TMainConsole.cpp" line="1764"/> <source>[ INFO ] - Map file located but it could not opened, please check permissions on:"%1".</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1641"/> + <location filename="../src/TMainConsole.cpp" line="1767"/> <source>loadMap: bad argument #1 value (filename used: "%1" could not be opened for reading).</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1665"/> + <location filename="../src/TMainConsole.cpp" line="1791"/> <source>[ INFO ] - Map reload request received from system...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1670"/> + <location filename="../src/TMainConsole.cpp" line="1796"/> <source>[ OK ] - ... System Map reload request completed.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1672"/> + <location filename="../src/TMainConsole.cpp" line="1798"/> <source>[ WARN ] - ... System Map reload request failed.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1824"/> + <location filename="../src/TMainConsole.cpp" line="2122"/> <source>+--------------------------------------------------------------+ | system statistics | +--------------------------------------------------------------+</source> @@ -3972,110 +3972,110 @@ Tried these locations: <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1834"/> + <location filename="../src/TMainConsole.cpp" line="2132"/> <source>GMCP events:</source> <extracomment>Heading for the system's statistics information displayed in the console</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1839"/> + <location filename="../src/TMainConsole.cpp" line="2137"/> <source>ATCP events:</source> <extracomment>Heading for the system's statistics information displayed in the console</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1844"/> + <location filename="../src/TMainConsole.cpp" line="2142"/> <source>Channel102 events:</source> <extracomment>Heading for the system's statistics information displayed in the console</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1849"/> + <location filename="../src/TMainConsole.cpp" line="2147"/> <source>MXP events:</source> <extracomment>Heading for the system's statistics information displayed in the console</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1854"/> + <location filename="../src/TMainConsole.cpp" line="2152"/> <source>MSSP events:</source> <extracomment>Heading for the system's statistics information displayed in the console</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1860"/> + <location filename="../src/TMainConsole.cpp" line="2158"/> <source>MSDP events:</source> <extracomment>Heading for the system's statistics information displayed in the console</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1873"/> + <location filename="../src/TMainConsole.cpp" line="2171"/> <source>Telnet Options:</source> <extracomment>Heading for the system's statistics information displayed in the console</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1877"/> + <location filename="../src/TMainConsole.cpp" line="2175"/> <source>Trigger Report:</source> <extracomment>Heading for the system's statistics information displayed in the console</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1882"/> + <location filename="../src/TMainConsole.cpp" line="2180"/> <source>Timer Report:</source> <extracomment>Heading for the system's statistics information displayed in the console</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1888"/> + <location filename="../src/TMainConsole.cpp" line="2186"/> <source>Alias Report:</source> <extracomment>Heading for the system's statistics information displayed in the console</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1893"/> + <location filename="../src/TMainConsole.cpp" line="2191"/> <source>Keybinding Report:</source> <extracomment>Heading for the system's statistics information displayed in the console</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1898"/> + <location filename="../src/TMainConsole.cpp" line="2196"/> <source>Script Report:</source> <extracomment>Heading for the system's statistics information displayed in the console</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1903"/> + <location filename="../src/TMainConsole.cpp" line="2201"/> <source>Gif Report:</source> <extracomment>Heading for the system's statistics information displayed in the console</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1953"/> + <location filename="../src/TMainConsole.cpp" line="2251"/> <source>Save profile?</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1953"/> + <location filename="../src/TMainConsole.cpp" line="2251"/> <source>Do you want to save the profile %1?</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1967"/> + <location filename="../src/TMainConsole.cpp" line="2265"/> <source>Could not save profile</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1967"/> + <location filename="../src/TMainConsole.cpp" line="2265"/> <source>Sorry, could not save your profile as "%1" - got the following error: "%2".</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1976"/> + <location filename="../src/TMainConsole.cpp" line="2274"/> <source>Could not save map</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMainConsole.cpp" line="1977"/> + <location filename="../src/TMainConsole.cpp" line="2275"/> <source>Sorry, could not save the map. Would you like to retry or close without saving the map?</source> <translation type="unfinished"></translation> </message> @@ -4083,118 +4083,118 @@ Tried these locations: <context> <name>TMap</name> <message> - <location filename="../src/TMap.cpp" line="618"/> + <location filename="../src/TMap.cpp" line="617"/> <source>[ INFO ] - CONVERTING: old style label, areaID:%1 labelID:%2.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="621"/> + <location filename="../src/TMap.cpp" line="620"/> <source>[ INFO ] - Converting old style label id: %1.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="626"/> + <location filename="../src/TMap.cpp" line="625"/> <source>[ WARN ] - CONVERTING: cannot convert old style label in area with id: %1, label id is: %2.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="629"/> + <location filename="../src/TMap.cpp" line="628"/> <source>[ WARN ] - CONVERTING: cannot convert old style label with id: %1.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="656"/> + <location filename="../src/TMap.cpp" line="655"/> <source>[ OK ] - Auditing of map completed (%1s). Enjoy your game...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="89"/> + <location filename="../src/TMap.cpp" line="88"/> <source>Default Area</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="90"/> + <location filename="../src/TMap.cpp" line="89"/> <source>Unnamed Area</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="585"/> + <location filename="../src/TMap.cpp" line="584"/> <source>[ INFO ] - Map audit starting...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="1571"/> + <location filename="../src/TMap.cpp" line="1576"/> <source>[ INFO ] - You might wish to donate THIS map file to the Mudlet Museum! There is so much data that it DOES NOT have that you could be better off starting again...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="1636"/> + <location filename="../src/TMap.cpp" line="1641"/> <source>[ ALERT ] - Failed to load a Mudlet JSON Map file, reason: %1; the file is: "%2".</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="1642"/> + <location filename="../src/TMap.cpp" line="1647"/> <source>[ INFO ] - Ignoring this map file.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="1814"/> + <location filename="../src/TMap.cpp" line="1825"/> <source>[ INFO ] - Default (reset) area (for rooms that have not been assigned to an area) not found, adding reserved -1 id.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="1905"/> + <location filename="../src/TMap.cpp" line="1916"/> <source>[ INFO ] - Successfully read the map file (%1s), checking some consistency details...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="2419"/> + <location filename="../src/TMap.cpp" line="2430"/> <source>Map issues</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="2426"/> + <location filename="../src/TMap.cpp" line="2437"/> <source>Area issues</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="2432"/> + <location filename="../src/TMap.cpp" line="2443"/> <source>Area id: %1 "%2"</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="2434"/> + <location filename="../src/TMap.cpp" line="2445"/> <source>Area id: %1</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="2443"/> + <location filename="../src/TMap.cpp" line="2454"/> <source>Room issues</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="2450"/> + <location filename="../src/TMap.cpp" line="2461"/> <source>Room id: %1 "%2"</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="2452"/> + <location filename="../src/TMap.cpp" line="2463"/> <source>Room id: %1</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="2462"/> + <location filename="../src/TMap.cpp" line="2473"/> <source>End of report</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="2468"/> + <location filename="../src/TMap.cpp" line="2479"/> <source>[ ALERT ] - At least one thing was detected during that last map operation that it is recommended that you review the most recent report in the file: @@ -4204,7 +4204,7 @@ the file: <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="2476"/> + <location filename="../src/TMap.cpp" line="2487"/> <source>[ INFO ] - The equivalent to the above information about that last map operation has been saved for review as the most recent report in the file: @@ -4214,21 +4214,29 @@ the file: <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="2497"/> + <location filename="../src/TMap.cpp" line="2508"/> <source>[ WARN ] - Attempt made to download an XML map when one has already been requested or is being imported from a local file - wait for that operation to complete (if it cannot be canceled) before retrying!</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="2518"/> + <location filename="../src/TMap.cpp" line="2517"/> + <source>[ WARN ] - Attempt made to download an XML map while a map import or +export is already in progress - wait for that operation to complete +before retrying!</source> + <extracomment>Shown in the main console when a map download is refused</extracomment> + <translation type="unfinished"></translation> + </message> + <message> + <location filename="../src/TMap.cpp" line="2538"/> <source>[ WARN ] - Attempt made to download an XML from an invalid URL. The URL was: %1 and the error message (may contain technical details) was:"%2".</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="2532"/> + <location filename="../src/TMap.cpp" line="2552"/> <source>[ ERROR ] - Unable to use or create directory to store map. Please check that you have permissions/access to: "%1" @@ -4236,257 +4244,272 @@ and there is enough space. The download operation has failed.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="2558"/> + <location filename="../src/TMap.cpp" line="2578"/> <source>[ INFO ] - Map download initiated, please wait...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="2693"/> + <location filename="../src/TMap.cpp" line="2620"/> + <source>loadMap: unable to perform request, a map import or export is +already in progress.</source> + <extracomment>Error returned by the loadMap() Lua function</extracomment> + <translation type="unfinished"></translation> + </message> + <message> + <location filename="../src/TMap.cpp" line="2624"/> + <source>[ WARN ] - Attempt made to import an XML map while a map import or +export is already in progress - wait for that operation to complete +before retrying!</source> + <extracomment>Shown in the main console when a map import is refused</extracomment> + <translation type="unfinished"></translation> + </message> + <message> + <location filename="../src/TMap.cpp" line="2730"/> <source>[ ERROR ] - Map download encountered an error: %1</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="2743"/> + <location filename="../src/TMap.cpp" line="2780"/> <source>[ ALERT ] - Map download failed, unable to save destination file: %1 reason: %2</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="3021"/> + <location filename="../src/TMap.cpp" line="3069"/> <source>Map JSON export</source> <extracomment>This is a title of a progress window.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="3246"/> + <location filename="../src/TMap.cpp" line="3288"/> <source>Map JSON import</source> <extracomment>This is a title of a progress window.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="3005"/> - <location filename="../src/TMap.cpp" line="3474"/> + <location filename="../src/TMap.cpp" line="3070"/> + <location filename="../src/TMap.cpp" line="3519"/> <source>Exporting JSON map data from %1 Areas: %2 of: %3 Rooms: %4 of: %5 Labels: %6 of: %7...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="3150"/> + <location filename="../src/TMap.cpp" line="3203"/> <source>Exporting JSON map file from %1 - writing data to file: %2 ...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="3177"/> + <location filename="../src/TMap.cpp" line="3229"/> <source>import or export already in progress</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="3183"/> + <location filename="../src/TMap.cpp" line="3235"/> <source>could not open file</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="3192"/> + <location filename="../src/TMap.cpp" line="3244"/> <source>could not parse file, reason: "%1" at offset %2</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="3198"/> + <location filename="../src/TMap.cpp" line="3250"/> <source>empty Json file, no map data detected</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="3212"/> + <location filename="../src/TMap.cpp" line="3264"/> <source>invalid format version "%1" detected</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="3217"/> + <location filename="../src/TMap.cpp" line="3269"/> <source>no format version detected</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="3221"/> + <location filename="../src/TMap.cpp" line="3273"/> <source>no areas detected</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="3342"/> + <location filename="../src/TMap.cpp" line="3388"/> <source>aborted by user</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="3230"/> - <location filename="../src/TMap.cpp" line="3484"/> + <location filename="../src/TMap.cpp" line="3289"/> + <location filename="../src/TMap.cpp" line="3529"/> <source>Importing JSON map data to %1 Areas: %2 of: %3 Rooms: %4 of: %5 Labels: %6 of: %7...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="164"/> + <location filename="../src/TMap.cpp" line="163"/> <source>[MAP ERROR:] %1</source> <extracomment>Used to print a map error in the Errors console in the Editor, %1 is the message text and a line-feed is also appended.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="187"/> + <location filename="../src/TMap.cpp" line="186"/> <source>Can not set room with RoomID %1 to AreaID %2. Room does not exist!</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="197"/> + <location filename="../src/TMap.cpp" line="196"/> <source>Can not set room with RoomID %1 to AreaID %2. Area does not exist!</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="1121"/> + <location filename="../src/TMap.cpp" line="1120"/> <source>[ ERROR ] - The format version "%1" you are trying to save the map with is too new for this version of Mudlet. Supported are only formats up to version %2.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="1137"/> + <location filename="../src/TMap.cpp" line="1136"/> <source>[ ALERT ] - Saving map in format version "%1" that is different than "%2" which it was loaded as. This may be an issue if you want to share the resulting map with others relying on the original format.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="1147"/> + <location filename="../src/TMap.cpp" line="1146"/> <source>[ WARN ] - Saving map in format version "%1" different from the recommended map version %2 for this version of Mudlet.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="1511"/> - <location filename="../src/TMap.cpp" line="1948"/> + <location filename="../src/TMap.cpp" line="1516"/> + <location filename="../src/TMap.cpp" line="1959"/> <source>[ ERROR ] - Unable to open map file for reading: "%1"!</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="1533"/> + <location filename="../src/TMap.cpp" line="1538"/> <source>[ ALERT ] - File does not seem to be a Mudlet Map file. The part that indicates its format version seems to be "%1" and that doesn't make sense. The file is: "%2".</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="1548"/> + <location filename="../src/TMap.cpp" line="1553"/> <source>[ ALERT ] - Map file is too new. Its format version "%1" is higher than this version of Mudlet can handle (%2)! The file is: "%3".</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="1555"/> + <location filename="../src/TMap.cpp" line="1560"/> <source>[ INFO ] - You will need to update your Mudlet to read the map file.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="1564"/> + <location filename="../src/TMap.cpp" line="1569"/> <source>[ ALERT ] - Map file is really old. Its format version "%1" is so ancient that this version of Mudlet may not gain enough information from it but it will try! The file is: "%2".</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="1578"/> + <location filename="../src/TMap.cpp" line="1583"/> <source>[ INFO ] - Reading map. Format version: %1. File: "%2", please wait...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="1583"/> + <location filename="../src/TMap.cpp" line="1588"/> <source>[ INFO ] - Reading map. Format version: %1. File: "%2".</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="1964"/> + <location filename="../src/TMap.cpp" line="1975"/> <source>[ INFO ] - Checking map file "%1", format version "%2".</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="2565"/> + <location filename="../src/TMap.cpp" line="2585"/> <source>Downloading map file for use in %1...</source> <extracomment>%1 is the name of the current Mudlet profile</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="2831"/> - <location filename="../src/TMap.cpp" line="3014"/> - <location filename="../src/TMap.cpp" line="3239"/> + <location filename="../src/TMap.cpp" line="2873"/> + <location filename="../src/TMap.cpp" line="3079"/> + <location filename="../src/TMap.cpp" line="3298"/> <source>Abort</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="1540"/> + <location filename="../src/TMap.cpp" line="1545"/> <source>[ INFO ] - Ignoring this unlikely map file.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="2567"/> + <location filename="../src/TMap.cpp" line="2587"/> <source>Map download</source> <extracomment>This is a title of a progress window.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="2584"/> + <location filename="../src/TMap.cpp" line="2604"/> <source>loadMap: unable to perform request, a map is already being downloaded or imported at user request.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="2614"/> + <location filename="../src/TMap.cpp" line="2651"/> <source>Importing XML map file for use in %1...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="2614"/> + <location filename="../src/TMap.cpp" line="2651"/> <source>Map import</source> <extracomment>This is a title of a progress window.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="2635"/> - <location filename="../src/TMap.cpp" line="2642"/> + <location filename="../src/TMap.cpp" line="2672"/> + <location filename="../src/TMap.cpp" line="2679"/> <source>loadMap: failure to import XML map file, further information may be available in main console!</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="2677"/> + <location filename="../src/TMap.cpp" line="2714"/> <source>[ ALERT ] - Map download was canceled, on user's request.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="2730"/> + <location filename="../src/TMap.cpp" line="2767"/> <source>[ ALERT ] - Map download failed, unable to open destination file: %1.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="2737"/> + <location filename="../src/TMap.cpp" line="2774"/> <source>[ ALERT ] - Map download failed, unable to write destination file: %1.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="2756"/> + <location filename="../src/TMap.cpp" line="2793"/> <source>[ INFO ] - ... map downloaded and stored, now parsing it...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="2792"/> + <location filename="../src/TMap.cpp" line="2829"/> <source>[ ERROR ] - Map download problem, failure in parsing destination file: %1.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMap.cpp" line="2772"/> + <location filename="../src/TMap.cpp" line="2809"/> <source>[ ERROR ] - Map download problem, unable to read destination file: %1.</source> <translation type="unfinished"></translation> @@ -4525,58 +4548,65 @@ in main console!</source> <context> <name>TMedia</name> <message> - <location filename="../src/TMedia.cpp" line="330"/> + <location filename="../src/TMedia.cpp" line="349"/> <source>fades</source> <extracomment>This word is part of a sentence like "Music fades" when the music is about to stop.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMedia.cpp" line="1179"/> + <location filename="../src/TMedia.cpp" line="1359"/> <source>Too many stopped media players. Purging stopped players.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMedia.cpp" line="1187"/> + <location filename="../src/TMedia.cpp" line="1367"/> <source>Too many stopped media players. Removed oldest active player.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMedia.cpp" line="1279"/> + <location filename="../src/TMedia.cpp" line="1459"/> <source>Maximum allowed active media players reached for media type. Cannot play additional media.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMedia.cpp" line="1380"/> + <location filename="../src/TMedia.cpp" line="651"/> + <location filename="../src/TMedia.cpp" line="1644"/> <source>stops</source> <extracomment>This word is part of a sentence like "Music stops" when the music is about to stop.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMedia.cpp" line="1404"/> + <location filename="../src/TMedia.cpp" line="1221"/> + <source>Media error: %1</source> + <extracomment>%1 is the media backend's own description of what went wrong, e.g. "Failed to load media".</extracomment> + <translation type="unfinished"></translation> + </message> + <message> + <location filename="../src/TMedia.cpp" line="1692"/> <source>plays</source> <extracomment>This word is part of a sentence like "Music plays" when the music is starting to play.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMedia.cpp" line="1428"/> + <location filename="../src/TMedia.cpp" line="1716"/> <source>pauses</source> <extracomment>This word is part of a sentence like "Music pauses" when the music stops playing for a while.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMedia.cpp" line="2115"/> + <location filename="../src/TMedia.cpp" line="2413"/> <source>music</source> <extracomment>This word is part of a sentence like "Music stops" when Mudlet handles a piece of music.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMedia.cpp" line="2117"/> + <location filename="../src/TMedia.cpp" line="2415"/> <source>video</source> <extracomment>This word is part of a sentence like "Video stops" when Mudlet handles a video.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TMedia.cpp" line="2119"/> + <location filename="../src/TMedia.cpp" line="2417"/> <source>sound</source> <translation type="unfinished"></translation> </message> @@ -4585,7 +4615,7 @@ in main console!</source> <name>TRoom</name> <message> <location filename="../src/TRoom.cpp" line="87"/> - <location filename="../src/TRoom.cpp" line="1092"/> + <location filename="../src/TRoom.cpp" line="1105"/> <source>North</source> <translation type="unfinished"></translation> </message> @@ -4601,7 +4631,7 @@ in main console!</source> </message> <message> <location filename="../src/TRoom.cpp" line="93"/> - <location filename="../src/TRoom.cpp" line="1134"/> + <location filename="../src/TRoom.cpp" line="1147"/> <source>South</source> <translation type="unfinished"></translation> </message> @@ -4617,37 +4647,37 @@ in main console!</source> </message> <message> <location filename="../src/TRoom.cpp" line="99"/> - <location filename="../src/TRoom.cpp" line="1176"/> + <location filename="../src/TRoom.cpp" line="1189"/> <source>East</source> <translation type="unfinished"></translation> </message> <message> <location filename="../src/TRoom.cpp" line="101"/> - <location filename="../src/TRoom.cpp" line="1190"/> + <location filename="../src/TRoom.cpp" line="1203"/> <source>West</source> <translation type="unfinished"></translation> </message> <message> <location filename="../src/TRoom.cpp" line="103"/> - <location filename="../src/TRoom.cpp" line="1204"/> + <location filename="../src/TRoom.cpp" line="1217"/> <source>Up</source> <translation type="unfinished"></translation> </message> <message> <location filename="../src/TRoom.cpp" line="105"/> - <location filename="../src/TRoom.cpp" line="1218"/> + <location filename="../src/TRoom.cpp" line="1231"/> <source>Down</source> <translation type="unfinished"></translation> </message> <message> <location filename="../src/TRoom.cpp" line="107"/> - <location filename="../src/TRoom.cpp" line="1232"/> + <location filename="../src/TRoom.cpp" line="1245"/> <source>In</source> <translation type="unfinished"></translation> </message> <message> <location filename="../src/TRoom.cpp" line="109"/> - <location filename="../src/TRoom.cpp" line="1246"/> + <location filename="../src/TRoom.cpp" line="1259"/> <source>Out</source> <translation type="unfinished"></translation> </message> @@ -4662,99 +4692,99 @@ in main console!</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TRoom.cpp" line="1106"/> + <location filename="../src/TRoom.cpp" line="1119"/> <source>Northeast</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TRoom.cpp" line="1120"/> + <location filename="../src/TRoom.cpp" line="1133"/> <source>Northwest</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TRoom.cpp" line="1148"/> + <location filename="../src/TRoom.cpp" line="1161"/> <source>Southeast</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TRoom.cpp" line="1162"/> + <location filename="../src/TRoom.cpp" line="1175"/> <source>Southwest</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TRoom.cpp" line="1268"/> + <location filename="../src/TRoom.cpp" line="1281"/> <source>[ WARN ] - In room ID: %1 removing invalid (special) exit to %2 (with no name!)</source> <extracomment>%1 is the room ID, %2 is the destination room ID</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TRoom.cpp" line="1281"/> + <location filename="../src/TRoom.cpp" line="1294"/> <source>[ INFO ] - In room with ID: %1 correcting special exit "%2" that was to room with an exit to invalid room: %3 to now go to: %4.</source> <extracomment>%1 is the room ID, %2 is the exit name, %3 is the old destination room ID, %4 is the new destination room ID</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TRoom.cpp" line="1312"/> + <location filename="../src/TRoom.cpp" line="1325"/> <source>[ WARN ] - Room with ID: %1 has a special exit "%2" with an exit to: %3 but that room does not exist. The exit will be removed (but the destination room ID will be stored in the room user data under a key: "%4").</source> <extracomment>%1 is the room ID, %2 is the exit name, %3 is the destination room ID, %4 is the audit key</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TRoom.cpp" line="1356"/> + <location filename="../src/TRoom.cpp" line="1369"/> <source>[ INFO ] - In room with ID: %1 special exit "%2" that was to room with an invalid ID: %3 that does not exist. The exit will be removed (the bad destination room ID will be stored in the room user data under a key: "%4").</source> <extracomment>%1 is the room ID, %2 is the exit name, %3 is the invalid destination room ID, %4 is the audit key</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TRoom.cpp" line="1409"/> + <location filename="../src/TRoom.cpp" line="1422"/> <source>[ INFO ] - In room with ID: %1 found one or more surplus door items that were removed: %2.</source> <extracomment>%1 is the room ID, %2 is a list of door items</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TRoom.cpp" line="1426"/> + <location filename="../src/TRoom.cpp" line="1439"/> <source>[ INFO ] - In room with ID: %1 found one or more surplus weight items that were removed: %2.</source> <extracomment>%1 is the room ID, %2 is a list of weight items</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TRoom.cpp" line="1443"/> + <location filename="../src/TRoom.cpp" line="1456"/> <source>[ INFO ] - In room with ID: %1 found one or more surplus exit lock items that were removed: %2.</source> <extracomment>%1 is the room ID, %2 is a list of exit lock items</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TRoom.cpp" line="1523"/> + <location filename="../src/TRoom.cpp" line="1536"/> <source>[ INFO ] - In room with ID: %1 found one or more surplus custom line elements that were removed: %2.</source> <extracomment>%1 is the room ID, %2 is a list of custom line elements</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TRoom.cpp" line="1550"/> + <location filename="../src/TRoom.cpp" line="1563"/> <source>[ INFO ] - In room with ID: %1 correcting exit "%2" that was to room with an exit to invalid room: %3 to now go to: %4.</source> <extracomment>%1 is the room ID, %2 is the exit direction, %3 is the old destination room ID, %4 is the new destination room ID</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TRoom.cpp" line="1569"/> + <location filename="../src/TRoom.cpp" line="1582"/> <source>[ WARN ] - Room with ID: %1 has an exit "%2" to: %3 but that room does not exist. The exit will be removed (but the destination room ID will be stored in the room user data under a key: "%4") and the exit will be turned into a stub.</source> <extracomment>%1 is the room ID, %2 is the exit direction, %3 is the destination room ID that doesn't exist, %4 is the audit key</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TRoom.cpp" line="1617"/> + <location filename="../src/TRoom.cpp" line="1630"/> <source>[ ALERT ] - Room with ID: %1 has an exit "%2" to: %3 but also has a stub exit in the same direction! As a real exit precludes a stub, the latter will be removed.</source> <extracomment>%1 is the room ID, %2 is the exit direction, %3 is the destination room ID</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TRoom.cpp" line="1675"/> + <location filename="../src/TRoom.cpp" line="1688"/> <source>[ INFO ] - In room with ID: %1 exit "%2" that was to room with an invalid ID: %3 that does not exist. The exit will be removed (the bad destination room ID will be stored in the room user data under a key: "%4") and the exit will be turned into a stub.</source> <extracomment>%1 is the room ID, %2 is the exit direction, %3 is the invalid destination room ID, %4 is the audit key</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TRoom.cpp" line="1393"/> + <location filename="../src/TRoom.cpp" line="1406"/> <source>%1 {none}</source> <translation type="unfinished"></translation> </message> @@ -4775,33 +4805,33 @@ in main console!</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TRoom.cpp" line="1396"/> + <location filename="../src/TRoom.cpp" line="1409"/> <source>%1 (open)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TRoom.cpp" line="1399"/> + <location filename="../src/TRoom.cpp" line="1412"/> <source>%1 (closed)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TRoom.cpp" line="1402"/> + <location filename="../src/TRoom.cpp" line="1415"/> <source>%1 (locked)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TRoom.cpp" line="1405"/> + <location filename="../src/TRoom.cpp" line="1418"/> <source>%1 {invalid}</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TRoom.cpp" line="1695"/> + <location filename="../src/TRoom.cpp" line="1708"/> <source>It had a weight, this is recorded as user data with key: "%1".</source> <extracomment>%1 is the audit key for the weight</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TRoom.cpp" line="1705"/> + <location filename="../src/TRoom.cpp" line="1718"/> <source>[ WARN ] - There was a custom exit line associated with the invalid exit but it has not been possible to salvage this, it has been lost!</source> <translation type="unfinished"></translation> </message> @@ -5090,499 +5120,499 @@ area) not found, adding "%1" against the reserved -1 id.</source> <context> <name>TTextEdit</name> <message> - <location filename="../src/TTextEdit.cpp" line="2448"/> + <location filename="../src/TTextEdit.cpp" line="2445"/> <source>Copy</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2459"/> + <location filename="../src/TTextEdit.cpp" line="2456"/> <source>Copy HTML</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2463"/> + <location filename="../src/TTextEdit.cpp" line="2460"/> <source>Copy as image</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2466"/> + <location filename="../src/TTextEdit.cpp" line="2463"/> <source>Select all</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2470"/> + <location filename="../src/TTextEdit.cpp" line="2467"/> <source>Unknown</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2471"/> + <location filename="../src/TTextEdit.cpp" line="2468"/> <source>Search on %1</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2486"/> + <location filename="../src/TTextEdit.cpp" line="2483"/> <source>Analyse characters</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2495"/> + <location filename="../src/TTextEdit.cpp" line="2492"/> <source>Hover on this item to display the Unicode codepoints in the selection <i>(only the first line!)</i></source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2504"/> + <location filename="../src/TTextEdit.cpp" line="2501"/> <source>restore Main menu</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2506"/> + <location filename="../src/TTextEdit.cpp" line="2503"/> <source>Use this to restore the Main menu to get access to controls.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2508"/> + <location filename="../src/TTextEdit.cpp" line="2505"/> <source>restore Main Toolbar</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2510"/> + <location filename="../src/TTextEdit.cpp" line="2507"/> <source>Use this to restore the Main Toolbar to get access to controls.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2518"/> + <location filename="../src/TTextEdit.cpp" line="2515"/> <source>Clear console</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2521"/> + <location filename="../src/TTextEdit.cpp" line="2518"/> <source>*** starting new session ***</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2730"/> + <location filename="../src/TTextEdit.cpp" line="2727"/> <source>{tab}</source> <extracomment>Unicode U+0009 codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2732"/> + <location filename="../src/TTextEdit.cpp" line="2729"/> <source>{line-feed}</source> <extracomment>Unicode U+000A codepoint. Not likely to be seen as it gets filtered out.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2734"/> + <location filename="../src/TTextEdit.cpp" line="2731"/> <source>{carriage-return}</source> <extracomment>Unicode U+000D codepoint. Not likely to be seen as it gets filtered out.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2736"/> + <location filename="../src/TTextEdit.cpp" line="2733"/> <source>{space}</source> <extracomment>Unicode U+0020 codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2738"/> + <location filename="../src/TTextEdit.cpp" line="2735"/> <source>{non-breaking space}</source> <extracomment>Unicode U+00A0 codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2740"/> + <location filename="../src/TTextEdit.cpp" line="2737"/> <source>{soft hyphen}</source> <extracomment>Unicode U+00AD codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2742"/> + <location filename="../src/TTextEdit.cpp" line="2739"/> <source>{combining grapheme joiner}</source> <extracomment>Unicode U+034F codepoint (badly named apparently - see Wikipedia!)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2744"/> + <location filename="../src/TTextEdit.cpp" line="2741"/> <source>{ogham space mark}</source> <extracomment>Unicode U+1680 codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2746"/> + <location filename="../src/TTextEdit.cpp" line="2743"/> <source>{'n' quad}</source> <extracomment>Unicode U+2000 codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2748"/> + <location filename="../src/TTextEdit.cpp" line="2745"/> <source>{'m' quad}</source> <extracomment>Unicode U+2001 codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2750"/> + <location filename="../src/TTextEdit.cpp" line="2747"/> <source>{'n' space}</source> <extracomment>Unicode U+2002 codepoint - En ('n') wide space.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2752"/> + <location filename="../src/TTextEdit.cpp" line="2749"/> <source>{'m' space}</source> <extracomment>Unicode U+2003 codepoint - Em ('m') wide space.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2754"/> + <location filename="../src/TTextEdit.cpp" line="2751"/> <source>{3-per-em space}</source> <extracomment>Unicode U+2004 codepoint - three-per-em ('m') wide (thick) space.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2756"/> + <location filename="../src/TTextEdit.cpp" line="2753"/> <source>{4-per-em space}</source> <extracomment>Unicode U+2005 codepoint - four-per-em ('m') wide (Middle) space.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2758"/> + <location filename="../src/TTextEdit.cpp" line="2755"/> <source>{6-per-em space}</source> <extracomment>Unicode U+2006 codepoint - six-per-em ('m') wide (Sometimes the same as a Thin) space.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2760"/> + <location filename="../src/TTextEdit.cpp" line="2757"/> <source>{digit space}</source> <extracomment>Unicode U+2007 codepoint - figure (digit) wide space.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2762"/> + <location filename="../src/TTextEdit.cpp" line="2759"/> <source>{punctuation wide space}</source> <extracomment>Unicode U+2008 codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2764"/> + <location filename="../src/TTextEdit.cpp" line="2761"/> <source>{5-per-em space}</source> <extracomment>Unicode U+2009 codepoint - five-per-em ('m') wide space.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2766"/> + <location filename="../src/TTextEdit.cpp" line="2763"/> <source>{hair width space}</source> <extracomment>Unicode U+200A codepoint - thinnest space.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2768"/> + <location filename="../src/TTextEdit.cpp" line="2765"/> <source>{zero width space}</source> <extracomment>Unicode U+200B codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2770"/> + <location filename="../src/TTextEdit.cpp" line="2767"/> <source>{Zero width non-joiner}</source> <extracomment>Unicode U+200C codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2772"/> + <location filename="../src/TTextEdit.cpp" line="2769"/> <source>{zero width joiner}</source> <extracomment>Unicode U+200D codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2774"/> + <location filename="../src/TTextEdit.cpp" line="2771"/> <source>{left-to-right mark}</source> <extracomment>Unicode U+200E codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2776"/> + <location filename="../src/TTextEdit.cpp" line="2773"/> <source>{right-to-left mark}</source> <extracomment>Unicode U+200F codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2778"/> + <location filename="../src/TTextEdit.cpp" line="2775"/> <source>{line separator}</source> <extracomment>Unicode 0x2028 codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2780"/> + <location filename="../src/TTextEdit.cpp" line="2777"/> <source>{paragraph separator}</source> <extracomment>Unicode U+2029 codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2782"/> + <location filename="../src/TTextEdit.cpp" line="2779"/> <source>{Left-to-right embedding}</source> <extracomment>Unicode U+202A codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2784"/> + <location filename="../src/TTextEdit.cpp" line="2781"/> <source>{right-to-left embedding}</source> <extracomment>Unicode U+202B codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2786"/> + <location filename="../src/TTextEdit.cpp" line="2783"/> <source>{pop directional formatting}</source> <extracomment>Unicode U+202C codepoint - pop (undo last) directional formatting.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2788"/> + <location filename="../src/TTextEdit.cpp" line="2785"/> <source>{Left-to-right override}</source> <extracomment>Unicode U+202D codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2790"/> + <location filename="../src/TTextEdit.cpp" line="2787"/> <source>{right-to-left override}</source> <extracomment>Unicode U+202E codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2792"/> + <location filename="../src/TTextEdit.cpp" line="2789"/> <source>{narrow width no-break space}</source> <extracomment>Unicode U+202F codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2794"/> + <location filename="../src/TTextEdit.cpp" line="2791"/> <source>{medium width mathematical space}</source> <extracomment>Unicode U+205F codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2796"/> + <location filename="../src/TTextEdit.cpp" line="2793"/> <source>{zero width non-breaking space}</source> <extracomment>Unicode U+2060 codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2798"/> + <location filename="../src/TTextEdit.cpp" line="2795"/> <source>{function application}</source> <extracomment>Unicode U+2061 codepoint - function application (whatever that means!)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2800"/> + <location filename="../src/TTextEdit.cpp" line="2797"/> <source>{invisible times}</source> <extracomment>Unicode U+2062 codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2802"/> + <location filename="../src/TTextEdit.cpp" line="2799"/> <source>{invisible separator}</source> <extracomment>Unicode U+2063 codepoint - invisible separator or comma.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2804"/> + <location filename="../src/TTextEdit.cpp" line="2801"/> <source>{invisible plus}</source> <extracomment>Unicode U+2064 codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2806"/> + <location filename="../src/TTextEdit.cpp" line="2803"/> <source>{left-to-right isolate}</source> <extracomment>Unicode U+2066 codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2808"/> + <location filename="../src/TTextEdit.cpp" line="2805"/> <source>{right-to-left isolate}</source> <extracomment>Unicode U+2067 codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2810"/> + <location filename="../src/TTextEdit.cpp" line="2807"/> <source>{first strong isolate}</source> <extracomment>Unicode U+2068 codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2812"/> + <location filename="../src/TTextEdit.cpp" line="2809"/> <source>{pop directional isolate}</source> <extracomment>Unicode U+2069 codepoint - pop (undo last) directional isolate.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2814"/> + <location filename="../src/TTextEdit.cpp" line="2811"/> <source>{inhibit symmetrical swapping}</source> <extracomment>Unicode U+206A codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2816"/> + <location filename="../src/TTextEdit.cpp" line="2813"/> <source>{activate symmetrical swapping}</source> <extracomment>Unicode U+206B codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2818"/> + <location filename="../src/TTextEdit.cpp" line="2815"/> <source>{inhibit arabic form-shaping}</source> <extracomment>Unicode U+206C codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2820"/> + <location filename="../src/TTextEdit.cpp" line="2817"/> <source>{activate arabic form-shaping}</source> <extracomment>Unicode U+206D codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2822"/> + <location filename="../src/TTextEdit.cpp" line="2819"/> <source>{national digit shapes}</source> <extracomment>Unicode U+206E codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2824"/> + <location filename="../src/TTextEdit.cpp" line="2821"/> <source>{nominal Digit shapes}</source> <extracomment>Unicode U+206F codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2826"/> + <location filename="../src/TTextEdit.cpp" line="2823"/> <source>{ideographic space}</source> <extracomment>Unicode U+3000 codepoint - ideographic (CJK Wide) space</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2828"/> + <location filename="../src/TTextEdit.cpp" line="2825"/> <source>{variation selector 1}</source> <extracomment>Unicode U+FE00 codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2830"/> + <location filename="../src/TTextEdit.cpp" line="2827"/> <source>{variation selector 2}</source> <extracomment>Unicode U+FE01 codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2832"/> + <location filename="../src/TTextEdit.cpp" line="2829"/> <source>{variation selector 3}</source> <extracomment>Unicode U+FE02 codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2834"/> + <location filename="../src/TTextEdit.cpp" line="2831"/> <source>{variation selector 4}</source> <extracomment>Unicode U+FE03 codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2836"/> + <location filename="../src/TTextEdit.cpp" line="2833"/> <source>{variation selector 5}</source> <extracomment>Unicode U+FE04 codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2838"/> + <location filename="../src/TTextEdit.cpp" line="2835"/> <source>{variation selector 6}</source> <extracomment>Unicode U+FE05 codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2840"/> + <location filename="../src/TTextEdit.cpp" line="2837"/> <source>{variation selector 7}</source> <extracomment>Unicode U+FE06 codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2842"/> + <location filename="../src/TTextEdit.cpp" line="2839"/> <source>{variation selector 8}</source> <extracomment>Unicode U+FE07 codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2844"/> + <location filename="../src/TTextEdit.cpp" line="2841"/> <source>{variation selector 9}</source> <extracomment>Unicode U+FE08 codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2846"/> + <location filename="../src/TTextEdit.cpp" line="2843"/> <source>{variation selector 10}</source> <extracomment>Unicode U+FE09 codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2848"/> + <location filename="../src/TTextEdit.cpp" line="2845"/> <source>{variation selector 11}</source> <extracomment>Unicode U+FE0A codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2850"/> + <location filename="../src/TTextEdit.cpp" line="2847"/> <source>{variation selector 12}</source> <extracomment>Unicode U+FE0B codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2852"/> + <location filename="../src/TTextEdit.cpp" line="2849"/> <source>{variation selector 13}</source> <extracomment>Unicode U+FE0C codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2854"/> + <location filename="../src/TTextEdit.cpp" line="2851"/> <source>{variation selector 14}</source> <extracomment>Unicode U+FE0D codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2856"/> + <location filename="../src/TTextEdit.cpp" line="2853"/> <source>{variation selector 15}</source> <extracomment>Unicode U+FE0E codepoint - after an Emoji codepoint forces the textual (black & white) rendition.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2858"/> + <location filename="../src/TTextEdit.cpp" line="2855"/> <source>{variation selector 16}</source> <extracomment>Unicode U+FE0F codepoint - after an Emoji codepoint forces the proper coloured 'Emoji' rendition.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2860"/> + <location filename="../src/TTextEdit.cpp" line="2857"/> <source>{zero width no-break space}</source> <extracomment>Unicode U+FEFF codepoint - also known as the Byte-order-mark at start of text!).</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2868"/> + <location filename="../src/TTextEdit.cpp" line="2865"/> <source>{interlinear annotation anchor}</source> <extracomment>Unicode U+FFF9 codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2870"/> + <location filename="../src/TTextEdit.cpp" line="2867"/> <source>{interlinear annotation separator}</source> <extracomment>Unicode U+FFFA codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2872"/> + <location filename="../src/TTextEdit.cpp" line="2869"/> <source>{interlinear annotation terminator}</source> <extracomment>Unicode U+FFFB codepoint</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2874"/> + <location filename="../src/TTextEdit.cpp" line="2871"/> <source>{object replacement character}</source> <extracomment>Unicode U+FFFC codepoint.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2887"/> - <location filename="../src/TTextEdit.cpp" line="2891"/> - <location filename="../src/TTextEdit.cpp" line="2913"/> + <location filename="../src/TTextEdit.cpp" line="2884"/> + <location filename="../src/TTextEdit.cpp" line="2888"/> + <location filename="../src/TTextEdit.cpp" line="2910"/> <source>{noncharacter}</source> <extracomment>Unicode codepoint in range U+FFD0 to U+FDEF - not a character ---------- @@ -5592,127 +5622,127 @@ Unicode codepoint is U+00xxFFFE or U+00xxFFFF - not a character.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2900"/> + <location filename="../src/TTextEdit.cpp" line="2897"/> <source>{FitzPatrick modifier 1 or 2}</source> <extracomment>Unicode codepoint U+0001F3FB - FitzPatrick modifier (Emoji Human skin-tone) 1-2.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2902"/> + <location filename="../src/TTextEdit.cpp" line="2899"/> <source>{FitzPatrick modifier 3}</source> <extracomment>Unicode codepoint U+0001F3FC - FitzPatrick modifier (Emoji Human skin-tone) 3.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2904"/> + <location filename="../src/TTextEdit.cpp" line="2901"/> <source>{FitzPatrick modifier 4}</source> <extracomment>Unicode codepoint U+0001F3FD - FitzPatrick modifier (Emoji Human skin-tone) 4.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2906"/> + <location filename="../src/TTextEdit.cpp" line="2903"/> <source>{FitzPatrick modifier 5}</source> <extracomment>Unicode codepoint U+0001F3FE - FitzPatrick modifier (Emoji Human skin-tone) 5.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="2908"/> + <location filename="../src/TTextEdit.cpp" line="2905"/> <source>{FitzPatrick modifier 6}</source> <extracomment>Unicode codepoint U+0001F3FF - FitzPatrick modifier (Emoji Human skin-tone) 6.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="3193"/> - <location filename="../src/TTextEdit.cpp" line="3259"/> + <location filename="../src/TTextEdit.cpp" line="3190"/> + <location filename="../src/TTextEdit.cpp" line="3256"/> <source>Index (UTF-16)</source> <extracomment>1st Row heading for Text analyser output, table item is the count into the QChars/TChars that make up the text {this translation used 2 times}</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="3198"/> - <location filename="../src/TTextEdit.cpp" line="3264"/> + <location filename="../src/TTextEdit.cpp" line="3195"/> + <location filename="../src/TTextEdit.cpp" line="3261"/> <source>U+<i>####</i> Unicode Code-point <i>(High:Low Surrogates)</i></source> <extracomment>2nd Row heading for Text analyser output, table item is the unicode code point (will be between 000001 and 10FFFF in hexadecimal) {this translation used 2 times}</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="3203"/> - <location filename="../src/TTextEdit.cpp" line="3269"/> + <location filename="../src/TTextEdit.cpp" line="3200"/> + <location filename="../src/TTextEdit.cpp" line="3266"/> <source>Visual</source> <extracomment>3rd Row heading for Text analyser output, table item is a visual representation of the character/part of the character or a '{'...'}' wrapped letter code if the character is whitespace or otherwise unshowable {this translation used 2 times}</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="3208"/> - <location filename="../src/TTextEdit.cpp" line="3274"/> + <location filename="../src/TTextEdit.cpp" line="3205"/> + <location filename="../src/TTextEdit.cpp" line="3271"/> <source>Index (UTF-8)</source> <extracomment>4th Row heading for Text analyser output, table item is the count into the bytes that make up the UTF-8 form of the text that the Lua system uses {this translation used 2 times}</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="3213"/> - <location filename="../src/TTextEdit.cpp" line="3279"/> + <location filename="../src/TTextEdit.cpp" line="3210"/> + <location filename="../src/TTextEdit.cpp" line="3276"/> <source>Byte</source> <extracomment>5th Row heading for Text analyser output, table item is the unsigned 8-bit integer for the particular byte in the UTF-8 form of the text that the Lua system uses {this translation used 2 times}</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="3219"/> - <location filename="../src/TTextEdit.cpp" line="3285"/> + <location filename="../src/TTextEdit.cpp" line="3216"/> + <location filename="../src/TTextEdit.cpp" line="3282"/> <source>Lua character or code</source> <extracomment>6th Row heading for Text analyser output, table item is either the ASCII character or the numeric code for the byte in the row about this item in the table, as displayed the thing shown can be used in a Lua string entry to reproduce this byte {this translation used 2 times}"</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="3499"/> + <location filename="../src/TTextEdit.cpp" line="3496"/> <source>link</source> <extracomment>Generic screen-reader announcement for a link with no tooltip or URL — used as fallback link description</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="3504"/> + <location filename="../src/TTextEdit.cpp" line="3501"/> <source>, visited</source> <extracomment>Appended to link announcement when the link has been previously visited</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="3508"/> + <location filename="../src/TTextEdit.cpp" line="3505"/> <source>, disabled</source> <extracomment>Appended to link announcement when the link is disabled</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="3512"/> + <location filename="../src/TTextEdit.cpp" line="3509"/> <source>, selected</source> <extracomment>Appended to link announcement when the link is selected</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="3517"/> + <location filename="../src/TTextEdit.cpp" line="3514"/> <source>, has menu</source> <extracomment>Appended to link announcement when the link opens a menu</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="3791"/> + <location filename="../src/TTextEdit.cpp" line="3788"/> <source>Wrapping to first link</source> <extracomment>Screen-reader announcement when forward link navigation (Tab / Ctrl+]) wraps past the last link back to the first</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="3794"/> + <location filename="../src/TTextEdit.cpp" line="3791"/> <source>Wrapping to last link</source> <extracomment>Screen-reader announcement when backward link navigation (Shift+Tab / Ctrl+[) wraps past the first link back to the last</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="3940"/> + <location filename="../src/TTextEdit.cpp" line="3937"/> <source>Jumped to start of buffer.</source> <extracomment>Screen-reader announcement when the user presses Ctrl+Home in caret mode to jump to the start of the buffer</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTextEdit.cpp" line="3954"/> + <location filename="../src/TTextEdit.cpp" line="3951"/> <source>Jumped to latest content.</source> <extracomment>Screen-reader announcement when the user presses Ctrl+End in caret mode to jump to the latest (most recent) content in the buffer</extracomment> <translation type="unfinished"></translation> @@ -5769,12 +5799,12 @@ Unicode codepoint is U+00xxFFFE or U+00xxFFFF - not a character.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TTrigger.cpp" line="1105"/> + <location filename="../src/TTrigger.cpp" line="1111"/> <source>Trigger name=%1 expired.</source> <translation type="unfinished"></translation> </message> <message numerus="yes"> - <location filename="../src/TTrigger.cpp" line="1110"/> + <location filename="../src/TTrigger.cpp" line="1116"/> <source>Trigger name=%1 will fire %n more time(s).</source> <translation type="unfinished"> <numerusform></numerusform> @@ -5893,6 +5923,29 @@ Unicode codepoint is U+00xxFFFE or U+00xxFFFF - not a character.</extracomment> <translation type="unfinished"></translation> </message> </context> +<context> + <name>TriggerUnit</name> + <message numerus="yes"> + <location filename="../src/TriggerUnit.cpp" line="355"/> + <source>%n trigger(s) created while processing this line have been stopped: temporary ones removed, permanent ones switched off until the profile is reloaded.</source> + <extracomment>%n is a count of triggers. Shown in the game window when a trigger keeps creating new triggers that match the same line, which would otherwise never end</extracomment> + <translation type="unfinished"> + <numerusform></numerusform> + </translation> + </message> + <message> + <location filename="../src/TriggerUnit.cpp" line="360"/> + <source>[ ERROR ] - Trigger processing stopped to prevent a freeze: a trigger (or another trigger it creates) keeps creating new triggers that match the line being processed, so that line never finishes. %1 Create the trigger once, outside its own script, or give it a pattern that does not match the line it is created on.</source> + <extracomment>%1 is the sentence above, about the triggers that were stopped</extracomment> + <translation type="unfinished"></translation> + </message> + <message> + <location filename="../src/TriggerUnit.cpp" line="366"/> + <source>[ ERROR ] - Trigger processing stopped to prevent a freeze: trigger '%1' (or another trigger it creates) keeps creating new triggers that match the line being processed, so that line never finishes. %2 Create the trigger once, outside its own script, or give it a pattern that does not match the line it is created on.</source> + <extracomment>%1 is the name of a trigger - the name of a trigger made by tempTrigger() and friends is its id number - and %2 is the sentence above, about the triggers that were stopped</extracomment> + <translation type="unfinished"></translation> + </message> +</context> <context> <name>UpdateDialog</name> <message> @@ -5970,9 +6023,9 @@ Would you like to update now?</source> <context> <name>Updater</name> <message> - <location filename="../src/updater.cpp" line="82"/> - <location filename="../src/updater.cpp" line="334"/> - <location filename="../src/updater.cpp" line="379"/> + <location filename="../src/updater.cpp" line="83"/> + <location filename="../src/updater.cpp" line="362"/> + <location filename="../src/updater.cpp" line="407"/> <source>Update</source> <extracomment>Label for the update/restart button in the main toolbar ---------- @@ -5980,54 +6033,54 @@ Label for the update button shown in the update dialog</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/updater.cpp" line="211"/> + <location filename="../src/updater.cpp" line="239"/> <source>Changelog Error</source> <extracomment>Error title for dialog shown when changelog fails to load</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/updater.cpp" line="213"/> + <location filename="../src/updater.cpp" line="241"/> <source>Could not load the changelog. Please try again later.</source> <extracomment>Error message shown when changelog fails to load from the server</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/updater.cpp" line="236"/> + <location filename="../src/updater.cpp" line="264"/> <source>No download available for version %1. Please try again later or download manually from https://www.mudlet.org/download/</source> <extracomment>Error shown when no download is available for the user's platform. %1 is the version number.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/updater.cpp" line="317"/> - <location filename="../src/updater.cpp" line="362"/> + <location filename="../src/updater.cpp" line="345"/> + <location filename="../src/updater.cpp" line="390"/> <source>Update download failed. Please try again or download manually from https://www.mudlet.org/download/</source> <extracomment>Error shown when the automatic update download finished but produced no file</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/updater.cpp" line="420"/> + <location filename="../src/updater.cpp" line="448"/> <source>Failed to extract the update. Please try again or download manually from https://www.mudlet.org/download/</source> <extracomment>Error shown when extracting the downloaded update archive fails on Linux</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/updater.cpp" line="440"/> - <location filename="../src/updater.cpp" line="446"/> - <location filename="../src/updater.cpp" line="460"/> - <location filename="../src/updater.cpp" line="473"/> + <location filename="../src/updater.cpp" line="468"/> + <location filename="../src/updater.cpp" line="474"/> + <location filename="../src/updater.cpp" line="488"/> + <location filename="../src/updater.cpp" line="501"/> <source>Failed to install the update. Please try again or download manually from https://www.mudlet.org/download/</source> <extracomment>Error shown when the automatic update fails to install on Linux</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/updater.cpp" line="454"/> + <location filename="../src/updater.cpp" line="482"/> <source>Failed to install the update and could not restore the previous version. Your previous version is saved at: %1 - please rename it back manually. Alternatively, download a fresh copy from https://www.mudlet.org/download/</source> <extracomment>Error shown when the update fails and the previous version could not be restored automatically. %1 is the file path to the backup copy.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/updater.cpp" line="510"/> - <location filename="../src/updater.cpp" line="610"/> + <location filename="../src/updater.cpp" line="538"/> + <location filename="../src/updater.cpp" line="638"/> <source>Update Error</source> <extracomment>Error title for update-related warning dialogs ---------- @@ -6035,20 +6088,20 @@ Error title for dialog shown when Mudlet fails to restart after updating</extrac <translation type="unfinished"></translation> </message> <message> - <location filename="../src/updater.cpp" line="515"/> + <location filename="../src/updater.cpp" line="543"/> <source>The update installer could not be found. Please try checking for updates again.</source> <extracomment>Error shown when the downloaded installer file cannot be found on disk</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/updater.cpp" line="527"/> + <location filename="../src/updater.cpp" line="555"/> <source>Could not prepare the update installer. Please try again or download the update manually from https://www.mudlet.org/download/</source> <extracomment>Error shown when the installer file cannot be copied to a temporary location for launch</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/updater.cpp" line="559"/> - <location filename="../src/updater.cpp" line="574"/> + <location filename="../src/updater.cpp" line="587"/> + <location filename="../src/updater.cpp" line="602"/> <source>Could not prepare the update. Please close Mudlet and run the installer manually: %1</source> <extracomment>Error shown when the batch file for managing the update process cannot be written. %1 is the path to the installer. @@ -6057,25 +6110,25 @@ Error shown when the batch file for managing the update process cannot be create <translation type="unfinished"></translation> </message> <message> - <location filename="../src/updater.cpp" line="567"/> + <location filename="../src/updater.cpp" line="595"/> <source>Could not launch the update installer. Please restart Mudlet and try again.</source> <extracomment>Error shown when the update installer process fails to start</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/updater.cpp" line="612"/> + <location filename="../src/updater.cpp" line="640"/> <source>Could not restart Mudlet after the update. Please start it manually.</source> <extracomment>Error message shown when Mudlet fails to restart after updating on Linux</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/updater.cpp" line="637"/> + <location filename="../src/updater.cpp" line="665"/> <source>Restart to apply update</source> <extracomment>Label for the button shown after the update has been downloaded and installed, prompting user to restart</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/updater.cpp" line="640"/> + <location filename="../src/updater.cpp" line="668"/> <source>Update failed</source> <extracomment>Label for the update button shown when the update installation failed</extracomment> <translation type="unfinished"></translation> @@ -6110,7 +6163,7 @@ Error shown when the batch file for managing the update process cannot be create <context> <name>XMLimport</name> <message> - <location filename="../src/XMLimport.cpp" line="151"/> + <location filename="../src/XMLimport.cpp" line="153"/> <source>[ ALERT ] - Sorry, the file being read: "%1" reports it has a version (%2) it must have come from a later Mudlet version, @@ -6118,27 +6171,27 @@ and this one cannot read it, you need a newer Mudlet!</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/XMLimport.cpp" line="354"/> + <location filename="../src/XMLimport.cpp" line="356"/> <source>Parsing area data...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/XMLimport.cpp" line="358"/> + <location filename="../src/XMLimport.cpp" line="360"/> <source>Parsing room data...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/XMLimport.cpp" line="362"/> + <location filename="../src/XMLimport.cpp" line="364"/> <source>Parsing environment data...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/XMLimport.cpp" line="370"/> + <location filename="../src/XMLimport.cpp" line="372"/> <source>Assigning rooms to their areas...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/XMLimport.cpp" line="577"/> + <location filename="../src/XMLimport.cpp" line="579"/> <source>Parsing room data [count: %1]...</source> <translation type="unfinished"></translation> </message> @@ -6179,113 +6232,123 @@ and this one cannot read it, you need a newer Mudlet!</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ui/actions_main_area.ui" line="100"/> + <location filename="../src/ui/actions_main_area.ui" line="103"/> <source>ID:</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ui/actions_main_area.ui" line="165"/> + <location filename="../src/ui/actions_main_area.ui" line="168"/> <source>Button Bar Properties</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ui/actions_main_area.ui" line="177"/> - <source>Number of columns/rows (depending on orientation):</source> - <translation type="unfinished"></translation> - </message> - <message> - <location filename="../src/ui/actions_main_area.ui" line="200"/> + <location filename="../src/ui/actions_main_area.ui" line="226"/> <source>Orientation Horizontal</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ui/actions_main_area.ui" line="205"/> + <location filename="../src/ui/actions_main_area.ui" line="231"/> <source>Orientation Vertical</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ui/actions_main_area.ui" line="220"/> + <location filename="../src/ui/actions_main_area.ui" line="246"/> <source>Dock Area Top</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ui/actions_main_area.ui" line="225"/> + <location filename="../src/ui/actions_main_area.ui" line="251"/> <source>Dock Area Left</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ui/actions_main_area.ui" line="230"/> + <location filename="../src/ui/actions_main_area.ui" line="256"/> <source>Dock Area Right</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ui/actions_main_area.ui" line="235"/> + <location filename="../src/ui/actions_main_area.ui" line="261"/> <source>Floating Toolbar</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ui/actions_main_area.ui" line="258"/> + <location filename="../src/ui/actions_main_area.ui" line="284"/> <source>Button Properties</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ui/actions_main_area.ui" line="264"/> + <location filename="../src/ui/actions_main_area.ui" line="290"/> <source>Button Rotation:</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ui/actions_main_area.ui" line="281"/> + <location filename="../src/ui/actions_main_area.ui" line="310"/> <source>no rotation</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ui/actions_main_area.ui" line="286"/> + <location filename="../src/ui/actions_main_area.ui" line="315"/> <source>90° rotation to the left</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ui/actions_main_area.ui" line="291"/> + <location filename="../src/ui/actions_main_area.ui" line="320"/> <source>90° rotation to the right</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ui/actions_main_area.ui" line="299"/> + <location filename="../src/ui/actions_main_area.ui" line="328"/> <source>Push down button</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ui/actions_main_area.ui" line="306"/> + <location filename="../src/ui/actions_main_area.ui" line="335"/> <source>Command:</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ui/actions_main_area.ui" line="319"/> - <location filename="../src/ui/actions_main_area.ui" line="339"/> + <location filename="../src/ui/actions_main_area.ui" line="351"/> + <location filename="../src/ui/actions_main_area.ui" line="374"/> <source>Text to send to the game as-is (optional)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ui/actions_main_area.ui" line="326"/> + <location filename="../src/ui/actions_main_area.ui" line="358"/> <source>Command (up):</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ui/actions_main_area.ui" line="72"/> + <location filename="../src/ui/actions_main_area.ui" line="75"/> <source><p>Choose a good, ideally unique, name for your button, menu or toolbar. This will be displayed in the buttons tree.</p></source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ui/actions_main_area.ui" line="316"/> + <location filename="../src/ui/actions_main_area.ui" line="180"/> + <source>Number of rows:</source> + <translation type="unfinished"></translation> + </message> + <message> + <location filename="../src/ui/actions_main_area.ui" line="199"/> + <source>Offset of first button:</source> + <translation type="unfinished"></translation> + </message> + <message> + <location filename="../src/ui/actions_main_area.ui" line="348"/> <source><p>Type in one or more commands you want the button to send directly to the game if it is pressed. (Optional)</p><p>If this is a <i>push-down</i> button then this is sent only when the button goes from the <i>up</i> to <i>down</i> state.</p><p>To send more complex commands, that could depend on or need to modifies variables within this profile a Lua script should be entered <i>instead</i> in the editor area below. Anything entered here is, literally, just sent to the game server.</p><p>It is permissible to use both this <i>and</i> a Lua script - this will be sent <b>before</b> the script is run.</p></source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ui/actions_main_area.ui" line="336"/> + <location filename="../src/ui/actions_main_area.ui" line="371"/> <source><p>Type in one or more commands you want the button to send directly to the game when this button goes from the <i>down</i> to <i>up</i> state.</p><p>To send more complex commands, that could depend on or need to modifies variables within this profile a Lua script should be entered <i>instead</i> in the editor area below. Anything entered here is, literally, just sent to the game server.</p><p>It is permissible to use both this <i>and</i> a Lua script - this will be sent <b>before</b> the script is run.</p></source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ui/actions_main_area.ui" line="358"/> + <location filename="../src/ui/actions_main_area.ui" line="384"/> + <source>Icon</source> + <translation type="unfinished"></translation> + </message> + <message> + <location filename="../src/ui/actions_main_area.ui" line="419"/> <source>Stylesheet:</source> <translation type="unfinished"></translation> </message> @@ -6341,26 +6404,26 @@ and this one cannot read it, you need a newer Mudlet!</source> <context> <name>cTelnet</name> <message> - <location filename="../src/ctelnet.cpp" line="779"/> + <location filename="../src/ctelnet.cpp" line="773"/> <source>hh:mm:ss.zzz</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="807"/> - <location filename="../src/ctelnet.cpp" line="863"/> + <location filename="../src/ctelnet.cpp" line="801"/> + <location filename="../src/ctelnet.cpp" line="857"/> <source>User Disconnected</source> <extracomment>A reason why a connection to a game server ended, could be one of several to be listed. This text used in two places, ensure the same text is used in both.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="812"/> - <location filename="../src/ctelnet.cpp" line="871"/> + <location filename="../src/ctelnet.cpp" line="806"/> + <location filename="../src/ctelnet.cpp" line="865"/> <source>Connection/login attempt rejected by server</source> <extracomment>A reason why a connection to a game server ended, could be one of several to be listed. This text used in two places, ensure the same text is used in both.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="1321"/> + <location filename="../src/ctelnet.cpp" line="1315"/> <source>[ ERROR ] - Internal error, no codec found for current setting of {"%1"} so Mudlet cannot send data in that format to the Game Server. Please check to see if there is an alternative that the MUD and Mudlet can @@ -6371,95 +6434,95 @@ changed.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="1553"/> + <location filename="../src/ctelnet.cpp" line="1547"/> <source>[ INFO ] - Package download cancelled.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="1556"/> + <location filename="../src/ctelnet.cpp" line="1550"/> <source>[ WARN ] - Package download failed from '%1', reason: %2</source> <extracomment>%1 is the URL, %2 is the error message</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="1560"/> + <location filename="../src/ctelnet.cpp" line="1554"/> <source> The package is hosted on a server with an SSL certificate problem. The URL may be using HTTPS when it should use HTTP, or the server's security certificate is not trusted by your system.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="1576"/> + <location filename="../src/ctelnet.cpp" line="1570"/> <source>[ WARN ] - Package download failed: could not open file '%1' for writing, reason: %2</source> <extracomment>%1 is the file path, %2 is the error message</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="1587"/> + <location filename="../src/ctelnet.cpp" line="1581"/> <source>[ WARN ] - Package download failed: could not save file, reason: %1</source> <extracomment>%1 is the error message</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="1600"/> + <location filename="../src/ctelnet.cpp" line="1594"/> <source>[ WARN ] - Package installation failed for '%1', reason: %2</source> <extracomment>%1 is the package file path, %2 is the error message</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="2523"/> + <location filename="../src/ctelnet.cpp" line="2517"/> <source>[ INFO ] - This game appears to use KaVir's protocol handler, which works best when Mudlet reports its version number during connection. Version reporting in terminal type has been automatically enabled for improved color support. Reconnecting...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="554"/> - <location filename="../src/ctelnet.cpp" line="1235"/> + <location filename="../src/ctelnet.cpp" line="548"/> + <location filename="../src/ctelnet.cpp" line="1229"/> <source>[%1]</source> <extracomment>For an IPv6 address (which is composed of hex-digits and colons) if we want to show it with a port number appended (as a colon and then an integer between 1 and 65535) we need to wrap it with '['...']' to separate the latter from the former, however some Far-East locales may expect to use the wide versions of these character here.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="557"/> + <location filename="../src/ctelnet.cpp" line="551"/> <source>Looking up the details of server: %1:%2 ...</source> <extracomment>%1 is the URL or an IP address (suitably wrapped if it is an IPv6 one) of the Game Server (or Proxy); %2 is the port number.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="704"/> + <location filename="../src/ctelnet.cpp" line="698"/> <source>[ OK ] - Secure connection made (IPv6).</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="706"/> + <location filename="../src/ctelnet.cpp" line="700"/> <source>[ OK ] - Secure connection made (IPv4).</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="710"/> + <location filename="../src/ctelnet.cpp" line="704"/> <source>[ OK ] - Open connection made (IPv6).</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="712"/> + <location filename="../src/ctelnet.cpp" line="706"/> <source>[ OK ] - Open connection made (IPv4).</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="717"/> + <location filename="../src/ctelnet.cpp" line="711"/> <source>[ OK ] - Connection made (IPv6).</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="719"/> + <location filename="../src/ctelnet.cpp" line="713"/> <source>[ OK ] - Connection made (IPv4).</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="774"/> + <location filename="../src/ctelnet.cpp" line="768"/> <source>[ INFO ] - Connection time: %1.</source> <translation type="unfinished"></translation> </message> <message numerus="yes"> - <location filename="../src/ctelnet.cpp" line="837"/> + <location filename="../src/ctelnet.cpp" line="831"/> <source>[ ALERT ] - Socket got disconnected, for %n reason(s): %1</source> <extracomment>This message is used when we have been trying to connect or we were connected securely, but the connection has been lost. It is possible with a secure connection that there is MORE than one error message to show, but for English or other locales where the singular case (%n==1) is distinct it would be perfectly feasible to replace "for %n reason(s)" with "because" for that number (1) of errors - however the text should then be repeated in the corresponding situation for an "open" connection which is different in that it only ever has one "reason" to report.</extracomment> @@ -6468,27 +6531,27 @@ The package is hosted on a server with an SSL certificate problem. The URL may b </translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="850"/> - <location filename="../src/ctelnet.cpp" line="883"/> + <location filename="../src/ctelnet.cpp" line="844"/> + <location filename="../src/ctelnet.cpp" line="877"/> <source>[ ALERT ] - Socket got disconnected.</source> <extracomment>This message is used when we have been trying to connect or we were connected securely or in an open manner, but the connection has been lost and we do not have any explaination to give to the user as to why. Anyhow, in this case we do not have anything more to say about it. This text used in two places, ensure the same translation is used in both of them.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="866"/> + <location filename="../src/ctelnet.cpp" line="860"/> <source>Secure connections not supported by this game on this port; try turning the option off</source> <extracomment>A reason why a connection to a game server ended.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="893"/> + <location filename="../src/ctelnet.cpp" line="887"/> <source>[ ALERT ] - Socket got disconnected, for reason: %1</source> <extracomment>This message is used when we have been trying to connect or we were connected in an open, insecure manner, but the connection has been lost. Unlike the secure connection case there is only one error message to show; it would be desirable to use the same text for this message as the "one reason" (%n==1) situation for locales such as English (with a distinct form for the singular) use for the secure type of connection.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="1019"/> + <location filename="../src/ctelnet.cpp" line="1013"/> <source>Host name lookup Failure! A connection cannot be established. The server name is not correct, or your nameservers are not working properly. @@ -6497,32 +6560,32 @@ working properly. <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="1024"/> + <location filename="../src/ctelnet.cpp" line="1018"/> <source>[ ERROR ] - Unable to connect to "%1". Check your internet connection and the details entered for the game server.</source> <extracomment>%1 is the URL of the Game Server</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="1036"/> + <location filename="../src/ctelnet.cpp" line="1030"/> <source>%1 (IPv6)</source> <extracomment>Used to add an IPv6 address line to the list displayed during connecting to a Host. Some, e.g. Far Eastern locales may require a different text here if they do not use spaces, or need "wide" '(' ')'s</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="1042"/> + <location filename="../src/ctelnet.cpp" line="1036"/> <source>%1 (IPv4)</source> <extracomment>Used to add an IPv4 address line to the list displayed during connecting to a Host. Some, e.g. Far Eastern locales may require a different text here if they do not use spaces, or "wide" '('...')'</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="1061"/> + <location filename="../src/ctelnet.cpp" line="1055"/> <source>A host name could not be found for the given IP address.</source> <extracomment>This text is used when the user has provided a raw IP address for the Game Server rather than a URL. In this case we try to perform a "reverse-lookup" to see if we can identify the URL that matches it - but nothing useful was found and we've got the original address back.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="1068"/> + <location filename="../src/ctelnet.cpp" line="1062"/> <source>A host name for the IP address has been found. It is: "%1" </source> @@ -6530,7 +6593,7 @@ It is: "%1" <translation type="unfinished"></translation> </message> <message numerus="yes"> - <location filename="../src/ctelnet.cpp" line="1079"/> + <location filename="../src/ctelnet.cpp" line="1073"/> <source>The %n IP address(es) of %1 has/have been found. It/They are:</source> <extracomment>This text is used in the (expected) case when the user has provided a URL (%1) for the Game Server rather than (unusually) an IP address. After a DNS lookup we have found at least one but possibly more (%n) IP addresses, which will be listed (one per line) immediately afterwards.</extracomment> <translation type="unfinished"> @@ -6538,15 +6601,15 @@ It is: "%1" </translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="1116"/> + <location filename="../src/ctelnet.cpp" line="1110"/> <source>Trying secure (IPv4 and IPv6) connections to proxy %1:%2 ...</source> <extracomment>Happy-Eyeballs (both IPv4 and IPv6 addresses available) case. %1 is the URL for the server and %2 is the port number (on BOTH addresses) for the connection.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="1121"/> - <location filename="../src/ctelnet.cpp" line="1154"/> - <location filename="../src/ctelnet.cpp" line="1181"/> + <location filename="../src/ctelnet.cpp" line="1115"/> + <location filename="../src/ctelnet.cpp" line="1148"/> + <location filename="../src/ctelnet.cpp" line="1175"/> <source>[ INFO ] - Attempting a secure connection to %1:%2 via proxy...</source> <extracomment>We don't need to worry about %1 being a raw IPv6 address here as we prohibit IP addresses for secure connections so it is a URL; %2 is the port number. ---------- @@ -6554,8 +6617,8 @@ It is: "%1" <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="1127"/> - <location filename="../src/ctelnet.cpp" line="1159"/> + <location filename="../src/ctelnet.cpp" line="1121"/> + <location filename="../src/ctelnet.cpp" line="1153"/> <source>Trying secure (IPv4 and IPv6) connections to %1:%2 ...</source> <extracomment>Happy-Eyeballs (both IPv4 and IPv6 addresses available) case. %1 is the URL for the Server and %2 is the port number (on BOTH addresses) for the connection. ---------- @@ -6563,9 +6626,9 @@ It is: "%1" <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="1132"/> - <location filename="../src/ctelnet.cpp" line="1164"/> - <location filename="../src/ctelnet.cpp" line="1189"/> + <location filename="../src/ctelnet.cpp" line="1126"/> + <location filename="../src/ctelnet.cpp" line="1158"/> + <location filename="../src/ctelnet.cpp" line="1183"/> <source>[ INFO ] - Attempting a secure connection to %1:%2 ...</source> <extracomment>We don't need to worry about %1 being a raw IPv6 address here as we prohibit IP addresses for secure connections so it is a URL; %2 is the port number. ---------- @@ -6573,33 +6636,33 @@ It is: "%1" <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="1149"/> + <location filename="../src/ctelnet.cpp" line="1143"/> <source>Trying secure (IPv6) connection to %1:%2 via proxy...</source> <extracomment>%1 is the URL for the Server and %2 is the port number for the connection.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="1178"/> + <location filename="../src/ctelnet.cpp" line="1172"/> <source>Trying secure (IPv4) connection to %1:%2 via proxy...</source> <extracomment>%1 is the URL for the Server and %2 is the port number for the connection.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="1186"/> + <location filename="../src/ctelnet.cpp" line="1180"/> <source>Trying secure (IPv4) connection to %1:%2 ...</source> <extracomment>%1 is the URL for the Server and %2 is the port number for the connection.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="1210"/> + <location filename="../src/ctelnet.cpp" line="1204"/> <source>Trying open (IPv4 and IPv6) connections to %1:%2 via proxy...</source> <extracomment>Happy-Eyeballs (both IPv4 and IPv6 addresses available) case. %1 is the URL for the proxy and %2 is the port number (on BOTH addresses) for the connection.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="1213"/> - <location filename="../src/ctelnet.cpp" line="1244"/> - <location filename="../src/ctelnet.cpp" line="1271"/> + <location filename="../src/ctelnet.cpp" line="1207"/> + <location filename="../src/ctelnet.cpp" line="1238"/> + <location filename="../src/ctelnet.cpp" line="1265"/> <source>[ INFO ] - Attempting an open connection to %1:%2 via proxy...</source> <extracomment>%1 is a URL for the Game Server; %2 is the port number. ---------- @@ -6609,15 +6672,15 @@ It is: "%1" <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="1219"/> + <location filename="../src/ctelnet.cpp" line="1213"/> <source>Trying open (IPv4 and IPv6) connections to %1:%2 ...</source> <extracomment>Happy-Eyeballs (both IPv4 and IPv6 addresses available) case. %1 is the URL for the Server and %2 is the port number (on BOTH addresses) for the connection.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="1222"/> - <location filename="../src/ctelnet.cpp" line="1252"/> - <location filename="../src/ctelnet.cpp" line="1280"/> + <location filename="../src/ctelnet.cpp" line="1216"/> + <location filename="../src/ctelnet.cpp" line="1246"/> + <location filename="../src/ctelnet.cpp" line="1274"/> <source>[ INFO ] - Attempting an open connection to %1:%2 ...</source> <extracomment>%1 is a URL for the Game Server; %2 is the port number. ---------- @@ -6627,203 +6690,203 @@ It is: "%1" <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="1240"/> + <location filename="../src/ctelnet.cpp" line="1234"/> <source>Trying open (IPv6) connection to %1:%2 via proxy...</source> <extracomment>%1 is the URL or IPv6 address (suitably wrapped) for the Game Server and %2 is the port number for the connection.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="1248"/> + <location filename="../src/ctelnet.cpp" line="1242"/> <source>Trying open (IPv6) connection to %1:%2 ...</source> <extracomment>%1 is the URL or IPv6 address (suitably wrapped) for the Game Server and %2 is the port number for the connection.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="1267"/> + <location filename="../src/ctelnet.cpp" line="1261"/> <source>Trying open (IPv4) connection to %1:%2 via proxy...</source> <extracomment>%1 is the URL or IPv4 address for the Game Server and %2 is the port number for the connection.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="1276"/> + <location filename="../src/ctelnet.cpp" line="1270"/> <source>Trying open (IPv4) connection to %1:%2 ...</source> <extracomment>%1 is the URL or IPv4 address for the Game Server and %2 is the port number for the connection.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="2542"/> + <location filename="../src/ctelnet.cpp" line="2536"/> <source>[ INFO ] - This game appears to support MXP (Mud eXtension Protocol), but has not turned it on properly. MXP processing has been automatically enabled for clickable links, room info, and richer interactions. You can disable this setting in Settings > Special Options.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="3634"/> - <location filename="../src/ctelnet.cpp" line="4033"/> + <location filename="../src/ctelnet.cpp" line="3628"/> + <location filename="../src/ctelnet.cpp" line="4027"/> <source>[ INFO ] - Upgrading the GUI to new version '%1' from version '%2' (url='%3').</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="3970"/> + <location filename="../src/ctelnet.cpp" line="3964"/> <source>[ INFO ] - Downloading and installing package '%1' (url='%2').</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="3994"/> + <location filename="../src/ctelnet.cpp" line="3988"/> <source>Cancel</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="3994"/> + <location filename="../src/ctelnet.cpp" line="3988"/> <source>Downloading game GUI from server...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="4295"/> + <location filename="../src/ctelnet.cpp" line="4289"/> <source>[ INFO ] - A more secure connection on port %1 is available.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="4304"/> + <location filename="../src/ctelnet.cpp" line="4298"/> <source>For data transfer protection and privacy, this connection advertises a secure port.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="4305"/> + <location filename="../src/ctelnet.cpp" line="4299"/> <source>Update to port %1 and connect with encryption?</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="4466"/> + <location filename="../src/ctelnet.cpp" line="4460"/> <source>ERROR</source> <extracomment>Keep the capitalisation, the translated text at 7 letters max so it aligns nicely</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="4479"/> + <location filename="../src/ctelnet.cpp" line="4473"/> <source>LUA</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="4491"/> + <location filename="../src/ctelnet.cpp" line="4485"/> <source>WARN</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="4503"/> + <location filename="../src/ctelnet.cpp" line="4497"/> <source>ALERT</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="4515"/> + <location filename="../src/ctelnet.cpp" line="4509"/> <source>INFO</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="4527"/> + <location filename="../src/ctelnet.cpp" line="4521"/> <source>OK</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="4538"/> + <location filename="../src/ctelnet.cpp" line="4532"/> <source>CHAT</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="4781"/> + <location filename="../src/ctelnet.cpp" line="4775"/> <source>[ WARN ] - MCCP decompression error (%1), compression disabled. If the display looks garbled, please reconnect to the game.</source> <extracomment>%1 is the decompression error description. Shown when the server sends a corrupt MCCP (compressed) data stream.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="4828"/> + <location filename="../src/ctelnet.cpp" line="4822"/> <source>[ INFO ] - Loading replay file: "%1".</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="4852"/> + <location filename="../src/ctelnet.cpp" line="4846"/> <source>Cannot replay file "%1", error message was: "replay file seems to be corrupt".</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="4854"/> + <location filename="../src/ctelnet.cpp" line="4848"/> <source>[ WARN ] - The replay has been aborted as the file seems to be corrupt.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="4863"/> + <location filename="../src/ctelnet.cpp" line="4857"/> <source>Cannot perform replay, another one may already be in progress. Try again when it has finished.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="4865"/> + <location filename="../src/ctelnet.cpp" line="4859"/> <source>[ WARN ] - Cannot perform replay, another one may already be in progress. Try again when it has finished.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="4873"/> + <location filename="../src/ctelnet.cpp" line="4867"/> <source>Cannot read file "%1", error message was: "%2".</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="4875"/> + <location filename="../src/ctelnet.cpp" line="4869"/> <source>[ ERROR ] - Cannot read file "%1", error message was: "%2".</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="4914"/> + <location filename="../src/ctelnet.cpp" line="4908"/> <source>[ OK ] - The replay has ended.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="5045"/> + <location filename="../src/ctelnet.cpp" line="5050"/> <source>[ WARN ] - Too much data to process at once, some may have been lost.</source> <extracomment>Shown when too much data expands out of one compressed read (e.g. a decompression bomb) to process safely.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="5610"/> + <location filename="../src/ctelnet.cpp" line="5611"/> <source>server %1</source> <extracomment>Telnet options report: server side of an option, %1 is "enabled" or "disabled"</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="5610"/> - <location filename="../src/ctelnet.cpp" line="5614"/> + <location filename="../src/ctelnet.cpp" line="5611"/> + <location filename="../src/ctelnet.cpp" line="5615"/> <source>enabled</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="5610"/> - <location filename="../src/ctelnet.cpp" line="5614"/> + <location filename="../src/ctelnet.cpp" line="5611"/> + <location filename="../src/ctelnet.cpp" line="5615"/> <source>disabled</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="5614"/> + <location filename="../src/ctelnet.cpp" line="5615"/> <source>client %1</source> <extracomment>Telnet options report: client side of an option, %1 is "enabled" or "disabled"</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="5617"/> + <location filename="../src/ctelnet.cpp" line="5618"/> <source> %1: %2</source> <extracomment>Telnet option line: %1 is the option name (e.g. "NAWS (31)"), %2 is one or both sides</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="5621"/> + <location filename="../src/ctelnet.cpp" line="5622"/> <source> (none negotiated yet) </source> <extracomment>Shown in the Telnet options statistics report when no options have been negotiated yet</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/ctelnet.cpp" line="5655"/> + <location filename="../src/ctelnet.cpp" line="5656"/> <source>[ WARN ] - This game appears to use character-at-a-time mode, which Mudlet does not support. Input may not work as expected. Consider using keybindings for immediate key response instead.</source> <extracomment>Warning shown when server uses character-at-a-time mode which Mudlet doesn't support</extracomment> <translation type="unfinished"></translation> @@ -7371,22 +7434,38 @@ custom line?</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/updater/Feed.cpp" line="163"/> - <location filename="../src/updater/Feed.cpp" line="182"/> - <location filename="../src/updater/Feed.cpp" line="215"/> - <source>Could not verify the integrity of the download. Please try again later.</source> - <extracomment>Error shown when a manual update cannot be verified as safe to install</extracomment> + <location filename="../src/updater/Feed.cpp" line="164"/> + <source>This update does not publish the checksums needed to verify it. Please try again later, or download it from https://www.mudlet.org/download/</source> + <extracomment>Error shown when the release publishes no checksums at all, so the download cannot be verified as safe to install</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/updater/Feed.cpp" line="258"/> + <location filename="../src/updater/Feed.cpp" line="225"/> + <source>Could not download the checksums needed to verify this update. Please try again later.</source> + <extracomment>Error shown when the checksums needed to verify the update could not be downloaded</extracomment> + <translation type="unfinished"></translation> + </message> + <message> + <location filename="../src/updater/Feed.cpp" line="243"/> + <source>The checksums for this update could not be read, so it cannot be verified. Please try again later.</source> + <extracomment>Error shown when the checksum file for the update was downloaded but could not be read</extracomment> + <translation type="unfinished"></translation> + </message> + <message> + <location filename="../src/updater/Feed.cpp" line="247"/> + <source>This update is missing a checksum for your platform, so it cannot be verified. Please try again later, or download it from https://www.mudlet.org/download/</source> + <extracomment>Error shown when the release publishes checksums but none of them cover this platform's download</extracomment> + <translation type="unfinished"></translation> + </message> + <message> + <location filename="../src/updater/Feed.cpp" line="291"/> <source>Could not connect to the update server: %1</source> <extracomment>Error shown when the network request to the update server fails. %1 is the technical error description.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/updater/Feed.cpp" line="272"/> - <location filename="../src/updater/Feed.cpp" line="294"/> + <location filename="../src/updater/Feed.cpp" line="305"/> + <location filename="../src/updater/Feed.cpp" line="327"/> <source>Could not read update information from the server</source> <extracomment>Error shown when the server response cannot be understood ---------- @@ -7394,56 +7473,56 @@ Error shown when the update server response cannot be understood</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/updater/Feed.cpp" line="283"/> + <location filename="../src/updater/Feed.cpp" line="316"/> <source>Update check temporarily unavailable. Please try again in a few minutes.</source> <extracomment>Error shown when the GitHub API rate limit has been exceeded</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/updater/Feed.cpp" line="286"/> + <location filename="../src/updater/Feed.cpp" line="319"/> <source>Could not check for updates: %1</source> <extracomment>Error shown when the GitHub API returns an error. %1 is the error message from the server.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/updater/Feed.cpp" line="340"/> + <location filename="../src/updater/Feed.cpp" line="373"/> <source>Could not create temporary file for download: %1</source> <extracomment>Error shown when a temporary file cannot be created for the update download. %1 is the system error message.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/updater/Feed.cpp" line="350"/> + <location filename="../src/updater/Feed.cpp" line="383"/> <source>Failed to save download data: %1</source> <extracomment>Error shown when writing download data to disk fails. %1 is the system error message.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/updater/Feed.cpp" line="361"/> + <location filename="../src/updater/Feed.cpp" line="394"/> <source>Download failed: %1</source> <extracomment>Error shown when the update file download fails. %1 is the network error message.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/updater/Feed.cpp" line="369"/> + <location filename="../src/updater/Feed.cpp" line="402"/> <source>Download failed. Please try again.</source> <extracomment>Error shown when the update download completed but nothing was received</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/updater/Feed.cpp" line="377"/> + <location filename="../src/updater/Feed.cpp" line="410"/> <source>Failed to save download: %1</source> <extracomment>Error shown when flushing the downloaded file to disk fails. %1 is the system error message.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/updater/Feed.cpp" line="385"/> - <location filename="../src/updater/Feed.cpp" line="394"/> + <location filename="../src/updater/Feed.cpp" line="418"/> + <location filename="../src/updater/Feed.cpp" line="427"/> <source>Failed to verify download integrity</source> <extracomment>Error shown when the downloaded file cannot be read back for checksum verification</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/updater/Feed.cpp" line="403"/> + <location filename="../src/updater/Feed.cpp" line="436"/> <source>Could not verify download integrity.</source> <extracomment>Error shown when the downloaded file's SHA256 checksum does not match the expected value</extracomment> <translation type="unfinished"></translation> @@ -7547,145 +7626,145 @@ Count</source> <context> <name>directions</name> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5922"/> + <location filename="../src/TLuaInterpreter.cpp" line="6151"/> <source>north</source> <comment>Entering this direction will move the player in the game</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5924"/> + <location filename="../src/TLuaInterpreter.cpp" line="6153"/> <source>n</source> <comment>Entering this direction will move the player in the game</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5926"/> + <location filename="../src/TLuaInterpreter.cpp" line="6155"/> <source>east</source> <comment>Entering this direction will move the player in the game</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5928"/> + <location filename="../src/TLuaInterpreter.cpp" line="6157"/> <source>e</source> <comment>Entering this direction will move the player in the game</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5930"/> + <location filename="../src/TLuaInterpreter.cpp" line="6159"/> <source>south</source> <comment>Entering this direction will move the player in the game</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5932"/> + <location filename="../src/TLuaInterpreter.cpp" line="6161"/> <source>s</source> <comment>Entering this direction will move the player in the game</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5934"/> + <location filename="../src/TLuaInterpreter.cpp" line="6163"/> <source>west</source> <comment>Entering this direction will move the player in the game</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5936"/> + <location filename="../src/TLuaInterpreter.cpp" line="6165"/> <source>w</source> <comment>Entering this direction will move the player in the game</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5938"/> + <location filename="../src/TLuaInterpreter.cpp" line="6167"/> <source>northeast</source> <comment>Entering this direction will move the player in the game</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5940"/> + <location filename="../src/TLuaInterpreter.cpp" line="6169"/> <source>ne</source> <comment>Entering this direction will move the player in the game</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5942"/> + <location filename="../src/TLuaInterpreter.cpp" line="6171"/> <source>southeast</source> <comment>Entering this direction will move the player in the game</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5944"/> + <location filename="../src/TLuaInterpreter.cpp" line="6173"/> <source>se</source> <comment>Entering this direction will move the player in the game</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5946"/> + <location filename="../src/TLuaInterpreter.cpp" line="6175"/> <source>southwest</source> <comment>Entering this direction will move the player in the game</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5948"/> + <location filename="../src/TLuaInterpreter.cpp" line="6177"/> <source>sw</source> <comment>Entering this direction will move the player in the game</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5950"/> + <location filename="../src/TLuaInterpreter.cpp" line="6179"/> <source>northwest</source> <comment>Entering this direction will move the player in the game</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5952"/> + <location filename="../src/TLuaInterpreter.cpp" line="6181"/> <source>nw</source> <comment>Entering this direction will move the player in the game</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5954"/> + <location filename="../src/TLuaInterpreter.cpp" line="6183"/> <source>in</source> <comment>Entering this direction will move the player in the game</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5956"/> + <location filename="../src/TLuaInterpreter.cpp" line="6185"/> <source>i</source> <comment>Entering this direction will move the player in the game</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5958"/> + <location filename="../src/TLuaInterpreter.cpp" line="6187"/> <source>out</source> <comment>Entering this direction will move the player in the game</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5960"/> + <location filename="../src/TLuaInterpreter.cpp" line="6189"/> <source>o</source> <comment>Entering this direction will move the player in the game</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5962"/> + <location filename="../src/TLuaInterpreter.cpp" line="6191"/> <source>up</source> <comment>Entering this direction will move the player in the game</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5964"/> + <location filename="../src/TLuaInterpreter.cpp" line="6193"/> <source>u</source> <comment>Entering this direction will move the player in the game</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5966"/> + <location filename="../src/TLuaInterpreter.cpp" line="6195"/> <source>down</source> <comment>Entering this direction will move the player in the game</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/TLuaInterpreter.cpp" line="5968"/> + <location filename="../src/TLuaInterpreter.cpp" line="6197"/> <source>d</source> <comment>Entering this direction will move the player in the game</comment> <translation type="unfinished"></translation> @@ -8056,6 +8135,21 @@ Count</source> <translation type="unfinished"></translation> </message> </context> +<context> + <name>dlgActionMainArea</name> + <message> + <location filename="../src/dlgActionMainArea.cpp" line="87"/> + <source>Number of columns:</source> + <extracomment>A toolbar is being set to vertical orientation - so multiple rows of this number of columns</extracomment> + <translation type="unfinished"></translation> + </message> + <message> + <location filename="../src/dlgActionMainArea.cpp" line="90"/> + <source>Number of rows:</source> + <extracomment>A toolbar is being set to horizontal orientation - so multiple columns of this number of rows</extracomment> + <translation type="unfinished"></translation> + </message> +</context> <context> <name>dlgAliasMainArea</name> <message> @@ -8252,213 +8346,213 @@ Count</source> <context> <name>dlgConnectionProfiles</name> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="132"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="167"/> <source>Connect</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="256"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="291"/> <source>Characters password. Note that the password is not encrypted in storage</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="334"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="369"/> <source>Game name: %1</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="336"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="371"/> <source>Button to select a mud game to play, double-click it to connect and start playing it.</source> <extracomment>Some text to speech engines will spell out initials like MUD so stick to lower case if that is a better option</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="1302"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="1350"/> <source>This profile is currently loaded - close it before changing the connection parameters.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="1623"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="1683"/> <source>Reset icon</source> <extracomment>Reset the custom picture for this profile in the connection dialog and show the default one instead</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="1627"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="1687"/> <source>Set custom icon</source> <extracomment>Set a custom picture to show for the profile in the connection dialog</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="1632"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="1692"/> <source>Set custom color</source> <extracomment>Set a custom color to show for the profile in the connection dialog</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="2096"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="2165"/> <source>The %1 character is not permitted. Use one of the following:</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="2119"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="2186"/> <source>You have to enter a number. Other characters are not permitted.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="2108"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="2175"/> <source>This profile name is already in use.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="822"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="867"/> <source>Could not rename your profile data on the computer.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="134"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="169"/> <source>Offline</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="138"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="173"/> <source>Skip - show me the games list</source> <extracomment>Button shown on first launch to skip the tutorial and show the full games list</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="163"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="198"/> <source><p><center><img src="tutorialIcon"/></center></p><p><center><big><b>Welcome to Mudlet!</b></big></center></p><p><center>Play a short guided adventure to learn<br>how to navigate in games, use triggers, aliases, and scripting.</center></p><p><center><a href="mudlet-tutorial">Start Tutorial</a></center></p><p align="right"><span style=" font-family:'Sans';">The Mudlet Team </span><img src=":/icons/mudlet_main_16px.png"/></p></source> <extracomment>Welcome message shown on first launch, focused on starting the tutorial.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="176"/> - <location filename="../src/dlgConnectionProfiles.cpp" line="1747"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="211"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="1807"/> <source>Copy</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="178"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="213"/> <source>Copy settings only</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="195"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="230"/> <source>copy profile</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="196"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="231"/> <source>copy the entire profile to new one that will require a different new name.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="208"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="243"/> <source>copy profile settings</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="209"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="244"/> <source>copy the settings and some other parts of the profile to a new one that will require a different new name.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="254"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="289"/> <source>Characters password, stored securely in the computer's credential manager</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="331"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="366"/> <source>Click to load but not connect the selected profile.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="332"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="367"/> <source>Click to load and connect the selected profile.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="333"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="368"/> <source>Need to have a valid profile name, game server address and port before this button can be enabled.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="830"/> - <location filename="../src/dlgConnectionProfiles.cpp" line="1776"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="875"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="1836"/> <source>Could not create the new profile folder on your computer.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="678"/> - <location filename="../src/dlgConnectionProfiles.cpp" line="921"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="723"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="966"/> <source>new profile name</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="95"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="130"/> <source>My games</source> <extracomment>Tab showing only the games the user already has profiles for</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="97"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="132"/> <source>All games</source> <extracomment>Tab showing every game Mudlet has a built-in profile for</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="99"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="134"/> <source>games shown</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="100"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="135"/> <source>Switch between showing only your own games and all of the games Mudlet knows about.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="1077"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="1125"/> <source>Deleting '%1'</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="1306"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="1354"/> <source>A profile that is in use cannot be removed</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="1647"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="1707"/> <source>Select custom image for profile (should be 120x30)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="1647"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="1707"/> <source>Images (%1)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="1728"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="1788"/> <source>Copying...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="2129"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="2196"/> <source>Port number must be above zero and below 65535.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="2149"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="2216"/> <source>Mudlet can not load support for secure connections.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="2171"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="2238"/> <source>Please enter the URL or IP address of the Game server.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="2190"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="2257"/> <source>Please enter the URL of the Game server. <i>SSL/TLS connections require a URL, as an IP address is not a suitable identifier for the certification of the Game Server.</i></source> @@ -8466,33 +8560,33 @@ Count</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="2209"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="2276"/> <source>Load profile without connecting.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="2225"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="2292"/> <source>Please set a valid profile name, game server address and the game port before loading.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="2230"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="2297"/> <source>Please set a valid profile name, game server address and the game port before connecting.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="2283"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="2350"/> <source>Click to hide the password; it will also hide if another profile is selected.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="2287"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="2354"/> <source>Click to reveal the password for this profile.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgConnectionProfiles.cpp" line="2137"/> - <location filename="../src/dlgConnectionProfiles.cpp" line="2140"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="2204"/> + <location filename="../src/dlgConnectionProfiles.cpp" line="2207"/> <source>Mudlet is not configured for secure connections.</source> <translation type="unfinished"></translation> </message> @@ -9636,132 +9730,132 @@ Message on button in package manager initially and when the view is NOT the &quo <context> <name>dlgProfilePreferences</name> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="176"/> + <location filename="../src/dlgProfilePreferences.cpp" line="177"/> <source>Location which will be used to store log files - matching logs will be appended to.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="177"/> + <location filename="../src/dlgProfilePreferences.cpp" line="178"/> <source>Select a directory where logs will be saved.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="178"/> + <location filename="../src/dlgProfilePreferences.cpp" line="179"/> <source>Reset the directory so that logs are saved to the profile's <i>log</i> directory.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="182"/> + <location filename="../src/dlgProfilePreferences.cpp" line="183"/> <source>Set a custom name for your log. (New logs are appended if a log file of the same name already exists).</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="218"/> + <location filename="../src/dlgProfilePreferences.cpp" line="219"/> <source>Automatic updates are disabled in development builds to prevent an update from overwriting your Mudlet.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="245"/> + <location filename="../src/dlgProfilePreferences.cpp" line="250"/> <source>Select the only or the primary font used (depending on <i>Only use symbols (glyphs) from chosen font</i> setting) to produce the 2D mapper room symbols.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="328"/> + <location filename="../src/dlgProfilePreferences.cpp" line="333"/> <source>%1 (%2% done)</source> <comment>%1 is the (not-translated so users of the language can read it!) language name, %2 is percentage done.</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="390"/> + <location filename="../src/dlgProfilePreferences.cpp" line="404"/> <source>Migrated all passwords to secure storage.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="401"/> + <location filename="../src/dlgProfilePreferences.cpp" line="415"/> <source>Migrated all passwords to profile storage.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="766"/> + <location filename="../src/dlgProfilePreferences.cpp" line="780"/> <source>From the dictionary file <tt>%1.dic</tt> (and its companion affix <tt>.aff</tt> file).</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="951"/> + <location filename="../src/dlgProfilePreferences.cpp" line="970"/> <source>yyyy-MM-dd#HH-mm-ss (e.g., 1970-01-01#00-00-00%1)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="953"/> + <location filename="../src/dlgProfilePreferences.cpp" line="972"/> <source>yyyy-MM-ddTHH-mm-ss (e.g., 1970-01-01T00-00-00%1)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="954"/> + <location filename="../src/dlgProfilePreferences.cpp" line="973"/> <source>yyyy-MM-dd (concatenate daily logs in, e.g. 1970-01-01%1)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="957"/> + <location filename="../src/dlgProfilePreferences.cpp" line="976"/> <source>yyyy-MM (concatenate month logs in, e.g. 1970-01%1)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="958"/> + <location filename="../src/dlgProfilePreferences.cpp" line="977"/> <source>Named file (concatenate logs in one file)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="1053"/> + <location filename="../src/dlgProfilePreferences.cpp" line="1072"/> <source>Other profiles to Map to:</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="1117"/> + <location filename="../src/dlgProfilePreferences.cpp" line="1136"/> <source>2D Map Room Symbol scaling factor:</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="1149"/> + <location filename="../src/dlgProfilePreferences.cpp" line="1168"/> <source>Show "%1" in the map area selection</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="1232"/> + <location filename="../src/dlgProfilePreferences.cpp" line="1251"/> <source>%1 (*Error, report to Mudlet Makers*)</source> <comment>The encoder code name is not in the mudlet class mEncodingNamesMap when it should be and the Mudlet Makers need to fix it!</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="1409"/> - <location filename="../src/dlgProfilePreferences.cpp" line="4826"/> + <location filename="../src/dlgProfilePreferences.cpp" line="1428"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4852"/> <source>Profile preferences - %1</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="1883"/> + <location filename="../src/dlgProfilePreferences.cpp" line="1902"/> <source>Profile preferences</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="2839"/> + <location filename="../src/dlgProfilePreferences.cpp" line="2865"/> <source>Load Mudlet map</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="2780"/> + <location filename="../src/dlgProfilePreferences.cpp" line="2806"/> <source>Loading map - please wait...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="185"/> + <location filename="../src/dlgProfilePreferences.cpp" line="186"/> <source>logfile</source> <extracomment>Must be a valid default filename for a log-file and is used if the user does not enter any other value (Ensure all instances have the same translation {one of two copies}).</extracomment> <translation type="unfinished"></translation> </message> <message numerus="yes"> - <location filename="../src/dlgProfilePreferences.cpp" line="196"/> - <location filename="../src/dlgProfilePreferences.cpp" line="3586"/> + <location filename="../src/dlgProfilePreferences.cpp" line="197"/> + <location filename="../src/dlgProfilePreferences.cpp" line="3612"/> <source>copy to %n destination(s)</source> <extracomment>text on button to put the map from this profile into the other profiles to receive the map from this profile, %n is the number of other profiles that have already been selected to receive it and will be zero or more. The button will also be disabled (greyed out) in the zero case but the text will still be visible.</extracomment> <translation type="unfinished"> @@ -9769,294 +9863,306 @@ Message on button in package manager initially and when the view is NOT the &quo </translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="397"/> + <location filename="../src/dlgProfilePreferences.cpp" line="411"/> <source>Migrated %1...</source> <extracomment>This notifies the user that progress is being made on profile migration by saying what profile was just migrated to store passwords securely</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="721"/> + <location filename="../src/dlgProfilePreferences.cpp" line="735"/> <source>Enable spell check using Mudlet dictionary:</source> <extracomment>On Windows and MacOs, we have to bundle our own dictionaries with our application - and we also use them on *nix systems where we do not find the system ones</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="724"/> + <location filename="../src/dlgProfilePreferences.cpp" line="738"/> <source>Enable spell check using System dictionary:</source> <extracomment>On *nix systems where we find the system ones we use them</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="837"/> + <location filename="../src/dlgProfilePreferences.cpp" line="851"/> <source><p>Use the maximum buffer size your system can handle (%1 lines). This will be calculated based on available memory.</p></source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="982"/> + <location filename="../src/dlgProfilePreferences.cpp" line="1001"/> <source>Protocols</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="991"/> + <location filename="../src/dlgProfilePreferences.cpp" line="1010"/> <source>GMCP: Generic Mud Communication Protocol</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="1004"/> + <location filename="../src/dlgProfilePreferences.cpp" line="1023"/> <source>MSDP: Mud Server Data Protocol</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="1014"/> + <location filename="../src/dlgProfilePreferences.cpp" line="1033"/> <source>MSSP: Mud Server Status Protocol</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="1009"/> + <location filename="../src/dlgProfilePreferences.cpp" line="1028"/> <source>MSP: Mud Sound Protocol</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="1024"/> + <location filename="../src/dlgProfilePreferences.cpp" line="1043"/> <source>MXP: Mud eXtension Protocol</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="1019"/> + <location filename="../src/dlgProfilePreferences.cpp" line="1038"/> <source>MTTS: Mud Terminal Type Standard</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="240"/> + <location filename="../src/dlgProfilePreferences.cpp" line="245"/> <source><p>Hide success messages in Central Debug Console for timers with intervals below this threshold. Error messages always display.</p></source> <extracomment>Tooltip for timer debug output minimum interval</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="244"/> + <location filename="../src/dlgProfilePreferences.cpp" line="249"/> <source>Show all map symbols, their Unicode code-points, font availability, and which rooms use them.</source> <extracomment>Tooltip for show glyph usage button</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="248"/> + <location filename="../src/dlgProfilePreferences.cpp" line="253"/> <source>Use only the selected font (may show � for missing symbols) or allow fallback fonts for better coverage.</source> <extracomment>Tooltip for map symbol font usage option</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="250"/> + <location filename="../src/dlgProfilePreferences.cpp" line="255"/> <source><p>Run all matching keybindings instead of just the first one. Disable for compatibility with pre-3.9.0 scripts.</p></source> <extracomment>Tooltip for run all keybindings option</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="253"/> + <location filename="../src/dlgProfilePreferences.cpp" line="258"/> <source><p>Controls display width for ambiguous East Asian characters. Auto-detects correct width for most encodings (default), or choose narrow/wide.</p></source> <extracomment>Tooltip for East Asian ambiguous width character option</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="256"/> + <location filename="../src/dlgProfilePreferences.cpp" line="261"/> <source><p>Enable context menu to analyze UTF-16/UTF-8 encoding of selected text. Useful for identifying multi-byte characters.</p></source> <extracomment>Tooltip for text analyzer option</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="259"/> + <location filename="../src/dlgProfilePreferences.cpp" line="264"/> <source><p>Control menu icon display: on, off, or auto (system default). May require restart.</p></source> <extracomment>Tooltip for show icons on menus option</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="914"/> + <location filename="../src/dlgProfilePreferences.cpp" line="933"/> <source>The Discord desktop app must be running for Rich Presence to work. Browser and mobile clients are not supported.</source> <extracomment>Tooltip shown when Discord Rich Presence cannot detect a logged-in user</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="986"/> + <location filename="../src/dlgProfilePreferences.cpp" line="1005"/> <source>CHARSET: Character Encoding Standard</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="996"/> + <location filename="../src/dlgProfilePreferences.cpp" line="1015"/> <source>MNES: Mud New-Environ Standard</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="1000"/> + <location filename="../src/dlgProfilePreferences.cpp" line="1019"/> <source>MNES uses the same telnet option as NEW-ENVIRON, so only one can be active. MNES sends a minimal set of variables, while NEW-ENVIRON sends extended variables including OSC link support.</source> <extracomment>Tooltip for MNES protocol option explaining mutual exclusivity with NEW-ENVIRON</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="1029"/> + <location filename="../src/dlgProfilePreferences.cpp" line="1048"/> <source>NAWS: Negotiate About Window Size</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="1034"/> + <location filename="../src/dlgProfilePreferences.cpp" line="1053"/> <source>NEW-ENVIRON: Client Variables Standard</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="1039"/> + <location filename="../src/dlgProfilePreferences.cpp" line="1058"/> <source>NEW-ENVIRON uses the same telnet option as MNES, so only one can be active. NEW-ENVIRON sends extended variables including OSC link support, while MNES sends a minimal set.</source> <extracomment>Tooltip for NEW-ENVIRON protocol option explaining mutual exclusivity with MNES</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="1094"/> + <location filename="../src/dlgProfilePreferences.cpp" line="1113"/> <source>%1 {Default}</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="1106"/> + <location filename="../src/dlgProfilePreferences.cpp" line="1125"/> <source>%1 {Experimental}</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="1108"/> + <location filename="../src/dlgProfilePreferences.cpp" line="1127"/> <source>%1 {For older versions}</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="1342"/> + <location filename="../src/dlgProfilePreferences.cpp" line="1361"/> <source>unknown error</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="1343"/> + <location filename="../src/dlgProfilePreferences.cpp" line="1362"/> <source>This profile could not be loaded correctly (%1). Settings cannot be saved. Close the profile and try loading an older version from 'Connect - Options - Profile history'.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="1520"/> + <location filename="../src/dlgProfilePreferences.cpp" line="1539"/> <source>Tab will switch between the input line and main window, and also step through hyperlinks while in caret mode. Ctrl+] and Ctrl+[ navigate links without conflicting with pane-switching. Press Enter or Space to activate the focused link, and the Menu key or Shift+F10 to open its context menu. Press Ctrl+End to jump to the latest content or Ctrl+Home to jump to the start of the buffer.</source> <extracomment>Screen-reader hint when the user picks Tab as the caret-mode pane-switching key, warning Tab is shared with hyperlink navigation and explaining how to activate links, open their menu, and jump to latest content. Do not translate the key names "Tab", "Ctrl+]", "Ctrl+[", "Enter", "Space", "Menu", "Shift+F10", "Ctrl+End" or "Ctrl+Home".</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="1525"/> + <location filename="../src/dlgProfilePreferences.cpp" line="1544"/> <source>In caret mode, use Ctrl+] for the next hyperlink and Ctrl+[ for the previous hyperlink. Press Enter or Space to activate the focused link, and the Menu key or Shift+F10 to open its context menu. Press Ctrl+End to jump to the latest content or Ctrl+Home to jump to the start of the buffer.</source> <extracomment>Screen-reader hint when the user picks any caret-mode pane-switching key other than Tab, explaining how to navigate, activate and open menus on hyperlinks, and jump to latest content. Do not translate the key names "Ctrl+]", "Ctrl+[", "Enter", "Space", "Menu", "Shift+F10", "Ctrl+End" or "Ctrl+Home".</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="1621"/> + <location filename="../src/dlgProfilePreferences.cpp" line="1640"/> <source>Warning: '%1' and '%2' now share the shortcut %3 - neither will work until one of them is changed.</source> <extracomment>Inline warning on the shortcuts preferences page when exactly two actions have been given the same shortcut. %1 and %2 are the action names, %3 is the shortcut itself.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="1628"/> + <location filename="../src/dlgProfilePreferences.cpp" line="1647"/> <source>Warning: %1 now share the shortcut %2 - none of them will work until they are changed.</source> <extracomment>Inline warning on the shortcuts preferences page when three or more actions have been given the same shortcut. %1 is the list of action names (each already quoted), %2 is the shortcut itself.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="1639"/> + <location filename="../src/dlgProfilePreferences.cpp" line="1658"/> <source>Shortcut conflict resolved.</source> <extracomment>Screen-reader announcement when editing the shortcuts removed the last duplicated assignment.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="2177"/> + <location filename="../src/dlgProfilePreferences.cpp" line="2105"/> + <source>[ WARN ] - Could not clear all of the stored media; some files may still be in use.</source> + <extracomment>Shown after the "Clear stored media" button in preferences fails to empty the profile's media directory.</extracomment> + <translation type="unfinished"></translation> + </message> + <message> + <location filename="../src/dlgProfilePreferences.cpp" line="2110"/> + <source>[ OK ] - The stored media files for this profile have been cleared.</source> + <extracomment>Shown after the "Clear stored media" button in preferences empties the profile's media directory.</extracomment> + <translation type="unfinished"></translation> + </message> + <message> + <location filename="../src/dlgProfilePreferences.cpp" line="2203"/> <source>Pick color</source> <extracomment>Generic pick color dialog title</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="2480"/> + <location filename="../src/dlgProfilePreferences.cpp" line="2506"/> <source>Forget saved sign-in?</source> <extracomment>Title of the dialog asking the user to confirm removing their saved sign-in.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="2482"/> + <location filename="../src/dlgProfilePreferences.cpp" line="2508"/> <source>This will remove the saved sign-in for this profile. You will need to sign in again next time. Continue?</source> <extracomment>Body of the dialog asking the user to confirm removing their saved sign-in; they will need to sign in again next time.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="2501"/> + <location filename="../src/dlgProfilePreferences.cpp" line="2527"/> <source>The saved sign-in has been forgotten.</source> <extracomment>Shown after the user's saved sign-in has actually been removed.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="2505"/> + <location filename="../src/dlgProfilePreferences.cpp" line="2531"/> <source>[ OK ] - The saved sign-in for this profile has been forgotten.</source> <extracomment>Shown in the main console after the user's saved sign-in has actually been removed.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="2510"/> + <location filename="../src/dlgProfilePreferences.cpp" line="2536"/> <source>Could not remove the saved sign-in; it may still be present.</source> <extracomment>Shown when removing the saved sign-in failed, so it may still be present.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="2514"/> + <location filename="../src/dlgProfilePreferences.cpp" line="2540"/> <source>[ WARN ] - Could not remove the saved sign-in; it may still be present.</source> <extracomment>Shown in the main console when removing the saved sign-in failed, so it may still be present.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="2520"/> + <location filename="../src/dlgProfilePreferences.cpp" line="2546"/> <source>No changes were made to the saved sign-in.</source> <extracomment>Shown when the user cancels removing their saved sign-in.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="2522"/> + <location filename="../src/dlgProfilePreferences.cpp" line="2548"/> <source>[ INFO ] - Cancelled: no changes were made to the saved sign-in.</source> <extracomment>Shown in the main console when the user cancels removing their saved sign-in.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="2804"/> + <location filename="../src/dlgProfilePreferences.cpp" line="2830"/> <source>Loaded map from %1.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="2806"/> + <location filename="../src/dlgProfilePreferences.cpp" line="2832"/> <source>Could not load map from %1.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="2870"/> + <location filename="../src/dlgProfilePreferences.cpp" line="2896"/> <source>Save Mudlet map</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="2898"/> + <location filename="../src/dlgProfilePreferences.cpp" line="2924"/> <source>Saving map - please wait...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="2915"/> + <location filename="../src/dlgProfilePreferences.cpp" line="2941"/> <source>Saved map to %1.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="2917"/> + <location filename="../src/dlgProfilePreferences.cpp" line="2943"/> <source>Could not save map to %1.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="2948"/> + <location filename="../src/dlgProfilePreferences.cpp" line="2974"/> <source>Migrating passwords to secure storage...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="2955"/> + <location filename="../src/dlgProfilePreferences.cpp" line="2981"/> <source>Migrating passwords to profiles...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="2987"/> + <location filename="../src/dlgProfilePreferences.cpp" line="3013"/> <source>[ ERROR ] - Unable to use or create directory to store map for other profile "%1". Please check that you have permissions/access to: "%2" @@ -10064,52 +10170,52 @@ and there is enough space. The copying operation has failed.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="2994"/> + <location filename="../src/dlgProfilePreferences.cpp" line="3020"/> <source>Creating a destination directory failed...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="3063"/> + <location filename="../src/dlgProfilePreferences.cpp" line="3089"/> <source>Backing up current map - please wait...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="3073"/> + <location filename="../src/dlgProfilePreferences.cpp" line="3099"/> <source>Could not backup the map - saving it failed.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="3098"/> + <location filename="../src/dlgProfilePreferences.cpp" line="3124"/> <source>Could not copy the map - failed to work out which map file we just saved the map as!</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="3110"/> + <location filename="../src/dlgProfilePreferences.cpp" line="3136"/> <source>Copying over map to %1 - please wait...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="3116"/> + <location filename="../src/dlgProfilePreferences.cpp" line="3142"/> <source>Could not copy the map to %1 - unable to copy the new map file over.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="3120"/> + <location filename="../src/dlgProfilePreferences.cpp" line="3146"/> <source>Map copied successfully to other profile %1.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="3131"/> + <location filename="../src/dlgProfilePreferences.cpp" line="3157"/> <source>Map copied, now signalling other profiles to reload it.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="3169"/> + <location filename="../src/dlgProfilePreferences.cpp" line="3195"/> <source>Where should Mudlet save log files?</source> <translation type="unfinished"></translation> </message> <message numerus="yes"> - <location filename="../src/dlgProfilePreferences.cpp" line="3591"/> + <location filename="../src/dlgProfilePreferences.cpp" line="3617"/> <source>%n selected - change destinations...</source> <extracomment>text on button to select other profiles to receive the map from this profile, %n is the number of other profiles that have already been selected to receive it and will always be 1 or more</extracomment> <translation type="unfinished"> @@ -10117,286 +10223,286 @@ and there is enough space. The copying operation has failed.</source> </translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="3596"/> + <location filename="../src/dlgProfilePreferences.cpp" line="3622"/> <source>pick destinations...</source> <extracomment>text on button to select other profiles to receive the map from this profile, this is used when no profiles have been selected</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="3833"/> + <location filename="../src/dlgProfilePreferences.cpp" line="3859"/> <source>Could not update themes: %1</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="3836"/> + <location filename="../src/dlgProfilePreferences.cpp" line="3862"/> <source>Updating themes from colorsublime.github.io...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4014"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4040"/> <source>{missing, possibly recently deleted trigger item}</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4017"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4043"/> <source>{missing, possibly recently deleted alias item}</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4020"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4046"/> <source>{missing, possibly recently deleted script item}</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4023"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4049"/> <source>{missing, possibly recently deleted timer item}</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4026"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4052"/> <source>{missing, possibly recently deleted key item}</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4029"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4055"/> <source>{missing, possibly recently deleted button item}</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4158"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4184"/> <source>The room symbol will appear like this if only symbols (glyphs) from the specific font are used.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4163"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4189"/> <source>The room symbol will appear like this if symbols (glyphs) from any font can be used.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4203"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4229"/> <source>How many rooms in the whole map have this symbol.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4221"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4247"/> <source>The rooms with this symbol, up to a maximum of thirty-two, if there are more than this, it is indicated but they are not shown.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4229"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4255"/> <source>The symbol can be made entirely from glyphs in the specified font.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4247"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4273"/> <source>The symbol cannot be drawn using any of the fonts in the system, either an invalid string was entered as the symbol for the indicated rooms or the map was created on a different systems with a different set of fonts available to use. You may be able to correct this by installing an additional font using whatever method is appropriate for this system or by editing the map to use a different symbol. It may be possible to do the latter via a lua script using the <i>getRoomChar</i> and <i>setRoomChar</i> functions.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4340"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4366"/> <source>Large icon</source> <extracomment>Discord Rich Presence large icon</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4342"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4368"/> <source>Detail</source> <extracomment>Discord Rich Presence detail</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4345"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4371"/> <source>Small icon</source> <extracomment>Discord Rich Presence small icon"</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4347"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4373"/> <source>State</source> <extracomment>Discord Rich Presence state</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4350"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4376"/> <source>Party size</source> <extracomment>Discord Rich Presence party size</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4352"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4378"/> <source>Party max</source> <extracomment>Discord Rich Presence maximum party size</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4354"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4380"/> <source>Time</source> <extracomment>Discord Rich Presence time until or time elapsed</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4969"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4995"/> <source>Set outer color of player room mark.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4969"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4995"/> <source>Set inner color of player room mark.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="179"/> + <location filename="../src/dlgProfilePreferences.cpp" line="180"/> <source><p>This option sets the format of the log name.</p><p>If <i>Named file</i> is selected, you can set a custom file name. (Logs are appended if a log file of the same name already exists.)</p></source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="753"/> + <location filename="../src/dlgProfilePreferences.cpp" line="767"/> <source>%1 - not recognised</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="767"/> + <location filename="../src/dlgProfilePreferences.cpp" line="781"/> <source><p>Mudlet does not recognise the code "%1", please report it to the Mudlet developers so we can describe it properly in future Mudlet versions!</p><p>The file <tt>%2.dic</tt> (and its companion affix <tt>.aff</tt> file) is still usable.</p></source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="784"/> + <location filename="../src/dlgProfilePreferences.cpp" line="798"/> <source>No Hunspell dictionary files found, spell-checking will not be available.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="903"/> - <location filename="../src/dlgProfilePreferences.cpp" line="904"/> + <location filename="../src/dlgProfilePreferences.cpp" line="917"/> + <location filename="../src/dlgProfilePreferences.cpp" line="920"/> <source>Mudlet will only show Rich Presence information while you use this Discord username (useful if you have multiple Discord accounts). Leave empty to show it for any Discord account you log in to. This must be the unique Discord username that uses a restricted lowercase ASCII character set and not any "Nickname" that you may have set for a particular Server.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="910"/> + <location filename="../src/dlgProfilePreferences.cpp" line="929"/> <source>This is the unique username using a restricted character set for the Discord account, and not necessarily the nickname that you might have set for a particular Server.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="912"/> + <location filename="../src/dlgProfilePreferences.cpp" line="931"/> <source>(Not connected)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="2791"/> + <location filename="../src/dlgProfilePreferences.cpp" line="2817"/> <source>[ ERROR ] - Unable to load JSON map file: %1 reason: %2.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="2831"/> + <location filename="../src/dlgProfilePreferences.cpp" line="2857"/> <source>Any map file (*.dat *.json *.xml)</source> <comment>Do not change extensions (in braces) as they are used programmatically</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="2832"/> - <location filename="../src/dlgProfilePreferences.cpp" line="2865"/> + <location filename="../src/dlgProfilePreferences.cpp" line="2858"/> + <location filename="../src/dlgProfilePreferences.cpp" line="2891"/> <source>Mudlet binary map (*.dat)</source> <comment>Do not change extensions (in braces) as they are used programmatically</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="2833"/> - <location filename="../src/dlgProfilePreferences.cpp" line="2866"/> + <location filename="../src/dlgProfilePreferences.cpp" line="2859"/> + <location filename="../src/dlgProfilePreferences.cpp" line="2892"/> <source>Mudlet JSON map (*.json)</source> <comment>Do not change extensions (in braces) as they are used programmatically</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="2834"/> + <location filename="../src/dlgProfilePreferences.cpp" line="2860"/> <source>Mudlet XML map (*.xml)</source> <comment>Do not change extensions (in braces) as they are used programmatically</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="2835"/> + <location filename="../src/dlgProfilePreferences.cpp" line="2861"/> <source>Any file (*)</source> <comment>Do not change extensions (in braces) as they are used programmatically</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4191"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4217"/> <source><p>These are the sequence of hexadecimal numbers that are used by the Unicode consortium to identify the graphemes needed to create the symbol. These numbers can be utilised to determine precisely what is to be drawn even if some fonts have glyphs that are the same for different codepoints or combination of codepoints.</p><p>Character entry utilities such as <i>charmap.exe</i> on <i>Windows</i> or <i>gucharmap</i> on many Unix type operating systems will also use these numbers which cover everything from U+0020 {Space} to U+10FFFD the last usable number in the <i>Private Use Plane 16</i> via most of the written marks that humanity has ever made.</p></source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4215"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4241"/> <source>more - not shown...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4238"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4264"/> <source><p>The symbol cannot be made entirely from glyphs in the specified font, but, using other fonts in the system, it can. Either un-check the <i>Only use symbols (glyphs) from chosen font</i> option or try and choose another font that does have the needed glyphs.</p><p><i>You need not close this table to try another font, changing it on the main preferences dialogue will update this table after a slight delay.</i></p></source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4392"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4418"/> <source>Map symbol usage - %1</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4502"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4528"/> <source>yyyy-MM-dd#HH-mm-ss (e.g., 1970-01-01#00-00-00.html)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4503"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4529"/> <source>yyyy-MM-ddTHH-mm-ss (e.g., 1970-01-01T00-00-00.html)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4504"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4530"/> <source>yyyy-MM-dd (concatenate daily logs in, e.g. 1970-01-01.html)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4505"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4531"/> <source>yyyy-MM (concatenate month logs in, e.g. 1970-01.html)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4508"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4534"/> <source>yyyy-MM-dd#HH-mm-ss (e.g., 1970-01-01#00-00-00.txt)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4509"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4535"/> <source>yyyy-MM-ddTHH-mm-ss (e.g., 1970-01-01T00-00-00.txt)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4510"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4536"/> <source>yyyy-MM-dd (concatenate daily logs in, e.g. 1970-01-01.txt)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="4511"/> + <location filename="../src/dlgProfilePreferences.cpp" line="4537"/> <source>yyyy-MM (concatenate month logs in, e.g. 1970-01.txt)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="5032"/> + <location filename="../src/dlgProfilePreferences.cpp" line="5058"/> <source>New: undo the game's own wrapping</source> <extracomment>Title of a balloon pointing out a newly added feature</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="5034"/> + <location filename="../src/dlgProfilePreferences.cpp" line="5060"/> <source>Games that wrap their own lines make triggers fiddly. Mudlet can now undo that wrapping, so triggers always see whole lines.</source> <extracomment>Body of the balloon, anchored to the option that rejoins lines the game server wrapped itself so that triggers match whole lines</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="5086"/> + <location filename="../src/dlgProfilePreferences.cpp" line="5112"/> <source>Deleting map - please wait...</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgProfilePreferences.cpp" line="5095"/> + <location filename="../src/dlgProfilePreferences.cpp" line="5121"/> <source>Deleted map.</source> <translation type="unfinished"></translation> </message> @@ -10815,361 +10921,361 @@ Format for showing a room weight with its usage count. %1 is the weight value (e <context> <name>dlgTriggerEditor</name> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="802"/> - <location filename="../src/dlgTriggerEditor.cpp" line="8581"/> - <location filename="../src/dlgTriggerEditor.h" line="595"/> + <location filename="../src/dlgTriggerEditor.cpp" line="803"/> + <location filename="../src/dlgTriggerEditor.cpp" line="8598"/> + <location filename="../src/dlgTriggerEditor.h" line="598"/> <source>Triggers</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="803"/> <location filename="../src/dlgTriggerEditor.cpp" line="804"/> + <location filename="../src/dlgTriggerEditor.cpp" line="805"/> <source>Show Triggers</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="832"/> - <location filename="../src/dlgTriggerEditor.cpp" line="8609"/> - <location filename="../src/dlgTriggerEditor.h" line="601"/> + <location filename="../src/dlgTriggerEditor.cpp" line="833"/> + <location filename="../src/dlgTriggerEditor.cpp" line="8626"/> + <location filename="../src/dlgTriggerEditor.h" line="604"/> <source>Buttons</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="833"/> <location filename="../src/dlgTriggerEditor.cpp" line="834"/> + <location filename="../src/dlgTriggerEditor.cpp" line="835"/> <source>Show Buttons</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="807"/> - <location filename="../src/dlgTriggerEditor.h" line="596"/> + <location filename="../src/dlgTriggerEditor.cpp" line="808"/> + <location filename="../src/dlgTriggerEditor.h" line="599"/> <source>Aliases</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="808"/> <location filename="../src/dlgTriggerEditor.cpp" line="809"/> + <location filename="../src/dlgTriggerEditor.cpp" line="810"/> <source>Show Aliases</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="817"/> - <location filename="../src/dlgTriggerEditor.cpp" line="8588"/> - <location filename="../src/dlgTriggerEditor.h" line="598"/> + <location filename="../src/dlgTriggerEditor.cpp" line="818"/> + <location filename="../src/dlgTriggerEditor.cpp" line="8605"/> + <location filename="../src/dlgTriggerEditor.h" line="601"/> <source>Timers</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="818"/> <location filename="../src/dlgTriggerEditor.cpp" line="819"/> + <location filename="../src/dlgTriggerEditor.cpp" line="820"/> <source>Show Timers</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="812"/> - <location filename="../src/dlgTriggerEditor.cpp" line="8595"/> - <location filename="../src/dlgTriggerEditor.h" line="597"/> + <location filename="../src/dlgTriggerEditor.cpp" line="813"/> + <location filename="../src/dlgTriggerEditor.cpp" line="8612"/> + <location filename="../src/dlgTriggerEditor.h" line="600"/> <source>Scripts</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="813"/> <location filename="../src/dlgTriggerEditor.cpp" line="814"/> + <location filename="../src/dlgTriggerEditor.cpp" line="815"/> <source>Show Scripts</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="822"/> - <location filename="../src/dlgTriggerEditor.h" line="599"/> + <location filename="../src/dlgTriggerEditor.cpp" line="823"/> + <location filename="../src/dlgTriggerEditor.h" line="602"/> <source>Keys</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="823"/> <location filename="../src/dlgTriggerEditor.cpp" line="824"/> + <location filename="../src/dlgTriggerEditor.cpp" line="825"/> <source>Show Keybindings</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="827"/> - <location filename="../src/dlgTriggerEditor.cpp" line="9112"/> - <location filename="../src/dlgTriggerEditor.h" line="600"/> + <location filename="../src/dlgTriggerEditor.cpp" line="828"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9129"/> + <location filename="../src/dlgTriggerEditor.h" line="603"/> <source>Variables</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="828"/> <location filename="../src/dlgTriggerEditor.cpp" line="829"/> + <location filename="../src/dlgTriggerEditor.cpp" line="830"/> <source>Show Variables</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="855"/> + <location filename="../src/dlgTriggerEditor.cpp" line="856"/> <source>Activate</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="856"/> + <location filename="../src/dlgTriggerEditor.cpp" line="857"/> <source>Toggle Active or Non-Active Mode for Triggers, Scripts etc.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="874"/> + <location filename="../src/dlgTriggerEditor.cpp" line="875"/> <source>Delete Item</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="898"/> - <location filename="../src/dlgTriggerEditor.cpp" line="13188"/> - <location filename="../src/dlgTriggerEditor.cpp" line="13197"/> + <location filename="../src/dlgTriggerEditor.cpp" line="899"/> + <location filename="../src/dlgTriggerEditor.cpp" line="13229"/> + <location filename="../src/dlgTriggerEditor.cpp" line="13238"/> <source>Copy</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="902"/> <location filename="../src/dlgTriggerEditor.cpp" line="903"/> + <location filename="../src/dlgTriggerEditor.cpp" line="904"/> <source>Copy the trigger/script/alias/etc</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="912"/> - <location filename="../src/dlgTriggerEditor.cpp" line="13189"/> - <location filename="../src/dlgTriggerEditor.cpp" line="13198"/> + <location filename="../src/dlgTriggerEditor.cpp" line="913"/> + <location filename="../src/dlgTriggerEditor.cpp" line="13230"/> + <location filename="../src/dlgTriggerEditor.cpp" line="13239"/> <source>Paste</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="916"/> <location filename="../src/dlgTriggerEditor.cpp" line="917"/> + <location filename="../src/dlgTriggerEditor.cpp" line="918"/> <source>Paste triggers/scripts/aliases/etc from the clipboard</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="957"/> + <location filename="../src/dlgTriggerEditor.cpp" line="958"/> <source>Import</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="961"/> + <location filename="../src/dlgTriggerEditor.cpp" line="962"/> <source>Export</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="970"/> - <location filename="../src/dlgTriggerEditor.cpp" line="12883"/> - <location filename="../src/dlgTriggerEditor.h" line="594"/> + <location filename="../src/dlgTriggerEditor.cpp" line="971"/> + <location filename="../src/dlgTriggerEditor.cpp" line="12924"/> + <location filename="../src/dlgTriggerEditor.h" line="597"/> <source>Save Profile</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="986"/> + <location filename="../src/dlgTriggerEditor.cpp" line="987"/> <source>Save Profile As</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="843"/> - <location filename="../src/dlgTriggerEditor.h" line="603"/> + <location filename="../src/dlgTriggerEditor.cpp" line="844"/> + <location filename="../src/dlgTriggerEditor.h" line="606"/> <source>Statistics</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="326"/> + <location filename="../src/dlgTriggerEditor.cpp" line="327"/> <source>new folder</source> <extracomment>Accessible description for a newly created folder, shown after the folder name</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="328"/> + <location filename="../src/dlgTriggerEditor.cpp" line="329"/> <source>new item</source> <extracomment>Accessible description for a newly created item, shown after the item name</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="334"/> + <location filename="../src/dlgTriggerEditor.cpp" line="335"/> <source>%1 - Editor</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="722"/> + <location filename="../src/dlgTriggerEditor.cpp" line="723"/> <source>*** starting new session ***</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="848"/> - <location filename="../src/dlgTriggerEditor.h" line="604"/> + <location filename="../src/dlgTriggerEditor.cpp" line="849"/> + <location filename="../src/dlgTriggerEditor.h" line="607"/> <source>Debug</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="994"/> + <location filename="../src/dlgTriggerEditor.cpp" line="995"/> <source>Something went wrong loading your Mudlet profile and it could not be loaded. Try loading an older version in 'Connect - Options - Profile history'</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="1021"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1022"/> <source>Editor Toolbar - %1 - Actions</source> <extracomment>This is the toolbar that is initially placed at the top of the editor.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="1062"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1063"/> <source>Editor Toolbar - %1 - Items</source> <extracomment>This is the toolbar that is initially placed at the left side of the editor.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="1072"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1073"/> <source>Restore Actions toolbar</source> <extracomment>This will restore that toolbar in the editor window, after a user has hidden it or moved it to another docking location or floated it elsewhere.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="1075"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1076"/> <source>Restore Items toolbar</source> <extracomment>This will restore that toolbar in the editor window, after a user has hidden it or moved it to another docking location or floated it elsewhere.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="1239"/> - <location filename="../src/dlgTriggerEditor.cpp" line="1242"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1241"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1244"/> <source>Search Options</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="1246"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1248"/> <source>Case sensitive</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="1390"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1392"/> <source>start of line</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="4925"/> + <location filename="../src/dlgTriggerEditor.cpp" line="4936"/> <source>New trigger group</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="4925"/> + <location filename="../src/dlgTriggerEditor.cpp" line="4936"/> <source>New trigger</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="5031"/> + <location filename="../src/dlgTriggerEditor.cpp" line="5042"/> <source>New timer group</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="5031"/> + <location filename="../src/dlgTriggerEditor.cpp" line="5042"/> <source>New timer</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="5186"/> + <location filename="../src/dlgTriggerEditor.cpp" line="5197"/> <source>New key group</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="5186"/> - <location filename="../src/dlgTriggerEditor.cpp" line="7032"/> - <location filename="../src/dlgTriggerEditor.cpp" line="7105"/> + <location filename="../src/dlgTriggerEditor.cpp" line="5197"/> + <location filename="../src/dlgTriggerEditor.cpp" line="7044"/> + <location filename="../src/dlgTriggerEditor.cpp" line="7117"/> <source>New key</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="5275"/> + <location filename="../src/dlgTriggerEditor.cpp" line="5286"/> <source>New alias group</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="5275"/> - <location filename="../src/dlgTriggerEditor.cpp" line="6159"/> + <location filename="../src/dlgTriggerEditor.cpp" line="5286"/> + <location filename="../src/dlgTriggerEditor.cpp" line="6168"/> <source>New alias</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="5370"/> + <location filename="../src/dlgTriggerEditor.cpp" line="5381"/> <source>New menu</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="5370"/> - <location filename="../src/dlgTriggerEditor.cpp" line="5399"/> + <location filename="../src/dlgTriggerEditor.cpp" line="5381"/> + <location filename="../src/dlgTriggerEditor.cpp" line="5408"/> <source>New button</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="5399"/> + <location filename="../src/dlgTriggerEditor.cpp" line="5408"/> <source>New toolbar</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="5474"/> + <location filename="../src/dlgTriggerEditor.cpp" line="5483"/> <source>New script group</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="5474"/> + <location filename="../src/dlgTriggerEditor.cpp" line="5483"/> <source>New script</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="6358"/> + <location filename="../src/dlgTriggerEditor.cpp" line="6367"/> <source>Alias <em>%1</em> has an infinite loop - substitution matches its own pattern. Please fix it - this alias isn't good as it'll call itself forever.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="6660"/> - <location filename="../src/dlgTriggerEditor.cpp" line="8446"/> - <location filename="../src/dlgTriggerEditor.cpp" line="13677"/> + <location filename="../src/dlgTriggerEditor.cpp" line="6672"/> + <location filename="../src/dlgTriggerEditor.cpp" line="8463"/> + <location filename="../src/dlgTriggerEditor.cpp" line="13718"/> <source>While loading the profile, this script had an error that has since been fixed, possibly by another script. The error was:%2%3</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="6990"/> - <location filename="../src/dlgTriggerEditor.cpp" line="8194"/> + <location filename="../src/dlgTriggerEditor.cpp" line="7002"/> + <location filename="../src/dlgTriggerEditor.cpp" line="8206"/> <source>Checked variables will be saved and loaded with your profile.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="7217"/> + <location filename="../src/dlgTriggerEditor.cpp" line="7229"/> <source>match on the prompt line</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="7221"/> + <location filename="../src/dlgTriggerEditor.cpp" line="7233"/> <source>match on the prompt line (disabled)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="7222"/> + <location filename="../src/dlgTriggerEditor.cpp" line="7234"/> <source>A Go-Ahead (GA) signal from the game is required to make this feature work</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="7657"/> - <location filename="../src/dlgTriggerEditor.cpp" line="7659"/> + <location filename="../src/dlgTriggerEditor.cpp" line="7669"/> + <location filename="../src/dlgTriggerEditor.cpp" line="7671"/> <source>fault</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="7509"/> - <location filename="../src/dlgTriggerEditor.cpp" line="7629"/> - <location filename="../src/dlgTriggerEditor.cpp" line="12784"/> + <location filename="../src/dlgTriggerEditor.cpp" line="7521"/> + <location filename="../src/dlgTriggerEditor.cpp" line="7641"/> + <location filename="../src/dlgTriggerEditor.cpp" line="12825"/> <source>Foreground color ignored</source> <extracomment>Color trigger ignored foreground color button, ensure all three instances have the same text</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="126"/> + <location filename="../src/dlgTriggerEditor.cpp" line="127"/> <source>How to add a new alias from the input line</source> <extracomment>Name of a selectable option for the Alias intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="129"/> - <location filename="../src/dlgTriggerEditor.cpp" line="166"/> + <location filename="../src/dlgTriggerEditor.cpp" line="130"/> + <location filename="../src/dlgTriggerEditor.cpp" line="167"/> <source>There are a <a href='https://forums.mudlet.org/viewtopic.php?f=6&t=22609'>couple</a> of <a href='https://forums.mudlet.org/viewtopic.php?f=6&t=16462'>packages</a> that can help you.</source> <extracomment>Help contents of a selectable option for the Alias intro ---------- @@ -11177,68 +11283,57 @@ Help contents of a selectable option for the Trigger intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="131"/> + <location filename="../src/dlgTriggerEditor.cpp" line="132"/> <source>Alias can also be defined from the input line in the main profile window like this:</source> <extracomment>Part of the Alias intro - This introductory text will be followed by a Lua code example for a trigger.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="134"/> + <location filename="../src/dlgTriggerEditor.cpp" line="135"/> <source>My greetings</source> <extracomment>Part of the Alias intro, code example for an alias - This is the name of the alias which reacts on the player typing "hi" by saying "Greetings, traveller!" in game.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="136"/> + <location filename="../src/dlgTriggerEditor.cpp" line="137"/> <source>hi</source> <extracomment>Part of the Alias intro, code example for an alias - This is the text input from the player which will be reacted on by saying "Greetings, traveller!" in game.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="138"/> + <location filename="../src/dlgTriggerEditor.cpp" line="139"/> <source>say Greetings, traveller!</source> <extracomment>Part of the Alias intro, code example for an alias - This is the command that Mudlet will send to the game after the player typed "hi".</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="140"/> + <location filename="../src/dlgTriggerEditor.cpp" line="141"/> <source>We said hi!</source> <extracomment>Part of the Alias intro, code example for an alias - This is the confirmation text shown to the player after they typed "hi" and we said "Greetings, traveller!" in game.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="143"/> - <location filename="../src/dlgTriggerEditor.cpp" line="178"/> - <location filename="../src/dlgTriggerEditor.cpp" line="203"/> - <location filename="../src/dlgTriggerEditor.cpp" line="228"/> - <location filename="../src/dlgTriggerEditor.cpp" line="249"/> - <location filename="../src/dlgTriggerEditor.cpp" line="271"/> - <location filename="../src/dlgTriggerEditor.cpp" line="297"/> + <location filename="../src/dlgTriggerEditor.cpp" line="144"/> + <location filename="../src/dlgTriggerEditor.cpp" line="179"/> + <location filename="../src/dlgTriggerEditor.cpp" line="204"/> + <location filename="../src/dlgTriggerEditor.cpp" line="229"/> + <location filename="../src/dlgTriggerEditor.cpp" line="250"/> + <location filename="../src/dlgTriggerEditor.cpp" line="272"/> + <location filename="../src/dlgTriggerEditor.cpp" line="298"/> <source>Where to find more information</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="145"/> - <location filename="../src/dlgTriggerEditor.cpp" line="180"/> - <location filename="../src/dlgTriggerEditor.cpp" line="205"/> - <location filename="../src/dlgTriggerEditor.cpp" line="273"/> + <location filename="../src/dlgTriggerEditor.cpp" line="146"/> + <location filename="../src/dlgTriggerEditor.cpp" line="181"/> + <location filename="../src/dlgTriggerEditor.cpp" line="206"/> + <location filename="../src/dlgTriggerEditor.cpp" line="274"/> <source>Watch a <a href='%1'>video demonstration</a> of the basic functionality.</source> <translation type="unfinished"></translation> </message> - <message> - <location filename="../src/dlgTriggerEditor.cpp" line="147"/> - <source>Read the <a href='http://wiki.mudlet.org/w/Manual:Introduction#Aliases'>Introduction to Aliases</a> for a detailed overview.</source> - <translation type="unfinished"></translation> - </message> <message> <location filename="../src/dlgTriggerEditor.cpp" line="148"/> - <location filename="../src/dlgTriggerEditor.cpp" line="183"/> - <location filename="../src/dlgTriggerEditor.cpp" line="208"/> - <location filename="../src/dlgTriggerEditor.cpp" line="231"/> - <location filename="../src/dlgTriggerEditor.cpp" line="252"/> - <location filename="../src/dlgTriggerEditor.cpp" line="276"/> - <location filename="../src/dlgTriggerEditor.cpp" line="300"/> - <source>Do you maybe have any other suggestions, questions or doubts?</source> + <source>Read the <a href='http://wiki.mudlet.org/w/Manual:Introduction#Aliases'>Introduction to Aliases</a> for a detailed overview.</source> <translation type="unfinished"></translation> </message> <message> @@ -11249,247 +11344,258 @@ Help contents of a selectable option for the Trigger intro</extracomment> <location filename="../src/dlgTriggerEditor.cpp" line="253"/> <location filename="../src/dlgTriggerEditor.cpp" line="277"/> <location filename="../src/dlgTriggerEditor.cpp" line="301"/> + <source>Do you maybe have any other suggestions, questions or doubts?</source> + <translation type="unfinished"></translation> + </message> + <message> + <location filename="../src/dlgTriggerEditor.cpp" line="150"/> + <location filename="../src/dlgTriggerEditor.cpp" line="185"/> + <location filename="../src/dlgTriggerEditor.cpp" line="210"/> + <location filename="../src/dlgTriggerEditor.cpp" line="233"/> + <location filename="../src/dlgTriggerEditor.cpp" line="254"/> + <location filename="../src/dlgTriggerEditor.cpp" line="278"/> + <location filename="../src/dlgTriggerEditor.cpp" line="302"/> <source>Join our community on <a href='https://www.mudlet.org/chat'>Discord</a> or in <a href='https://forums.mudlet.org/'>Mudlet forums</a> - See you there!</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="163"/> + <location filename="../src/dlgTriggerEditor.cpp" line="164"/> <source>How to add a new trigger from the input line</source> <extracomment>Name of a selectable option for the Trigger intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="168"/> + <location filename="../src/dlgTriggerEditor.cpp" line="169"/> <source>Triggers can also be defined from the input line in the main profile window like this:</source> <extracomment>Part of the Trigger intro - This introductory text will be followed by a Lua code example for a trigger.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="171"/> + <location filename="../src/dlgTriggerEditor.cpp" line="172"/> <source>My drink trigger</source> <extracomment>Part of the Trigger intro, code example for a trigger - This is the name of the trigger which reacts on "You are thirsty" with "drink water".</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="173"/> + <location filename="../src/dlgTriggerEditor.cpp" line="174"/> <source>You are thirsty.</source> <extracomment>Part of the Trigger intro, code example for a trigger - This is the text from game which will be triggered on, and reacted to with "drink water".</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="175"/> + <location filename="../src/dlgTriggerEditor.cpp" line="176"/> <source>drink water</source> <extracomment>Part of the Trigger intro, code example for a trigger - This is the command sent to game after we triggered on text "You are thirsty." from game.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="182"/> + <location filename="../src/dlgTriggerEditor.cpp" line="183"/> <source>Read the <a href='http://wiki.mudlet.org/w/Manual:Introduction#Triggers'>Introduction to Triggers</a> for a detailed overview.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="207"/> + <location filename="../src/dlgTriggerEditor.cpp" line="208"/> <source>Read the <a href='http://wiki.mudlet.org/w/Manual:Introduction#Scripts'>Introduction to Scripts</a> for a detailed overview.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="223"/> + <location filename="../src/dlgTriggerEditor.cpp" line="224"/> <source>How to add a new timer from the input line</source> <extracomment>Name of a selectable option for the Timer intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="230"/> + <location filename="../src/dlgTriggerEditor.cpp" line="231"/> <source>Read the <a href='http://wiki.mudlet.org/w/Manual:Introduction#Timers'>Introduction to Timers</a> for a detailed overview.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="240"/> + <location filename="../src/dlgTriggerEditor.cpp" line="241"/> <source><ol><li>Add a new group to create a <strong>button bar</strong>.</li><li>Add groups as <strong>menus</strong> or sub-menus.</li><li>Add items as <strong>buttons</strong> to a bar or menu.</li><li>Define a <strong>command</strong> or script to execute when pressed.</li><li><strong>Activate</strong> the item. </li></ol><p><strong>Note:</strong> Deactivated items are hidden, including all items they contain.</p><p><strong>Click-down buttons:</strong> Can define separate commands for press/release. Use getButtonState() to check state.</p></source> <extracomment>Help contents of a selectable option for the Button intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="251"/> + <location filename="../src/dlgTriggerEditor.cpp" line="252"/> <source>Read the <a href='http://wiki.mudlet.org/w/Manual:Introduction#Buttons'>Introduction to Buttons</a> for a detailed overview.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="266"/> + <location filename="../src/dlgTriggerEditor.cpp" line="267"/> <source>How to add a new keybinding from the input line</source> <extracomment>Name of a selectable option for the Keys intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="275"/> + <location filename="../src/dlgTriggerEditor.cpp" line="276"/> <source>Read the <a href='http://wiki.mudlet.org/w/Manual:Introduction#Keybindings'>Introduction to Keybindings</a> for a detailed overview.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="292"/> + <location filename="../src/dlgTriggerEditor.cpp" line="293"/> <source>How to add a new variable from the input line</source> <extracomment>Name of a selectable option for the Variable intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="299"/> + <location filename="../src/dlgTriggerEditor.cpp" line="300"/> <source>Read the <a href='http://wiki.mudlet.org/w/Manual:Introduction#Variables'>Introduction to Variables</a> for a detailed overview.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="330"/> + <location filename="../src/dlgTriggerEditor.cpp" line="331"/> <source>package item</source> <extracomment>Accessible description indicating an item belongs to a package, shown after the item name. Keep short, as it's appended to other descriptions like "activated, package item"</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="459"/> - <location filename="../src/dlgTriggerEditor.cpp" line="13184"/> - <location filename="../src/dlgTriggerEditor.cpp" line="13193"/> + <location filename="../src/dlgTriggerEditor.cpp" line="460"/> + <location filename="../src/dlgTriggerEditor.cpp" line="13225"/> + <location filename="../src/dlgTriggerEditor.cpp" line="13234"/> <source>Undo</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="472"/> - <location filename="../src/dlgTriggerEditor.cpp" line="13185"/> - <location filename="../src/dlgTriggerEditor.cpp" line="13194"/> + <location filename="../src/dlgTriggerEditor.cpp" line="473"/> + <location filename="../src/dlgTriggerEditor.cpp" line="13226"/> + <location filename="../src/dlgTriggerEditor.cpp" line="13235"/> <source>Redo</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="486"/> - <location filename="../src/dlgTriggerEditor.cpp" line="1569"/> + <location filename="../src/dlgTriggerEditor.cpp" line="487"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1580"/> <source>Undo: %1 (%2)</source> <extracomment>Tooltip for undo action. %1 is the action being undone (e.g., "Activate trigger "foo""), %2 is the keyboard shortcut</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="491"/> - <location filename="../src/dlgTriggerEditor.cpp" line="1580"/> + <location filename="../src/dlgTriggerEditor.cpp" line="492"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1591"/> <source>Undo (%1)</source> <extracomment>Tooltip for undo action when no specific action. %1 is the keyboard shortcut</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="500"/> - <location filename="../src/dlgTriggerEditor.cpp" line="1574"/> + <location filename="../src/dlgTriggerEditor.cpp" line="501"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1585"/> <source>Redo: %1 (%2)</source> <extracomment>Tooltip for redo action. %1 is the action being redone (e.g., "Activate trigger "foo""), %2 is the keyboard shortcut</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="505"/> - <location filename="../src/dlgTriggerEditor.cpp" line="1583"/> + <location filename="../src/dlgTriggerEditor.cpp" line="506"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1594"/> <source>Redo (%1)</source> <extracomment>Tooltip for redo action when no specific action. %1 is the keyboard shortcut</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="852"/> + <location filename="../src/dlgTriggerEditor.cpp" line="853"/> <source>Show/Hide Debug Console (%1) -> system will be <b><i>slower</i></b>.</source> <extracomment>%1 is a keyboard shortcut, e.g. 'Ctrl+0' on Windows/Linux or '⌘0' on macOS</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="867"/> + <location filename="../src/dlgTriggerEditor.cpp" line="868"/> <source>Add Item</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="965"/> + <location filename="../src/dlgTriggerEditor.cpp" line="966"/> <source>Create Module</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="967"/> + <location filename="../src/dlgTriggerEditor.cpp" line="968"/> <source><p>Create a module from selected items</p></source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="972"/> + <location filename="../src/dlgTriggerEditor.cpp" line="973"/> <source><p>Saves your profile. (%1)</p><p>Saves your entire profile (triggers, aliases, scripts, timers, buttons and keys, but not the map or script-specific settings) to your computer disk, so in case of a computer or program crash, all changes you have done will be retained.</p><p>It also makes a backup of your profile, you can load an older version of it when connecting.</p><p>Should there be any modules that are marked to be "<i>synced</i>" this will also cause them to be saved and reloaded into other profiles if they too are active.</p></source> <extracomment>%1 is a keyboard shortcut, e.g. 'Ctrl+Shift+S' on Windows/Linux or '⌘⇧S' on macOS</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="1258"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1260"/> <source>Whole word</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="1260"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1262"/> <source>Only match whole words</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="1729"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1740"/> <source>Text to find (anywhere in the game output)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="1731"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1742"/> <source>Text to find (as a regular expression pattern)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="1733"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1744"/> <source>Text to find (from beginning of the line)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="1735"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1746"/> <source>Exact line to match</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="1737"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1748"/> <source>Lua code to run (return true to match)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="3928"/> + <location filename="../src/dlgTriggerEditor.cpp" line="3939"/> <source><p>Unable to activate "<tt>%1</tt>": %2</p> <p><i>You will need to reactivate this after the problem has been corrected.</i></p></source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="4035"/> + <location filename="../src/dlgTriggerEditor.cpp" line="4046"/> <source>move items</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="4228"/> + <location filename="../src/dlgTriggerEditor.cpp" line="4239"/> <source><p><b>Unable to activate "<tt>%1</tt>": %2.</b></p> <p><i>You will need to reactivate this after the problem has been corrected.</i></p></source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="4376"/> - <location filename="../src/dlgTriggerEditor.cpp" line="4505"/> - <location filename="../src/dlgTriggerEditor.cpp" line="4668"/> - <location filename="../src/dlgTriggerEditor.cpp" line="4840"/> + <location filename="../src/dlgTriggerEditor.cpp" line="4387"/> + <location filename="../src/dlgTriggerEditor.cpp" line="4516"/> + <location filename="../src/dlgTriggerEditor.cpp" line="4679"/> + <location filename="../src/dlgTriggerEditor.cpp" line="4851"/> <source><p><b>Unable to activate "<tt>%1</tt>"; %2.</b></p> <p><i>You will need to reactivate this after the problem has been corrected.</i></p></source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="5136"/> + <location filename="../src/dlgTriggerEditor.cpp" line="5147"/> <source>table_variable</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="5136"/> + <location filename="../src/dlgTriggerEditor.cpp" line="5147"/> <source>variable_name</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="5767"/> - <location filename="../src/dlgTriggerEditor.cpp" line="7735"/> - <location filename="../src/dlgTriggerEditor.cpp" line="7816"/> - <location filename="../src/dlgTriggerEditor.cpp" line="7899"/> - <location filename="../src/dlgTriggerEditor.cpp" line="8341"/> - <location filename="../src/dlgTriggerEditor.cpp" line="8461"/> - <location filename="../src/dlgTriggerEditor.cpp" line="8549"/> + <location filename="../src/dlgTriggerEditor.cpp" line="5776"/> + <location filename="../src/dlgTriggerEditor.cpp" line="7747"/> + <location filename="../src/dlgTriggerEditor.cpp" line="7828"/> + <location filename="../src/dlgTriggerEditor.cpp" line="7911"/> + <location filename="../src/dlgTriggerEditor.cpp" line="8358"/> + <location filename="../src/dlgTriggerEditor.cpp" line="8478"/> + <location filename="../src/dlgTriggerEditor.cpp" line="8566"/> <source>This item is part of a package. To best preserve your changes, copy this item before editing as package upgrades may overwrite modifications.</source> <extracomment>Package item warning shown in trigger editor when editing package items. Should only be announced to screen readers once per item, not repeatedly on every edit. ---------- @@ -11497,1131 +11603,1135 @@ Package item warning banner shown in trigger editor when selecting package items <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="7513"/> - <location filename="../src/dlgTriggerEditor.cpp" line="7633"/> - <location filename="../src/dlgTriggerEditor.cpp" line="12787"/> + <location filename="../src/dlgTriggerEditor.cpp" line="7525"/> + <location filename="../src/dlgTriggerEditor.cpp" line="7645"/> + <location filename="../src/dlgTriggerEditor.cpp" line="12828"/> <source>Default foreground color</source> <extracomment>Color trigger default foreground color button, ensure all three instances have the same text</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="7517"/> - <location filename="../src/dlgTriggerEditor.cpp" line="7637"/> - <location filename="../src/dlgTriggerEditor.cpp" line="12790"/> + <location filename="../src/dlgTriggerEditor.cpp" line="7529"/> + <location filename="../src/dlgTriggerEditor.cpp" line="7649"/> + <location filename="../src/dlgTriggerEditor.cpp" line="12831"/> <source>Foreground color [ANSI %1]</source> <extracomment>Color trigger ANSI foreground color button, ensure all three instances have the same text</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="7523"/> - <location filename="../src/dlgTriggerEditor.cpp" line="7643"/> - <location filename="../src/dlgTriggerEditor.cpp" line="12847"/> + <location filename="../src/dlgTriggerEditor.cpp" line="7535"/> + <location filename="../src/dlgTriggerEditor.cpp" line="7655"/> + <location filename="../src/dlgTriggerEditor.cpp" line="12888"/> <source>Background color ignored</source> <extracomment>Color trigger ignored background color button, ensure all three instances have the same text</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="7527"/> - <location filename="../src/dlgTriggerEditor.cpp" line="7647"/> - <location filename="../src/dlgTriggerEditor.cpp" line="12850"/> + <location filename="../src/dlgTriggerEditor.cpp" line="7539"/> + <location filename="../src/dlgTriggerEditor.cpp" line="7659"/> + <location filename="../src/dlgTriggerEditor.cpp" line="12891"/> <source>Default background color</source> <extracomment>Color trigger default background color button, ensure all three instances have the same text</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="7531"/> - <location filename="../src/dlgTriggerEditor.cpp" line="7651"/> - <location filename="../src/dlgTriggerEditor.cpp" line="12853"/> + <location filename="../src/dlgTriggerEditor.cpp" line="7543"/> + <location filename="../src/dlgTriggerEditor.cpp" line="7663"/> + <location filename="../src/dlgTriggerEditor.cpp" line="12894"/> <source>Background color [ANSI %1]</source> <extracomment>Color trigger ANSI background color button, ensure all three instances have the same text</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="7712"/> - <location filename="../src/dlgTriggerEditor.cpp" line="7716"/> - <location filename="../src/dlgTriggerEditor.cpp" line="12644"/> - <location filename="../src/dlgTriggerEditor.cpp" line="12688"/> - <location filename="../src/dlgTriggerEditor.cpp" line="13346"/> - <location filename="../src/dlgTriggerEditor.cpp" line="13348"/> + <location filename="../src/dlgTriggerEditor.cpp" line="7724"/> + <location filename="../src/dlgTriggerEditor.cpp" line="7728"/> + <location filename="../src/dlgTriggerEditor.cpp" line="12685"/> + <location filename="../src/dlgTriggerEditor.cpp" line="12729"/> + <location filename="../src/dlgTriggerEditor.cpp" line="13387"/> + <location filename="../src/dlgTriggerEditor.cpp" line="13389"/> <source>keep</source> <extracomment>Keep the existing colour on matches to highlight. Use shortest word possible so it fits on the button</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="7741"/> - <location filename="../src/dlgTriggerEditor.cpp" line="7822"/> - <location filename="../src/dlgTriggerEditor.cpp" line="7905"/> - <location filename="../src/dlgTriggerEditor.cpp" line="8347"/> - <location filename="../src/dlgTriggerEditor.cpp" line="8467"/> - <location filename="../src/dlgTriggerEditor.cpp" line="8555"/> + <location filename="../src/dlgTriggerEditor.cpp" line="7753"/> + <location filename="../src/dlgTriggerEditor.cpp" line="7834"/> + <location filename="../src/dlgTriggerEditor.cpp" line="7917"/> + <location filename="../src/dlgTriggerEditor.cpp" line="8364"/> + <location filename="../src/dlgTriggerEditor.cpp" line="8484"/> + <location filename="../src/dlgTriggerEditor.cpp" line="8572"/> <source>Package item. Copy before editing to preserve changes.</source> <extracomment>First-time educational message for screen reader users about package items</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="8263"/> - <location filename="../src/dlgTriggerEditor.cpp" line="12607"/> + <location filename="../src/dlgTriggerEditor.cpp" line="8278"/> + <location filename="../src/dlgTriggerEditor.cpp" line="12648"/> <source>Command:</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="8303"/> + <location filename="../src/dlgTriggerEditor.cpp" line="8320"/> <source>Menu properties</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="8313"/> + <location filename="../src/dlgTriggerEditor.cpp" line="8330"/> <source>Button properties</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="8321"/> + <location filename="../src/dlgTriggerEditor.cpp" line="8338"/> <source>Command (down);</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="8602"/> + <location filename="../src/dlgTriggerEditor.cpp" line="8619"/> <source>Aliases - Input Triggers</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="8616"/> + <location filename="../src/dlgTriggerEditor.cpp" line="8633"/> <source>Key Bindings</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9841"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9868"/> <source>Add Trigger</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9842"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9869"/> <source>Add new trigger</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9843"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9870"/> <source>Add Trigger Group</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9844"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9871"/> <source>Add new group of triggers</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9845"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9872"/> <source>Delete Trigger</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9846"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9873"/> <source>Delete the selected trigger</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9847"/> - <location filename="../src/dlgTriggerEditor.h" line="587"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9874"/> + <location filename="../src/dlgTriggerEditor.h" line="590"/> <source>Save Trigger</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9852"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9879"/> <source>Add Timer</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9853"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9880"/> <source>Add new timer</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9854"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9881"/> <source>Add Timer Group</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9855"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9882"/> <source>Add new group of timers</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9856"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9883"/> <source>Delete Timer</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9857"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9884"/> <source>Delete the selected timer</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9858"/> - <location filename="../src/dlgTriggerEditor.h" line="588"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9885"/> + <location filename="../src/dlgTriggerEditor.h" line="591"/> <source>Save Timer</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9863"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9890"/> <source>Add Alias</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9864"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9891"/> <source>Add new alias</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9865"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9892"/> <source>Add Alias Group</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9866"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9893"/> <source>Add new group of aliases</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9867"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9894"/> <source>Delete Alias</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9868"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9895"/> <source>Delete the selected alias</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9869"/> - <location filename="../src/dlgTriggerEditor.h" line="589"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9896"/> + <location filename="../src/dlgTriggerEditor.h" line="592"/> <source>Save Alias</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9874"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9901"/> <source>Add Script</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9875"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9902"/> <source>Add new script</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9876"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9903"/> <source>Add Script Group</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9877"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9904"/> <source>Add new group of scripts</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9878"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9905"/> <source>Delete Script</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9879"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9906"/> <source>Delete the selected script</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9880"/> - <location filename="../src/dlgTriggerEditor.h" line="590"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9907"/> + <location filename="../src/dlgTriggerEditor.h" line="593"/> <source>Save Script</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9885"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9912"/> <source>Add Button</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9886"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9913"/> <source>Add new button</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9887"/> - <source>Add Button Group</source> + <location filename="../src/dlgTriggerEditor.cpp" line="9914"/> + <source>Add Toolbar or Menu</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9888"/> - <source>Add new group of buttons</source> + <location filename="../src/dlgTriggerEditor.cpp" line="9915"/> + <source>Add a Toolbar (top level) or Menu (lower levels) to contain menus or buttons</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9889"/> - <source>Delete Button</source> + <location filename="../src/dlgTriggerEditor.cpp" line="9916"/> + <source>Delete Button, Menu or Toolbar</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9890"/> - <source>Delete the selected button</source> + <location filename="../src/dlgTriggerEditor.cpp" line="9917"/> + <source>Delete the selected button, menu or toolbar</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9891"/> - <location filename="../src/dlgTriggerEditor.h" line="591"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9918"/> + <source>Save item</source> + <translation type="unfinished"></translation> + </message> + <message> + <location filename="../src/dlgTriggerEditor.cpp" line="9920"/> + <source>Apply button/menu/toolbar changes (does not save to disk).</source> + <extracomment>Status tip for saving button changes</extracomment> + <translation type="unfinished"></translation> + </message> + <message> + <location filename="../src/dlgTriggerEditor.h" line="594"/> <source>Save Button</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9896"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9923"/> <source>Add Key</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9897"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9924"/> <source>Add new key</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9898"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9925"/> <source>Add Key Group</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9899"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9926"/> <source>Add new group of keys</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9900"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9927"/> <source>Delete Key</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9901"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9928"/> <source>Delete the selected key</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9902"/> - <location filename="../src/dlgTriggerEditor.h" line="592"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9929"/> + <location filename="../src/dlgTriggerEditor.h" line="595"/> <source>Save Key</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9907"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9934"/> <source>Add Variable</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9908"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9935"/> <source>Add new variable</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9909"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9936"/> <source>Add Lua table</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9910"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9937"/> <source>Add new Lua table</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9911"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9938"/> <source>Delete Variable</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9912"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9939"/> <source>Delete the selected variable</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9913"/> - <location filename="../src/dlgTriggerEditor.h" line="593"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9940"/> + <location filename="../src/dlgTriggerEditor.h" line="596"/> <source>Save Variable</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="10705"/> + <location filename="../src/dlgTriggerEditor.cpp" line="10738"/> <source>Central Debug Console</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="10987"/> - <location filename="../src/dlgTriggerEditor.cpp" line="10991"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11011"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11015"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11035"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11039"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11059"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11063"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11083"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11087"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11107"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11112"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11125"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11142"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11189"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11206"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11245"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11262"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11301"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11318"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11357"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11374"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11413"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11430"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11020"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11024"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11044"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11048"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11068"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11072"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11092"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11096"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11116"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11120"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11140"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11145"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11158"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11175"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11222"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11239"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11278"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11295"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11334"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11351"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11390"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11407"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11446"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11463"/> <source>Export Package:</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="10987"/> - <location filename="../src/dlgTriggerEditor.cpp" line="10991"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11011"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11015"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11035"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11039"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11059"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11063"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11083"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11087"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11107"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11112"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11125"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11189"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11245"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11301"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11357"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11413"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11020"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11024"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11044"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11048"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11068"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11072"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11092"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11096"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11116"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11120"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11140"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11145"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11158"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11222"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11278"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11334"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11390"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11446"/> <source>You have to choose an item for export first. Please select a tree item and then click on export again.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="10996"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11020"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11044"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11068"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11092"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11117"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11029"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11053"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11077"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11101"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11125"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11150"/> <source>Package %1 saved</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="11142"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11175"/> <source>No valid triggers found to export.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="11150"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11213"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11269"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11325"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11381"/> - <location filename="../src/dlgTriggerEditor.cpp" line="11437"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11183"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11246"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11302"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11358"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11414"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11470"/> <source>Copied %1 to clipboard</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="11154"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11187"/> <source>Copied %1 triggers to clipboard</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="11206"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11239"/> <source>No valid timers found to export.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="11216"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11249"/> <source>Copied %1 timers to clipboard</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="11262"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11295"/> <source>No valid aliases found to export.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="11272"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11305"/> <source>Copied %1 aliases to clipboard</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="11318"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11351"/> <source>No valid actions found to export.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="11328"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11361"/> <source>Copied %1 actions to clipboard</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="11374"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11407"/> <source>No valid scripts found to export.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="11384"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11417"/> <source>Copied %1 scripts to clipboard</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="11430"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11463"/> <source>No valid keys found to export.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="11440"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11473"/> <source>Copied %1 keys to clipboard</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="11475"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11508"/> <source>Mudlet packages (*.xml)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="11475"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11508"/> <source>Export Item</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="11492"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11525"/> <source>export package:</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="11492"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11525"/> <source>Cannot write file %1: %2.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="11790"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11823"/> <source>Pasted %1 items successfully</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="11810"/> + <location filename="../src/dlgTriggerEditor.cpp" line="11843"/> <source>paste</source> <extracomment>Undo/redo text for pasting items</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="12298"/> + <location filename="../src/dlgTriggerEditor.cpp" line="12331"/> <source>Import Mudlet Package</source> <extracomment>Trigger editor - import packages from file dialog (multi-select enabled) Trigger editor - file filter for supported package types (mpackage, zip, xml)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="12298"/> + <location filename="../src/dlgTriggerEditor.cpp" line="12331"/> <source>Mudlet Packages (*.mpackage *.zip *.xml)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="12341"/> + <location filename="../src/dlgTriggerEditor.cpp" line="12374"/> <source>Failed to import: %1</source> <extracomment>Trigger editor - status message shown when some packages failed to import. %1 is a comma-separated list of package names</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="12423"/> + <location filename="../src/dlgTriggerEditor.cpp" line="12464"/> <source>Couldn't save profile</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="12423"/> + <location filename="../src/dlgTriggerEditor.cpp" line="12464"/> <source>Sorry, couldn't save your profile - got the following error: %1</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="12433"/> + <location filename="../src/dlgTriggerEditor.cpp" line="12474"/> <source>Backup Profile</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="12433"/> + <location filename="../src/dlgTriggerEditor.cpp" line="12474"/> <source>trigger files (*.trigger *.xml)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="12632"/> - <location filename="../src/dlgTriggerEditor.cpp" line="12676"/> + <location filename="../src/dlgTriggerEditor.cpp" line="12673"/> + <location filename="../src/dlgTriggerEditor.cpp" line="12717"/> <source>Keep color</source> <extracomment>Button in the color picker that preserves the existing text color on trigger matches</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="12710"/> + <location filename="../src/dlgTriggerEditor.cpp" line="12751"/> <source>Audio files(*.aac *.mp3 *.mp4a *.oga *.ogg *.pcm *.wav *.wma);;Advanced Audio Coding-stream(*.aac);;MPEG-2 Audio Layer 3(*.mp3);;MPEG-4 Audio(*.mp4a);;Ogg Vorbis(*.oga *.ogg);;PCM Audio(*.pcm);;Wave(*.wav);;Windows Media Audio(*.wma);;All files(*.*)</source> <extracomment>This the list of file extensions that are considered for sounds from triggers, the terms inside of the '('...')' and the ";;" are used programmatically and should not be changed.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="14342"/> + <location filename="../src/dlgTriggerEditor.cpp" line="14399"/> <source>Banner hidden. <a href='undo' style='color: inherit; text-decoration: underline;'>Undo</a> | <a href='hide-permanently' style='color: inherit; text-decoration: underline;'>Hide permanently</a></source> <extracomment>Toast notification shown when user dismisses an editor tip banner. Allows them to undo or permanently hide the tips for this editor view type.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="12603"/> + <location filename="../src/dlgTriggerEditor.cpp" line="12644"/> <source>Command (down):</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9849"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9876"/> <source>Apply trigger changes (does not save to disk).</source> <extracomment>Status tip for saving trigger changes</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9860"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9887"/> <source>Apply timer changes (does not save to disk).</source> <extracomment>Status tip for saving timer changes</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9871"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9898"/> <source>Apply alias changes (does not save to disk).</source> <extracomment>Status tip for saving alias changes</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9882"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9909"/> <source>Apply script changes (does not save to disk).</source> <extracomment>Status tip for saving script changes</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9893"/> - <source>Apply button changes (does not save to disk).</source> - <extracomment>Status tip for saving button changes</extracomment> - <translation type="unfinished"></translation> - </message> - <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9904"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9931"/> <source>Apply key changes (does not save to disk).</source> <extracomment>Status tip for saving key changes</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="9915"/> + <location filename="../src/dlgTriggerEditor.cpp" line="9942"/> <source>Apply variable changes (does not save to disk).</source> <extracomment>Status tip for saving variable changes</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="12625"/> + <location filename="../src/dlgTriggerEditor.cpp" line="12666"/> <source>Select foreground color to apply to matches</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="12669"/> + <location filename="../src/dlgTriggerEditor.cpp" line="12710"/> <source>Select background color to apply to matches</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="12707"/> + <location filename="../src/dlgTriggerEditor.cpp" line="12748"/> <source>Choose sound file</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="12763"/> + <location filename="../src/dlgTriggerEditor.cpp" line="12804"/> <source>Select foreground trigger color for item %1</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="12827"/> + <location filename="../src/dlgTriggerEditor.cpp" line="12868"/> <source>Select background trigger color for item %1</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="12876"/> + <location filename="../src/dlgTriggerEditor.cpp" line="12917"/> <source>Saving…</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="13181"/> + <location filename="../src/dlgTriggerEditor.cpp" line="13222"/> <source>Format All</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="13187"/> - <location filename="../src/dlgTriggerEditor.cpp" line="13196"/> + <location filename="../src/dlgTriggerEditor.cpp" line="13228"/> + <location filename="../src/dlgTriggerEditor.cpp" line="13237"/> <source>Cut</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="13191"/> - <location filename="../src/dlgTriggerEditor.cpp" line="13200"/> + <location filename="../src/dlgTriggerEditor.cpp" line="13232"/> + <location filename="../src/dlgTriggerEditor.cpp" line="13241"/> <source>Select All</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="13362"/> + <location filename="../src/dlgTriggerEditor.cpp" line="13403"/> <source>Sound file to play when the trigger fires.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="1390"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1392"/> <source>substring</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="117"/> + <location filename="../src/dlgTriggerEditor.cpp" line="118"/> <source>Alias react on user input.</source> <extracomment>Headline for the Alias intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="119"/> + <location filename="../src/dlgTriggerEditor.cpp" line="120"/> <source>How to add a new alias now</source> <extracomment>Name of a selectable option for the Alias intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="121"/> + <location filename="../src/dlgTriggerEditor.cpp" line="122"/> <source><ol><li>Click on the 'Add Item' icon above.</li><li>Define an input <strong>pattern</strong> either literally or with a Perl regular expression.</li><li>Define a 'substitution' <strong>command</strong> to send to the game in clear text <strong>instead of the alias pattern</strong>, or write a script for more complicated needs.</li><li><strong>Activate</strong> the alias.</li></ol></source> <extracomment>Help contents of a selectable option for the Alias intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="153"/> + <location filename="../src/dlgTriggerEditor.cpp" line="154"/> <source>Triggers react on game output.</source> <extracomment>Headline for the Trigger intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="155"/> + <location filename="../src/dlgTriggerEditor.cpp" line="156"/> <source>How to add a new trigger now</source> <extracomment>Name of a selectable option for the Trigger intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="157"/> + <location filename="../src/dlgTriggerEditor.cpp" line="158"/> <source><ol><li>Click on the 'Add Item' icon above.</li><li>Define a <strong>pattern</strong> that you want to trigger on.</li><li>Select the appropriate pattern <strong>type</strong>.</li><li>Define a clear text <strong>command</strong> that you want to send to the game if the trigger finds the pattern in the text from the game, or write a script for more complicated needs..</li><li><strong>Activate</strong> the trigger.</li></ol></source> <extracomment>Help contents of a selectable option for the Trigger intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="188"/> + <location filename="../src/dlgTriggerEditor.cpp" line="189"/> <source>Scripts organize code and can react to events.</source> <extracomment>Headline for the Script intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="190"/> + <location filename="../src/dlgTriggerEditor.cpp" line="191"/> <source>How to add a new script now</source> <extracomment>Name of a selectable option for the Script intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="192"/> + <location filename="../src/dlgTriggerEditor.cpp" line="193"/> <source><ol><li>Click on the 'Add Item' icon above.</li><li>Enter a script in the box below. You can for example define <strong>functions</strong> to be called by other triggers, aliases, etc.</li><li>If you write lua <strong>commands</strong> without defining a function, they will be run on Mudlet startup and each time you open the script for editing.</li><li><strong>Activate</strong> the script.</li></ol><p><strong>Note:</strong> Scripts are run automatically when viewed, even if they are deactivated.</p></source> <extracomment>Help contents of a selectable option for the Script intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="198"/> + <location filename="../src/dlgTriggerEditor.cpp" line="199"/> <source>How to have a script react to events</source> <extracomment>Name of a selectable option for the Script intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="200"/> + <location filename="../src/dlgTriggerEditor.cpp" line="201"/> <source><p>You can register a list of <strong>events</strong> with the + and - symbols. If one of these events take place, the function with the same name as the script item itself will be called.</p><p><strong>Note:</strong> Events can also be added to a script from the command line in the main profile window like this:</p><p><code>lua registerAnonymousEventHandler(&quot;nameOfTheMudletEvent&quot;, &quot;nameOfYourFunctionToBeCalled&quot;)</code></p></source> <extracomment>Help contents of a selectable option for the Script intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="213"/> + <location filename="../src/dlgTriggerEditor.cpp" line="214"/> <source>Timers react after a timespan once or regularly.</source> <extracomment>Headline for the Timer intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="215"/> + <location filename="../src/dlgTriggerEditor.cpp" line="216"/> <source>How to add a new timer now</source> <extracomment>Name of a selectable option for the Timer intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="217"/> + <location filename="../src/dlgTriggerEditor.cpp" line="218"/> <source><ol><li>Click on the 'Add Item' icon above.</li><li>Define the <strong>timespan</strong> after which the timer should react in a this format: hours : minutes : seconds.</li><li>Define a clear text <strong>command</strong> that you want to send to the game when the time has passed, or write a script for more complicated needs.</li><li><strong>Activate</strong> the timer.</li></ol><p><strong>Note:</strong> If you want the trigger to react only once and not regularly, use the Lua tempTimer() function instead.</p></source> <extracomment>Help contents of a selectable option for the Timer intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="225"/> + <location filename="../src/dlgTriggerEditor.cpp" line="226"/> <source><p>Timers can also be defined from the input line in the main profile window like this:</p><p><code>lua tempTimer(3, function() echo(&quot;hello! &quot;) end)</code></p><p>This will greet you exactly 3 seconds after it was made.</p></source> <extracomment>Help contents of a selectable option for the Timer intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="236"/> + <location filename="../src/dlgTriggerEditor.cpp" line="237"/> <source>Buttons react on mouse clicks.</source> <extracomment>Headline for the Button intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="238"/> + <location filename="../src/dlgTriggerEditor.cpp" line="239"/> <source>How to add a new button now</source> <extracomment>Name of a selectable option for the Button intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="257"/> + <location filename="../src/dlgTriggerEditor.cpp" line="258"/> <source>Keys react on keyboard presses.</source> <extracomment>Headline for the Keys intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="259"/> + <location filename="../src/dlgTriggerEditor.cpp" line="260"/> <source>How to add a new keybinding now</source> <extracomment>Name of a selectable option for the Keys intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="261"/> + <location filename="../src/dlgTriggerEditor.cpp" line="262"/> <source><ol><li>Click on the 'Add Item' icon above.</li><li>Click on <strong>'grab key'</strong> and then press your key combination, e.g. including modifier keys like Control, Shift, etc.</li><li>Define a clear text <strong>command</strong> that you want to send to the game if the button is pressed, or write a script for more complicated needs.</li><li><strong>Activate</strong> the new key binding.</li></ol></source> <extracomment>Help contents of a selectable option for the Keys intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="268"/> + <location filename="../src/dlgTriggerEditor.cpp" line="269"/> <source><p>Keys can be defined from the input line in the main profile window like this:</p><p><code>lua permKey(&quot;my jump key&quot;, &quot;&quot;, mudlet.key.F8, [[send(&quot;jump&quot;]]) end)</code></p><p>Pressing F8 will make you jump.</p></source> <extracomment>Help contents of a selectable option for the Keys intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="281"/> + <location filename="../src/dlgTriggerEditor.cpp" line="282"/> <source>Variables store information.</source> <extracomment>Headline for the Variable intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="283"/> + <location filename="../src/dlgTriggerEditor.cpp" line="284"/> <source>How to add a new variable now</source> <extracomment>Name of a selectable option for the Variable intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="285"/> + <location filename="../src/dlgTriggerEditor.cpp" line="286"/> <source><ol><li>Click on the 'Add Item' icon above. To add a table instead click 'Add Group'.</li><li>Select type of variable value (can be a string, integer, boolean)</li><li>Enter the value you want to store in this variable.</li><li>If you want to keep the variable in your next Mudlet sessions, check the checkbox in the list of variables to the left.</li><li>To remove a variable manually, set it to 'nil' or click on the 'Delete' icon above.</li></ol><p><strong>Note:</strong> Variables created here won't be saved when Mudlet shuts down unless you check their checkbox in the list of variables to the left. You could also create scripts with the variables instead.</p></source> <extracomment>Help contents of a selectable option for the Variable intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="294"/> + <location filename="../src/dlgTriggerEditor.cpp" line="295"/> <source><p>Variables and tables can also be defined from the input line in the main profile window like this:</p><p><code>lua foo = &quot;bar&quot;</code></p><p>This will create a string called 'foo' with 'bar' as its value.</p></source> <extracomment>Help contents of a selectable option for the Variable intro</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="306"/> + <location filename="../src/dlgTriggerEditor.cpp" line="307"/> <source>activated</source> <extracomment>Item is currently on, short enough to be spoken</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="308"/> + <location filename="../src/dlgTriggerEditor.cpp" line="309"/> <source>deactivated</source> <extracomment>Item is currently off, short enough to be spoken</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="310"/> + <location filename="../src/dlgTriggerEditor.cpp" line="311"/> <source>activated folder</source> <extracomment>Folder is currently turned on</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="312"/> + <location filename="../src/dlgTriggerEditor.cpp" line="313"/> <source>deactivated folder</source> <extracomment>Folder is currently turned off</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="314"/> + <location filename="../src/dlgTriggerEditor.cpp" line="315"/> <source>deactivated due to error</source> <extracomment>Item is currently inactive because of errors, short enough to be spoken</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="316"/> + <location filename="../src/dlgTriggerEditor.cpp" line="317"/> <source>%1 in a deactivated group</source> <extracomment>Item is currently turned on individually, but is member of an inactive group</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="318"/> + <location filename="../src/dlgTriggerEditor.cpp" line="319"/> <source>activated filter chain</source> <extracomment>A trigger that unlocks other triggers is currently turned on, short enough to be spoken</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="320"/> + <location filename="../src/dlgTriggerEditor.cpp" line="321"/> <source>deactivated filter chain</source> <extracomment>A trigger that unlocks other triggers is currently turned off, short enough to be spoken</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="322"/> + <location filename="../src/dlgTriggerEditor.cpp" line="323"/> <source>activated offset timer</source> <extracomment>A timer that starts after another timer is currently turned on</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="324"/> + <location filename="../src/dlgTriggerEditor.cpp" line="325"/> <source>deactivated offset timer</source> <extracomment>A timer that starts after another timer is currently turned off</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="401"/> + <location filename="../src/dlgTriggerEditor.cpp" line="402"/> <source>-- add your Lua code here</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="838"/> - <location filename="../src/dlgTriggerEditor.h" line="602"/> + <location filename="../src/dlgTriggerEditor.cpp" line="839"/> + <location filename="../src/dlgTriggerEditor.h" line="605"/> <source>Errors</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="839"/> + <location filename="../src/dlgTriggerEditor.cpp" line="840"/> <source>Show/Hide the errors console in the bottom right of this editor.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="840"/> + <location filename="../src/dlgTriggerEditor.cpp" line="841"/> <source>Show/Hide errors console</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="844"/> + <location filename="../src/dlgTriggerEditor.cpp" line="845"/> <source>Generate a statistics summary display on the main profile console.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="845"/> + <location filename="../src/dlgTriggerEditor.cpp" line="846"/> <source>Generate statistics</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="849"/> + <location filename="../src/dlgTriggerEditor.cpp" line="850"/> <source>Show/Hide the separate Central Debug Console - when being displayed the system will be slower.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="984"/> + <location filename="../src/dlgTriggerEditor.cpp" line="985"/> <source>Save profile (triggers, aliases, scripts, timers, buttons, keys - not the map) and synchronize modules.</source> <extracomment>Status tip for saving profile</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="1248"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1250"/> <source>Match case precisely</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="1252"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1254"/> <source>Include variables</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="1254"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1256"/> <source>Search variables (slower)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="1306"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1308"/> <source>Type</source> <extracomment>Heading for the first column of the search results</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="1310"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1312"/> <source>Where</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="1312"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1314"/> <source>What</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="1390"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1392"/> <source>perl regex</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="1390"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1392"/> <source>exact match</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="1390"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1392"/> <source>lua function</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="1390"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1392"/> <source>line spacer</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="1390"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1392"/> <source>color trigger</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="1390"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1392"/> <source>prompt</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="2804"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2813"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2838"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2853"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2815"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2824"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2849"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2864"/> <source>Trigger</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="1308"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2435"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2485"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2519"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2603"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2691"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2745"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2804"/> + <location filename="../src/dlgTriggerEditor.cpp" line="1310"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2446"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2496"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2530"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2614"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2702"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2756"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2815"/> <source>Name</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="2494"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2499"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2528"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2533"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2612"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2617"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2754"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2759"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2813"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2818"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2505"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2510"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2539"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2544"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2623"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2628"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2765"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2770"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2824"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2829"/> <source>Command</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="2838"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2843"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2849"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2854"/> <source>Pattern {%1}</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="2569"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2574"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2580"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2585"/> <source>Lua code (%1:%2)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="2745"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2754"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2770"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2783"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2756"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2765"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2781"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2794"/> <source>Alias</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="2770"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2775"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2781"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2786"/> <source>Pattern</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="2691"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2709"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2724"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2702"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2720"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2735"/> <source>Script</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="2709"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2714"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2720"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2725"/> <source>Event Handler</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="2603"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2612"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2629"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2655"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2670"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2614"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2623"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2640"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2666"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2681"/> <source>Button</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="882"/> + <location filename="../src/dlgTriggerEditor.cpp" line="883"/> <source>Add Group (%1)</source> <extracomment>%1 is a keyboard shortcut, e.g. 'Ctrl+Shift+N' on Windows/Linux or '⌘⇧N' on macOS</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="892"/> + <location filename="../src/dlgTriggerEditor.cpp" line="893"/> <source><p>Saves the selected item. (%1)</p><p>Saving causes any changes to the item to take effect. It will not save to disk, so changes will be lost in case of a computer/program crash (but Save Profile to the right will be secure.)</p></source> <extracomment>%1 is a keyboard shortcut, e.g. 'Ctrl+S' on Windows/Linux or '⌘S' on macOS</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="2612"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2617"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2623"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2628"/> <source>Command {Down}</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="2629"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2634"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2640"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2645"/> <source>Command {Up}</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="2655"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2660"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2666"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2671"/> <source>Stylesheet {L: %1 C: %2}</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="2485"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2494"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2507"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2496"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2505"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2518"/> <source>Timer</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="2519"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2528"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2541"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2530"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2539"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2552"/> <source>Key</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="2435"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2449"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2446"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2460"/> <source>Variable</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.cpp" line="2449"/> - <location filename="../src/dlgTriggerEditor.cpp" line="2455"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2460"/> + <location filename="../src/dlgTriggerEditor.cpp" line="2466"/> <source>Value</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/dlgTriggerEditor.h" line="586"/> + <location filename="../src/dlgTriggerEditor.h" line="589"/> <source>Save Item</source> <translation type="unfinished"></translation> </message> @@ -13645,1018 +13755,1018 @@ There is NO WARRANTY, to the extent permitted by law.</source> <context> <name>mudlet</name> <message> - <location filename="../src/mudlet.cpp" line="998"/> + <location filename="../src/mudlet.cpp" line="1001"/> <source>Afrikaans</source> <extracomment>In the translation source texts the language is the leading term, with, generally, the (primary) country(ies) in the brackets, with a trailing language disabiguation after a '-' Chinese is an exception!</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="999"/> + <location filename="../src/mudlet.cpp" line="1002"/> <source>Afrikaans (South Africa)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1000"/> + <location filename="../src/mudlet.cpp" line="1003"/> <source>Aragonese</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1001"/> + <location filename="../src/mudlet.cpp" line="1004"/> <source>Aragonese (Spain)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1002"/> + <location filename="../src/mudlet.cpp" line="1005"/> <source>Arabic</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1003"/> + <location filename="../src/mudlet.cpp" line="1006"/> <source>Arabic (United Arab Emirates)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1004"/> + <location filename="../src/mudlet.cpp" line="1007"/> <source>Arabic (Bahrain)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1005"/> + <location filename="../src/mudlet.cpp" line="1008"/> <source>Arabic (Algeria)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1007"/> + <location filename="../src/mudlet.cpp" line="1010"/> <source>Arabic (India)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1008"/> + <location filename="../src/mudlet.cpp" line="1011"/> <source>Arabic (Iraq)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1009"/> + <location filename="../src/mudlet.cpp" line="1012"/> <source>Arabic (Jordan)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1010"/> + <location filename="../src/mudlet.cpp" line="1013"/> <source>Arabic (Kuwait)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1011"/> + <location filename="../src/mudlet.cpp" line="1014"/> <source>Arabic (Lebanon)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1012"/> + <location filename="../src/mudlet.cpp" line="1015"/> <source>Arabic (Libya)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1013"/> + <location filename="../src/mudlet.cpp" line="1016"/> <source>Arabic (Morocco)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1014"/> + <location filename="../src/mudlet.cpp" line="1017"/> <source>Arabic (Oman)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1015"/> + <location filename="../src/mudlet.cpp" line="1018"/> <source>Arabic (Qatar)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1016"/> + <location filename="../src/mudlet.cpp" line="1019"/> <source>Arabic (Saudi Arabia)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1017"/> + <location filename="../src/mudlet.cpp" line="1020"/> <source>Arabic (Sudan)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1018"/> + <location filename="../src/mudlet.cpp" line="1021"/> <source>Arabic (Syria)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1019"/> + <location filename="../src/mudlet.cpp" line="1022"/> <source>Arabic (Tunisia)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1020"/> + <location filename="../src/mudlet.cpp" line="1023"/> <source>Arabic (Yemen)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1021"/> + <location filename="../src/mudlet.cpp" line="1024"/> <source>Belarusian</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1022"/> + <location filename="../src/mudlet.cpp" line="1025"/> <source>Belarusian (Belarus)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1023"/> + <location filename="../src/mudlet.cpp" line="1026"/> <source>Belarusian (Russia)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1024"/> + <location filename="../src/mudlet.cpp" line="1027"/> <source>Bulgarian</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1025"/> + <location filename="../src/mudlet.cpp" line="1028"/> <source>Bulgarian (Bulgaria)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1026"/> + <location filename="../src/mudlet.cpp" line="1029"/> <source>Bangla</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1027"/> + <location filename="../src/mudlet.cpp" line="1030"/> <source>Bangla (Bangladesh)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1028"/> + <location filename="../src/mudlet.cpp" line="1031"/> <source>Bangla (India)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1029"/> + <location filename="../src/mudlet.cpp" line="1032"/> <source>Tibetan</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1031"/> + <location filename="../src/mudlet.cpp" line="1034"/> <source>Tibetan (China)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1032"/> + <location filename="../src/mudlet.cpp" line="1035"/> <source>Tibetan (India)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1033"/> + <location filename="../src/mudlet.cpp" line="1036"/> <source>Breton</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1034"/> + <location filename="../src/mudlet.cpp" line="1037"/> <source>Breton (France)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1035"/> + <location filename="../src/mudlet.cpp" line="1038"/> <source>Bosnian</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1036"/> + <location filename="../src/mudlet.cpp" line="1039"/> <source>Bosnian (Bosnia/Herzegovina)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1037"/> + <location filename="../src/mudlet.cpp" line="1040"/> <source>Bosnian (Bosnia/Herzegovina - Cyrillic alphabet)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1038"/> + <location filename="../src/mudlet.cpp" line="1041"/> <source>Catalan</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1039"/> + <location filename="../src/mudlet.cpp" line="1042"/> <source>Catalan (Spain)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1040"/> + <location filename="../src/mudlet.cpp" line="1043"/> <source>Catalan (Spain - Valencian)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1041"/> + <location filename="../src/mudlet.cpp" line="1044"/> <source>Central Kurdish</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1042"/> + <location filename="../src/mudlet.cpp" line="1045"/> <source>Central Kurdish (Iraq)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1043"/> + <location filename="../src/mudlet.cpp" line="1046"/> <source>Czech</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1044"/> + <location filename="../src/mudlet.cpp" line="1047"/> <source>Czech (Czechia)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1047"/> + <location filename="../src/mudlet.cpp" line="1050"/> <source>Danish</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1048"/> + <location filename="../src/mudlet.cpp" line="1051"/> <source>Danish (Denmark)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1049"/> + <location filename="../src/mudlet.cpp" line="1052"/> <source>German</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1050"/> + <location filename="../src/mudlet.cpp" line="1053"/> <source>German (Austria)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1051"/> + <location filename="../src/mudlet.cpp" line="1054"/> <source>German (Austria, revised by F M Baumann)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1052"/> + <location filename="../src/mudlet.cpp" line="1055"/> <source>German (Belgium)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1053"/> + <location filename="../src/mudlet.cpp" line="1056"/> <source>German (Switzerland)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1054"/> + <location filename="../src/mudlet.cpp" line="1057"/> <source>German (Switzerland, revised by F M Baumann)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1055"/> + <location filename="../src/mudlet.cpp" line="1058"/> <source>German (Germany/Belgium/Luxemburg)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1056"/> + <location filename="../src/mudlet.cpp" line="1059"/> <source>German (Germany/Belgium/Luxemburg, revised by F M Baumann)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1057"/> + <location filename="../src/mudlet.cpp" line="1060"/> <source>German (Liechtenstein)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1058"/> + <location filename="../src/mudlet.cpp" line="1061"/> <source>German (Luxembourg)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1061"/> + <location filename="../src/mudlet.cpp" line="1064"/> <source>Greek</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1062"/> + <location filename="../src/mudlet.cpp" line="1065"/> <source>Greek (Greece)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1063"/> + <location filename="../src/mudlet.cpp" line="1066"/> <source>English</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1064"/> + <location filename="../src/mudlet.cpp" line="1067"/> <source>English (Antigua/Barbuda)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1065"/> + <location filename="../src/mudlet.cpp" line="1068"/> <source>English (Australia)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1067"/> + <location filename="../src/mudlet.cpp" line="1070"/> <source>English (Bahamas)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1068"/> + <location filename="../src/mudlet.cpp" line="1071"/> <source>English (Botswana)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1069"/> + <location filename="../src/mudlet.cpp" line="1072"/> <source>English (Belize)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1006"/> + <location filename="../src/mudlet.cpp" line="1009"/> <source>Arabic (Egypt)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="311"/> - <location filename="../src/mudlet.cpp" line="313"/> - <location filename="../src/mudlet.cpp" line="726"/> + <location filename="../src/mudlet.cpp" line="314"/> + <location filename="../src/mudlet.cpp" line="316"/> + <location filename="../src/mudlet.cpp" line="729"/> <source>Close profile</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="316"/> - <location filename="../src/mudlet.cpp" line="318"/> + <location filename="../src/mudlet.cpp" line="319"/> + <location filename="../src/mudlet.cpp" line="321"/> <source>Close Mudlet</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="372"/> + <location filename="../src/mudlet.cpp" line="375"/> <source>Mute</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="379"/> - <location filename="../src/mudlet.cpp" line="381"/> - <location filename="../src/mudlet.cpp" line="722"/> - <location filename="../src/mudlet.cpp" line="5166"/> - <location filename="../src/mudlet.cpp" line="5169"/> + <location filename="../src/mudlet.cpp" line="382"/> + <location filename="../src/mudlet.cpp" line="384"/> + <location filename="../src/mudlet.cpp" line="725"/> + <location filename="../src/mudlet.cpp" line="5238"/> + <location filename="../src/mudlet.cpp" line="5241"/> <source>Mute all media</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="385"/> - <location filename="../src/mudlet.cpp" line="387"/> - <location filename="../src/mudlet.cpp" line="5201"/> + <location filename="../src/mudlet.cpp" line="388"/> + <location filename="../src/mudlet.cpp" line="390"/> + <location filename="../src/mudlet.cpp" line="5273"/> <source>Mute sounds from Mudlet (triggers, scripts, etc.)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="414"/> + <location filename="../src/mudlet.cpp" line="417"/> <source>Mudlet chat</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="415"/> + <location filename="../src/mudlet.cpp" line="418"/> <source>Open a link to the Mudlet server on Discord</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="453"/> + <location filename="../src/mudlet.cpp" line="456"/> <source>Show Main Toolbar</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="509"/> + <location filename="../src/mudlet.cpp" line="512"/> <source>Report issue</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="514"/> + <location filename="../src/mudlet.cpp" line="517"/> <source>Report bugs in the public test build to help us improve Mudlet.</source> <extracomment>Tooltip for Report Issue button in public test builds</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="523"/> - <location filename="../src/mudlet.cpp" line="5984"/> + <location filename="../src/mudlet.cpp" line="526"/> + <location filename="../src/mudlet.cpp" line="6056"/> <source>About Mudlet version, creators, and license.</source> <extracomment>Tooltip for About Mudlet sub-menu item and main toolbar button (or menu item if an update has changed that control to have a popup menu instead) (Used in multiple places - please ensure all have the same translation).</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="533"/> + <location filename="../src/mudlet.cpp" line="536"/> <source>Full Screen</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="714"/> + <location filename="../src/mudlet.cpp" line="717"/> <source>Script editor</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="715"/> + <location filename="../src/mudlet.cpp" line="718"/> <source>Show Map</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="716"/> + <location filename="../src/mudlet.cpp" line="719"/> <source>Compact input line</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="717"/> + <location filename="../src/mudlet.cpp" line="720"/> <source>Preferences</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="719"/> + <location filename="../src/mudlet.cpp" line="722"/> <source>Package manager</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="720"/> + <location filename="../src/mudlet.cpp" line="723"/> <source>Module manager</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="723"/> + <location filename="../src/mudlet.cpp" line="726"/> <source>Play</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="727"/> + <location filename="../src/mudlet.cpp" line="730"/> <source>Toggle Time Stamps</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="728"/> + <location filename="../src/mudlet.cpp" line="731"/> <source>Toggle Replay</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="729"/> + <location filename="../src/mudlet.cpp" line="732"/> <source>Toggle Logging</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="730"/> + <location filename="../src/mudlet.cpp" line="733"/> <source>Toggle Emergency Stop</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="731"/> + <location filename="../src/mudlet.cpp" line="734"/> <source>Next profile</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="732"/> + <location filename="../src/mudlet.cpp" line="735"/> <source>Previous profile</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="735"/> + <location filename="../src/mudlet.cpp" line="738"/> <source>Switch to profile %1</source> <extracomment>Name of the keyboard shortcut that switches to the numbered profile tab, %1 is that number (1 to 9)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1030"/> + <location filename="../src/mudlet.cpp" line="1033"/> <source>Tibetan (Bhutan)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1045"/> + <location filename="../src/mudlet.cpp" line="1048"/> <source>Welsh</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1046"/> + <location filename="../src/mudlet.cpp" line="1049"/> <source>Welsh (United Kingdom {Wales})</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1059"/> + <location filename="../src/mudlet.cpp" line="1062"/> <source>Dzongkha</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1060"/> + <location filename="../src/mudlet.cpp" line="1063"/> <source>Dzongkha (Bhutan)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1066"/> + <location filename="../src/mudlet.cpp" line="1069"/> <source>English (Australia, Large)</source> <comment>This dictionary contains larger vocabulary.</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1070"/> + <location filename="../src/mudlet.cpp" line="1073"/> <source>English (Canada)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1071"/> + <location filename="../src/mudlet.cpp" line="1074"/> <source>English (Canada, Large)</source> <comment>This dictionary contains larger vocabulary.</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1072"/> + <location filename="../src/mudlet.cpp" line="1075"/> <source>English (Denmark)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1073"/> + <location filename="../src/mudlet.cpp" line="1076"/> <source>English (United Kingdom)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1074"/> + <location filename="../src/mudlet.cpp" line="1077"/> <source>English (United Kingdom, Large)</source> <comment>This dictionary contains larger vocabulary.</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1075"/> + <location filename="../src/mudlet.cpp" line="1078"/> <source>English (United Kingdom - 'ise' not 'ize')</source> <comment>This dictionary prefers the British 'ise' form over the American 'ize' one.</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1076"/> + <location filename="../src/mudlet.cpp" line="1079"/> <source>English (Ghana)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1077"/> + <location filename="../src/mudlet.cpp" line="1080"/> <source>English (Hong Kong SAR China)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1078"/> + <location filename="../src/mudlet.cpp" line="1081"/> <source>English (Ireland)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1079"/> + <location filename="../src/mudlet.cpp" line="1082"/> <source>English (India)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1080"/> + <location filename="../src/mudlet.cpp" line="1083"/> <source>English (Jamaica)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1081"/> + <location filename="../src/mudlet.cpp" line="1084"/> <source>English (Namibia)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1082"/> + <location filename="../src/mudlet.cpp" line="1085"/> <source>English (Nigeria)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1083"/> + <location filename="../src/mudlet.cpp" line="1086"/> <source>English (New Zealand)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1084"/> + <location filename="../src/mudlet.cpp" line="1087"/> <source>English (Philippines)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1085"/> + <location filename="../src/mudlet.cpp" line="1088"/> <source>English (Singapore)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1086"/> + <location filename="../src/mudlet.cpp" line="1089"/> <source>English (Trinidad/Tobago)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1087"/> + <location filename="../src/mudlet.cpp" line="1090"/> <source>English (United States)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1088"/> + <location filename="../src/mudlet.cpp" line="1091"/> <source>English (United States, Large)</source> <comment>This dictionary contains larger vocabulary.</comment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1089"/> + <location filename="../src/mudlet.cpp" line="1092"/> <source>English (South Africa)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1090"/> + <location filename="../src/mudlet.cpp" line="1093"/> <source>English (Zimbabwe)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1091"/> + <location filename="../src/mudlet.cpp" line="1094"/> <source>Esperanto</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1092"/> + <location filename="../src/mudlet.cpp" line="1095"/> <source>Spanish</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1093"/> + <location filename="../src/mudlet.cpp" line="1096"/> <source>Spanish (Argentina)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1094"/> + <location filename="../src/mudlet.cpp" line="1097"/> <source>Spanish (Bolivia)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1095"/> + <location filename="../src/mudlet.cpp" line="1098"/> <source>Spanish (Chile)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1096"/> + <location filename="../src/mudlet.cpp" line="1099"/> <source>Spanish (Colombia)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1097"/> + <location filename="../src/mudlet.cpp" line="1100"/> <source>Spanish (Costa Rica)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1098"/> + <location filename="../src/mudlet.cpp" line="1101"/> <source>Spanish (Cuba)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1099"/> + <location filename="../src/mudlet.cpp" line="1102"/> <source>Spanish (Dominican Republic)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1100"/> + <location filename="../src/mudlet.cpp" line="1103"/> <source>Spanish (Ecuador)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1101"/> + <location filename="../src/mudlet.cpp" line="1104"/> <source>Spanish (Spain)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1102"/> + <location filename="../src/mudlet.cpp" line="1105"/> <source>Spanish (Guatemala)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1103"/> + <location filename="../src/mudlet.cpp" line="1106"/> <source>Spanish (Honduras)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1104"/> + <location filename="../src/mudlet.cpp" line="1107"/> <source>Spanish (Mexico)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1105"/> + <location filename="../src/mudlet.cpp" line="1108"/> <source>Spanish (Nicaragua)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1106"/> + <location filename="../src/mudlet.cpp" line="1109"/> <source>Spanish (Panama)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1107"/> + <location filename="../src/mudlet.cpp" line="1110"/> <source>Spanish (Peru)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1108"/> + <location filename="../src/mudlet.cpp" line="1111"/> <source>Spanish (Puerto Rico)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1109"/> + <location filename="../src/mudlet.cpp" line="1112"/> <source>Spanish (Paraguay)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1110"/> + <location filename="../src/mudlet.cpp" line="1113"/> <source>Spanish (El Savador)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1111"/> + <location filename="../src/mudlet.cpp" line="1114"/> <source>Spanish (United States)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1112"/> + <location filename="../src/mudlet.cpp" line="1115"/> <source>Spanish (Uruguay)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1113"/> + <location filename="../src/mudlet.cpp" line="1116"/> <source>Spanish (Venezuela)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1114"/> + <location filename="../src/mudlet.cpp" line="1117"/> <source>Estonian</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1115"/> + <location filename="../src/mudlet.cpp" line="1118"/> <source>Estonian (Estonia)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1116"/> + <location filename="../src/mudlet.cpp" line="1119"/> <source>Basque</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1117"/> + <location filename="../src/mudlet.cpp" line="1120"/> <source>Basque (Spain)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1118"/> + <location filename="../src/mudlet.cpp" line="1121"/> <source>Basque (France)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1119"/> - <location filename="../src/mudlet.cpp" line="1120"/> + <location filename="../src/mudlet.cpp" line="1122"/> + <location filename="../src/mudlet.cpp" line="1123"/> <source>Finnish</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1121"/> + <location filename="../src/mudlet.cpp" line="1124"/> <source>Faroese</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1122"/> + <location filename="../src/mudlet.cpp" line="1125"/> <source>Faroese (Faroe Islands)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1123"/> - <location filename="../src/mudlet.cpp" line="1127"/> + <location filename="../src/mudlet.cpp" line="1126"/> + <location filename="../src/mudlet.cpp" line="1130"/> <source>French</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1128"/> + <location filename="../src/mudlet.cpp" line="1131"/> <source>French (Belgium)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1129"/> + <location filename="../src/mudlet.cpp" line="1132"/> <source>French (Catalan)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1130"/> + <location filename="../src/mudlet.cpp" line="1133"/> <source>French (Switzerland)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1131"/> + <location filename="../src/mudlet.cpp" line="1134"/> <source>French (France)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1132"/> + <location filename="../src/mudlet.cpp" line="1135"/> <source>French (Luxemburg)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1133"/> + <location filename="../src/mudlet.cpp" line="1136"/> <source>French (Monaco)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1134"/> + <location filename="../src/mudlet.cpp" line="1137"/> <source>Irish</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1135"/> + <location filename="../src/mudlet.cpp" line="1138"/> <source>Gaelic</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1136"/> + <location filename="../src/mudlet.cpp" line="1139"/> <source>Gaelic (United Kingdom {Scots})</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1137"/> + <location filename="../src/mudlet.cpp" line="1140"/> <source>Galician</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1138"/> + <location filename="../src/mudlet.cpp" line="1141"/> <source>Galician (Spain)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1139"/> - <location filename="../src/mudlet.cpp" line="1144"/> + <location filename="../src/mudlet.cpp" line="1142"/> + <location filename="../src/mudlet.cpp" line="1147"/> <source>Guarani</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1140"/> - <location filename="../src/mudlet.cpp" line="1145"/> + <location filename="../src/mudlet.cpp" line="1143"/> + <location filename="../src/mudlet.cpp" line="1148"/> <source>Guarani (Paraguay)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1141"/> + <location filename="../src/mudlet.cpp" line="1144"/> <source>Gujarati</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1142"/> + <location filename="../src/mudlet.cpp" line="1145"/> <source>Gujarati (India)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1146"/> + <location filename="../src/mudlet.cpp" line="1149"/> <source>Hebrew</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1147"/> + <location filename="../src/mudlet.cpp" line="1150"/> <source>Hebrew (Israel)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1148"/> + <location filename="../src/mudlet.cpp" line="1151"/> <source>Hindi</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1149"/> + <location filename="../src/mudlet.cpp" line="1152"/> <source>Hindi (India)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1150"/> + <location filename="../src/mudlet.cpp" line="1153"/> <source>Croatian</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1151"/> + <location filename="../src/mudlet.cpp" line="1154"/> <source>Croatian (Croatia)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1152"/> + <location filename="../src/mudlet.cpp" line="1155"/> <source>Hungarian</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1153"/> + <location filename="../src/mudlet.cpp" line="1156"/> <source>Hungarian (Hungary)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1154"/> + <location filename="../src/mudlet.cpp" line="1157"/> <source>Armenian</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1155"/> + <location filename="../src/mudlet.cpp" line="1158"/> <source>Armenian (Armenia)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1156"/> + <location filename="../src/mudlet.cpp" line="1159"/> <source>Indonesian</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1157"/> + <location filename="../src/mudlet.cpp" line="1160"/> <source>Indonesian (Indonesia)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1185"/> + <location filename="../src/mudlet.cpp" line="1188"/> <source>Mongolian</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1186"/> + <location filename="../src/mudlet.cpp" line="1189"/> <source>Mongolian (Mongolia)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1251"/> + <location filename="../src/mudlet.cpp" line="1254"/> <source>Tagalog</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1354"/> - <location filename="../src/mudlet.cpp" line="1356"/> + <location filename="../src/mudlet.cpp" line="1357"/> + <location filename="../src/mudlet.cpp" line="1359"/> <source>Medievia {Custom codec for that MUD}</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1380"/> + <location filename="../src/mudlet.cpp" line="1383"/> <source>hh:mm:ss.zzz </source> <extracomment>This represents the format of the timestamps shown alongside the texts in a console and might require translation for a few locales; the content is as per QDateTime::toString(...) and needs to follow the rules for that function as well as being suitable for the translation locale.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1384"/> + <location filename="../src/mudlet.cpp" line="1387"/> <source>------------ </source> <extracomment>This represents the format of the timestamps shown for lines that do not have a timestamp in a console that is showing them. If localised this should be set to the same format and length as the smTimeStampFormat:</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1860"/> + <location filename="../src/mudlet.cpp" line="1863"/> <source>%1 (Main Window)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1887"/> + <location filename="../src/mudlet.cpp" line="1890"/> <source>%1 (Detached)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="2303"/> + <location filename="../src/mudlet.cpp" line="2375"/> <source>Switch games with the keyboard</source> <extracomment>Title of a balloon pointing out the newly added profile tab switching shortcuts</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="2305"/> + <location filename="../src/mudlet.cpp" line="2377"/> <source>Press %1 to cycle through your open games, or %2 to %3 to jump straight to one. You can change these keys in the preferences.</source> <extracomment>%1, %2 and %3 are keyboard shortcuts, e.g. Ctrl+Tab, Ctrl+1 and Ctrl+9 (Control-Tab, Command-1 and Command-9 on macOS)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="4239"/> + <location filename="../src/mudlet.cpp" line="4311"/> <source>Map - %1</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="5030"/> + <location filename="../src/mudlet.cpp" line="5102"/> <source>[ CHAT ] - Auto-starting MMCP Server on port %1.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="5166"/> - <location filename="../src/mudlet.cpp" line="5169"/> + <location filename="../src/mudlet.cpp" line="5238"/> + <location filename="../src/mudlet.cpp" line="5241"/> <source>Unmute all media</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="5186"/> + <location filename="../src/mudlet.cpp" line="5258"/> <source>[ INFO ] - Mudlet and game sounds are muted. Use "%1" to unmute.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="5187"/> + <location filename="../src/mudlet.cpp" line="5259"/> <source>[ INFO ] - Mudlet and game sounds are unmuted. Use "%1" to mute.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="5255"/> + <location filename="../src/mudlet.cpp" line="5327"/> <source>[ INFO ] - Compact input line set. Press "%1" to show bottom-right buttons again.</source> <extracomment>Here %1 will be replaced with the keyboard shortcut, default is ALT+L.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="5375"/> + <location filename="../src/mudlet.cpp" line="5447"/> <source>Detach Tab "%1"</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="5397"/> + <location filename="../src/mudlet.cpp" line="5469"/> <source>Show Connection Indicators on Tabs</source> <translation type="unfinished"></translation> </message> <message numerus="yes"> - <location filename="../src/mudlet.cpp" line="5996"/> + <location filename="../src/mudlet.cpp" line="6068"/> <source><p>About Mudlet</p><p><i>%n update(s) is/are now available!</i><p></source> <extracomment>This is the tooltip text for the 'About' Mudlet main toolbar button when it has been changed by adding a menu which now contains the original 'About Mudlet' action and a new one to access the manual update process</extracomment> <translation type="unfinished"> @@ -14664,7 +14774,7 @@ There is NO WARRANTY, to the extent permitted by law.</source> </translation> </message> <message numerus="yes"> - <location filename="../src/mudlet.cpp" line="6014"/> + <location filename="../src/mudlet.cpp" line="6086"/> <source>Review %n update(s)...</source> <extracomment>Review update(s) menu item, %n is the count of how many updates are available</extracomment> <translation type="unfinished"> @@ -14672,7 +14782,7 @@ There is NO WARRANTY, to the extent permitted by law.</source> </translation> </message> <message numerus="yes"> - <location filename="../src/mudlet.cpp" line="6016"/> + <location filename="../src/mudlet.cpp" line="6088"/> <source>Review the update(s) available...</source> <extracomment>Tool-tip for review update(s) menu item, given that the count of how many updates are available is already shown in the menu, the %n parameter that is that number need not be used here</extracomment> <translation type="unfinished"> @@ -14680,853 +14790,853 @@ There is NO WARRANTY, to the extent permitted by law.</source> </translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1160"/> + <location filename="../src/mudlet.cpp" line="1163"/> <source>Icelandic</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="391"/> - <location filename="../src/mudlet.cpp" line="393"/> - <location filename="../src/mudlet.cpp" line="5206"/> + <location filename="../src/mudlet.cpp" line="394"/> + <location filename="../src/mudlet.cpp" line="396"/> + <location filename="../src/mudlet.cpp" line="5278"/> <source>Mute sounds from the game (MCMP, MSP)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1161"/> + <location filename="../src/mudlet.cpp" line="1164"/> <source>Icelandic (Iceland)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1162"/> + <location filename="../src/mudlet.cpp" line="1165"/> <source>Italian</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1163"/> + <location filename="../src/mudlet.cpp" line="1166"/> <source>Italian (Switzerland)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1164"/> + <location filename="../src/mudlet.cpp" line="1167"/> <source>Italian (Italy)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1165"/> + <location filename="../src/mudlet.cpp" line="1168"/> <source>Kazakh</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1166"/> + <location filename="../src/mudlet.cpp" line="1169"/> <source>Kazakh (Kazakhstan)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1167"/> + <location filename="../src/mudlet.cpp" line="1170"/> <source>Kurmanji</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1168"/> + <location filename="../src/mudlet.cpp" line="1171"/> <source>Kurmanji {Latin-alphabet Kurdish}</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1169"/> + <location filename="../src/mudlet.cpp" line="1172"/> <source>Korean</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1170"/> + <location filename="../src/mudlet.cpp" line="1173"/> <source>Korean (South Korea)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1171"/> + <location filename="../src/mudlet.cpp" line="1174"/> <source>Kurdish</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1172"/> + <location filename="../src/mudlet.cpp" line="1175"/> <source>Kurdish (Syria)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1173"/> + <location filename="../src/mudlet.cpp" line="1176"/> <source>Kurdish (Turkey)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1174"/> + <location filename="../src/mudlet.cpp" line="1177"/> <source>Latin</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1175"/> + <location filename="../src/mudlet.cpp" line="1178"/> <source>Luxembourgish</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1176"/> + <location filename="../src/mudlet.cpp" line="1179"/> <source>Luxembourgish (Luxembourg)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1177"/> + <location filename="../src/mudlet.cpp" line="1180"/> <source>Lao</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1178"/> + <location filename="../src/mudlet.cpp" line="1181"/> <source>Lao (Laos)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1179"/> + <location filename="../src/mudlet.cpp" line="1182"/> <source>Lithuanian</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1180"/> + <location filename="../src/mudlet.cpp" line="1183"/> <source>Lithuanian (Lithuania)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1181"/> + <location filename="../src/mudlet.cpp" line="1184"/> <source>Latvian</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1182"/> + <location filename="../src/mudlet.cpp" line="1185"/> <source>Latvian (Latvia)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1183"/> + <location filename="../src/mudlet.cpp" line="1186"/> <source>Malayalam</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1184"/> + <location filename="../src/mudlet.cpp" line="1187"/> <source>Malayalam (India)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1187"/> + <location filename="../src/mudlet.cpp" line="1190"/> <source>Norwegian Bokmål</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1188"/> + <location filename="../src/mudlet.cpp" line="1191"/> <source>Norwegian Bokmål (Norway)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1189"/> + <location filename="../src/mudlet.cpp" line="1192"/> <source>Nepali</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1190"/> + <location filename="../src/mudlet.cpp" line="1193"/> <source>Nepali (Nepal)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1191"/> + <location filename="../src/mudlet.cpp" line="1194"/> <source>Dutch</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1192"/> + <location filename="../src/mudlet.cpp" line="1195"/> <source>Dutch (Netherlands Antilles)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1193"/> + <location filename="../src/mudlet.cpp" line="1196"/> <source>Dutch (Aruba)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1194"/> + <location filename="../src/mudlet.cpp" line="1197"/> <source>Dutch (Belgium)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1195"/> + <location filename="../src/mudlet.cpp" line="1198"/> <source>Dutch (Netherlands)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1196"/> + <location filename="../src/mudlet.cpp" line="1199"/> <source>Dutch (Suriname)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1197"/> + <location filename="../src/mudlet.cpp" line="1200"/> <source>Norwegian Nynorsk</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1198"/> + <location filename="../src/mudlet.cpp" line="1201"/> <source>Norwegian Nynorsk (Norway)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1199"/> + <location filename="../src/mudlet.cpp" line="1202"/> <source>Occitan</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1200"/> + <location filename="../src/mudlet.cpp" line="1203"/> <source>Occitan (France)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1201"/> + <location filename="../src/mudlet.cpp" line="1204"/> <source>Polish</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1202"/> + <location filename="../src/mudlet.cpp" line="1205"/> <source>Polish (Poland)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1203"/> + <location filename="../src/mudlet.cpp" line="1206"/> <source>Portuguese</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1204"/> + <location filename="../src/mudlet.cpp" line="1207"/> <source>Portuguese (Brazil)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1205"/> + <location filename="../src/mudlet.cpp" line="1208"/> <source>Portuguese (Portugal)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1206"/> + <location filename="../src/mudlet.cpp" line="1209"/> <source>Romanian</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1207"/> + <location filename="../src/mudlet.cpp" line="1210"/> <source>Romanian (Romania)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1208"/> + <location filename="../src/mudlet.cpp" line="1211"/> <source>Russian</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1209"/> + <location filename="../src/mudlet.cpp" line="1212"/> <source>Russian (Russia)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1210"/> + <location filename="../src/mudlet.cpp" line="1213"/> <source>Northern Sami</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1211"/> + <location filename="../src/mudlet.cpp" line="1214"/> <source>Northern Sami (Finland)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1212"/> + <location filename="../src/mudlet.cpp" line="1215"/> <source>Northern Sami (Norway)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1213"/> + <location filename="../src/mudlet.cpp" line="1216"/> <source>Northern Sami (Sweden)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1218"/> + <location filename="../src/mudlet.cpp" line="1221"/> <source>Sinhala</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1219"/> + <location filename="../src/mudlet.cpp" line="1222"/> <source>Sinhala (Sri Lanka)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1220"/> + <location filename="../src/mudlet.cpp" line="1223"/> <source>Slovak</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1221"/> + <location filename="../src/mudlet.cpp" line="1224"/> <source>Slovak (Slovakia)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1222"/> + <location filename="../src/mudlet.cpp" line="1225"/> <source>Slovenian</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1223"/> + <location filename="../src/mudlet.cpp" line="1226"/> <source>Slovenian (Slovenia)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1224"/> + <location filename="../src/mudlet.cpp" line="1227"/> <source>Somali</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1225"/> + <location filename="../src/mudlet.cpp" line="1228"/> <source>Somali (Somalia)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1226"/> + <location filename="../src/mudlet.cpp" line="1229"/> <source>Albanian</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1227"/> + <location filename="../src/mudlet.cpp" line="1230"/> <source>Albanian (Albania)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1228"/> + <location filename="../src/mudlet.cpp" line="1231"/> <source>Serbian</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1229"/> + <location filename="../src/mudlet.cpp" line="1232"/> <source>Serbian (Montenegro)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1230"/> + <location filename="../src/mudlet.cpp" line="1233"/> <source>Serbian (Serbia)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1231"/> + <location filename="../src/mudlet.cpp" line="1234"/> <source>Serbian (Serbia - Latin-alphabet)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1232"/> + <location filename="../src/mudlet.cpp" line="1235"/> <source>Serbian (former state of Yugoslavia)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1233"/> + <location filename="../src/mudlet.cpp" line="1236"/> <source>Swati</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1234"/> + <location filename="../src/mudlet.cpp" line="1237"/> <source>Swati (Swaziland)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1235"/> + <location filename="../src/mudlet.cpp" line="1238"/> <source>Swati (South Africa)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1236"/> + <location filename="../src/mudlet.cpp" line="1239"/> <source>Swedish</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1237"/> + <location filename="../src/mudlet.cpp" line="1240"/> <source>Swedish (Sweden)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1238"/> + <location filename="../src/mudlet.cpp" line="1241"/> <source>Swedish (Finland)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1239"/> + <location filename="../src/mudlet.cpp" line="1242"/> <source>Swahili</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1240"/> + <location filename="../src/mudlet.cpp" line="1243"/> <source>Swahili (Kenya)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1241"/> + <location filename="../src/mudlet.cpp" line="1244"/> <source>Swahili (Tanzania)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1255"/> + <location filename="../src/mudlet.cpp" line="1258"/> <source>Turkish</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1242"/> + <location filename="../src/mudlet.cpp" line="1245"/> <source>Telugu</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1243"/> + <location filename="../src/mudlet.cpp" line="1246"/> <source>Telugu (India)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1244"/> + <location filename="../src/mudlet.cpp" line="1247"/> <source>Thai</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1245"/> + <location filename="../src/mudlet.cpp" line="1248"/> <source>Thai (Thailand)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1246"/> + <location filename="../src/mudlet.cpp" line="1249"/> <source>Tigrinya</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1247"/> + <location filename="../src/mudlet.cpp" line="1250"/> <source>Tigrinya (Eritrea)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1248"/> + <location filename="../src/mudlet.cpp" line="1251"/> <source>Tigrinya (Ethiopia)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1249"/> + <location filename="../src/mudlet.cpp" line="1252"/> <source>Turkmen</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1250"/> + <location filename="../src/mudlet.cpp" line="1253"/> <source>Turkmen (Turkmenistan)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1252"/> + <location filename="../src/mudlet.cpp" line="1255"/> <source>Tswana</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1253"/> + <location filename="../src/mudlet.cpp" line="1256"/> <source>Tswana (Botswana)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1254"/> + <location filename="../src/mudlet.cpp" line="1257"/> <source>Tswana (South Africa)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1257"/> + <location filename="../src/mudlet.cpp" line="1260"/> <source>Tsonga</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1258"/> + <location filename="../src/mudlet.cpp" line="1261"/> <source>Tsonga (South Africa)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1259"/> + <location filename="../src/mudlet.cpp" line="1262"/> <source>Ukrainian</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1260"/> + <location filename="../src/mudlet.cpp" line="1263"/> <source>Ukrainian (Ukraine)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1261"/> + <location filename="../src/mudlet.cpp" line="1264"/> <source>Uzbek</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1262"/> + <location filename="../src/mudlet.cpp" line="1265"/> <source>Uzbek (Uzbekistan)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1263"/> + <location filename="../src/mudlet.cpp" line="1266"/> <source>Venda</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1264"/> + <location filename="../src/mudlet.cpp" line="1267"/> <source>Vietnamese</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1265"/> + <location filename="../src/mudlet.cpp" line="1268"/> <source>Vietnamese (Vietnam)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1272"/> + <location filename="../src/mudlet.cpp" line="1275"/> <source>Walloon</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1273"/> + <location filename="../src/mudlet.cpp" line="1276"/> <source>Xhosa</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1274"/> + <location filename="../src/mudlet.cpp" line="1277"/> <source>Yiddish</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1275"/> + <location filename="../src/mudlet.cpp" line="1278"/> <source>Chinese</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1276"/> + <location filename="../src/mudlet.cpp" line="1279"/> <source>Chinese (China - simplified)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1277"/> + <location filename="../src/mudlet.cpp" line="1280"/> <source>Chinese (Taiwan - traditional)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1278"/> + <location filename="../src/mudlet.cpp" line="1281"/> <source>Zulu</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1282"/> + <location filename="../src/mudlet.cpp" line="1285"/> <source>ASCII (Basic)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1284"/> + <location filename="../src/mudlet.cpp" line="1287"/> <source>UTF-8 (Recommended)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1286"/> + <location filename="../src/mudlet.cpp" line="1289"/> <source>EUC-KR (Korean)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1288"/> + <location filename="../src/mudlet.cpp" line="1291"/> <source>GBK (Chinese)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1290"/> + <location filename="../src/mudlet.cpp" line="1293"/> <source>GB18030 (Chinese)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1292"/> + <location filename="../src/mudlet.cpp" line="1295"/> <source>Big5-ETen (Taiwan)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1294"/> + <location filename="../src/mudlet.cpp" line="1297"/> <source>Big5-HKSCS (Hong Kong)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1296"/> + <location filename="../src/mudlet.cpp" line="1299"/> <source>ISO 8859-1 (Western European)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1298"/> + <location filename="../src/mudlet.cpp" line="1301"/> <source>ISO 8859-2 (Central European)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1300"/> + <location filename="../src/mudlet.cpp" line="1303"/> <source>ISO 8859-3 (South European)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1302"/> + <location filename="../src/mudlet.cpp" line="1305"/> <source>ISO 8859-4 (Baltic)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1304"/> + <location filename="../src/mudlet.cpp" line="1307"/> <source>ISO 8859-5 (Cyrillic)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1306"/> + <location filename="../src/mudlet.cpp" line="1309"/> <source>ISO 8859-6 (Arabic)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1308"/> + <location filename="../src/mudlet.cpp" line="1311"/> <source>ISO 8859-7 (Greek)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1310"/> + <location filename="../src/mudlet.cpp" line="1313"/> <source>ISO 8859-8 (Hebrew Visual)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1312"/> + <location filename="../src/mudlet.cpp" line="1315"/> <source>ISO 8859-9 (Turkish)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1314"/> + <location filename="../src/mudlet.cpp" line="1317"/> <source>ISO 8859-10 (Nordic)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1316"/> + <location filename="../src/mudlet.cpp" line="1319"/> <source>ISO 8859-11 (Latin/Thai)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1318"/> + <location filename="../src/mudlet.cpp" line="1321"/> <source>ISO 8859-13 (Baltic)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1320"/> + <location filename="../src/mudlet.cpp" line="1323"/> <source>ISO 8859-14 (Celtic)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1322"/> + <location filename="../src/mudlet.cpp" line="1325"/> <source>ISO 8859-15 (Western)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1324"/> + <location filename="../src/mudlet.cpp" line="1327"/> <source>ISO 8859-16 (Romanian)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1326"/> - <location filename="../src/mudlet.cpp" line="1328"/> + <location filename="../src/mudlet.cpp" line="1329"/> + <location filename="../src/mudlet.cpp" line="1331"/> <source>CP437 (OEM Font)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1330"/> - <location filename="../src/mudlet.cpp" line="1332"/> + <location filename="../src/mudlet.cpp" line="1333"/> + <location filename="../src/mudlet.cpp" line="1335"/> <source>CP667 (Mazovia)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1334"/> - <location filename="../src/mudlet.cpp" line="1336"/> + <location filename="../src/mudlet.cpp" line="1337"/> + <location filename="../src/mudlet.cpp" line="1339"/> <source>CP737 (DOS Greek)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1338"/> + <location filename="../src/mudlet.cpp" line="1341"/> <source>CP850 (Western Europe)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1340"/> + <location filename="../src/mudlet.cpp" line="1343"/> <source>CP866 (Cyrillic/Russian)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1342"/> - <location filename="../src/mudlet.cpp" line="1344"/> + <location filename="../src/mudlet.cpp" line="1345"/> + <location filename="../src/mudlet.cpp" line="1347"/> <source>CP869 (DOS Greek 2)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1346"/> + <location filename="../src/mudlet.cpp" line="1349"/> <source>CP1161 (Latin/Thai)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1348"/> + <location filename="../src/mudlet.cpp" line="1351"/> <source>KOI8-R (Cyrillic)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1350"/> + <location filename="../src/mudlet.cpp" line="1353"/> <source>KOI8-U (Cyrillic/Ukrainian)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1352"/> + <location filename="../src/mudlet.cpp" line="1355"/> <source>MACINTOSH</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1358"/> + <location filename="../src/mudlet.cpp" line="1361"/> <source>WINDOWS-1250 (Central European)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1360"/> + <location filename="../src/mudlet.cpp" line="1363"/> <source>WINDOWS-1251 (Cyrillic)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1362"/> + <location filename="../src/mudlet.cpp" line="1365"/> <source>WINDOWS-1252 (Western)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1364"/> + <location filename="../src/mudlet.cpp" line="1367"/> <source>WINDOWS-1253 (Greek)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1366"/> + <location filename="../src/mudlet.cpp" line="1369"/> <source>WINDOWS-1254 (Turkish)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1368"/> + <location filename="../src/mudlet.cpp" line="1371"/> <source>WINDOWS-1255 (Hebrew)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1370"/> + <location filename="../src/mudlet.cpp" line="1373"/> <source>WINDOWS-1256 (Arabic)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1372"/> + <location filename="../src/mudlet.cpp" line="1375"/> <source>WINDOWS-1257 (Baltic)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1374"/> + <location filename="../src/mudlet.cpp" line="1377"/> <source>WINDOWS-1258 (Vietnamese)</source> <extracomment>Keep the English translation intact, so if a user accidentally changes to a language they don't understand, they can change back e.g. ISO 8859-2 (Центральная Европа/Central European)</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="5949"/> + <location filename="../src/mudlet.cpp" line="6021"/> <source>Update check failed. Error: %1 </source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="6112"/> + <location filename="../src/mudlet.cpp" line="6184"/> <source>Could not open profile file: %1</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="6121"/> + <location filename="../src/mudlet.cpp" line="6193"/> <source>[ ERROR ] - Something went wrong loading your Mudlet profile and it could not be loaded. Try loading an older version in 'Connect - Options - Profile history' or double-check that %1 looks correct.</source> <extracomment>%1 is the path and file name (i.e. the location) of the problem fil</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="5189"/> + <location filename="../src/mudlet.cpp" line="5261"/> <source>[ INFO ] - Mudlet and game sounds are muted.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="5189"/> + <location filename="../src/mudlet.cpp" line="5261"/> <source>[ INFO ] - Mudlet and game sounds are unmuted.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="5201"/> + <location filename="../src/mudlet.cpp" line="5273"/> <source>Unmute sounds from Mudlet (Triggers, Scripts, etc.)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="5206"/> + <location filename="../src/mudlet.cpp" line="5278"/> <source>Unmute sounds from the game (MCMP, MSP)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="5426"/> + <location filename="../src/mudlet.cpp" line="5498"/> <source>Cannot load a replay as one is already in progress in this or another profile.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="5445"/> + <location filename="../src/mudlet.cpp" line="5517"/> <source>Replay each step with a shorter time interval between steps.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="5451"/> + <location filename="../src/mudlet.cpp" line="5523"/> <source>Replay each step with a longer time interval between steps.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="7292"/> + <location filename="../src/mudlet.cpp" line="7364"/> <source>Hide tray icon</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="7297"/> + <location filename="../src/mudlet.cpp" line="7369"/> <source>Quit Mudlet</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="250"/> - <location filename="../src/mudlet.cpp" line="5386"/> + <location filename="../src/mudlet.cpp" line="253"/> + <location filename="../src/mudlet.cpp" line="5458"/> <source>Main Toolbar</source> <extracomment>Name of the main toolbar shown in Qt's built-in toolbar toggle menus and right-click context menus ---------- @@ -15534,304 +15644,304 @@ Toggle action in the tab bar context menu to show/hide the main toolbar</extraco <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="296"/> - <location filename="../src/mudlet.cpp" line="303"/> - <location filename="../src/mudlet.cpp" line="305"/> + <location filename="../src/mudlet.cpp" line="299"/> + <location filename="../src/mudlet.cpp" line="306"/> + <location filename="../src/mudlet.cpp" line="308"/> <source>Connect</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="308"/> - <location filename="../src/mudlet.cpp" line="724"/> + <location filename="../src/mudlet.cpp" line="311"/> + <location filename="../src/mudlet.cpp" line="727"/> <source>Disconnect</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="409"/> + <location filename="../src/mudlet.cpp" line="412"/> <source>Open Discord</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="327"/> + <location filename="../src/mudlet.cpp" line="330"/> <source>Triggers</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="214"/> + <location filename="../src/mudlet.cpp" line="217"/> <source>hh:mm:ss</source> <extracomment>Formatting string for elapsed time display in replay playback - see QDateTime::toString(const QString&) for the gory details...!</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="328"/> + <location filename="../src/mudlet.cpp" line="331"/> <source>Show and edit triggers</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="335"/> + <location filename="../src/mudlet.cpp" line="338"/> <source>Aliases</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="336"/> + <location filename="../src/mudlet.cpp" line="339"/> <source>Show and edit aliases</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="341"/> + <location filename="../src/mudlet.cpp" line="344"/> <source>Timers</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="342"/> + <location filename="../src/mudlet.cpp" line="345"/> <source>Show and edit timers</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="347"/> + <location filename="../src/mudlet.cpp" line="350"/> <source>Buttons</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="348"/> + <location filename="../src/mudlet.cpp" line="351"/> <source>Show and edit easy buttons</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="353"/> + <location filename="../src/mudlet.cpp" line="356"/> <source>Scripts</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="354"/> + <location filename="../src/mudlet.cpp" line="357"/> <source>Show and edit scripts</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="359"/> + <location filename="../src/mudlet.cpp" line="362"/> <source>Keys</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="360"/> + <location filename="../src/mudlet.cpp" line="363"/> <source>Show and edit keys</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="365"/> + <location filename="../src/mudlet.cpp" line="368"/> <source>Variables</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="366"/> + <location filename="../src/mudlet.cpp" line="369"/> <source>Show and edit Lua variables</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="425"/> + <location filename="../src/mudlet.cpp" line="428"/> <source>Map</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="426"/> + <location filename="../src/mudlet.cpp" line="429"/> <source>Show/hide the map</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="431"/> + <location filename="../src/mudlet.cpp" line="434"/> <source>Manual</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="432"/> + <location filename="../src/mudlet.cpp" line="435"/> <source>Browse reference material and documentation</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="437"/> + <location filename="../src/mudlet.cpp" line="440"/> <source>Settings</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="438"/> + <location filename="../src/mudlet.cpp" line="441"/> <source>See and edit profile preferences</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="446"/> - <location filename="../src/mudlet.cpp" line="718"/> + <location filename="../src/mudlet.cpp" line="449"/> + <location filename="../src/mudlet.cpp" line="721"/> <source>Notepad</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="447"/> + <location filename="../src/mudlet.cpp" line="450"/> <source>Open a notepad that you can store your notes in</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="459"/> - <location filename="../src/mudlet.cpp" line="468"/> + <location filename="../src/mudlet.cpp" line="462"/> + <location filename="../src/mudlet.cpp" line="471"/> <source>Packages</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="466"/> + <location filename="../src/mudlet.cpp" line="469"/> <source>Package Manager</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="471"/> + <location filename="../src/mudlet.cpp" line="474"/> <source>Module Manager</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="475"/> + <location filename="../src/mudlet.cpp" line="478"/> <source>Package Exporter</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="485"/> + <location filename="../src/mudlet.cpp" line="488"/> <source>Replay</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="490"/> - <location filename="../src/mudlet.cpp" line="725"/> + <location filename="../src/mudlet.cpp" line="493"/> + <location filename="../src/mudlet.cpp" line="728"/> <source>Reconnect</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="491"/> + <location filename="../src/mudlet.cpp" line="494"/> <source>Disconnects you from the game and connects once again</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="496"/> - <location filename="../src/mudlet.cpp" line="721"/> + <location filename="../src/mudlet.cpp" line="499"/> + <location filename="../src/mudlet.cpp" line="724"/> <source>MultiView</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="498"/> + <location filename="../src/mudlet.cpp" line="501"/> <source>Splits the Mudlet screen to show multiple profiles at once; disabled when less than two are loaded.</source> <extracomment>Same text is used in 2 places.</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="521"/> - <location filename="../src/mudlet.cpp" line="6001"/> + <location filename="../src/mudlet.cpp" line="524"/> + <location filename="../src/mudlet.cpp" line="6073"/> <source>About</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1159"/> + <location filename="../src/mudlet.cpp" line="1162"/> <source>Interlingue</source> <extracomment>, formerly known as Occidental, and not to be mistaken for Interlingua</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1215"/> + <location filename="../src/mudlet.cpp" line="1218"/> <source>Shtokavian</source> <extracomment>This code seems to be the identifier for the prestige dialect for several languages used in the region of the former Yugoslavia state without a state indication</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1217"/> + <location filename="../src/mudlet.cpp" line="1220"/> <source>Shtokavian (former state of Yugoslavia)</source> <extracomment>This code seems to be the identifier for the prestige dialect for several languages used in the region of the former Yugoslavia state with a (withdrawn from ISO 3166) state indication</extracomment> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1256"/> + <location filename="../src/mudlet.cpp" line="1259"/> <source>Turkish (Turkey)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1266"/> - <location filename="../src/mudlet.cpp" line="1270"/> + <location filename="../src/mudlet.cpp" line="1269"/> + <location filename="../src/mudlet.cpp" line="1273"/> <source>Vietnamese (DauCu variant - old-style diacritics)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="1267"/> - <location filename="../src/mudlet.cpp" line="1271"/> + <location filename="../src/mudlet.cpp" line="1270"/> + <location filename="../src/mudlet.cpp" line="1274"/> <source>Vietnamese (DauMoi variant - new-style diacritics)</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="2542"/> - <location filename="../src/mudlet.cpp" line="2650"/> - <location filename="../src/mudlet.cpp" line="5521"/> + <location filename="../src/mudlet.cpp" line="2614"/> + <location filename="../src/mudlet.cpp" line="2722"/> + <location filename="../src/mudlet.cpp" line="5593"/> <source>Load a Mudlet replay.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="4725"/> + <location filename="../src/mudlet.cpp" line="4797"/> <source>Central Debug Console</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="534"/> - <location filename="../src/mudlet.cpp" line="742"/> + <location filename="../src/mudlet.cpp" line="537"/> + <location filename="../src/mudlet.cpp" line="745"/> <source>Toggle Full Screen View</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="2459"/> - <location filename="../src/mudlet.cpp" line="2547"/> + <location filename="../src/mudlet.cpp" line="2531"/> + <location filename="../src/mudlet.cpp" line="2619"/> <source><p>Load a Mudlet replay.</p><p><i>Disabled until a profile is loaded.</i></p></source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="4420"/> + <location filename="../src/mudlet.cpp" line="4492"/> <source>%1 - notes</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="4523"/> + <location filename="../src/mudlet.cpp" line="4595"/> <source>Select Replay</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="4523"/> + <location filename="../src/mudlet.cpp" line="4595"/> <source>*.dat</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="5010"/> + <location filename="../src/mudlet.cpp" line="5082"/> <source>[ OK ] - Profile "%1" loaded in offline mode.</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="5443"/> + <location filename="../src/mudlet.cpp" line="5515"/> <source>Faster</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="5449"/> + <location filename="../src/mudlet.cpp" line="5521"/> <source>Slower</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="5461"/> - <location filename="../src/mudlet.cpp" line="5529"/> - <location filename="../src/mudlet.cpp" line="5538"/> + <location filename="../src/mudlet.cpp" line="5533"/> + <location filename="../src/mudlet.cpp" line="5601"/> + <location filename="../src/mudlet.cpp" line="5610"/> <source>Speed: X%1</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="5468"/> - <location filename="../src/mudlet.cpp" line="5484"/> + <location filename="../src/mudlet.cpp" line="5540"/> + <location filename="../src/mudlet.cpp" line="5556"/> <source>Time: %1</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="6041"/> + <location filename="../src/mudlet.cpp" line="6113"/> <source>Update installed - restart to apply</source> <translation type="unfinished"></translation> </message> <message> - <location filename="../src/mudlet.cpp" line="6172"/> + <location filename="../src/mudlet.cpp" line="6244"/> <source>[ WARN ] - Cannot perform replay, another one may already be in progress, try again when it has finished.</source> <translation type="unfinished"></translation> From c0e1fac7cbc50352b93a502fd3a9b8a67037378b Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Fri, 7 Aug 2026 06:10:42 +0200 Subject: [PATCH 107/155] fix: profile close during a map operation, Discord presence truncation, and interrupting ttsSpeak() (#9686) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit #### Brief overview of PR changes/additions - Closing a profile no longer frees the map out from under a running import, export or download. `TMap` counts the operations that pump `qApp->processEvents()`, and `mudlet::closeHost()` - which one of those pumps is what delivers it - stops the operation and destroys the `Host` once it has unwound, instead of half way through it. - Discord presence fields keep their last character and are only ever cut between characters: each buffer is now the documented limit plus room for its terminator, and a new `utils::copyUtf8String()` walks the cut back to a character boundary. - An interrupting `ttsSpeak()` announces the utterance it starts, and the `Ready` an engine reports for the utterance it cut off no longer drains `ttsQueue()` over the top of the one the script asked for. #### Motivation for adding to Mudlet Each is a filed defect, and each was reproduced before it was fixed. The map one is a use-after-free: ASan reports `heap-use-after-free` inside `TMap::readJsonMapFile()`, freed by `~TMap` <- `~Host` <- `HostManager::deleteHost` <- `mudlet::closeHost` delivered by the import's own `processEvents()`. The Discord one is worse than one field looking wrong: a single over-long non-ASCII field makes the whole `SET_ACTIVITY` payload undecodable, so the entire presence update is discarded - the fake Discord client recorded exactly that. The TTS one silently drops speech: `ttsQueue()` plus an interrupting `ttsSpeak()` speaks the queued line and never speaks the requested one. #### Other info (issues closed, discussion etc) Closes #9520, closes #9634, closes #9659. `MapCloseDuringImportTest` stages the close through `mudlet::slot_closeProfileByName()` and lets the map operation's own pump deliver it; the functional tests build with ASan, so the pre-fix run is a sanitizer report rather than an inference. `TtsInterruptingSpeakTest` hands `ttsStateChanged()` the `Ready` a real engine sends, which Qt's mock engine never does - the mock-visible half is pinned in `Media_spec.lua`, where the two specs that recorded the old behaviour are updated. `Discord_spec.lua` gains four end-to-end specs against `CI/discord-ipc-fixture.py` asserting that the captured frame still decodes as JSON and that a field is cut on a character boundary, and `DiscordTest.cpp` covers the same at unit level. Every new or changed test was confirmed to fail without its fix. Two things deliberately left alone, both older than this PR: `Host::requestClose()` still runs nested inside the map operation's pump (it saves the profile there), and an XML import or a map download has no cancel to poll, so a close waits for it rather than stopping it. **Test case:** Export a large map with `exportJsonMap()` and close the profile's tab while it runs; then `setDiscordDetail(string.rep("ä", 65))` and confirm the presence still updates; then `ttsQueue("queued line") ttsSpeak("first")` followed immediately by `ttsSpeak("second")` and confirm "second" is what gets spoken. Assisted-by: Claude:claude-opus-5 --- src/TLuaInterpreterTextToSpeech.cpp | 89 ++++++- src/TMap.cpp | 22 ++ src/TMap.h | 42 +++ src/discord.cpp | 18 +- src/discord.h | 30 ++- src/mudlet-lua/tests/Discord_spec.lua | 74 +++++- src/mudlet-lua/tests/Media_spec.lua | 39 ++- src/mudlet.cpp | 33 +++ src/utils.h | 24 ++ test/DiscordTest.cpp | 83 +++++- test/functional_tests/CMakeLists.txt | 4 +- .../MapCloseDuringImportTest.cpp | 248 ++++++++++++++++++ .../TtsInterruptingSpeakTest.cpp | 243 +++++++++++++++++ 13 files changed, 903 insertions(+), 46 deletions(-) create mode 100644 test/functional_tests/MapCloseDuringImportTest.cpp create mode 100644 test/functional_tests/TtsInterruptingSpeakTest.cpp diff --git a/src/TLuaInterpreterTextToSpeech.cpp b/src/TLuaInterpreterTextToSpeech.cpp index ff6ae650b..27d75158b 100644 --- a/src/TLuaInterpreterTextToSpeech.cpp +++ b/src/TLuaInterpreterTextToSpeech.cpp @@ -59,6 +59,7 @@ #include "glwidget_integration.h" #endif +#include <chrono> #include <limits> #include <math.h> @@ -67,6 +68,7 @@ #include <QDesktopServices> #include <QFileInfo> #include <QMovie> +#include <QTimer> #include <QVector> #ifdef QT_TEXTTOSPEECH_LIB #include <QTextToSpeech> @@ -79,9 +81,34 @@ bool bSpeechBuilt; bool bSpeechQueueing; int speechState = QTextToSpeech::State::Ready; QString speechCurrent; +// Whether a ttsSpeechStarted has been raised for what speechCurrent holds. The +// events are raised off the engine's state edges, and an engine that is already +// speaking has no edge to report when it is given something else to say. +static bool speechStartAnnounced = false; +// Set while the utterance ttsSpeak() last asked for was started over one that +// was still being spoken. Every engine stops the running utterance inside say(), +// and the Ready that reports that has to be told apart from the engine going +// idle - see ttsSpeak(). +static bool speechInterrupting = false; +// How long an engine is given to start the utterance that interrupted another +// before a Ready held back on its account is taken at face value after all. +static constexpr std::chrono::milliseconds scmInterruptedSpeechGrace{250}; static const QTextToSpeech::State TEXT_TO_SPEECH_ERROR_STATE = QTextToSpeech::State::Error; +// ttsStateChanged() raises this same event whenever the engine reports a state +// edge into Speaking; ttsSpeak() raises it through here for the utterance an +// already-speaking engine starts without any such edge. +static void raiseSpeechStartedEvent(const QString& text) +{ + TEvent event{}; + event.mArgumentList.append(QLatin1String("ttsSpeechStarted")); + event.mArgumentTypeList.append(ARGUMENT_TYPE_STRING); + event.mArgumentList.append(text); + event.mArgumentTypeList.append(ARGUMENT_TYPE_STRING); + mudlet::self()->getHostManager().postInterHostEvent(nullptr, event, true); +} + // No documentation available in wiki - internal function void TLuaInterpreter::ttsBuild() { @@ -114,6 +141,10 @@ int TLuaInterpreter::ttsSkip(lua_State* L) Q_UNUSED(L) TLuaInterpreter::ttsBuild(); + // An explicit stop ends whatever is being spoken outright, so the Ready it + // produces is the engine going idle and must drain the queue as it always + // has - it is not the interruption ttsSpeak() has to defend against. + speechInterrupting = false; speechUnit->stop(); return 0; @@ -122,12 +153,22 @@ int TLuaInterpreter::ttsSkip(lua_State* L) // No documentation available in wiki - internal function void TLuaInterpreter::ttsStateChanged(QTextToSpeech::State state) { + // ttsSpeak() announces an utterance itself when the engine was already + // speaking, because there is then no state edge to announce it. An engine + // that gets round to reporting the interruption afterwards ends up here + // with an edge back into Speaking for that same utterance, which would tell + // a script it started twice. + const bool alreadyAnnounced = (state == QTextToSpeech::State::Speaking && speechStartAnnounced); + if (state != speechState) { speechState = state; TEvent event{}; switch (state) { case QTextToSpeech::State::Paused: event.mArgumentList.append(QLatin1String("ttsSpeechPaused")); + // Resuming has always announced the utterance again, so let it: + // being paused is the end of what was announced before. + speechStartAnnounced = false; break; case QTextToSpeech::State::Speaking: event.mArgumentList.append(QLatin1String("ttsSpeechStarted")); @@ -151,9 +192,37 @@ void TLuaInterpreter::ttsStateChanged(QTextToSpeech::State state) if (state == QTextToSpeech::Speaking) { event.mArgumentList.append(speechCurrent); event.mArgumentTypeList.append(ARGUMENT_TYPE_STRING); + // The engine has taken up what it was last given, so ttsSpeak() has + // nothing left to announce and any interruption is over. + speechStartAnnounced = true; + speechInterrupting = false; } - mudlet::self()->getHostManager().postInterHostEvent(NULL, event, true); + if (!alreadyAnnounced) { + mudlet::self()->getHostManager().postInterHostEvent(NULL, event, true); + } + } + + if (state == QTextToSpeech::State::Ready && speechInterrupting) { + // Not the engine falling idle but the utterance ttsSpeak() spoke over + // ending inside say(). Draining here would speak a queued line on top of + // the one the script has just asked for, and that one is then never + // heard at all (#9659). The engine reports Speaking for the requested + // utterance next, which clears this above. + speechInterrupting = false; + bSpeechQueueing = false; + // Unless it does not: an engine that rejects an utterance outright, or + // that replaces one without ever reporting a state change, leaves this + // as the last word on the matter, and a queue waiting on a Ready that + // is never coming waits forever. Look again once the engine has had its + // chance to start speaking - if it is still idle, that Ready did mean + // idle and the queue is free to go. + QTimer::singleShot(scmInterruptedSpeechGrace, qApp, []() { + if (!speechUnit.isNull() && speechUnit->state() == QTextToSpeech::State::Ready && !speechQueue.isEmpty()) { + TLuaInterpreter::ttsStateChanged(QTextToSpeech::State::Ready); + } + }); + return; } if (state != QTextToSpeech::State::Ready || speechQueue.empty()) { @@ -166,6 +235,7 @@ void TLuaInterpreter::ttsStateChanged(QTextToSpeech::State state) // recorded before say() because the engine can switch to Speaking inside // that call, and this function reports speechCurrent with the event speechCurrent = textToSay; + speechStartAnnounced = false; speechUnit->say(textToSay); return; @@ -379,6 +449,9 @@ int TLuaInterpreter::ttsQueue(lua_State* L) if (speechQueue.size() == 1 && speechUnit->state() == QTextToSpeech::State::Ready && !bSpeechQueueing) { bSpeechQueueing = true; + // The engine says it is idle, so nothing is left of any utterance an + // earlier ttsSpeak() interrupted and this queued line is free to start. + speechInterrupting = false; TLuaInterpreter::ttsStateChanged(speechUnit->state()); } @@ -419,7 +492,21 @@ int TLuaInterpreter::ttsSpeak(lua_State* L) // recorded before say() because the engine can switch to Speaking inside // that call, and ttsStateChanged() reports speechCurrent with the event speechCurrent = textToSay; + speechStartAnnounced = false; + // Every engine stops what it is saying inside say() and reports Ready for + // it, some during the call and some shortly after. That Ready says the + // interrupted utterance ended, not that the engine has nothing to do, so + // ttsStateChanged() must not drain the queue over the top of this one. + speechInterrupting = (speechUnit->state() == QTextToSpeech::State::Speaking); speechUnit->say(textToSay); + + // An engine that was already speaking stays in the Speaking state through + // all of that, and the events are raised off state edges - so without this + // nothing tells a script that what is being spoken has changed (#9659). + if (!speechStartAnnounced && speechUnit->state() == QTextToSpeech::State::Speaking) { + speechStartAnnounced = true; + raiseSpeechStartedEvent(textToSay); + } return 0; } diff --git a/src/TMap.cpp b/src/TMap.cpp index ba5ae0264..4878691d9 100644 --- a/src/TMap.cpp +++ b/src/TMap.cpp @@ -1596,6 +1596,7 @@ bool TMap::validatePotentialMapFile(QFile& file, QDataStream& ifs) bool TMap::restore(QString location) { + const MapOperationScope operationScope(this); qDebug().noquote().nospace() << "TMap::restore(\"" << location << "\") INFO: restoring map of Profile: \"" << mProfileName << "\" URL: " << mpHost->getUrl(); QElapsedTimer _time; @@ -2498,6 +2499,7 @@ void TMap::pushErrorMessagesToFile(const QString title, const bool isACleanup) void TMap::downloadMap(const QString& remoteUrl, const QString& localFileName) { + const MapOperationScope operationScope(this); Host* pHost = mpHost; if (!pHost) { return; @@ -2639,6 +2641,7 @@ bool TMap::importMap(QFile& file, QString* errMsg) bool TMap::readXmlMapFile(QFile& file, QString* errMsg) { + const MapOperationScope operationScope(this); Host* pHost = mpHost; bool isLocalImport = false; if (!pHost) { @@ -2942,6 +2945,23 @@ void TMap::clearTransferProgress() } } +void TMap::requestMapOperationAbort() +{ + if (!mMapOperationDepth || mMapOperationAbortRequested) { + return; + } + mMapOperationAbortRequested = true; + // Deliberately not slot_mapProgressDialogCancelled(): that is the user + // pressing Abort and says so in the console, whereas this is the profile + // going away and has no console left to say it to. What it does share is + // the flag the JSON import and export poll at their next progress step, and + // dropping a download that would otherwise hold the close up on the network. + mMapProgressCancelRequested = true; + if (mMapProgressIsTransfer && mpNetworkReply) { + mpNetworkReply->abort(); + } +} + void TMap::slot_mapProgressDialogCancelled() { // The JSON path polls mMapProgressCancelRequested in its increment loop; the @@ -3032,6 +3052,7 @@ void TMap::setRoomNamesShown(bool shown) */ std::pair<bool, QString> TMap::writeJsonMapFile(const QString& dest) { + const MapOperationScope operationScope(this); QString destination{dest}; if (destination.isEmpty()) { @@ -3222,6 +3243,7 @@ std::pair<bool, QString> TMap::writeJsonMapFile(const QString& dest) // Lua sub-system and do need to report the file: std::pair<bool, QString> TMap::readJsonMapFile(const QString& source, const bool translatableTexts) { + const MapOperationScope operationScope(this); const QString oldDefaultAreaName{mDefaultAreaName}; const QString oldUnnamedName{mUnnamedAreaName}; diff --git a/src/TMap.h b/src/TMap.h index 844b8eb5a..023fcbdfa 100644 --- a/src/TMap.h +++ b/src/TMap.h @@ -184,6 +184,20 @@ public: void disableTransferProgressCancel(); void clearTransferProgress(); + // True while a map import, export or download is on the stack. Those pump + // qApp->processEvents() to keep their progress display alive, so anything + // delivered from an event loop can find itself running nested inside one - + // and destroying this map's Host from there would free the operation's own + // "this" (#9520). Whoever would do that has to wait for this to go false. + bool mapOperationInProgress() const { return mMapOperationDepth > 0; } + // Ask an operation that is in progress to stop at its next opportunity, so + // that a caller waiting on the above does not wait for a whole map. Only the + // JSON import and export poll this; an XML import or a download runs to its + // own end. Asking twice does nothing, which mapOperationAbortRequested() + // also lets a caller polling in a loop see. + void requestMapOperationAbort(); + bool mapOperationAbortRequested() const { return mMapOperationAbortRequested; } + // Show which rooms have which symbols: QHash<QString, QSet<int>> roomSymbolsHash(); @@ -381,6 +395,34 @@ public slots: private: + // Held for the whole of a map operation that pumps the event loop, so that + // mapOperationInProgress() can tell anything re-entered from that pump that + // this map is on the stack. Nested operations are counted, not flagged: an + // XML import can start from inside a download's pump. + class MapOperationScope + { + public: + explicit MapOperationScope(TMap* pMap) + : mpMap(pMap) + { + if (!mpMap->mMapOperationDepth) { + mpMap->mMapOperationAbortRequested = false; + } + ++mpMap->mMapOperationDepth; + } + ~MapOperationScope() { --mpMap->mMapOperationDepth; } + MapOperationScope(const MapOperationScope&) = delete; + MapOperationScope& operator=(const MapOperationScope&) = delete; + + private: + TMap* mpMap = nullptr; + }; + + int mMapOperationDepth = 0; + // requestMapOperationAbort() is asked again on every retry of a deferred + // profile close, and asking twice would abort a network reply twice over. + bool mMapOperationAbortRequested = false; + void addDirectionalRoute(QHash<unsigned int, route>& bestRoutes, const QMap<QString, int>& exitWeights, unsigned int source, diff --git a/src/discord.cpp b/src/discord.cpp index b1fb4106d..9460c2a86 100644 --- a/src/discord.cpp +++ b/src/discord.cpp @@ -688,55 +688,55 @@ DiscordRichPresence localDiscordPresence::convert() const void localDiscordPresence::setDetailText(const QString& text) { const QByteArray utf8Data = text.toUtf8(); - utils::copyString(mDetails, sizeof(mDetails), utf8Data.constData(), utf8Data.size()); + utils::copyUtf8String(mDetails, sizeof(mDetails), utf8Data.constData(), utf8Data.size()); } void localDiscordPresence::setStateText(const QString& text) { const QByteArray utf8Data = text.toUtf8(); - utils::copyString(mState, sizeof(mState), utf8Data.constData(), utf8Data.size()); + utils::copyUtf8String(mState, sizeof(mState), utf8Data.constData(), utf8Data.size()); } void localDiscordPresence::setLargeImageText(const QString& text) { const QByteArray utf8Data = text.toUtf8(); - utils::copyString(mLargeImageText, sizeof(mLargeImageText), utf8Data.constData(), utf8Data.size()); + utils::copyUtf8String(mLargeImageText, sizeof(mLargeImageText), utf8Data.constData(), utf8Data.size()); } void localDiscordPresence::setLargeImageKey(const QString& text) { const QByteArray utf8Data = text.toUtf8(); - utils::copyString(mLargeImageKey, sizeof(mLargeImageKey), utf8Data.constData(), utf8Data.size()); + utils::copyUtf8String(mLargeImageKey, sizeof(mLargeImageKey), utf8Data.constData(), utf8Data.size()); } void localDiscordPresence::setSmallImageText(const QString& text) { const QByteArray utf8Data = text.toUtf8(); - utils::copyString(mSmallImageText, sizeof(mSmallImageText), utf8Data.constData(), utf8Data.size()); + utils::copyUtf8String(mSmallImageText, sizeof(mSmallImageText), utf8Data.constData(), utf8Data.size()); } void localDiscordPresence::setSmallImageKey(const QString& text) { const QByteArray utf8Data = text.toUtf8(); - utils::copyString(mSmallImageKey, sizeof(mSmallImageKey), utf8Data.constData(), utf8Data.size()); + utils::copyUtf8String(mSmallImageKey, sizeof(mSmallImageKey), utf8Data.constData(), utf8Data.size()); } void localDiscordPresence::setJoinSecret(const QString& text) { const QByteArray utf8Data = text.toUtf8(); - utils::copyString(mJoinSecret, sizeof(mJoinSecret), utf8Data.constData(), utf8Data.size()); + utils::copyUtf8String(mJoinSecret, sizeof(mJoinSecret), utf8Data.constData(), utf8Data.size()); } void localDiscordPresence::setMatchSecret(const QString& text) { const QByteArray utf8Data = text.toUtf8(); - utils::copyString(mMatchSecret, sizeof(mMatchSecret), utf8Data.constData(), utf8Data.size()); + utils::copyUtf8String(mMatchSecret, sizeof(mMatchSecret), utf8Data.constData(), utf8Data.size()); } void localDiscordPresence::setSpectateSecret(const QString& text) { const QByteArray utf8Data = text.toUtf8(); - utils::copyString(mSpectateSecret, sizeof(mSpectateSecret), utf8Data.constData(), utf8Data.size()); + utils::copyUtf8String(mSpectateSecret, sizeof(mSpectateSecret), utf8Data.constData(), utf8Data.size()); } bool Discord::usingMudletsDiscordID(Host* pHost) const diff --git a/src/discord.h b/src/discord.h index 4752b0101..c1662005b 100644 --- a/src/discord.h +++ b/src/discord.h @@ -115,20 +115,30 @@ public: int8_t getInstance() const { return mInstance; } private: - char mState[128]; - char mDetails[128]; + // The limits Discord documents for each field, in bytes (see the struct + // comment above). The buffers are one byte larger than the limit they hold: + // sized at exactly the limit, the null terminator would take the last byte + // and a field of the full documented length would always lose its final + // character. Named in the 'k' form the rest of the codebase gives an array + // size (TArea.cpp's kPixmapDataLineSize) rather than the 'scm' one it gives + // other static class members. + static constexpr size_t kTextByteLimit = 128; + static constexpr size_t kImageKeyByteLimit = 32; + + char mState[kTextByteLimit + 1]; + char mDetails[kTextByteLimit + 1]; int64_t mStartTimestamp = 0; int64_t mEndTimestamp = 0; - char mLargeImageKey[32]; - char mLargeImageText[128]; - char mSmallImageKey[32]; - char mSmallImageText[128]; - char mPartyId[128]; + char mLargeImageKey[kImageKeyByteLimit + 1]; + char mLargeImageText[kTextByteLimit + 1]; + char mSmallImageKey[kImageKeyByteLimit + 1]; + char mSmallImageText[kTextByteLimit + 1]; + char mPartyId[kTextByteLimit + 1]; int mPartySize = 0; int mPartyMax = 0; - char mMatchSecret[128]; - char mJoinSecret[128]; - char mSpectateSecret[128]; + char mMatchSecret[kTextByteLimit + 1]; + char mJoinSecret[kTextByteLimit + 1]; + char mSpectateSecret[kTextByteLimit + 1]; int8_t mInstance = 1; }; diff --git a/src/mudlet-lua/tests/Discord_spec.lua b/src/mudlet-lua/tests/Discord_spec.lua index db18cefea..7f84c2298 100644 --- a/src/mudlet-lua/tests/Discord_spec.lua +++ b/src/mudlet-lua/tests/Discord_spec.lua @@ -139,6 +139,21 @@ local function activityFrom(action, accept, timeoutMilliseconds) return activity end +-- How many of the frames recorded after `mark` the fake Discord client could +-- not decode. The fixture files a frame whose payload is not valid JSON (or not +-- valid UTF-8, which JSON decoding of the payload requires) as {"raw": <text>} +-- instead of the parsed object, so this counts exactly the presence updates a +-- real Discord client would have had to throw away whole. +local function undecodableFramesAfter(mark) + local count = 0 + for _, frame in ipairs(framesAfter(mark)) do + if type(frame.payload) == "table" and frame.payload.raw ~= nil then + count = count + 1 + end + end + return count +end + -- How many presence updates have reached the fake Discord client. Counting -- SET_ACTIVITY frames rather than all of them keeps an unrelated handshake or -- subscription from being mistaken for a presence update. @@ -367,11 +382,33 @@ describe("setDiscordDetail", function() local overlong = string.rep("a", 200) local activity = activityFrom(function() setDiscordDetail(overlong) end, function(seen) return seen.details ~= nil end) - assert.equals(127, #activity.details) - assert.equals(string.rep("a", 127), activity.details) + -- The whole documented 128 bytes, not 127: the buffer holding this used to + -- be exactly 128 bytes and lost its last byte to the null terminator + -- (#9634). + assert.equals(128, #activity.details) + assert.equals(string.rep("a", 128), activity.details) -- Only what Discord is sent is truncated; Mudlet keeps the whole string. assert.equals(overlong, getDiscordDetail()) end) + + it("cuts an overlong non-ASCII detail text between characters", function() + if not readyForDiscord() then + return + end + -- #9634: the cut used to be made at the byte limit with no regard for + -- UTF-8, leaving the last character in the field as a lone lead byte. That + -- does not merely damage one field - the payload stops being decodable, so + -- the whole SET_ACTIVITY frame is discarded and every well-formed field in + -- it goes with it. + local mark = frameCount() + -- 65 two-byte characters, 130 bytes: two more than the field holds, so the + -- cut has to fall inside the 65th character. + local activity = activityFrom(function() setDiscordDetail(string.rep("ä", 65)) end, + function(seen) return seen.details ~= nil end) + assert.equals(string.rep("ä", 64), activity.details) + assert.equals(128, #activity.details) + assert.equals(0, undecodableFramesAfter(mark)) + end) end) describe("setDiscordState", function() @@ -460,6 +497,20 @@ describe("setDiscordLargeIcon and setDiscordSmallIcon", function() assert.equals("shield", getDiscordSmallIcon()) end) + it("sends a full length icon key without dropping its last character", function() + if not readyForDiscord() then + return + end + -- #9634: a Discord asset key may be the full 32 bytes the API documents, + -- but the buffer was 32 bytes including the terminator, so the last + -- character was cut off and the icon never resolved. + local key = string.rep("a", 32) + local activity = activityFrom(function() setDiscordLargeIcon(key) end, + function(seen) return seen.assets.large_image ~= "mudlet" end) + assert.equals(32, #activity.assets.large_image) + assert.equals(key, activity.assets.large_image) + end) + it("sends the small icon's tooltip text", function() if not readyForDiscord() then return @@ -811,10 +862,19 @@ describe("setDiscordApplicationID", function() end) end) -describe("known Discord API defects", function() - it("truncates an overlong detail text on a character boundary", function() - pending("localDiscordPresence cuts the text at 127 bytes without regard for UTF-8, so 64 " - .. "two-byte characters reach Discord as 63 characters plus half of one - the frame is " - .. "no longer valid UTF-8. Fix the truncation in discord.cpp, then unpend this") +describe("an icon key that has to be truncated", function() + it("cuts a non-ASCII key between characters and keeps the frame decodable", function() + if not readyForDiscord() then + return + end + -- The 32 byte fields cut in the same place as the 128 byte ones, so they + -- broke the frame in the same way (#9634). 16 two-byte characters are 32 + -- bytes, which now fits exactly; a 17th has to go, whole. + local mark = frameCount() + local activity = activityFrom(function() setDiscordLargeIcon(string.rep("é", 17)) end, + function(seen) return seen.assets.large_image ~= "mudlet" end) + assert.equals(string.rep("é", 16), activity.assets.large_image) + assert.equals(32, #activity.assets.large_image) + assert.equals(0, undecodableFramesAfter(mark)) end) end) diff --git a/src/mudlet-lua/tests/Media_spec.lua b/src/mudlet-lua/tests/Media_spec.lua index 922259933..8ad130f38 100644 --- a/src/mudlet-lua/tests/Media_spec.lua +++ b/src/mudlet-lua/tests/Media_spec.lua @@ -938,9 +938,6 @@ describe("Tests the text-to-speech Lua API", function() -- and the engine changes state inside say(), so the event carried the -- previous utterance. The handler has to be armed up front because the -- event is raised before ttsSpeak() returns. - -- The event only fires on a state transition, so the skip between the - -- two utterances is required: speaking over an utterance that is still - -- running raises no second event at all. local started = {} collect("ttsSpeechStarted", started) @@ -953,6 +950,25 @@ describe("Tests the text-to-speech Lua API", function() assert.same({"first spoken line", "second spoken line"}, started) end) + it("announces an utterance spoken over one that is still running", function() + if noMockEngine() then + return + end + -- #9659: the events are raised off the engine's state edges, and an + -- engine that is already speaking has no edge to report when it is + -- handed something else - so a script tracking what is being spoken was + -- never told the text had changed, while ttsGetCurrentLine() moved on + -- underneath it. No ttsSkip() here: the interruption is the point. + local started = {} + collect("ttsSpeechStarted", started) + + ttsClearQueue() + ttsSpeak("the utterance being spoken over") + ttsSpeak("the utterance spoken over it") + assert.same({"the utterance being spoken over", "the utterance spoken over it"}, started) + assert.equals("the utterance spoken over it", ttsGetCurrentLine()) + end) + it("ttsSpeechStarted carries the queued line the drain started speaking", function() if noMockEngine() then return @@ -976,17 +992,24 @@ describe("Tests the text-to-speech Lua API", function() if noMockEngine() then return end - -- Guards the ordering the two specs above rely on: ttsSpeak() records - -- the text before say(), so an engine that drained the queue from - -- inside say() would leave the queued line reported as the current one - -- instead of the utterance actually asked for. Speaking over a busy - -- engine does not pass through Ready, so no drain happens. + -- The utterance a script asks for outright has to survive the queue: + -- an engine reporting Ready for the utterance say() interrupted used to + -- be read as an idle engine, which drained the queued line straight + -- over the requested one (#9659). The mock engine reports no such Ready, + -- so what this spec can hold onto is the state ttsSpeak() leaves behind + -- - the guard itself is exercised by TtsInterruptingSpeakTest, which + -- delivers that Ready the way a real engine does. + local started = {} + collect("ttsSpeechStarted", started) + ttsClearQueue() ttsSpeak("the busy utterance") ttsQueue("still queued") ttsSpeak("the direct utterance") assert.equals(1, #ttsGetQueue()) assert.equals("the direct utterance", ttsGetCurrentLine()) + -- ...and the queued line was not what got announced: + assert.same({"the busy utterance", "the direct utterance"}, started) end) it("ttsSetVoiceByName reports success for a voice it switched to", function() diff --git a/src/mudlet.cpp b/src/mudlet.cpp index e4cbca125..6f0ec6090 100644 --- a/src/mudlet.cpp +++ b/src/mudlet.cpp @@ -2010,6 +2010,39 @@ void mudlet::closeHost(const QString& name) return; } + if (pH->mpMap && pH->mpMap->mapOperationInProgress()) { + // A map import, export or download is on the stack, and it is that + // operation's own qApp->processEvents() that has delivered whatever + // asked for this close. Destroying the Host here would free the TMap + // under its running loop (#9520), so tell the operation to stop and try + // again once the stack has unwound. Retried on a timer rather than + // immediately: the retry would otherwise land back in the same pump, + // spinning until the operation ends instead of letting it get there. + if (!pH->mpMap->mapOperationAbortRequested()) { + qDebug().nospace().noquote() << "mudlet::closeHost(\"" << name << "\") INFO - a map operation is still running, so the profile will be closed once it has stopped."; + } + pH->mpMap->requestMapOperationAbort(); + const QPointer<Host> pClosingHost(pH); + QTimer::singleShot(50ms, this, [this, name, pClosingHost]() { + if (mHostManager.getHost(name) != pClosingHost) { + // Somebody else closed it while we waited, and the name now + // belongs to a profile that was never asked to close. + return; + } + closeHost(name); + // The callers that defer to us run their own follow-up before this + // retry comes round, when the profile is still open and it does + // nothing. Left out, closing the last profile mid-operation ends + // with no profile and no connection dialog either. + updateMainWindowToolbarState(); + if (!mHostManager.getHostCount() && !mIsGoingDown) { + disableToolbarButtons(); + slot_showConnectionDialog(); + } + }); + return; + } + migrateDebugConsole(pH); // Clean up any main window dock widgets for this profile diff --git a/src/utils.h b/src/utils.h index 6105e0df2..1b2d8681f 100644 --- a/src/utils.h +++ b/src/utils.h @@ -74,6 +74,30 @@ public: return copyLen; } + // As copyString(), but for UTF-8 data that has to stay valid UTF-8: the copy + // stops at the last character that fits whole rather than at the last byte, + // so no trailing half-character is left behind. Use it wherever a truncated + // copy is handed on to something that decodes it - Discord discards an + // entire presence frame whose JSON payload carries an incomplete sequence. + // Returns the number of bytes copied (excluding the null terminator). + static size_t copyUtf8String(char* dest, size_t destSize, const char* src, size_t srcLen) + { + if (destSize == 0) { + return 0; + } + size_t copyLen = (srcLen < destSize) ? srcLen : destSize - 1; + // Every byte after the first of a multi-byte character has the form + // 10xxxxxx, so a cut in front of one is a cut inside a character: walk + // back to where that character starts. A cut that took everything (or + // that landed on a character start) needs no adjustment. + while (copyLen > 0 && copyLen < srcLen && (static_cast<unsigned char>(src[copyLen]) & 0xC0u) == 0x80u) { + --copyLen; + } + std::memcpy(dest, src, copyLen); + dest[copyLen] = '\0'; + return copyLen; + } + // This construct will be very useful for formatting tooltips and by // defining a static function/method here we can save using the same // qsl all over the place: diff --git a/test/DiscordTest.cpp b/test/DiscordTest.cpp index 3a145c4e9..7952f06f6 100644 --- a/test/DiscordTest.cpp +++ b/test/DiscordTest.cpp @@ -19,17 +19,17 @@ #include <discord.h> #include <Host.h> +#include <utils.h> #include <QFile> #include <QtTest/QtTest> -class DiscordTest : public QObject { +class DiscordTest : public QObject +{ Q_OBJECT private slots: - void initTestCase() - { - } + void initTestCase() {} // Test that convert() returns nullptr for empty string fields void testConvertNullIfEmpty() @@ -155,14 +155,79 @@ private slots: void testStringTruncation() { localDiscordPresence presence; - // Details buffer is 128 bytes - test with a string longer than that + // Discord documents details as holding 128 bytes, so a longer string is + // cut down to exactly that - the buffer allows for its own terminator + // rather than spending one of those 128 bytes on it (#9634). QString longString(200, QChar('A')); presence.setDetailText(longString); DiscordRichPresence converted = presence.convert(); QVERIFY(converted.details != nullptr); - // Should be truncated but not crash - QVERIFY(strlen(converted.details) < 128); + QCOMPARE(strlen(converted.details), size_t{128}); + } + + // A field of exactly the documented length has to arrive whole: an asset key + // that loses its last character resolves to no icon at all (#9634). + void testFullLengthFieldsSurviveWhole() + { + localDiscordPresence presence; + presence.setLargeImageKey(QString(32, QChar('a'))); + presence.setStateText(QString(128, QChar('s'))); + + DiscordRichPresence converted = presence.convert(); + QCOMPARE(strlen(converted.largeImageKey), size_t{32}); + QCOMPARE(strlen(converted.state), size_t{128}); + } + + // Truncation has to fall between characters. A field cut through the middle + // of a multi-byte one is no longer valid UTF-8, and Discord discards the + // whole presence frame carrying it rather than just that field (#9634). + void testTruncationKeepsUtf8Intact() + { + localDiscordPresence presence; + // 65 two-byte characters: 130 bytes, so the cut has to fall inside the + // 65th and take all of it. + presence.setDetailText(QString(65, QChar(0x00E9))); + // 17 of the same in a 32 byte field, which holds 16 of them. + presence.setLargeImageKey(QString(17, QChar(0x00E9))); + + DiscordRichPresence converted = presence.convert(); + QCOMPARE(QByteArray(converted.details), QString(64, QChar(0x00E9)).toUtf8()); + QCOMPARE(QByteArray(converted.largeImageKey), QString(16, QChar(0x00E9)).toUtf8()); + // A three-byte character has two ways to be cut in half, so check the + // other one too: 43 of them are 129 bytes. + presence.setStateText(QString(43, QChar(0x4F60))); + converted = presence.convert(); + QCOMPARE(QByteArray(converted.state), QString(42, QChar(0x4F60)).toUtf8()); + + // And an emoji, the four-byte case, where the walk-back has to step + // over three continuation bytes: 33 of them are 132 bytes. + const char32_t grinningFace = 0x1F600; + const QString emoji = QString::fromUcs4(&grinningFace, 1); + presence.setDetailText(emoji.repeated(33)); + converted = presence.convert(); + QCOMPARE(QByteArray(converted.details), emoji.repeated(32).toUtf8()); + } + + // The truncation itself, at boundaries the fixed-size presence fields + // cannot reach. + void testCopyUtf8StringEdgeCases() + { + char buffer[8]; + // Nothing to copy, and a destination too small even to terminate: + QCOMPARE(utils::copyUtf8String(buffer, sizeof(buffer), "", 0), size_t{0}); + QCOMPARE(utils::copyUtf8String(buffer, 0, "abc", 3), size_t{0}); + // Exactly filling the usable space is not a truncation, so there is + // nothing to walk back from: + QCOMPARE(utils::copyUtf8String(buffer, sizeof(buffer), "abcdefg", 7), size_t{7}); + QCOMPARE(QByteArray(buffer), QByteArray("abcdefg")); + // One byte too many, cut between characters: + QCOMPARE(utils::copyUtf8String(buffer, sizeof(buffer), "abcdefgh", 8), size_t{7}); + // Input that is nothing but continuation bytes cannot be cut anywhere + // valid, so an empty field is what comes out - never a broken sequence. + const char continuationBytes[] = "\x80\x80\x80\x80\x80\x80\x80\x80\x80"; + QCOMPARE(utils::copyUtf8String(buffer, sizeof(buffer), continuationBytes, 9), size_t{0}); + QCOMPARE(QByteArray(buffer), QByteArray()); } // Test that Discord username comparison is case-insensitive. @@ -233,9 +298,7 @@ private slots: QVERIFY2(checked >= 22, qPrintable(qsl("only categorised %1 Discord Lua functions - has the source moved?").arg(checked))); } - void cleanupTestCase() - { - } + void cleanupTestCase() {} }; #include "DiscordTest.moc" diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index 478213ab5..951961942 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -40,6 +40,8 @@ set(FUNCTIONAL_TEST_SOURCES ModuleSaveTeardownTest.cpp MapRoundTripTest.cpp MapProgressDialogSeamTest.cpp + MapCloseDuringImportTest.cpp + TtsInterruptingSpeakTest.cpp UndoServerWrapTest.cpp NarrowWindowWrapTest.cpp HostWidgetDecouplingTest.cpp @@ -148,7 +150,7 @@ endif() # The round-trip tests boot a full mudlet instance and save/reload profile and # map data, so they need a longer timeout -set_tests_properties(ProfileRoundTripTest MapRoundTripTest MapProgressDialogSeamTest PROPERTIES TIMEOUT 300) +set_tests_properties(ProfileRoundTripTest MapRoundTripTest MapProgressDialogSeamTest MapCloseDuringImportTest PROPERTIES TIMEOUT 300) # HostWidgetDecouplingTest creates a fresh profile per test method, so it needs a longer timeout set_tests_properties(HostWidgetDecouplingTest PROPERTIES TIMEOUT 300) diff --git a/test/functional_tests/MapCloseDuringImportTest.cpp b/test/functional_tests/MapCloseDuringImportTest.cpp new file mode 100644 index 000000000..968ebdd23 --- /dev/null +++ b/test/functional_tests/MapCloseDuringImportTest.cpp @@ -0,0 +1,248 @@ +/*************************************************************************** + * Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +/* + * Regression guard for #9520: closing a profile while its map was being + * imported or exported used to free the TMap while its own loop was still + * running. + * + * Mudlet is single threaded, so nothing here is a race. The interleaving is + * re-entrancy: TMap::readJsonMapFile() and TMap::writeJsonMapFile() call + * qApp->processEvents() once per area to keep their progress display alive and + * its Abort button clickable, and that pump delivers whatever else the event + * loop is holding - including the zero-millisecond timer that + * mudlet::slot_closeProfileByName() posts to run mudlet::closeHost(). That call + * takes the profile's QSharedPointer<Host> out of the host pool, which destroys + * the Host and, with it, the TMap whose loop is still on the stack. Everything + * the reader touches after that is freed memory. + * + * These tests stage exactly that, through the same public slot the tab close + * and closeProfile() use, and let the operation's own pump deliver the timer. A + * QPointer to the map is how they tell: it goes null the moment the TMap is + * destroyed, so the failure is reported rather than left to whatever the freed + * memory happens to hold. Without the fix that assertion fails - and under ASan + * the run additionally reports the use-after-free that follows it. + * + * Run with: ctest -R MapCloseDuringImportTest -V + */ + +#include <QtTest/QtTest> + +#include <QDeadlineTimer> +#include <QPointer> +#include <QTemporaryDir> + +#include <chrono> + +#include "Host.h" +#include "HostManager.h" +#include "MudletInstanceCoordinator.h" +#include "TMap.h" +#include "TRoomDB.h" +#include "mudlet.h" + +using namespace std::chrono_literals; + +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); +void initializeQRCResourcesForMapCloseDuringImportTest(); + +class MapCloseDuringImportTest : public QObject +{ + Q_OBJECT + +private: + const QString mSourceName = qsl("MapCloseDuringImportSource-Test"); + // A name of its own per test: a test that fails part way through can leave + // its deferred close pending on a timer, and a later test reusing the name + // would have that close land on its profile instead. + const QString mImportTargetName = qsl("MapCloseDuringImportTarget-Test"); + const QString mExportTargetName = qsl("MapCloseDuringExportTarget-Test"); + QTemporaryDir mConfigDir; + QTemporaryDir mSaveDir; + QByteArray mSavedXdg; + QString mMapFile; + + // Enough areas that the operation pumps the event loop many times over: the + // progress increment that delivers the close is reached once per area. + static constexpr int areaCount = 40; + + void buildMap(Host* pHost) + { + TMap* pMap = pHost->mpMap.data(); + TRoomDB* pDB = pMap->mpRoomDB.get(); + int roomId = 1; + for (int area = 0; area < areaCount; ++area) { + const int areaId = pDB->addArea(qsl("Area %1").arg(area)); + QVERIFY(areaId > 0); + for (int room = 0; room < 5; ++room, ++roomId) { + QVERIFY(pMap->addRoom(roomId)); + QVERIFY(pMap->setRoomArea(roomId, areaId, false)); + QVERIFY(pMap->setRoomCoordinates(roomId, room, area, 0)); + } + } + } + + Host* addProfile(const QString& name) + { + auto& hostManager = mudlet::self()->getHostManager(); + if (!hostManager.addHost(name, qsl("23"), QString(), QString())) { + return nullptr; + } + return hostManager.getHost(name); + } + + // Runs the event loop until the profile is gone. The close is deferred + // until the map operation has unwound, so this is where it lands. + bool waitForProfileToClose(const QString& name) + { + QDeadlineTimer deadline(10s); + while (mudlet::self()->getHostManager().getHost(name)) { + if (deadline.hasExpired()) { + return false; + } + qApp->processEvents(QEventLoop::AllEvents, 20); + } + return true; + } + +private slots: + void initTestCase() + { + initializeQRCResourcesForMapCloseDuringImportTest(); + + QVERIFY(mConfigDir.isValid()); + QVERIFY(mSaveDir.isValid()); + mSavedXdg = qgetenv("XDG_CONFIG_HOME"); + QVERIFY(QDir().mkpath(qsl("%1/mudlet/profiles").arg(mConfigDir.path()))); + qputenv("XDG_CONFIG_HOME", mConfigDir.path().toUtf8()); + + mudlet::start(); + mudlet::self()->setupConfig(); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique<MudletInstanceCoordinator>("MudletInstanceCoordinator")); + mudlet::self()->init(); + mudlet::self()->setStorePasswordsSecurely(false); + + // Kept for the whole run, so that closing the profile under test never + // leaves Mudlet with no profiles at all and popping its connection + // dialog at an offscreen test. + Host* pSource = addProfile(mSourceName); + QVERIFY2(pSource, "failed to create the source Host"); + buildMap(pSource); + if (QTest::currentTestFailed()) { + return; + } + + mMapFile = qsl("%1/close-during-import.json").arg(mSaveDir.path()); + const auto [wrote, writeMessage] = pSource->mpMap->writeJsonMapFile(mMapFile); + QVERIFY2(wrote, qPrintable(writeMessage)); + } + + void cleanupTestCase() + { + delete mudlet::self(); + mSavedXdg.isNull() ? qunsetenv("XDG_CONFIG_HOME") : qputenv("XDG_CONFIG_HOME", mSavedXdg); + } + + void test_closingTheProfileDuringAJsonImportDoesNotFreeTheMap() + { + Host* pTarget = addProfile(mImportTargetName); + QVERIFY2(pTarget, "failed to create the target Host"); + TMap* pTargetMap = pTarget->mpMap.data(); + const QPointer<TMap> mapWatch(pTargetMap); + + bool closeRequested = false; + const QMetaObject::Connection closeOnProgress = connect(pTargetMap, &TMap::signal_mapProgressSetValue, pTargetMap, [&]() { + if (closeRequested) { + return; + } + closeRequested = true; + // The same slot the tab's close button and closeProfile() use: it + // posts closeHost() as a zero-millisecond timer, which the import's + // own processEvents() then delivers with the import on the stack. + mudlet::self()->slot_closeProfileByName(mImportTargetName); + }); + const auto [read, readMessage] = pTargetMap->readJsonMapFile(mMapFile); + disconnect(closeOnProgress); + + QVERIFY2(closeRequested, "the import never announced any progress, so no close was delivered into its pump"); + QVERIFY2(!mapWatch.isNull(), "the TMap was destroyed while its own import loop was still on the stack"); + // A close asked for mid-import stops it rather than reading a whole map + // into a profile that is going away: + QVERIFY2(!read, "the import was expected to stop once the close asked it to"); + QCOMPARE(readMessage, qsl("aborted by user")); + // ...and deferring the close must not drop it: + QVERIFY2(waitForProfileToClose(mImportTargetName), "the deferred close never completed once the import had unwound"); + QVERIFY2(mapWatch.isNull(), "the TMap outlived the profile it belongs to"); + } + + // The export half of the same loop, which pumps the event loop the same way. + void test_closingTheProfileDuringAJsonExportDoesNotFreeTheMap() + { + Host* pTarget = addProfile(mExportTargetName); + QVERIFY2(pTarget, "failed to create the target Host"); + TMap* pTargetMap = pTarget->mpMap.data(); + buildMap(pTarget); + if (QTest::currentTestFailed()) { + return; + } + const QPointer<TMap> mapWatch(pTargetMap); + + bool closeRequested = false; + const QMetaObject::Connection closeOnProgress = connect(pTargetMap, &TMap::signal_mapProgressSetValue, pTargetMap, [&]() { + if (closeRequested) { + return; + } + closeRequested = true; + mudlet::self()->slot_closeProfileByName(mExportTargetName); + }); + const auto [wrote, writeMessage] = pTargetMap->writeJsonMapFile(qsl("%1/close-during-export.json").arg(mSaveDir.path())); + disconnect(closeOnProgress); + + QVERIFY2(closeRequested, "the export never announced any progress, so no close was delivered into its pump"); + QVERIFY2(!mapWatch.isNull(), "the TMap was destroyed while its own export loop was still on the stack"); + // As with the import: the close stops the operation rather than writing + // a whole map out of a profile that is going away. + QVERIFY2(!wrote, "the export was expected to stop once the close asked it to"); + QCOMPARE(writeMessage, qsl("aborted by user")); + QVERIFY2(waitForProfileToClose(mExportTargetName), "the deferred close never completed once the export had unwound"); + QVERIFY2(mapWatch.isNull(), "the TMap outlived the profile it belongs to"); + } +}; + +void initializeQRCResourcesForMapCloseDuringImportTest() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +#include "MapCloseDuringImportTest.moc" +QTEST_MAIN(MapCloseDuringImportTest) diff --git a/test/functional_tests/TtsInterruptingSpeakTest.cpp b/test/functional_tests/TtsInterruptingSpeakTest.cpp new file mode 100644 index 000000000..307c43d52 --- /dev/null +++ b/test/functional_tests/TtsInterruptingSpeakTest.cpp @@ -0,0 +1,243 @@ +/*************************************************************************** + * Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +/* + * Regression guard for #9659: an interrupting ttsSpeak() dropping the utterance + * it was asked to speak. + * + * Every speech engine Qt wraps stops the running utterance inside say() and + * reports Ready for it - speech-dispatcher, SAPI, WinRT and AVFoundation all + * do. Mudlet raises its TTS events off those state changes and drains + * ttsQueue() on any Ready, so that one was read as "the engine is idle": the + * queued line was spoken straight over the utterance the script had just asked + * for, and that utterance was never heard at all. + * + * Qt's mock engine, which the Lua specs in Media_spec.lua use, never reports + * that Ready - it stays in Speaking with no state change at all, which is the + * other half of the same issue and is covered there. So the guard itself needs + * that Ready delivered the way a real engine delivers it, which is what this + * test does: it drives the Lua API for everything else and hands + * TLuaInterpreter::ttsStateChanged() the state change the engine's + * QTextToSpeech::stateChanged signal would have carried. + * + * Run with: ctest -R TtsInterruptingSpeakTest -V + */ + +#include <QtTest/QtTest> + +#include <QTemporaryDir> + +#include "Host.h" +#include "HostManager.h" +#include "MudletInstanceCoordinator.h" +#include "TLuaInterpreter.h" +#include "TScript.h" +#include "ScriptUnit.h" +#include "mudlet.h" + +#ifdef QT_TEXTTOSPEECH_LIB +#include <QTextToSpeech> +#endif + +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); +void initializeQRCResourcesForTtsInterruptingSpeakTest(); + +class TtsInterruptingSpeakTest : public QObject +{ + Q_OBJECT + +private: + Host* mpHost = nullptr; + const QString mProfileName = qsl("TtsInterruptingSpeak-Test"); + QTemporaryDir mConfigDir; + QByteArray mSavedXdg; + +#ifdef QT_TEXTTOSPEECH_LIB + // Runs a snippet in the profile's Lua state, failing the test with the + // script's own error message when it does not run cleanly. Lua assert()s in + // the snippet are how the queue and the current line are read back. + bool runLua(const QString& script) { return mpHost->getLuaInterpreter()->compileAndExecuteScript(script); } + + // Counts ttsSpeechStarted from here on in the Lua global ttsStartedCount. A + // TScript rather than registerAnonymousEventHandler(): this console-less + // Host never loads LuaGlobals.lua, where that function is defined. + bool countStartedEvents() + { + auto pScript = new TScript(nullptr, mpHost); + mpHost->getScriptUnit()->registerScript(pScript); + pScript->setName(qsl("ttsStartedCounter")); + if (!pScript->setScript(qsl("ttsStartedCount = 0\nfunction ttsStartedCounter(event, text)\n ttsStartedCount = ttsStartedCount + 1\nend\n"))) { + return false; + } + pScript->setEventHandlerList(QStringList{qsl("ttsSpeechStarted")}); + pScript->setIsActive(true); + return true; + } +#endif + +private slots: + void initTestCase() + { + initializeQRCResourcesForTtsInterruptingSpeakTest(); + + QVERIFY(mConfigDir.isValid()); + mSavedXdg = qgetenv("XDG_CONFIG_HOME"); + QVERIFY(QDir().mkpath(qsl("%1/mudlet/profiles").arg(mConfigDir.path()))); + qputenv("XDG_CONFIG_HOME", mConfigDir.path().toUtf8()); + // Picked up by TLuaInterpreter::ttsBuild(), which then asks for Qt's + // deterministic mock engine instead of whatever the host machine would + // otherwise speak out loud. + qputenv("MUDLET_TEST_MODE", "1"); + + mudlet::start(); + mudlet::self()->setupConfig(); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique<MudletInstanceCoordinator>("MudletInstanceCoordinator")); + mudlet::self()->init(); + mudlet::self()->setStorePasswordsSecurely(false); + + QVERIFY2(mudlet::self()->getHostManager().addHost(mProfileName, qsl("23"), QString(), QString()), "failed to create the Host"); + mpHost = mudlet::self()->getHostManager().getHost(mProfileName); + QVERIFY(mpHost); + // A bare Host blocks script compilation until the full profile boot + // would clear this, and these tests need their snippets to compile: + mpHost->mBlockScriptCompile = false; + } + + void cleanupTestCase() + { + mpHost = nullptr; + delete mudlet::self(); + qunsetenv("MUDLET_TEST_MODE"); + mSavedXdg.isNull() ? qunsetenv("XDG_CONFIG_HOME") : qputenv("XDG_CONFIG_HOME", mSavedXdg); + } + + // The TTS state - engine, queue, and the flags this fixes - is process + // global, so it is reset after every test method rather than at the end of + // each, where an assertion that fails would jump over it. + void cleanup() + { +#ifdef QT_TEXTTOSPEECH_LIB + if (mpHost) { + runLua(qsl("ttsClearQueue() ttsSkip()")); + } +#endif + } + + void test_theReadyFromAnInterruptedUtteranceDoesNotDrainTheQueue() + { +#ifndef QT_TEXTTOSPEECH_LIB + QSKIP("Mudlet was built without text-to-speech support"); +#else + QVERIFY2(runLua(qsl("ttsClearQueue() ttsSkip()")), "could not reset the TTS state"); + if (!runLua(qsl("assert(#ttsGetVoices() > 0)"))) { + QSKIP("Qt's mock speech engine is unavailable here, so nothing can be made to speak"); + } + + QVERIFY(runLua(qsl("ttsSpeak('the utterance already being spoken')"))); + QVERIFY(runLua(qsl("ttsQueue('the queued line')"))); + QVERIFY(runLua(qsl("ttsSpeak('the utterance the script asked for')"))); + + // What every real engine reports next: the utterance say() stopped has + // ended. It is not the engine falling idle, and the queue must survive + // it - the requested utterance is what should be being spoken. + TLuaInterpreter::ttsStateChanged(QTextToSpeech::State::Ready); + + QVERIFY2(runLua(qsl("assert(#ttsGetQueue() == 1, 'the queued line was spoken over the utterance ttsSpeak() asked for, queue holds '..#ttsGetQueue())")), + "the queue was drained by the Ready that reported the interrupted utterance ending"); + QVERIFY2(runLua(qsl("assert(ttsGetCurrentLine() == 'the utterance the script asked for', 'the current line became: '..tostring(ttsGetCurrentLine()))")), + "the drained line replaced the utterance the script asked for"); + + // The engine getting round to reporting that the requested utterance + // started must not announce it a second time: ttsSpeak() already did, + // there being no state edge at the time for it to have come from. + QVERIFY2(countStartedEvents(), "could not install the event handler that counts ttsSpeechStarted"); + TLuaInterpreter::ttsStateChanged(QTextToSpeech::State::Speaking); + QVERIFY2(runLua(qsl("assert(ttsStartedCount == 0, 'the utterance was announced '..ttsStartedCount..' more time(s)')")), + "the engine's late Speaking announced the same utterance a second time"); +#endif + } + + // The control for the test above: with nothing interrupted, that same Ready + // is the engine going idle and has to drain the queue. Without this, a + // change that stopped ttsStateChanged() draining at all would leave the + // test above passing while the queue feature was dead. + void test_theReadyFromAnUninterruptedUtteranceStillDrainsTheQueue() + { +#ifndef QT_TEXTTOSPEECH_LIB + QSKIP("Mudlet was built without text-to-speech support"); +#else + QVERIFY2(runLua(qsl("ttsClearQueue() ttsSkip()")), "could not reset the TTS state"); + if (!runLua(qsl("assert(#ttsGetVoices() > 0)"))) { + QSKIP("Qt's mock speech engine is unavailable here, so nothing can be made to speak"); + } + + QVERIFY(runLua(qsl("ttsSpeak('the only utterance')"))); + QVERIFY(runLua(qsl("ttsQueue('the queued line')"))); + + TLuaInterpreter::ttsStateChanged(QTextToSpeech::State::Ready); + + QVERIFY2(runLua(qsl("assert(#ttsGetQueue() == 0, 'the queue was not drained, it holds '..#ttsGetQueue())")), "an idle engine left the queue undrained"); + QVERIFY2(runLua(qsl("assert(ttsGetCurrentLine() == 'the queued line', 'the current line is: '..tostring(ttsGetCurrentLine()))")), "the drain did not start speaking the queued line"); +#endif + } + + // The other side of the same guard: an explicit stop really does leave the + // engine idle, so its Ready has to keep draining the queue as it always has. + void test_theReadyFromAnExplicitSkipStillDrainsTheQueue() + { +#ifndef QT_TEXTTOSPEECH_LIB + QSKIP("Mudlet was built without text-to-speech support"); +#else + QVERIFY2(runLua(qsl("ttsClearQueue() ttsSkip()")), "could not reset the TTS state"); + if (!runLua(qsl("assert(#ttsGetVoices() > 0)"))) { + QSKIP("Qt's mock speech engine is unavailable here, so nothing can be made to speak"); + } + + QVERIFY(runLua(qsl("ttsSpeak('the utterance being spoken over')"))); + QVERIFY(runLua(qsl("ttsSpeak('the utterance the script asked for')"))); + QVERIFY(runLua(qsl("ttsQueue('the queued line')"))); + QVERIFY(runLua(qsl("ttsSkip()"))); + + QVERIFY2(runLua(qsl("assert(#ttsGetQueue() == 0, 'the queue still holds '..#ttsGetQueue())")), "an explicit skip left the queue undrained"); + QVERIFY2(runLua(qsl("assert(ttsGetCurrentLine() == 'the queued line', 'the current line is: '..tostring(ttsGetCurrentLine()))")), "the skip did not start speaking the queued line"); +#endif + } +}; + +void initializeQRCResourcesForTtsInterruptingSpeakTest() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +#include "TtsInterruptingSpeakTest.moc" +QTEST_MAIN(TtsInterruptingSpeakTest) From e3204258feb0d7028a1db07d1e20bbfe760e183b Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Fri, 7 Aug 2026 06:12:30 +0200 Subject: [PATCH 108/155] fix: stop the test-only waitForEvent() wedging Mudlet on macOS (#9691) #### Brief overview of PR changes/additions - Fixes #9670 "Mudlet stops responding on macOS part way through the package specs": the test-only `waitForEvent()` ran a nested `QEventLoop::exec()`, which the Cocoa dispatcher services by re-entering `-[NSApplication run]` from inside the timer callout it is already in - so no Qt timer, including the wait's own timeout, ever fires again. `EventLoopPump::pumpFor()` drives `processEvents()` against a deadline instead, which activates Qt's timers on every pass. - Lifts the macOS pending gate the package specs have carried since they were written: ~40 specs now run on both macOS legs, green. - Fixes four pre-existing crashes (each reproduced on `development` under ASan) when a profile or the application is closed from a handler delivered during a wait: profile closes are held off while a pump runs, application shutdowns postpone rather than cancel. #### Motivation for adding to Mudlet macOS was the only platform not running the package specs, and the hang wedged real CI runs. #### Other info (issues closed, discussion etc) Test case: #9689's harness with this fix runs the previously hanging suite to completion (2277/0) on both macOS runners; this PR's own legs: 2370/0 on both macOS arches, 2426/0 on Linux with ASan and leak checking. Assisted-by: Claude:claude-opus-5 --- src/CMakeLists.txt | 2 + src/EventLoopPump.cpp | 60 +++++++++ src/EventLoopPump.h | 34 +++++ src/Host.cpp | 10 +- src/TLuaInterpreter.cpp | 6 +- src/TLuaInterpreter.h | 21 ++- src/TLuaInterpreterMudletObjects.cpp | 105 +++++++++++---- src/mudlet-lua/tests/MudletBusted_spec.lua | 55 ++++++++ src/mudlet-lua/tests/Networking_spec.lua | 8 +- src/mudlet-lua/tests/Package_spec.lua | 127 ++++--------------- src/mudlet.cpp | 75 +++++++++-- src/mudlet.h | 2 + test/CMakeLists.txt | 5 + test/EventLoopPumpTest.cpp | 141 +++++++++++++++++++++ 14 files changed, 484 insertions(+), 167 deletions(-) create mode 100644 src/EventLoopPump.cpp create mode 100644 src/EventLoopPump.h create mode 100644 test/EventLoopPumpTest.cpp diff --git a/src/CMakeLists.txt b/src/CMakeLists.txt index e18bfee5f..1e3ac52c8 100644 --- a/src/CMakeLists.txt +++ b/src/CMakeLists.txt @@ -87,6 +87,7 @@ set(mudlet_SRCS EditorMoveItemCommand.cpp EditorToggleActiveCommand.cpp EditorUndoStack.cpp + EventLoopPump.cpp exitstreewidget.cpp FileOpenHandler.cpp FontManager.cpp @@ -315,6 +316,7 @@ set(mudlet_HDRS EditorToggleActiveCommand.h EditorUndoStack.h enums.h + EventLoopPump.h exitstreewidget.h FileOpenHandler.h FontManager.h diff --git a/src/EventLoopPump.cpp b/src/EventLoopPump.cpp new file mode 100644 index 000000000..886f191ff --- /dev/null +++ b/src/EventLoopPump.cpp @@ -0,0 +1,60 @@ +/*************************************************************************** + * Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +#include "EventLoopPump.h" + +#include <QCoreApplication> +#include <QDeadlineTimer> +#include <QDebug> +#include <QEventLoop> +#include <QThread> + +// A nested QEventLoop::exec() cannot be used here. exec() sets +// QEventLoop::EventLoopExec, which QCocoaEventDispatcher answers by re-entering +// -[NSApplication run] and leaving Qt's timers to the platform run loop; nested +// inside a Qt timer callback that run loop never wakes it again, so not even +// the wait's own timeout fires (issue #9670). processEvents() instead takes the +// branch that drives the dispatcher's processTimers() on every pass. +bool EventLoopPump::pumpFor(const int timeoutMs, const std::function<bool()>& stopCondition) +{ + // processEvents() returns silently without a dispatcher, which would make + // this a plain sleep that then reports a timeout as though it had waited. + if (!QThread::currentThread()->eventDispatcher()) { + qWarning() << "EventLoopPump::pumpFor() called with no event dispatcher on this thread, no events can be delivered"; + return false; + } + + QDeadlineTimer deadline(qMax(timeoutMs, 0)); + if (stopCondition && stopCondition()) { + return true; + } + + while (true) { + QCoreApplication::processEvents(QEventLoop::AllEvents); + if (stopCondition && stopCondition()) { + return true; + } + if (deadline.hasExpired()) { + return false; + } + // A pass returns as soon as nothing is pending, so without this the loop + // spins a core flat for the whole timeout. + QThread::msleep(1); + } +} diff --git a/src/EventLoopPump.h b/src/EventLoopPump.h new file mode 100644 index 000000000..be305c9b4 --- /dev/null +++ b/src/EventLoopPump.h @@ -0,0 +1,34 @@ +#ifndef MUDLET_EVENTLOOPPUMP_H +#define MUDLET_EVENTLOOPPUMP_H + +/*************************************************************************** + * Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +#include <functional> + +class EventLoopPump +{ +public: + // Delivers Qt events for up to timeoutMs. True means stopCondition became + // true, false means the time ran out. Not a nested QEventLoop::exec(): see + // EventLoopPump.cpp for why exec() cannot be used here. + [[nodiscard]] static bool pumpFor(int timeoutMs, const std::function<bool()>& stopCondition = {}); +}; + +#endif // MUDLET_EVENTLOOPPUMP_H diff --git a/src/Host.cpp b/src/Host.cpp index eaf76eb3c..375f7d7fb 100644 --- a/src/Host.cpp +++ b/src/Host.cpp @@ -900,12 +900,10 @@ bool Host::resetProfile_phase1() return false; } - // A test-mode waitForEvent() is blocked in a nested event loop on this - // profile's lua_State; phase2 would lua_close() that state underneath it (a - // use-after-free). Refuse until the wait finishes. Always empty (so a no-op) - // outside MUDLET_TEST_MODE, where waitForEvent() is inert. - if (mLuaInterpreter.hasPendingEventWaits()) { - qWarning() << "Host::resetProfile_phase1() called while a waitForEvent() is blocked, ignoring"; + // Phase 2 lua_close()s the very state the pump is running Lua code on, so + // refuse rather than reset into a use-after-free. + if (mLuaInterpreter.pumpingEvents()) { + qWarning() << "Host::resetProfile_phase1() called while the test-mode event pump is running, ignoring"; return false; } diff --git a/src/TLuaInterpreter.cpp b/src/TLuaInterpreter.cpp index e2ec23072..7d2d9bc41 100644 --- a/src/TLuaInterpreter.cpp +++ b/src/TLuaInterpreter.cpp @@ -4977,8 +4977,6 @@ int TLuaInterpreter::createEventArgsTableRef(const TEvent& pE) } // No documentation available in wiki - internal, test-only helper for waitForEvent() -// If a waitForEvent() call is blocked waiting for this event, capture its -// arguments and quit that call's nested event loop. Called from Host::raiseEvent(). void TLuaInterpreter::captureEventForWaits(const TEvent& pE) { if (mPendingEventWaits.isEmpty() || pE.mArgumentList.isEmpty()) { @@ -4991,9 +4989,6 @@ void TLuaInterpreter::captureEventForWaits(const TEvent& pE) } pWait->mArgsRef = createEventArgsTableRef(pE); pWait->mCaptured = true; - if (pWait->mpLoop) { - pWait->mpLoop->quit(); - } } } @@ -5409,6 +5404,7 @@ void TLuaInterpreter::initLuaGlobals() lua_register(pGlobalLua, "tempLineTrigger", TLuaInterpreter::tempLineTrigger); lua_register(pGlobalLua, "raiseEvent", TLuaInterpreter::raiseEvent); lua_register(pGlobalLua, "waitForEvent", TLuaInterpreter::waitForEvent); + lua_register(pGlobalLua, "pumpEvents", TLuaInterpreter::pumpEvents); lua_register(pGlobalLua, "deleteLine", TLuaInterpreter::deleteLine); lua_register(pGlobalLua, "copy", TLuaInterpreter::copy); lua_register(pGlobalLua, "cut", TLuaInterpreter::cut); diff --git a/src/TLuaInterpreter.h b/src/TLuaInterpreter.h index d0c1f935d..d47642dde 100644 --- a/src/TLuaInterpreter.h +++ b/src/TLuaInterpreter.h @@ -62,7 +62,6 @@ extern "C" { #include <optional> class Host; -class QEventLoop; class TAction; class TEvent; class TLuaThread; @@ -398,6 +397,7 @@ public: static int tempLineTrigger(lua_State*); static int raiseEvent(lua_State*); static int waitForEvent(lua_State*); + static int pumpEvents(lua_State*); static int deleteLine(lua_State*); static int copy(lua_State*); static int cut(lua_State*); @@ -792,14 +792,11 @@ public: void freeLuaRegistryIndex(int index); void freeAllInLuaRegistry(TEvent); - // Test-only support for the waitForEvent() Lua helper (MUDLET_TEST_MODE): - // called from Host::raiseEvent() so an event that fires while a busted spec - // is blocked inside a nested event loop can be captured and unblock it. + // Called from Host::raiseEvent(), to unblock a waitForEvent() on that event. void captureEventForWaits(const TEvent&); - // True while a waitForEvent() call is blocked in its nested event loop. Lets - // Host refuse a profile reset that would lua_close() the state out from - // under it. Always false (a no-op) outside MUDLET_TEST_MODE. - bool hasPendingEventWaits() const { return !mPendingEventWaits.isEmpty(); } + // Lets callers refuse anything that would lua_close() the state the pump is + // running Lua on. Always false outside MUDLET_TEST_MODE. + bool pumpingEvents() const { return !mPendingEventWaits.isEmpty() || mEventPumpDepth > 0; } inline static const QMap<Qt::MouseButton, QString> csmMouseButtons = { {Qt::NoButton, qsl("NoButton")}, {Qt::LeftButton, qsl("LeftButton")}, {Qt::RightButton, qsl("RightButton")}, {Qt::MiddleButton, qsl("MidButton")}, @@ -925,16 +922,18 @@ private: QVector<QVector<QPair<QString, QString>>> mMultiCaptureNameGroups; QMap<QNetworkReply*, QString> downloadMap; - // A waitForEvent() call in progress: the nested event loop to quit when the - // named event arrives, plus a Lua registry reference to the captured args. + // A waitForEvent() call in progress. mArgsRef is a Lua registry reference, + // so it has to be unref'd once the waiter has read it. struct TEventWait { QString mName; - QEventLoop* mpLoop = nullptr; int mArgsRef = LUA_NOREF; bool mCaptured = false; }; QList<TEventWait*> mPendingEventWaits; + // pumpEvents() registers no TEventWait of its own, so it needs its own + // counter to be visible to pumpingEvents(). + int mEventPumpDepth = 0; int createEventArgsTableRef(const TEvent&); lua_State* pGlobalLua = nullptr; diff --git a/src/TLuaInterpreterMudletObjects.cpp b/src/TLuaInterpreterMudletObjects.cpp index e3ccd425a..d4bcaf6cc 100644 --- a/src/TLuaInterpreterMudletObjects.cpp +++ b/src/TLuaInterpreterMudletObjects.cpp @@ -31,6 +31,7 @@ #include "TLuaInterpreter.h" #include "EAction.h" +#include "EventLoopPump.h" #include "Host.h" #include "TAlias.h" #include "TArea.h" @@ -60,6 +61,8 @@ #include "glwidget_integration.h" #endif +#include <QScopeGuard> + #include <algorithm> #include <cmath> #include <limits> @@ -85,9 +88,7 @@ #include <QCollator> #include <QCoreApplication> #include <QDesktopServices> -#include <QEventLoop> #include <QFileDialog> -#include <QTimer> #include <QFileInfo> #include <QMovie> #include <QVector> @@ -1559,14 +1560,19 @@ int TLuaInterpreter::raiseEvent(lua_State* L) return 1; } +// A gone Host, or a mudlet singleton already past its destructor, is further +// along than the flags rather than healthier, so the nulls count as shutting +// down too. +static bool shuttingDown(const QPointer<Host>& pHost) +{ + mudlet* pMudlet = mudlet::self(); + return !pHost || pHost->isClosingDown() || !pMudlet || pMudlet->isGoingDown(); +} + // No documentation available in wiki - internal, test-only function -// Blocks the calling Lua code inside a nested Qt event loop until the named -// event is raised (returning the event name followed by its arguments, exactly -// as an event handler would receive them) or the timeout elapses (returning -// nil and an error message). Timers, networking and other events keep being -// processed while blocked, which is what lets busted specs observe asynchronous -// behaviour without sleeps. Gated behind MUDLET_TEST_MODE so it is inert for -// normal users. +// Blocks the calling Lua code until the named event is raised, returning the +// event name and its arguments exactly as an event handler would receive them, +// or nil and an error message. Timers and networking run on meanwhile. int TLuaInterpreter::waitForEvent(lua_State* L) { if (!qEnvironmentVariableIsSet("MUDLET_TEST_MODE")) { @@ -1597,36 +1603,33 @@ int TLuaInterpreter::waitForEvent(lua_State* L) Host& host = getHostFromLua(L); TLuaInterpreter* pLuaInterpreter = host.getLuaInterpreter(); - // A profile reset recreates this profile's lua_State (initLuaGlobals() calls - // lua_close()), and shutdown destroys the interpreter outright. Either would - // free the state L is executing on while we block, so refuse rather than risk - // a use-after-free when the nested loop unwinds. resetProfile_phase1() guards - // the mirror case where a reset is requested while we are already blocked. + // A reset recreates this lua_State and a shutdown destroys the interpreter, + // either of which frees the state L runs on mid-wait. resetProfile_phase1() + // guards the mirror case, a reset asked for once we are already blocked. if (host.profileResetInProgress() || host.isClosingDown()) { lua_pushnil(L); lua_pushstring(L, "waitForEvent: cannot wait while the profile is being reset or Mudlet is closing"); return 2; } - QEventLoop loop; TEventWait wait; wait.mName = eventName; - wait.mpLoop = &loop; pLuaInterpreter->mPendingEventWaits.append(&wait); - QTimer timeoutTimer; - timeoutTimer.setSingleShot(true); - QObject::connect(&timeoutTimer, &QTimer::timeout, &loop, &QEventLoop::quit); - timeoutTimer.start(timeoutMs); + const QPointer<Host> pHost(&host); + const bool stoppedEarly = EventLoopPump::pumpFor(timeoutMs, [&wait, &pHost]() { + return wait.mCaptured || shuttingDown(pHost); + }); - loop.exec(); - - timeoutTimer.stop(); pLuaInterpreter->mPendingEventWaits.removeAll(&wait); if (!wait.mCaptured) { lua_pushnil(L); - lua_pushstring(L, qsl("waitForEvent: timed out after %1ms waiting for event '%2'").arg(QString::number(timeoutMs), eventName).toUtf8().constData()); + if (stoppedEarly) { + lua_pushstring(L, qsl("waitForEvent: gave up waiting for event '%1', Mudlet is shutting down").arg(eventName).toUtf8().constData()); + } else { + lua_pushstring(L, qsl("waitForEvent: timed out after %1ms waiting for event '%2'").arg(QString::number(timeoutMs), eventName).toUtf8().constData()); + } return 2; } @@ -1654,6 +1657,60 @@ int TLuaInterpreter::waitForEvent(lua_State* L) return argCount; } +// No documentation available in wiki - internal, test-only function +// Keeps Mudlet delivering events for the given number of milliseconds: the +// sleep a spec wants to let queued work run when there is no named event to +// wait for. +int TLuaInterpreter::pumpEvents(lua_State* L) +{ + if (!qEnvironmentVariableIsSet("MUDLET_TEST_MODE")) { + lua_pushnil(L); + lua_pushstring(L, "pumpEvents: only available in test mode (set the MUDLET_TEST_MODE environment variable)"); + return 2; + } + + // The ceiling matches waitForEvent()'s: below busted's per-spec CI timeout, + // so a runaway pump fails on its own rather than taking the suite with it. + constexpr int defaultTimeoutMs = 50; + constexpr int maximumTimeoutMs = 30000; + int timeoutMs = defaultTimeoutMs; + if (!lua_isnoneornil(L, 1)) { + timeoutMs = getVerifiedInt(L, __func__, 1, "duration in milliseconds", true); + } + timeoutMs = std::clamp(timeoutMs, 0, maximumTimeoutMs); + + Host& host = getHostFromLua(L); + TLuaInterpreter* pLuaInterpreter = host.getLuaInterpreter(); + + // Same use-after-free waitForEvent() guards, and worse here: the pump is + // itself what delivers the zero-timer phase2 is armed on. + if (host.profileResetInProgress() || host.isClosingDown()) { + lua_pushnil(L); + lua_pushstring(L, "pumpEvents: cannot pump while the profile is being reset or Mudlet is closing"); + return 2; + } + + const QPointer<Host> pHost(&host); + ++pLuaInterpreter->mEventPumpDepth; + const auto pumpGuard = qScopeGuard([pLuaInterpreter]() { + --pLuaInterpreter->mEventPumpDepth; + }); + const bool stoppedEarly = EventLoopPump::pumpFor(timeoutMs, [&pHost]() { + return shuttingDown(pHost); + }); + + if (stoppedEarly) { + // Ran short, so whatever the caller queued may not have happened - a + // spec flushing a profile save needs to hear that, not just get true. + lua_pushnil(L); + lua_pushstring(L, "pumpEvents: stopped early, Mudlet is shutting down"); + return 2; + } + + lua_pushboolean(L, true); + return 1; +} + // Documentation: https://wiki.mudlet.org/w/Manual:Lua_Functions#raiseGlobalEvent int TLuaInterpreter::raiseGlobalEvent(lua_State* L) { diff --git a/src/mudlet-lua/tests/MudletBusted_spec.lua b/src/mudlet-lua/tests/MudletBusted_spec.lua index 9b3f6af4a..b5594d6e1 100644 --- a/src/mudlet-lua/tests/MudletBusted_spec.lua +++ b/src/mudlet-lua/tests/MudletBusted_spec.lua @@ -100,6 +100,24 @@ describe("waitForEvent test helper", function() assert.has_error(function() waitForEvent() end) end) + it("observes an event raised from inside another timer's callback", function() + -- The #9670 shape: the wait itself is armed from inside a timer callback. + tempTimer(0, function() + tempTimer(0.05, function() raiseEvent("mudletTestNestedTimer", "deep") end) + _G.mudletTestNestedTimerResult = {waitForEvent("mudletTestNestedTimer", 2000)} + end) + local waited = 0 + while not _G.mudletTestNestedTimerResult and waited < 5000 do + pumpEvents(50) + waited = waited + 50 + end + local result = _G.mudletTestNestedTimerResult + _G.mudletTestNestedTimerResult = nil + assert.is_table(result, "the wait inside the timer callback never returned") + assert.equals("mudletTestNestedTimer", result[1]) + assert.equals("deep", result[2]) + end) + it("supports a nested waitForEvent while one is already blocked", function() local innerName tempTimer(0, function() @@ -114,3 +132,40 @@ describe("waitForEvent test helper", function() assert.equals("mudletTestNested", innerName) end) end) + +describe("pumpEvents test helper", function() + it("returns true once the time is up", function() + assert.is_true(pumpEvents(20)) + end) + + it("accepts no argument and clamps a negative duration", function() + assert.is_true(pumpEvents()) + assert.is_true(pumpEvents(-50)) + end) + + it("runs a timer that falls due while it is pumping", function() + local fired = false + tempTimer(0.05, function() fired = true end) + pumpEvents(300) + assert.is_true(fired, "a timer that came due during the pump did not fire") + end) + + it("keeps running timers when pumping from inside a timer's callback", function() + -- The #9670 shape: on macOS this position stops Qt timers entirely, so + -- a regression hangs the spec rather than failing it. + local result = {} + tempTimer(0, function() + tempTimer(0.05, function() result.innerFired = true end) + pumpEvents(300) + result.firedDuringPump = result.innerFired == true + result.done = true + end) + local waited = 0 + while not result.done and waited < 5000 do + pumpEvents(50) + waited = waited + 50 + end + assert.is_true(result.done, "the pump inside the timer callback never returned") + assert.is_true(result.firedDuringPump, "a timer did not fire while pumping from inside a timer callback") + end) + end) diff --git a/src/mudlet-lua/tests/Networking_spec.lua b/src/mudlet-lua/tests/Networking_spec.lua index 5043c3be5..df3975d2b 100644 --- a/src/mudlet-lua/tests/Networking_spec.lua +++ b/src/mudlet-lua/tests/Networking_spec.lua @@ -294,8 +294,8 @@ describe("Downloads and HTTP verbs against the local fixture server", function() -- checked too. -- -- The requests are asynchronous: nothing is sent until the event loop runs, - -- which only happens inside waitForEvent(), so arming the wait after issuing - -- the request cannot miss the reply. + -- which only happens inside waitForEvent() and pumpEvents(), so arming the + -- wait after issuing the request cannot miss the reply. local httpPort = os.getenv("MUDLET_TEST_HTTP_PORT") -- the contents of CI/http-fixtures/fixture.txt local fixtureBody = "Mudlet self-test HTTP fixture.\n" @@ -849,10 +849,8 @@ describe("MMCP effects against a scripted chat peer", function() return true end - -- Lets Mudlet's event loop run for ms without blocking it: waiting on an - -- event nothing raises is how a spec gives sockets and timers time to work. local function pump(ms) - waitForEvent("mmcpFixtureIdleEvent", ms) + pumpEvents(ms) end local function waitUntil(predicate, timeoutMs) diff --git a/src/mudlet-lua/tests/Package_spec.lua b/src/mudlet-lua/tests/Package_spec.lua index 33fac641f..047da11d4 100644 --- a/src/mudlet-lua/tests/Package_spec.lua +++ b/src/mudlet-lua/tests/Package_spec.lua @@ -17,13 +17,13 @@ -- behind: the self-test profile is reused between runs, so a leak here would -- break the next run. --- waitForEvent() is inert outside test mode, and without it these specs cannot --- let the profile save finish - the uninstalls would fail and strand fixture --- packages in the profile, so say so rather than make a mess of it. +-- pumpEvents() is inert outside test mode, and without it the profile save +-- never finishes: the uninstalls fail and strand fixture packages in the +-- profile, so say so rather than make that mess. if not os.getenv("MUDLET_TEST_MODE") then describe("Tests the package and module lifecycle", function() it("needs test mode", function() - pending("the package specs need MUDLET_TEST_MODE (waitForEvent() does nothing without it)") + pending("the package specs need MUDLET_TEST_MODE (pumpEvents() does nothing without it)") end) end) return @@ -69,20 +69,6 @@ local function defer(cleanup) cleanups[#cleanups + 1] = cleanup end --- Mudlet stops responding part way through this file on macOS: every install --- and uninstall starts a profile save, and on that platform the run wedges --- somewhere in the middle of them, so the one-minute CI step for the Lua tests --- is killed. Linux (including the AddressSanitizer build) and Windows run the --- whole file fine. Until the save is fixed the specs that install something are --- pending on macOS; the contract specs still run there. -local installsWedgeThisPlatform = getOS() == "mac" - -local function requireWorkingInstalls() - if installsWedgeThisPlatform then - pending("installing a package wedges Mudlet on macOS - see the PR that added this file") - end -end - local function contains(haystack, needle) return type(haystack) == "string" and haystack:find(needle, 1, true) ~= nil end @@ -97,21 +83,15 @@ local function assertArgError(fn, needle) assert.is_true(contains(err, needle), tostring(err)) end --- waitForEvent() spins the Qt event loop, so waiting for an event nothing ever --- raises is how a spec gives Mudlet's queued work a chance to run: the install --- events are raised from a zero-timer, and so is the profile save that --- uninstallPackage() schedules. -local function pumpEventLoop(milliseconds) - waitForEvent("mudletPackageSpecIdleEvent", milliseconds) -end - +-- The install events, and the profile save uninstallPackage() schedules, are +-- all raised from a zero-timer, so none of them happen unless a spec pumps. local function waitUntil(condition, timeoutMilliseconds) local waited = 0 while waited < timeoutMilliseconds do if condition() then return true end - pumpEventLoop(50) + pumpEvents(50) waited = waited + 50 end return condition() and true or false @@ -173,7 +153,7 @@ local function installUntilConfirmed(install, path, isInstalled, what) if isInstalled() then return end - waitForProfileSaveToPass() + assert.is_true(waitForProfileSaveToPass(), "a profile save was still running after 5s, so this install would be postponed") local ok, err = install(path) -- a postponed install can still be carried out while the pump below runs -- the event loop, so a repeat may legitimately come back "already installed" @@ -185,7 +165,7 @@ local function installUntilConfirmed(install, path, isInstalled, what) if isInstalled() then return end - pumpEventLoop(400 * attempt) + pumpEvents(400 * attempt) end assert.is_true(false, "could not install " .. what) end @@ -194,12 +174,12 @@ end -- about the refusal waits for the save to pass and asks again. local function installUntilRefused(install, path) for attempt = 1, 3 do - waitForProfileSaveToPass() + assert.is_true(waitForProfileSaveToPass(), "a profile save was still running after 5s, so this install would be postponed") local ok, err = install(path) if ok == nil then return err end - pumpEventLoop(400 * attempt) + pumpEvents(400 * attempt) end assert.is_true(false, "the install was postponed instead of being answered") end @@ -212,7 +192,7 @@ local function reloadModuleUntil(name, reloaded) if waitUntil(reloaded, 300) then return end - pumpEventLoop(400 * attempt) + pumpEvents(400 * attempt) end assert.is_true(false, "the module was never reloaded") end @@ -225,14 +205,14 @@ local function removeFixturePackage(name) if not packageInstalled(name) then return end - waitForProfileSaveToPass() + assert.is_true(waitForProfileSaveToPass(), "a profile save was still running after 5s, so this uninstall would be refused") -- uninstallPackage() refuses while a profile save is in progress, and the -- installs here start one, so keep asking until it takes assert.is_true(waitUntil(function() return uninstallPackage(name) == true end, 5000), "could not uninstall the fixture package " .. name) -- let the profile save that uninstallPackage() queues run now, rather than -- during Mudlet's shutdown - pumpEventLoop(200) + pumpEvents(200) end assert.is_false(packageInstalled(name), "the fixture package " .. name .. " reinstalled itself") end @@ -252,10 +232,10 @@ local function removeFixtureModule(name) if not moduleInstalled(name) then break end - waitForProfileSaveToPass() + assert.is_true(waitForProfileSaveToPass(), "a profile save was still running after 5s, so this uninstall would be refused") assert.is_true(waitUntil(function() return uninstallModule(name) == true end, 5000), "could not uninstall the fixture module " .. name) - pumpEventLoop(200) + pumpEvents(200) end assert.is_false(moduleInstalled(name), "the fixture module " .. name .. " reinstalled itself") os.remove(scratchDirectory .. "/" .. name .. ".mpackage") @@ -331,9 +311,6 @@ describe("Tests the functionality of installPackage", function() local runsBefore, installEvents, packageEvents, handlers setup(function() - if installsWedgeThisPlatform then - return - end runsBefore = mudletSpecMinimalRuns or 0 local genericHandler, detailedHandler installEvents, genericHandler = collectEvents("sysInstall") @@ -345,9 +322,6 @@ describe("Tests the functionality of installPackage", function() end) teardown(function() - if installsWedgeThisPlatform then - return - end for _, handler in ipairs(handlers) do killAnonymousEventHandler(handler) end @@ -355,7 +329,6 @@ describe("Tests the functionality of installPackage", function() end) it("unpacks the package into the profile and runs its contents", function() - requireWorkingInstalls() local packageDirectory = getMudletHomeDir() .. "/" .. minimalPackage assert.is_true(fileExists(packageDirectory), "the package folder was not created") assert.is_true(fileExists(packageDirectory .. "/config.lua")) @@ -366,7 +339,6 @@ describe("Tests the functionality of installPackage", function() end) it("raises sysInstall and sysInstallPackage once the install is complete", function() - requireWorkingInstalls() assert.equals(1, #installEvents) assert.equals(minimalPackage, installEvents[1][1]) assert.equals(1, #packageEvents) @@ -375,14 +347,12 @@ describe("Tests the functionality of installPackage", function() end) it("refuses to install a package that is already installed", function() - requireWorkingInstalls() local err = installUntilRefused(installPackage, fixtureDirectory .. "/" .. minimalPackage .. ".mpackage") assert.is_true(contains(err, "package " .. minimalPackage .. " is already installed"), tostring(err)) end) end) it("unpacks a folder of resources that ships with a package", function() - requireWorkingInstalls() withFixturePackage(resourcesPackage) local packageDirectory = getMudletHomeDir() .. "/" .. resourcesPackage @@ -398,7 +368,6 @@ describe("Tests the functionality of installPackage", function() end) it("names a package after its file when the archive has no config.lua", function() - requireWorkingInstalls() withFixturePackage("mudlet-spec-noconfig") assert.equals(1, exists("mudlet-spec-noconfig alias", "alias")) @@ -406,7 +375,6 @@ describe("Tests the functionality of installPackage", function() end) it("installs a package from a plain XML file", function() - requireWorkingInstalls() local path = fixtureDirectory .. "/sources/mudlet-spec-xmlonly/mudlet-spec-xmlonly.xml" defer(function() removeFixturePackage("mudlet-spec-xmlonly") end) installUntilConfirmed(installPackage, path, function() return packageInstalled("mudlet-spec-xmlonly") end, @@ -434,7 +402,6 @@ describe("Tests the functionality of uninstallPackage", function() end) it("removes the package, its items and its folder, and raises the uninstall events", function() - requireWorkingInstalls() withFixturePackage(minimalPackage) local packageDirectory = getMudletHomeDir() .. "/" .. minimalPackage assert.is_true(fileExists(packageDirectory)) @@ -468,14 +435,10 @@ end) describe("Tests the package info accessors", function() setup(function() - if not installsWedgeThisPlatform then - installFixturePackage(minimalPackage) - end + installFixturePackage(minimalPackage) end) teardown(function() - if not installsWedgeThisPlatform then - removeFixturePackage(minimalPackage) - end + removeFixturePackage(minimalPackage) end) describe("Tests the functionality of getPackageInfo", function() @@ -484,12 +447,10 @@ describe("Tests the package info accessors", function() end) it("raises a Lua error when the requested field is not a string", function() - requireWorkingInstalls() assertArgError(function() getPackageInfo(minimalPackage, {}) end, "getPackageInfo: bad argument #2 type") end) it("returns everything the package's config.lua declared", function() - requireWorkingInstalls() assert.same({ mpackage = minimalPackage, author = "Mudlet test suite", @@ -500,13 +461,11 @@ describe("Tests the package info accessors", function() end) it("returns a single field when one is named", function() - requireWorkingInstalls() assert.equals("1.0", getPackageInfo(minimalPackage, "version")) assert.equals("Mudlet test suite", getPackageInfo(minimalPackage, "author")) end) it("returns an empty string for a field the package does not have", function() - requireWorkingInstalls() assert.equals("", getPackageInfo(minimalPackage, "no-such-field")) end) @@ -521,12 +480,10 @@ describe("Tests the package info accessors", function() end) it("raises a Lua error when the value is missing", function() - requireWorkingInstalls() assertArgError(function() setPackageInfo(minimalPackage, "version") end, "setPackageInfo: bad argument #3 type") end) it("round-trips a value through getPackageInfo", function() - requireWorkingInstalls() defer(function() setPackageInfo(minimalPackage, "version", "1.0") end) assert.is_true(setPackageInfo(minimalPackage, "version", "9.9")) @@ -535,7 +492,6 @@ describe("Tests the package info accessors", function() end) it("adds a field the package did not declare", function() - requireWorkingInstalls() assert.is_true(setPackageInfo(minimalPackage, "spec-added", "yes")) assert.equals("yes", getPackageInfo(minimalPackage, "spec-added")) end) @@ -556,9 +512,6 @@ describe("Tests the functionality of installModule", function() local runsBefore, installEvents, moduleEvents, handlers, modulePath setup(function() - if installsWedgeThisPlatform then - return - end runsBefore = mudletSpecModuleRuns or 0 local genericHandler, detailedHandler installEvents, genericHandler = collectEvents("sysInstall") @@ -569,9 +522,6 @@ describe("Tests the functionality of installModule", function() end) teardown(function() - if installsWedgeThisPlatform then - return - end for _, handler in ipairs(handlers) do killAnonymousEventHandler(handler) end @@ -579,7 +529,6 @@ describe("Tests the functionality of installModule", function() end) it("installs the module, unpacks it and runs its contents", function() - requireWorkingInstalls() assert.is_true(moduleInstalled(moduleName)) -- a module is not a package: it must not turn up in getPackages() assert.is_false(packageInstalled(moduleName)) @@ -589,7 +538,6 @@ describe("Tests the functionality of installModule", function() end) it("raises sysInstall and sysLuaInstallModule", function() - requireWorkingInstalls() assert.equals(1, #installEvents) assert.equals(moduleName, installEvents[1][1]) assert.equals(1, #moduleEvents) @@ -598,7 +546,6 @@ describe("Tests the functionality of installModule", function() end) it("refuses to install a module that is already installed", function() - requireWorkingInstalls() local err = installUntilRefused(installModule, modulePath) assert.is_true(contains(err, "module " .. moduleName .. " is already installed"), tostring(err)) end) @@ -615,7 +562,6 @@ describe("Tests the functionality of uninstallModule", function() end) it("removes the module, its items and its folder, and raises the uninstall events", function() - requireWorkingInstalls() withFixtureModule(moduleName) local moduleDirectory = getMudletHomeDir() .. "/" .. moduleName assert.is_true(fileExists(moduleDirectory)) @@ -647,14 +593,10 @@ describe("Tests the module accessors", function() local modulePath setup(function() - if not installsWedgeThisPlatform then - modulePath = installFixtureModule(moduleName) - end + modulePath = installFixtureModule(moduleName) end) teardown(function() - if not installsWedgeThisPlatform then - removeFixtureModule(moduleName) - end + removeFixtureModule(moduleName) end) describe("Tests the functionality of getModuleInfo", function() @@ -663,7 +605,6 @@ describe("Tests the module accessors", function() end) it("returns everything the module's config.lua declared", function() - requireWorkingInstalls() assert.same({ mpackage = moduleName, author = "Mudlet test suite", @@ -674,7 +615,6 @@ describe("Tests the module accessors", function() end) it("returns a single field when one is named", function() - requireWorkingInstalls() assert.equals("3.1", getModuleInfo(moduleName, "version")) assert.equals("", getModuleInfo(moduleName, "no-such-field")) end) @@ -686,12 +626,10 @@ describe("Tests the module accessors", function() describe("Tests the functionality of setModuleInfo", function() it("raises a Lua error when the value is missing", function() - requireWorkingInstalls() assertArgError(function() setModuleInfo(moduleName, "version") end, "setModuleInfo: bad argument #3 type") end) it("round-trips a value through getModuleInfo", function() - requireWorkingInstalls() defer(function() setModuleInfo(moduleName, "version", "3.1") end) assert.is_true(setModuleInfo(moduleName, "version", "8.8")) @@ -702,7 +640,6 @@ describe("Tests the module accessors", function() describe("Tests the functionality of getModulePath", function() it("returns the file the module was installed from", function() - requireWorkingInstalls() assert.equals(modulePath, getModulePath(moduleName)) end) end) @@ -713,7 +650,6 @@ describe("Tests the module accessors", function() -- alone), so once one has been set for this module the default this spec is -- about can never be observed again. it("reports the default priority of a freshly installed module", function() - requireWorkingInstalls() -- Installing a module seeds no priority for it, so this is the default the -- module manager displays and the profile exporter writes out, rather than -- the "module doesn't exist" that reading the priority map as an existence @@ -730,7 +666,6 @@ describe("Tests the module accessors", function() describe("Tests the functionality of setModulePriority", function() it("raises a Lua error when the priority is missing", function() - requireWorkingInstalls() assertArgError(function() setModulePriority(moduleName) end, "setModulePriority: bad argument #2 type") end) @@ -741,7 +676,6 @@ describe("Tests the module accessors", function() end) it("returns no values and is read back by getModulePriority", function() - requireWorkingInstalls() assert.equals(0, select('#', setModulePriority(moduleName, 7))) assert.equals(7, getModulePriority(moduleName)) setModulePriority(moduleName, -2) @@ -767,7 +701,6 @@ describe("Tests the module accessors", function() end) it("turns syncing on for an installed module", function() - requireWorkingInstalls() -- leave the module unsynced: a profile save rewrites a synced module's -- own .mpackage, and the fixture copy is thrown away when this block ends defer(function() disableModuleSync(moduleName) end) @@ -786,7 +719,6 @@ describe("Tests the module accessors", function() end) it("turns syncing back off", function() - requireWorkingInstalls() defer(function() disableModuleSync(moduleName) end) assert.is_true(enableModuleSync(moduleName)) @@ -807,7 +739,6 @@ describe("Tests the module accessors", function() end) it("is false for a module that nobody has turned syncing on for", function() - requireWorkingInstalls() assert.is_false(getModuleSync(moduleName)) end) end) @@ -820,7 +751,6 @@ describe("Tests the module accessors", function() -- unless a spec puts a synced module in the profile first. describe("Tests saving a profile that has a module to write", function() it("writes the synced module out again", function() - requireWorkingInstalls() -- rewriting this module's own .mpackage is only safe because -- installFixtureModule() installed a scratch copy, not the committed one defer(function() disableModuleSync(moduleName) end) @@ -859,18 +789,13 @@ describe("Tests the functionality of reloadModule", function() describe("with the fixture module installed", function() setup(function() - if not installsWedgeThisPlatform then - installFixtureModule(moduleName) - end + installFixtureModule(moduleName) end) teardown(function() - if not installsWedgeThisPlatform then - removeFixtureModule(moduleName) - end + removeFixtureModule(moduleName) end) it("runs the module's scripts again", function() - requireWorkingInstalls() local runsBefore = mudletSpecModuleRuns reloadModuleUntil(moduleName, function() return mudletSpecModuleRuns > runsBefore end) @@ -880,7 +805,6 @@ describe("Tests the functionality of reloadModule", function() end) it("re-reads the module's info from its config.lua", function() - requireWorkingInstalls() setModuleInfo(moduleName, "title", "changed by the spec") assert.equals("changed by the spec", getModuleInfo(moduleName, "title")) @@ -890,7 +814,6 @@ describe("Tests the functionality of reloadModule", function() end) it("keeps the module's priority and sync setting", function() - requireWorkingInstalls() defer(function() disableModuleSync(moduleName) end) setModulePriority(moduleName, 4) assert.is_true(enableModuleSync(moduleName)) @@ -922,7 +845,6 @@ describe("Tests a package that uninstalls itself", function() -- used to free the TScript objects that Host::raiseEvent() was still -- iterating over. Package auto-updaters do exactly this. it("survives a package uninstalling itself from its own event handler", function() - requireWorkingInstalls() defer(function() removeFixturePackage("mudlet-spec-selfuninstall") mudletSpecSelfUninstallHandler = nil @@ -951,7 +873,7 @@ describe("Tests a package that uninstalls itself", function() assert.equals(0, exists("mudletSpecSelfUninstallSecondHandler", "script")) -- raising the event again must not reach the removed scripts raiseEvent("mudletSpecSelfUninstall") - pumpEventLoop(100) + pumpEvents(100) assert.is_false(packageInstalled("mudlet-spec-selfuninstall")) end) end) @@ -979,7 +901,6 @@ end) describe("Tests installing an archive with nothing in it for Mudlet", function() it("refuses an archive that holds neither a config.lua nor a package XML", function() - requireWorkingInstalls() -- Nothing in such an archive registers the package, so answering true would -- leave a name that getPackages() does not list, that uninstallPackage() -- refuses, and a folder in the profile that only a file manager can take @@ -1035,6 +956,6 @@ describe("The package specs clean up after themselves", function() -- Let the profile save that the last uninstall queued run while the profile -- is still up, rather than leaving it to be stopped by the profile close. - pumpEventLoop(1500) + pumpEvents(1500) end) end) diff --git a/src/mudlet.cpp b/src/mudlet.cpp index 6f0ec6090..508574dd4 100644 --- a/src/mudlet.cpp +++ b/src/mudlet.cpp @@ -1694,6 +1694,10 @@ void mudlet::slot_closeProfileRequested(int tab) return; } + if (closeHeldOffByEventPump(pH)) { + return; + } + if (!pH->requestClose()) { return; } @@ -1710,6 +1714,18 @@ void mudlet::slot_closeProfileRequested(int tab) }); } +// Closing a profile destroys the lua_State the pump is still executing on. The +// application-wide close paths are deliberately not guarded like this: refusing +// there would cancel a shutdown nobody would retry. +bool mudlet::closeHeldOffByEventPump(Host* pHost) const +{ + if (!pHost->getLuaInterpreter()->pumpingEvents()) { + return false; + } + qWarning() << "mudlet: asked to close profile" << pHost->getName() << "while the test-mode event pump is running on it, ignoring"; + return true; +} + void mudlet::slot_closeProfileByName(const QString& profileName) { Host* pH = mHostManager.getHost(profileName); @@ -1717,6 +1733,10 @@ void mudlet::slot_closeProfileByName(const QString& profileName) return; } + if (closeHeldOffByEventPump(pH)) { + return; + } + if (!pH->requestClose()) { return; } @@ -7597,6 +7617,18 @@ void mudlet::onlyShowProfiles(const QStringList& predefinedProfiles) void mudlet::armForceClose() { QTimer::singleShot(0ms, this, [this]() { + // Deferring by one event loop iteration is meant to land outside Lua, + // but the pump runs the event loop from inside Lua, so it can land + // right back in it. Retrying terminates: the pump is capped at 30s. + for (auto pHost : mHostManager) { + if (pHost->getLuaInterpreter()->pumpingEvents()) { + qWarning() << "mudlet::armForceClose() - the test-mode event pump is running, waiting for it to finish"; + QTimer::singleShot(50ms, this, [this]() { + armForceClose(); + }); + return; + } + } forceClose(); }); } @@ -7824,20 +7856,37 @@ void mudlet::slot_detachedWindowClosed(const QString& profileName) updateMainWindowTitle(); // Properly close the host to avoid dangling connections - Host* pHost = mHostManager.getHost(profileName); - if (pHost) { - if (pHost->requestClose()) { - QTimer::singleShot(0ms, this, [this, profileName] { - closeHost(profileName); - // Check to see if there are any profiles left... - if (!mHostManager.getHostCount() && !mIsGoingDown) { - disableToolbarButtons(); - slot_showConnectionDialog(); - setWindowTitle(scmVersion); - } - }); + closeHostOfClosedDetachedWindow(profileName); + } +} + +// Unlike the tab-close slots, the window and its bookkeeping are already gone by +// the time we get here, so dropping the close while the pump runs would leave +// the profile loaded with no way to reach it. Wait the pump out instead. +void mudlet::closeHostOfClosedDetachedWindow(const QString& profileName) +{ + Host* pHost = mHostManager.getHost(profileName); + if (!pHost) { + return; + } + + if (closeHeldOffByEventPump(pHost)) { + QTimer::singleShot(50ms, this, [this, profileName]() { + closeHostOfClosedDetachedWindow(profileName); + }); + return; + } + + if (pHost->requestClose()) { + QTimer::singleShot(0ms, this, [this, profileName] { + closeHost(profileName); + // Check to see if there are any profiles left... + if (!mHostManager.getHostCount() && !mIsGoingDown) { + disableToolbarButtons(); + slot_showConnectionDialog(); + setWindowTitle(scmVersion); } - } + }); } } diff --git a/src/mudlet.h b/src/mudlet.h index 1cdfc5c8b..5464e7cd4 100644 --- a/src/mudlet.h +++ b/src/mudlet.h @@ -241,6 +241,7 @@ public: // operating without either menubar or main toolbar showing. bool isControlsVisible() const; bool isGoingDown() { return mIsGoingDown; } + bool closeHeldOffByEventPump(Host*) const; Host* loadProfile(const QString&, const bool, const QString& saveFileName = QString()); bool loadReplay(Host*, const QString&, QString* pErrMsg = nullptr); bool loadWindowLayout(); @@ -787,6 +788,7 @@ private: QPointer<QDockWidget> mpCurrentMapDockWidget; // Helper methods for detached windows + void closeHostOfClosedDetachedWindow(const QString& profileName); void detachTab(int tabIndex, const QPoint& position); void reattachTab(const QString& profileName, int insertIndex = -1); TMainConsole* removeConsoleFromSplitter(const QString& profileName); diff --git a/test/CMakeLists.txt b/test/CMakeLists.txt index ea08cd842..de33fbb2e 100644 --- a/test/CMakeLists.txt +++ b/test/CMakeLists.txt @@ -24,6 +24,7 @@ set(UNIT_TESTS TMxpEdgeCasesTest TMxpElementDefinitionHandlerTest TLuaInterfaceTest + EventLoopPumpTest TVariableEditorTest SecureStringUtilsTest CredentialManagerTest @@ -50,6 +51,10 @@ foreach(test_name ${UNIT_TESTS}) ) endforeach() +# A regression in what EventLoopPumpTest covers hangs rather than fails, so cap +# it well under ctest's default 25 minutes. +set_tests_properties(EventLoopPumpTest PROPERTIES TIMEOUT 60) + # TKeySequenceEditTest's focus traversal cases need an active window, which an X # server with no window manager never gives them, so a plain `xvfb-run ctest` # reported two failures that meant nothing and cost the activation timeout twice diff --git a/test/EventLoopPumpTest.cpp b/test/EventLoopPumpTest.cpp new file mode 100644 index 000000000..a83dc93a2 --- /dev/null +++ b/test/EventLoopPumpTest.cpp @@ -0,0 +1,141 @@ +/*************************************************************************** + * Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +#include <QtTest/QtTest> + +#include <QElapsedTimer> +#include <QTimer> + +#include "EventLoopPump.h" + +/* + * The macOS CI legs are what make pumpingFromInsideATimerCallback() worth + * having: that is the position a nested QEventLoop::exec() stops seeing Qt + * timers in (issue #9670), and no other platform reproduces it. + */ +class EventLoopPumpTest : public QObject +{ + Q_OBJECT + +private slots: + void runsOutTheClockWithNoCondition(); + void makesOnePassForAZeroTimeout(); + void stopsAsSoonAsTheConditionHolds(); + void stopsWithoutPumpingWhenTheConditionAlreadyHolds(); + void deliversATimerThatComesDueWhilePumping(); + void pumpingFromInsideATimerCallback(); + +private: + bool mDelivered = false; +}; + +void EventLoopPumpTest::runsOutTheClockWithNoCondition() +{ + QElapsedTimer elapsed; + elapsed.start(); + QVERIFY(!EventLoopPump::pumpFor(120)); + QVERIFY2(elapsed.elapsed() >= 110, qPrintable(QString::number(elapsed.elapsed()))); +} + +void EventLoopPumpTest::makesOnePassForAZeroTimeout() +{ + bool delivered = false; + QMetaObject::invokeMethod( + this, + [&delivered]() { + delivered = true; + }, + Qt::QueuedConnection); + + QVERIFY(!EventLoopPump::pumpFor(0)); + QVERIFY2(delivered, "a zero timeout did not deliver the already-posted event"); +} + +void EventLoopPumpTest::stopsAsSoonAsTheConditionHolds() +{ + bool done = false; + QTimer::singleShot(50, this, [&done]() { + done = true; + }); + + QElapsedTimer elapsed; + elapsed.start(); + QVERIFY(EventLoopPump::pumpFor(5000, [&done]() { + return done; + })); + QVERIFY2(elapsed.elapsed() < 2000, qPrintable(QString::number(elapsed.elapsed()))); +} + +void EventLoopPumpTest::stopsWithoutPumpingWhenTheConditionAlreadyHolds() +{ + mDelivered = false; + QMetaObject::invokeMethod( + this, + [this]() { + mDelivered = true; + }, + Qt::QueuedConnection); + + QVERIFY(EventLoopPump::pumpFor(1000, []() { + return true; + })); + QVERIFY2(!mDelivered, "a condition that already held should not have pumped anything"); + + // Drain the still-queued event so it cannot turn up mid-way through the + // next test. + QVERIFY(!EventLoopPump::pumpFor(20)); + QVERIFY(mDelivered); +} + +void EventLoopPumpTest::deliversATimerThatComesDueWhilePumping() +{ + bool fired = false; + QTimer::singleShot(40, this, [&fired]() { + fired = true; + }); + + QVERIFY(!EventLoopPump::pumpFor(300)); + QVERIFY2(fired, "a timer that came due during the pump did not fire"); +} + +void EventLoopPumpTest::pumpingFromInsideATimerCallback() +{ + // A regression here hangs rather than fails: nothing ever completes the + // outer callback. + bool innerFired = false; + bool firedDuringPump = false; + bool outerDone = false; + + QTimer::singleShot(0, this, [&]() { + QTimer::singleShot(40, this, [&innerFired]() { + innerFired = true; + }); + QVERIFY(!EventLoopPump::pumpFor(300)); + firedDuringPump = innerFired; + outerDone = true; + }); + + QVERIFY(EventLoopPump::pumpFor(5000, [&outerDone]() { + return outerDone; + })); + QVERIFY2(firedDuringPump, "a timer did not fire while pumping from inside a timer callback"); +} + +QTEST_MAIN(EventLoopPumpTest) +#include "EventLoopPumpTest.moc" From c594d83c2581d27c0d8a5766160a98524285e6de Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Fri, 7 Aug 2026 06:12:54 +0200 Subject: [PATCH 109/155] infrastructure: leak checking now gates the functional tests (#9694) #### Brief overview of PR changes/additions - 43 of 45 functional tests now run with `detect_leaks=1` and fail CI if they leak (the suite leaked 11.83MB before this PR). The LSan suppression hooks move into an OBJECT library so they actually bind into the test binaries. - Fixes the three production leaks behind nearly all of it: the unparented `QSettings` (now application-parented, since the Updater holds the pointer past window close), edbee re-initialisation orphaning its managers on every repeat `mudlet::init()`, and the preferences dialog's menu `QAction`s (`QMenu::addAction()` does not take ownership). - New `EdbeeReinitTest` and a preferences-reopen test lock the fixes in. Still excluded: `dlgTriggerEditorUndoRedoTest` (fixed in #9700) and `UpdaterTeardownTest` (Qt's one-time CA-store load). #### Motivation for adding to Mudlet Leaks in code covered by the functional suite now fail the build instead of accumulating silently, and two of the three fixes stop real leaks in production. #### Other info (issues closed, discussion etc) Test case: full serial suite passes twice, 45/45; settings persistence verified end-to-end under Xvfb. Startup unchanged (median 213ms vs 214ms); the suite's +62s is LSan's at-exit scan, no individual test regressed. Assisted-by: Claude:claude-fable-5 --- src/CMakeLists.txt | 13 +- src/LsanHooks.cpp | 40 ++++ src/dlgProfilePreferences.cpp | 24 +-- src/main.cpp | 22 -- src/mudlet.cpp | 17 +- test/CMakeLists.txt | 3 +- test/functional_tests/CMakeLists.txt | 26 ++- test/functional_tests/DialogTeardownTest.cpp | 36 ++++ test/functional_tests/EdbeeReinitTest.cpp | 207 +++++++++++++++++++ 9 files changed, 346 insertions(+), 42 deletions(-) create mode 100644 src/LsanHooks.cpp create mode 100644 test/functional_tests/EdbeeReinitTest.cpp diff --git a/src/CMakeLists.txt b/src/CMakeLists.txt index 1e3ac52c8..89fe197d5 100644 --- a/src/CMakeLists.txt +++ b/src/CMakeLists.txt @@ -768,7 +768,7 @@ endif(USE_UPDATER) # Embed the LeakSanitizer suppression list into the binary so that # sanitizer-enabled builds (PTBs, testing AppImages) filter third-party noise # out of leak reports without needing LSAN_OPTIONS set at runtime; picked up -# by __lsan_default_suppressions() in main.cpp +# by __lsan_default_suppressions() in LsanHooks.cpp set_property(DIRECTORY APPEND PROPERTY CMAKE_CONFIGURE_DEPENDS "${mudlet_SOURCE_DIR}/asan-suppressions.txt") file(READ "${mudlet_SOURCE_DIR}/asan-suppressions.txt" MUDLET_LSAN_SUPPRESSIONS_CONTENT) string(REPLACE "\\" "\\\\" MUDLET_LSAN_SUPPRESSIONS_CONTENT "${MUDLET_LSAN_SUPPRESSIONS_CONTENT}") @@ -777,6 +777,15 @@ string(REPLACE "\n" "\\n" MUDLET_LSAN_SUPPRESSIONS_CONTENT "${MUDLET_LSAN_SUPPRE configure_file("${CMAKE_CURRENT_SOURCE_DIR}/LsanSuppressions.h.in" "${CMAKE_CURRENT_BINARY_DIR}/LsanSuppressions.h" @ONLY) target_include_directories(${LIB_MUDLET_TARGET} PRIVATE ${CMAKE_CURRENT_BINARY_DIR}) +# LeakSanitizer resolves its hooks as weak symbols and a weak reference never +# pulls a member out of a static archive, so they cannot live in +# ${LIB_MUDLET_TARGET}: binaries that bring their own main() (the Qt Test ones, +# via QTEST_MAIN) would link no suppressions at all. An OBJECT library puts the +# definitions on the link line of every target that links it. +add_library(mudlet_lsan_hooks OBJECT LsanHooks.cpp) +target_include_directories(mudlet_lsan_hooks PRIVATE ${CMAKE_CURRENT_BINARY_DIR}) +set_target_properties(mudlet_lsan_hooks PROPERTIES AUTOMOC OFF POSITION_INDEPENDENT_CODE ON) + if(USE_3DMAPPER) target_link_libraries(${LIB_MUDLET_TARGET} OpenGL::GLU) target_link_libraries(${LIB_MUDLET_TARGET} assimp::assimp) @@ -792,7 +801,7 @@ target_compile_options(${LIB_MUDLET_TARGET} PUBLIC -Wno-deprecated) add_executable(${EXE_MUDLET_TARGET} emptyFile.cpp) set_target_properties(${EXE_MUDLET_TARGET} PROPERTIES OUTPUT_NAME ${EXE_MUDLET_NAME}) -target_link_libraries(${EXE_MUDLET_TARGET} ${LIB_MUDLET_TARGET}) +target_link_libraries(${EXE_MUDLET_TARGET} ${LIB_MUDLET_TARGET} mudlet_lsan_hooks) # Enable symbol exports from the main executable so that dynamically loaded Lua modules # can find and use Lua API symbols (like lua_gettop) at runtime. Without this, modules diff --git a/src/LsanHooks.cpp b/src/LsanHooks.cpp new file mode 100644 index 000000000..3a15b5362 --- /dev/null +++ b/src/LsanHooks.cpp @@ -0,0 +1,40 @@ +/*************************************************************************** + * Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +#include "LsanSuppressions.h" + +// Inert unless the LeakSanitizer runtime is linked in. They cannot be guarded +// with an "is ASAN on" macro check: Mudlet only applies -fsanitize=address at +// link time, so no compiler macro is set, and Qt's qcompilerdetection.h shims +// __has_feature to 0 on GCC anyway. Built as their own OBJECT library, see +// src/CMakeLists.txt. + +// Keeps third-party noise (GPU drivers, font stack) out of the leak reports +// that testing/PTB builds show users, with no LSAN_OPTIONS set at runtime +extern "C" const char* __lsan_default_suppressions() +{ + return mudletLsanSuppressions; +} + +// Without this, LeakSanitizer appends a "Suppressions used" summary to every +// clean exit, which reads like an error to users: +extern "C" const char* __lsan_default_options() +{ + return "print_suppressions=0"; +} diff --git a/src/dlgProfilePreferences.cpp b/src/dlgProfilePreferences.cpp index 363d67742..8a9a26a09 100644 --- a/src/dlgProfilePreferences.cpp +++ b/src/dlgProfilePreferences.cpp @@ -1002,17 +1002,17 @@ void dlgProfilePreferences::initWithHost(Host* pHost) } protocolMenu->clear(); - mEnableCHARSET = new QAction(tr("CHARSET: Character Encoding Standard"), nullptr); + mEnableCHARSET = new QAction(tr("CHARSET: Character Encoding Standard"), protocolMenu); mEnableCHARSET->setCheckable(true); mEnableCHARSET->setChecked(pHost->mEnableCHARSET); protocolMenu->addAction(mEnableCHARSET); - mEnableGMCP = new QAction(tr("GMCP: Generic Mud Communication Protocol"), nullptr); + mEnableGMCP = new QAction(tr("GMCP: Generic Mud Communication Protocol"), protocolMenu); mEnableGMCP->setCheckable(true); mEnableGMCP->setChecked(pHost->mEnableGMCP); protocolMenu->addAction(mEnableGMCP); - mEnableMNES = new QAction(tr("MNES: Mud New-Environ Standard"), nullptr); + mEnableMNES = new QAction(tr("MNES: Mud New-Environ Standard"), protocolMenu); mEnableMNES->setCheckable(true); mEnableMNES->setChecked(pHost->mEnableMNES); //: Tooltip for MNES protocol option explaining mutual exclusivity with NEW-ENVIRON @@ -1020,37 +1020,37 @@ void dlgProfilePreferences::initWithHost(Host* pHost) "including OSC link support.")); protocolMenu->addAction(mEnableMNES); - mEnableMSDP = new QAction(tr("MSDP: Mud Server Data Protocol"), nullptr); + mEnableMSDP = new QAction(tr("MSDP: Mud Server Data Protocol"), protocolMenu); mEnableMSDP->setCheckable(true); mEnableMSDP->setChecked(pHost->mEnableMSDP); protocolMenu->addAction(mEnableMSDP); - mEnableMSP = new QAction(tr("MSP: Mud Sound Protocol"), nullptr); + mEnableMSP = new QAction(tr("MSP: Mud Sound Protocol"), protocolMenu); mEnableMSP->setCheckable(true); mEnableMSP->setChecked(pHost->mEnableMSP); protocolMenu->addAction(mEnableMSP); - mEnableMSSP = new QAction(tr("MSSP: Mud Server Status Protocol"), nullptr); + mEnableMSSP = new QAction(tr("MSSP: Mud Server Status Protocol"), protocolMenu); mEnableMSSP->setCheckable(true); mEnableMSSP->setChecked(pHost->mEnableMSSP); protocolMenu->addAction(mEnableMSSP); - mEnableMTTS = new QAction(tr("MTTS: Mud Terminal Type Standard"), nullptr); + mEnableMTTS = new QAction(tr("MTTS: Mud Terminal Type Standard"), protocolMenu); mEnableMTTS->setCheckable(true); mEnableMTTS->setChecked(pHost->mEnableMTTS); protocolMenu->addAction(mEnableMTTS); - mEnableMXP = new QAction(tr("MXP: Mud eXtension Protocol"), nullptr); + mEnableMXP = new QAction(tr("MXP: Mud eXtension Protocol"), protocolMenu); mEnableMXP->setCheckable(true); mEnableMXP->setChecked(pHost->mEnableMXP); protocolMenu->addAction(mEnableMXP); - mEnableNAWS = new QAction(tr("NAWS: Negotiate About Window Size"), nullptr); + mEnableNAWS = new QAction(tr("NAWS: Negotiate About Window Size"), protocolMenu); mEnableNAWS->setCheckable(true); mEnableNAWS->setChecked(pHost->mEnableNAWS); protocolMenu->addAction(mEnableNAWS); - mEnableNEWENVIRON = new QAction(tr("NEW-ENVIRON: Client Variables Standard"), nullptr); + mEnableNEWENVIRON = new QAction(tr("NEW-ENVIRON: Client Variables Standard"), protocolMenu); mEnableNEWENVIRON->setCheckable(true); mEnableNEWENVIRON->setChecked(pHost->mEnableNEWENVIRON); //: Tooltip for NEW-ENVIRON protocol option explaining mutual exclusivity with MNES @@ -1069,7 +1069,7 @@ void dlgProfilePreferences::initWithHost(Host* pHost) pushButton_chooseProfiles->setEnabled(false); pushButton_copyMap->setEnabled(false); if (!mpMenu) { - mpMenu = new QMenu(tr("Other profiles to Map to:")); + mpMenu = new QMenu(tr("Other profiles to Map to:"), this); } mpMenu->clear(); @@ -1082,7 +1082,7 @@ void dlgProfilePreferences::initWithHost(Host* pHost) continue; } - auto pItem = new QAction(s, nullptr); + auto pItem = new QAction(s, mpMenu); pItem->setCheckable(true); pItem->setChecked(false); mpMenu->addAction(pItem); diff --git a/src/main.cpp b/src/main.cpp index 279e329c1..d28d36773 100644 --- a/src/main.cpp +++ b/src/main.cpp @@ -63,7 +63,6 @@ #include "TAccessibleConsole.h" #include "TAccessibleTextEdit.h" #include "FileOpenHandler.h" -#include "LsanSuppressions.h" #include "SentryWrapper.h" #include "utils.h" #include <QFileInfo> @@ -78,27 +77,6 @@ using namespace std::chrono_literals; -// These hooks are only consulted when the LeakSanitizer runtime is linked in -// (USE_SANITIZER builds, i.e. PTBs and testing builds); elsewhere they are two -// inert functions. They cannot be guarded with an "is ASAN on" macro check: -// Mudlet only applies -fsanitize=address at link time, so no compiler macro is -// set, and Qt's qcompilerdetection.h shims __has_feature to 0 on GCC anyway. - -// Embeds the suppression list into the binary so leak reports shown to users -// by testing/PTB builds exclude third-party noise (GPU drivers, font stack) -// with no LSAN_OPTIONS needed at runtime: -extern "C" const char* __lsan_default_suppressions() -{ - return mudletLsanSuppressions; -} - -// Without this, LeakSanitizer appends a "Suppressions used" summary to every -// clean exit, which reads like an error to users: -extern "C" const char* __lsan_default_options() -{ - return "print_suppressions=0"; -} - extern void qInitResources_mudlet(); extern void qInitResources_qm(); extern void qInitResources_additional_splash_screens(); diff --git a/src/mudlet.cpp b/src/mudlet.cpp index 508574dd4..104bead17 100644 --- a/src/mudlet.cpp +++ b/src/mudlet.cpp @@ -954,7 +954,12 @@ void mudlet::setupConfig() } qDebug() << "mudlet::setupConfig() INFO:" << "using config dir:" << confPath; - mpSettings = new QSettings(qsl("%1/Mudlet.ini").arg(confPath), QSettings::IniFormat); + // parented to the application, not this window: the window deletes itself + // on close and the Updater keeps using this QSettings past that point. + // Which is also why setupConfig() must not run again once init() has + // created the Updater - the delete below would dangle its pointer. + delete mpSettings; + mpSettings = new QSettings(qsl("%1/Mudlet.ini").arg(confPath), QSettings::IniFormat, qApp); migrateConfig(*mpSettings); } @@ -967,6 +972,16 @@ void mudlet::setupConfig() void mudlet::initEdbee() { + // edbee's init() has no re-entry guard - a second call reassigns all of its + // manager members and orphans the previous graph. Everything set up here is + // process-global, so one pass is enough however many mudlet instances a + // test constructs. + static bool initialised = false; + if (initialised) { + return; + } + initialised = true; + auto edbee = edbee::Edbee::instance(); edbee->init(); edbee->autoShutDownOnAppExit(); diff --git a/test/CMakeLists.txt b/test/CMakeLists.txt index de33fbb2e..df86bffe2 100644 --- a/test/CMakeLists.txt +++ b/test/CMakeLists.txt @@ -44,7 +44,8 @@ set(UNIT_TESTS foreach(test_name ${UNIT_TESTS}) add_executable(${test_name} ${test_name}.cpp) add_dependencies(${test_name} ${LIB_MUDLET_TARGET}) - target_link_libraries(${test_name} PRIVATE Qt6::Test ${LIB_MUDLET_TARGET}) + # mudlet_lsan_hooks has to be linked explicitly, see src/CMakeLists.txt + target_link_libraries(${test_name} PRIVATE Qt6::Test ${LIB_MUDLET_TARGET} mudlet_lsan_hooks) add_test(NAME ${test_name} COMMAND $<TARGET_FILE:${test_name}>) set_tests_properties(${test_name} PROPERTIES ENVIRONMENT "ASAN_OPTIONS=detect_leaks=0" diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index 951961942..0b2e464d7 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -48,6 +48,7 @@ set(FUNCTIONAL_TEST_SOURCES ActionSelfUninstallTest.cpp ProfileFolderNameTest.cpp DialogTeardownTest.cpp + EdbeeReinitTest.cpp TMediaLoopTest.cpp DefaultPackagesTest.cpp ProfileSwitchShortcutTest.cpp @@ -69,7 +70,7 @@ set(FUNCTIONAL_TEST_UTILS # output - built but deliberately not registered with ctest: add_executable(UndoServerWrapReplay UndoServerWrapReplay.cpp ${FUNCTIONAL_TEST_UTILS}) add_dependencies(UndoServerWrapReplay ${LIB_MUDLET_TARGET}) -target_link_libraries(UndoServerWrapReplay PRIVATE Qt6::Test ${LIB_MUDLET_TARGET}) +target_link_libraries(UndoServerWrapReplay PRIVATE Qt6::Test ${LIB_MUDLET_TARGET} mudlet_lsan_hooks) set_target_properties(UndoServerWrapReplay PROPERTIES ENABLE_EXPORTS ON) # Report-only perf harness for manual before/after comparisons @@ -81,7 +82,7 @@ set_target_properties(UndoServerWrapReplay PROPERTIES ENABLE_EXPORTS ON) option(REGISTER_PERF_BENCHMARK "Register the report-only PipelineBenchmark with ctest (it is built either way)" OFF) add_executable(PipelineBenchmark PipelineBenchmark.cpp ${FUNCTIONAL_TEST_UTILS}) add_dependencies(PipelineBenchmark ${LIB_MUDLET_TARGET}) -target_link_libraries(PipelineBenchmark PRIVATE Qt6::Test ${LIB_MUDLET_TARGET}) +target_link_libraries(PipelineBenchmark PRIVATE Qt6::Test ${LIB_MUDLET_TARGET} mudlet_lsan_hooks) set_target_properties(PipelineBenchmark PROPERTIES ENABLE_EXPORTS ON) if(REGISTER_PERF_BENCHMARK) add_test(NAME PipelineBenchmark COMMAND $<TARGET_FILE:PipelineBenchmark>) @@ -92,15 +93,32 @@ if(REGISTER_PERF_BENCHMARK) TIMEOUT 600) endif() +# These still leak and stay unchecked until their defects are fixed: +# - dlgTriggerEditorUndoRedoTest: never destroys its dlgTriggerEditor, leaving +# ~3.4MB of tree-item QIcon/QPixmap behind +# - UpdaterTeardownTest: Qt's one-time system CA-certificate store load on +# first TLS use, cached for the process lifetime +set(leakCheckExcludedTests + dlgTriggerEditorUndoRedoTest + UpdaterTeardownTest +) + +# mudlet_lsan_hooks has to be linked explicitly, see src/CMakeLists.txt foreach(test_file ${FUNCTIONAL_TEST_SOURCES}) get_filename_component(test_name ${test_file} NAME_WE) add_executable(${test_name} ${test_file} ${FUNCTIONAL_TEST_UTILS}) add_dependencies(${test_name} ${LIB_MUDLET_TARGET}) - target_link_libraries(${test_name} PRIVATE Qt6::Test ${LIB_MUDLET_TARGET}) + target_link_libraries(${test_name} PRIVATE Qt6::Test ${LIB_MUDLET_TARGET} mudlet_lsan_hooks) set_target_properties(${test_name} PROPERTIES ENABLE_EXPORTS ON) add_test(NAME ${test_name} COMMAND $<TARGET_FILE:${test_name}>) + # Apple's ASan runtime has no LeakSanitizer + if(APPLE OR test_name IN_LIST leakCheckExcludedTests) + set(leakCheck "detect_leaks=0") + else() + set(leakCheck "detect_leaks=1") + endif() set_tests_properties(${test_name} PROPERTIES - ENVIRONMENT "QT_QPA_PLATFORM=offscreen;ASAN_OPTIONS=detect_leaks=0" + ENVIRONMENT "QT_QPA_PLATFORM=offscreen;ASAN_OPTIONS=${leakCheck}" LABELS "functional" TIMEOUT 60 # seconds ) diff --git a/test/functional_tests/DialogTeardownTest.cpp b/test/functional_tests/DialogTeardownTest.cpp index 7d56607f5..ae200a234 100644 --- a/test/functional_tests/DialogTeardownTest.cpp +++ b/test/functional_tests/DialogTeardownTest.cpp @@ -40,6 +40,7 @@ #include <QtTest/QtTest> #include <chrono> +#include <QAction> #include <QKeySequenceEdit> #include <QLineEdit> #include <QScopeGuard> @@ -322,6 +323,41 @@ private slots: QVERIFY2(!mpHost->getTriggerUnit()->findTrigger(typedName), "Being destroyed made the editor rename the trigger"); QVERIFY2(mpHost->getTriggerUnit()->findTrigger(nameBefore), "The trigger lost its name while the editor was destroyed"); } + + void test_protocolActionsFireAfterPreferencesReopen() + { + mudlet::self()->showOptionsDialog(qsl("tab_general"), mpHost); + QTest::qWait(100ms); + auto* first = mpHost->mpDlgProfilePreferences.data(); + QVERIFY2(first, "Preferences dialog was not created"); + delete first; + QVERIFY2(mpHost->mpDlgProfilePreferences.isNull(), "Preferences dialog should have been destroyed"); + + mudlet::self()->showOptionsDialog(qsl("tab_general"), mpHost); + QTest::qWait(100ms); + auto* preferences = mpHost->mpDlgProfilePreferences.data(); + QVERIFY2(preferences, "Preferences dialog was not recreated"); + + QAction* gmcpAction = nullptr; + for (auto* action : preferences->findChildren<QAction*>()) { + if (action->text().startsWith(qsl("GMCP"))) { + gmcpAction = action; + break; + } + } + QVERIFY2(gmcpAction, "GMCP protocol action not found under the reopened dialog - parenting to the menu broke discovery or population"); + + // initWithHost() wires GMCP's toggled() to this button's setEnabled(), + // so the button flipping proves the fresh action is connected + const bool enabledBefore = preferences->pushButton_forgetSavedSignIn->isEnabled(); + QCOMPARE(enabledBefore, gmcpAction->isChecked()); + gmcpAction->toggle(); + QCOMPARE(preferences->pushButton_forgetSavedSignIn->isEnabled(), !enabledBefore); + gmcpAction->toggle(); + QCOMPARE(preferences->pushButton_forgetSavedSignIn->isEnabled(), enabledBefore); + + delete preferences; + } }; void initializeQRCResourcesForDialogTeardownTest() diff --git a/test/functional_tests/EdbeeReinitTest.cpp b/test/functional_tests/EdbeeReinitTest.cpp new file mode 100644 index 000000000..aa1ac60a6 --- /dev/null +++ b/test/functional_tests/EdbeeReinitTest.cpp @@ -0,0 +1,207 @@ +/*************************************************************************** + * Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +/* + * mudlet::initEdbee() only runs once per process, so destroying a mudlet + * instance and constructing another - what every functional test with a + * per-method init() does - must leave the edbee singleton fully usable: Lua + * grammar, Mudlet theme, and a script editor that opens against them. + * + * Run with: ctest -R EdbeeReinitTest -V + */ + +#include <QtTest/QtTest> +#include <chrono> + +#include "Host.h" +#include "MudletInstanceCoordinator.h" +#include "TelnetServerStub.h" +#include "ctelnet.h" +#include "dlgConnectionProfiles.h" +#include "dlgTriggerEditor.h" +#include "mudlet.h" + +#include "edbee/edbee.h" +#include "edbee/models/textgrammar.h" +#include "edbee/views/texttheme.h" + +using namespace std::chrono_literals; + +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); + +static void initializeQRCResources() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +class EdbeeReinitTest : public QObject +{ + Q_OBJECT + +private: + TelnetServerStub* mpServer = nullptr; + Host* mpHost = nullptr; + const QString mProfileName = qsl("EdbeeReinit-Test-Profile"); + QString mPort; + const QString mLocalhost = qsl("localhost"); + + void deleteProfileDirectory(const QString& profileName) + { + const QString path = mudlet::getMudletPath(enums::profileHomePath, profileName); + QDir dir(path); + if (dir.exists() && !dir.removeRecursively()) { + qWarning() << "deleteProfileDirectory: could not remove" << path << "- later failures may stem from this stale state"; + } + } + + static void bootMudlet() + { + mudlet::start(); + mudlet::self()->setupConfig(); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique<MudletInstanceCoordinator>(qsl("MudletInstanceCoordinator"))); + mudlet::self()->init(); + mudlet::self()->setStorePasswordsSecurely(false); + } + + void startProfile(const QString& profileName, const QString& address, const QString& port) + { + QTimer::singleShot(0ms, qApp, [profileName, address, port]() { + mudlet::self()->startAutoLogin({}); + QTest::qWait(100ms); + + dlgConnectionProfiles* connectionDialog = mudlet::self()->mpConnectionDialog; + if (!connectionDialog || !connectionDialog->new_profile_button) { + qWarning() << "startProfile: connection dialog did not appear"; + return; + } + QTest::mouseClick(connectionDialog->new_profile_button, Qt::LeftButton); + QTest::qWait(100ms); + + const auto focusedWidget = [](const char* step) -> QWidget* { + QWidget* widget = QApplication::focusWidget(); + if (!widget) { + qWarning() << "startProfile: no focused widget at step" << step; + } + return widget; + }; + + QWidget* nameField = focusedWidget("profile name"); + if (!nameField) { + return; + } + QTest::keyClicks(nameField, profileName); + QTest::qWait(100ms); + QTest::keyClick(nameField, Qt::Key_Tab); + QTest::qWait(100ms); + + QWidget* addressField = focusedWidget("address"); + if (!addressField) { + return; + } + QTest::keyClicks(addressField, address); + QTest::qWait(100ms); + QTest::keyClick(addressField, Qt::Key_Tab); + QTest::qWait(100ms); + + QWidget* portField = focusedWidget("port"); + if (!portField) { + return; + } + QTest::keyClicks(portField, port); + QTest::qWait(100ms); + QTest::keyClick(portField, Qt::Key_Return); + }); + + QSignalSpy spy(mudlet::self(), &mudlet::signal_profileLoaded); + if (!spy.wait(2000)) { + QFAIL("Profile took too long to load."); + } + + mpHost = mudlet::self()->getActiveHost(); + if (!mpHost) { + QFAIL("No active host available for the test."); + } + + QSignalSpy spy2(&(mpHost->mTelnet), &cTelnet::signal_connected); + if (!spy2.wait(2000)) { + QFAIL("Could not connect with the host."); + } + } + +private slots: + void initTestCase() + { + initializeQRCResources(); + mpServer = new TelnetServerStub(qApp); + mpServer->start(mLocalhost, 0); + QVERIFY2(mpServer->isListening(), qPrintable(qsl("TelnetServerStub failed to start: %1").arg(mpServer->errorString()))); + mPort = QString::number(mpServer->serverPort()); + } + + void cleanupTestCase() + { + mpHost = nullptr; + delete mpServer; + mpServer = nullptr; + deleteProfileDirectory(mProfileName); + delete mudlet::self(); + } + + void test_editorAliveAfterMudletReconstruction() + { + bootMudlet(); + delete mudlet::self(); + + bootMudlet(); + deleteProfileDirectory(mProfileName); + + auto* edbee = edbee::Edbee::instance(); + auto* luaGrammar = edbee->grammarManager()->get(qsl("source.lua")); + QVERIFY2(luaGrammar, "Lua grammar gone after mudlet reconstruction - initEdbee()'s once-guard left edbee unprimed"); + // the editor picks its grammar by filename, so that path must agree + QCOMPARE(edbee->grammarManager()->detectGrammarWithFilename(qsl("Buck.lua")), luaGrammar); + QVERIFY2(edbee->themeManager()->theme(qsl("Mudlet")), "Mudlet editor theme gone after mudlet reconstruction"); + + startProfile(mProfileName, mLocalhost, mPort); + if (QTest::currentTestFailed()) { + return; + } + + mudlet::self()->slot_showScriptDialog(); + QTest::qWait(100ms); + QVERIFY2(mpHost->mpEditorDialog, "Script editor did not open on the reconstructed mudlet instance"); + } +}; + +#include "EdbeeReinitTest.moc" +QTEST_MAIN(EdbeeReinitTest) From fd822ebb839e897edb3ceb79de263b778ea873d4 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Fri, 7 Aug 2026 06:13:15 +0200 Subject: [PATCH 110/155] infrastructure: move module documents into their write jobs instead of copying (#9699) #### Brief overview of PR changes/additions - `Host::saveProfile()` cloned each module's XML document into its background write job while the original sat unread in `writers` as a save-in-progress token, doubling peak memory per module during saves. The document is now moved into the job instead (pugixml move, available since 1.9). - The async profile save in `runAsyncSave()` had the identical doubling and gets the same move. #### Motivation for adding to Mudlet Follow-up to #9690 "fix: module save reaching into the profile after it is destroyed" - saves now hold one copy of each document, not two. #### Other info (issues closed, discussion etc) Test case: `ModuleSaveTeardownTest`, `PackageUninstallSaveTeardownTest` and `ProfileRoundTripTest` pass; a 241KB document round-trips byte-identical through the move under ASan/UBSan. Assisted-by: Claude:claude-fable-5 --- src/Host.cpp | 5 ++--- src/XMLexport.cpp | 35 ++++++++++++----------------------- src/XMLexport.h | 2 +- 3 files changed, 15 insertions(+), 27 deletions(-) diff --git a/src/Host.cpp b/src/Host.cpp index 375f7d7fb..a53dc1e56 100644 --- a/src/Host.cpp +++ b/src/Host.cpp @@ -701,10 +701,9 @@ QList<Host::ModuleWriteJob> Host::prepareModuleSaves(bool backup) writer->writeModuleXML(moduleName); // The writer stays in `writers` purely as the save-in-progress token that // xmlSaved() retires on the main thread, so the XMLexport - a QObject with - // main-thread affinity - is only ever destroyed there. What gets written out - // is the job's own copy of the document, which outlives both of them. + // main-thread affinity - is only ever destroyed there. writers.insert(xmlFilename, writer); - jobs.append({writer->cloneExportDocument(), moduleName, filename, xmlFilename, backup ? backupPath + moduleName : QString()}); + jobs.append({writer->takeExportDocument(), moduleName, filename, xmlFilename, backup ? backupPath + moduleName : QString()}); if (entry.at(1).toInt()) { mModulesToSync << moduleName; diff --git a/src/XMLexport.cpp b/src/XMLexport.cpp index 8bc9fb287..06549655d 100644 --- a/src/XMLexport.cpp +++ b/src/XMLexport.cpp @@ -47,6 +47,7 @@ #include <QMetaEnum> #include <sstream> +#include <utility> XMLexport::XMLexport(Host* pH) : mpHost(pH) @@ -85,8 +86,7 @@ XMLexport::XMLexport(TKey* pT) // Builds the module's XML document into mExportDoc. This reads the live // trigger/timer/alias/action/script/key lists, so it must run on the main thread; -// serializing a copy of it (cloneExportDocument()) to disk can then happen on a -// background thread. +// serializing it to disk can then happen on a background thread. void XMLexport::writeModuleXML(const QString& moduleName) { auto pHost = mpHost; @@ -161,17 +161,12 @@ void XMLexport::writeModuleXML(const QString& moduleName) } } -// Deep copy of the document built so far, so the write can outlive both this XMLexport -// and the Host it belongs to. The copy is made while the main thread is already -// quiescent, and each document owns its own tree, so the clone can be serialized off -// the main thread without touching anything shared. -std::shared_ptr<pugi::xml_document> XMLexport::cloneExportDocument() const +// Hands the document over so the write can outlive both this XMLexport and its Host +// without a second copy of the tree. mExportDoc is left valid but empty, and any +// xml_node handle taken from it beforehand must not be used afterwards. +std::shared_ptr<pugi::xml_document> XMLexport::takeExportDocument() { - auto clone = std::make_shared<pugi::xml_document>(); - for (pugi::xml_node child = mExportDoc.first_child(); child; child = child.next_sibling()) { - clone->append_copy(child); - } - return clone; + return std::make_shared<pugi::xml_document>(std::move(mExportDoc)); } bool XMLexport::exportHost(const QString& filename_pugi_xml) @@ -188,15 +183,11 @@ bool XMLexport::exportHost(const QString& filename_pugi_xml) return true; } -// Helper to encapsulate async save pattern: clone document, save in background thread, -// notify host when complete void XMLexport::runAsyncSave(const QString& fileName, const QString& xmlSavedKey) { - // Clone the XML document on the main thread, then serialize and save it on a - // background thread that owns the clone outright. QPointer<Host> host = mpHost; - auto future = QtConcurrent::run([fileName, docClone = cloneExportDocument()]() { - return XMLexport::saveXmlDocToFile(fileName, *docClone); + auto future = QtConcurrent::run([fileName, doc = takeExportDocument()]() { + return XMLexport::saveXmlDocToFile(fileName, *doc); }); // Parented to the profile for the same reason the module save's watcher is: the // deleteLater() below needs an event loop that is still running to be delivered, @@ -325,11 +316,9 @@ bool XMLexport::saveXml(const QString& fileName) return success; } -// Save an XML document to a file. This is thread-safe and can be called from a background thread -// as long as the document is not being modified concurrently (which we ensure by passing a clone). -// Static method so it can be called without keeping XMLexport alive. -// Note: This is a static member method that doesn't access any instance state, -// making it safe to call from background threads. +// Callable from a background thread as long as nothing modifies the document +// concurrently, which handing it over with takeExportDocument() ensures. Static so it +// neither keeps the XMLexport alive nor touches any instance state. bool XMLexport::saveXmlDocToFile(const QString& fileName, const pugi::xml_document& doc) { QSaveFile file(fileName); diff --git a/src/XMLexport.h b/src/XMLexport.h index 0477b247d..d357325ea 100644 --- a/src/XMLexport.h +++ b/src/XMLexport.h @@ -67,7 +67,7 @@ public: void writeKey(TKey*, pugi::xml_node xmlParent); void writeVariable(TVar*, LuaInterface*, VarUnit*, pugi::xml_node xmlParent, bool insideSavedTable = false); void writeModuleXML(const QString& moduleName); - std::shared_ptr<pugi::xml_document> cloneExportDocument() const; + std::shared_ptr<pugi::xml_document> takeExportDocument(); static bool saveXmlDocToFile(const QString& fileName, const pugi::xml_document& doc); bool exportHost(const QString& filename_pugi_xml); From 6bda075517e01b9ef210ab27cd4edfed0cde75e3 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Fri, 7 Aug 2026 06:13:56 +0200 Subject: [PATCH 111/155] fix: trigger editor and deleted item subtrees leaking memory (#9700) #### Brief overview of PR changes/additions - The editor's seven `delete_*` functions detached the selected `QTreeWidgetItem` subtree but never freed it, so every deleted item leaked its tree items and icons. The subtrees are now freed once the new selection applies, and detached variable items are also purged from `VarUnit`'s maps - which fixes a pre-existing double free when a table and its selected child were deleted together. - `~Host()` now deletes the editor when a profile is destroyed without `closeChildren()`, and the undo-stack disconnects moved into the destructor so every destruction path is covered. #### Motivation for adding to Mudlet Every trigger/alias/script/timer/key/button/variable deleted in the editor leaked for the session's lifetime. Found during the LSan baseline sweep of the functional tests. #### Other info (issues closed, discussion etc) Test case: `dlgTriggerEditorUndoRedoTest` with `detect_leaks=1` drops from 3,382,339 to 13,633 leaked bytes (residue is the settings floor fixed in #9694). Full suite passes twice; profile-close/quit with open editors are clean under ASan; runtime unchanged (~4.9s before and after). Assisted-by: Claude:claude-fable-5 --- src/Host.cpp | 9 ++++ src/VarUnit.cpp | 6 +++ src/VarUnit.h | 9 ++-- src/dlgTriggerEditor.cpp | 91 +++++++++++++++++++++++++++++++++++----- 4 files changed, 100 insertions(+), 15 deletions(-) diff --git a/src/Host.cpp b/src/Host.cpp index a53dc1e56..0db451c52 100644 --- a/src/Host.cpp +++ b/src/Host.cpp @@ -456,6 +456,15 @@ Host::~Host() // is being taken apart runs against freed members (#9653): mDeferredSaveTimer.stop(); + // The editor is a parentless top-level window, so delete it here while the + // units it references are still alive. Null the QPointer first: it only + // clears itself once ~QObject is reached, so anything looking at + // mpEditorDialog mid-teardown would find a half-destroyed widget: + if (auto* pEditor = mpEditorDialog.data()) { + mpEditorDialog = nullptr; + delete pEditor; + } + // This needs to be cleared here while the Host object is still valid, // otherwise it'll be cleared when the Host object is being destroyed, // which can lead to a crash when closing multiple profiles at once. diff --git a/src/VarUnit.cpp b/src/VarUnit.cpp index 5c6ba102d..7f7469499 100644 --- a/src/VarUnit.cpp +++ b/src/VarUnit.cpp @@ -182,6 +182,12 @@ void VarUnit::addTreeItem(QTreeWidgetItem* p, TVar* var) wVars.insert(p, var); } +void VarUnit::removeTreeItem(QTreeWidgetItem* p) +{ + wVars.remove(p); + tVars.remove(p); +} + void VarUnit::addTempVar(QTreeWidgetItem* p, TVar* var) { tVars.insert(p, var); diff --git a/src/VarUnit.h b/src/VarUnit.h index 80be57add..46e018a12 100644 --- a/src/VarUnit.h +++ b/src/VarUnit.h @@ -59,14 +59,15 @@ public: TVar* getWVar(QTreeWidgetItem*); TVar* getTVar(QTreeWidgetItem*); void addTreeItem(QTreeWidgetItem*, TVar*); + void removeTreeItem(QTreeWidgetItem*); void addSavedVar(TVar*); void removeSavedVar(TVar*); void addHidden(TVar*, int); void addHidden(const QString&); - bool isHidden(TVar *var); - bool isHidden(const QString &fullname); - void removeHidden(TVar *var); - void removeHidden(const QString &name); + bool isHidden(TVar* var); + bool isHidden(const QString& fullname); + void removeHidden(TVar* var); + void removeHidden(const QString& name); bool isSaved(TVar*); void addPointer(const void*); QString getUnsaveableReason(TVar*); diff --git a/src/dlgTriggerEditor.cpp b/src/dlgTriggerEditor.cpp index 04bf69b93..faf4465d4 100644 --- a/src/dlgTriggerEditor.cpp +++ b/src/dlgTriggerEditor.cpp @@ -1422,6 +1422,14 @@ dlgTriggerEditor::~dlgTriggerEditor() // into one of the slot_saveProperty_...() slots when this object is no // longer a valid receiver (#9574) utils::disconnectChildSignals(this); + // The undo stacks are not in this widget's child tree - the edbee one hangs + // off a parentless CharTextDocument - so disconnect them by hand: + if (mpTextUndoStack) { + disconnect(mpTextUndoStack, nullptr, this, nullptr); + } + if (mpUndoStack) { + disconnect(mpUndoStack, nullptr, this, nullptr); + } } void dlgTriggerEditor::slot_searchSplitterMoved(const int pos, const int index) @@ -1881,17 +1889,6 @@ void dlgTriggerEditor::slot_setTreeWidgetIconSize(const int s) void dlgTriggerEditor::closeEvent(QCloseEvent* event) { - // Only disconnect signals and clear undo stack if the dialog is being destroyed (WA_DeleteOnClose set) - // This happens when the profile closes (Host::closeChildren), not when the user just closes the editor window - if (testAttribute(Qt::WA_DeleteOnClose)) { - if (mpTextUndoStack) { - disconnect(mpTextUndoStack, nullptr, this, nullptr); - } - if (mpUndoStack) { - disconnect(mpUndoStack, nullptr, this, nullptr); - } - } - emit editorClosing(); writeSettings(); event->accept(); @@ -3058,6 +3055,7 @@ void dlgTriggerEditor::delete_alias() std::reverse(selectedItems.begin(), selectedItems.end()); QTreeWidgetItem* newSelection = nullptr; + QList<QTreeWidgetItem*> removedItems; for (QTreeWidgetItem* pItem : std::as_const(selectedItems)) { QTreeWidgetItem* pParentItem = pItem->parent(); const int itemId = pItem->data(0, Qt::UserRole).toInt(); @@ -3080,6 +3078,7 @@ void dlgTriggerEditor::delete_alias() } if (pParentItem) { pParentItem->removeChild(pItem); + removedItems.append(pItem); } clearEditorState(EditorViewType::cmAliasView, itemId); delete pT; @@ -3091,6 +3090,12 @@ void dlgTriggerEditor::delete_alias() mpUndoStack->pushCommand(qtCmd); } + // Detaching an item nulls treeWidget() on its whole subtree, which is how a + // newSelection that sat inside another removed subtree is caught here: + if (newSelection && !newSelection->treeWidget()) { + newSelection = mpAliasBaseItem; + } + // Set new selection if (newSelection) { mpCurrentAliasItem = newSelection; @@ -3100,6 +3105,10 @@ void dlgTriggerEditor::delete_alias() mpCurrentAliasItem = nullptr; clearAliasForm(); } + + // Has to stay after the selection handling: the slots it fires still read + // the detached items. + qDeleteAll(removedItems); } void dlgTriggerEditor::delete_action() @@ -3201,6 +3210,7 @@ void dlgTriggerEditor::delete_action() std::reverse(selectedItems.begin(), selectedItems.end()); QTreeWidgetItem* newSelection = nullptr; + QList<QTreeWidgetItem*> removedItems; for (QTreeWidgetItem* pItem : std::as_const(selectedItems)) { QTreeWidgetItem* pParentItem = pItem->parent(); const int itemId = pItem->data(0, Qt::UserRole).toInt(); @@ -3228,6 +3238,7 @@ void dlgTriggerEditor::delete_action() } if (pParentItem) { pParentItem->removeChild(pItem); + removedItems.append(pItem); } clearEditorState(EditorViewType::cmActionView, itemId); delete pT; @@ -3239,6 +3250,10 @@ void dlgTriggerEditor::delete_action() mpUndoStack->pushCommand(qtCmd); } + if (newSelection && !newSelection->treeWidget()) { + newSelection = mpActionBaseItem; + } + // Set new selection if (newSelection) { mpCurrentActionItem = newSelection; @@ -3249,6 +3264,8 @@ void dlgTriggerEditor::delete_action() clearActionForm(); } + qDeleteAll(removedItems); + mpHost->getActionUnit()->updateAllToolbars(); } @@ -3287,6 +3304,7 @@ void dlgTriggerEditor::delete_variable() std::reverse(selectedItems.begin(), selectedItems.end()); QTreeWidgetItem* newSelection = nullptr; + QList<QTreeWidgetItem*> removedItems; for (QTreeWidgetItem* pItem : std::as_const(selectedItems)) { QTreeWidgetItem* pParentItem = pItem->parent(); TVar* var = vu->getWVar(pItem); @@ -3304,11 +3322,28 @@ void dlgTriggerEditor::delete_variable() } if (pParentItem) { pParentItem->removeChild(pItem); + removedItems.append(pItem); + // Deleting the TVar below frees its descendants too and nothing + // unregisters those, so drop the whole detached subtree from the + // lookup maps now: a later pass over a selected descendant would + // otherwise resolve a freed TVar, as would a recycled item address: + QList<QTreeWidgetItem*> pendingPurge{pItem}; + while (!pendingPurge.isEmpty()) { + QTreeWidgetItem* pEntry = pendingPurge.takeLast(); + vu->removeTreeItem(pEntry); + for (int i = 0; i < pEntry->childCount(); ++i) { + pendingPurge.append(pEntry->child(i)); + } + } } delete var; } } + if (newSelection && !newSelection->treeWidget()) { + newSelection = mpVarBaseItem; + } + // Set new selection if (newSelection) { mpCurrentVarItem = newSelection; @@ -3318,6 +3353,8 @@ void dlgTriggerEditor::delete_variable() mpCurrentVarItem = nullptr; clearVarForm(); } + + qDeleteAll(removedItems); } void dlgTriggerEditor::delete_script() @@ -3410,6 +3447,7 @@ void dlgTriggerEditor::delete_script() std::reverse(selectedItems.begin(), selectedItems.end()); QTreeWidgetItem* newSelection = nullptr; + QList<QTreeWidgetItem*> removedItems; for (QTreeWidgetItem* pItem : std::as_const(selectedItems)) { QTreeWidgetItem* pParentItem = pItem->parent(); const int itemId = pItem->data(0, Qt::UserRole).toInt(); @@ -3432,6 +3470,7 @@ void dlgTriggerEditor::delete_script() } if (pParentItem) { pParentItem->removeChild(pItem); + removedItems.append(pItem); } clearEditorState(EditorViewType::cmScriptView, itemId); delete pT; @@ -3443,6 +3482,10 @@ void dlgTriggerEditor::delete_script() mpUndoStack->pushCommand(qtCmd); } + if (newSelection && !newSelection->treeWidget()) { + newSelection = mpScriptsBaseItem; + } + // Set new selection if (newSelection) { mpCurrentScriptItem = newSelection; @@ -3452,6 +3495,8 @@ void dlgTriggerEditor::delete_script() mpCurrentScriptItem = nullptr; clearScriptForm(); } + + qDeleteAll(removedItems); } void dlgTriggerEditor::delete_key() @@ -3544,6 +3589,7 @@ void dlgTriggerEditor::delete_key() std::reverse(selectedItems.begin(), selectedItems.end()); QTreeWidgetItem* newSelection = nullptr; + QList<QTreeWidgetItem*> removedItems; for (QTreeWidgetItem* pItem : std::as_const(selectedItems)) { QTreeWidgetItem* pParentItem = pItem->parent(); const int itemId = pItem->data(0, Qt::UserRole).toInt(); @@ -3566,6 +3612,7 @@ void dlgTriggerEditor::delete_key() } if (pParentItem) { pParentItem->removeChild(pItem); + removedItems.append(pItem); } clearEditorState(EditorViewType::cmKeysView, itemId); delete pT; @@ -3577,6 +3624,10 @@ void dlgTriggerEditor::delete_key() mpUndoStack->pushCommand(qtCmd); } + if (newSelection && !newSelection->treeWidget()) { + newSelection = mpKeyBaseItem; + } + // Set new selection if (newSelection) { mpCurrentKeyItem = newSelection; @@ -3586,6 +3637,8 @@ void dlgTriggerEditor::delete_key() mpCurrentKeyItem = nullptr; clearKeyForm(); } + + qDeleteAll(removedItems); } void dlgTriggerEditor::delete_trigger() @@ -3683,6 +3736,7 @@ void dlgTriggerEditor::delete_trigger() std::reverse(selectedItems.begin(), selectedItems.end()); QTreeWidgetItem* newSelection = nullptr; + QList<QTreeWidgetItem*> removedItems; for (QTreeWidgetItem* pItem : std::as_const(selectedItems)) { QTreeWidgetItem* pParentItem = pItem->parent(); const int itemId = pItem->data(0, Qt::UserRole).toInt(); @@ -3705,6 +3759,7 @@ void dlgTriggerEditor::delete_trigger() } if (pParentItem) { pParentItem->removeChild(pItem); + removedItems.append(pItem); } clearEditorState(EditorViewType::cmTriggerView, itemId); delete pT; @@ -3716,6 +3771,10 @@ void dlgTriggerEditor::delete_trigger() mpUndoStack->pushCommand(qtCmd); } + if (newSelection && !newSelection->treeWidget()) { + newSelection = mpTriggerBaseItem; + } + // Set new selection if (newSelection) { mpCurrentTriggerItem = newSelection; @@ -3725,6 +3784,8 @@ void dlgTriggerEditor::delete_trigger() mpCurrentTriggerItem = nullptr; clearTriggerForm(); } + + qDeleteAll(removedItems); } void dlgTriggerEditor::delete_timer() @@ -3817,6 +3878,7 @@ void dlgTriggerEditor::delete_timer() std::reverse(selectedItems.begin(), selectedItems.end()); QTreeWidgetItem* newSelection = nullptr; + QList<QTreeWidgetItem*> removedItems; for (QTreeWidgetItem* pItem : std::as_const(selectedItems)) { QTreeWidgetItem* pParentItem = pItem->parent(); const int itemId = pItem->data(0, Qt::UserRole).toInt(); @@ -3839,6 +3901,7 @@ void dlgTriggerEditor::delete_timer() } if (pParentItem) { pParentItem->removeChild(pItem); + removedItems.append(pItem); } clearEditorState(EditorViewType::cmTimerView, itemId); delete pT; @@ -3850,6 +3913,10 @@ void dlgTriggerEditor::delete_timer() mpUndoStack->pushCommand(qtCmd); } + if (newSelection && !newSelection->treeWidget()) { + newSelection = mpTimerBaseItem; + } + // Set new selection if (newSelection) { mpCurrentTimerItem = newSelection; @@ -3859,6 +3926,8 @@ void dlgTriggerEditor::delete_timer() mpCurrentTimerItem = nullptr; clearTimerForm(); } + + qDeleteAll(removedItems); } From 71f736297b0ca426ba9a6cc25343446c97be5002 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Fri, 7 Aug 2026 06:14:11 +0200 Subject: [PATCH 112/155] infrastructure: reject a release tag that does not match APP_VERSION (#9701) #### Brief overview of PR changes/additions - Adds `CI/check-release-tag.sh`: APP_VERSION must be three-component, and a release tag must be exactly `Mudlet-<APP_VERSION>`. - Wires it into the tag-build validation (`CI/validate_deployment.sh`, `CI/validate-deployment-for-windows.sh`) so a bad tag fails minutes after the push, before an asset exists, and into `create-github-release.yml` as the last gate before anything is published. The PTB path gets the version-shape half, which nothing checks on `development` today. - Covers it with `test/ci/release-tag-version-test.sh`, registered as `ReleaseTagVersionTest`. #### Motivation for adding to Mudlet Tagging `Mudlet-5.0` instead of `Mudlet-5.0.0` would strand the entire 4.22.0 user base with no error anywhere, and it is the one version mistake CI does not currently catch. The updater takes the version it offers from the tag, not the binary: `Release::Release()` strips the `Mudlet-` prefix (`src/updater/Release.cpp:49`) and `SemVer::getRegExp()` needs three components (`src/updater/SemVer.cpp:111`), so `"5.0"` is invalid, `Release::operator<` (`src/updater/Release.cpp:96`) reports the release as not newer, and `Feed::getUpdates()` returns nothing. The update check goes on logging `0 update(s) available` - the same line as a week with no release. The asymmetry is what makes it dangerous. A stale APP_VERSION with a correct tag fails loudly, because `CI/prepare-release-assets.sh:62` rejects assets by tag prefix. A short tag with a correct APP_VERSION passes everything, because `Mudlet-5.0.0-linux-x64.AppImage.tar` genuinely does start with `Mudlet-5.0`. **Why the build scripts and not only the workflow:** `create-github-release.yml` is `workflow_run`-triggered, so it cannot fail before the assets are built - by the time it runs, the full matrix has already finished. The validate scripts run at the start of every tag build on all three platforms and already parse APP_VERSION, so that is where the fast failure belongs. The workflow keeps a copy because it always runs from the default branch, so it still guards a tag placed on a commit that predates this change. APP_VERSION is deliberately left at 4.22.0 - bumping it is a release decision, not a QA fix. This guard is what catches a mismatch when the bump happens. #### Other info (issues closed, discussion etc) From the 5.0 release QA sweep, finding C1, "A two-component release tag silently disables auto-update for every existing user". Pre-existing mechanism, no single commit introduced it. Three claims from an earlier draft did not survive checking and were corrected: `src/sparkleupdater.mm` installs no `versionComparatorForUpdater:`, so Sparkle's default component-wise comparator would still offer `5.0` over `4.22.0` (macOS breaks on the opposite mismatch instead); the update check does log, it is just indistinguishable from having nothing to offer; and SemVer does accept a prerelease component, so rejecting `Mudlet-5.0.0-rc1` follows from APP_VERSION being unable to carry a suffix, not from the updater. No video - a CI guard is not visually observable. The shell output below is the evidence instead. **Test case:** `ctest -R ReleaseTagVersionTest`, and the guard run directly: ``` $ CI/check-release-tag.sh 5.0.0 Mudlet-5.0.0 Release tag 'Mudlet-5.0.0' matches APP_VERSION '5.0.0'. exit=0 $ CI/check-release-tag.sh 5.0.0 Mudlet-5.0 error: release tag 'Mudlet-5.0' does not match APP_VERSION '5.0.0'. The tag has to be exactly 'Mudlet-5.0.0'. Publishing under a mismatched tag breaks auto-update, without saying so. [...] exit=1 ``` Replayed over every release tag since 4.18.5, each against the APP_VERSION at that tag - all accepted, so the guard blocks nothing Mudlet has actually shipped. Executing the real `Determine release type` step under GitHub's shell flags fails on `Mudlet-5.0` + `5.0.0` and on a PTB with APP_VERSION `5.0`, and passes on `Mudlet-5.0.0` + `5.0.0` and on a normal PTB. The updater trace was confirmed by compiling `Release.cpp` + `SemVer.cpp` and comparing: tag `Mudlet-5.0.0` gives `(4.22.0 < release) = true`, tag `Mudlet-5.0` gives `false`. Assisted-by: Claude:claude-opus-5 --- .github/workflows/create-github-release.yml | 8 + CI/check-release-tag.sh | 74 +++++++++ CI/validate-deployment-for-windows.sh | 19 +++ CI/validate_deployment.sh | 19 +++ test/CMakeLists.txt | 8 + test/ci/release-tag-version-test.sh | 175 ++++++++++++++++++++ 6 files changed, 303 insertions(+) create mode 100755 CI/check-release-tag.sh create mode 100755 test/ci/release-tag-version-test.sh diff --git a/.github/workflows/create-github-release.yml b/.github/workflows/create-github-release.yml index e6a7046b2..4b5aed784 100644 --- a/.github/workflows/create-github-release.yml +++ b/.github/workflows/create-github-release.yml @@ -160,6 +160,10 @@ jobs: COMMIT=$(echo "$META" | jq -r '.commit') if [[ "$REF" == refs/tags/Mudlet-* ]]; then + # release-scripts/ is this workflow's own ref, so the guard is present + # even when the tagged commit predates it + bash release-scripts/CI/check-release-tag.sh "${VERSION}" "${REF#refs/tags/}" + echo "type=release" >> "$GITHUB_OUTPUT" echo "tag=${REF#refs/tags/}" >> "$GITHUB_OUTPUT" echo "title=Mudlet ${VERSION}" >> "$GITHUB_OUTPUT" @@ -169,6 +173,10 @@ jobs: echo "::error::COMMIT field is empty or missing in release metadata for PTB" exit 1 fi + # Nothing validates APP_VERSION on development, and a two-component one + # makes a PTB unofferable the same way + bash release-scripts/CI/check-release-tag.sh "${VERSION}" + PTB_TAG="Mudlet-${VERSION}${BUILD_SUFFIX}-${COMMIT}" echo "type=ptb" >> "$GITHUB_OUTPUT" echo "tag=${PTB_TAG}" >> "$GITHUB_OUTPUT" diff --git a/CI/check-release-tag.sh b/CI/check-release-tag.sh new file mode 100755 index 000000000..b11c21643 --- /dev/null +++ b/CI/check-release-tag.sh @@ -0,0 +1,74 @@ +#!/bin/bash +# Usage: check-release-tag.sh <version> [tag] +# +# The updater offers the version from the release tag, not from APP_VERSION +# (src/updater/Release.cpp), and SemVer needs three components - so "Mudlet-5.0" is +# never offered to anyone, silently. CI/prepare-release-assets.sh cannot see it: that +# check matches the tag as a prefix of the asset names, and "Mudlet-5.0.0-linux-x64" +# does start with "Mudlet-5.0". Only the opposite mistake fails there. +# +# "Mudlet-5.0.0-rc1" is rejected as well - SemVer would accept it, but APP_VERSION +# cannot carry a suffix, so the assets named after it would not match the tag. +# +# A PTB passes no tag, its tag being generated rather than pushed. + +set -euo pipefail + +VERSION="${1:-}" +TAG="${2:-}" + +if [ $# -lt 1 ] || [ $# -gt 2 ] || [ -z "${VERSION}" ]; then + echo "usage: $(basename "$0") <version> [tag]" >&2 + exit 2 +fi + +# A multi-line message cannot become a GitHub annotation, so summarise in one line +annotate() { + if [ "${GITHUB_ACTIONS:-}" = "true" ]; then + echo "::error::$1" + fi +} + +# Same shape SemVer::getRegExp() accepts, leading zeros and all +if ! [[ "${VERSION}" =~ ^(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)$ ]]; then + annotate "APP_VERSION '${VERSION}' is not a three-component version - nothing built from it would ever be offered as an update to anyone who already has Mudlet installed" + cat >&2 <<EOF +error: APP_VERSION '${VERSION}' is not a three-component version like 5.0.0. + +Mudlet's updater only recognises three-component semantic versions, so a build +carrying this version is never offered to anyone who already has Mudlet installed - +including public test builds. Set a three-component version in +set(APP_VERSION ...) in CMakeLists.txt. +EOF + exit 1 +fi + +if [ -n "${TAG}" ] && [ "${TAG}" != "Mudlet-${VERSION}" ]; then + annotate "Release tag '${TAG}' does not match APP_VERSION '${VERSION}' - it has to be exactly 'Mudlet-${VERSION}', or auto-update stops working for every existing user without saying so" + cat >&2 <<EOF +error: release tag '${TAG}' does not match APP_VERSION '${VERSION}'. +The tag has to be exactly 'Mudlet-${VERSION}'. + +Publishing under a mismatched tag breaks auto-update, without saying so. The +updater reads the version it offers from the tag rather than from the binary, so a +tag like 'Mudlet-5.0' offers version '5.0' - not a three-component semantic +version, therefore never newer than the installed 4.22.0, therefore never offered. +No error is shown and the update check logs "0 update(s) available", the same line +it logs when there is genuinely nothing new. + +It also desynchronises macOS: create-github-release.yml puts the tag's version into +<sparkle:version> while the app reports APP_VERSION as its CFBundleVersion, so a +tag ahead of APP_VERSION leaves Sparkle re-offering an update the installed app can +never satisfy. + +Delete the tag and push it again as 'Mudlet-${VERSION}'. If '${VERSION}' is not the +version you meant to release, change set(APP_VERSION ...) in CMakeLists.txt first. +EOF + exit 1 +fi + +# A release log with no line here reads the same whether the tag was compared or the +# guard was never reached +if [ -n "${TAG}" ]; then + echo "Release tag '${TAG}' matches APP_VERSION '${VERSION}'." +fi diff --git a/CI/validate-deployment-for-windows.sh b/CI/validate-deployment-for-windows.sh index ff7d634c4..c14dec951 100644 --- a/CI/validate-deployment-for-windows.sh +++ b/CI/validate-deployment-for-windows.sh @@ -25,12 +25,31 @@ function validate_cmake() { # there is no static "APP_BUILD" line left to validate here. } +function validate_release_tag() { + local TAG_NAME="" + if [[ "${GITHUB_REF:-}" =~ ^refs/tags/ ]]; then + TAG_NAME="${GITHUB_REF#refs/tags/}" + fi + if [ -z "${TAG_NAME}" ]; then + error "This is a release build, but the tag being built could not be determined from GITHUB_REF." + fi + + local APP_VERSION + APP_VERSION=$(pcre2grep --only-matching=1 "set\(APP_VERSION (.+)\)$" < CMakeLists.txt) + if [ -z "${APP_VERSION}" ]; then + error "No set(APP_VERSION ...) line could be read out of CMakeLists.txt." + fi + + bash "$(dirname "${BASH_SOURCE[0]}")/check-release-tag.sh" "${APP_VERSION}" "${TAG_NAME}" || exit $? +} + function validate_updater_environment_variable() { if [ "$WITH_UPDATER" == "NO" ]; then error "Updater is disabled in a release build." fi } +validate_release_tag validate_cmake validate_updater_environment_variable diff --git a/CI/validate_deployment.sh b/CI/validate_deployment.sh index b0d9aaa46..4ea901b74 100755 --- a/CI/validate_deployment.sh +++ b/CI/validate_deployment.sh @@ -26,12 +26,31 @@ else # there is no static "APP_BUILD" line left to validate here. } + function validate_release_tag() { + local TAG_NAME="${TRAVIS_TAG:-}" + if [[ "${GITHUB_REF:-}" =~ ^refs/tags/ ]]; then + TAG_NAME="${GITHUB_REF#refs/tags/}" + fi + if [ -z "${TAG_NAME}" ]; then + error "This is a release build, but the tag being built could not be determined from GITHUB_REF or TRAVIS_TAG." + fi + + local APP_VERSION + APP_VERSION=$(pcre2grep --only-matching=1 "set\(APP_VERSION (.+)\)$" < CMakeLists.txt) + if [ -z "${APP_VERSION}" ]; then + error "No set(APP_VERSION ...) line could be read out of CMakeLists.txt." + fi + + bash "$(dirname "${BASH_SOURCE[0]}")/check-release-tag.sh" "${APP_VERSION}" "${TAG_NAME}" || exit $? + } + function validate_updater_environment_variable() { if [ "$WITH_UPDATER" == "NO" ]; then error "Updater is disabled in a release build." fi } + validate_release_tag validate_cmake validate_updater_environment_variable fi diff --git a/test/CMakeLists.txt b/test/CMakeLists.txt index df86bffe2..3ff0759fa 100644 --- a/test/CMakeLists.txt +++ b/test/CMakeLists.txt @@ -108,6 +108,14 @@ if(NOT WIN32) ) endif() +# The updater reads its version from the release tag, so a tag like "Mudlet-5.0" +# stops every existing user being offered the release, silently +if(NOT WIN32) + add_test(NAME ReleaseTagVersionTest + COMMAND bash ${CMAKE_CURRENT_SOURCE_DIR}/ci/release-tag-version-test.sh + ) +endif() + # Checks the milestone lookup that add-milestone runs - the one that matched a # title that no longer existed and assigned nothing for months, without ever # failing. gh is stubbed, so there is no network and no token diff --git a/test/ci/release-tag-version-test.sh b/test/ci/release-tag-version-test.sh new file mode 100755 index 000000000..218554753 --- /dev/null +++ b/test/ci/release-tag-version-test.sh @@ -0,0 +1,175 @@ +#!/bin/bash +# Tests CI/check-release-tag.sh, which catches a mistake that otherwise leaves no +# trace: "Mudlet-5.0" passes every existing check and is then never offered to a +# single existing user. See that script for why. + +set -uo pipefail + +SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" +REPO_DIR="$(cd "${SCRIPT_DIR}/../.." && pwd)" +CHECK="${REPO_DIR}/CI/check-release-tag.sh" +RELEASE_WORKFLOW="${REPO_DIR}/.github/workflows/create-github-release.yml" + +WORK_DIR="$(mktemp -d)" +trap 'rm -rf "${WORK_DIR}"' EXIT + +OUT="${WORK_DIR}/out" +FAILURES=0 + +start_test() { + echo "=== $1" +} + +fail() { + echo " FAIL: $*" >&2 + FAILURES=$((FAILURES + 1)) +} + +run_check() { + bash "${CHECK}" "$@" > "${OUT}" 2>&1 + echo $? +} + +assert_status() { + local expected="$1" actual="$2" + # -ne on an empty status errors out and takes the false branch, turning every + # assertion into a pass + case "${actual}" in + ''|*[!0-9]*) + fail "expected exit ${expected}, got a non-numeric status '${actual}'" + return + ;; + esac + if [ "${actual}" -ne "${expected}" ]; then + fail "expected exit ${expected}, got ${actual}, output:" + sed 's/^/ /' "${OUT}" >&2 + fi +} + +assert_contains() { + local file="$1" needle="$2" + if ! grep -qF -- "${needle}" "${file}"; then + fail "expected '${needle}' in ${file}:" + sed 's/^/ /' "${file}" >&2 + fi +} + +start_test "the tag a 5.0 release has to carry is accepted" +assert_status 0 "$(run_check "5.0.0" "Mudlet-5.0.0")" + +start_test "the tags of every release since 4.19 are accepted, and plausible future ones" +for version in 4.19.0 4.20.1 4.21.0 4.22.0 5.0.0 10.11.12; do + assert_status 0 "$(run_check "${version}" "Mudlet-${version}")" +done + +start_test "the two-component tag that silently disables auto-update is rejected" +assert_status 1 "$(run_check "5.0.0" "Mudlet-5.0")" +assert_contains "${OUT}" "Mudlet-5.0.0" +assert_contains "${OUT}" "auto-update" + +start_test "a stale tag against a bumped APP_VERSION is rejected" +assert_status 1 "$(run_check "5.0.0" "Mudlet-4.22.0")" + +start_test "a stale APP_VERSION against a bumped tag is rejected" +assert_status 1 "$(run_check "4.22.0" "Mudlet-5.0.0")" + +start_test "a two-component APP_VERSION is rejected even though its tag matches" +assert_status 1 "$(run_check "5.0" "Mudlet-5.0")" +assert_contains "${OUT}" "three-component" + +start_test "a version SemVer would reject for its leading zeros is rejected" +assert_status 1 "$(run_check "5.01.0" "Mudlet-5.01.0")" + +# Release.cpp strips only a capitalised "Mudlet-", while the asset check is +# case-insensitive and set-build-info.sh lowercases the version +start_test "a lowercase tag is rejected" +assert_status 1 "$(run_check "4.22.0" "mudlet-4.22.0")" + +start_test "a tag missing the Mudlet- prefix is rejected" +assert_status 1 "$(run_check "5.0.0" "5.0.0")" + +start_test "a suffixed tag is rejected while APP_VERSION cannot carry a suffix" +assert_status 1 "$(run_check "5.0.0" "Mudlet-5.0.0-rc1")" + +start_test "a PTB checks its version without a tag to compare against" +assert_status 0 "$(run_check "5.0.0")" +assert_status 1 "$(run_check "5.0")" +assert_contains "${OUT}" "three-component" + +start_test "a missing or surplus argument is a usage error, not a silent pass" +assert_status 2 "$(run_check "")" +assert_status 2 "$(run_check)" +assert_status 2 "$(run_check "5.0.0" "Mudlet-5.0.0" "extra")" + +start_test "the failure is annotated for GitHub Actions, not only printed" +GITHUB_ACTIONS=true bash "${CHECK}" "5.0.0" "Mudlet-5.0" > "${OUT}" 2>&1 +assert_contains "${OUT}" "::error::" + +start_test "the tag-push build validation calls the guard" +if ! command -v pcre2grep > /dev/null; then + # Skipping is a local convenience; on CI a missing pcre2grep is a broken runner + if [ -n "${CI:-}${GITHUB_ACTIONS:-}" ]; then + fail "pcre2grep is missing, so the build validation scripts cannot be exercised" + else + echo " skipped: pcre2grep is not installed" + fi +else + mkdir -p "${WORK_DIR}/repo" + printf 'set(APP_VERSION 5.0.0)\n' > "${WORK_DIR}/repo/CMakeLists.txt" + + for script in validate_deployment.sh validate-deployment-for-windows.sh; do + (cd "${WORK_DIR}/repo" && GITHUB_REF="refs/tags/Mudlet-5.0.0" GITHUB_REPO_TAG=true WITH_UPDATER=YES \ + bash "${REPO_DIR}/CI/${script}") > "${OUT}" 2>&1 + assert_status 0 "$?" + + (cd "${WORK_DIR}/repo" && GITHUB_REF="refs/tags/Mudlet-5.0" GITHUB_REPO_TAG=true WITH_UPDATER=YES \ + bash "${REPO_DIR}/CI/${script}") > "${OUT}" 2>&1 + assert_status 1 "$?" + assert_contains "${OUT}" "does not match APP_VERSION" + done + + # The Windows script decides it is a release build from GITHUB_REPO_TAG but takes + # the tag from GITHUB_REF, so the two can disagree + (cd "${WORK_DIR}/repo" && GITHUB_REF="refs/heads/development" GITHUB_REPO_TAG=true WITH_UPDATER=YES \ + bash "${REPO_DIR}/CI/validate-deployment-for-windows.sh") > "${OUT}" 2>&1 + assert_status 1 "$?" + assert_contains "${OUT}" "could not be determined" + + # The two scripts decide "not a release build" from different variables + (cd "${WORK_DIR}/repo" && GITHUB_REF="refs/heads/development" WITH_UPDATER=YES \ + bash "${REPO_DIR}/CI/validate_deployment.sh") > "${OUT}" 2>&1 + assert_status 0 "$?" + assert_contains "${OUT}" "skipping release validation" + + (cd "${WORK_DIR}/repo" && GITHUB_REF="refs/heads/development" GITHUB_REPO_TAG=false WITH_UPDATER=YES \ + bash "${REPO_DIR}/CI/validate-deployment-for-windows.sh") > "${OUT}" 2>&1 + assert_status 0 "$?" + assert_contains "${OUT}" "skipping release validation" +fi + +start_test "the release workflow calls the guard before it publishes anything" +# Keeps the line numbering, so a commented-out call cannot satisfy any of this +UNCOMMENTED="${WORK_DIR}/workflow-without-comments" +sed 's/^[[:space:]]*#.*$//' "${RELEASE_WORKFLOW}" > "${UNCOMMENTED}" + +release_call='^[[:space:]]*bash release-scripts/CI/check-release-tag\.sh "\$\{VERSION\}" "\$\{REF#refs/tags/\}"[[:space:]]*$' +ptb_call='^[[:space:]]*bash release-scripts/CI/check-release-tag\.sh "\$\{VERSION\}"[[:space:]]*$' +publish_line=$(grep -n 'gh release create' "${UNCOMMENTED}" | head -1 | cut -d: -f1) + +for description in "release:${release_call}" "PTB:${ptb_call}"; do + guard_line=$(grep -nE "${description#*:}" "${UNCOMMENTED}" | head -1 | cut -d: -f1) + if [ -z "${guard_line}" ]; then + fail "create-github-release.yml no longer runs the guard on the ${description%%:*} path" + elif [ -z "${publish_line}" ]; then + fail "could not find the publishing step in create-github-release.yml" + elif [ "${guard_line}" -ge "${publish_line}" ]; then + fail "the ${description%%:*} guard at line ${guard_line} runs after the release is published at line ${publish_line}" + fi +done + +if [ "${FAILURES}" -gt 0 ]; then + echo "${FAILURES} check(s) failed" + exit 1 +fi + +echo "All checks passed" From 13ac7da8390e29d6710cdf9a8e08c0ae01b3844b Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Fri, 7 Aug 2026 06:20:08 +0200 Subject: [PATCH 113/155] fix: mapper scripts stopped being told the map had opened (#9709) #### Brief overview of PR changes/additions - `createMapper()` raises `mapOpenEvent` again when the profile's map is already loaded, and repopulates/reselects the mapper's area dropdown on that path - The redundant second `map->restore()` that `2a3334a6a` ("Fix: don't load a map if trying to create a mapper & map is already loaded (#9415)") was written to skip is still skipped - only the event raise and the combo box setup move back out of its guard, matching the shape `Host::createMapper()` has always had - New `EmbeddedMapperCreationTest` functional test covering both sides of the branch; the busted suite structurally cannot, since an embedded mapper and the dockable map widget are mutually exclusive for the life of a profile #### Motivation for adding to Mudlet Every returning user has a saved map, so `createMapper()` and `Geyser.Mapper{embedded = true}` hit exactly this path, and third-party mapping scripts that finish setting themselves up on `mapOpenEvent` silently stopped running. #### Other info (issues closed, discussion etc) Found in the 5.0 QA sweep (finding C4), verified on two pristine profiles: 0 rooms raises the event once, 1 room raised it zero times. The same guard also swallowed `updateAreaComboBox()`/`resetAreaComboBoxToPlayerRoomArea()`, which left the area dropdown reading "Default Area" while the player room was elsewhere. Assisted-by: Claude:claude-opus-5 **Test case:** on a profile with a saved map, run `registerAnonymousEventHandler("mapOpenEvent", function() echo("\nmapOpenEvent fired\n") end) createMapper(0, 0, 400, 400)` - the echo appears, and the mapper's area dropdown shows the player's area. --- src/TMainConsole.cpp | 13 +- test/functional_tests/CMakeLists.txt | 1 + .../EmbeddedMapperCreationTest.cpp | 203 ++++++++++++++++++ 3 files changed, 212 insertions(+), 5 deletions(-) create mode 100644 test/functional_tests/EmbeddedMapperCreationTest.cpp diff --git a/src/TMainConsole.cpp b/src/TMainConsole.cpp index ae9eec23d..73584563f 100644 --- a/src/TMainConsole.cpp +++ b/src/TMainConsole.cpp @@ -932,12 +932,15 @@ std::pair<bool, QString> TMainConsole::createMapper(const QString& windowname, i } mpHost->mpMap->pushErrorMessagesToFile(tr("Loading map(2) at %1 report").arg(now.toString(Qt::ISODate)), true); - - TEvent mapOpenEvent{}; - mapOpenEvent.mArgumentList.append(QLatin1String("mapOpenEvent")); - mapOpenEvent.mArgumentTypeList.append(ARGUMENT_TYPE_STRING); - mpHost->raiseEvent(mapOpenEvent); + } else { + mpMapper->updateAreaComboBox(); + mpMapper->resetAreaComboBoxToPlayerRoomArea(); } + + TEvent mapOpenEvent{}; + mapOpenEvent.mArgumentList.append(QLatin1String("mapOpenEvent")); + mapOpenEvent.mArgumentTypeList.append(ARGUMENT_TYPE_STRING); + mpHost->raiseEvent(mapOpenEvent); } mpMapper->resize(width, height); mpMapper->move(x, y); diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index 0b2e464d7..d4781de5b 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -53,6 +53,7 @@ set(FUNCTIONAL_TEST_SOURCES DefaultPackagesTest.cpp ProfileSwitchShortcutTest.cpp ExperiencedPlayerGateTest.cpp + EmbeddedMapperCreationTest.cpp ) # The updater sources are only built with USE_UPDATER, and on macOS the diff --git a/test/functional_tests/EmbeddedMapperCreationTest.cpp b/test/functional_tests/EmbeddedMapperCreationTest.cpp new file mode 100644 index 000000000..460e428b6 --- /dev/null +++ b/test/functional_tests/EmbeddedMapperCreationTest.cpp @@ -0,0 +1,203 @@ +/*************************************************************************** + * Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +/* + * Covers TMainConsole::createMapper() - the embedded mapper behind Lua + * createMapper() and Geyser.Mapper{embedded = true} - on both sides of its + * already-loaded-map branch. + * + * An embedded mapper and the dockable map widget are mutually exclusive for the + * life of a profile and neither can be destroyed, so the busted suite cannot go + * here and each test method needs a mudlet of its own. + */ + +#include <QSignalSpy> +#include <QtTest/QtTest> +#include <chrono> + +#include "Host.h" +#include "MudletInstanceCoordinator.h" +#include "TMainConsole.h" +#include "TMap.h" +#include "TRoomDB.h" +#include "TelnetServerStub.h" +#include "ctelnet.h" +#include "dlgConnectionProfiles.h" +#include "dlgMapper.h" +#include "mudlet.h" + +using namespace std::chrono_literals; + +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); +void initializeQRCResourcesForEmbeddedMapperTest(); + +class EmbeddedMapperCreationTest : public QObject +{ + Q_OBJECT + +private: + TelnetServerStub* mpServer = nullptr; + Host* mpHost = nullptr; + const QString mHostname = qsl("Embedded-Mapper-Test-Host"); + QString mPort; + const QString mLocalhost = qsl("localhost"); + const QString mFirstAreaName = qsl("AAArea"); + const QString mPlayerAreaName = qsl("QAArea"); + +private slots: + void initTestCase() { initializeQRCResourcesForEmbeddedMapperTest(); } + + void init() + { + mpServer = new TelnetServerStub(qApp); + mpServer->start(mLocalhost, 0); + mPort = QString::number(mpServer->serverPort()); + mudlet::start(); + mudlet::self()->setupConfig(); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique<MudletInstanceCoordinator>("MudletInstanceCoordinator")); + mudlet::self()->init(); + mudlet::self()->setStorePasswordsSecurely(false); + deleteProfileDirectory(); + + QTimer::singleShot(0ms, qApp, [this]() { + mudlet::self()->startAutoLogin({}); + QTest::qWait(100ms); + QTest::mouseClick(mudlet::self()->mpConnectionDialog->new_profile_button, Qt::LeftButton); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), mHostname); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), mLocalhost); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), mPort); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Return); + }); + + QSignalSpy spy(mudlet::self(), &mudlet::signal_profileLoaded); + if (!spy.wait(5000)) { + QFAIL("Profile took too long to load."); + } + mpHost = mudlet::self()->getActiveHost(); + if (!mpHost) { + QFAIL("No active host available for the test."); + } + + QSignalSpy connectionSpy(&(mpHost->mTelnet), &cTelnet::signal_connected); + if (!connectionSpy.wait(2000)) { + QFAIL("Could not connect with the host."); + } + + QVERIFY(mpHost->mpConsole); + watchMapOpenEvent(); + } + + void cleanup() + { + delete mpServer; + mpServer = nullptr; + mpHost = nullptr; + deleteProfileDirectory(); + delete mudlet::self(); + } + + void test_createMapperWithALoadedMap() + { + TMap* pMap = mpHost->mpMap.data(); + TRoomDB* pRoomDB = pMap->mpRoomDB.get(); + + // the player's area has to sort after the one the dlgMapper constructor's own fill leaves selected + QVERIFY(pRoomDB->addArea(mFirstAreaName) > 0); + const int playerAreaId = pRoomDB->addArea(mPlayerAreaName); + QVERIFY(playerAreaId > 0); + QVERIFY(pMap->addRoom(1)); + QVERIFY(pMap->setRoomArea(1, playerAreaId, false)); + pMap->mRoomIdHash[pMap->mProfileName] = 1; + pMap->setDefaultAreaShown(false); + QVERIFY2(!pRoomDB->isEmpty(), "the map has to be non-empty for this to be the returning-user path"); + + auto [created, message] = mpHost->mpConsole->createMapper(QString(), 0, 0, 300, 300); + QVERIFY2(created, qPrintable(message)); + QVERIFY(mpHost->mpConsole->mpMapper); + + QVERIFY2(mapOpenEventCountIs(1), "createMapper() did not raise mapOpenEvent exactly once for an already-loaded map"); + + auto* pComboBox = mpHost->mpConsole->mpMapper->comboBox_showArea; + QCOMPARE(pComboBox->count(), 2); // the hidden default area is still in the constructor's fill + QCOMPARE(pComboBox->currentText(), mPlayerAreaName); + + // Geyser.Mapper re-runs createMapper() on every reposition + auto [recreated, recreateMessage] = mpHost->mpConsole->createMapper(QString(), 0, 0, 300, 300); + QVERIFY2(recreated, qPrintable(recreateMessage)); + QVERIFY2(mapOpenEventCountIs(1), "a repeat createMapper() raised mapOpenEvent again"); + } + + void test_createMapperWithNoMapToLoad() + { + QVERIFY2(mpHost->mpMap->mpRoomDB->isEmpty(), "a freshly created profile was expected to have no rooms"); + + auto [created, message] = mpHost->mpConsole->createMapper(QString(), 0, 0, 300, 300); + QVERIFY2(created, qPrintable(message)); + QVERIFY(mpHost->mpConsole->mpMapper); + + QVERIFY2(mapOpenEventCountIs(1), "createMapper() did not raise mapOpenEvent exactly once for a first-run profile"); + } + +private: + void watchMapOpenEvent() + { + mpHost->getLuaInterpreter()->compileAndExecuteScript(qsl("mapOpenSeen = 0\n" + "registerAnonymousEventHandler('mapOpenEvent', function() mapOpenSeen = mapOpenSeen + 1 end)")); + } + + bool mapOpenEventCountIs(const int expected) const { return mpHost->getLuaInterpreter()->compileAndExecuteScript(qsl("assert(mapOpenSeen == %1)").arg(expected)); } + + void deleteProfileDirectory() const + { + QDir dir(mudlet::getMudletPath(enums::profileHomePath, mHostname)); + if (dir.exists()) { + dir.removeRecursively(); + } + } +}; + +void initializeQRCResourcesForEmbeddedMapperTest() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +#include "EmbeddedMapperCreationTest.moc" +QTEST_MAIN(EmbeddedMapperCreationTest) From eaa991b9c236267fbbbec8b7314e0fd0dab268c5 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Fri, 7 Aug 2026 06:20:28 +0200 Subject: [PATCH 114/155] fix: pausing a track and then playing a different one left you with silence (#9710) #### Brief overview of PR changes/additions - Ending a track is now done before its player is handed to the next one, so pausing a sound (or music) and playing a *different* file plays it, and reports the paused track's own ending rather than a spurious `sysMediaFinished` carrying the new request's key and tag. - A `play()` call now owns the player it is setting up, so a `sysMediaFinished` handler that starts media of its own can no longer take that player over and make the caller's higher-priority request disappear. - `purgeMediaCache()` returns `nil, message` instead of a bare `false`, a media URL whose scheme is not http(s) now raises `sysDownloadError` instead of being refused silently, and the last pass of a `loops = N` track can no longer have its ending swallowed. #### Motivation for adding to Mudlet "Pause the ambience, start the combat theme" is an ordinary GMCP/script sequence and in 5.0 it produced silence plus a misleading event. #### Other info (issues closed, discussion etc) Found by the 5.0 QA sweep (finding C16). The three commits behind it were each reviewed alone and share one state machine: `92f01b850` "fix: Client.Media loops=-1 plays once (#9569)", `3474cb58d` "fix: playing a sound again right after stopping it (#9611)" and `8dd99e4db` "fix: media that fails to load never reports it (#9612)". Pause `a.wav`, then play `b.wav`, on `origin/development` and on this branch: ``` before sysMediaFinished file=a.wav key=k2 tag=t2 <- old file, new request's key (nothing playing, the paused track is gone too) after sysMediaFinished file=a.wav key=k1 tag=t1 sysMediaStarted file=b.wav key=k2 tag=t2 <- b.wav plays ``` Contract change worth a changelog line: `purgeMediaCache()` returned `false` on failure and now returns `nil` plus a message. `if not purgeMediaCache()` still behaves the same; `== false` no longer matches. Adjacent and deliberately left alone: `stopSounds{fadeaway = true}` issued while a track is still loading is lost, and the track then plays forever. That is byte-identical in 4.22.0, so it is not a 5.0 regression. `downloadFile()`'s five other refusals (path traversal, three directory-creation failures, an invalid URL) are still silent, also pre-existing. **Test case:** `playSoundFile{name = "a.wav", key = "k1"}`, `pauseSounds()`, then `playSoundFile{name = "b.wav", key = "k2"}` - b.wav plays and exactly one `sysMediaFinished` arrives, naming a.wav and k1. Seven new specs in `Media_spec.lua` (six of them fail against `origin/development`) and one new case in `TMediaLoopTest` cover this, pause-then-play for music, a refused-on-priority request, re-entrant `play()`, `loops = 2`, and both failure contracts. Assisted-by: Claude:claude-opus-5 --- src/TLuaInterpreterMedia.cpp | 8 +- src/TMedia.cpp | 106 ++++++++++- src/TMedia.h | 28 ++- src/ctelnet.cpp | 2 +- src/ctelnet.h | 3 +- src/dlgProfilePreferences.cpp | 10 +- src/mudlet-lua/tests/Media_spec.lua | 213 ++++++++++++++++++++++- test/functional_tests/TMediaLoopTest.cpp | 29 +++ 8 files changed, 380 insertions(+), 19 deletions(-) diff --git a/src/TLuaInterpreterMedia.cpp b/src/TLuaInterpreterMedia.cpp index 204bad28e..a7cc0bca8 100644 --- a/src/TLuaInterpreterMedia.cpp +++ b/src/TLuaInterpreterMedia.cpp @@ -2706,6 +2706,12 @@ int TLuaInterpreter::pauseVideos(lua_State* L) int TLuaInterpreter::purgeMediaCache(lua_State* L) { Host& host = getHostFromLua(L); - lua_pushboolean(L, host.mTelnet.purgeMediaCache()); + const auto [purged, message] = host.mTelnet.purgeMediaCache(); + + if (!purged) { + return warnArgumentValue(L, __func__, message); + } + + lua_pushboolean(L, true); return 1; } diff --git a/src/TMedia.cpp b/src/TMedia.cpp index a11d4ff32..037f72061 100644 --- a/src/TMedia.cpp +++ b/src/TMedia.cpp @@ -36,6 +36,37 @@ #include <QStandardPaths> #include <QTimer> +namespace { +// Holds TMediaPlayer::reservedForPlay() for as long as a play() call is setting that player up, +// however that call returns. +class MediaPlayerReservation +{ +public: + MediaPlayerReservation() = default; + ~MediaPlayerReservation() + { + if (mPlayer) { + mPlayer->setReservedForPlay(false); + } + } + Q_DISABLE_COPY(MediaPlayerReservation) + + void reserve(const std::shared_ptr<TMediaPlayer>& player) + { + if (mPlayer) { + mPlayer->setReservedForPlay(false); + } + mPlayer = player; + if (mPlayer) { + mPlayer->setReservedForPlay(true); + } + } + +private: + std::shared_ptr<TMediaPlayer> mPlayer; +}; +} // namespace + // Public TMedia::TMedia(Host* pHost, const QString& profileName) { @@ -416,24 +447,24 @@ void TMedia::parseGMCP(QString& packageMessage, QString& gmcp) } // Documentation: https://wiki.mudlet.org/w/Manual:Miscellaneous_Functions#purgeMediaCache -bool TMedia::purgeMediaCache() +std::pair<bool, QString> TMedia::purgeMediaCache() { const QString mediaPath = mudlet::getMudletPath(enums::profileMediaPath, mpHost->getName()); QDir mediaDir(mediaPath); if (!mediaDir.mkpath(mediaPath)) { - qWarning() << qsl("TMedia::purgeMediaCache() WARNING - not able to reference directory: %1").arg(mudlet::getMudletPath(enums::profileMediaPath, mpHost->getName())); - return false; + qWarning() << qsl("TMedia::purgeMediaCache() WARNING - not able to reference directory: %1").arg(mediaPath); + return {false, qsl("could not access the media directory \"%1\"").arg(mediaPath)}; } stopAllMediaPlayers(); if (!mediaDir.removeRecursively()) { qWarning() << qsl("TMedia::purgeMediaCache() WARNING - not able to remove all of directory: %1").arg(mediaPath); - return false; + return {false, qsl("removed what could be removed, but not all of the media directory \"%1\" - some files may be in use or write protected").arg(mediaPath)}; } - return true; + return {true, QString()}; } void TMedia::refreshAudioDevices() @@ -1130,6 +1161,17 @@ void TMedia::downloadFile(TMediaData& mediaData) const QString scheme = fileUrl.scheme(); if (scheme != qsl("http") && scheme != qsl("https")) { qWarning() << qsl("TMedia::downloadFile() WARNING - refused to download media from a non-HTTP(S) URL: %1").arg(fileUrl.toString()); + + // Told the same way a download that fails is, so a script waiting on this media learns + // the request is over rather than waiting on it forever. + TEvent event{}; + event.mArgumentList << qsl("sysDownloadError"); + event.mArgumentTypeList << ARGUMENT_TYPE_STRING; + event.mArgumentList << qsl("Media can only be downloaded from an http:// or https:// URL, not \"%1\"").arg(fileUrl.toString()); + event.mArgumentTypeList << ARGUMENT_TYPE_STRING; + event.mArgumentList << mediaData.mediaAbsolutePathFileName(); + event.mArgumentTypeList << ARGUMENT_TYPE_STRING; + mpHost->raiseEvent(event); return; } @@ -1430,8 +1472,11 @@ std::shared_ptr<TMediaPlayer> TMedia::getMediaPlayer(TMediaData& mediaData) continue; } + if (existingPlayer->reservedForPlay()) { + continue; // Another play() call is setting this one up + } + if (existingPlayer->getPlaybackState() != QMediaPlayer::PlayingState && existingPlayer->mediaPlayer()->mediaStatus() != QMediaPlayer::LoadingMedia) { - existingPlayer->setMediaData(mediaData); return existingPlayer; // Reuse existing player } } @@ -1470,7 +1515,6 @@ std::shared_ptr<TMediaPlayer> TMedia::getMediaPlayer(TMediaData& mediaData) return nullptr; } - newPlayer->setMediaData(mediaData); connectMediaPlayer(newPlayer); mediaPlayerList.append(newPlayer); @@ -1645,6 +1689,40 @@ void TMedia::releaseMediaSourceAfterEvents(const std::shared_ptr<TMediaPlayer>& }); } +// Hands a player over to a track that is about to start on it. Call only once the request is +// certain to go ahead - a request that is then refused must not have ended anything. +void TMedia::claimPlayerFor(const std::shared_ptr<TMediaPlayer>& player, TMediaData& mediaData, const QUrl& mediaSource) +{ + // In this order: the ending is reported under the key and tag the player still carries for + // the track that ended, and its source is released before claimSource() bumps the generation + // that any release still pending on this player is judged against. + endDisplacedPlayback(player); + player->setMediaData(mediaData); + player->claimSource(mediaSource); +} + +// Ends whatever playback the player is still holding, so the track taking it over starts from a +// player with nothing loaded. A paused one is what makes this necessary: it keeps its source, and +// handing setSource() a player that is not stopped stops it - which would otherwise be reported +// as the new track ending, under the new track's key and tag, and could clear its source a turn +// later. +void TMedia::endDisplacedPlayback(const std::shared_ptr<TMediaPlayer>& player) +{ + if (!player || !player->mediaPlayer() || player->mediaPlayer()->source().isEmpty()) { + return; + } + + // Read before the source goes, because releasing is what makes it unreadable. + const TMediaData endedData = player->mediaData(); + const QUrl endedUrl = player->mediaPlayer()->source(); + + player->mediaPlayer()->stop(); + player->releaseSource(); + + // Skipped when the stop above already announced it - see endAnnounced(). + raiseMediaFinishedEvent(player, endedUrl, endedData); +} + void TMedia::handlePlayerPlaybackStateChanged(QMediaPlayerPlaybackState playbackState, const std::shared_ptr<TMediaPlayer>& player) { if (!player) { @@ -1652,6 +1730,11 @@ void TMedia::handlePlayerPlaybackStateChanged(QMediaPlayerPlaybackState playback } if (playbackState == QMediaPlayer::StoppedState) { + if (player->claimingSource()) { + qDebug() << "TMedia::handlePlayerPlaybackStateChanged() - stopped a player that is being handed a new source; the playback it stopped was ended by whoever handed it over."; + return; + } + if (!player->mediaPlayer() || player->mediaPlayer()->source().isEmpty()) { // Whoever released the source already ended this playback and raised its event. A // second one from here would carry an empty file name and path, because the URL @@ -1836,6 +1919,7 @@ void TMedia::play(TMediaData& mediaData) } std::shared_ptr<TMediaPlayer> pPlayer; + MediaPlayerReservation reservation; // Only match an existing media player for music and video if (mediaData.mediaType() == TMediaData::MediaTypeMusic || mediaData.mediaType() == TMediaData::MediaTypeVideo) { @@ -1859,6 +1943,10 @@ void TMedia::play(TMediaData& mediaData) return; } + // The stops below raise sysMediaFinished into script handlers synchronously - see + // TMediaPlayer::reservedForPlay(). + reservation.reserve(pPlayer); + // Ensure the player has a valid playlist TMediaPlaylist* playlist = pPlayer->playlist(); @@ -1901,7 +1989,7 @@ void TMedia::play(TMediaData& mediaData) } const QUrl mediaSource = mediaData.mediaInput() == TMediaData::MediaInputFile ? QUrl::fromLocalFile(absolutePathFileName) : QUrl(absolutePathFileName); - pPlayer->claimSource(mediaSource); + claimPlayerFor(pPlayer, mediaData, mediaSource); } else { if (mediaData.mediaLoops() == TMediaData::MediaLoopsRepeat) { // Repeat indefinitely playlist->setPlaybackMode(TMediaPlaylist::Loop); @@ -1967,7 +2055,7 @@ void TMedia::play(TMediaData& mediaData) playlist->setCurrentIndex(0); pPlayer->setPlaylist(playlist); - pPlayer->claimSource(playlist->currentMedia()); + claimPlayerFor(pPlayer, mediaData, playlist->currentMedia()); } // Set volume and start position diff --git a/src/TMedia.h b/src/TMedia.h index 6a7212550..9fb74c062 100644 --- a/src/TMedia.h +++ b/src/TMedia.h @@ -32,6 +32,7 @@ #include "TMediaPlaylist.h" #include <memory> +#include <utility> #include <QAudioOutput> #include <QMediaPlayer> #include <QUrl> @@ -86,15 +87,22 @@ public: if (mMediaPlayer->playbackState() == QMediaPlayer::StoppedState && !mMediaPlayer->source().isEmpty()) { releaseSource(); } + mClaimingSource = true; mMediaPlayer->setSource(media); + mClaimingSource = false; } } void continuePlaying(const QUrl& media) { ++mContinuationGeneration; - mEndAnnounced = false; if (mMediaPlayer) { mMediaPlayer->setSource(media); + // Cleared after the source is installed, not before. On a backend that delivers + // EndOfMedia while the player is still playing this setSource() is a real + // playing-to-stopped transition, and its handler announces the pass that just ended. + // Clearing first leaves that announcement standing for the pass about to start, and + // the last pass has no continuation left to clear it again. + mEndAnnounced = false; mMediaPlayer->play(); } } @@ -119,6 +127,18 @@ public: bool endAnnounced() const { return mEndAnnounced; } void noteEndAnnounced() { mEndAnnounced = true; } + // True only while claimSource() is installing a new source. A stop delivered during that is + // the previous track being displaced rather than this one ending, and whoever displaced it + // has already said so - with the metadata the player no longer holds. + bool claimingSource() const { return mClaimingSource; } + + // A play() call owns the player it is setting up until it returns, because the events it + // raises run script handlers synchronously. A handler that starts media of its own must be + // given a different player: two play() calls sharing one overwrite each other's playlist and + // media data. + bool reservedForPlay() const { return mReservedForPlay; } + void setReservedForPlay(const bool reserved) { mReservedForPlay = reserved; } + // Read-only uses and playback control are fine; do not setSource() on it, for the reason // given above claimSource(). QMediaPlayer* mediaPlayer() const { return mMediaPlayer.get(); } @@ -179,6 +199,8 @@ private: quint64 mClaimGeneration = 0; quint64 mContinuationGeneration = 0; bool mEndAnnounced = false; + bool mClaimingSource = false; + bool mReservedForPlay = false; }; class TMedia : public QObject @@ -204,7 +226,7 @@ public: void pauseMedia(TMediaData& mediaData); void stopMedia(TMediaData& mediaData); void parseGMCP(QString& packageMessage, QString& gmcp); - bool purgeMediaCache(); + std::pair<bool, QString> purgeMediaCache(); void refreshAudioDevices(); void muteMedia(const TMediaData::MediaProtocol mediaProtocol); void unmuteMedia(const TMediaData::MediaProtocol mediaProtocol); @@ -268,6 +290,8 @@ private: // endedUrl and endedData are passed in rather than read off the player, so a caller that has // already released the source can still say what it was that ended. void raiseMediaFinishedEvent(const std::shared_ptr<TMediaPlayer>& player, const QUrl& endedUrl, const TMediaData& endedData); + void claimPlayerFor(const std::shared_ptr<TMediaPlayer>& player, TMediaData& mediaData, const QUrl& mediaSource); + void endDisplacedPlayback(const std::shared_ptr<TMediaPlayer>& player); void releaseMediaSourceAfterEvents(const std::shared_ptr<TMediaPlayer>& player, const TMediaData& endedData, const PlaybackEnd endedBy); void handlePlayerPlaybackStateChanged(QMediaPlayerPlaybackState playbackState, const std::shared_ptr<TMediaPlayer>& player); bool setupVideo(const std::shared_ptr<TMediaPlayer>& player); diff --git a/src/ctelnet.cpp b/src/ctelnet.cpp index e56c62687..2fb66f0b2 100644 --- a/src/ctelnet.cpp +++ b/src/ctelnet.cpp @@ -4337,7 +4337,7 @@ void cTelnet::slot_tlsUpgradeResponse(const bool accepted) } #endif -bool cTelnet::purgeMediaCache() +std::pair<bool, QString> cTelnet::purgeMediaCache() { return mpHost->mpMedia->purgeMediaCache(); } diff --git a/src/ctelnet.h b/src/ctelnet.h index 32d3c52eb..48a8b4e27 100644 --- a/src/ctelnet.h +++ b/src/ctelnet.h @@ -52,6 +52,7 @@ #include <iostream> #include <queue> #include <string> +#include <utility> #if defined(Q_OS_WINDOWS) #include <ws2tcpip.h> @@ -192,7 +193,7 @@ public: void setMSSPVariables(const QByteArray&); void setMSPVariables(const QByteArray&); bool isIPAddress(const QString&); - bool purgeMediaCache(); + std::pair<bool, QString> purgeMediaCache(); void atcpComposerCancel(); void atcpComposerSave(QString); void checkNAWS(); diff --git a/src/dlgProfilePreferences.cpp b/src/dlgProfilePreferences.cpp index 8a9a26a09..a9eaaea21 100644 --- a/src/dlgProfilePreferences.cpp +++ b/src/dlgProfilePreferences.cpp @@ -1346,7 +1346,7 @@ void dlgProfilePreferences::initWithHost(Host* pHost) break; default: { } // There are a significant number of other errors - // that are not handled here! + // that are not handled here! } } } @@ -2100,9 +2100,11 @@ void dlgProfilePreferences::slot_purgeMediaCache() return; } - if (!pHost->mpMedia->purgeMediaCache()) { - //: Shown after the "Clear stored media" button in preferences fails to empty the profile's media directory. - pHost->postMessage(tr("[ WARN ] - Could not clear all of the stored media; some files may still be in use.")); + const auto [purged, message] = pHost->mpMedia->purgeMediaCache(); + + if (!purged) { + //: Shown after the "Clear stored media" button in preferences fails to empty the profile's media directory. %1 is the reason, which is not translated. + pHost->postMessage(tr("[ WARN ] - Could not clear the stored media: %1.").arg(message)); return; } diff --git a/src/mudlet-lua/tests/Media_spec.lua b/src/mudlet-lua/tests/Media_spec.lua index 8ad130f38..5986cf5b8 100644 --- a/src/mudlet-lua/tests/Media_spec.lua +++ b/src/mudlet-lua/tests/Media_spec.lua @@ -188,8 +188,10 @@ describe("Media playback effects with a generated sound file", function() -- own, and a long one for the specs that have to still be playing when they -- stop or pause it, so a slow runner cannot turn a natural finish into a -- spurious failure. + -- A second long file so a spec can tell one playback from another by name. local soundFile = "busted-media-tone.wav" local longSoundFile = "busted-media-hold.wav" + local otherLongSoundFile = "busted-media-hold-other.wav" local mediaDirectory = getMudletHomeDir() .. "/media" local playbackObserved @@ -224,6 +226,7 @@ describe("Media playback effects with a generated sound file", function() local function writeSoundFiles() writeMediaFile(soundFile, 150) writeMediaFile(longSoundFile, 10000) + writeMediaFile(otherLongSoundFile, 10000) end -- purgeMediaCache() empties the whole media directory, not just the fixtures @@ -234,7 +237,7 @@ describe("Media playback effects with a generated sound file", function() local stash = getMudletHomeDir() .. "/busted-media-stash" local preserved = {} for entry in lfs.dir(mediaDirectory) do - if entry ~= "." and entry ~= ".." and entry ~= soundFile and entry ~= longSoundFile then + if entry ~= "." and entry ~= ".." and entry ~= soundFile and entry ~= longSoundFile and entry ~= otherLongSoundFile then preserved[#preserved + 1] = entry end end @@ -265,6 +268,17 @@ describe("Media playback effects with a generated sound file", function() finally(function() killAnonymousEventHandler(handler) end) end + -- Waits until collected holds count entries. A media event can be raised + -- inside the call that caused it, so waiting has to start with a look. + local function waitForCount(eventName, collected, count) + for _ = 1, 5 do + if #collected >= count then + return + end + waitForEvent(eventName, 1000) + end + end + -- The media events carry QUrl::path(), which puts a slash in front of a -- drive-lettered Windows path ("/C:/..."). Take that back off so one -- expected value works on every platform. @@ -290,6 +304,7 @@ describe("Media playback effects with a generated sound file", function() if not playbackObserved then os.remove(mediaDirectory .. "/" .. soundFile) os.remove(mediaDirectory .. "/" .. longSoundFile) + os.remove(mediaDirectory .. "/" .. otherLongSoundFile) end end if playbackObserved then @@ -416,6 +431,153 @@ describe("Media playback effects with a generated sound file", function() assert.equals(0, #getPausedSounds()) end) + it("playing a different sound while one is paused ends the paused one and starts the new one", function() + if mediaPlaybackUnavailable() then + return + end + local finished, started = {}, {} + collect("sysMediaFinished", finished) + collect("sysMediaStarted", started) + + writeSoundFiles() + assert.is_true(playSoundFile({name = longSoundFile, key = "busted-parked", tag = "busted-parked-tag"})) + waitForCount("sysMediaStarted", started, 1) + assert.is_true(pauseSounds()) + assert.equals(1, #getPausedSounds()) + + assert.is_true(playSoundFile({name = otherLongSoundFile, key = "busted-replacement"})) + + assert.equals(1, #finished) + assert.equals(longSoundFile, finished[1].file) + assert.equals("busted-parked", finished[1].key) + assert.equals("busted-parked-tag", finished[1].tag) + + waitForCount("sysMediaStarted", started, 2) + assert.equals(2, #started) + assert.equals(otherLongSoundFile, started[2].file) + local playing = getPlayingSounds() + assert.equals(1, #playing) + assert.equals(otherLongSoundFile, playing[1].name) + assert.equals(0, #getPausedSounds()) + end) + + it("playing different music while some is paused ends the paused track", function() + if mediaPlaybackUnavailable() then + return + end + local finished, started = {}, {} + collect("sysMediaFinished", finished) + collect("sysMediaStarted", started) + + writeSoundFiles() + assert.is_true(playMusicFile({name = longSoundFile, key = "busted-music-parked", tag = "busted-music-parked-tag"})) + waitForCount("sysMediaStarted", started, 1) + assert.is_true(pauseMusic()) + assert.equals(1, #getPausedMusic()) + + assert.is_true(playMusicFile({name = otherLongSoundFile, key = "busted-music-new"})) + + assert.equals(1, #finished) + assert.equals(longSoundFile, finished[1].file) + assert.equals("busted-music-parked", finished[1].key) + assert.equals("busted-music-parked-tag", finished[1].tag) + + waitForCount("sysMediaStarted", started, 2) + local music = getPlayingMusic() + assert.equals(1, #music) + assert.equals(otherLongSoundFile, music[1].name) + assert.equals(0, #getPausedMusic()) + end) + + it("a request refused on priority leaves the paused sound it would have taken over", function() + if mediaPlaybackUnavailable() then + return + end + local finished, started = {}, {} + collect("sysMediaFinished", finished) + collect("sysMediaStarted", started) + + writeSoundFiles() + -- first, because a priority of its own would stop every sound that has none + assert.is_true(playSoundFile({name = otherLongSoundFile, key = "busted-priority-loud", priority = 90})) + waitForCount("sysMediaStarted", started, 1) + assert.is_true(playSoundFile({name = longSoundFile, key = "busted-priority-parked"})) + waitForCount("sysMediaStarted", started, 2) + assert.is_true(pauseSounds({key = "busted-priority-parked"})) + assert.equals(1, #getPausedSounds()) + assert.equals(1, #getPlayingSounds()) + + -- refused, since the sound already playing is louder - and a paused player + -- is what a request is handed before anything else in the pool + assert.is_true(playSoundFile({name = soundFile, key = "busted-priority-refused", priority = 10})) + + assert.equals(0, #getPlayingSounds({key = "busted-priority-refused"})) + assert.equals(0, #finished) + local paused = getPausedSounds() + assert.equals(1, #paused) + assert.equals(longSoundFile, paused[1].name) + assert.equals("busted-priority-parked", paused[1].key) + end) + + it("a finite loop count plays every pass and reports each one", function() + if mediaPlaybackUnavailable() then + return + end + local finished, started = {}, {} + collect("sysMediaFinished", finished) + collect("sysMediaStarted", started) + + writeSoundFiles() + assert.is_true(playSoundFile({name = soundFile, key = "busted-looped", tag = "busted-looped-tag", loops = 2})) + waitForCount("sysMediaFinished", finished, 2) + + assert.equals(2, #started) + assert.equals(2, #finished) + for _, pass in ipairs(finished) do + assert.equals(soundFile, pass.file) + assert.equals("busted-looped", pass.key) + assert.equals("busted-looped-tag", pass.tag) + end + assert.equals(0, #getPlayingSounds()) + end) + + it("a sysMediaFinished handler that starts a sound leaves the caller's own request playing", function() + if mediaPlaybackUnavailable() then + return + end + writeSoundFiles() + + -- A player joins the pool only once the play() that made it has returned, + -- so warming several up - each started while the one before it is playing - + -- is what puts the re-entrant call in reach of the one being set up below. + local warmed = {} + collect("sysMediaStarted", warmed) + for index, key in ipairs({"busted-warm-one", "busted-warm-two", "busted-warm-three"}) do + assert.is_true(playSoundFile({name = longSoundFile, key = key})) + waitForCount("sysMediaStarted", warmed, index) + end + assert.equals(3, #getPlayingSounds()) + assert.is_true(stopSounds()) + + local reentered = 0 + local handler = registerAnonymousEventHandler("sysMediaFinished", function() + reentered = reentered + 1 + playSoundFile({name = otherLongSoundFile, key = "busted-handler-sound"}) + end) + finally(function() killAnonymousEventHandler(handler) end) + + assert.is_true(playSoundFile({name = longSoundFile, key = "busted-quiet", priority = 10})) + -- stops the sound above while it is still loading, which raises + -- sysMediaFinished into the handler from inside this very call + assert.is_true(playSoundFile({name = longSoundFile, key = "busted-loud", priority = 90, loops = 3})) + + assert.is_true(reentered > 0, "the priority stop raised no sysMediaFinished, so nothing re-entered") + local loud = getPlayingSounds({key = "busted-loud"}) + assert.equals(1, #loud) + assert.equals(longSoundFile, loud[1].name) + assert.is_true(#getPlayingSounds({key = "busted-handler-sound"}) > 0) + end) + it("the key filter picks out which sound is listed and stopped", function() if mediaPlaybackUnavailable() then return @@ -503,6 +665,55 @@ describe("Media playback effects with a generated sound file", function() assert.equals(0, #getPlayingSounds()) assert.is_nil(lfs.attributes(soundPath, "mode")) end) + + it("purgeMediaCache returns nil and a message when it cannot empty the directory", function() + if getOS() == "windows" then + pending("staging an undeletable file needs chmod") + return + end + writeSoundFiles() + preserveMediaDirectory() + + local lockedDirectory = mediaDirectory .. "/busted-media-locked" + lfs.mkdir(lockedDirectory) + local pinnedFile = lockedDirectory .. "/busted-media-pinned.wav" + local handle = io.open(pinnedFile, "wb") + assert.is_not_nil(handle, "could not write the pinned media fixture") + handle:write("pinned") + handle:close() + os.execute("chmod 500 '" .. lockedDirectory .. "'") + finally(function() + os.execute("chmod 700 '" .. lockedDirectory .. "'") + os.remove(pinnedFile) + lfs.rmdir(lockedDirectory) + end) + + if os.remove(pinnedFile) then + pending("this user can delete files out of a directory it cannot write") + return + end + + local ok, err = purgeMediaCache() + assert.is_nil(ok) + assert.is_true(contains(err, mediaDirectory), tostring(err)) + -- a purge that half happened, not one that did not happen + assert.is_nil(lfs.attributes(mediaDirectory .. "/" .. soundFile, "mode")) + end) + + it("a media url that is not http(s) reports a download error", function() + local errors = {} + local handler = registerAnonymousEventHandler("sysDownloadError", function(_, message, path) + errors[#errors + 1] = {message = message, path = path} + end) + finally(function() killAnonymousEventHandler(handler) end) + + -- a file the media directory does not have, so the url is the only way to get it + assert.is_true(playSoundFile({name = "busted-media-absent-scheme.wav", url = "ftp://example.invalid/sounds"})) + waitForCount("sysDownloadError", errors, 1) + assert.equals(1, #errors) + assert.is_true(contains(errors[1].message, "http"), tostring(errors[1].message)) + assert.is_true(contains(errors[1].path, "busted-media-absent-scheme.wav"), tostring(errors[1].path)) + end) end) describe("receiveMSP reports MSP is not enabled while offline", function() diff --git a/test/functional_tests/TMediaLoopTest.cpp b/test/functional_tests/TMediaLoopTest.cpp index e8a02d8f1..d9a34c5a9 100644 --- a/test/functional_tests/TMediaLoopTest.cpp +++ b/test/functional_tests/TMediaLoopTest.cpp @@ -196,6 +196,35 @@ private slots: QVERIFY2(cleanedUp, "A loops=3 track never finished and released its source - the deferred cleanup did not take over from the last pass."); } + // Staged rather than played: only a backend that delivers EndOfMedia before StoppedState + // announces a pass from inside continuePlaying()'s setSource(), and no runner this suite has + // does. sourceChanged stands in for that announcement, being emitted from inside the same + // setSource() call. + void test_continuingToTheNextPassClearsTheEarlierAnnouncement() + { + const QString path = qsl("%1/pass.wav").arg(mProbeDir.path()); + QFile file(path); + QVERIFY(file.open(QIODevice::WriteOnly)); + file.write(wavBytes()); + file.close(); + + TMediaData data{}; + TMediaPlayer player(nullptr, data); + QVERIFY(player.isInitialized()); + + bool announcedFromInsideSetSource = false; + connect(player.mediaPlayer(), &QMediaPlayer::sourceChanged, player.mediaPlayer(), [&](const QUrl&) { + player.noteEndAnnounced(); + announcedFromInsideSetSource = true; + }); + + player.continuePlaying(QUrl::fromLocalFile(path)); + player.mediaPlayer()->stop(); + + QVERIFY2(announcedFromInsideSetSource, "setSource() emitted nothing synchronously, so the ordering this test is about was never staged."); + QVERIFY2(!player.endAnnounced(), "The new pass started already counted as announced, so its own ending would be swallowed as a duplicate."); + } + // The deferred cleanup must still fire for a genuinely finished track, otherwise the // media source release added by #9237 is lost. Releasing the source is what this asserts // on because playingMedia() has already dropped the player by the time the cleanup runs. From 963b035ab41b3aa4c8fcb5dbe6abf1f06ac61074 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Fri, 7 Aug 2026 06:23:06 +0200 Subject: [PATCH 115/155] fix: four security holes in the new browser sign-in (#9713) #### Brief overview of PR changes/additions Four security fixes to the GMCP `Char.Login` v2 browser sign-in added in #9378 *Add: sign in to supported games using your browser (e.g. Google, Discord, or the game's own account)*, found by the 5.0 QA sweep and reproduced on the wire. The game server is untrusted throughout: Mudlet connects to arbitrary user-specified MUDs. - **A saved sign-in no longer goes out in the clear.** `Char.Login.Reconnect` carries a bearer token that signs into the player's account without their password, and Mudlet replayed it on whatever transport was live at the time - so a sign-in earned over TLS went out over plain telnet on the next connect. It is now refused on a cleartext transport, mirroring the `Char.Login.AuthCode` guard already in the same file; the player is told why and the sign-in falls back to the provider resume or the game's own sign-in screen. - **A server can no longer open browser tabs at will.** The client-driven OAuth path reached `QDesktopServices::openUrl()` with a server-chosen address and no guard at all, once per frame the server sent (5 frames measured, 5 tabs). Both flows now go through one decision point with a budget of one automatic hand-off per connection, refilled whenever the player sends something to the game. The client-driven flow still opens the browser on connect - that is the sign-in the player came for - but a burst of frames buys one tab, not a tab each, and `Char.Login.URL`, which a server may push at any moment, still needs actual input first. - **The OIDC nonce reaches the game, and a `Char.Login.Default` flood no longer buys credential-store churn.** With `"nonce": true` Mudlet generated a nonce and put it in the authorization URL but never sent it on, so the party that actually validates the ID token could not check its `nonce` claim; it now rides in `Char.Login.AuthCode`. Separately each `Char.Login.Default` frame started a fresh credential-store read (a 114 KB flood measured 4002 reads); sign-in attempts are now throttled to one per second, and dropped outright if the connection that scheduled them has gone. #### Motivation for adding to Mudlet All four are new in 5.0 and none was covered by a test, which is why they shipped. The token replay is the serious one: it hands a password-equivalent account credential to anyone on the path. Two decisions worth a second opinion: - The Char.Login 2 draft on Area 51 defines no `nonce` field in `Char.Login.AuthCode`, so this adds one. Without it `"nonce": true` cannot mean anything - nobody is in a position to verify the value. **The spec needs the field added to match.** - The same draft explicitly permits sending the reconnect token over plain telnet ("a server may choose to issue and accept tokens only over `telnets://`"). It does not require a client to, so refusing is conformant, but it is deliberately stricter than the spec. #### Other info (issues closed, discussion etc) Test case: connect a profile with a saved sign-in to a game offering `Char.Login 2` over plain telnet - Mudlet says the connection is not encrypted and hands off to the game's own sign-in screen instead of replaying the token. `GMCPCharLoginTest` gains a TLS-capable stub (embedded self-signed loopback certificate) and a loopback OpenID discovery stub, so the encrypted-transport and client-driven paths are exercised for real rather than assumed. The seven existing token tests move onto it, which is itself the proof that they were previously passing over cleartext. 80/80 `ctest` green. Assisted-by: Claude:claude-opus-5 --- src/GMCPAuthenticator.cpp | 157 ++++++-- src/GMCPAuthenticator.h | 31 +- src/Host.h | 4 +- src/OAuthClientFlow.cpp | 16 +- src/OAuthClientFlow.h | 15 +- test/OAuthClientFlowTest.cpp | 51 ++- test/functional_tests/CMakeLists.txt | 2 +- test/functional_tests/GMCPCharLoginTest.cpp | 413 ++++++++++++++++++-- 8 files changed, 570 insertions(+), 119 deletions(-) diff --git a/src/GMCPAuthenticator.cpp b/src/GMCPAuthenticator.cpp index 8bc97635c..63562781d 100644 --- a/src/GMCPAuthenticator.cpp +++ b/src/GMCPAuthenticator.cpp @@ -70,6 +70,25 @@ GMCPAuthenticator::GMCPAuthenticator(Host* pHost) : mpHost(pHost) { resetPerConnectionState(); + // mTelnet is declared before this authenticator in Host, so it is already constructed here. + QObject::connect(&pHost->mTelnet, &cTelnet::signal_connected, pHost, [this]() { + resetForNewConnection(); + }); + QObject::connect(&pHost->mTelnet, &cTelnet::signal_disconnected, pHost, [this]() { + resetForNewConnection(); + }); +} + +void GMCPAuthenticator::resetForNewConnection() +{ + // Anything still in flight belongs to the connection that started it: a deferred attempt would + // cancel the new connection's login timers and sign in with capabilities the new server never + // advertised, and a credential read landing there would replay a token nobody asked for. + ++mSignInScheduleGeneration; + ++mAuthAttemptGeneration; + mSignInAttemptPending = false; + mLastSignInAttempt.invalidate(); + mUnpromptedBrowserOpenAvailable = true; } void GMCPAuthenticator::resetPerConnectionState() @@ -224,8 +243,19 @@ void GMCPAuthenticator::sendCredentials(bool interactiveHandoff) #endif } -void GMCPAuthenticator::sendReconnect(const QString& account, QString token) +bool GMCPAuthenticator::sendReconnect(const QString& account, QString token) { + // The token signs in to the account without the player's password, and is replayed on whatever + // transport is live now rather than the one it was earned on: in the clear that hands the account + // to anyone on the path. + if (!mpHost->mTelnet.currentlySecure()) { + SecureStringUtils::secureStringClear(token); + qWarning().noquote() << "GMCP Char.Login.Reconnect - refusing to replay the saved sign-in token over an unencrypted connection."; + //: Shown when a saved password-less sign-in cannot be reused because this connection to the game is not encrypted. + mpHost->postMessage(tr("[ WARN ] - Not using your saved sign-in because this connection is not encrypted; please sign in again.")); + return false; + } + QJsonObject payload; payload[qsl("account")] = account; payload[qsl("token")] = token; @@ -263,6 +293,7 @@ void GMCPAuthenticator::sendReconnect(const QString& account, QString token) #if defined(DEBUG_GMCP_AUTHENTICATION) qDebug() << "Sent GMCP reconnect for account:" << account; #endif + return true; } void GMCPAuthenticator::storeReconnectToken(const QString& account, QString token) @@ -421,26 +452,34 @@ void GMCPAuthenticator::handleAuthUrl(const QString& packageMessage, const QStri return; } - // This message can arrive unsolicited, so only auto-open the browser when the player has sent input - // this connection (evidence they acted on the game's sign-in screen); otherwise offer the link to - // open deliberately, so a misbehaving server cannot pop a browser at an idle player. - if (mpHost->userSentInputThisConnection()) { - openSignInUrl(parsedUrl, provider); + // Char.Login.URL can arrive at any moment in a session, so it only auto-opens against user input. + offerOrOpenSignInUrl(parsedUrl, provider, false); +} + +void GMCPAuthenticator::offerOrOpenSignInUrl(const QUrl& url, const QString& provider, bool answersTheGamesSignInOffer) +{ + const bool mayOpen = mpHost->userSentInputThisConnection() || (answersTheGamesSignInOffer && mUnpromptedBrowserOpenAvailable); + if (mayOpen) { + if (openSignInUrl(url, provider)) { + mUnpromptedBrowserOpenAvailable = false; + mpHost->setUserSentInputThisConnection(false); + } return; } //: %1 is the sign-in web address the user should open in their browser to sign in. - mpHost->postMessage(tr("[ INFO ] - To sign in, open this link in your browser: %1").arg(url)); + mpHost->postMessage(tr("[ INFO ] - To sign in, open this link in your browser: %1").arg(url.toString())); } -void GMCPAuthenticator::openSignInUrl(const QUrl& url, const QString& provider) +bool GMCPAuthenticator::openSignInUrl(const QUrl& url, const QString& provider) { if (!QDesktopServices::openUrl(url)) { //: %1 is the sign-in web address the user should open manually in their browser. mpHost->postMessage(tr("[ WARN ] - Could not open your browser. Open this link manually to sign in: %1").arg(url.toString())); - return; + return false; } announceBrowserHandoff(provider); + return true; } void GMCPAuthenticator::announceBrowserHandoff(const QString& provider) @@ -465,15 +504,12 @@ void GMCPAuthenticator::startClientDrivenOAuth() // Parented to the Host so the flow (and its loopback listener) cannot outlive the profile. mpOAuthFlow = new OAuthClientFlow(mpHost); - QObject::connect(mpOAuthFlow, &OAuthClientFlow::authorizationCaptured, mpHost, [this](const QString& code, const QString& codeVerifier, const QString& redirectUri) { - sendAuthCode(code, codeVerifier, redirectUri); + QObject::connect(mpOAuthFlow, &OAuthClientFlow::authorizationCaptured, mpHost, [this](const QString& code, const QString& codeVerifier, const QString& redirectUri, const QString& nonce) { + sendAuthCode(code, codeVerifier, redirectUri, nonce); }); - QObject::connect(mpOAuthFlow, &OAuthClientFlow::browserOpened, mpHost, [this]() { - announceBrowserHandoff(QString()); - }); - QObject::connect(mpOAuthFlow, &OAuthClientFlow::browserOpenFailed, mpHost, [this](const QString& url) { - //: %1 is the sign-in web address the user should open manually in their browser. - mpHost->postMessage(tr("[ WARN ] - Could not open your browser. Open this link manually to sign in: %1").arg(url)); + // This flow only starts from the game's own sign-in offer, so connecting is itself the request. + QObject::connect(mpOAuthFlow, &OAuthClientFlow::authorizationUrlReady, mpHost, [this](const QUrl& authorizationUrl) { + offerOrOpenSignInUrl(authorizationUrl, QString(), true); }); QObject::connect(mpOAuthFlow, &OAuthClientFlow::flowFailed, mpHost, [this](const QString& logDetail) { qWarning().noquote() << "GMCP Char.Login client-driven OAuth failed:" << logDetail; @@ -494,7 +530,7 @@ void GMCPAuthenticator::cancelClientDrivenOAuth() } } -void GMCPAuthenticator::sendAuthCode(QString code, QString codeVerifier, const QString& redirectUri) +void GMCPAuthenticator::sendAuthCode(QString code, QString codeVerifier, const QString& redirectUri, QString nonce) { // The spec forbids Char.Login.AuthCode on a cleartext connection: the authorization code and PKCE // verifier together would let an eavesdropper redeem the code at the provider. The flow only starts @@ -502,6 +538,7 @@ void GMCPAuthenticator::sendAuthCode(QString code, QString codeVerifier, const Q if (!mpHost->mTelnet.currentlySecure()) { SecureStringUtils::secureStringClear(code); SecureStringUtils::secureStringClear(codeVerifier); + SecureStringUtils::secureStringClear(nonce); qWarning().noquote() << "GMCP Char.Login.AuthCode - refusing to send the authorization code over an unencrypted connection."; mpHost->mTelnet.setDontReconnect(true); // Tear down the in-flight flow and its loopback listener immediately: the sign-in is doomed, so @@ -516,6 +553,13 @@ void GMCPAuthenticator::sendAuthCode(QString code, QString codeVerifier, const Q payload[qsl("code")] = code; payload[qsl("code_verifier")] = codeVerifier; payload[qsl("redirect_uri")] = redirectUri; + // The server, not this client, receives and validates the ID token, so it is the only party that + // can check the nonce claim - and only against the value chosen here. + if (!nonce.isEmpty()) { + payload[qsl("nonce")] = nonce; + } else if (mOAuthNonceRequired) { + qWarning().noquote() << "GMCP Char.Login.AuthCode - the server asked for a nonce but none was generated, so it cannot verify the ID token's nonce claim."; + } payload[qsl("version")] = mNegotiatedVersion; QByteArray json = QJsonDocument(payload).toJson(QJsonDocument::Compact); QString gmcpMessage = QString::fromUtf8(json); @@ -543,6 +587,7 @@ void GMCPAuthenticator::sendAuthCode(QString code, QString codeVerifier, const Q // payloads, and the assembled telnet frame. SecureStringUtils::secureStringClear(code); SecureStringUtils::secureStringClear(codeVerifier); + SecureStringUtils::secureStringClear(nonce); SecureStringUtils::secureStringClear(gmcpMessage); SecureStringUtils::secureStdStringClear(plaintext); SecureStringUtils::secureStdStringClear(encoded); @@ -687,16 +732,21 @@ void GMCPAuthenticator::retryOrDropRejectedToken() #if defined(DEBUG_GMCP_AUTHENTICATION) qDebug() << "GMCP reconnect token was rotated by another instance; replaying the fresh token"; #endif - mConn.retriedRotatedToken = true; - mConn.sentReconnectTokenHash = storedHash; - mConn.reconnectingWithToken = true; - mConn.awaitingReconnectResult = true; - mConn.reconnectAccount = account; - // This attempt is replaying a live token rather than recovering from a dead - // one, so release the latch: the next Char.Login.Default is an ordinary - // sign-in again and may use a stored token. - mReconnectRejected = false; - sendReconnect(account, std::move(token)); + if (sendReconnect(account, std::move(token))) { + mConn.retriedRotatedToken = true; + mConn.sentReconnectTokenHash = storedHash; + mConn.reconnectingWithToken = true; + mConn.awaitingReconnectResult = true; + mConn.reconnectAccount = account; + // This attempt is replaying a live token rather than recovering from a dead + // one, so release the latch: the next Char.Login.Default is an ordinary + // sign-in again and may use a stored token. + mReconnectRejected = false; + return; + } + // The other instance's token is live, so leave the stored entry alone. The + // rejection latch stays armed: this connection cannot use a token at all. + selectAuthMethod(); return; } // Both branches above return, so reaching here means the stored token is not a @@ -775,7 +825,7 @@ void GMCPAuthenticator::handleAuthGMCP(const QString& packageMessage, const QStr // deciding how to authenticate. resetPerConnectionState(); - attemptReconnect(); + scheduleSignInAttempt(); return; } @@ -849,6 +899,34 @@ void GMCPAuthenticator::handleAuthToken(const QString& packageMessage, const QSt #endif } +void GMCPAuthenticator::scheduleSignInAttempt() +{ + if (mSignInAttemptPending) { +#if defined(DEBUG_GMCP_AUTHENTICATION) + qDebug() << "GMCP Char.Login.Default arrived while a sign-in attempt was already scheduled; folding it into that attempt"; +#endif + return; + } + if (!mLastSignInAttempt.isValid() || mLastSignInAttempt.durationElapsed() >= scmSignInAttemptInterval) { + mLastSignInAttempt.start(); + attemptReconnect(); + return; + } + + // Inside the throttle window: serve the whole burst with one attempt when it closes, using the + // capabilities the last frame left behind, and drop it if that connection has gone by then. + mSignInAttemptPending = true; + const auto scheduleGeneration = mSignInScheduleGeneration; + QTimer::singleShot(scmSignInAttemptInterval - mLastSignInAttempt.durationElapsed(), mpHost, [this, scheduleGeneration]() { + if (scheduleGeneration != mSignInScheduleGeneration) { + return; + } + mSignInAttemptPending = false; + mLastSignInAttempt.start(); + attemptReconnect(); + }); +} + void GMCPAuthenticator::attemptReconnect() { mpHost->mTelnet.cancelLoginTimers(); @@ -927,20 +1005,23 @@ void GMCPAuthenticator::readStoredSignIn(bool allowToken) mConn.accountProvider = provider; } if (allowToken && !account.isEmpty() && !token.isEmpty()) { - // This connection is logging in by replaying a saved token, so a Char.Login.Token - // that comes back is a silent rotation rather than a first-time save to announce. - mConn.reconnectingWithToken = true; - mConn.awaitingReconnectResult = true; - mConn.reconnectAccount = account; // Remember only a hash of what we send: if the reconnect is rejected, comparing it // against a fresh read tells a dead token apart from one another running instance // (sharing this profile's keychain) rotated while ours was in flight. QByteArray tokenBytes = token.toUtf8(); - mConn.sentReconnectTokenHash = QCryptographicHash::hash(tokenBytes, QCryptographicHash::Sha256); + const QByteArray sentHash = QCryptographicHash::hash(tokenBytes, QCryptographicHash::Sha256); SecureStringUtils::secureByteArrayClear(tokenBytes); - // Move the token in so sendReconnect owns the sole copy and can scrub it after sending. - sendReconnect(account, std::move(token)); - return; + // Move the token in so sendReconnect owns the sole copy and can scrub it either way. + if (sendReconnect(account, std::move(token))) { + // This connection is logging in by replaying a saved token, so a Char.Login.Token + // that comes back is a silent rotation rather than a first-time save to announce. + mConn.reconnectingWithToken = true; + mConn.awaitingReconnectResult = true; + mConn.reconnectAccount = account; + mConn.sentReconnectTokenHash = sentHash; + return; + } + // Not sent, so nothing awaits a result on it; fall through to resume or hand-off. } if (!account.isEmpty() && !provider.isEmpty()) { // No usable token, but we remember how this account signs in: ask the game to diff --git a/src/GMCPAuthenticator.h b/src/GMCPAuthenticator.h index 44cb16a5a..4a74578ff 100644 --- a/src/GMCPAuthenticator.h +++ b/src/GMCPAuthenticator.h @@ -23,6 +23,7 @@ #include "Host.h" #include "utils.h" +#include <QElapsedTimer> #include <QJsonArray> #include <QJsonDocument> #include <QJsonObject> @@ -30,6 +31,7 @@ #include <QString> #include <QVariantMap> +#include <chrono> #include <functional> class OAuthClientFlow; @@ -58,19 +60,28 @@ public: private: void handleAuthUrl(const QString& packageMessage, const QString& data); - void openSignInUrl(const QUrl& url, const QString& provider); + // The single place where a sign-in web address may reach the system browser, for both the + // server-driven (Char.Login.URL) and the client-driven flow. Auto-opens only against evidence that + // the player wants to sign in and consumes it, otherwise offers the address as a link. + // answersTheGamesSignInOffer marks an address reached from Char.Login.Default, where connecting is + // itself that evidence - once per connection. + void offerOrOpenSignInUrl(const QUrl& url, const QString& provider, bool answersTheGamesSignInOffer); + bool openSignInUrl(const QUrl& url, const QString& provider); void startClientDrivenOAuth(); void cancelClientDrivenOAuth(); void announceBrowserHandoff(const QString& provider); - void sendAuthCode(QString code, QString codeVerifier, const QString& redirectUri); + void sendAuthCode(QString code, QString codeVerifier, const QString& redirectUri, QString nonce); void selectAuthMethod(); + void scheduleSignInAttempt(); void attemptReconnect(); // Reads the stored sign-in entry ({account, provider?, token?}) and acts on it: replay the token // (when allowToken), else send the resume form for a remembered provider, else fall through to // selectAuthMethod(). allowToken is false on the connection straight after a rejection, so a // not-yet-rewritten entry cannot loop us back into another rejected reconnect. void readStoredSignIn(bool allowToken); - void sendReconnect(const QString& account, QString token); + // Returns false when it refused to send: the token is a bearer secret and never goes out over a + // cleartext transport. It is scrubbed either way, and only a true return means a result is awaited. + bool sendReconnect(const QString& account, QString token); // Sends the resume form of Char.Login.Credentials: {account, provider, version}, no password - // asking the game to restart the browser sign-in for the provider remembered from an earlier // Char.Login.URL. The absence of a password (not the presence of provider) is what distinguishes it. @@ -90,6 +101,8 @@ private: void storeResumeHint(const QString& account, const QString& provider); void discardReconnectToken(std::function<void(bool success)> callback = {}); void resetPerConnectionState(); + // Per socket connection, unlike resetPerConnectionState() which runs per Char.Login.Default. + void resetForNewConnection(); bool clientDrivenOAuthAvailable() const; @@ -165,6 +178,18 @@ private: // callback, so a result arriving after a newer connection began is discarded instead of driving a // sign-in on the wrong attempt. Not part of mConn: it must monotonically increase, never reset. unsigned int mAuthAttemptGeneration = 0; + + // A server can pack thousands of Char.Login.Default frames into one packet and every sign-in + // attempt reads the credential store. Throttling bounds that cost by wall clock rather than by how + // much the server sent, and unlike a hard per-connection cap never refuses a legitimate re-offer. + inline static constexpr std::chrono::milliseconds scmSignInAttemptInterval = std::chrono::seconds(1); + QElapsedTimer mLastSignInAttempt; + bool mSignInAttemptPending = false; + // Bumped whenever a connection begins or ends, so a deferred attempt from a previous one is dropped. + unsigned int mSignInScheduleGeneration = 0; + // One automatic browser hand-off per connection for an address reached from the game's sign-in + // offer, so a server cannot turn a burst of frames into a burst of tabs. + bool mUnpromptedBrowserOpenAvailable = true; }; #endif // MUDLET_AUTHENTICATOR_H diff --git a/src/Host.h b/src/Host.h index d5716f849..87c23393f 100644 --- a/src/Host.h +++ b/src/Host.h @@ -197,9 +197,11 @@ public: void setPass(const QString& password) { mPass = password; } bool hasAutoLoginCredentials() const { return !mLogin.isEmpty() && !mPass.isEmpty(); } // True once the user has sent any command to the game on the current connection. It gates whether - // an unsolicited GMCP Char.Login.URL may auto-open the browser: a URL that arrives only after the + // an unsolicited GMCP sign-in address may auto-open the browser: one that arrives only after the // player acted (e.g. chose a provider on the game's own sign-in screen) is a consequence of their // input, whereas one at an untouched connection is not and must not silently launch a browser. + // GMCPAuthenticator clears it again when it auto-opens, so one player action can launch at most + // one browser hand-off however many sign-in addresses the game pushes. bool userSentInputThisConnection() const { return mUserSentInputThisConnection; } void setUserSentInputThisConnection(const bool b) { mUserSentInputThisConnection = b; } int getRetries() { return mRetries; } diff --git a/src/OAuthClientFlow.cpp b/src/OAuthClientFlow.cpp index 64ca658a9..c6cdc08eb 100644 --- a/src/OAuthClientFlow.cpp +++ b/src/OAuthClientFlow.cpp @@ -23,7 +23,6 @@ #include "utils.h" #include <QCryptographicHash> -#include <QDesktopServices> #include <QJsonDocument> #include <QJsonObject> #include <QNetworkReply> @@ -192,14 +191,7 @@ void OAuthClientFlow::handleDiscoveryReply(QNetworkReply* reply) mCodeVerifier = generateCodeVerifier(); mState = randomUrlSafeToken(16); - const QUrl authorizationUrl = buildAuthorizationUrl(authorizationEndpoint, mClientId, mScopes, mRedirectUri, mState, codeChallengeS256(mCodeVerifier), mNonce); - - if (QDesktopServices::openUrl(authorizationUrl)) { - emit browserOpened(authorizationUrl.toString()); - } else { - // Keep the listener up: the user can still open the link by hand and complete the sign-in. - emit browserOpenFailed(authorizationUrl.toString()); - } + emit authorizationUrlReady(buildAuthorizationUrl(authorizationEndpoint, mClientId, mScopes, mRedirectUri, mState, codeChallengeS256(mCodeVerifier), mNonce)); } void OAuthClientFlow::handleRedirectConnection() @@ -278,11 +270,15 @@ void OAuthClientFlow::readRedirectRequest(QTcpSocket* socket) respond(socket, "200 OK", tr("You are signed in. You can close this tab and return to Mudlet.")); mCompleted = true; + // Move rather than copy: cleanup() scrubs mNonce next, and clearing a shared QString detaches, + // zeroing a fresh copy while the real value stays in the buffer this one still points at. + QString nonce = std::move(mNonce); cleanup(); - emit authorizationCaptured(code, mCodeVerifier, mRedirectUri); + emit authorizationCaptured(code, mCodeVerifier, mRedirectUri, nonce); // The authorization code and verifier are single-use secrets; the receiver has taken its own copies // (and is responsible for scrubbing them), so drop ours now. SecureStringUtils::secureStringClear(code); + SecureStringUtils::secureStringClear(nonce); SecureStringUtils::secureStringClear(mCodeVerifier); } diff --git a/src/OAuthClientFlow.h b/src/OAuthClientFlow.h index b0230add2..e77c3ef0e 100644 --- a/src/OAuthClientFlow.h +++ b/src/OAuthClientFlow.h @@ -32,10 +32,12 @@ class QNetworkReply; class QTcpSocket; // Runs the client-driven GMCP Char.Login v2 OAuth flow: fetches the server's OpenID Connect -// discovery document, opens the provider's authorization URL in the system browser with a PKCE -// (S256) challenge, and captures the authorization code on a loopback (RFC 8252) redirect -// listener. The token exchange itself stays on the game server - this class only produces the -// {code, code_verifier, redirect_uri} triple that GMCPAuthenticator sends as Char.Login.AuthCode. +// discovery document, builds the provider's authorization URL with a PKCE (S256) challenge, and +// captures the authorization code on a loopback (RFC 8252) redirect listener. The token exchange +// itself stays on the game server - this class only produces the {code, code_verifier, +// redirect_uri, nonce} set that GMCPAuthenticator sends as Char.Login.AuthCode. Handing the +// authorization URL to the system browser is the caller's job, so that the decision to launch a +// browser at the player is made in one place for both this and the server-driven flow. class OAuthClientFlow : public QObject { Q_OBJECT @@ -58,9 +60,8 @@ public: const QString& nonce); signals: - void authorizationCaptured(const QString& code, const QString& codeVerifier, const QString& redirectUri); - void browserOpened(const QString& url); - void browserOpenFailed(const QString& url); + void authorizationCaptured(const QString& code, const QString& codeVerifier, const QString& redirectUri, const QString& nonce); + void authorizationUrlReady(const QUrl& authorizationUrl); void flowFailed(const QString& logDetail); private: diff --git a/test/OAuthClientFlowTest.cpp b/test/OAuthClientFlowTest.cpp index d0bf149c5..e8037c046 100644 --- a/test/OAuthClientFlowTest.cpp +++ b/test/OAuthClientFlowTest.cpp @@ -19,7 +19,6 @@ #include <OAuthClientFlow.h> #include <QtTest/QtTest> -#include <QDesktopServices> #include <QJsonDocument> #include <QJsonObject> #include <QRegularExpression> @@ -96,11 +95,9 @@ class OAuthClientFlowTest : public QObject Q_OBJECT public slots: - void captureBrowserUrl(const QUrl& url) { mBrowserUrl = url; } + void captureAuthorizationUrl(const QUrl& url) { mAuthorizationUrl = url; } private slots: - void initTestCase(); - void cleanupTestCase(); void init(); void testCodeVerifierFormat(); void testCodeVerifierUnique(); @@ -116,22 +113,12 @@ private slots: void testEmptyCodeFailsFlow(); private: - QUrl mBrowserUrl; + QUrl mAuthorizationUrl; }; -void OAuthClientFlowTest::initTestCase() -{ - QDesktopServices::setUrlHandler(QStringLiteral("http"), this, "captureBrowserUrl"); -} - -void OAuthClientFlowTest::cleanupTestCase() -{ - QDesktopServices::unsetUrlHandler(QStringLiteral("http")); -} - void OAuthClientFlowTest::init() { - mBrowserUrl.clear(); + mAuthorizationUrl.clear(); } @@ -199,15 +186,16 @@ void OAuthClientFlowTest::testFullFlowCapturesAuthorizationCode() { MiniDiscoveryServer discovery(QStringLiteral("http://127.0.0.1:1/authorize")); OAuthClientFlow flow; + connect(&flow, &OAuthClientFlow::authorizationUrlReady, this, &OAuthClientFlowTest::captureAuthorizationUrl); QSignalSpy capturedSpy(&flow, &OAuthClientFlow::authorizationCaptured); QSignalSpy failedSpy(&flow, &OAuthClientFlow::flowFailed); - QSignalSpy openedSpy(&flow, &OAuthClientFlow::browserOpened); + QSignalSpy urlReadySpy(&flow, &OAuthClientFlow::authorizationUrlReady); flow.start(discovery.discoveryUrl(), QStringLiteral("test-client"), {QStringLiteral("openid")}, true); - QTRY_VERIFY(!mBrowserUrl.isEmpty()); - QCOMPARE(openedSpy.count(), 1); + QTRY_VERIFY(!mAuthorizationUrl.isEmpty()); + QCOMPARE(urlReadySpy.count(), 1); - const QUrlQuery query(mBrowserUrl); + const QUrlQuery query(mAuthorizationUrl); QCOMPARE(query.queryItemValue(QStringLiteral("response_type")), QStringLiteral("code")); QCOMPARE(query.queryItemValue(QStringLiteral("client_id")), QStringLiteral("test-client")); QCOMPARE(query.queryItemValue(QStringLiteral("scope"), QUrl::FullyDecoded), QStringLiteral("openid")); @@ -231,6 +219,7 @@ void OAuthClientFlowTest::testFullFlowCapturesAuthorizationCode() QCOMPARE(args.at(0).toString(), QStringLiteral("test-auth-code")); QCOMPARE(OAuthClientFlow::codeChallengeS256(args.at(1).toString()), challenge); QCOMPARE(args.at(2).toString(), redirectUri.toString()); + QCOMPARE(args.at(3).toString(), query.queryItemValue(QStringLiteral("nonce"))); QCOMPARE(failedSpy.count(), 0); // Wait for the full status line (peek does not consume) so a split packet cannot yield a partial read. @@ -241,12 +230,13 @@ void OAuthClientFlowTest::testStateMismatchFailsFlow() { MiniDiscoveryServer discovery(QStringLiteral("http://127.0.0.1:1/authorize")); OAuthClientFlow flow; + connect(&flow, &OAuthClientFlow::authorizationUrlReady, this, &OAuthClientFlowTest::captureAuthorizationUrl); QSignalSpy capturedSpy(&flow, &OAuthClientFlow::authorizationCaptured); QSignalSpy failedSpy(&flow, &OAuthClientFlow::flowFailed); flow.start(discovery.discoveryUrl(), QStringLiteral("test-client"), {QStringLiteral("openid")}, false); - QTRY_VERIFY(!mBrowserUrl.isEmpty()); - const QUrlQuery query(mBrowserUrl); + QTRY_VERIFY(!mAuthorizationUrl.isEmpty()); + const QUrlQuery query(mAuthorizationUrl); const QUrl redirectUri(query.queryItemValue(QStringLiteral("redirect_uri"), QUrl::FullyDecoded)); QTcpSocket browser; @@ -265,12 +255,13 @@ void OAuthClientFlowTest::testNonRedirectRequestIgnored() { MiniDiscoveryServer discovery(QStringLiteral("http://127.0.0.1:1/authorize")); OAuthClientFlow flow; + connect(&flow, &OAuthClientFlow::authorizationUrlReady, this, &OAuthClientFlowTest::captureAuthorizationUrl); QSignalSpy capturedSpy(&flow, &OAuthClientFlow::authorizationCaptured); QSignalSpy failedSpy(&flow, &OAuthClientFlow::flowFailed); flow.start(discovery.discoveryUrl(), QStringLiteral("test-client"), {QStringLiteral("openid")}, false); - QTRY_VERIFY(!mBrowserUrl.isEmpty()); - const QUrlQuery query(mBrowserUrl); + QTRY_VERIFY(!mAuthorizationUrl.isEmpty()); + const QUrlQuery query(mAuthorizationUrl); const QUrl redirectUri(query.queryItemValue(QStringLiteral("redirect_uri"), QUrl::FullyDecoded)); // A browser side-request (no code/error) must be answered without ending the flow. @@ -294,6 +285,7 @@ void OAuthClientFlowTest::testNonRedirectRequestIgnored() void OAuthClientFlowTest::testDiscoveryFetchFailureFailsFlow() { OAuthClientFlow flow; + connect(&flow, &OAuthClientFlow::authorizationUrlReady, this, &OAuthClientFlowTest::captureAuthorizationUrl); QSignalSpy failedSpy(&flow, &OAuthClientFlow::flowFailed); // A server that accepts the connection then closes it immediately guarantees the discovery // fetch fails deterministically, rather than relying on a host refusing a particular port. @@ -305,6 +297,7 @@ void OAuthClientFlowTest::testDiscoveryFetchFailureFailsFlow() void OAuthClientFlowTest::testNonLoopbackHttpDiscoveryUrlRejected() { OAuthClientFlow flow; + connect(&flow, &OAuthClientFlow::authorizationUrlReady, this, &OAuthClientFlowTest::captureAuthorizationUrl); QSignalSpy failedSpy(&flow, &OAuthClientFlow::flowFailed); // Plain http is only acceptable for loopback hosts; anything else must be refused // before any network activity happens. @@ -316,12 +309,13 @@ void OAuthClientFlowTest::testProviderErrorFailsFlow() { MiniDiscoveryServer discovery(QStringLiteral("http://127.0.0.1:1/authorize")); OAuthClientFlow flow; + connect(&flow, &OAuthClientFlow::authorizationUrlReady, this, &OAuthClientFlowTest::captureAuthorizationUrl); QSignalSpy capturedSpy(&flow, &OAuthClientFlow::authorizationCaptured); QSignalSpy failedSpy(&flow, &OAuthClientFlow::flowFailed); flow.start(discovery.discoveryUrl(), QStringLiteral("test-client"), {QStringLiteral("openid")}, false); - QTRY_VERIFY(!mBrowserUrl.isEmpty()); - const QUrlQuery query(mBrowserUrl); + QTRY_VERIFY(!mAuthorizationUrl.isEmpty()); + const QUrlQuery query(mAuthorizationUrl); const QUrl redirectUri(query.queryItemValue(QStringLiteral("redirect_uri"), QUrl::FullyDecoded)); QTcpSocket browser; @@ -337,12 +331,13 @@ void OAuthClientFlowTest::testEmptyCodeFailsFlow() { MiniDiscoveryServer discovery(QStringLiteral("http://127.0.0.1:1/authorize")); OAuthClientFlow flow; + connect(&flow, &OAuthClientFlow::authorizationUrlReady, this, &OAuthClientFlowTest::captureAuthorizationUrl); QSignalSpy capturedSpy(&flow, &OAuthClientFlow::authorizationCaptured); QSignalSpy failedSpy(&flow, &OAuthClientFlow::flowFailed); flow.start(discovery.discoveryUrl(), QStringLiteral("test-client"), {QStringLiteral("openid")}, false); - QTRY_VERIFY(!mBrowserUrl.isEmpty()); - const QUrlQuery query(mBrowserUrl); + QTRY_VERIFY(!mAuthorizationUrl.isEmpty()); + const QUrlQuery query(mAuthorizationUrl); const QUrl redirectUri(query.queryItemValue(QStringLiteral("redirect_uri"), QUrl::FullyDecoded)); // A redirect with a matching state but an empty code (code= present but blank) must fail, not diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index d4781de5b..afb106aec 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -141,7 +141,7 @@ set_tests_properties(TriggerSameLineMatchTest PROPERTIES TIMEOUT 300) # GMCPCharLoginTest creates a fresh profile per test method, so it needs a longer timeout -set_tests_properties(GMCPCharLoginTest PROPERTIES TIMEOUT 300) +set_tests_properties(GMCPCharLoginTest PROPERTIES TIMEOUT 600) # InsertTextCapTest creates a fresh profile per test method, so it needs a longer timeout set_tests_properties(InsertTextCapTest PROPERTIES TIMEOUT 300) diff --git a/test/functional_tests/GMCPCharLoginTest.cpp b/test/functional_tests/GMCPCharLoginTest.cpp index 30da41939..503e00ee2 100644 --- a/test/functional_tests/GMCPCharLoginTest.cpp +++ b/test/functional_tests/GMCPCharLoginTest.cpp @@ -25,11 +25,15 @@ #include <QtTest/QtTest> #include <chrono> +#include <QtNetwork/QSslCertificate> +#include <QtNetwork/QSslKey> +#include <QtNetwork/QSslSocket> #include <QtNetwork/QTcpServer> #include <QtNetwork/QTcpSocket> #include <QDesktopServices> #include <QJsonDocument> #include <QJsonObject> +#include <QUrlQuery> #include <functional> #include "CredentialManager.h" @@ -41,6 +45,56 @@ using namespace std::chrono_literals; +// Self-signed loopback certificate, valid until 2126; the client accepts it via Host::mSslIgnoreAll. +static const char* csmTestCertificatePem = R"PEM(-----BEGIN CERTIFICATE----- +MIIDJzCCAg+gAwIBAgIULa4vwGAVOB+r6qtcLMPqwzBlEJgwDQYJKoZIhvcNAQEL +BQAwFDESMBAGA1UEAwwJbG9jYWxob3N0MCAXDTI2MDgwNjE0MTM0OFoYDzIxMjYw +NzEzMTQxMzQ4WjAUMRIwEAYDVQQDDAlsb2NhbGhvc3QwggEiMA0GCSqGSIb3DQEB +AQUAA4IBDwAwggEKAoIBAQDEg1HE09f69FW/OLD0jrWEQRbKkSkIkexLfV5OtzbI +ZVDWcH3Y3NKrbZ60j8WEY8DqVzO2kMnOppc5LBEKGP1TTs6C9R+e5hlI6McoKown +ha4aU9nqM7dsjY71xGZNN9DCVxhRpqadlZon7M4wzVvUO5VIRhFeA2AO6LRVQhyi +9Whe/uJVlncb2tbiGgTavixWSQ5kH0ocE8Cp4SbuHuXPwgiZ9hYEIX2xAFSR48OB +bjWgqVISptu/s+UkK2XckI42qdxqzwglLIIqjFYJ1HvGqhqV69DeqB0XNw6qp8W2 +qwTpv3gPGzI60vNL6aaHTivLxnsEClPbcrTfG1y8DnnLAgMBAAGjbzBtMB0GA1Ud +DgQWBBSyDWWzo202vFbYncaD2crvY5V2pDAfBgNVHSMEGDAWgBSyDWWzo202vFbY +ncaD2crvY5V2pDAPBgNVHRMBAf8EBTADAQH/MBoGA1UdEQQTMBGCCWxvY2FsaG9z +dIcEfwAAATANBgkqhkiG9w0BAQsFAAOCAQEAs5nw4GBPPHc9Nc08uLUYTDLkA2XM +WPugjSO7OxUe8NptVh/v4GbeKzQ4FRIF6rca8De15+OOZgIDppRUoy+fd+ncoDan +flw38rIj13XfV/3WF33Uag2xtZG0Hrpu4PFZQyIzr0MwGJJ/v2uRjMiV0CX+rc0L +BJg2JS4oCbNdQpwH81qOktoH8aHirAyLjtm732GQgAGLe0fIBBsb4Dg2ZdvN+TF5 +xfKoFfri3H1rwju43zHXmUyCE/RPdIBR8flO6gzdgWAVY0jaixZi1fzQEQuReh2j +d2iZYOFSrVDea41ltrUvRC6q6gxe/REVjj1nCSYU1x44J9DQ6n6ljvJCVw== +-----END CERTIFICATE-----)PEM"; + +static const char* csmTestPrivateKeyPem = R"PEM(-----BEGIN PRIVATE KEY----- +MIIEwAIBADANBgkqhkiG9w0BAQEFAASCBKowggSmAgEAAoIBAQDEg1HE09f69FW/ +OLD0jrWEQRbKkSkIkexLfV5OtzbIZVDWcH3Y3NKrbZ60j8WEY8DqVzO2kMnOppc5 +LBEKGP1TTs6C9R+e5hlI6McoKownha4aU9nqM7dsjY71xGZNN9DCVxhRpqadlZon +7M4wzVvUO5VIRhFeA2AO6LRVQhyi9Whe/uJVlncb2tbiGgTavixWSQ5kH0ocE8Cp +4SbuHuXPwgiZ9hYEIX2xAFSR48OBbjWgqVISptu/s+UkK2XckI42qdxqzwglLIIq +jFYJ1HvGqhqV69DeqB0XNw6qp8W2qwTpv3gPGzI60vNL6aaHTivLxnsEClPbcrTf +G1y8DnnLAgMBAAECggEBALRPHebwzfrI2CilttAeZXTdWDEzsifX5K17cd3eBBkp +xVuNShuCupZq9bUNOhl4ghlDPALmpRTFDHp78YKHXWFkLN5CVeoxjL+2Po6fQ4w7 +/3zOtWNMYp/q32Kn+4ocjaLT0U+SDs0G6LR7dtGWjAyXQylWiTbu9+OWJ2kXSTlH +QbdtamymoJrrjRTV1HUEq/a3qSHlqTA5/EKIcGeiETq2NR0fZ3NFbe+PLiOSpiNg +uIiVEdsItuZTdINSEzOtMFvRd2od0ITDpMtLG404aGsI4Zisiuhr5naf4DWqK2aL +n9Z/55LSuAdBqvrtJ9XVdtNsFdCRjbIj2R1qqDTFm/kCgYEA6W/+ufDXrhPi8XWS +8+7tlOoUd0jYZL9N+N1hfho21SN3eH5TtNO0b/os/PN/M+5dKeWPtnyzwg49EksF +Es9Z4+lLt/Z+71RDmYqSCwaLhXNKtUZluZmrGHcRogd4hJDYv9icgmpwMK5Hg634 +PYCgVYb9C1Wug/mZhgLg7Aw3hn8CgYEA14GxAPViaSszVNRps+a9WVEJklPbPR8U +kAxWTP6n1SdT3Z9HRcHH9inIdTLyC/3ti4+4dc1pDkMrq+MUTjvF8BqN35uzJa7l +6dnsXBmWvB1cIcwQb4SLnDb7jzmiK2uIjMrO54x3+atB83GdvESLOQ/9NAJL/+NX +ILq5kAs2nrUCgYEAqq7/8pceLKNPybttMr0drEenpTx3NNsIORItydWDCD8BiPHd +ZJdzFHk5Uc780EzWg97dQNJXYWmlz+1YjVNdZ57ahW1PjNDxCKBgfn1PoMkW9ArA +MIAisSXGl9GcllmOkl/guB75Xy7fDXIz00xsb3zfIt2IV+k2Dt2l9hJMuyMCgYEA +lv45ZHCJeSJZntANF41NkazjxfCXJaYHJD5goSWztfcOHbOhnlB9qA3yc5s0WA6c +RzJ1jaRUPTf2+0HpUj8zGl2gldFjnb2DPWwA3S7YnAj+Knft9BSsNNGZQ+qfo0h+ +rhbTDQ0wanABj25FlEl6OornX29UjH9e5oGtziztIhkCgYEAppTHqOgLiKmeV15d +i850uRyh7X6whywY8gm0VLO+xzCVsCR6CvgZY1MwwFuDwu2d/d5jdJXLpHueQwNU +3HipTI77OuIRv4ykXwPOIemT9VmL/N21CgrckJGA6dYywTnc/JNpOKxdTM9srOyr +Rcsgla9jttJevaHI71x2jLNBaKk= +-----END PRIVATE KEY-----)PEM"; + extern void qInitResources_mudlet(); extern void qInitResources_qm(); extern void qInitResources_additional_splash_screens(); @@ -48,6 +102,42 @@ extern void qInitResources_mudlet_fonts_common(); extern void qInitResources_mudlet_fonts_posix(); static void initializeQRCResources(); +// Hands out QSslSocket connections when asked to, so the stub can offer an encrypted transport. +class GmcpTcpServer : public QTcpServer +{ + Q_OBJECT + +public: + explicit GmcpTcpServer(QObject* parent = nullptr) + : QTcpServer(parent) + { + } + + void setTls(bool tls) { mTls = tls; } + +protected: + void incomingConnection(qintptr socketDescriptor) override + { + if (!mTls) { + QTcpServer::incomingConnection(socketDescriptor); + return; + } + auto* socket = new QSslSocket(this); + if (!socket->setSocketDescriptor(socketDescriptor)) { + delete socket; + return; + } + socket->setLocalCertificate(QSslCertificate(QByteArray(csmTestCertificatePem))); + socket->setPrivateKey(QSslKey(QByteArray(csmTestPrivateKeyPem), QSsl::Rsa)); + socket->startServerEncryption(); + // QSslSocket buffers writes queued before the handshake, so this behaves like a plain socket. + addPendingConnection(socket); + } + +private: + bool mTls = false; +}; + // A tiny GMCP-capable server: offers GMCP on connect, parses the telnet stream to // collect the client's GMCP messages, and can push Char.Login frames on demand. class GmcpServerStub : public QObject @@ -65,8 +155,15 @@ public: // reads the actual port back via serverPort(). bool start() { return mServer.listen(QHostAddress::LocalHost, 0); } quint16 serverPort() const { return mServer.serverPort(); } + void setTls(bool tls) { mServer.setTls(tls); } bool gmcpEnabled() const { return mGmcpEnabled; } + // So a test asserting on encrypted-transport behaviour cannot silently pass over a plain socket. + bool clientEncrypted() const + { + auto* sslClient = qobject_cast<QSslSocket*>(mClient.data()); + return sslClient && sslClient->isEncrypted(); + } QStringList receivedGmcp() const { return mReceivedGmcp; } void clearReceived() { mReceivedGmcp.clear(); } @@ -200,7 +297,7 @@ private: mBuffer = mBuffer.mid(i); } - QTcpServer mServer; + GmcpTcpServer mServer; QPointer<QTcpSocket> mClient; QByteArray mBuffer; QStringList mReceivedGmcp; @@ -208,20 +305,61 @@ private: int mConnectionCount = 0; }; +// Serves a static OpenID Connect discovery document over loopback http, which +// OAuthClientFlow::acceptableEndpointUrl() permits, so no second certificate is needed. +class DiscoveryServerStub : public QObject +{ + Q_OBJECT + +public: + explicit DiscoveryServerStub(QObject* parent = nullptr) + : QObject(parent) + { + connect(&mServer, &QTcpServer::newConnection, this, [this]() { + while (mServer.hasPendingConnections()) { + QTcpSocket* socket = mServer.nextPendingConnection(); + connect(socket, &QTcpSocket::readyRead, socket, [this, socket]() { + mRequests[socket] += socket->readAll(); + if (!mRequests.value(socket).contains("\r\n\r\n")) { + return; + } + mRequests.remove(socket); + const QByteArray body = QJsonDocument(QJsonObject{{qsl("authorization_endpoint"), authorizationEndpoint()}}).toJson(QJsonDocument::Compact); + socket->write("HTTP/1.1 200 OK\r\nContent-Type: application/json\r\nContent-Length: " + QByteArray::number(body.size()) + "\r\nConnection: close\r\n\r\n" + body); + socket->disconnectFromHost(); + }); + connect(socket, &QObject::destroyed, this, [this, socket]() { + mRequests.remove(socket); + }); + connect(socket, &QTcpSocket::disconnected, socket, &QObject::deleteLater); + } + }); + } + + bool start() { return mServer.listen(QHostAddress::LocalHost, 0); } + QString discoveryUrl() const { return qsl("http://127.0.0.1:%1/.well-known/openid-configuration").arg(mServer.serverPort()); } + QString authorizationEndpoint() const { return qsl("http://127.0.0.1:%1/authorize").arg(mServer.serverPort()); } + +private: + QTcpServer mServer; + QHash<QTcpSocket*, QByteArray> mRequests; +}; + class GMCPCharLoginTest : public QObject { Q_OBJECT public slots: - // Registered as the http/https URL handler so a Char.Login.URL the client auto-opens routes here + // Registered as the http/https URL handler so a sign-in address the client auto-opens routes here // instead of launching a real browser during the test. - void captureOpenedUrl(const QUrl& url) { mOpenedUrl = url; } + void captureOpenedUrl(const QUrl& url) { mOpenedUrls.append(url); } private: GmcpServerStub* mpServer = nullptr; + DiscoveryServerStub* mpDiscovery = nullptr; const QString mHostname = qsl("Test-CharLogin"); quint16 mPort = 0; // assigned the stub's actual loopback port in init() - QUrl mOpenedUrl; + QList<QUrl> mOpenedUrls; private slots: void initTestCase() @@ -245,7 +383,7 @@ private slots: mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique<MudletInstanceCoordinator>("MudletInstanceCoordinator")); mudlet::self()->init(); mudlet::self()->setStorePasswordsSecurely(false); - mOpenedUrl.clear(); + mOpenedUrls.clear(); // Start each test from a clean credential state so a reconnect token saved by an earlier test // cannot leak into one that expects none (which would make the client replay it instead). CredentialManager::removeCredential(mHostname, qsl("reconnect")); @@ -256,6 +394,8 @@ private slots: { delete mpServer; mpServer = nullptr; + delete mpDiscovery; + mpDiscovery = nullptr; deleteProfileDirectory(mHostname); delete mudlet::self(); } @@ -384,7 +524,7 @@ private slots: void testSavedTokenIsReplayedOnReconnect() { - Host* host = connectAndNegotiate(); + Host* host = connectAndNegotiate(true); QVERIFY(host); host->setLogin(QString()); host->setPass(QString()); @@ -402,10 +542,56 @@ private slots: QCOMPARE(sent.value(qsl("version")).toInt(), 2); } - void testRejectedReconnectTokenIsDiscarded() + void testSavedTokenIsNotReplayedOverCleartext() { Host* host = connectAndNegotiate(); QVERIFY(host); + QVERIFY2(!host->mTelnet.currentlySecure(), "precondition: this connection is unencrypted"); + host->setLogin(QString()); + host->setPass(QString()); + const QString tokenJson = qsl("{\"account\": \"acct:char\", \"token\": \"saved-token\"}"); + QVERIFY(CredentialManager::storeCredential(host->getName(), qsl("reconnect"), tokenJson)); + + mpServer->clearReceived(); + mpServer->sendGmcp(qsl("Char.Login.Default {\"version\": 2, \"type\": [\"oauth\", \"password-credentials\"]}")); + + QJsonObject sent; + QVERIFY2(waitForClientGmcp(qsl("Char.Login.Credentials"), sent), "the sign-in should fall back to the interactive hand-off"); + QVERIFY2(sent.isEmpty(), "the fall-back must be the empty {} hand-off"); + QCOMPARE(mpServer->countReceived(qsl("Char.Login.Reconnect")), 0); + QVERIFY2(waitForConsoleContains(host, qsl("not encrypted")), "the user should be told why their saved sign-in was not used"); + QVERIFY2(!CredentialManager::retrieveCredential(host->getName(), qsl("reconnect")).isEmpty(), "refusing to send the token must not destroy it"); + + // Nothing awaits a reconnect result, so an ordinary failed sign-in must not be mistaken for a + // rejected token - that would rewrite or delete the stored entry the player still needs. + mpServer->sendGmcp(qsl("Char.Login.Result {\"success\": false, \"message\": \"Invalid credentials\"}")); + QVERIFY2(waitForConsoleContains(host, qsl("Could not log in to the game")), "a failed interactive sign-in should be reported as one"); + QVERIFY2(!CredentialManager::retrieveCredential(host->getName(), qsl("reconnect")).isEmpty(), "the stored sign-in must survive an unrelated login failure"); + } + + void testCleartextTokenFallsBackToProviderResume() + { + Host* host = connectAndNegotiate(); + QVERIFY(host); + host->setLogin(QString()); + host->setPass(QString()); + const QString tokenJson = qsl("{\"account\": \"acct:char\", \"provider\": \"discord\", \"token\": \"saved-token\"}"); + QVERIFY(CredentialManager::storeCredential(host->getName(), qsl("reconnect"), tokenJson)); + + mpServer->clearReceived(); + mpServer->sendGmcp(qsl("Char.Login.Default {\"version\": 2, \"type\": [\"oauth\", \"password-credentials\"]}")); + + QJsonObject sent; + QVERIFY2(waitForClientGmcp(qsl("Char.Login.Credentials"), sent), "client did not send the resume form"); + QCOMPARE(sent.value(qsl("provider")).toString(), qsl("discord")); + QVERIFY2(!sent.contains(qsl("token")), "the resume form must not carry the token"); + QCOMPARE(mpServer->countReceived(qsl("Char.Login.Reconnect")), 0); + } + + void testRejectedReconnectTokenIsDiscarded() + { + Host* host = connectAndNegotiate(true); + QVERIFY(host); host->setLogin(QString()); host->setPass(QString()); // No provider in the entry: with nothing to resume, rejection removes the entry entirely. @@ -426,7 +612,7 @@ private slots: void testRejectedReconnectKeepsResumeHint() { - Host* host = connectAndNegotiate(); + Host* host = connectAndNegotiate(true); QVERIFY(host); host->setLogin(QString()); host->setPass(QString()); @@ -491,7 +677,7 @@ private slots: void testRotatedTokenIsReplayedNotDiscarded() { - Host* host = connectAndNegotiate(); + Host* host = connectAndNegotiate(true); QVERIFY(host); host->setLogin(QString()); host->setPass(QString()); @@ -532,7 +718,7 @@ private slots: void testRotationReplayClearsTheRejectionLatch() { - Host* host = connectAndNegotiate(); + Host* host = connectAndNegotiate(true); QVERIFY(host); host->setLogin(QString()); host->setPass(QString()); @@ -622,7 +808,7 @@ private slots: void testStoredCredentialsOutrankSavedToken() { - Host* host = connectAndNegotiate(); + Host* host = connectAndNegotiate(true); QVERIFY(host); // Both a saved reconnect token AND stored character name/password are present. The player's // typed credentials name the exact character, so they must win: the client sends @@ -652,17 +838,40 @@ private slots: // Simulate the player having acted on the game's sign-in screen this connection; an unsolicited // Char.Login.URL is then a consequence of their input and must be auto-opened in the browser. host->setUserSentInputThisConnection(true); - mOpenedUrl.clear(); + mOpenedUrls.clear(); mpServer->sendGmcp(qsl("Char.Login.URL {\"url\": \"https://example.com/signin\", \"provider\": \"discord\"}")); QVERIFY2(waitForConsoleContains(host, qsl("Opening your browser to sign in with Discord")), "a prompted URL should be auto-opened with a provider-labelled handoff"); - QCOMPARE(mOpenedUrl, QUrl(qsl("https://example.com/signin"))); + QCOMPARE(mOpenedUrls, QList<QUrl>{QUrl(qsl("https://example.com/signin"))}); + } + + void testRepeatedAuthUrlsOpenOneBrowserPerUserAction() + { + Host* host = connectAndNegotiate(); + QVERIFY(host); + host->setUserSentInputThisConnection(true); + mOpenedUrls.clear(); + + for (int i = 1; i <= 5; ++i) { + mpServer->sendGmcp(qsl("Char.Login.URL {\"url\": \"https://example.com/signin%1\"}").arg(i)); + } + // GMCP frames are handled in order, so a reply to this one proves all five were processed. + mpServer->sendGmcp(qsl("Char.Login.Default {\"version\": 2, \"type\": [\"password-credentials\"]}")); + QJsonObject sent; + QVERIFY2(waitForClientGmcp(qsl("Char.Login.Credentials"), sent), "client did not work through the pushed sign-in addresses"); + QCOMPARE(mOpenedUrls, QList<QUrl>{QUrl(qsl("https://example.com/signin1"))}); + + // A further player action re-arms it: a rate limit, not a one-per-connection cap. + host->setUserSentInputThisConnection(true); + mpServer->sendGmcp(qsl("Char.Login.URL {\"url\": \"https://example.com/signin6\"}")); + QTRY_COMPARE(mOpenedUrls.size(), 2); + QCOMPARE(mOpenedUrls.at(1), QUrl(qsl("https://example.com/signin6"))); } // ---- Post-rejection loop guard (allowToken == false) ------------------- void testReconnectAfterRejectionDoesNotReplayToken() { - Host* host = connectAndNegotiate(); + Host* host = connectAndNegotiate(true); QVERIFY(host); host->setLogin(QString()); host->setPass(QString()); @@ -708,6 +917,112 @@ private slots: // mReconnectRejected. Getting either wrong loses a player's freshly saved token or lets a rejected one // be replayed, and neither failure is reachable by hand. + // ---- Client-driven OAuth (Char.Login.AuthCode) ------------------------- + + void testClientDrivenOAuthOpensOneBrowserPerConnection() + { + Host* host = connectAndNegotiate(true); + QVERIFY(host); + host->setLogin(QString()); + host->setPass(QString()); + QVERIFY2(!host->userSentInputThisConnection(), "precondition: no user input yet"); + startDiscoveryServer(); + mOpenedUrls.clear(); + + // Connecting is itself the request, so the first offer opens the browser with nothing typed. + mpServer->sendGmcp(clientDrivenDefault()); + QTRY_COMPARE(mOpenedUrls.size(), 1); + + for (int i = 0; i < 4; ++i) { + mpServer->sendGmcp(clientDrivenDefault()); + } + QVERIFY2(waitForConsoleContains(host, qsl("To sign in, open this link")), "a re-offered client-driven sign-in should be offered as a link"); + QCOMPARE(mOpenedUrls.size(), 1); + } + + void testAuthCodeCarriesTheNonceTheServerAskedFor() + { + Host* host = connectAndNegotiate(true); + QVERIFY(host); + host->setLogin(QString()); + host->setPass(QString()); + startDiscoveryServer(); + mOpenedUrls.clear(); + mpServer->clearReceived(); + + mpServer->sendGmcp(clientDrivenDefault()); + QTRY_VERIFY(!mOpenedUrls.isEmpty()); + const QUrlQuery authorizationQuery(mOpenedUrls.first()); + const QString nonce = authorizationQuery.queryItemValue(qsl("nonce")); + QVERIFY2(!nonce.isEmpty(), "the authorization request should carry a nonce when the server asked for one"); + + // Play the identity provider: send the browser's redirect back to the loopback listener. + const QUrl redirectUri(authorizationQuery.queryItemValue(qsl("redirect_uri"), QUrl::FullyDecoded)); + QTcpSocket browser; + browser.connectToHost(redirectUri.host(), static_cast<quint16>(redirectUri.port())); + QVERIFY(browser.waitForConnected(3000)); + browser.write("GET /?code=test-auth-code&state=" + authorizationQuery.queryItemValue(qsl("state")).toLatin1() + " HTTP/1.1\r\nHost: 127.0.0.1\r\n\r\n"); + + QJsonObject sent; + QVERIFY2(waitForClientGmcp(qsl("Char.Login.AuthCode"), sent), "client did not complete the client-driven sign-in"); + QCOMPARE(sent.value(qsl("code")).toString(), qsl("test-auth-code")); + QVERIFY(!sent.value(qsl("code_verifier")).toString().isEmpty()); + QCOMPARE(sent.value(qsl("redirect_uri")).toString(), redirectUri.toString()); + QCOMPARE(sent.value(qsl("nonce")).toString(), nonce); + } + + void testAuthCodeOmitsTheNonceWhenTheServerDidNotAskForIt() + { + Host* host = connectAndNegotiate(true); + QVERIFY(host); + host->setLogin(QString()); + host->setPass(QString()); + startDiscoveryServer(); + mOpenedUrls.clear(); + mpServer->clearReceived(); + + mpServer->sendGmcp(clientDrivenDefault(false)); + QTRY_VERIFY(!mOpenedUrls.isEmpty()); + const QUrlQuery authorizationQuery(mOpenedUrls.first()); + QVERIFY2(!authorizationQuery.hasQueryItem(qsl("nonce")), "no nonce should be requested from the provider either"); + + const QUrl redirectUri(authorizationQuery.queryItemValue(qsl("redirect_uri"), QUrl::FullyDecoded)); + QTcpSocket browser; + browser.connectToHost(redirectUri.host(), static_cast<quint16>(redirectUri.port())); + QVERIFY(browser.waitForConnected(3000)); + browser.write("GET /?code=test-auth-code&state=" + authorizationQuery.queryItemValue(qsl("state")).toLatin1() + " HTTP/1.1\r\nHost: 127.0.0.1\r\n\r\n"); + + QJsonObject sent; + QVERIFY2(waitForClientGmcp(qsl("Char.Login.AuthCode"), sent), "client did not complete the client-driven sign-in"); + QVERIFY2(!sent.contains(qsl("nonce")), "an empty nonce must be left out rather than sent as an empty string"); + } + + // ---- Char.Login.Default flood ------------------------------------------ + + void testDefaultFloodIsThrottled() + { + Host* host = connectAndNegotiate(); + QVERIFY(host); + host->setLogin(QString()); + host->setPass(QString()); + + mpServer->clearReceived(); + for (int i = 0; i < 200; ++i) { + mpServer->sendGmcp(qsl("Char.Login.Default {\"version\": 2, \"type\": [\"oauth\", \"password-credentials\"]}")); + } + + QJsonObject sent; + QVERIFY2(waitForClientGmcp(qsl("Char.Login.Credentials"), sent), "the first frame should still be answered straight away"); + + // Cost is bounded by wall clock, not by how much the server sent: one immediate attempt plus + // one when the window closes, not 200. A range, so a loaded runner slipping into the next + // window does not flake, and a lower bound because a re-offer must still be answered. + QTest::qWait(2500ms); + const int attempts = mpServer->countReceived(qsl("Char.Login.Credentials")); + QVERIFY2(attempts >= 2, qPrintable(qsl("a throttled burst must still be answered, saw %1 attempts").arg(attempts))); + QVERIFY2(attempts <= 4, qPrintable(qsl("200 frames should not buy 200 sign-in attempts, saw %1").arg(attempts))); + } + // ---- Char.Login.Result -------------------------------------------------- void testFailedResultReportsError() @@ -727,8 +1042,44 @@ private slots: } private: - // Drive the GUI to create/connect a profile, then wait for GMCP to negotiate. - Host* connectAndNegotiate() + void startDiscoveryServer() + { + mpDiscovery = new DiscoveryServerStub(); + QVERIFY(mpDiscovery->start()); + } + + // Advertises the client-driven OAuth capability, which the client only honours over TLS. + QString clientDrivenDefault(bool requestNonce = true) const + { + return qsl(R"(Char.Login.Default {"version": 2, "type": ["oauth"], "location": "%1", "client_id": "test-client", "nonce": %2})") + .arg(mpDiscovery->discoveryUrl(), requestNonce ? qsl("true") : qsl("false")); + } + + // Drive the GUI to create/connect a profile, then wait for GMCP to negotiate. Reaching TLS by + // reconnecting rather than creating the profile encrypted is what makes this deterministic: + // mSslTsl and mSslIgnoreAll are set on a live Host, before the attempt that reads them starts. + Host* connectAndNegotiate(bool secure = false) + { + Host* host = createProfileAndConnect(); + if (!host || !secure) { + return host; + } + host->mSslTsl = true; + host->mSslIgnoreAll = true; // the stub's certificate is self-signed + mpServer->setTls(true); + const int plainConnection = mpServer->connectionCount(); + host->mTelnet.reconnect(); + if (!waitForNegotiatedConnection(plainConnection)) { + return nullptr; + } + if (!mpServer->clientEncrypted()) { + qWarning("The connection did not complete a TLS handshake"); + return nullptr; + } + return host; + } + + Host* createProfileAndConnect() { const QString port = QString::number(mPort); QTimer::singleShot(0ms, qApp, [this, port]() { @@ -749,8 +1100,9 @@ private: QTest::keyClick(QApplication::focusWidget(), Qt::Key_Return); }); + // A fresh mudlet and profile per test on an instrumented, loaded runner is slow. QSignalSpy loaded(mudlet::self(), &mudlet::signal_profileLoaded); - if (!loaded.wait(5000)) { + if (!loaded.wait(20000)) { qWarning("Profile took too long to load"); return nullptr; } @@ -759,22 +1111,21 @@ private: qWarning("No active host"); return nullptr; } - QSignalSpy connected(&(host->mTelnet), &cTelnet::signal_connected); - if (!connected.wait(3000)) { - qWarning("Could not connect to the stub"); - return nullptr; - } - // Wait until the client has answered our GMCP offer (IAC DO GMCP) so that - // Char.Login frames we push afterwards are processed. - const bool negotiated = QTest::qWaitFor( - [this]() { - return mpServer->gmcpEnabled(); + return waitForNegotiatedConnection(0) ? host : nullptr; + } + + // Also waits for the client to answer our GMCP offer, so frames pushed afterwards are processed. + bool waitForNegotiatedConnection(int afterConnectionCount) + { + const bool connected = QTest::qWaitFor( + [this, afterConnectionCount]() { + return mpServer->connectionCount() > afterConnectionCount && mpServer->gmcpEnabled(); }, - 3000); - if (!negotiated) { - qWarning("GMCP was not negotiated"); + 15000); + if (!connected) { + qWarning("Could not connect to the stub, or GMCP was not negotiated"); } - return host; + return connected; } // Wait until the client sends a GMCP message whose package matches, returning its JSON body. From 159d4bbe022f6900b453f94c368d918c9a4d07c4 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Fri, 7 Aug 2026 10:14:30 +0200 Subject: [PATCH 116/155] Fix three crashes in the game selection screen (#9702) #### Brief overview of PR changes/additions - **Right-clicking the games list with nothing selected killed Mudlet.** `dlgConnectionProfiles::slot_profileContextMenu()` dereferenced `currentItem()` unguarded. That line is byte-identical in 4.22.0, so the null deref itself is long-standing and latent - what is new is that it became reachable: "improve: split the games list into My games and All games tabs" (#9452) leaves a user with no saved profiles an empty but still right-clickable "My games" tab, a state 4.22.0's always-populated list never had. About 40 seconds into a fresh install. - **Copying a profile while the list was rebuilt was a use-after-free.** The copy runs on a thread pool and its completion handler kept the `QListWidgetItem*` it had made; clicking the other games tab meanwhile calls `fillout_form()`, which destroys every item. The handler now finds the copy by name, and the `QFutureWatcher` is parented so it cannot outlive the dialog. - **Quitting before the connection dialog had been shown dereferenced null.** The queued `0ms` lambda in `mudlet::slot_showConnectionDialog()` used `mpConnectionDialog`, which `mudlet::closeEvent()` closes (it is `WA_DeleteOnClose`) and clears. #### Motivation for adding to Mudlet All three came out of the 5.0 QA sweep and are confirmed with AddressSanitizer. The first is the serious one - it is the default state of a brand-new install, so a new user can lose Mudlet before they have connected to anything. Scope note on the third: it is **not** a 5.0 regression. It has been there since "Fix: Improve tab indicators and detached window UX" (#7965) and is unchanged in 4.22.0; #9493 only turned the literal `0` into `0ms`. Nor could I reach it by clicking: I drove *Games -> Close profile* followed by quitting at six delays from 0 to 2000 ms and the dialog was always painted first. It reproduces deterministically in-process, and QA reproduced it 2/2 driving the close from Lua. Worth guarding - the pointer is documented to go null - but latent rather than routinely hit. #### Other info (issues closed, discussion etc) Test case: `ctest -R ConnectionDialogCrashTest` - with the fix reverted, four of its tests reproduce the original ASan reports exactly (two SEGVs in `slot_profileContextMenu`, a heap-use-after-free in `slot_itemClicked`, the SEGV in `QWidget::show()` from the lambda); two more are controls that pass either way, one of them pinning that the menu still opens for a selected profile so the guard cannot degenerate into an unconditional early return. Full suite 79/79. Assisted-by: Claude:claude-opus-5 --- src/dlgConnectionProfiles.cpp | 80 +++- src/dlgConnectionProfiles.h | 2 + src/mudlet.cpp | 7 + test/functional_tests/CMakeLists.txt | 6 + .../ConnectionDialogCrashTest.cpp | 412 ++++++++++++++++++ 5 files changed, 497 insertions(+), 10 deletions(-) create mode 100644 test/functional_tests/ConnectionDialogCrashTest.cpp diff --git a/src/dlgConnectionProfiles.cpp b/src/dlgConnectionProfiles.cpp index 9ddc0a6b2..7a35ffecd 100644 --- a/src/dlgConnectionProfiles.cpp +++ b/src/dlgConnectionProfiles.cpp @@ -126,6 +126,8 @@ dlgConnectionProfiles::dlgConnectionProfiles(QWidget* parent) connect(listWidget_profiles, &QWidget::customContextMenuRequested, this, &dlgConnectionProfiles::slot_profileContextMenu); mpTabBar = new QTabBar(this); + // QTabWidget gives this dialog a second QTabBar, so this one needs a name + mpTabBar->setObjectName(qsl("gamesTabBar")); //: Tab showing only the games the user already has profiles for mpTabBar->insertTab(scmMyGamesTab, tr("My games")); //: Tab showing every game Mudlet has a built-in profile for @@ -1672,10 +1674,37 @@ void dlgConnectionProfiles::generateCustomProfile(const QString& profileName) co listWidget_profiles->addItem(pItem); } +// fillout_form() destroys and rebuilds every item, so callers that have let the +// event loop run cannot hold on to one. +void dlgConnectionProfiles::setIconOfListedProfile(const QString& profileName, const QIcon& icon) const +{ + const auto pItems = findData(*listWidget_profiles, profileName, csmNameRole); + if (pItems.isEmpty()) { + return; + } + pItems.first()->setIcon(icon); +} + +// Empty when nothing is selected. The context-menu actions re-check rather than +// trust slot_profileContextMenu(): menu.exec() runs a nested event loop, and the +// profile-copy completion handler calls fillout_form() from it, which can clear +// the selection - or leave a different profile current, in which case the action +// still mis-targets. Only the crash of acting on nothing is handled here. +QString dlgConnectionProfiles::selectedProfileName() const +{ + const auto* pItem = listWidget_profiles->currentItem(); + return pItem ? pItem->data(csmNameRole).toString() : QString(); +} + void dlgConnectionProfiles::slot_profileContextMenu(QPoint pos) { + // "My games" on a fresh install lists nothing, so nothing is current + const auto profileName = selectedProfileName(); + if (profileName.isEmpty()) { + return; + } + const QPoint globalPos = listWidget_profiles->mapToGlobal(pos); - auto profileName = listWidget_profiles->currentItem()->data(csmNameRole).toString(); QMenu menu; if (hasCustomIcon(profileName)) { @@ -1699,7 +1728,10 @@ void dlgConnectionProfiles::slot_profileContextMenu(QPoint pos) void dlgConnectionProfiles::slot_setCustomIcon() { - auto profileName = listWidget_profiles->currentItem()->data(csmNameRole).toString(); + const auto profileName = selectedProfileName(); + if (profileName.isEmpty()) { + return; + } QSettings& settings = *mudlet::getQSettings(); QString lastDir = settings.value("lastFileDialogLocation", QDir::homePath()).toString(); @@ -1718,11 +1750,15 @@ void dlgConnectionProfiles::slot_setCustomIcon() } auto icon = QIcon(QPixmap(imageLocation).scaled(QSize(120, 30), Qt::IgnoreAspectRatio, Qt::SmoothTransformation).copy()); - listWidget_profiles->currentItem()->setIcon(icon); + // the file dialog ran a nested event loop, so the current item may have moved + setIconOfListedProfile(profileName, icon); } void dlgConnectionProfiles::slot_setCustomColor() { - auto profileName = listWidget_profiles->currentItem()->data(csmNameRole).toString(); + const auto profileName = selectedProfileName(); + if (profileName.isEmpty()) { + return; + } QColor color = QColorDialog::getColor(getCustomColor(profileName).value_or(QColor(255, 255, 255))); if (color.isValid()) { auto profileColorPath = mudlet::getMudletPath(enums::profileDataItemPath, profileName, qsl("profilecolor")); @@ -1736,12 +1772,15 @@ void dlgConnectionProfiles::slot_setCustomColor() if (!file.commit()) { qDebug() << "dlgConnectionProfiles::slot_setCustomColor: error saving custom icon color: " << file.errorString(); } - listWidget_profiles->currentItem()->setIcon(customIcon(profileName, {color})); + setIconOfListedProfile(profileName, customIcon(profileName, {color})); } } void dlgConnectionProfiles::slot_resetCustomIcon() { - auto profileName = listWidget_profiles->currentItem()->data(csmNameRole).toString(); + const auto profileName = selectedProfileName(); + if (profileName.isEmpty()) { + return; + } const bool success = mudlet::self()->resetProfileIcon(profileName).first; if (!success) { @@ -1788,10 +1827,31 @@ void dlgConnectionProfiles::slot_copyProfile() mpCopyProfile->setText(tr("Copying...")); mpCopyProfile->setEnabled(false); auto future = QtConcurrent::run(dlgConnectionProfiles::copyFolder, mudlet::getMudletPath(enums::profileHomePath, oldname), mudlet::getMudletPath(enums::profileHomePath, profile_name)); - auto watcher = new QFutureWatcher<bool>; - connect(watcher, &QFutureWatcher<bool>::finished, this, [=, this]() { - mProfileList << profile_name; - slot_itemClicked(pItem); + auto watcher = new QFutureWatcher<bool>(this); + connect(watcher, &QFutureWatcher<bool>::finished, this, [this, profile_name, oldPassword, watcher]() { + if (!mProfileList.contains(profile_name)) { + mProfileList << profile_name; + } + + // The dialog stays usable while the copy runs, and switching the games + // tab calls fillout_form(), which destroys every item - including the + // one made for this copy. Hence look it up by name rather than hold it. + auto pCopiedItems = findData(*listWidget_profiles, profile_name, csmNameRole); + if (pCopiedItems.isEmpty()) { + // that rebuild scanned the profiles directory before the copy + // landed in it + fillout_form(); + pCopiedItems = findData(*listWidget_profiles, profile_name, csmNameRole); + } + if (!pCopiedItems.isEmpty()) { + auto* pCopiedItem = pCopiedItems.first(); + if (listWidget_profiles->currentItem() == pCopiedItem) { + slot_itemClicked(pCopiedItem); + } else { + // reaches slot_itemClicked() through currentItemChanged + listWidget_profiles->setCurrentItem(pCopiedItem); + } + } // restore the password, which won't be copied by the disk copy if stored in the credential manager // Temporarily block textChanged signal to avoid triggering save on programmatic setText diff --git a/src/dlgConnectionProfiles.h b/src/dlgConnectionProfiles.h index 13ce66eab..d6fed63f3 100644 --- a/src/dlgConnectionProfiles.h +++ b/src/dlgConnectionProfiles.h @@ -126,6 +126,8 @@ private: void loadCustomProfile(const QString&) const; void generateCustomProfile(const QString&) const; void setCustomIcon(const QString&, QListWidgetItem*) const; + void setIconOfListedProfile(const QString& profileName, const QIcon& icon) const; + QString selectedProfileName() const; template <typename L> void loadSecuredPassword(const QString& profile, L callback); void migrateSecuredPassword(const QString& oldProfile, const QString& newProfile); diff --git a/src/mudlet.cpp b/src/mudlet.cpp index 104bead17..7a399b842 100644 --- a/src/mudlet.cpp +++ b/src/mudlet.cpp @@ -3494,6 +3494,13 @@ void mudlet::slot_showConnectionDialog() // Use a timer to ensure the main window is ready before showing the dialog // This is especially important at startup when the main window might not be fully initialized QTimer::singleShot(0ms, this, [this]() { + // closeEvent() closes this WA_DeleteOnClose dialog and clears the + // QPointer, so quitting before this runs leaves nothing to show - and + // show() below would undo closeEvent()'s hide() of the main window + if (!mpConnectionDialog) { + return; + } + // Ensure the main window is visible and ready if (!isVisible()) { show(); diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index afb106aec..24b7d880c 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -48,6 +48,7 @@ set(FUNCTIONAL_TEST_SOURCES ActionSelfUninstallTest.cpp ProfileFolderNameTest.cpp DialogTeardownTest.cpp + ConnectionDialogCrashTest.cpp EdbeeReinitTest.cpp TMediaLoopTest.cpp DefaultPackagesTest.cpp @@ -174,6 +175,11 @@ set_tests_properties(ProfileRoundTripTest MapRoundTripTest MapProgressDialogSeam # HostWidgetDecouplingTest creates a fresh profile per test method, so it needs a longer timeout set_tests_properties(HostWidgetDecouplingTest PROPERTIES TIMEOUT 300) +# ConnectionDialogCrashTest waits out two real profile copies (15s budget each) +# on top of a full mudlet start under ASan, so the 60s default is too tight for +# a loaded machine even though the file runs in ~2s +set_tests_properties(ConnectionDialogCrashTest PROPERTIES TIMEOUT 300) + # NarrowWindowWrapTest creates a fresh profile per test method, so it needs a longer timeout set_tests_properties(NarrowWindowWrapTest PROPERTIES TIMEOUT 300) diff --git a/test/functional_tests/ConnectionDialogCrashTest.cpp b/test/functional_tests/ConnectionDialogCrashTest.cpp new file mode 100644 index 000000000..743c26689 --- /dev/null +++ b/test/functional_tests/ConnectionDialogCrashTest.cpp @@ -0,0 +1,412 @@ +/*************************************************************************** + * Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +/* + * Crashes of the connection dialog, driven through the real dialog against an + * isolated config directory. Reaching the end of a test is most of what it + * asserts; the rest pins the behaviour that replaced the crash. + * + * Run with: ctest -R ConnectionDialogCrashTest -V + */ + +#include "MudletInstanceCoordinator.h" +#include "dlgConnectionProfiles.h" +#include "mudlet.h" + +#include <QtTest/QtTest> + +#include <QAbstractScrollArea> +#include <QContextMenuEvent> +#include <QMenu> +#include <QPushButton> +#include <QTabBar> +#include <chrono> + +using namespace std::chrono_literals; + +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); + +static void initializeQRCResources() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +class ConnectionDialogCrashTest : public QObject +{ + Q_OBJECT + +private: + QTemporaryDir mXdgDir; + QByteArray mSavedXdg; + + // not created in initTestCase(): the first test needs a profiles/ with + // nothing in it at all + const QString mProfileName = qsl("ConnDialogCrash-Test"); + // what copyProfileWidget() names the copy of a name not ending in a digit + const QString mCopyName = qsl("ConnDialogCrash-Test1"); + const QString mQuietProfileName = qsl("ConnDialogCrash-Quiet"); + const QString mQuietCopyName = qsl("ConnDialogCrash-Quiet1"); + + static constexpr int scmMyGamesTab = 0; + static constexpr int scmAllGamesTab = 1; + static constexpr int scmTestMarkerRole = Qt::UserRole + 99; + const QString mProfileUrl = qsl("mudlet.org"); + const QString mProfilePort = qsl("23"); + + // setupConfig() consults portable.txt before the XDG logic, so its presence + // would put this test on the user's real config dir (see ConfigDirOverrideTest) + bool portableMarkerPresent() const + { + return QFileInfo::exists(qsl("%1/portable.txt").arg(QCoreApplication::applicationDirPath())) || QFileInfo::exists(qsl("%1/.config/mudlet/portable.txt").arg(QDir::homePath())); + } + + // by name: QTabWidget gives the dialog a second QTabBar + QTabBar* gamesTabBar(dlgConnectionProfiles* dialog) const { return dialog->findChild<QTabBar*>(qsl("gamesTabBar")); } + + // members, not locals of the calling test: with no menu the timer is still + // armed when that method returns + QStringList mMenuActionTexts; + bool mSawMenu = false; + QString mUnexpectedPopup; + + // menu.exec() runs its own event loop, so the menu can only be inspected and + // dismissed from inside it; callers stop the timer when no menu appears + QTimer* armMenuCloser() + { + mMenuActionTexts.clear(); + mSawMenu = false; + mUnexpectedPopup.clear(); + auto* closer = new QTimer(this); + closer->setInterval(20); + connect(closer, &QTimer::timeout, this, [this, closer]() { + auto* popup = QApplication::activePopupWidget(); + if (!popup) { + return; + } + auto* menu = qobject_cast<QMenu*>(popup); + if (!menu) { + // menu.exec() waits on whatever holds the popup, so close it + // rather than time the run out + mUnexpectedPopup = QString::fromLatin1(popup->metaObject()->className()); + popup->close(); + closer->stop(); + return; + } + mSawMenu = true; + const auto actions = menu->actions(); + for (const auto* action : actions) { + mMenuActionTexts << action->text(); + } + menu->close(); + closer->stop(); + }); + closer->start(); + return closer; + } + + void disarmMenuCloser(QTimer* closer) + { + closer->stop(); + closer->deleteLater(); + } + + QString menuOutcome() const { return mUnexpectedPopup.isEmpty() ? QString() : qsl(" (a %1 took the popup instead)").arg(mUnexpectedPopup); } + + // Must go to the viewport: QAbstractScrollArea ignores a mouse-reason + // context menu sent to itself, and its viewportEvent() is what raises + // customContextMenuRequested. + void rightClickBelowTheLastItem(QAbstractScrollArea* view) const + { + auto* viewport = view->viewport(); + const QPoint pos(viewport->width() / 2, viewport->height() - 4); + QContextMenuEvent event(QContextMenuEvent::Mouse, pos, viewport->mapToGlobal(pos)); + QApplication::sendEvent(viewport, &event); + } + + // reports instead of QVERIFYing: a QVERIFY here would only leave the helper + bool makeProfileFolder(const QString& name) const + { + return QDir().mkpath(mudlet::getMudletPath(enums::profileHomePath, name)) && mudlet::self()->writeProfileData(name, qsl("url"), mProfileUrl).first + && mudlet::self()->writeProfileData(name, qsl("port"), mProfilePort).first; + } + +private slots: + void initTestCase() + { + if (portableMarkerPresent()) { + QSKIP("portable.txt present - cannot redirect the config dir for this test"); + } + initializeQRCResources(); + + mSavedXdg = qgetenv("XDG_CONFIG_HOME"); + QVERIFY(mXdgDir.isValid()); + QVERIFY(QDir().mkpath(qsl("%1/mudlet").arg(mXdgDir.path()))); // empty dir = XDG opt-in + qputenv("XDG_CONFIG_HOME", mXdgDir.path().toUtf8()); + + mudlet::start(); + mudlet::self()->setupConfig(); + QVERIFY(mudlet::getMudletPath(enums::profilesPath).startsWith(mXdgDir.path())); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique<MudletInstanceCoordinator>("MudletInstanceCoordinator")); + mudlet::self()->init(); + mudlet::self()->setStorePasswordsSecurely(false); + + mudlet::self()->startAutoLogin({}); + // the dialog is only shown from a queued lambda, so the pointer turning + // up is not enough + QVERIFY(QTest::qWaitFor( + []() { + return mudlet::self()->mpConnectionDialog && mudlet::self()->mpConnectionDialog->isVisible(); + }, + 5000)); + } + + void cleanupTestCase() + { + mSavedXdg.isNull() ? qunsetenv("XDG_CONFIG_HOME") : qputenv("XDG_CONFIG_HOME", mSavedXdg); + delete mudlet::self(); + } + + void test_rightClickWithNoProfileSelected() + { + auto* dialog = mudlet::self()->mpConnectionDialog.data(); + QVERIFY2(dialog, "No connection dialog to test against"); + + auto* skipButton = dialog->findChild<QPushButton*>(qsl("skipToGamesButton")); + QVERIFY2(skipButton, "The first-launch invitation has no skip button any more"); + QVERIFY2(skipButton->isVisible(), "This is not a first-launch dialog - the skip button is not shown"); + skipButton->click(); + QTest::qWait(100ms); + + auto* tabBar = gamesTabBar(dialog); + QVERIFY2(tabBar, "The games list has no tab bar"); + tabBar->setCurrentIndex(scmMyGamesTab); + QTest::qWait(100ms); + + // not an empty list: a debug build still lists the self-test entry, but + // none of it is on disk so fillout_form() makes nothing current + QVERIFY2(!dialog->listWidget_profiles->currentItem(), + qPrintable( + qsl("The 'My games' tab of a fresh install selected something (%1 items listed) - this test no longer covers the reported crash").arg(dialog->listWidget_profiles->count()))); + + auto* closer = armMenuCloser(); + rightClickBelowTheLastItem(dialog->listWidget_profiles); + disarmMenuCloser(closer); + + QVERIFY2(!mSawMenu, "A context menu was offered with no profile for it to act on"); + QVERIFY2(mUnexpectedPopup.isEmpty(), qPrintable(menuOutcome())); + QVERIFY2(!QApplication::activePopupWidget(), "A popup was left on screen"); + } + + void test_rightClickOnAnEmptyList() + { + auto* dialog = mudlet::self()->mpConnectionDialog.data(); + QVERIFY2(dialog, "No connection dialog to test against"); + + dialog->listWidget_profiles->clear(); + QCOMPARE(dialog->listWidget_profiles->count(), 0); + + auto* closer = armMenuCloser(); + rightClickBelowTheLastItem(dialog->listWidget_profiles); + disarmMenuCloser(closer); + + QVERIFY2(!mSawMenu, "A context menu was offered for an empty games list"); + QVERIFY2(mUnexpectedPopup.isEmpty(), qPrintable(menuOutcome())); + + dialog->fillout_form(); + QTest::qWait(100ms); + } + + // so that "return early when nothing is current" cannot become "return early" + void test_contextMenuStillOpensForASelectedProfile() + { + auto* dialog = mudlet::self()->mpConnectionDialog.data(); + QVERIFY2(dialog, "No connection dialog to test against"); + + auto* tabBar = gamesTabBar(dialog); + QVERIFY(tabBar); + tabBar->setCurrentIndex(scmAllGamesTab); + QTest::qWait(100ms); + + QVERIFY2(dialog->listWidget_profiles->count() > 0, "The 'All games' tab lists nothing"); + dialog->listWidget_profiles->setCurrentRow(0); + QVERIFY2(dialog->listWidget_profiles->currentItem(), "Could not select a profile to open the menu for"); + + auto* closer = armMenuCloser(); + rightClickBelowTheLastItem(dialog->listWidget_profiles); + disarmMenuCloser(closer); + + QVERIFY2(mSawMenu, qPrintable(qsl("No context menu appeared for a selected profile%1").arg(menuOutcome()))); + // "Set custom icon" and "Set custom color" for a profile without one + QCOMPARE(mMenuActionTexts.size(), 2); + QVERIFY2(!mMenuActionTexts.first().isEmpty(), "The menu offered a nameless action"); + } + + void test_copiedProfileSurvivesTheListBeingRebuilt() + { + auto* dialog = mudlet::self()->mpConnectionDialog.data(); + QVERIFY2(dialog, "No connection dialog to test against"); + + QVERIFY(makeProfileFolder(mProfileName)); + QDir(mudlet::getMudletPath(enums::profileHomePath, mCopyName)).removeRecursively(); + + auto* tabBar = gamesTabBar(dialog); + QVERIFY(tabBar); + tabBar->setCurrentIndex(scmMyGamesTab); + dialog->fillout_form(); + // clear slot_itemClicked()'s 100ms same-profile debounce, which would + // otherwise leave the form blank after fillout_form() cleared it + QTest::qWait(300ms); + + const auto items = dialog->findData(*dialog->listWidget_profiles, mProfileName, dlgConnectionProfiles::csmNameRole); + QVERIFY2(!items.isEmpty(), "The test profile is not listed in the dialog"); + dialog->listWidget_profiles->setCurrentItem(items.first()); + dialog->slot_itemClicked(items.first()); + QCOMPARE(dialog->profile_name_entry->text(), mProfileName); + + auto* copyAction = dialog->findChild<QAction*>(qsl("copyProfile")); + QVERIFY2(copyAction, "The dialog has no Copy action any more"); + + dialog->slot_copyProfile(); + QVERIFY2(!copyAction->isEnabled(), "The copy did not take the asynchronous path"); + // the copy reports back through the event loop, which has not run since, + // so this destroys the copy's item before the handler sees it + tabBar->setCurrentIndex(scmAllGamesTab); + + QVERIFY2(QTest::qWaitFor( + [copyAction]() { + return copyAction->isEnabled(); + }, + 15000), + "The copy never completed"); + + QVERIFY2(QDir(mudlet::getMudletPath(enums::profileHomePath, mCopyName)).exists(), "The copy has no folder on disk"); + QCOMPARE(dialog->readProfileData(mCopyName, qsl("url")), mProfileUrl); + QCOMPARE(dialog->readProfileData(mCopyName, qsl("port")), mProfilePort); + QVERIFY2(!dialog->findData(*dialog->listWidget_profiles, mCopyName, dlgConnectionProfiles::csmNameRole).isEmpty(), "The copy is not listed in the games list"); + // No assertions on the form fields: a copy completes inside + // slot_itemClicked()'s 100ms debounce, which swallows the fill and + // leaves Server address and Port blank - a separate bug. + auto* pCurrentItem = dialog->listWidget_profiles->currentItem(); + QVERIFY2(pCurrentItem, "Nothing is selected after the copy finished"); + QCOMPARE(pCurrentItem->data(dlgConnectionProfiles::csmNameRole).toString(), mCopyName); + + QDir(mudlet::getMudletPath(enums::profileHomePath, mCopyName)).removeRecursively(); + QDir(mudlet::getMudletPath(enums::profileHomePath, mProfileName)).removeRecursively(); + dialog->fillout_form(); + QTest::qWait(100ms); + } + + // the branch where the copy's item is still there and still current + void test_copiedProfileIsSelectedWhenTheListIsLeftAlone() + { + auto* dialog = mudlet::self()->mpConnectionDialog.data(); + QVERIFY2(dialog, "No connection dialog to test against"); + + QVERIFY(makeProfileFolder(mQuietProfileName)); + QDir(mudlet::getMudletPath(enums::profileHomePath, mQuietCopyName)).removeRecursively(); + + auto* tabBar = gamesTabBar(dialog); + QVERIFY(tabBar); + tabBar->setCurrentIndex(scmMyGamesTab); + dialog->fillout_form(); + QTest::qWait(300ms); + + const auto items = dialog->findData(*dialog->listWidget_profiles, mQuietProfileName, dlgConnectionProfiles::csmNameRole); + QVERIFY2(!items.isEmpty(), "The test profile is not listed in the dialog"); + dialog->listWidget_profiles->setCurrentItem(items.first()); + dialog->slot_itemClicked(items.first()); + QCOMPARE(dialog->profile_name_entry->text(), mQuietProfileName); + + auto* copyAction = dialog->findChild<QAction*>(qsl("copyProfile")); + QVERIFY(copyAction); + dialog->slot_copyProfile(); + QVERIFY2(!copyAction->isEnabled(), "The copy did not take the asynchronous path"); + + const auto created = dialog->findData(*dialog->listWidget_profiles, mQuietCopyName, dlgConnectionProfiles::csmNameRole); + QVERIFY2(!created.isEmpty(), "The copy got no entry in the list"); + // a mark outlives a rebuild check; a pointer would have been freed by one + created.first()->setData(scmTestMarkerRole, true); + + QVERIFY2(QTest::qWaitFor( + [copyAction]() { + return copyAction->isEnabled(); + }, + 15000), + "The copy never completed"); + + QVERIFY2(QDir(mudlet::getMudletPath(enums::profileHomePath, mQuietCopyName)).exists(), "The copy has no folder on disk"); + QCOMPARE(dialog->readProfileData(mQuietCopyName, qsl("url")), mProfileUrl); + QCOMPARE(dialog->readProfileData(mQuietCopyName, qsl("port")), mProfilePort); + auto* pCurrentItem = dialog->listWidget_profiles->currentItem(); + QVERIFY2(pCurrentItem, "Nothing is selected after the copy finished"); + QCOMPARE(pCurrentItem->data(dlgConnectionProfiles::csmNameRole).toString(), mQuietCopyName); + QVERIFY2(pCurrentItem->data(scmTestMarkerRole).toBool(), "The list was rebuilt after all - this test no longer covers the undisturbed branch"); + + QDir(mudlet::getMudletPath(enums::profileHomePath, mQuietCopyName)).removeRecursively(); + QDir(mudlet::getMudletPath(enums::profileHomePath, mQuietProfileName)).removeRecursively(); + dialog->fillout_form(); + QTest::qWait(100ms); + } + + // Must stay last: leaves the main window hidden and no connection dialog, + // both of which the other tests need. + void test_connectionDialogClosedBeforeItIsShown() + { + auto* mudletApp = mudlet::self(); + if (mudletApp->mpConnectionDialog) { + mudletApp->mpConnectionDialog->close(); + mudletApp->mpConnectionDialog = nullptr; + QTest::qWait(200ms); + } + QVERIFY2(!mudletApp->mpConnectionDialog, "Could not get rid of the connection dialog this test starts from"); + + mudletApp->slot_showConnectionDialog(); + QVERIFY2(mudletApp->mpConnectionDialog, "No connection dialog was created"); + + // what closeEvent() does, with the event loop not having run since + // slot_showConnectionDialog() queued its lambda + QVERIFY2(mudletApp->isVisible(), "The main window has to start out visible for the hide() below to mean anything"); + mudletApp->mpConnectionDialog->close(); + mudletApp->mpConnectionDialog = nullptr; + mudletApp->hide(); + QVERIFY2(!mudletApp->isVisible(), "The main window did not hide"); + + QTest::qWait(300ms); // the queued lambda gets its turn in here + + QVERIFY2(!mudletApp->mpConnectionDialog, "The queued lambda brought the connection dialog back"); + QVERIFY2(!mudletApp->isVisible(), "The queued lambda re-showed the main window Mudlet was shutting down"); + } +}; + +QTEST_MAIN(ConnectionDialogCrashTest) +#include "ConnectionDialogCrashTest.moc" From 6c67a1382682b74193794b80d806346343703f64 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Fri, 7 Aug 2026 10:14:45 +0200 Subject: [PATCH 117/155] fix: two ways a profile save could lose or resurrect your data (#9704) #### Brief overview of PR changes/additions - Variables: the export skipped its refresh whenever the editor's Variables view was on screen, so anything a script wrote into a saved variable while it sat open was dropped from the save - including the session's last save, which is taken with whatever view the editor was left on. The variables are now read into a throwaway tree, which also stops a save stranding the editor's variable search results. - Packages: a save taken while a unit was still executing an item of a package that had just been uninstalled wrote that package's items back into the profile, where they returned as orphans the Package Manager could not remove. The XML writers now skip what the units have queued for a deferred delete, the module writer included - reloading a module from a script used to write both the pre- and post-reload copies of its items into the module file. - `LuaInterface::getVars()` is now `setjmp`-guarded like every other Lua-touching method there, so a panic cannot jump past the export's scope with its variable tree and registry references still held. #### Motivation for adding to Mudlet Both are silent data loss in everyday use: quitting with the editor on the Variables tab, and the `mpkg`/auto-updater shape of uninstalling a package from a script. #### Other info (issues closed, discussion etc) From the 5.0 QA sweep, findings C13 and C14. The variables half re-opens the loss that `20009c5ec` "fix: variables added while playing are no longer lost when saving (#9492)" fixed, via the guard it added; the packages half is the missing counterpart to the self-uninstall deferral in `276e8bbfd` (#9383) and its follow-ups. #9492's own cases still pass unchanged. **Test case:** create a table from the command line, tick it to be saved in the editor's Variables view, leave the editor there, run `lua myTable.later = "x"`, quit and reopen - `later` is still there. `ctest -R 'XMLexportVariablesTest|PackageSelfUninstallTest'` covers both halves; all 12 new cases were verified to fail against the unfixed source. Assisted-by: Claude:claude-opus-5 --- src/LuaInterface.cpp | 29 +- src/LuaInterface.h | 5 +- src/XMLexport.cpp | 58 +-- src/dlgTriggerEditor.cpp | 5 - src/dlgTriggerEditor.h | 3 - .../PackageSelfUninstallTest.cpp | 396 ++++++++++++++++++ .../XMLexportVariablesTest.cpp | 163 +++++++ 7 files changed, 617 insertions(+), 42 deletions(-) diff --git a/src/LuaInterface.cpp b/src/LuaInterface.cpp index 7cc969ed4..564728731 100644 --- a/src/LuaInterface.cpp +++ b/src/LuaInterface.cpp @@ -49,6 +49,8 @@ LuaInterface::LuaInterface(lua_State* L) lua_atpanic(L, &onPanic); } +// Does not release lrefs: a profile reset closes the lua_State before this +// object is replaced, so unref'ing here would write into a freed state. LuaInterface::~LuaInterface() = default; int LuaInterface::onPanic(lua_State* L) @@ -68,6 +70,19 @@ VarUnit* LuaInterface::getVarUnit() return varUnit.data(); } +lua_State* LuaInterface::getState() const +{ + return mL; +} + +void LuaInterface::releaseVariableReferences() +{ + for (const int ref : std::as_const(lrefs)) { + luaL_unref(mL, LUA_REGISTRYINDEX, ref); + } + lrefs.clear(); +} + QStringList LuaInterface::varName(TVar* var) { QStringList names; @@ -825,17 +840,19 @@ void LuaInterface::getVars(bool hide) //returns the base item // QElapsedTimer t; // t.start(); + // onPanic() longjmp()s to the shared buf, so without a setjmp of our own + // that jump lands in whichever frame set it last - usually one that has + // already returned, taking the caller's scope down with it. + if (setjmp(buf) != 0) { + qWarning() << "LuaInterface::getVars() WARNING - Lua panicked while reading the variables in; the variable tree is incomplete."; + return; + } lua_pushnil(mL); depth = 0; auto global = new TVar(); global->setName("_G", LUA_TSTRING); global->setValue("{}", LUA_TTABLE); - QListIterator<int> it(lrefs); - while (it.hasNext()) { - const int ref = it.next(); - luaL_unref(mL, LUA_REGISTRYINDEX, ref); - } - lrefs.clear(); + releaseVariableReferences(); varUnit->clear(); varUnit->setBase(global); varUnit->addVariable(global); diff --git a/src/LuaInterface.h b/src/LuaInterface.h index c2e531f36..e5f1d93ae 100644 --- a/src/LuaInterface.h +++ b/src/LuaInterface.h @@ -65,12 +65,15 @@ public: void renameVar(TVar*); void createVar(TVar*); VarUnit* getVarUnit(); + // Anything that builds a variable tree and throws it away owes this call: + // ~LuaInterface cannot make it, see there. + void releaseVariableReferences(); bool loadVar(TVar* var); bool reparentCVariable(TVar* from, TVar* to, TVar* curVar); bool reparentVariable(QTreeWidgetItem*, QTreeWidgetItem*, QTreeWidgetItem*); std::pair<bool, QString> validMove(QTreeWidgetItem*); void getAllChildren(TVar* var, QList<TVar*>* list); - lua_State* getState(); + lua_State* getState() const; static int onPanic(lua_State*); private: diff --git a/src/XMLexport.cpp b/src/XMLexport.cpp index 06549655d..0152641a3 100644 --- a/src/XMLexport.cpp +++ b/src/XMLexport.cpp @@ -95,7 +95,7 @@ void XMLexport::writeModuleXML(const QString& moduleName) auto triggerPackage = mudletPackage.append_child("TriggerPackage"); //we go a level down for all these functions so as to not infinitely nest the module for (auto& it : pHost->mTriggerUnit.mTriggerRootNodeList) { - if (!it || it->mPackageName != moduleName) { + if (!it || pHost->mTriggerUnit.uninstallList.contains(it) || it->mPackageName != moduleName) { continue; } if (!it->isTemporary() && it->mModuleMember) { @@ -105,7 +105,7 @@ void XMLexport::writeModuleXML(const QString& moduleName) auto timerPackage = mudletPackage.append_child("TimerPackage"); for (auto& it : pHost->mTimerUnit.mTimerRootNodeList) { - if (!it || it->mPackageName != moduleName) { + if (!it || pHost->mTimerUnit.uninstallList.contains(it) || it->mPackageName != moduleName) { continue; } if (!it->isTemporary() && it->mModuleMember) { @@ -115,7 +115,7 @@ void XMLexport::writeModuleXML(const QString& moduleName) auto aliasPackage = mudletPackage.append_child("AliasPackage"); for (auto& it : pHost->mAliasUnit.mAliasRootNodeList) { - if (!it || it->mPackageName != moduleName) { + if (!it || pHost->mAliasUnit.uninstallList.contains(it) || it->mPackageName != moduleName) { continue; } if (!it->isTemporary() && it->mModuleMember) { @@ -125,7 +125,7 @@ void XMLexport::writeModuleXML(const QString& moduleName) auto actionPackage = mudletPackage.append_child("ActionPackage"); for (auto& it : pHost->mActionUnit.mActionRootNodeList) { - if (!it || it->mPackageName != moduleName) { + if (!it || pHost->mActionUnit.uninstallList.contains(it) || it->mPackageName != moduleName) { continue; } if (it->mModuleMember) { @@ -135,7 +135,7 @@ void XMLexport::writeModuleXML(const QString& moduleName) auto scriptPackage = mudletPackage.append_child("ScriptPackage"); for (auto& it : pHost->mScriptUnit.mScriptRootNodeList) { - if (!it || it->mPackageName != moduleName) { + if (!it || pHost->mScriptUnit.uninstallList.contains(it) || it->mPackageName != moduleName) { continue; } if (it->mModuleMember) { @@ -145,7 +145,7 @@ void XMLexport::writeModuleXML(const QString& moduleName) auto keyPackage = mudletPackage.append_child("KeyPackage"); for (auto& it : pHost->mKeyUnit.mKeyRootNodeList) { - if (!it || it->mPackageName != moduleName) { + if (!it || pHost->mKeyUnit.uninstallList.contains(it) || it->mPackageName != moduleName) { continue; } if (!it->isTemporary() && it->mModuleMember) { @@ -772,33 +772,37 @@ void XMLexport::writeVariablePackage(Host* pHost, pugi::xml_node& mudletPackage) } } - // Refresh the variable tree so it reflects the current Lua state. The tree - // is otherwise only rebuilt at profile load and when the Variables editor - // populates it, so a variable (or saved table member) a script created - // afterwards would be missing here and silently dropped from the saved - // profile. Skip the refresh only while that editor view is on screen: it - // owns the tree and rebuilding it here would invalidate the widget the user - // is interacting with (its variables would stop responding until refreshed). - const bool variablesEditorOnScreen = pHost->mpEditorDialog && pHost->mpEditorDialog->variablesViewActive(); - TVar* base = vu->getBase(); - if (!variablesEditorOnScreen || !base) { - lI->getVars(false); - base = vu->getBase(); - } + // Into a throwaway tree rather than the live one: the Variables editor's + // QTreeWidgetItems point into the live tree, so rebuilding it here would + // strand every one of them. Reusing it as it stands is no good either - only + // the editor rebuilds it, so anything a script did since is missing from it. + LuaInterface saveTimeInterface(lI->getState()); + VarUnit* saveTimeUnit = saveTimeInterface.getVarUnit(); + // A fresh tree carries no per-variable saved/hidden flags, so isSaved() and + // isHidden() have to answer from these name-keyed sets. + saveTimeUnit->savedVars = vu->savedVars; + saveTimeUnit->hidden = vu->hidden; + saveTimeUnit->hiddenByUser = vu->hiddenByUser; + saveTimeInterface.getVars(false); - if (base) { + if (TVar* base = saveTimeUnit->getBase()) { QListIterator<TVar*> itVariable(base->getChildren(false)); while (itVariable.hasNext()) { - writeVariable(itVariable.next(), lI, vu, variablePackage); + writeVariable(itVariable.next(), &saveTimeInterface, saveTimeUnit, variablePackage); } } + saveTimeInterface.releaseVariableReferences(); } +// A unit busy executing an item of a package being uninstalled can only +// deactivate it; it stays registered in uninstallList until doCleanup() flushes +// it. Such an item is gone as far as the profile is concerned, so no writer that +// walks a root node list may serialize it. The list is empty at any other time. void XMLexport::writeKeyPackage(const Host* pHost, pugi::xml_node& mudletPackage, bool skipModuleMembers) { auto keyPackage = mudletPackage.append_child("KeyPackage"); for (auto it : pHost->mKeyUnit.mKeyRootNodeList) { - if (!it || it->isTemporary() || (skipModuleMembers && it->mModuleMember)) { + if (!it || pHost->mKeyUnit.uninstallList.contains(it) || it->isTemporary() || (skipModuleMembers && it->mModuleMember)) { continue; } writeKey(it, keyPackage); @@ -809,7 +813,7 @@ void XMLexport::writeScriptPackage(const Host* pHost, pugi::xml_node& mudletPack { auto scriptPackage = mudletPackage.append_child("ScriptPackage"); for (auto it : pHost->mScriptUnit.mScriptRootNodeList) { - if (!it || (skipModuleMembers && it->mModuleMember)) { + if (!it || pHost->mScriptUnit.uninstallList.contains(it) || (skipModuleMembers && it->mModuleMember)) { continue; } writeScript(it, scriptPackage); @@ -820,7 +824,7 @@ void XMLexport::writeActionPackage(const Host* pHost, pugi::xml_node& mudletPack { auto actionPackage = mudletPackage.append_child("ActionPackage"); for (auto it : pHost->mActionUnit.mActionRootNodeList) { - if (!it || (skipModuleMembers && it->mModuleMember)) { + if (!it || pHost->mActionUnit.uninstallList.contains(it) || (skipModuleMembers && it->mModuleMember)) { continue; } writeAction(it, actionPackage); @@ -831,7 +835,7 @@ void XMLexport::writeAliasPackage(const Host* pHost, pugi::xml_node& mudletPacka { auto aliasPackage = mudletPackage.append_child("AliasPackage"); for (auto it : pHost->mAliasUnit.mAliasRootNodeList) { - if (!it || (skipModuleMembers && it->mModuleMember)) { + if (!it || pHost->mAliasUnit.uninstallList.contains(it) || (skipModuleMembers && it->mModuleMember)) { continue; } if (!it->isTemporary()) { @@ -844,7 +848,7 @@ void XMLexport::writeTimerPackage(const Host* pHost, pugi::xml_node& mudletPacka { auto timerPackage = mudletPackage.append_child("TimerPackage"); for (auto it : pHost->mTimerUnit.mTimerRootNodeList) { - if (!it || (skipModuleMembers && it->mModuleMember)) { + if (!it || pHost->mTimerUnit.uninstallList.contains(it) || (skipModuleMembers && it->mModuleMember)) { continue; } if (!it->isTemporary()) { @@ -857,7 +861,7 @@ void XMLexport::writeTriggerPackage(const Host* pHost, pugi::xml_node& mudletPac { auto triggerPackage = mudletPackage.append_child("TriggerPackage"); for (auto it : pHost->mTriggerUnit.mTriggerRootNodeList) { - if (!it || (ignoreModuleMembers && it->mModuleMember)) { + if (!it || pHost->mTriggerUnit.uninstallList.contains(it) || (ignoreModuleMembers && it->mModuleMember)) { continue; } if (!it->isTemporary()) { diff --git a/src/dlgTriggerEditor.cpp b/src/dlgTriggerEditor.cpp index faf4465d4..95c1f994c 100644 --- a/src/dlgTriggerEditor.cpp +++ b/src/dlgTriggerEditor.cpp @@ -9706,11 +9706,6 @@ EditorViewType dlgTriggerEditor::determineViewFromVisibleTree() return EditorViewType::cmUnknownView; } -bool dlgTriggerEditor::variablesViewActive() const -{ - return isVisible() && mCurrentView == EditorViewType::cmVarsView; -} - EditorViewType dlgTriggerEditor::resolveCurrentView() { if (mCurrentView != EditorViewType::cmUnknownView) { diff --git a/src/dlgTriggerEditor.h b/src/dlgTriggerEditor.h index 942301296..a848e639d 100644 --- a/src/dlgTriggerEditor.h +++ b/src/dlgTriggerEditor.h @@ -204,9 +204,6 @@ public: int canRecast(QTreeWidgetItem*, int newNameType, int newValueType); void saveVar(); void repopulateVars(); - // true while the Variables view is the one shown on screen, so a profile - // save can avoid rebuilding the tree out from under the live widget - bool variablesViewActive() const; void changeView(EditorViewType); void recurseVariablesUp(QTreeWidgetItem* const, QList<QTreeWidgetItem*>&); void recurseVariablesDown(QTreeWidgetItem* const, QList<QTreeWidgetItem*>&); diff --git a/test/functional_tests/PackageSelfUninstallTest.cpp b/test/functional_tests/PackageSelfUninstallTest.cpp index 59a212c55..84de87f8a 100644 --- a/test/functional_tests/PackageSelfUninstallTest.cpp +++ b/test/functional_tests/PackageSelfUninstallTest.cpp @@ -38,23 +38,48 @@ * inside TTimer::execute() / Host::raiseEvent() / TScript::compileScript(); with * the deferral in place all scenarios complete cleanly. * + * The second half covers the other side of that deferral: an item whose delete + * is outstanding is still registered, and must not be written back into the + * profile by a save taken before the unit goes idle. + * * Run with: ctest -R PackageSelfUninstallTest -V */ #include <QtTest/QtTest> +#include <QScopeGuard> #include <QTemporaryDir> +#include "ActionUnit.h" +#include "AliasUnit.h" #include "Host.h" #include "HostManager.h" +#include "LuaInterface.h" #include "MudletInstanceCoordinator.h" #include "ScriptUnit.h" +#include "TAction.h" +#include "TAlias.h" #include "TEvent.h" #include "TScript.h" #include "TTimer.h" +#include "TTrigger.h" #include "TimerUnit.h" +#include "TriggerUnit.h" +#include "VarUnit.h" +#include "XMLexport.h" +#include "XMLimport.h" #include "mudlet.h" +extern "C" { +#if defined(INCLUDE_VERSIONED_LUA_HEADERS) +#include <lua5.1/lauxlib.h> +#include <lua5.1/lua.h> +#else +#include <lauxlib.h> +#include <lua.h> +#endif +} + extern void qInitResources_mudlet(); extern void qInitResources_qm(); extern void qInitResources_additional_splash_screens(); @@ -62,6 +87,38 @@ extern void qInitResources_mudlet_fonts_common(); extern void qInitResources_mudlet_fonts_posix(); void initializeQRCResourcesForPackageSelfUninstallTest(); +// TriggerUnit only holds its depth inside processDataStream(), so a save at +// depth has to come from a trigger's own script. Stands in for the Lua +// saveProfile() one would call - a bare test Host has no console for that. +static Host* gpMidPassExportHost = nullptr; +static QString gMidPassExportPath; +static QString gMidPassExportedXml; + +static int exportProfileMidPass(lua_State* L) +{ + Q_UNUSED(L) + gMidPassExportedXml.clear(); + if (!gpMidPassExportHost) { + return 0; + } + auto writer = std::make_shared<XMLexport>(gpMidPassExportHost); + // variables included: the only export here that builds the variable tree, + // and it does so with a Lua call frame live + if (!writer->exportPackage(gMidPassExportPath, true, false)) { + qWarning() << "exportProfileMidPass() - the export itself failed"; + return 0; + } + QFile file(gMidPassExportPath); + if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) { + qWarning() << "exportProfileMidPass() - could not read back" << gMidPassExportPath; + return 0; + } + gMidPassExportedXml = QString::fromUtf8(file.readAll()); + file.close(); + QFile::remove(gMidPassExportPath); + return 0; +} + class PackageSelfUninstallTest : public QObject { Q_OBJECT @@ -99,6 +156,7 @@ private slots: // NB: mLoadedOk is left false on purpose - the deferred saveProfile() // that uninstallPackage() schedules then declines to run, which this // console-less test Host could not service anyway. + createKeeperItems(); } void cleanupTestCase() @@ -257,6 +315,344 @@ private slots: // save would serialize it back in: QVERIFY2(!mpHost->getTimerUnit()->findFirstTimer(qsl("selfUninstallTimer")), "uninstalled package timer is still registered"); } + + // The trigger route, driven the whole way: the package's own trigger fires, + // uninstalls its package and saves, all inside the pass. Its export is the + // only one here that includes the variables, so it doubles as the check that + // the variable tree can be built from inside a live Lua call frame. + void test_saveFromTriggerScriptDoesNotResurrectItsPackage() + { + const QString packageName = qsl("resurrect-trigger"); + mpHost->mInstalledPackages << packageName; + + gpMidPassExportHost = mpHost; + gMidPassExportPath = qsl("%1/mid-pass-export.xml").arg(mConfigDir.path()); + lua_State* L = mpHost->mLuaInterpreter.getLuaGlobalState(); + lua_register(L, "qaExportProfileMidPass", exportProfileMidPass); + QCOMPARE(luaL_dostring(L, "midPassSavedVar = 'saved from inside the pass'"), 0); + mpHost->getLuaInterface()->getVarUnit()->savedVars.insert(qsl("midPassSavedVar")); + + auto pGroup = new TTrigger(nullptr, mpHost); + pGroup->setIsFolder(true); + pGroup->registerTrigger(); + pGroup->setName(qsl("resurrectTriggerGroup")); + pGroup->mPackageName = packageName; + pGroup->setIsActive(true); + + auto pKicker = new TTrigger(pGroup, mpHost); + pKicker->setRegexCodeList({qsl("^resurrect me$")}, {REGEX_PERL}); + pKicker->registerTrigger(); + QVERIFY2(pKicker->setScript(qsl("uninstallPackage(\"%1\")\nqaExportProfileMidPass()").arg(packageName)), "trigger script failed to compile"); + pKicker->setName(qsl("resurrectTriggerKicker")); + pKicker->setIsActive(true); + + // a sibling that never runs: the whole group must go, not just the one + // that fired + auto pBystander = new TTrigger(pGroup, mpHost); + pBystander->setRegexCodeList({qsl("^never matched$")}, {REGEX_PERL}); + pBystander->registerTrigger(); + pBystander->setName(qsl("resurrectTriggerBystander")); + pBystander->setIsActive(true); + + QVERIFY2(exportedProfileXml().contains(qsl("resurrectTriggerGroup")), "the trigger group should be in the profile before its package is uninstalled"); + + mpHost->getTriggerUnit()->processDataStream(qsl("resurrect me"), -1); + + QVERIFY2(!mpHost->mInstalledPackages.contains(packageName), "package was not uninstalled"); + QVERIFY2(!gMidPassExportedXml.isEmpty(), "the mid-pass export produced nothing to check"); + QVERIFY2(!gMidPassExportedXml.contains(qsl("resurrectTriggerGroup")), "a save taken mid-pass wrote the uninstalled package's trigger group back into the profile"); + QVERIFY2(!gMidPassExportedXml.contains(qsl("resurrectTriggerKicker")), "a save taken mid-pass wrote the uninstalled package's trigger back into the profile"); + QVERIFY2(!gMidPassExportedXml.contains(qsl("resurrectTriggerBystander")), "a save taken mid-pass wrote the uninstalled package's trigger back into the profile"); + const QString keeperError = keepersMissingFrom(gMidPassExportedXml); + QVERIFY2(keeperError.isEmpty(), qPrintable(keeperError)); + QVERIFY2(gMidPassExportedXml.contains(qsl("saved from inside the pass")), "the variables were not read out of Lua by a save taken from inside a script"); + + QVERIFY2(mpHost->getTriggerUnit()->findItems(qsl("resurrectTriggerKicker")).empty(), "uninstalled trigger is still registered"); + + mpHost->getLuaInterface()->getVarUnit()->savedVars.remove(qsl("midPassSavedVar")); + gpMidPassExportHost = nullptr; + } + + // The alias route: a package shipping its own "uninstall" alias. + void test_saveFromAliasScriptDoesNotResurrectItsPackage() + { + const QString packageName = qsl("resurrect-alias"); + mpHost->mInstalledPackages << packageName; + + gpMidPassExportHost = mpHost; + gMidPassExportPath = qsl("%1/mid-pass-alias-export.xml").arg(mConfigDir.path()); + lua_register(mpHost->mLuaInterpreter.getLuaGlobalState(), "qaExportProfileMidPass", exportProfileMidPass); + + auto pAlias = new TAlias(qsl("resurrectAlias"), mpHost); + pAlias->setRegexCode(qsl("^resurrect me$")); + mpHost->getAliasUnit()->registerAlias(pAlias); + pAlias->mPackageName = packageName; + QVERIFY2(pAlias->setScript(qsl("uninstallPackage(\"%1\")\nqaExportProfileMidPass()").arg(packageName)), "alias script failed to compile"); + pAlias->setIsActive(true); + + QVERIFY2(exportedProfileXml().contains(qsl("resurrectAlias")), "the alias should be in the profile before its package is uninstalled"); + + mpHost->getAliasUnit()->processDataStream(qsl("resurrect me")); + + QVERIFY2(!mpHost->mInstalledPackages.contains(packageName), "package was not uninstalled"); + QVERIFY2(!gMidPassExportedXml.isEmpty(), "the mid-pass export produced nothing to check"); + QVERIFY2(!gMidPassExportedXml.contains(qsl("resurrectAlias")), "a save taken mid-pass wrote the uninstalled package's alias back into the profile"); + const QString keeperError = keepersMissingFrom(gMidPassExportedXml); + QVERIFY2(keeperError.isEmpty(), qPrintable(keeperError)); + + QVERIFY2(!mpHost->getAliasUnit()->findFirstAlias(qsl("resurrectAlias")), "uninstalled alias is still registered"); + gpMidPassExportHost = nullptr; + } + + // The timer route. beginProcessing()/endProcessing() below are the calls + // TTimer::execute() wraps its whole callback in. + void test_saveDuringTimerCallbackDoesNotResurrectItsPackage() + { + const QString packageName = qsl("resurrect-timer"); + mpHost->mInstalledPackages << packageName; + + auto pTimer = new TTimer(qsl("resurrectTimer"), QTime(0, 0, 30), mpHost); + mpHost->getTimerUnit()->registerTimer(pTimer); + pTimer->mPackageName = packageName; + QVERIFY2(pTimer->setScript(qsl("local noop = true\n")), "timer script failed to compile"); + + QVERIFY2(exportedProfileXml().contains(qsl("resurrectTimer")), "the timer should be in the profile before its package is uninstalled"); + + QString xml; + { + mpHost->getTimerUnit()->beginProcessing(); + // a failed QVERIFY returns from the slot; a level left on would + // wedge every later test's doCleanup() + const auto depthGuard = qScopeGuard([this]() { + mpHost->getTimerUnit()->endProcessing(); + mpHost->getTimerUnit()->doCleanup(); + }); + QVERIFY(mpHost->uninstallPackage(packageName, enums::PackageModuleType::Package)); + xml = exportedProfileXml(); + } + + QVERIFY2(!xml.isEmpty(), "the export produced nothing to check"); + QVERIFY2(!xml.contains(qsl("resurrectTimer")), "a save taken during a timer callback wrote the uninstalled package's timer back into the profile"); + const QString keeperError = keepersMissingFrom(xml); + QVERIFY2(keeperError.isEmpty(), qPrintable(keeperError)); + QVERIFY2(!mpHost->getTimerUnit()->findFirstTimer(qsl("resurrectTimer")), "uninstalled timer is still registered"); + } + + // The button route: TAction::execute() holds ActionUnit's depth the same way. + void test_saveDuringButtonScriptDoesNotResurrectItsPackage() + { + const QString packageName = qsl("resurrect-action"); + mpHost->mInstalledPackages << packageName; + + auto pAction = new TAction(qsl("resurrectAction"), mpHost); + mpHost->getActionUnit()->registerAction(pAction); + pAction->mPackageName = packageName; + QVERIFY2(pAction->setScript(qsl("local noop = true\n")), "button script failed to compile"); + + QVERIFY2(exportedProfileXml().contains(qsl("resurrectAction")), "the button should be in the profile before its package is uninstalled"); + + QString xml; + { + mpHost->getActionUnit()->beginProcessing(); + const auto depthGuard = qScopeGuard([this]() { + mpHost->getActionUnit()->endProcessing(); + mpHost->getActionUnit()->doCleanup(); + }); + QVERIFY(mpHost->uninstallPackage(packageName, enums::PackageModuleType::Package)); + xml = exportedProfileXml(); + } + + QVERIFY2(!xml.isEmpty(), "the export produced nothing to check"); + QVERIFY2(!xml.contains(qsl("resurrectAction")), "a save taken during a button script wrote the uninstalled package's button back into the profile"); + const QString keeperError = keepersMissingFrom(xml); + QVERIFY2(keeperError.isEmpty(), qPrintable(keeperError)); + QVERIFY2(!mpHost->getActionUnit()->findAction(qsl("resurrectAction")), "uninstalled button is still registered"); + } + + // The event-handler route: Host::raiseEvent() holds ScriptUnit's depth. + void test_saveDuringEventDispatchDoesNotResurrectItsPackage() + { + const QString packageName = qsl("resurrect-script"); + mpHost->mInstalledPackages << packageName; + + auto pScript = new TScript(nullptr, mpHost); + mpHost->getScriptUnit()->registerScript(pScript); + pScript->mPackageName = packageName; + pScript->setName(qsl("resurrectScript")); + QVERIFY2(pScript->setScript(qsl("local noop = true\n")), "script failed to compile"); + + QVERIFY2(exportedProfileXml().contains(qsl("resurrectScript")), "the script should be in the profile before its package is uninstalled"); + + QString xml; + { + mpHost->getScriptUnit()->beginProcessing(); + const auto depthGuard = qScopeGuard([this]() { + mpHost->getScriptUnit()->endProcessing(); + mpHost->getScriptUnit()->doCleanup(); + }); + QVERIFY(mpHost->uninstallPackage(packageName, enums::PackageModuleType::Package)); + xml = exportedProfileXml(); + } + + QVERIFY2(!xml.isEmpty(), "the export produced nothing to check"); + QVERIFY2(!xml.contains(qsl("resurrectScript")), "a save taken during an event dispatch wrote the uninstalled package's script back into the profile"); + const QString keeperError = keepersMissingFrom(xml); + QVERIFY2(keeperError.isEmpty(), qPrintable(keeperError)); + QVERIFY2(mpHost->getScriptUnit()->findItems(qsl("resurrectScript")).empty(), "uninstalled script is still registered"); + } + + // Host::reloadModule() - reachable from Lua - uninstalls and reinstalls a + // module back to back, so from a script the old items are still registered + // when the new ones arrive. + void test_moduleSaveDuringReloadDoesNotDuplicateItsItems() + { + const QString moduleName = qsl("resurrect-module"); + registerModuleAs(moduleName); + QVERIFY2(importModuleTimerNamed(moduleName, qsl("moduleTimerBeforeReload")), "could not import the module's timer"); + + QVERIFY2(exportedModuleXml(moduleName).contains(qsl("moduleTimerBeforeReload")), "the module's timer should be in its file before the reload"); + + QString xml; + { + mpHost->getTimerUnit()->beginProcessing(); + const auto depthGuard = qScopeGuard([this]() { + mpHost->getTimerUnit()->endProcessing(); + mpHost->getTimerUnit()->doCleanup(); + }); + // the uninstall half: at depth the old timer only gets deactivated + QVERIFY(mpHost->uninstallPackage(moduleName, enums::PackageModuleType::ModuleSync)); + // ... and the reinstall half brings the module back with fresh items + registerModuleAs(moduleName); + QVERIFY2(importModuleTimerNamed(moduleName, qsl("moduleTimerAfterReload")), "could not re-import the module's timer"); + + xml = exportedModuleXml(moduleName); + } + + QVERIFY2(!xml.isEmpty(), "the module export produced nothing to check"); + QVERIFY2(xml.contains(qsl("moduleTimerAfterReload")), "the reloaded module's timer must be written to its file"); + QVERIFY2(!xml.contains(qsl("moduleTimerBeforeReload")), "a module save taken mid-reload wrote the pre-reload copy of the timer back into the module file"); + } + +private: + // Items of a package that is never uninstalled. Every other assertion here + // is an absence, so without these an over-broad filter passes the whole file + // while emptying the user's profile. + void createKeeperItems() + { + const QString keeperPackage = qsl("keeper-package"); + mpHost->mInstalledPackages << keeperPackage; + + auto pTrigger = new TTrigger(nullptr, mpHost); + pTrigger->setRegexCodeList({qsl("^never matched$")}, {REGEX_PERL}); + pTrigger->registerTrigger(); + pTrigger->setName(qsl("keeperTrigger")); + pTrigger->mPackageName = keeperPackage; + + auto pAlias = new TAlias(qsl("keeperAlias"), mpHost); + pAlias->setRegexCode(qsl("^never matched$")); + mpHost->getAliasUnit()->registerAlias(pAlias); + pAlias->mPackageName = keeperPackage; + + auto pTimer = new TTimer(qsl("keeperTimer"), QTime(0, 0, 30), mpHost); + mpHost->getTimerUnit()->registerTimer(pTimer); + pTimer->mPackageName = keeperPackage; + + auto pAction = new TAction(qsl("keeperAction"), mpHost); + mpHost->getActionUnit()->registerAction(pAction); + pAction->mPackageName = keeperPackage; + + auto pScript = new TScript(nullptr, mpHost); + mpHost->getScriptUnit()->registerScript(pScript); + pScript->setName(qsl("keeperScript")); + pScript->mPackageName = keeperPackage; + } + + QString keepersMissingFrom(const QString& xml) const + { + for (const auto& name : {qsl("keeperTrigger"), qsl("keeperAlias"), qsl("keeperTimer"), qsl("keeperAction"), qsl("keeperScript")}) { + if (!xml.contains(name)) { + return qsl("a save taken while a delete was outstanding dropped \"%1\", which belongs to a package that is still installed").arg(name); + } + } + return {}; + } + + void registerModuleAs(const QString& moduleName) + { + mpHost->mInstalledModules[moduleName] = QStringList{qsl("%1/%2.xml").arg(mConfigDir.path(), moduleName), qsl("0")}; + mpHost->mModulesLoadedOk << moduleName; + } + + // The module-member flag is private to XMLimport, so a genuine module item + // can only be made by importing one: that creates the module's master folder + // per unit, and renaming the timer's tells the two copies apart. + bool importModuleTimerNamed(const QString& moduleName, const QString& itemName) + { + const QString path = qsl("%1/%2-import.xml").arg(mConfigDir.path(), itemName); + auto* pSeed = new TTimer(itemName, QTime(0, 0, 30), mpHost); + mpHost->getTimerUnit()->registerTimer(pSeed); + pSeed->setScript(qsl("local noop = true\n")); + const bool exported = XMLexport(pSeed).exportTimer(path); + mpHost->getTimerUnit()->unregisterTimer(pSeed); + delete pSeed; + if (!exported) { + return false; + } + + QFile file(path); + if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) { + return false; + } + XMLimport importer(mpHost); + const bool imported = importer.importPackage(&file, moduleName, 1).first; + file.close(); + QFile::remove(path); + if (!imported) { + return false; + } + TTimer* pTimer = mpHost->getTimerUnit()->findFirstTimer(moduleName); + if (!pTimer) { + return false; + } + pTimer->setName(itemName); + return true; + } + + // Builds the document writeModuleXML() produces for a save and reads it back. + QString exportedModuleXml(const QString& moduleName) + { + const QString path = qsl("%1/module-export.xml").arg(mConfigDir.path()); + XMLexport writer(mpHost); + writer.writeModuleXML(moduleName); + if (!XMLexport::saveXmlDocToFile(path, *writer.cloneExportDocument())) { + return {}; + } + return readBack(path); + } + + // The writers a profile save uses, without the console Host::saveProfile() + // would need. + QString exportedProfileXml() + { + const QString path = qsl("%1/profile-export.xml").arg(mConfigDir.path()); + auto writer = std::make_shared<XMLexport>(mpHost); + if (!writer->exportPackage(path, true, true)) { + return {}; + } + return readBack(path); + } + + static QString readBack(const QString& path) + { + QFile file(path); + if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) { + return {}; + } + const QString xml = QString::fromUtf8(file.readAll()); + file.close(); + QFile::remove(path); + return xml; + } }; void initializeQRCResourcesForPackageSelfUninstallTest() diff --git a/test/functional_tests/XMLexportVariablesTest.cpp b/test/functional_tests/XMLexportVariablesTest.cpp index 34e636151..8a2cdb9c4 100644 --- a/test/functional_tests/XMLexportVariablesTest.cpp +++ b/test/functional_tests/XMLexportVariablesTest.cpp @@ -40,8 +40,11 @@ #include "XMLexport.h" #include "ctelnet.h" #include "dlgConnectionProfiles.h" +#include "dlgTriggerEditor.h" #include "mudlet.h" +#include <QTreeWidget> + extern "C" { #if defined(INCLUDE_VERSIONED_LUA_HEADERS) #include <lua5.1/lauxlib.h> @@ -68,6 +71,7 @@ class XMLexportVariablesTest : public QObject private: TelnetServerStub* mpServer = nullptr; Host* mpHost = nullptr; + dlgTriggerEditor* mpEditor = nullptr; const QString mHostname = "XMLexportVars-Test"; const QString mLocalhost = "localhost"; @@ -95,6 +99,7 @@ private slots: void cleanupTestCase() { + mpEditor = nullptr; mpHost = nullptr; delete mpServer; mpServer = nullptr; @@ -107,6 +112,10 @@ private slots: // must still be written out - the save path has to refresh the tree. void test_lateCreatedSavedVariableIsExported() { + // QTest runs slots in declaration order and these stand for a profile + // whose Variables view was never opened. Profile load builds the editor + // dialog itself, so what matters is that no slot has shown it yet. + QVERIFY2(!mpEditor, "a Variables-view test was declared before the ones that must run without it"); LuaInterface* lI = mpHost->getLuaInterface(); VarUnit* vu = lI->getVarUnit(); // build the tree directly, standing in for the initial build that @@ -387,7 +396,161 @@ private slots: vu->removeHidden(qsl("userHiddenPrefVar")); } + // VarUnit has two hidden sets: hiddenByUser, and hidden, which + // Host::hideMudletsVariables() fills with Mudlet's own Lua API. Both have to + // reach the export's tree or a saved table drags the internals into the XML. + void test_internallyHiddenMemberOfSavedTableIsNotExported() + { + LuaInterface* lI = mpHost->getLuaInterface(); + VarUnit* vu = lI->getVarUnit(); + lua_State* L = mpHost->mLuaInterpreter.getLuaGlobalState(); + QCOMPARE(luaL_dostring(L, "internalHiddenTable = {plainMember = 'plain member value', internalMember = 'internal member value'}"), 0); + vu->savedVars.insert(qsl("internalHiddenTable")); + // what addHidden(TVar*, 0) records - the non-user half of the pair + vu->hidden.insert(qsl("internalHiddenTable.internalMember")); + + const QString xml = exportProfileXml(); + QVERIFY(!xml.isEmpty()); + QVERIFY2(xml.contains(qsl("plain member value")), "a plain member of a saved table must be exported"); + QVERIFY2(!xml.contains(qsl("internal member value")), "a member hidden by Mudlet itself must not ride along with its saved table"); + + vu->savedVars.remove(qsl("internalHiddenTable")); + vu->hidden.remove(qsl("internalHiddenTable.internalMember")); + QCOMPARE(luaL_dostring(L, "internalHiddenTable = nil"), 0); + } + + // A variable tree takes a Lua registry reference per reference-keyed entry. + // The export throws its tree away, so if the references went with it the + // registry would grow by that many slots on every save. + void test_exportDoesNotLeakLuaRegistryReferences() + { + lua_State* L = mpHost->mLuaInterpreter.getLuaGlobalState(); + // several reference-keyed members, so a leak grows the registry visibly + QCOMPARE(luaL_dostring(L, "refKeyLeakTable = {} for i = 1, 20 do refKeyLeakTable[{}] = i end"), 0); + + // freed slots go on a free list and come straight back out, so the + // number stops climbing once the registry fits one pass's worth. + // Measuring after the first export leaves that one-off growth out. + QVERIFY(!exportProfileXml().isEmpty()); + lua_pushboolean(L, 1); + const int refAfterOne = luaL_ref(L, LUA_REGISTRYINDEX); + luaL_unref(L, LUA_REGISTRYINDEX, refAfterOne); + + for (int i = 0; i < 5; ++i) { + QVERIFY(!exportProfileXml().isEmpty()); + } + + lua_pushboolean(L, 1); + const int refAfterSix = luaL_ref(L, LUA_REGISTRYINDEX); + luaL_unref(L, LUA_REGISTRYINDEX, refAfterSix); + + // five more exports keeping 20 references each would put this 100 higher + QVERIFY2(refAfterSix < refAfterOne + 20, + qPrintable(qsl("the exports pinned Lua registry slots: a reference taken after one export was %1, one taken after six was %2").arg(refAfterOne).arg(refAfterSix))); + + QCOMPARE(luaL_dostring(L, "refKeyLeakTable = nil"), 0); + } + + // A script adds to a saved table while the editor sits on the Variables + // view. A session's last save is taken with whatever view was left on + // screen, so quitting from there is enough to reach this. + void test_savedTableMemberIsExportedWithVariablesViewOpen() + { + QVERIFY2(showEditorOnVariablesView(), "the script editor could not be opened on the Variables view"); + + LuaInterface* lI = mpHost->getLuaInterface(); + VarUnit* vu = lI->getVarUnit(); + lua_State* L = mpHost->mLuaInterpreter.getLuaGlobalState(); + QCOMPARE(luaL_dostring(L, "varsViewTable = {seedMember = 'seed member value'}"), 0); + vu->savedVars.insert(qsl("varsViewTable")); + vu->savedVars.insert(qsl("varsViewTable.seedMember")); + mpEditor->repopulateVars(); + + // a script running afterwards, with the view still up + QCOMPARE(luaL_dostring(L, "varsViewTable.lateMember = 'late member value'"), 0); + QCOMPARE(luaL_dostring(L, "varsViewTable.seedMember = nil"), 0); + + const QString xml = exportProfileXml(); + QVERIFY(!xml.isEmpty()); + QVERIFY2(xml.contains(qsl("late member value")), "a member added while the Variables view was open must still be saved"); + // secondary: writeVariable() re-reads values from Lua, so a stale tree + // writes this one out empty rather than with its old value + QVERIFY2(!xml.contains(qsl("seed member value")), "a member a script removed while the Variables view was open must not be saved back"); + + auto* pVariablesTree = mpEditor->findChild<QTreeWidget*>(qsl("treeWidget_variables")); + QVERIFY2(pVariablesTree, "the editor has no variables tree widget"); + QTreeWidgetItem* pBaseItem = pVariablesTree->topLevelItem(0); + QVERIFY2(pBaseItem && pBaseItem->childCount() > 0, "the Variables view did not populate"); + QVERIFY2(vu->getWVar(pBaseItem->child(0)), "a save taken with the Variables view on screen must leave its items resolving to their variables"); + + vu->savedVars.remove(qsl("varsViewTable")); + vu->savedVars.remove(qsl("varsViewTable.seedMember")); + QCOMPARE(luaL_dostring(L, "varsViewTable = nil"), 0); + } + + // ... and the same for a whole variable rather than a table member. + void test_lateSavedVariableIsExportedWithVariablesViewOpen() + { + QVERIFY2(showEditorOnVariablesView(), "the script editor could not be opened on the Variables view"); + + LuaInterface* lI = mpHost->getLuaInterface(); + VarUnit* vu = lI->getVarUnit(); + mpEditor->repopulateVars(); + + lua_State* L = mpHost->mLuaInterpreter.getLuaGlobalState(); + QCOMPARE(luaL_dostring(L, "varsViewLateVar = 'late variable value'"), 0); + vu->savedVars.insert(qsl("varsViewLateVar")); + + const QString xml = exportProfileXml(); + QVERIFY(!xml.isEmpty()); + QVERIFY2(xml.contains(qsl("late variable value")), "a saved variable created while the Variables view was open must still be saved"); + + vu->savedVars.remove(qsl("varsViewLateVar")); + QCOMPARE(luaL_dostring(L, "varsViewLateVar = nil"), 0); + } + + // The other side: a save must not pull the tree out from under the editor. + // Its tree widget and search results resolve items through VarUnit's + // item -> TVar map, which rebuilding the shared tree empties. + void test_variablesEditorItemMappingSurvivesExport() + { + QVERIFY2(showEditorOnVariablesView(), "the script editor could not be opened on the Variables view"); + mpEditor->repopulateVars(); + + VarUnit* vu = mpHost->getLuaInterface()->getVarUnit(); + auto* pVariablesTree = mpEditor->findChild<QTreeWidget*>(qsl("treeWidget_variables")); + QVERIFY2(pVariablesTree, "the editor has no variables tree widget"); + QTreeWidgetItem* pBaseItem = pVariablesTree->topLevelItem(0); + QVERIFY2(pBaseItem && pBaseItem->childCount() > 0, "the Variables view did not populate"); + QTreeWidgetItem* pVariableItem = pBaseItem->child(0); + TVar* pMappedBefore = vu->getWVar(pVariableItem); + QVERIFY2(pMappedBefore, "the Variables view's items should resolve to a variable"); + + // any save does it: the Save Profile button, the autosave, a package change + mpEditor->slot_showTriggers(); + QVERIFY(!exportProfileXml().isEmpty()); + + QVERIFY2(vu->getWVar(pVariableItem) == pMappedBefore, "a profile save must leave the Variables editor's items resolving to their variables"); + } + private: + // Returns false rather than asserting: a QVERIFY here would only return from + // this helper, leaving the caller to dereference a null editor. + bool showEditorOnVariablesView() + { + if (!mpEditor) { + mudlet::self()->slot_showScriptDialog(); + QTest::qWait(100); + mpEditor = mpHost->mpEditorDialog; + if (!mpEditor) { + return false; + } + } + mpEditor->slot_showVariables(); + QTest::qWait(50); + return true; + } + QString exportProfileXml() { const QString xmlPath = mudlet::getMudletPath(enums::profileHomePath, mHostname) + qsl("/xmlexport-test.xml"); From 8a8325a6affa3e2cc8e5009f2f0b85761652e9dd Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Fri, 7 Aug 2026 10:15:11 +0200 Subject: [PATCH 118/155] fix: three full-window background bugs - vanishing console, lost border colour, huge cover scaling (#9711) #### Brief overview of PR changes/additions - `lowerWindow()` moved the main display below the full-window background widget, so with a background set the whole console (text, split, scrollbar, command line) vanished for the rest of the session; it now keeps the background bottom-most. - `setBorderColor` lived only in `mpMainFrame`'s palette, which `changeColors()` rebuilds from constants - a game sending an OSC palette change wiped it with no user action at all - and `getBorderColor()` returned `0,0,0` under a full-window background. The colour is now stored on the console. - `cover` mode scaled the whole source before cropping, so a 3000x100 image in a 1920x1080 window built a 32400x1080 (~140MB) intermediate on every resize event; it now crops to the target aspect first. Measured 133.5MB/15ms to 0.1MB/3ms, and 890MB for a 20000x100 source. #### Motivation for adding to Mudlet All three are in the 5.0 full-window background feature and the first one makes an ordinary `lowerWindow()` call blank the entire console. #### Other info (issues closed, discussion etc) Finding C10 of the 5.0 QA sweep. Introduced by `ae6b017c8` "add: full-window background image/gradient support" (#9394). `raiseWindow("main")` and `lowerWindow("main")` both return false today (`"main"` is never registered in any of the window maps), so there was no way to undo the first bug from a script - verified, not changed here. New `WindowBackgroundTest` (17 cases). Five of its assertions were confirmed to fail before the fix and pass after; the crop-then-scale order is pinned by comparing the installed brush against a crop-first render, which a scale-first implementation fails. Assisted-by: Claude:claude-opus-5 **Test case:** `setBackgroundImage("main", getMudletHomeDir().."/bg.png", "cover", true)` then `createLabel("l", 10, 10, 100, 100, 1)` then `lowerWindow("l")` - the console stays visible. --- src/TConsole.cpp | 72 ++- src/TConsole.h | 11 +- src/TLuaInterpreterUI.cpp | 12 +- src/TMainConsole.cpp | 12 +- test/functional_tests/CMakeLists.txt | 1 + .../functional_tests/WindowBackgroundTest.cpp | 435 ++++++++++++++++++ 6 files changed, 521 insertions(+), 22 deletions(-) create mode 100644 test/functional_tests/WindowBackgroundTest.cpp diff --git a/src/TConsole.cpp b/src/TConsole.cpp index 92eba15e4..53fa98510 100644 --- a/src/TConsole.cpp +++ b/src/TConsole.cpp @@ -1588,11 +1588,26 @@ bool TConsole::setWindowBackgroundImage(const QString& imgPath, int mode) if (mode == 5) { QPixmap pixmap(imgPath); if (pixmap.isNull()) { + qWarning().nospace().noquote() << "TConsole::setWindowBackgroundImage() ERROR - could not load \"" << imgPath << "\" as an image."; return false; } + const QPixmap previousSource = mWindowBgSourcePixmap; + const QString previousPath = mWindowBgImagePath; + const QString previousStyleSheet = mpWindowBackground->styleSheet(); mWindowBgSourcePixmap = pixmap; + mWindowBgImagePath = imgPath; + // clearing a stylesheet repolishes the widget and drops the palette brush, + // so it has to happen before the brush is installed mpWindowBackground->setStyleSheet(QString()); - updateWindowBackgroundCoverPixmap(); + if (!updateWindowBackgroundCoverPixmap()) { + mWindowBgSourcePixmap = previousSource; + mWindowBgImagePath = previousPath; + mpWindowBackground->setStyleSheet(previousStyleSheet); + // the failed attempt dropped the brush, so rebuild the one the previous + // source was showing rather than waiting for the next resize + updateWindowBackgroundCoverPixmap(); + return false; + } } else { const QColor bgColor = mpHost ? mpHost->mBgColor : QColorConstants::Black; const QString styleSheet = buildBackgroundImageStyleSheet(qsl("WindowBackground"), bgColor, mode, imgPath); @@ -1636,30 +1651,69 @@ void TConsole::updateMainFrameTransparency() QPalette framePalette; framePalette.setColor(QPalette::Text, QColor(Qt::black)); framePalette.setColor(QPalette::Highlight, QColor(55, 55, 255)); - framePalette.setColor(QPalette::Window, mWindowBgImageMode ? QColor(0, 0, 0, 0) : QColor(0, 0, 0, 255)); + framePalette.setColor(QPalette::Window, mWindowBgImageMode ? QColor(0, 0, 0, 0) : mBorderColor); mpMainFrame->setPalette(framePalette); mpMainFrame->setAutoFillBackground(true); } -// Simulates CSS "cover" since QT stylesheets do not support it -void TConsole::updateWindowBackgroundCoverPixmap() +void TConsole::setBorderColor(const QColor& color) +{ + mBorderColor = color; + updateMainFrameTransparency(); +} + +void TConsole::lowerMainDisplay() +{ + mpMainDisplay->lower(); + if (mpWindowBackground) { + mpWindowBackground->lower(); + } +} + +// The largest centred rectangle of the source that has the target's aspect ratio. +QRect TConsole::coverSourceRect(const QSize& sourceSize, const QSize& targetSize) +{ + QSize cropSize = targetSize; + cropSize.scale(sourceSize, Qt::KeepAspectRatio); + cropSize = cropSize.boundedTo(sourceSize).expandedTo(QSize(1, 1)); + return QRect(QPoint((sourceSize.width() - cropSize.width()) / 2, (sourceSize.height() - cropSize.height()) / 2), cropSize); +} + +// Simulates CSS "cover" since QT stylesheets do not support it. Crop first: the +// other order multiplies the intermediate by the aspect mismatch, so a 3000x100 +// image in a 1920x1080 window builds a 32400x1080 (~140MB) one on every resize. +bool TConsole::updateWindowBackgroundCoverPixmap() { if (!mpWindowBackground || mWindowBgSourcePixmap.isNull()) { - return; + return true; } const QSize targetSize = mpWindowBackground->size(); if (targetSize.isEmpty()) { - return; + return true; } - const QPixmap scaled = mWindowBgSourcePixmap.scaled(targetSize, Qt::KeepAspectRatioByExpanding, Qt::SmoothTransformation); - const QRect cropRect(qMax(0, (scaled.width() - targetSize.width()) / 2), qMax(0, (scaled.height() - targetSize.height()) / 2), targetSize.width(), targetSize.height()); + const QRect sourceRect = coverSourceRect(mWindowBgSourcePixmap.size(), targetSize); + const QPixmap cropped = (sourceRect == mWindowBgSourcePixmap.rect()) ? mWindowBgSourcePixmap : mWindowBgSourcePixmap.copy(sourceRect); + const QPixmap scaled = cropped.scaled(targetSize, Qt::IgnoreAspectRatio, Qt::SmoothTransformation); + if (scaled.isNull()) { + if (!mWindowBgCoverScaleFailed) { + mWindowBgCoverScaleFailed = true; + qWarning().nospace().noquote() << "TConsole::updateWindowBackgroundCoverPixmap() ERROR - could not scale \"" << mWindowBgImagePath << "\" (source area " << sourceRect << ") to " + << targetSize << '.'; + } + // a brush smaller than the widget tiles, so drop the stale one + mpWindowBackground->setAutoFillBackground(false); + mpWindowBackground->setPalette(QPalette()); + return false; + } + mWindowBgCoverScaleFailed = false; QPalette palette; - palette.setBrush(QPalette::Window, QBrush(scaled.copy(cropRect))); + palette.setBrush(QPalette::Window, QBrush(scaled)); mpWindowBackground->setPalette(palette); mpWindowBackground->setAutoFillBackground(true); + return true; } void TConsole::setCmdVisible(bool isVisible) diff --git a/src/TConsole.h b/src/TConsole.h index 3e53d047f..ba68cfc78 100644 --- a/src/TConsole.h +++ b/src/TConsole.h @@ -296,7 +296,12 @@ public: bool setWindowBackgroundImage(const QString&, int); bool resetWindowBackgroundImage(); void updateMainFrameTransparency(); - void updateWindowBackgroundCoverPixmap(); + // False only when a scale failed; no source or an unsized widget defers to the next resize + bool updateWindowBackgroundCoverPixmap(); + static QRect coverSourceRect(const QSize& sourceSize, const QSize& targetSize); + void setBorderColor(const QColor&); + QColor borderColor() const { return mBorderColor; } + void lowerMainDisplay(); void setLink(const QStringList& linkFunction, const QStringList& linkHint, const QVector<int> linkReference = QVector<int>()); // Cannot be called setAttributes as that would mask an inherited method void setDisplayAttributes(const TChar::AttributeFlags, const bool); @@ -498,6 +503,10 @@ private: // Whether to show (a 13 character by default) timestamp to the left of // each line of text: bool mShowTimeStamps = false; + // mpMainFrame's palette cannot hold this - it is rebuilt from scratch on every colour change + QColor mBorderColor = Qt::black; + // latches the 'cover' scale failure so a resize drag does not repeat the warning + bool mWindowBgCoverScaleFailed = false; }; Q_DECLARE_OPERATORS_FOR_FLAGS(TConsole::ConsoleType) diff --git a/src/TLuaInterpreterUI.cpp b/src/TLuaInterpreterUI.cpp index 79e51dbdf..a28704d4b 100644 --- a/src/TLuaInterpreterUI.cpp +++ b/src/TLuaInterpreterUI.cpp @@ -1257,7 +1257,7 @@ int TLuaInterpreter::getBorderTop(lua_State* L) int TLuaInterpreter::getBorderColor(lua_State* L) { const Host& host = getHostFromLua(L); - const QColor color = host.mpConsole->mpMainFrame->palette().color(QPalette::Window); + const QColor color = host.mpConsole->borderColor(); lua_pushnumber(L, color.red()); lua_pushnumber(L, color.green()); lua_pushnumber(L, color.blue()); @@ -2702,6 +2702,10 @@ int TLuaInterpreter::setBackgroundImage(lua_State* L) Host* host = &getHostFromLua(L); if (!host->setBackgroundImage(windowName, imgPath, mode, fullWindow)) { + if (fullWindow) { + // the console name is already validated above, so this is about the image + return warnArgumentValue(L, __func__, qsl("could not use '%1' as a full window background image").arg(imgPath)); + } return warnArgumentValue(L, __func__, qsl("console or label '%1' not found").arg(windowName)); } @@ -2800,11 +2804,7 @@ int TLuaInterpreter::setBorderColor(lua_State* L) const int luaGreen = getVerifiedInt(L, __func__, 2, "green"); const int luaBlue = getVerifiedInt(L, __func__, 3, "blue"); const Host& host = getHostFromLua(L); - QPalette framePalette; - framePalette.setColor(QPalette::Text, QColor(Qt::black)); - framePalette.setColor(QPalette::Highlight, QColor(55, 55, 255)); - framePalette.setColor(QPalette::Window, QColor(luaRed, luaGreen, luaBlue, 255)); - host.mpConsole->mpMainFrame->setPalette(framePalette); + host.mpConsole->setBorderColor(QColor(luaRed, luaGreen, luaBlue)); return 0; } diff --git a/src/TMainConsole.cpp b/src/TMainConsole.cpp index 73584563f..7485636c9 100644 --- a/src/TMainConsole.cpp +++ b/src/TMainConsole.cpp @@ -1137,32 +1137,32 @@ bool TMainConsole::lowerWindow(const QString& name) if (pC) { pC->lower(); - mpMainDisplay->lower(); + lowerMainDisplay(); return true; } if (pL) { pL->lower(); - mpMainDisplay->lower(); + lowerMainDisplay(); return true; } if (pM && !name.compare(QLatin1String("mapper"), Qt::CaseInsensitive)) { pM->lower(); - mpMainDisplay->lower(); + lowerMainDisplay(); return true; } if (pS) { pS->lower(); - mpMainDisplay->lower(); + lowerMainDisplay(); return true; } if (pN) { pN->lower(); - mpMainDisplay->lower(); + lowerMainDisplay(); return true; } if (pT) { pT->lower(); - mpMainDisplay->lower(); + lowerMainDisplay(); return true; } return false; diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index 24b7d880c..0a759ecfd 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -54,6 +54,7 @@ set(FUNCTIONAL_TEST_SOURCES DefaultPackagesTest.cpp ProfileSwitchShortcutTest.cpp ExperiencedPlayerGateTest.cpp + WindowBackgroundTest.cpp EmbeddedMapperCreationTest.cpp ) diff --git a/test/functional_tests/WindowBackgroundTest.cpp b/test/functional_tests/WindowBackgroundTest.cpp new file mode 100644 index 000000000..253822177 --- /dev/null +++ b/test/functional_tests/WindowBackgroundTest.cpp @@ -0,0 +1,435 @@ +/*************************************************************************** + * Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +#include <QSignalSpy> +#include <QtTest/QtTest> +#include <chrono> + +#include "Host.h" +#include "MudletInstanceCoordinator.h" +#include "TLabel.h" +#include "TLuaInterpreter.h" +#include "TMainConsole.h" +#include "TelnetServerStub.h" +#include "ctelnet.h" +#include "dlgConnectionProfiles.h" +#include "mudlet.h" + +extern "C" { +#if defined(INCLUDE_VERSIONED_LUA_HEADERS) +#include <lua5.1/lua.h> +#else +#include <lua.h> +#endif +} + +using namespace std::chrono_literals; + +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); +void initializeQRCResourcesForWindowBackgroundTest(); + +// Covers the full-window background feature added in #9394. +class WindowBackgroundTest : public QObject +{ + Q_OBJECT + +private: + TelnetServerStub* mpServer = nullptr; + Host* mpHost = nullptr; + const QString mHostname = "WindowBackground-Test-Host"; + QString mPort; + const QString mLocalhost = "localhost"; + QTemporaryDir mImageDir; + + // a pattern rather than a flat fill, so that resampling differences show up + QString writeImage(const QString& fileName, const QSize& size, const QColor& seed) + { + QImage image(size, QImage::Format_ARGB32); + for (int y = 0; y < size.height(); ++y) { + for (int x = 0; x < size.width(); ++x) { + image.setPixel(x, y, qRgb((seed.red() + x * 7) % 256, (seed.green() + y * 13) % 256, (seed.blue() + (x + y) * 3) % 256)); + } + } + const QString path = mImageDir.filePath(fileName); + if (!image.save(path, "PNG")) { + return QString(); + } + return path; + } + + void runLua(const QString& script) { QVERIFY2(mpHost->getLuaInterpreter()->compileAndExecuteScript(script), qPrintable(script)); } + + int luaInt(const QString& global) + { + lua_State* L = mpHost->mLuaInterpreter.getLuaGlobalState(); + lua_getglobal(L, global.toUtf8().constData()); + const int value = static_cast<int>(lua_tointeger(L, -1)); + lua_pop(L, 1); + return value; + } + + QString luaString(const QString& global) + { + lua_State* L = mpHost->mLuaInterpreter.getLuaGlobalState(); + lua_getglobal(L, global.toUtf8().constData()); + const QString value = QString::fromUtf8(lua_tostring(L, -1)); + lua_pop(L, 1); + return value; + } + + bool luaNil(const QString& global) + { + lua_State* L = mpHost->mLuaInterpreter.getLuaGlobalState(); + lua_getglobal(L, global.toUtf8().constData()); + const bool value = lua_isnil(L, -1); + lua_pop(L, 1); + return value; + } + + int stackIndex(const QWidget* widget) const { return mpHost->mpConsole->mpMainFrame->children().indexOf(widget); } + + void verifyStackedBelow(const QWidget* lower, const QWidget* upper, const char* message) + { + QVERIFY(lower); + QVERIFY(upper); + const int lowerIndex = stackIndex(lower); + const int upperIndex = stackIndex(upper); + QVERIFY2(lowerIndex >= 0 && upperIndex >= 0, "a widget under test is not a child of mpMainFrame"); + QVERIFY2(lowerIndex < upperIndex, message); + } + + QPixmap installedBackgroundBrush() const { return mpHost->mpConsole->mpWindowBackground->palette().brush(QPalette::Window).texture(); } + +private slots: + void initTestCase() + { + initializeQRCResourcesForWindowBackgroundTest(); + + QVERIFY(mImageDir.isValid()); + + mpServer = new TelnetServerStub(qApp); + mpServer->start(mLocalhost, 0); + mPort = QString::number(mpServer->serverPort()); + mudlet::start(); + mudlet::self()->setupConfig(); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique<MudletInstanceCoordinator>("MudletInstanceCoordinator")); + mudlet::self()->init(); + mudlet::self()->setStorePasswordsSecurely(false); + + QDir(mudlet::getMudletPath(enums::profileHomePath, mHostname)).removeRecursively(); + + QTimer::singleShot(0ms, qApp, [this]() { + mudlet::self()->startAutoLogin({}); + QTest::qWait(100ms); + QTest::mouseClick(mudlet::self()->mpConnectionDialog->new_profile_button, Qt::LeftButton); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), mHostname); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), mLocalhost); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), mPort); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Return); + }); + + QSignalSpy spy(mudlet::self(), &mudlet::signal_profileLoaded); + if (!spy.wait(5000)) { + QFAIL("Profile took too long to load."); + } + mpHost = mudlet::self()->getActiveHost(); + if (!mpHost) { + QFAIL("No active host available for the test."); + } + + QSignalSpy spy2(&(mpHost->mTelnet), &cTelnet::signal_connected); + if (!spy2.wait(2000)) { + QFAIL("Could not connect with the host."); + } + + mudlet::self()->resize(1200, 800); + QTest::qWait(100ms); + } + + void cleanupTestCase() + { + delete mpServer; + mpServer = nullptr; + mpHost = nullptr; + const QString path = mudlet::getMudletPath(enums::profileHomePath, mHostname); + delete mudlet::self(); + QDir(path).removeRecursively(); + } + + void init() + { + QVERIFY(mpHost); + QVERIFY(mpHost->mpConsole); + QVERIFY(mpHost->mpConsole->mpWindowBackground); + runLua(qsl("resetBackgroundImage('main', true)")); + QCOMPARE(mpHost->mpConsole->mWindowBgImageMode, 0); + runLua(qsl("setBorderColor(0, 0, 0)")); + } + + // runs even when a QVERIFY aborts a test body, so nothing leaks into the next one + void cleanup() + { + mpHost->mpConsole->deleteLabel(qsl("lowerTarget")); + mpHost->mpConsole->deleteMiniConsole(qsl("lowerConsole")); + } + + // lowerWindow() drops mpMainDisplay to the bottom of mpMainFrame's stack so a + // lowered label still sits above the console - and the background is a sibling there. + void test_lowerWindowKeepsWindowBackgroundBottomMost() + { + const QString imagePath = writeImage(qsl("solid.png"), QSize(64, 64), Qt::red); + QVERIFY(!imagePath.isEmpty()); + + runLua(qsl("setBackgroundImage('main', [[%1]], 'cover', true)").arg(imagePath)); + QCOMPARE(mpHost->mpConsole->mWindowBgImageMode, 5); + + runLua(qsl("createLabel('lowerTarget', 10, 10, 100, 100, 1)")); + QVERIFY(mpHost->mpConsole->mLabelMap.contains(qsl("lowerTarget"))); + + runLua(qsl("lowerWindow('lowerTarget')")); + + verifyStackedBelow(mpHost->mpConsole->mpWindowBackground, mpHost->mpConsole->mpMainDisplay, "lowerWindow() left the full-window background painting on top of the main display"); + verifyStackedBelow(mpHost->mpConsole->mpMainDisplay, mpHost->mpConsole->mLabelMap.value(qsl("lowerTarget")), "lowerWindow() left the lowered label hidden behind the main display"); + } + + // The six branches of lowerWindow() are copy-pasted, so cover a second one. + void test_lowerWindowKeepsWindowBackgroundBottomMostForAMiniConsole() + { + const QString imagePath = writeImage(qsl("solidConsole.png"), QSize(64, 64), Qt::cyan); + QVERIFY(!imagePath.isEmpty()); + + runLua(qsl("setBackgroundImage('main', [[%1]], 'cover', true)").arg(imagePath)); + runLua(qsl("createMiniConsole('lowerConsole', 10, 10, 200, 100)")); + QVERIFY(mpHost->mpConsole->mSubConsoleMap.contains(qsl("lowerConsole"))); + + runLua(qsl("lowerWindow('lowerConsole')")); + + verifyStackedBelow(mpHost->mpConsole->mpWindowBackground, mpHost->mpConsole->mpMainDisplay, "lowerWindow() left the full-window background painting on top of the main display"); + } + + void test_lowerWindowOrderingHoldsWithoutABackgroundImage() + { + runLua(qsl("createLabel('lowerTarget', 10, 10, 100, 100, 1)")); + runLua(qsl("lowerWindow('lowerTarget')")); + + verifyStackedBelow(mpHost->mpConsole->mpWindowBackground, mpHost->mpConsole->mpMainDisplay, "lowerWindow() put the main display below the full-window background widget"); + verifyStackedBelow(mpHost->mpConsole->mpMainDisplay, mpHost->mpConsole->mLabelMap.value(qsl("lowerTarget")), "lowerWindow() left the lowered label hidden behind the main display"); + } + + // a game can reach changeColors() with no user action, through an OSC palette change + void test_borderColorSurvivesChangeColors() + { + runLua(qsl("setBorderColor(10, 20, 30)")); + QCOMPARE(mpHost->mpConsole->mpMainFrame->palette().color(QPalette::Window), QColor(10, 20, 30)); + + mpHost->mpConsole->changeColors(); + + QCOMPARE(mpHost->mpConsole->mpMainFrame->palette().color(QPalette::Window), QColor(10, 20, 30)); + QCOMPARE(mpHost->mpConsole->borderColor(), QColor(10, 20, 30)); + } + + void test_borderColorSurvivesSetBackgroundColor() + { + runLua(qsl("setBorderColor(40, 50, 60)")); + runLua(qsl("setBackgroundColor('main', 1, 2, 3, 255)")); + + QCOMPARE(mpHost->mpConsole->mpMainFrame->palette().color(QPalette::Window), QColor(40, 50, 60)); + } + + void test_borderColorReturnsAfterResettingTheBackground() + { + const QString imagePath = writeImage(qsl("reset.png"), QSize(64, 64), Qt::yellow); + QVERIFY(!imagePath.isEmpty()); + + runLua(qsl("setBorderColor(255, 0, 0)")); + runLua(qsl("setBackgroundImage('main', [[%1]], 'cover', true)").arg(imagePath)); + QCOMPARE(mpHost->mpConsole->mpMainFrame->palette().color(QPalette::Window).alpha(), 0); + + runLua(qsl("resetBackgroundImage('main', true)")); + + QCOMPARE(mpHost->mpConsole->mpMainFrame->palette().color(QPalette::Window), QColor(255, 0, 0)); + } + + void test_setBorderColorUnderAFullWindowBackgroundKeepsTheFrameTransparent() + { + const QString imagePath = writeImage(qsl("order.png"), QSize(64, 64), Qt::white); + QVERIFY(!imagePath.isEmpty()); + + runLua(qsl("setBackgroundImage('main', [[%1]], 'cover', true)").arg(imagePath)); + runLua(qsl("setBorderColor(11, 22, 33)")); + + QCOMPARE(mpHost->mpConsole->mpMainFrame->palette().color(QPalette::Window).alpha(), 0); + QCOMPARE(mpHost->mpConsole->borderColor(), QColor(11, 22, 33)); + } + + // the frame is transparent under a full-window background, so the palette cannot be the source + void test_getBorderColorReportsSetValueUnderFullWindowBackground() + { + const QString imagePath = writeImage(qsl("solid2.png"), QSize(64, 64), Qt::blue); + QVERIFY(!imagePath.isEmpty()); + + runLua(qsl("setBorderColor(70, 80, 90)")); + runLua(qsl("setBackgroundImage('main', [[%1]], 'cover', true)").arg(imagePath)); + runLua(qsl("borderR, borderG, borderB = getBorderColor()")); + + QCOMPARE(luaInt(qsl("borderR")), 70); + QCOMPARE(luaInt(qsl("borderG")), 80); + QCOMPARE(luaInt(qsl("borderB")), 90); + + QCOMPARE(mpHost->mpConsole->mpMainFrame->palette().color(QPalette::Window).alpha(), 0); + } + + void test_coverSourceRectNeverExceedsTheSourceImage() + { + const QVector<QSize> sourceSizes{{3000, 100}, {100, 3000}, {1920, 1080}, {64, 64}, {1, 4000}, {4000, 1}}; + const QVector<QSize> targetSizes{{1920, 1080}, {800, 600}, {1, 1}, {3840, 40}}; + + for (const QSize& source : sourceSizes) { + for (const QSize& target : targetSizes) { + const QRect crop = TConsole::coverSourceRect(source, target); + const QString context = qsl("source %1x%2 target %3x%4").arg(source.width()).arg(source.height()).arg(target.width()).arg(target.height()); + QVERIFY2(!crop.isEmpty(), qPrintable(context)); + QVERIFY2(QRect(QPoint(0, 0), source).contains(crop), qPrintable(context)); + } + } + } + + void test_coverSourceRectMatchesAspectPreservingCentreCrop() + { + const QRect wideSource = TConsole::coverSourceRect(QSize(3000, 100), QSize(1920, 1080)); + QCOMPARE(wideSource.height(), 100); + QCOMPARE(wideSource.width(), 177); + QCOMPARE(wideSource.center().x(), QRect(0, 0, 3000, 100).center().x()); + + const QRect tallSource = TConsole::coverSourceRect(QSize(100, 3000), QSize(1920, 1080)); + QCOMPARE(tallSource.width(), 100); + QCOMPARE(tallSource.height(), 56); + QCOMPARE(tallSource.center().y(), QRect(0, 0, 100, 3000).center().y()); + } + + void test_coverBrushMatchesWidgetSizeForExtremeAspectImage() + { + const QString imagePath = writeImage(qsl("wide.png"), QSize(3000, 100), Qt::green); + QVERIFY(!imagePath.isEmpty()); + + runLua(qsl("setBackgroundImage('main', [[%1]], 'cover', true)").arg(imagePath)); + + const QSize widgetSize = mpHost->mpConsole->mpWindowBackground->size(); + QVERIFY(!widgetSize.isEmpty()); + QCOMPARE(installedBackgroundBrush().size(), widgetSize); + } + + // the two orders resample differently, so this fails if the crop stops coming first + void test_coverBrushIsScaledFromTheCroppedSourceRegion() + { + const QSize sourceSize(3000, 100); + const QString imagePath = writeImage(qsl("order-wide.png"), sourceSize, Qt::darkGreen); + QVERIFY(!imagePath.isEmpty()); + + runLua(qsl("setBackgroundImage('main', [[%1]], 'cover', true)").arg(imagePath)); + + const QSize widgetSize = mpHost->mpConsole->mpWindowBackground->size(); + const QPixmap source(imagePath); + QCOMPARE(source.size(), sourceSize); + const QPixmap expected = source.copy(TConsole::coverSourceRect(sourceSize, widgetSize)).scaled(widgetSize, Qt::IgnoreAspectRatio, Qt::SmoothTransformation); + + QCOMPARE(installedBackgroundBrush().toImage(), expected.toImage()); + } + + void test_unloadableCoverImageIsReportedAndKeepsThePreviousBackground() + { + const QString goodPath = writeImage(qsl("good.png"), QSize(300, 200), Qt::gray); + QVERIFY(!goodPath.isEmpty()); + + runLua(qsl("setBackgroundImage('main', [[%1]], 'cover', true)").arg(goodPath)); + const QImage installed = installedBackgroundBrush().toImage(); + QVERIFY(!installed.isNull()); + + runLua(qsl("bgOk, bgError = setBackgroundImage('main', [[%1]], 'cover', true)").arg(mImageDir.filePath(qsl("no-such-file.png")))); + + QVERIFY(luaNil(qsl("bgOk"))); + QVERIFY2(luaString(qsl("bgError")).contains(qsl("full window background image")), qPrintable(luaString(qsl("bgError")))); + QCOMPARE(mpHost->mpConsole->mWindowBgImagePath, goodPath); + QCOMPARE(installedBackgroundBrush().toImage(), installed); + } + + void test_coverBrushFollowsAWindowResize() + { + const QString imagePath = writeImage(qsl("resize.png"), QSize(3000, 100), Qt::darkRed); + QVERIFY(!imagePath.isEmpty()); + + runLua(qsl("setBackgroundImage('main', [[%1]], 'cover', true)").arg(imagePath)); + const QSize sizeBefore = mpHost->mpConsole->mpWindowBackground->size(); + + mudlet::self()->resize(900, 640); + QTest::qWait(200ms); + + const QSize sizeAfter = mpHost->mpConsole->mpWindowBackground->size(); + QVERIFY2(sizeAfter != sizeBefore, "the window did not actually resize"); + QCOMPARE(installedBackgroundBrush().size(), sizeAfter); + + mudlet::self()->resize(1200, 800); + QTest::qWait(200ms); + } + + // clearing a stylesheet repolishes the widget, which can drop the palette brush + void test_switchingFromStylesheetModeToCoverInstallsTheBrush() + { + const QString imagePath = writeImage(qsl("switch.png"), QSize(256, 128), Qt::magenta); + QVERIFY(!imagePath.isEmpty()); + + runLua(qsl("setBackgroundImage('main', [[%1]], 'border', true)").arg(imagePath)); + QVERIFY(!mpHost->mpConsole->mpWindowBackground->styleSheet().isEmpty()); + + runLua(qsl("setBackgroundImage('main', [[%1]], 'cover', true)").arg(imagePath)); + + QVERIFY(mpHost->mpConsole->mpWindowBackground->styleSheet().isEmpty()); + QCOMPARE(mpHost->mpConsole->mpWindowBackground->palette().brush(QPalette::Window).texture().size(), mpHost->mpConsole->mpWindowBackground->size()); + } +}; + +void initializeQRCResourcesForWindowBackgroundTest() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +#include "WindowBackgroundTest.moc" +QTEST_MAIN(WindowBackgroundTest) From 96335540f5ba0262faf4b0b6cca248965e320ea1 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Fri, 7 Aug 2026 10:15:30 +0200 Subject: [PATCH 119/155] fix: getWindowGeometry() and windowVisible() answer for the main window (#9714) #### Brief overview of PR changes/additions - `getWindowGeometry("main")` and `windowVisible("main")` (and the `""` spelling of the same) now answer instead of returning `nil, 'window "main" not found'`; geometry is `0, 0` plus whatever `getMainWindowSize()` reports, so the two functions cannot disagree - `windowVisible()` reads `isVisibleTo(mpConsole)` rather than `isVisible()`, so a profile that is not the front tab - whose whole console Mudlet hides - stops reporting every one of its labels, miniconsoles, scroll boxes, command lines and text edits as invisible. A child of a hidden user window still reports `false`, which is the documented behaviour - New two-profile `WindowStateGettersTest` (the busted suite is always the single front profile, so it cannot reach this), and the two `UI_spec` specs that asserted the old refusal are replaced #### Motivation for adding to Mudlet Both getters are new in 5.0, and as shipped the first one tells a script the main window does not exist while the second answers wrong for every profile the user is not currently looking at. #### Other info (issues closed, discussion etc) 5.0 QA findings C6 (main rejected) and D10 F1 (background profiles). The background-profile half is the same defect `7bb20fa2c` ("add: widget state getters for titles, stylesheets, tooltips and scroll bars (#9645)") fixed for `getScrollBarVisible`; `windowVisible` landed a week earlier in `1227bc377` ("add: getWindowGeometry(), windowVisible() and getLabelText() functions (#9528)") and was left reading the widget. **On excluding `main` - the counter-argument, weighed.** #9528 made that choice deliberately: it shipped two `UI_spec` specs asserting the refusal, with the comment "mirrors moveWindow/resizeWindow, which likewise do not act on main", and the Area 51 draft says the same. So this overturns a decision rather than filling an oversight. I still think it is wrong: the message claims a window that manifestly exists was *not found*, whereas `moveWindow("main", ...)` is a silent no-op and claims nothing; `windowType("main")` in the same readback family answers; and `isMain()`, `getRowCount`, `getColumnCount`, `getWindowWrap` and `getScrollBarVisible` all take `"main"`/`""`. Refusing is only defensible when there is no sensible answer, and there is one. The Area 51 text for both functions needs the matching edit before it goes to the manual. Two things deliberately left alone, reported rather than fixed: `Host::windowType()` still special-cases `"main"` without `""`, and a user element literally named `"main"` is now shadowed by the main window. Assisted-by: Claude:claude-opus-5 **Test case:** `print(getWindowGeometry("main"))` and `print(windowVisible("main"))` answer; with two profiles open, `createLabel("probe", 0, 0, 50, 50, 1)` in profile A then `windowVisible("probe")` from a timer while profile B is in front still returns `true`. --- src/Host.cpp | 43 +-- src/mudlet-lua/tests/UI_spec.lua | 21 +- test/functional_tests/CMakeLists.txt | 1 + .../WindowStateGettersTest.cpp | 256 ++++++++++++++++++ 4 files changed, 296 insertions(+), 25 deletions(-) create mode 100644 test/functional_tests/WindowStateGettersTest.cpp diff --git a/src/Host.cpp b/src/Host.cpp index 0db451c52..f23f17635 100644 --- a/src/Host.cpp +++ b/src/Host.cpp @@ -5054,19 +5054,23 @@ std::optional<QString> Host::windowType(const QString& name) const return {}; } -// Returns the position and size of a named window element, matching what -// moveWindow()/resizeWindow() set. pos()/size() (rather than geometry()) are -// used deliberately: they are the exact inverse of the move()/resize() calls -// those setters make, including for a floating user-window dock where move() -// targets the frame origin while geometry() would report the client area. -// Mirrors the widget dispatch of moveWindow()/resizeWindow(); user windows are -// moved/resized through their dock widget, so read the dock, not the console. +// Returns the position and size of a window element, matching what +// moveWindow()/resizeWindow() set and mirroring their widget dispatch, so user +// windows are read from their dock widget rather than their console. +// pos()/size() rather than geometry(): for a floating dock move() targets the +// frame origin while geometry() would report the client area. std::optional<QRect> Host::windowGeometry(const QString& name) const { if (!mpConsole) { return {}; } + if (name.isEmpty() || name == QLatin1String("main")) { + // 0,0 rather than the console's pos(), which under multi-view is an + // offset within the split; the size is getMainWindowSize()'s so the two + // functions cannot disagree. + return {QRect(QPoint(0, 0), mpConsole->getMainWindowSize())}; + } if (auto pL = mpConsole->mLabelMap.value(name)) { return {QRect(pL->pos(), pL->size())}; } @@ -5089,32 +5093,39 @@ std::optional<QRect> Host::windowGeometry(const QString& name) const return {}; } -// Returns whether a named window element is currently visible. Mirrors the -// widget dispatch of hideWindow()/showWindow(); user windows report the -// visibility of their dock widget, which is what those functions toggle. +// Returns whether a window element is currently visible, mirroring the widget +// dispatch of hideWindow()/showWindow() - user windows report their dock's +// visibility, which is what those toggle. Answered relative to the profile's +// own console: a child of a hidden user window still reads hidden, but a +// profile that is merely not the front tab does not. std::optional<bool> Host::windowVisible(const QString& name) const { if (!mpConsole) { return {}; } + if (name.isEmpty() || name == QLatin1String("main")) { + // only the tab machinery hides the main console, and that is the hiding + // this function looks past + return {true}; + } if (auto pL = mpConsole->mLabelMap.value(name)) { - return {pL->isVisible()}; + return {pL->isVisibleTo(mpConsole)}; } if (auto pC = mpConsole->mSubConsoleMap.value(name)) { if (auto pD = mpConsole->mDockWidgetMap.value(name)) { - return {pD->isVisible()}; + return {pD->isVisibleTo(mpConsole)}; } - return {pC->isVisible()}; + return {pC->isVisibleTo(mpConsole)}; } if (auto pS = mpConsole->mScrollBoxMap.value(name)) { - return {pS->isVisible()}; + return {pS->isVisibleTo(mpConsole)}; } if (auto pN = mpConsole->mSubCommandLineMap.value(name)) { - return {pN->isVisible()}; + return {pN->isVisibleTo(mpConsole)}; } if (auto pT = mpConsole->mTextBoxMap.value(name)) { - return {pT->isVisible()}; + return {pT->isVisibleTo(mpConsole)}; } return {}; diff --git a/src/mudlet-lua/tests/UI_spec.lua b/src/mudlet-lua/tests/UI_spec.lua index 118dda5f9..2fba3c281 100644 --- a/src/mudlet-lua/tests/UI_spec.lua +++ b/src/mudlet-lua/tests/UI_spec.lua @@ -2666,11 +2666,15 @@ describe("Window state getters", function() assert.is_truthy(err:find("wdgNoSuchWindow", 1, true)) end) - it("returns nil and a message for the main window", function() - -- mirrors moveWindow/resizeWindow, which likewise do not act on "main" - local result, err = getWindowGeometry("main") - assert.is_nil(result) - assert.are.equal("string", type(err)) + it("returns the main window's geometry under both of its names", function() + local width, height = getMainWindowSize() + for _, name in ipairs({"main", ""}) do + local x, y, w, h = getWindowGeometry(name) + assert.are.equal(0, x) + assert.are.equal(0, y) + assert.are.equal(width, w) + assert.are.equal(height, h) + end end) it("errors when called without a window name", function() @@ -2737,10 +2741,9 @@ describe("Window state getters", function() assert.is_truthy(err:find("wdgNoSuchWindow", 1, true)) end) - it("returns nil and a message for the main window", function() - local result, err = windowVisible("main") - assert.is_nil(result) - assert.are.equal("string", type(err)) + it("reports the main window as visible under both of its names", function() + assert.is_true(windowVisible("main")) + assert.is_true(windowVisible("")) end) it("errors when called without a window name", function() diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index 0a759ecfd..a49be4441 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -21,6 +21,7 @@ set(FUNCTIONAL_TEST_SOURCES dlgTriggerEditorUndoRedoTest.cpp EditorBannerViewSwitchTest.cpp TDiscordModeTest.cpp + WindowStateGettersTest.cpp MainConsoleSelectionTest.cpp EnableDisableByNameTest.cpp UnitDeferredDeleteTest.cpp diff --git a/test/functional_tests/WindowStateGettersTest.cpp b/test/functional_tests/WindowStateGettersTest.cpp new file mode 100644 index 000000000..293828a30 --- /dev/null +++ b/test/functional_tests/WindowStateGettersTest.cpp @@ -0,0 +1,256 @@ +/*************************************************************************** + * Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +/* + * Covers getWindowGeometry() and windowVisible() for a profile that is not the + * front tab. Mudlet hides a backgrounded profile's whole console, so the busted + * suite structurally cannot reach this: it always runs as the only, front, + * profile. + */ + +#include <QSignalSpy> +#include <QtTest/QtTest> +#include <chrono> + +#include "Host.h" +#include "HostManager.h" +#include "MudletInstanceCoordinator.h" +#include "TMainConsole.h" +#include "TelnetServerStub.h" +#include "ctelnet.h" +#include "dlgConnectionProfiles.h" +#include "mudlet.h" + +using namespace std::chrono_literals; + +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); +void initializeQRCResourcesForWindowStateGettersTest(); + +class WindowStateGettersTest : public QObject +{ + Q_OBJECT + +private: + TelnetServerStub* mpServer = nullptr; + Host* mpBackgroundHost = nullptr; + Host* mpFrontHost = nullptr; + const QString mBackgroundHostname = qsl("WindowStateGetters-Background"); + const QString mFrontHostname = qsl("WindowStateGetters-Front"); + QString mPort; + const QString mLocalhost = qsl("localhost"); + const QString mLabelName = qsl("wsgLabel"); + const QString mConsoleName = qsl("wsgConsole"); + const QString mScrollBoxName = qsl("wsgScrollBox"); + const QString mCmdLineName = qsl("wsgCmdLine"); + const QString mTextEditName = qsl("wsgTextEdit"); + const QString mUserWindowName = qsl("wsgUserWindow"); + const QString mChildLabelName = qsl("wsgChildLabel"); + +private slots: + void initTestCase() + { + initializeQRCResourcesForWindowStateGettersTest(); + + mpServer = new TelnetServerStub(qApp); + mpServer->start(mLocalhost, 0); + mPort = QString::number(mpServer->serverPort()); + mudlet::start(); + mudlet::self()->setupConfig(); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique<MudletInstanceCoordinator>("MudletInstanceCoordinator")); + mudlet::self()->init(); + mudlet::self()->setStorePasswordsSecurely(false); + + deleteProfileDirectory(mBackgroundHostname); + deleteProfileDirectory(mFrontHostname); + + startProfile(mBackgroundHostname); + if (QTest::currentTestFailed()) { + return; + } + mpBackgroundHost = mudlet::self()->getHostManager().getHost(mBackgroundHostname); + QVERIFY(mpBackgroundHost); + QVERIFY(mpBackgroundHost->mpConsole); + + startProfile(mFrontHostname); + if (QTest::currentTestFailed()) { + return; + } + mpFrontHost = mudlet::self()->getHostManager().getHost(mFrontHostname); + QVERIFY(mpFrontHost); + QVERIFY(mpFrontHost->mpConsole); + + QVERIFY2(mpBackgroundHost->mpConsole->isHidden(), "opening a second profile did not background the first one, so there is nothing to test here"); + } + + void cleanupTestCase() + { + delete mpServer; + mpServer = nullptr; + mpBackgroundHost = nullptr; + mpFrontHost = nullptr; + deleteProfileDirectory(mBackgroundHostname); + deleteProfileDirectory(mFrontHostname); + delete mudlet::self(); + } + + void test_backgroundProfileReportsEveryElementTypeAsVisible() + { + buildElements(mpBackgroundHost); + + for (const QString& name : elementNames()) { + assertVisibility(mpBackgroundHost, name, true, qsl("%1 of a backgrounded profile").arg(name)); + } + + // a hidden user window still has to take its children with it + QVERIFY(mpBackgroundHost->hideWindow(mUserWindowName)); + assertVisibility(mpBackgroundHost, mUserWindowName, false, qsl("a hidden user window")); + assertVisibility(mpBackgroundHost, mChildLabelName, false, qsl("a child of a hidden user window")); + + QVERIFY(mpBackgroundHost->hideWindow(mLabelName)); + assertVisibility(mpBackgroundHost, mLabelName, false, qsl("a label hidden on a backgrounded profile")); + QVERIFY(mpBackgroundHost->showWindow(mLabelName)); + assertVisibility(mpBackgroundHost, mLabelName, true, qsl("a label shown again on a backgrounded profile")); + } + + void test_frontProfileReportsEveryElementTypeAsVisible() + { + buildElements(mpFrontHost); + + for (const QString& name : elementNames()) { + assertVisibility(mpFrontHost, name, true, qsl("%1 of the front profile").arg(name)); + } + + QVERIFY(mpFrontHost->hideWindow(mLabelName)); + assertVisibility(mpFrontHost, mLabelName, false, qsl("a label hidden on the front profile")); + } + + void test_mainWindowAnswersBothOfItsNames() + { + for (const QString& name : {qsl("main"), QString()}) { + const auto geometry = mpFrontHost->windowGeometry(name); + QVERIFY2(geometry.has_value(), qPrintable(qsl("getWindowGeometry(\"%1\") did not recognise the main window").arg(name))); + QCOMPARE(geometry->topLeft(), QPoint(0, 0)); + QCOMPARE(geometry->size(), mpFrontHost->mpConsole->getMainWindowSize()); + QVERIFY2(geometry->width() > 0 && geometry->height() > 0, qPrintable(qsl("the main window reported an empty geometry: %1x%2").arg(geometry->width()).arg(geometry->height()))); + + assertVisibility(mpFrontHost, name, true, qsl("the front profile's main window")); + } + } + + void test_backgroundProfileAnswersForItsOwnMainWindow() + { + assertVisibility(mpBackgroundHost, qsl("main"), true, qsl("a backgrounded profile's main window")); + + // getMainWindowSize() falls back to a cached size while the console is hidden + const auto geometry = mpBackgroundHost->windowGeometry(qsl("main")); + QVERIFY(geometry.has_value()); + QVERIFY2(geometry->width() > 0 && geometry->height() > 0, + qPrintable(qsl("a backgrounded profile's main window reported an empty geometry: %1x%2").arg(geometry->width()).arg(geometry->height()))); + } + +private: + QStringList elementNames() const { return {mLabelName, mConsoleName, mScrollBoxName, mCmdLineName, mTextEditName, mUserWindowName, mChildLabelName}; } + + // built through the Lua API so each profile's own interpreter creates them + void buildElements(Host* pHost) const + { + pHost->getLuaInterpreter()->compileAndExecuteScript(qsl("createLabel('%1', 0, 0, 50, 50, 1)\n" + "createMiniConsole('%2', 0, 60, 100, 50)\n" + "createScrollBox('%3', 0, 120, 100, 50)\n" + "createCommandLine('%4', 0, 180, 100, 30)\n" + "createTextEdit('%5', 0, 220, 100, 50)\n" + "openUserWindow('%6')\n" + "createLabel('%6', '%7', 5, 5, 40, 20, 1)") + .arg(mLabelName, mConsoleName, mScrollBoxName, mCmdLineName, mTextEditName, mUserWindowName, mChildLabelName)); + } + + void assertVisibility(Host* pHost, const QString& name, const bool expected, const QString& what) const + { + const auto visible = pHost->windowVisible(name); + QVERIFY2(visible.has_value(), qPrintable(qsl("windowVisible() reported %1 as not found").arg(what))); + QVERIFY2(*visible == expected, qPrintable(qsl("windowVisible() reported %1 as %2").arg(what, *visible ? qsl("visible") : qsl("hidden")))); + } + + void startProfile(const QString& hostname) + { + const QString address = mLocalhost; + const QString port = mPort; + QTimer::singleShot(0ms, qApp, [hostname, address, port]() { + mudlet::self()->startAutoLogin({}); + QTest::qWait(100ms); + QTest::mouseClick(mudlet::self()->mpConnectionDialog->new_profile_button, Qt::LeftButton); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), hostname); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), address); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), port); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Return); + }); + + QSignalSpy spy(mudlet::self(), &mudlet::signal_profileLoaded); + if (!spy.wait(5000)) { + QFAIL("Profile took too long to load."); + } + auto host = mudlet::self()->getActiveHost(); + if (!host) { + QFAIL("No active host available for the test."); + } + + QSignalSpy connectionSpy(&(host->mTelnet), &cTelnet::signal_connected); + if (!connectionSpy.wait(2000)) { + QFAIL("Could not connect with the host."); + } + } + + void deleteProfileDirectory(const QString& profileName) + { + QDir dir(mudlet::getMudletPath(enums::profileHomePath, profileName)); + if (dir.exists()) { + dir.removeRecursively(); + } + } +}; + +void initializeQRCResourcesForWindowStateGettersTest() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +#include "WindowStateGettersTest.moc" +QTEST_MAIN(WindowStateGettersTest) From 24b912807642b985137178ace9eaddeb11c9fc9a Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Sat, 8 Aug 2026 00:20:33 +0200 Subject: [PATCH 120/155] fix: unbreak development - cloneExportDocument was renamed to takeExportDocument (#9732) #### Brief overview of PR changes/additions - Every CI job on development has been red since 6c67a138 (#9704): `PackageSelfUninstallTest.cpp:627` calls `XMLexport::cloneExportDocument()`, which fd822ebb (#9699) had renamed to `takeExportDocument()` four hours earlier. #9704's checks were green against the older base and were not re-run before merge, so the collision only appeared once both were on development. - The call site is a local `XMLexport` used once and destroyed immediately after, so handing the document over instead of copying it is equivalent here. #### Test case `ctest -R PackageSelfUninstall` passes, and a full build of all targets is clean. Assisted-by: Claude:claude-opus-5 --- .github/workflows/build-mudlet-pr.yml | 37 ++++++++++++++++++- .github/workflows/build-mudlet.yml | 37 ++++++++++++++++++- .../PackageSelfUninstallTest.cpp | 2 +- 3 files changed, 71 insertions(+), 5 deletions(-) diff --git a/.github/workflows/build-mudlet-pr.yml b/.github/workflows/build-mudlet-pr.yml index d0c46b570..94a907da2 100644 --- a/.github/workflows/build-mudlet-pr.yml +++ b/.github/workflows/build-mudlet-pr.yml @@ -92,8 +92,41 @@ jobs: cache: true modules: qt5compat qtmultimedia qtspeech - - name: Use CMake 3.30.3 - uses: lukka/get-cmake@v4.4.0 + - name: Build Lua (lua.org with mirror fallback) + env: + HOMEBREW_NO_AUTO_UPDATE: "ON" + # sha256 of lua-5.1.5.tar.gz - update when LUA_VERSION changes + LUA_SHA256: '2640fc56a795f29d28ef15e13c34a47e223960b0240e8cb0a82d9b0738695333' + run: | + # Pre-build Lua into .lua/ so the gh-actions-lua steps below skip their + # own download - they only fetch from lua.org, which goes down at times + # and takes all of CI with it. + for url in \ + "https://www.lua.org/ftp/lua-${LUA_VERSION}.tar.gz" \ + "https://sources.buildroot.net/lua/lua-${LUA_VERSION}.tar.gz" \ + "https://distfiles.macports.org/lua/lua-${LUA_VERSION}.tar.gz" \ + "https://ftp.openbsd.org/pub/OpenBSD/distfiles/lua-${LUA_VERSION}.tar.gz"; do + echo "Downloading ${url}" + if curl -fsSL --connect-timeout 15 --max-time 120 -o lua.tar.gz "${url}" \ + && echo "${LUA_SHA256} lua.tar.gz" | shasum -a 256 -c -; then + break + fi + rm -f lua.tar.gz + done + if [ ! -f lua.tar.gz ]; then + echo "::error::could not download Lua ${LUA_VERSION} from any source" + exit 1 + fi + tar xzf lua.tar.gz + if [ "${RUNNER_OS}" = "macOS" ]; then + brew install readline ncurses + make -C "lua-${LUA_VERSION}" -j macosx + else + sudo apt-get install -qy libreadline-dev libncurses-dev + make -C "lua-${LUA_VERSION}" -j linux + fi + make -C "lua-${LUA_VERSION}" INSTALL_TOP="${GITHUB_WORKSPACE}/.lua" install + rm -rf lua.tar.gz "lua-${LUA_VERSION}" - name: (macOS) Install Lua via GitHub Actions if: runner.os == 'macOS' diff --git a/.github/workflows/build-mudlet.yml b/.github/workflows/build-mudlet.yml index 7301071b4..51ecdec8a 100644 --- a/.github/workflows/build-mudlet.yml +++ b/.github/workflows/build-mudlet.yml @@ -78,8 +78,41 @@ jobs: cache: true modules: qt5compat qtmultimedia qtspeech - - name: Use CMake 3.30.3 - uses: lukka/get-cmake@v4.4.0 + - name: Build Lua (lua.org with mirror fallback) + env: + HOMEBREW_NO_AUTO_UPDATE: "ON" + # sha256 of lua-5.1.5.tar.gz - update when LUA_VERSION changes + LUA_SHA256: '2640fc56a795f29d28ef15e13c34a47e223960b0240e8cb0a82d9b0738695333' + run: | + # Pre-build Lua into .lua/ so the gh-actions-lua steps below skip their + # own download - they only fetch from lua.org, which goes down at times + # and takes all of CI with it. + for url in \ + "https://www.lua.org/ftp/lua-${LUA_VERSION}.tar.gz" \ + "https://sources.buildroot.net/lua/lua-${LUA_VERSION}.tar.gz" \ + "https://distfiles.macports.org/lua/lua-${LUA_VERSION}.tar.gz" \ + "https://ftp.openbsd.org/pub/OpenBSD/distfiles/lua-${LUA_VERSION}.tar.gz"; do + echo "Downloading ${url}" + if curl -fsSL --connect-timeout 15 --max-time 120 -o lua.tar.gz "${url}" \ + && echo "${LUA_SHA256} lua.tar.gz" | shasum -a 256 -c -; then + break + fi + rm -f lua.tar.gz + done + if [ ! -f lua.tar.gz ]; then + echo "::error::could not download Lua ${LUA_VERSION} from any source" + exit 1 + fi + tar xzf lua.tar.gz + if [ "${RUNNER_OS}" = "macOS" ]; then + brew install readline ncurses + make -C "lua-${LUA_VERSION}" -j macosx + else + sudo apt-get install -qy libreadline-dev libncurses-dev + make -C "lua-${LUA_VERSION}" -j linux + fi + make -C "lua-${LUA_VERSION}" INSTALL_TOP="${GITHUB_WORKSPACE}/.lua" install + rm -rf lua.tar.gz "lua-${LUA_VERSION}" - name: (macOS) Install Lua via GitHub Actions if: runner.os == 'macOS' diff --git a/test/functional_tests/PackageSelfUninstallTest.cpp b/test/functional_tests/PackageSelfUninstallTest.cpp index 84de87f8a..5f4052b62 100644 --- a/test/functional_tests/PackageSelfUninstallTest.cpp +++ b/test/functional_tests/PackageSelfUninstallTest.cpp @@ -624,7 +624,7 @@ private: const QString path = qsl("%1/module-export.xml").arg(mConfigDir.path()); XMLexport writer(mpHost); writer.writeModuleXML(moduleName); - if (!XMLexport::saveXmlDocToFile(path, *writer.cloneExportDocument())) { + if (!XMLexport::saveXmlDocToFile(path, *writer.takeExportDocument())) { return {}; } return readBack(path); From 0618512c2ff9ab2dc1104977778c6de72794d933 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Sat, 8 Aug 2026 08:20:43 +0200 Subject: [PATCH 121/155] Fix macOS builds sometimes failing their tests for no reason (#9733) #### Brief overview of PR changes/additions - The macOS Lua test step's 1-minute timeout now fires mid-suite on a slow Intel runner: the suite takes 43-60s there (31s on arm64), so a slow run gets killed while tests are still finishing and the job reads as a failure. - The timed-out runs were not hung: in the 2026-08-07 failure, `mudlet::closeEvent` arrived 0.6 seconds before the 60-second cutoff, with every spec already passed. - Raise the step timeout to 3 minutes, matching the Linux leg, in both paired build workflows. #### Motivation for adding to Mudlet Three required-check failures on 2026-08-07 (two on development pushes, one on a PR) were this timeout, not real breakage. All previous "macOS timed out" theories pointed at a shutdown hang; the step logs' timestamps show there is none. #### Other info (issues closed, discussion etc) Test case: timestamp analysis of passing vs timed-out runs of `(macOS) Run Lua tests` (jobs 93008145745 and 92999008773) - the failed run's shutdown began 59.6s into a 60s budget. No timeout existed before 2026-08-07 because the suite only recently grew past a minute on the slower runners. Assisted-by: Claude:claude-fable-5 --- .github/workflows/build-mudlet-pr.yml | 7 ++++--- .github/workflows/build-mudlet.yml | 7 ++++--- 2 files changed, 8 insertions(+), 6 deletions(-) diff --git a/.github/workflows/build-mudlet-pr.yml b/.github/workflows/build-mudlet-pr.yml index 94a907da2..da3ae93ab 100644 --- a/.github/workflows/build-mudlet-pr.yml +++ b/.github/workflows/build-mudlet-pr.yml @@ -615,8 +615,8 @@ jobs: - name: (Linux) Run Lua tests if: matrix.run_tests == 'true' && runner.os == 'Linux' - # Longer than the other platforms': this leg also drives the real - # discord-rpc library, whose reconnects happen in wall-clock time. + # This leg drives the real discord-rpc library, whose reconnects + # happen in wall-clock time. timeout-minutes: 3 run: xvfb-run --auto-servernum ${{github.workspace}}/src/mudlet --profile "Mudlet self-test" --mirror env: @@ -650,7 +650,8 @@ jobs: - name: (macOS) Run Lua tests if: matrix.run_tests == 'true' && runner.os == 'macOS' - timeout-minutes: 1 + # The suite alone can run past a minute on the slower Intel runners + timeout-minutes: 3 run: ~/Desktop/Mudlet.app/Contents/MacOS/mudlet --profile "Mudlet self-test" --mirror env: AUTORUN_BUSTED_TESTS: 'true' diff --git a/.github/workflows/build-mudlet.yml b/.github/workflows/build-mudlet.yml index 51ecdec8a..56497b080 100644 --- a/.github/workflows/build-mudlet.yml +++ b/.github/workflows/build-mudlet.yml @@ -626,8 +626,8 @@ jobs: - name: (Linux) Run Lua tests if: matrix.run_tests == 'true' && runner.os == 'Linux' - # Longer than the other platforms': this leg also drives the real - # discord-rpc library, whose reconnects happen in wall-clock time. + # This leg drives the real discord-rpc library, whose reconnects + # happen in wall-clock time. timeout-minutes: 3 run: xvfb-run --auto-servernum ${{github.workspace}}/src/mudlet --profile "Mudlet self-test" --mirror env: @@ -661,7 +661,8 @@ jobs: - name: (macOS) Run Lua tests if: matrix.run_tests == 'true' && runner.os == 'macOS' - timeout-minutes: 1 + # The suite alone can run past a minute on the slower Intel runners + timeout-minutes: 3 run: ~/Desktop/Mudlet.app/Contents/MacOS/mudlet --profile "Mudlet self-test" --mirror env: AUTORUN_BUSTED_TESTS: 'true' From 3e36ed47217ef6ab92d99cc66d89b921f389c1fc Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sat, 8 Aug 2026 08:21:41 +0200 Subject: [PATCH 122/155] Infrastructure: Bump github/codeql-action from 4.37.3 to 4.37.6 (#9730) Bumps [github/codeql-action](https://github.com/github/codeql-action) from 4.37.3 to 4.37.6. <details> <summary>Release notes</summary> <p><em>Sourced from <a href="https://github.com/github/codeql-action/releases">github/codeql-action's releases</a>.</em></p> <blockquote> <h2>v4.37.6</h2> <ul> <li>Changed the default filepath for the new remote file address format that was introduced in CodeQL Action 4.37.0 / 3.37.0 to <code>.github/codeql-config.yml</code> to align it with the suggested path that is used elsewhere. <a href="https://redirect.github.com/github/codeql-action/pull/4070">#4070</a></li> </ul> <h2>v4.37.5</h2> <ul> <li>Fixed a bug where a network error while streaming the download of the CodeQL bundle could terminate the <code>init</code> Action instead of falling back to downloading the bundle before extracting it. <a href="https://redirect.github.com/github/codeql-action/pull/4061">#4061</a></li> </ul> <h2>v4.37.4</h2> <ul> <li>This version of the CodeQL Action adds support for the <code>tools</code> input for the <code>codeql-action/init</code> step to be specified using a <code>github-codeql-tools</code> <a href="https://docs.github.com/en/organizations/managing-organization-settings/managing-custom-properties-for-repositories-in-your-organization">repository property</a>. This feature will gradually be rolled out following the release of this version. Once rolled out, this allows for the CodeQL CLI version that is used in GitHub-managed workflows, such as Default Setup, to be set to a custom value. For example, customers who run into issues with rate limits when a new CodeQL CLI version is released can set the value to <code>toolcache</code> to always use the CodeQL CLI version that is available in the runner toolcache. For Advanced Setup workflows, the value provided for <code>tools</code> in the workflow definition always takes precedence unless the value of the repository property starts with <code>!</code>. <a href="https://redirect.github.com/github/codeql-action/pull/4037">#4037</a></li> <li>Update default CodeQL bundle version to <a href="https://github.com/github/codeql-action/releases/tag/codeql-bundle-v2.26.2">2.26.2</a>. <a href="https://redirect.github.com/github/codeql-action/pull/4051">#4051</a></li> </ul> </blockquote> </details> <details> <summary>Changelog</summary> <p><em>Sourced from <a href="https://github.com/github/codeql-action/blob/main/CHANGELOG.md">github/codeql-action's changelog</a>.</em></p> <blockquote> <h2>4.37.6 - 04 Aug 2026</h2> <ul> <li>Changed the default filepath for the new remote file address format that was introduced in CodeQL Action 4.37.0 / 3.37.0 to <code>.github/codeql-config.yml</code> to align it with the suggested path that is used elsewhere. <a href="https://redirect.github.com/github/codeql-action/pull/4070">#4070</a></li> </ul> <h2>4.37.5 - 03 Aug 2026</h2> <ul> <li>Fixed a bug where a network error while streaming the download of the CodeQL bundle could terminate the <code>init</code> Action instead of falling back to downloading the bundle before extracting it. <a href="https://redirect.github.com/github/codeql-action/pull/4061">#4061</a></li> </ul> <h2>4.37.4 - 29 Jul 2026</h2> <ul> <li>This version of the CodeQL Action adds support for the <code>tools</code> input for the <code>codeql-action/init</code> step to be specified using a <code>github-codeql-tools</code> <a href="https://docs.github.com/en/organizations/managing-organization-settings/managing-custom-properties-for-repositories-in-your-organization">repository property</a>. This feature will gradually be rolled out following the release of this version. Once rolled out, this allows for the CodeQL CLI version that is used in GitHub-managed workflows, such as Default Setup, to be set to a custom value. For example, customers who run into issues with rate limits when a new CodeQL CLI version is released can set the value to <code>toolcache</code> to always use the CodeQL CLI version that is available in the runner toolcache. For Advanced Setup workflows, the value provided for <code>tools</code> in the workflow definition always takes precedence unless the value of the repository property starts with <code>!</code>. <a href="https://redirect.github.com/github/codeql-action/pull/4037">#4037</a></li> <li>Update default CodeQL bundle version to <a href="https://github.com/github/codeql-action/releases/tag/codeql-bundle-v2.26.2">2.26.2</a>. <a href="https://redirect.github.com/github/codeql-action/pull/4051">#4051</a></li> </ul> </blockquote> </details> <details> <summary>Commits</summary> <ul> <li><a href="https://github.com/github/codeql-action/commit/5595ccaf912efad79be6eef63a5619ff05969be3"><code>5595cca</code></a> Merge pull request <a href="https://redirect.github.com/github/codeql-action/issues/4071">#4071</a> from github/update-v4.37.6-6a9359a1b</li> <li><a href="https://github.com/github/codeql-action/commit/ec9c75796a7f2cee5af0c5ffa0b81dc3bb58754b"><code>ec9c757</code></a> Add change note for PR 4070</li> <li><a href="https://github.com/github/codeql-action/commit/45c8742e17cbd668814137f95e605d925b8722a2"><code>45c8742</code></a> Update changelog for v4.37.6</li> <li><a href="https://github.com/github/codeql-action/commit/6a9359a1bd054c53cae7bb737bd8d796cfbf3014"><code>6a9359a</code></a> Merge pull request <a href="https://redirect.github.com/github/codeql-action/issues/4070">#4070</a> from github/mbg/remote-address/change-file-default</li> <li><a href="https://github.com/github/codeql-action/commit/065cdc0394d424981db720df63ebc570e41b775f"><code>065cdc0</code></a> Change <code>DEFAULT_CONFIG_FILE_NAME</code></li> <li><a href="https://github.com/github/codeql-action/commit/f99dd5aeee9cf92e92d0c700cb0aa7afd7bbf431"><code>f99dd5a</code></a> Merge pull request <a href="https://redirect.github.com/github/codeql-action/issues/4066">#4066</a> from github/dependabot/npm_and_yarn/js-yaml-5.2.2</li> <li><a href="https://github.com/github/codeql-action/commit/1804b211a343d69a6584d26fb3a68a8fe6ca39d4"><code>1804b21</code></a> Merge pull request <a href="https://redirect.github.com/github/codeql-action/issues/4068">#4068</a> from github/mergeback/v4.37.5-to-main-d1ba80a1</li> <li><a href="https://github.com/github/codeql-action/commit/3020a2f46286abb1704269b22ada83bd0e81c64f"><code>3020a2f</code></a> Rebuild</li> <li><a href="https://github.com/github/codeql-action/commit/93c3a5a40b7affbf8ea6a480767ed0db8e8d3c5c"><code>93c3a5a</code></a> Update changelog and version after v4.37.5</li> <li><a href="https://github.com/github/codeql-action/commit/d1ba80a13dd99fba24a470575428917156a28b43"><code>d1ba80a</code></a> Merge pull request <a href="https://redirect.github.com/github/codeql-action/issues/4067">#4067</a> from github/update-v4.37.5-1cd4d01d5</li> <li>Additional commits viewable in <a href="https://github.com/github/codeql-action/compare/v4.37.3...v4.37.6">compare view</a></li> </ul> </details> <br /> [![Dependabot compatibility score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=github/codeql-action&package-manager=github_actions&previous-version=4.37.3&new-version=4.37.6)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores) Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting `@dependabot rebase`. [//]: # (dependabot-automerge-start) [//]: # (dependabot-automerge-end) --- <details> <summary>Dependabot commands and options</summary> <br /> You can trigger Dependabot actions by commenting on this PR: - `@dependabot rebase` will rebase this PR - `@dependabot recreate` will recreate this PR, overwriting any edits that have been made to it - `@dependabot show <dependency name> ignore conditions` will show all of the ignore conditions of the specified dependency - `@dependabot ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself) - `@dependabot ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself) - `@dependabot ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself) </details> Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Vadim Peretokin <vperetokin@hey.com> --- .github/workflows/codeql-analysis.yml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/.github/workflows/codeql-analysis.yml b/.github/workflows/codeql-analysis.yml index 986688f5e..1f5af9c6c 100644 --- a/.github/workflows/codeql-analysis.yml +++ b/.github/workflows/codeql-analysis.yml @@ -88,7 +88,7 @@ jobs: # Initializes the CodeQL tools for scanning. - name: Initialize CodeQL - uses: github/codeql-action/init@v4.37.3 + uses: github/codeql-action/init@v4.37.6 with: config-file: ./.github/codeql/codeql-config.yml languages: ${{ matrix.language }} @@ -156,7 +156,7 @@ jobs: NINJA_STATUS: '[%f/%t %o/sec] ' - name: Perform CodeQL Analysis - uses: github/codeql-action/analyze@v4.37.3 + uses: github/codeql-action/analyze@v4.37.6 with: category: "/language:${{ matrix.language }}" upload: false @@ -171,6 +171,6 @@ jobs: output: sarif-results/${{ matrix.language }}.sarif - name: Upload SARIF - uses: github/codeql-action/upload-sarif@v4.37.3 + uses: github/codeql-action/upload-sarif@v4.37.6 with: sarif_file: sarif-results/${{ matrix.language }}.sarif From 81b02054b5347c973edfb37c78b41262ae26a692 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sat, 8 Aug 2026 08:21:57 +0200 Subject: [PATCH 123/155] Infrastructure: Bump 3rdparty/edbee-lib from `a3ae51b` to `62ca709` (#9728) Bumps [3rdparty/edbee-lib](https://github.com/Mudlet/edbee-lib) from `a3ae51b` to `62ca709`. <details> <summary>Commits</summary> <ul> <li><a href="https://github.com/Mudlet/edbee-lib/commit/62ca70905d5d60ccafeb45137596bfb5e55e2936"><code>62ca709</code></a> fix <a href="https://redirect.github.com/Mudlet/edbee-lib/issues/177">#177</a>, Fix strange mouse behavior dragging selection above top</li> <li><a href="https://github.com/Mudlet/edbee-lib/commit/ceb9b0364b1585013de55a22fd04238191897834"><code>ceb9b03</code></a> Read font from config (<a href="https://redirect.github.com/Mudlet/edbee-lib/issues/157">#157</a>)</li> <li><a href="https://github.com/Mudlet/edbee-lib/commit/038d35fced4681c1a7cba1ae850d78075e60b36a"><code>038d35f</code></a> - [v0.11.1] Regression, autoInit was invoked too late the new contructor setu...</li> <li><a href="https://github.com/Mudlet/edbee-lib/commit/a8505d4b7459ee9e6312eebaf24fa754b57ee029"><code>a8505d4</code></a> Update license headers; docs to Doxygen Awesome</li> <li><a href="https://github.com/Mudlet/edbee-lib/commit/8969bd1b6b1035a4d0bd6a59800ba3dafce1b83d"><code>8969bd1</code></a> Pass config to TextEditorWidget (<a href="https://redirect.github.com/Mudlet/edbee-lib/issues/156">#156</a>)</li> <li><a href="https://github.com/Mudlet/edbee-lib/commit/4d6e3f6032e180060bc7c810c3ac8e436a2f12c0"><code>4d6e3f6</code></a> set-version also adjusts the Doxyfile</li> <li>See full diff in <a href="https://github.com/Mudlet/edbee-lib/compare/a3ae51bbb82158366b3d5c4030a54981db688892...62ca70905d5d60ccafeb45137596bfb5e55e2936">compare view</a></li> </ul> </details> <br /> Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting `@dependabot rebase`. [//]: # (dependabot-automerge-start) [//]: # (dependabot-automerge-end) --- <details> <summary>Dependabot commands and options</summary> <br /> You can trigger Dependabot actions by commenting on this PR: - `@dependabot rebase` will rebase this PR - `@dependabot recreate` will recreate this PR, overwriting any edits that have been made to it - `@dependabot show <dependency name> ignore conditions` will show all of the ignore conditions of the specified dependency - `@dependabot ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself) - `@dependabot ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself) - `@dependabot ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself) </details> Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Vadim Peretokin <vperetokin@hey.com> --- 3rdparty/edbee-lib | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/3rdparty/edbee-lib b/3rdparty/edbee-lib index a3ae51bbb..62ca70905 160000 --- a/3rdparty/edbee-lib +++ b/3rdparty/edbee-lib @@ -1 +1 @@ -Subproject commit a3ae51bbb82158366b3d5c4030a54981db688892 +Subproject commit 62ca70905d5d60ccafeb45137596bfb5e55e2936 From a66794e5c76a9eccb9b720f2ffbdd95e71aa86fb Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sat, 8 Aug 2026 08:23:42 +0200 Subject: [PATCH 124/155] Infrastructure: Bump 3rdparty/sentry-native from `a99d64e` to `a185ce8` (#9727) Bumps [3rdparty/sentry-native](https://github.com/getsentry/sentry-native) from `a99d64e` to `a185ce8`. <details> <summary>Commits</summary> <ul> <li><a href="https://github.com/getsentry/sentry-native/commit/a185ce80ba2416b0a0bb04b4ee8f11f1117ae08f"><code>a185ce8</code></a> release: 0.16.1</li> <li><a href="https://github.com/getsentry/sentry-native/commit/e3c769f0f18d0b87f32b42c0e7feb88d48393196"><code>e3c769f</code></a> feat: added <code>app_hang_pause</code> (<a href="https://redirect.github.com/getsentry/sentry-native/issues/1928">#1928</a>)</li> <li><a href="https://github.com/getsentry/sentry-native/commit/ee9ac8c856c7ccb8a76312e5d8404a2d3650f6e6"><code>ee9ac8c</code></a> fix(docker): expand PIPX_BIN_DIR when adding it to PATH (<a href="https://redirect.github.com/getsentry/sentry-native/issues/1925">#1925</a>)</li> <li><a href="https://github.com/getsentry/sentry-native/commit/16e7222d8f45ac2562ac3f576d3c9f86396f0b0e"><code>16e7222</code></a> fix(consent): honor checks before launching crash reporter (<a href="https://redirect.github.com/getsentry/sentry-native/issues/1906">#1906</a>)</li> <li><a href="https://github.com/getsentry/sentry-native/commit/86cb8d336835f10d19a1b0327671b6b6039f74d9"><code>86cb8d3</code></a> Merge branch 'release/0.16.0'</li> <li>See full diff in <a href="https://github.com/getsentry/sentry-native/compare/a99d64efb8d5c614bbcfdab7c7dc737530e5ef7d...a185ce80ba2416b0a0bb04b4ee8f11f1117ae08f">compare view</a></li> </ul> </details> <br /> Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting `@dependabot rebase`. [//]: # (dependabot-automerge-start) [//]: # (dependabot-automerge-end) --- <details> <summary>Dependabot commands and options</summary> <br /> You can trigger Dependabot actions by commenting on this PR: - `@dependabot rebase` will rebase this PR - `@dependabot recreate` will recreate this PR, overwriting any edits that have been made to it - `@dependabot show <dependency name> ignore conditions` will show all of the ignore conditions of the specified dependency - `@dependabot ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself) - `@dependabot ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself) - `@dependabot ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself) </details> Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Vadim Peretokin <vperetokin@hey.com> --- 3rdparty/sentry-native | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/3rdparty/sentry-native b/3rdparty/sentry-native index a99d64efb..a185ce80b 160000 --- a/3rdparty/sentry-native +++ b/3rdparty/sentry-native @@ -1 +1 @@ -Subproject commit a99d64efb8d5c614bbcfdab7c7dc737530e5ef7d +Subproject commit a185ce80ba2416b0a0bb04b4ee8f11f1117ae08f From a87525d8d462ed5babf3b148fd24d4ce36f69f82 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Sat, 8 Aug 2026 08:26:28 +0200 Subject: [PATCH 125/155] Fix triggers being deleted when a script creates a lot of them at once (#9724) #### Brief overview of PR changes/additions - One budget of 100 covered every root trigger created while a line was processed, and tripping it deactivated all of them, so a script arming 101 unrelated triggers lost all 101. - Triggers created mid-line now carry the creation lineage they belong to and how many generations deep they sit in it. A batch is one generation however big it is; only a trigger that re-creates itself keeps adding generations, so that is the only shape the budget counts. The limit is 1000 generations, and only the runaway lineage is stopped and named. - Generations do not bound a lineage that widens as it deepens, so past 20000 creations on one line new triggers stop being offered that line. Nothing is disowned there - they are all still armed for the lines that follow. #### Motivation for adding to Mudlet #9697 fixed a real freeze, but its counter had no lineage, so it destroyed legitimate triggers along with the runaway. Any routine arming more than 100 triggers from a trigger loses them, permanent ones included, which is a regression against 4.22.0. #### Other info (issues closed, discussion etc) Fixes a regression introduced by merged #9697; release-blocking for 5.0. Test case: `lua fired=0; tempTrigger("GATE", function() for i=1,200 do tempTrigger("PAY", function() fired=fired+1 end) end end); feedTriggers("\nGATE\n"); feedTriggers("\nPAY\n"); print(fired)` - prints 0 before, 200 after. A/B against a shipped 4.22.0 binary (4.22.0 / 5.0 RC / this PR), counted on the line after the one that armed them: 1001 unrelated temp triggers 1001 / 0 / 1001; two scripts of 600 each 600+600 / 0+0 / 600+600; 1001 permanent triggers 1001 / 0 / 1001. #9697's freeze is still stopped and bounded (601 runaway lines in 8 s, RSS flat at ~820 MB) and its own tests still pass. Eleven new tests parameterise the creation count, and cover nested passes and folder/filter-chain children, which none of #9697's did - that is why this shipped. Assisted-by: Claude:claude-opus-5 --- src/TTrigger.cpp | 40 ++- src/TTrigger.h | 16 + src/TriggerUnit.cpp | 100 ++++-- src/TriggerUnit.h | 48 ++- .../TriggerSameLineMatchTest.cpp | 329 +++++++++++++++++- 5 files changed, 485 insertions(+), 48 deletions(-) diff --git a/src/TTrigger.cpp b/src/TTrigger.cpp index 5be23fa53..3694821b1 100644 --- a/src/TTrigger.cpp +++ b/src/TTrigger.cpp @@ -1297,31 +1297,51 @@ bool TTrigger::compileScript() } namespace { -// Tracks the innermost trigger running its script so feedTriggers() can name the -// culprit when aborting an endless loop; RAII restores the prior value on exit. -class ExecutingTriggerNameGuard +// Tracks the innermost trigger running its script, so feedTriggers() can name the +// culprit when aborting an endless loop, and the same-line creation lineage of +// that trigger's root, so anything the script creates joins it; RAII restores the +// prior values on exit. +class ExecutingTriggerGuard { public: - ExecutingTriggerNameGuard(TriggerUnit* pUnit, const QString* pName) + ExecutingTriggerGuard(TriggerUnit* pUnit, const QString* pName, const int chainId, const int generation) : mpUnit(pUnit) - , mpPrevious(pUnit->currentExecutingTriggerName()) + , mpPreviousName(pUnit->currentExecutingTriggerName()) + , mPreviousChainId(pUnit->currentSameLineChainId()) + , mPreviousGeneration(pUnit->currentSameLineGeneration()) { mpUnit->setCurrentExecutingTriggerName(pName); + mpUnit->setCurrentSameLineChain(chainId, generation); + } + ~ExecutingTriggerGuard() + { + mpUnit->setCurrentExecutingTriggerName(mpPreviousName); + mpUnit->setCurrentSameLineChain(mPreviousChainId, mPreviousGeneration); } - ~ExecutingTriggerNameGuard() { mpUnit->setCurrentExecutingTriggerName(mpPrevious); } - ExecutingTriggerNameGuard(const ExecutingTriggerNameGuard&) = delete; - ExecutingTriggerNameGuard& operator=(const ExecutingTriggerNameGuard&) = delete; + ExecutingTriggerGuard(const ExecutingTriggerGuard&) = delete; + ExecutingTriggerGuard& operator=(const ExecutingTriggerGuard&) = delete; private: TriggerUnit* mpUnit; - const QString* mpPrevious; + const QString* mpPreviousName; + int mPreviousChainId; + int mPreviousGeneration; }; } // namespace void TTrigger::execute() { - const ExecutingTriggerNameGuard executingTriggerNameGuard(mpHost->getTriggerUnit(), &mName); + // Only root triggers carry a lineage, so a trigger nested in a folder or a + // filter chain reads the one on the root its subtree hangs from. Creations + // that go under a parent rather than to the root list are outside this + // accounting altogether, as they are outside the list processDataStream() + // walks. + const TTrigger* pRoot = this; + while (pRoot->getParent()) { + pRoot = pRoot->getParent(); + } + const ExecutingTriggerGuard executingTriggerGuard(mpHost->getTriggerUnit(), &mName, pRoot->sameLineChainId(), pRoot->sameLineGeneration()); if (mSoundTrigger) { /* eventually something should be added to the gui to change sound volumes. 100=full volume */ QString mediaFileName = mSoundFile; diff --git a/src/TTrigger.h b/src/TTrigger.h index d0bc54a88..75d4706c2 100644 --- a/src/TTrigger.h +++ b/src/TTrigger.h @@ -172,6 +172,20 @@ public: int getExpiryCount() const; void setExpiryCount(int expiryCount); + // Set when the trigger is registered as a root node while a line is being + // processed, and cleared when that line is done with - see TriggerUnit's + // same-line creation chains. The id names the lineage this trigger belongs + // to, the generation is how many creations deep in it this trigger sits; + // everything its script creates during that line joins the same lineage one + // generation further down. + int sameLineChainId() const { return mSameLineChainId; } + int sameLineGeneration() const { return mSameLineGeneration; } + void setSameLineChain(const int chainId, const int generation) + { + mSameLineChainId = chainId; + mSameLineGeneration = generation; + } + private: TTrigger() = default; @@ -225,6 +239,8 @@ private: bool mModuleMember = false; // -1: don't self-destruct, 0: delete, 1+: number of times it can still fire int mExpiryCount = -1; + int mSameLineChainId = 0; + int mSameLineGeneration = 0; }; #ifndef QT_NO_DEBUG_STREAM diff --git a/src/TriggerUnit.cpp b/src/TriggerUnit.cpp index 0b7af2dad..d9ca319f8 100644 --- a/src/TriggerUnit.cpp +++ b/src/TriggerUnit.cpp @@ -32,6 +32,7 @@ #include <algorithm> #include <functional> +#include <limits> /* We need an explicit constructor in this file as the Host class is forward * declared in the header file and it is problematic to define any dereferencing @@ -205,13 +206,6 @@ void TriggerUnit::removeTriggerRootNode(TTrigger* pT) mLookupTable.remove(pT->getName(), pT); mTriggerMap.remove(pT->getID()); mTriggerRootNodeList.remove(pT); - // A node can be removed and deleted mid-pass without going through the - // deferred-cleanup paths (e.g. XMLimport discarding its placeholder trigger - // when installPackage() runs from a trigger script), so it must not linger - // in the same-line match list. Null the slot instead of compacting: - // processDataStream() may be walking that list by index right now, and - // shifting entries under it would skip a trigger's same-line match. - std::replace(mRootNodesAddedWhileProcessing.begin(), mRootNodesAddedWhileProcessing.end(), pT, static_cast<TTrigger*>(nullptr)); } TTrigger* TriggerUnit::getTrigger(int id) @@ -243,15 +237,47 @@ bool TriggerUnit::registerTrigger(TTrigger* pT) addTriggerRootNode(pT); if (mProcessingDepth > 0) { mRootNodesAddedWhileProcessing.append(pT); + startOrExtendSameLineChain(pT); } return true; } +// A trigger created by a trigger that was itself created while this line was +// being processed joins that trigger's lineage, one generation further down; +// anything created from a script that predates the line starts a lineage of its +// own at generation one. So a script arming a batch produces a generation of +// one-deep lineages however big the batch, while a trigger that re-creates +// itself keeps adding generations to a single lineage. +void TriggerUnit::startOrExtendSameLineChain(TTrigger* pT) +{ + int chainId = mCurrentSameLineChainId; + if (!chainId) { + if (mLastSameLineChainId == std::numeric_limits<int>::max()) { + mLastSameLineChainId = 0; + } + chainId = ++mLastSameLineChainId; + mSameLineChainStarters.insert(chainId, mpCurrentExecutingTriggerName ? *mpCurrentExecutingTriggerName : QString()); + } + pT->setSameLineChain(chainId, mCurrentSameLineGeneration + 1); +} + void TriggerUnit::unregisterTrigger(TTrigger* pT) { if (!pT) { return; } + // A node can be removed and deleted mid-pass without going through the + // deferred-cleanup paths (e.g. XMLimport discarding its placeholder trigger + // when installPackage() runs from a trigger script), so it must not linger in + // the same-line match list. Done here rather than in removeTriggerRootNode() + // because a trigger that was a root node when it was added to that list can + // have been reparented since, which routes it to removeTrigger() instead. + // Null the slot instead of compacting: processDataStream() may be walking the + // list by index right now, and shifting entries under it would skip a + // trigger's same-line match. Nulling it also takes the trigger out of reach + // of the end-of-pass reset, so drop its lineage here instead. + std::replace(mRootNodesAddedWhileProcessing.begin(), mRootNodesAddedWhileProcessing.end(), pT, static_cast<TTrigger*>(nullptr)); + pT->setSameLineChain(0, 0); if (pT->getParent()) { removeTrigger(pT); return; @@ -307,26 +333,25 @@ int TriggerUnit::getNewID() return ++mMaxID; } -// Stopping the pass is not enough: what the loop created is still live and still -// matching, so the next line would start with a budget's worth of them and each -// would spawn a budget's worth again, costing a multiple of the line before it. -// Everything registered during the pass is disowned, not just the loop's -// offspring: the list records no lineage, so an unrelated capture trigger armed -// on the same line is caught too. Permanent triggers get deactivate() and -// not setIsActive(false), which would clear the user-active state XMLexport saves -// and leave them switched off after a restart. -void TriggerUnit::stopSameLineCreationLoop(const qsizetype firstNodeAddedThisPass) +// Stopping the pass is not enough: what the lineage created is still live and +// still matching, so the next line would start with a budget's worth of them and +// each would spawn a budget's worth again, costing a multiple of the line before +// it. Only the runaway lineage is disowned - a capture trigger an unrelated +// script armed on the same line belongs to a lineage of its own and is left +// alone. The whole list is scanned rather than the tail of this pass: a lineage +// started in an outer pass can go on growing inside a nested feedTriggers() pass, +// and when that nested pass is the one to trip, the earlier members sit below its +// first-node index. Permanent triggers get deactivate() and not setIsActive(false), +// which would clear the user-active state XMLexport saves and leave them switched +// off after a restart. +void TriggerUnit::stopSameLineCreationLoop(const int chainId) { - QString triggerName; int killedCount = 0; int deactivatedCount = 0; - for (qsizetype i = firstNodeAddedThisPass; i < mRootNodesAddedWhileProcessing.size(); ++i) { - auto trigger = mRootNodesAddedWhileProcessing.at(i); - if (!trigger) { + for (auto trigger : std::as_const(mRootNodesAddedWhileProcessing)) { + if (!trigger || trigger->sameLineChainId() != chainId) { continue; } - // keeps the last: the newest link in the chain names the culprit - triggerName = trigger->getName(); if (trigger->isTemporary()) { trigger->setIsActive(false); markCleanup(trigger); @@ -336,10 +361,11 @@ void TriggerUnit::stopSameLineCreationLoop(const qsizetype firstNodeAddedThisPas ++deactivatedCount; } } + const QString triggerName = mSameLineChainStarters.value(chainId); - qWarning().nospace() << "TriggerUnit::processDataStream(...) aborting: triggers created while processing one line reached the limit of " << scmMaxSameLineCreations - << " - probably a trigger that re-creates itself. Profile: " << (mpHost ? mpHost->getName() : QString()) << ", triggers removed: " << killedCount - << ", deactivated: " << deactivatedCount << ", last one created: " << triggerName; + qWarning().nospace() << "TriggerUnit::processDataStream(...) aborting: one lineage of triggers created while processing a line reached " << scmMaxSameLineGenerations + << " generations - probably a trigger that re-creates itself. Profile: " << (mpHost ? mpHost->getName() : QString()) << ", triggers removed: " << killedCount + << ", deactivated: " << deactivatedCount << ", lineage started by: " << triggerName; if (!mpHost) { return; } @@ -392,7 +418,15 @@ void TriggerUnit::processDataStream(const QString& data, int line) if (mProcessingDepth == 0) { // Deletion is deferred while any pass runs, so these pointers stayed // valid; drop them before doCleanup() frees the underlying triggers. + // A trigger that outlives the line it was created on stops being part + // of a lineage, so its own creations start counting afresh. + for (auto trigger : std::as_const(mRootNodesAddedWhileProcessing)) { + if (trigger) { + trigger->setSameLineChain(0, 0); + } + } mRootNodesAddedWhileProcessing.clear(); + mSameLineChainStarters.clear(); doCleanup(); } }); @@ -421,17 +455,25 @@ void TriggerUnit::processDataStream(const QString& data, int line) // current line - so the list grows in front of the loop, and a trigger that // re-creates itself never lets the line finish. Nothing else catches that: no // C++ frame recurses, so mProcessingDepth stays put and the feedTriggers() - // depth guard never sees it. - const qsizetype sameLineCreationBudget = firstNodeAddedThisPass + scmMaxSameLineCreations; + // depth guard never sees it. Only the lineage that is extending itself gets + // stopped; every other lineage the line started carries on matching, which is + // the difference between a runaway and a script arming a batch of triggers. for (qsizetype i = firstNodeAddedThisPass; i < mRootNodesAddedWhileProcessing.size(); ++i) { - if (i >= sameLineCreationBudget) { - stopSameLineCreationLoop(firstNodeAddedThisPass); + if (i - firstNodeAddedThisPass >= scmMaxSameLineCreationsPerLine) { + qWarning().nospace() << "TriggerUnit::processDataStream(...) stopping: more than " << scmMaxSameLineCreationsPerLine + << " triggers were created while processing one line, so the rest are not being offered it. Profile: " << (mpHost ? mpHost->getName() : QString()); break; } auto trigger = mRootNodesAddedWhileProcessing.at(i); if (!trigger || !trigger->isActive()) { continue; } + // stopSameLineCreationLoop() deactivates the whole lineage, so the check + // above skips its remaining members and this loop reaches a lineage once + if (trigger->sameLineGeneration() > scmMaxSameLineGenerations) { + stopSameLineCreationLoop(trigger->sameLineChainId()); + continue; + } trigger->match(subject, data, line); } free(subject); diff --git a/src/TriggerUnit.h b/src/TriggerUnit.h index e8adbdeaa..95ab96c36 100644 --- a/src/TriggerUnit.h +++ b/src/TriggerUnit.h @@ -28,6 +28,7 @@ #include <QCoreApplication> #include <QElapsedTimer> +#include <QHash> #include <QMultiMap> #include <QPointer> #include <QSet> @@ -84,16 +85,39 @@ public: // is deferred to doCleanup() once mProcessingDepth returns to 0. const QString* currentExecutingTriggerName() const { return mpCurrentExecutingTriggerName; } void setCurrentExecutingTriggerName(const QString* pName) { mpCurrentExecutingTriggerName = pName; } + // The same-line creation lineage of the root of the trigger whose script is + // running, so a trigger it creates joins that lineage rather than starting + // one - see registerTrigger(). Zero while no trigger script is running (an + // alias or a timer counts as none), or while the running one predates the + // line being processed. + int currentSameLineChainId() const { return mCurrentSameLineChainId; } + int currentSameLineGeneration() const { return mCurrentSameLineGeneration; } + void setCurrentSameLineChain(const int chainId, const int generation) + { + mCurrentSameLineChainId = chainId; + mCurrentSameLineGeneration = generation; + } // Turns an endless self-feeding-trigger loop into a catchable Lua error before // it overflows the stack. Sized for the smallest platform stack (~1MB on // Windows, where the original crash hit before Lua's own 200-C-call guard): // a few times any legitimate nesting, comfortably below the native limit. inline static const int scmMaxProcessingDepth = 50; - // How many triggers created while one line is processed may match that same - // line. Separate from the depth above, which measures the C stack: nothing - // recurses here, it is the list processDataStream() walks that grows. A - // room-capture script needs a handful, so 100 is ample. - inline static const qsizetype scmMaxSameLineCreations = 100; + // How many creations deep one lineage of same-line creations may go while a + // single line is processed. Separate from the depth above, which measures the + // C stack: nothing recurses here, it is the list processDataStream() walks + // that grows. Generations rather than a head count is what separates the two + // shapes: a script arming a batch produces one generation however big the + // batch, while a trigger that re-creates itself adds a generation per round + // and is the only thing that can go on forever. 1000 is far past any chain a + // real script builds. + inline static const int scmMaxSameLineGenerations = 1000; + // Generations alone do not bound what one line costs: a lineage that widens + // as it deepens multiplies. Past this many creations new triggers stop being + // offered the line, and since matching is what makes them create more, that + // ends the growth. Nothing is stopped or disowned here - all of them are + // still armed for the lines that follow - so it can sit well clear of any + // legitimate batch. + inline static const qsizetype scmMaxSameLineCreationsPerLine = 20000; QList<TTrigger*> uninstallList; @@ -105,7 +129,8 @@ private: void addTrigger(TTrigger* pT); void removeTriggerRootNode(TTrigger* pT); void removeTrigger(TTrigger*); - void stopSameLineCreationLoop(const qsizetype firstNodeAddedThisPass); + void startOrExtendSameLineChain(TTrigger* pT); + void stopSameLineCreationLoop(const int chainId); QPointer<Host> mpHost; QMap<int, TTrigger*> mTriggerMap; @@ -124,6 +149,17 @@ private: // pass can match the ones created during it against the line being // processed - see processDataStream(). Cleared once the outermost pass ends. QList<TTrigger*> mRootNodesAddedWhileProcessing; + // The name of the trigger whose script started each same-line creation + // lineage, for the message when one runs away. Keyed by chain id, so a + // trigger dying mid-line cannot leave a stale pointer behind. Cleared once + // the outermost pass ends. + QHash<int, QString> mSameLineChainStarters; + int mCurrentSameLineChainId = 0; + int mCurrentSameLineGeneration = 0; + // Handed out monotonically and never deliberately recycled: an id that + // outlived the pass it was given out in would otherwise be misfiled under a + // later lineage. Zero means "none". + int mLastSameLineChainId = 0; QElapsedTimer mSameLineLoopReportTimer; }; diff --git a/test/functional_tests/TriggerSameLineMatchTest.cpp b/test/functional_tests/TriggerSameLineMatchTest.cpp index cdc81d135..b141a7f54 100644 --- a/test/functional_tests/TriggerSameLineMatchTest.cpp +++ b/test/functional_tests/TriggerSameLineMatchTest.cpp @@ -225,7 +225,7 @@ private slots: QVERIFY2(bufferContains(qsl("Trigger processing stopped to prevent a freeze")), "Expected the same-line re-creation abort error in the console buffer"); // one fire from the trigger already there, then one per budgeted creation; // the trailing # keeps the check from also passing on ten times the number - const int expectedFires = 1 + static_cast<int>(TriggerUnit::scmMaxSameLineCreations); + const int expectedFires = 1 + TriggerUnit::scmMaxSameLineGenerations; QVERIFY2(bufferContains(qsl("LOOPFIRES=%1#").arg(expectedFires)), qPrintable(qsl("Expected the re-arming trigger to fire exactly %1 times").arg(expectedFires))); } @@ -288,7 +288,7 @@ private slots: "echo('KEPTFIRES=' .. keptFires .. '#\\n')\n")); QCOMPARE(host->getTriggerUnit()->processingDepth(), 0); - const int firesPerLine = 1 + static_cast<int>(TriggerUnit::scmMaxSameLineCreations); + const int firesPerLine = 1 + TriggerUnit::scmMaxSameLineGenerations; QVERIFY2(bufferContains(qsl("KEPTFIRES=%1#").arg(2 * firesPerLine)), qPrintable(qsl("Expected the second line to cost the same %1 fires as the first, not a multiple of them").arg(firesPerLine))); } @@ -313,7 +313,7 @@ private slots: "echo('PERMACTIVE=' .. isActive('Perm Loop', 'trigger') .. '#\\n')\n" "echo('PERMEXISTS=' .. exists('Perm Loop', 'trigger') .. '#\\n')\n")); - const int expectedFires = 1 + static_cast<int>(TriggerUnit::scmMaxSameLineCreations); + const int expectedFires = 1 + TriggerUnit::scmMaxSameLineGenerations; QCOMPARE(host->getTriggerUnit()->processingDepth(), 0); QVERIFY2(bufferContains(qsl("Trigger processing stopped to prevent a freeze")), "Expected a permanent trigger re-creating itself to be stopped too"); QVERIFY2(bufferContains(qsl("PERMFIRES=%1#").arg(expectedFires)), qPrintable(qsl("Expected the re-arming permanent trigger to fire exactly %1 times").arg(expectedFires))); @@ -321,6 +321,329 @@ private slots: QVERIFY2(bufferContains(qsl("PERMEXISTS=%1#").arg(expectedFires + 1)), "Expected the stopped permanent triggers to still exist - stopping them is not deleting them"); } + // A script arming a batch of unrelated triggers is not a runaway, however + // big the batch: each of them starts a creation chain of its own, and none + // of those chains ever gets a second link. + void test_bulkUnrelatedCreationsAreNotStopped() + { + startProfile(mpHostname, mpLocalhost, mpPort); + auto* host = mudlet::self()->getActiveHost(); + QVERIFY(host); + host->mEchoLuaErrors = true; + + const int bulkCount = TriggerUnit::scmMaxSameLineGenerations + 1; + host->getLuaInterpreter()->compileAndExecuteScript(qsl("bulkFires = 0\n" + "tempRegexTrigger('^bulkgate$', [=[\n" + " for i = 1, %1 do\n" + " tempRegexTrigger('^bulkpay$', [[bulkFires = bulkFires + 1]])\n" + " end\n" + "]=], 1)\n" + "feedTriggers('bulkgate\\n')\n" + "feedTriggers('bulkpay\\n')\n" + "echo('BULKFIRES=' .. bulkFires .. '#\\n')\n") + .arg(bulkCount)); + + QCOMPARE(host->getTriggerUnit()->processingDepth(), 0); + QVERIFY2(!bufferContains(qsl("Trigger processing stopped to prevent a freeze")), "A batch of unrelated triggers must not be mistaken for a trigger re-creating itself"); + QVERIFY2(bufferContains(qsl("BULKFIRES=%1#").arg(bulkCount)), qPrintable(qsl("Expected all %1 triggers armed on the previous line to survive and fire").arg(bulkCount))); + } + + // Two scripts arming triggers on one line get a budget each, so neither can + // exhaust the other's - together they come to more than one budget's worth. + void test_twoScriptsArmingOnOneLineKeepBothSetsOfTriggers() + { + startProfile(mpHostname, mpLocalhost, mpPort); + auto* host = mudlet::self()->getActiveHost(); + QVERIFY(host); + host->mEchoLuaErrors = true; + + const int eachCount = (TriggerUnit::scmMaxSameLineGenerations / 2) + 1; + host->getLuaInterpreter()->compileAndExecuteScript(qsl("firesA, firesB = 0, 0\n" + "tempRegexTrigger('^sharedgate$', [=[\n" + " for i = 1, %1 do\n" + " tempRegexTrigger('^payA$', [[firesA = firesA + 1]])\n" + " end\n" + "]=], 1)\n" + "tempRegexTrigger('^sharedgate$', [=[\n" + " for i = 1, %1 do\n" + " tempRegexTrigger('^payB$', [[firesB = firesB + 1]])\n" + " end\n" + "]=], 1)\n" + "feedTriggers('sharedgate\\n')\n" + "feedTriggers('payA\\n')\n" + "feedTriggers('payB\\n')\n" + "echo('SHARED=' .. firesA .. ',' .. firesB .. '#\\n')\n") + .arg(eachCount)); + + QCOMPARE(host->getTriggerUnit()->processingDepth(), 0); + QVERIFY2(bufferContains(qsl("SHARED=%1,%1#").arg(eachCount)), qPrintable(qsl("Expected both scripts to keep all %1 of the triggers they armed").arg(eachCount))); + } + + // The batch is armed by a trigger that was itself created on this line, so + // creator and batch share a lineage. Counting a lineage's members rather than + // its generations condemns the whole batch here, which is the room-capture + // shape: the room-title trigger creates the capture trigger, and the capture + // trigger is what arms the batch. + void test_bulkCreationsFromAMidLineTriggerAreNotStopped() + { + startProfile(mpHostname, mpLocalhost, mpPort); + auto* host = mudlet::self()->getActiveHost(); + QVERIFY(host); + host->mEchoLuaErrors = true; + + const int bulkCount = TriggerUnit::scmMaxSameLineGenerations + 1; + host->getLuaInterpreter()->compileAndExecuteScript(qsl("deepFires = 0\n" + "tempRegexTrigger('^deepgate$', [===[\n" + " tempRegexTrigger('^deepgate$', [==[\n" + " for i = 1, %1 do\n" + " tempRegexTrigger('^deeppay$', [[deepFires = deepFires + 1]])\n" + " end\n" + " ]==], 1)\n" + "]===], 1)\n" + "feedTriggers('deepgate\\n')\n" + "feedTriggers('deeppay\\n')\n" + "echo('DEEPFIRES=' .. deepFires .. '#\\n')\n") + .arg(bulkCount)); + + QCOMPARE(host->getTriggerUnit()->processingDepth(), 0); + QVERIFY2(!bufferContains(qsl("Trigger processing stopped to prevent a freeze")), "A batch is one generation wherever it is armed from, and must not be mistaken for a runaway"); + QVERIFY2(bufferContains(qsl("DEEPFIRES=%1#").arg(bulkCount)), qPrintable(qsl("Expected all %1 triggers armed by a trigger created on the same line to survive and fire").arg(bulkCount))); + } + + // Permanent triggers take the same path, and are the more painful loss - a + // "rebuild my triggers when the game says X" routine arms them in bulk. + void test_bulkPermanentCreationsAreNotStopped() + { + startProfile(mpHostname, mpLocalhost, mpPort); + auto* host = mudlet::self()->getActiveHost(); + QVERIFY(host); + host->mEchoLuaErrors = true; + + const int bulkCount = TriggerUnit::scmMaxSameLineGenerations + 1; + host->getLuaInterpreter()->compileAndExecuteScript(qsl("permBulkFires = 0\n" + "function permBulkStep() permBulkFires = permBulkFires + 1 end\n" + "tempRegexTrigger('^permgate$', [=[\n" + " for i = 1, %1 do\n" + " permRegexTrigger('PermBulk' .. i, '', {'^permpay$'}, [[permBulkStep()]])\n" + " end\n" + "]=], 1)\n" + "feedTriggers('permgate\\n')\n" + "feedTriggers('permpay\\n')\n" + "echo('PERMBULK=' .. permBulkFires .. '#\\n')\n" + "echo('PERMBULKACTIVE=' .. isActive('PermBulk%1', 'trigger') .. '#\\n')\n") + .arg(bulkCount)); + + QCOMPARE(host->getTriggerUnit()->processingDepth(), 0); + QVERIFY2(bufferContains(qsl("PERMBULK=%1#").arg(bulkCount)), qPrintable(qsl("Expected all %1 permanent triggers armed on the previous line to survive and fire").arg(bulkCount))); + QVERIFY2(bufferContains(qsl("PERMBULKACTIVE=1#")), "Expected the permanent triggers to be left switched on"); + } + + // The whole point of the budget being per chain: the runaway loses its + // triggers, the script that happened to arm a trigger on the same line does not. + void test_runawayChainSparesTriggersFromOtherScripts() + { + startProfile(mpHostname, mpLocalhost, mpPort); + auto* host = mudlet::self()->getActiveHost(); + QVERIFY(host); + host->mEchoLuaErrors = true; + + host->getLuaInterpreter()->compileAndExecuteScript(qsl("innocentFires = 0\n" + "function armRunaway()\n" + " tempRegexTrigger('^runline$', [[armRunaway()]], 1)\n" + "end\n" + "armRunaway()\n" + "tempRegexTrigger('^runline$', [=[\n" + " tempRegexTrigger('^innocent$', [[innocentFires = innocentFires + 1]])\n" + "]=], 1)\n" + "feedTriggers('runline\\n')\n" + "feedTriggers('innocent\\n')\n" + "echo('INNOCENT=' .. innocentFires .. '#\\n')\n")); + + QCOMPARE(host->getTriggerUnit()->processingDepth(), 0); + QVERIFY2(bufferContains(qsl("Trigger processing stopped to prevent a freeze")), "Expected the self-recreating chain to still be stopped"); + QVERIFY2(bufferContains(qsl("INNOCENT=1#")), "Expected the trigger armed by an unrelated script on the same line to survive the runaway's abort and fire"); + } + + // A lineage of exactly the budget's depth ends on its own; the trip is on the + // generation after it, which test_selfRecreatingTriggerIsStopped() pins from + // the other side. Both land on the same fire count, so the presence or + // absence of the abort message is what tells the two apart. + void test_chainExactlyAtTheLimitIsNotStopped() + { + startProfile(mpHostname, mpLocalhost, mpPort); + auto* host = mudlet::self()->getActiveHost(); + QVERIFY(host); + host->mEchoLuaErrors = true; + + const int limit = TriggerUnit::scmMaxSameLineGenerations; + host->getLuaInterpreter()->compileAndExecuteScript(qsl("boundFires = 0\n" + "function boundStep()\n" + " boundFires = boundFires + 1\n" + " if boundFires <= %1 then\n" + " tempRegexTrigger('^boundline$', [[boundStep()]], 1)\n" + " end\n" + "end\n" + "tempRegexTrigger('^boundline$', [[boundStep()]], 1)\n" + "feedTriggers('boundline\\n')\n" + "echo('BOUNDFIRES=' .. boundFires .. '#\\n')\n") + .arg(limit)); + + QCOMPARE(host->getTriggerUnit()->processingDepth(), 0); + QVERIFY2(!bufferContains(qsl("Trigger processing stopped to prevent a freeze")), "A chain of exactly the budget's length ends on its own and must not be stopped"); + QVERIFY2(bufferContains(qsl("BOUNDFIRES=%1#").arg(limit + 1)), qPrintable(qsl("Expected the chain to run to its own end, %1 fires").arg(limit + 1))); + } + + // Once the line that created a trigger is done with, that trigger is as + // ordinary as any other and what it creates starts fresh chains - otherwise + // it would carry its creator's chain around for the rest of the session. + void test_aTriggerOutlivingItsLineStartsFreshChains() + { + startProfile(mpHostname, mpLocalhost, mpPort); + auto* host = mudlet::self()->getActiveHost(); + QVERIFY(host); + host->mEchoLuaErrors = true; + + const int bulkCount = TriggerUnit::scmMaxSameLineGenerations + 1; + host->getLuaInterpreter()->compileAndExecuteScript(qsl("laterFires = 0\n" + "tempRegexTrigger('^egate$', [==[\n" + " tempRegexTrigger('^esecond$', [=[\n" + " for i = 1, %1 do\n" + " tempRegexTrigger('^epay$', [[laterFires = laterFires + 1]])\n" + " end\n" + " ]=], 1)\n" + "]==], 1)\n" + "feedTriggers('egate\\n')\n" + "feedTriggers('esecond\\n')\n" + "feedTriggers('epay\\n')\n" + "echo('LATERFIRES=' .. laterFires .. '#\\n')\n") + .arg(bulkCount)); + + QCOMPARE(host->getTriggerUnit()->processingDepth(), 0); + QVERIFY2(!bufferContains(qsl("Trigger processing stopped to prevent a freeze")), "A trigger created on an earlier line is not part of a chain any more and must arm freely"); + QVERIFY2(bufferContains(qsl("LATERFIRES=%1#").arg(bulkCount)), qPrintable(qsl("Expected all %1 triggers armed on the later line to survive and fire").arg(bulkCount))); + } + + // A lineage that starts in the outer pass and runs away inside a nested + // feedTriggers() has members either side of the nested pass's first-node + // index, which is why stopping one scans the whole list rather than the + // tail of the tripping pass. Scanning only the tail leaves the first link + // alive, and the outer pass then has to trip on the same lineage all over + // again - the fire count is what shows that, at twice this number. + void test_runawayCrossingIntoANestedPassIsStoppedWhole() + { + startProfile(mpHostname, mpLocalhost, mpPort); + auto* host = mudlet::self()->getActiveHost(); + QVERIFY(host); + host->mEchoLuaErrors = true; + + host->getLuaInterpreter()->compileAndExecuteScript(qsl("nestFires, nestSafeFires = 0, 0\n" + "function armNested()\n" + " tempRegexTrigger('^nestin$', [[nestFires = nestFires + 1; armNested()]])\n" + "end\n" + "tempRegexTrigger('^nestout$', [=[\n" + " armNested()\n" + " tempRegexTrigger('^nestsafe$', [[nestSafeFires = nestSafeFires + 1]])\n" + " feedTriggers('nestin\\n')\n" + "]=], 1)\n" + "feedTriggers('nestout\\n')\n" + "echo('NESTFIRES=' .. nestFires .. '#\\n')\n" + "nestFires = 0\n" + "feedTriggers('nestin\\n')\n" + "feedTriggers('nestsafe\\n')\n" + "echo('NESTAFTER=' .. nestFires .. '#\\n')\n" + "echo('NESTSAFE=' .. nestSafeFires .. '#\\n')\n")); + + QCOMPARE(host->getTriggerUnit()->processingDepth(), 0); + QVERIFY2(bufferContains(qsl("Trigger processing stopped to prevent a freeze")), "Expected a runaway that crosses into a nested pass to be stopped"); + QVERIFY2(bufferContains(qsl("NESTFIRES=%1#").arg(TriggerUnit::scmMaxSameLineGenerations)), "Expected the runaway to cost one budget, not one per pass the lineage is spread across"); + QVERIFY2(bufferContains(qsl("NESTAFTER=0#")), "Expected no member of the stopped lineage to be left armed, wherever in the list it sat"); + QVERIFY2(bufferContains(qsl("NESTSAFE=1#")), "Expected a trigger armed by an unrelated script on the outer line to survive the nested pass's abort"); + } + + // Creations made inside a nested pass are appended to the same list the outer + // pass is walking, so a batch armed there has to be read as one generation + // just the same. + void test_bulkCreationsInsideANestedPassAreNotStopped() + { + startProfile(mpHostname, mpLocalhost, mpPort); + auto* host = mudlet::self()->getActiveHost(); + QVERIFY(host); + host->mEchoLuaErrors = true; + + const int bulkCount = TriggerUnit::scmMaxSameLineGenerations + 1; + host->getLuaInterpreter()->compileAndExecuteScript(qsl("crossFires = 0\n" + "tempRegexTrigger('^crossout$', [==[\n" + " tempRegexTrigger('^crossin$', [=[\n" + " for i = 1, %1 do\n" + " tempRegexTrigger('^crosspay$', [[crossFires = crossFires + 1]])\n" + " end\n" + " ]=], 1)\n" + " feedTriggers('crossin\\n')\n" + "]==], 1)\n" + "feedTriggers('crossout\\n')\n" + "feedTriggers('crosspay\\n')\n" + "echo('CROSSFIRES=' .. crossFires .. '#\\n')\n") + .arg(bulkCount)); + + QCOMPARE(host->getTriggerUnit()->processingDepth(), 0); + QVERIFY2(!bufferContains(qsl("Trigger processing stopped to prevent a freeze")), "A batch armed inside a nested pass is still one generation and must not be stopped"); + QVERIFY2(bufferContains(qsl("CROSSFIRES=%1#").arg(bulkCount)), qPrintable(qsl("Expected all %1 triggers armed inside the nested pass to survive and fire").arg(bulkCount))); + } + + // Only root triggers carry a lineage, so a trigger sitting in a folder creates + // on the folder's behalf. Read the child's own (always empty) lineage instead + // and every round would start a fresh one, which never deepens and so never + // trips - the run would only end at the per-line creation ceiling. + void test_folderChildCreatesOnItsRootsBehalf() + { + startProfile(mpHostname, mpLocalhost, mpPort); + auto* host = mudlet::self()->getActiveHost(); + QVERIFY(host); + host->mEchoLuaErrors = true; + + host->getLuaInterpreter()->compileAndExecuteScript(qsl("folderFires, folderCount = 0, 0\n" + "function makeFolderGen()\n" + " folderCount = folderCount + 1\n" + " local name = 'FGen' .. folderCount\n" + " permGroup(name, 'trigger')\n" + " permRegexTrigger('FChild' .. folderCount, name, {'^folderloop$'}, [[folderFires = folderFires + 1; makeFolderGen()]])\n" + "end\n" + "makeFolderGen()\n" + "feedTriggers('folderloop\\n')\n" + "echo('FOLDERFIRES=' .. folderFires .. '#\\n')\n")); + + QCOMPARE(host->getTriggerUnit()->processingDepth(), 0); + QVERIFY2(bufferContains(qsl("Trigger processing stopped to prevent a freeze")), "Expected a runaway driven from inside a folder to be stopped"); + QVERIFY2(bufferContains(qsl("FOLDERFIRES=%1#").arg(1 + TriggerUnit::scmMaxSameLineGenerations)), + "Expected the folder's lineage to deepen by one per round, so the generation budget is what ends it"); + } + + // The same for a filter chain, where the child is reached through the parent's + // capture rather than by the root list passing data down. + void test_filterChainChildCreatesOnItsRootsBehalf() + { + startProfile(mpHostname, mpLocalhost, mpPort); + auto* host = mudlet::self()->getActiveHost(); + QVERIFY(host); + host->mEchoLuaErrors = true; + + host->getLuaInterpreter()->compileAndExecuteScript(qsl("filterFires, filterCount = 0, 0\n" + "function makeFilterGen()\n" + " filterCount = filterCount + 1\n" + " local name = 'FiltP' .. filterCount\n" + " tempComplexRegexTrigger(name, '^(filterloop)$', '', 0, 0, 0, 1, 0, 0, 0, 0, 0, 0)\n" + " permRegexTrigger('FiltC' .. filterCount, name, {'filterloop'}, [[filterFires = filterFires + 1; makeFilterGen()]])\n" + "end\n" + "makeFilterGen()\n" + "feedTriggers('filterloop\\n')\n" + "echo('FILTERFIRES=' .. filterFires .. '#\\n')\n")); + + QCOMPARE(host->getTriggerUnit()->processingDepth(), 0); + QVERIFY2(bufferContains(qsl("Trigger processing stopped to prevent a freeze")), "Expected a runaway driven from inside a filter chain to be stopped"); + QVERIFY2(bufferContains(qsl("FILTERFIRES=%1#").arg(1 + TriggerUnit::scmMaxSameLineGenerations)), + "Expected the filter parent's lineage to deepen by one per round, so the generation budget is what ends it"); + } + // The outer line's own mid-pass triggers were registered before the nested // pass began, so its abort must not take them. void test_nestedPassAbortLeavesTheOuterLineAlone() From cf269620cd3379dd10b7eaa35a0d66a1cb2bbd6f Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Sat, 8 Aug 2026 08:26:43 +0200 Subject: [PATCH 126/155] fix: game text no longer loses a character to a stray escape code (#9723) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit #### Brief overview of PR changes/additions - A stray `ESC` from the game ate the byte after it, including the lead byte of a multi-byte character, so `café` arrived as `caf<?>`. - Mudlet now consumes only the escape sequences it recognises: the CSI/OSC/DCS/SOS/PM/APC introducers as before, the two-byte escapes `ESC 7`, `ESC 8`, `ESC c` and `ESC \`, and ISO 2022 character set designation (`ESC ( ) * +` plus the byte naming the set, which is what fixes `ESC ( B`). - Any other byte after an `ESC` is text and is left alone, so a stray escape now costs zero characters. #### Motivation for adding to Mudlet #9433 fixed a real bug - a stray `ESC` staying latched - but over-applied it by consuming any byte `>= 0x20`. Against shipped 4.22.0, `AA<ESC>éBBB` renders as `AAéBBB` there, `AA<U+FFFD>BBB` today, and `AAéBBB` with this PR. Any game that emits a stray escape corrupts accented text for its players. #9433's other fix, the leaking payloads of #7446, is done by the `ESC P X ^ _` branch and is untouched. #### Other info (issues closed, discussion etc) Test case: `lua setServerEncoding("UTF-8") feedTriggers("Menu: caf\27\195\169 au lait\n")` - shows `caf<?>` before, `café` after. 20 new busted tests in `TBufferOSC_spec.lua`, 13 of which fail on an unpatched build; #9433's 8 tests still pass. Trade-off: an escape sequence Mudlet does not recognise prints its final byte as text, exactly as 4.22.0 did, rather than risk eating real output. Assisted-by: Claude:claude-opus-5 --- src/TBuffer.cpp | 44 +++++-- src/TBuffer.h | 6 +- src/mudlet-lua/tests/TBufferOSC_spec.lua | 155 ++++++++++++++++++++--- 3 files changed, 177 insertions(+), 28 deletions(-) diff --git a/src/TBuffer.cpp b/src/TBuffer.cpp index 2f19e9eb6..b40bae218 100644 --- a/src/TBuffer.cpp +++ b/src/TBuffer.cpp @@ -226,6 +226,7 @@ TBuffer::TBuffer(const TBuffer& other) , mEchoingText(other.mEchoingText) , mpConsole(other.mpConsole) , mGotESC(other.mGotESC) +, mGotEscCharset(other.mGotEscCharset) , mGotCSI(other.mGotCSI) , mGotOSC(other.mGotOSC) , mGotString(other.mGotString) @@ -271,6 +272,7 @@ TBuffer::TBuffer(const TBuffer& other) , mWrapDetectSamples(other.mWrapDetectSamples) , mIncompleteSequenceBytes(other.mIncompleteSequenceBytes) , mLocalGotESC(other.mLocalGotESC) +, mLocalGotEscCharset(other.mLocalGotEscCharset) , mLocalGotCSI(other.mLocalGotCSI) , mLocalGotOSC(other.mLocalGotOSC) , mLocalGotString(other.mLocalGotString) @@ -321,6 +323,7 @@ TBuffer& TBuffer::operator=(const TBuffer& other) mEchoingText = other.mEchoingText; mpConsole = other.mpConsole; mGotESC = other.mGotESC; + mGotEscCharset = other.mGotEscCharset; mGotCSI = other.mGotCSI; mGotOSC = other.mGotOSC; mGotString = other.mGotString; @@ -366,6 +369,7 @@ TBuffer& TBuffer::operator=(const TBuffer& other) mWrapDetectSamples = other.mWrapDetectSamples; mIncompleteSequenceBytes = other.mIncompleteSequenceBytes; mLocalGotESC = other.mLocalGotESC; + mLocalGotEscCharset = other.mLocalGotEscCharset; mLocalGotCSI = other.mLocalGotCSI; mLocalGotOSC = other.mLocalGotOSC; mLocalGotString = other.mLocalGotString; @@ -580,6 +584,7 @@ void TBuffer::addLink(bool trigMode, const QString& text, QStringList& command, void TBuffer::swapParserSequenceState() { std::swap(mGotESC, mLocalGotESC); + std::swap(mGotEscCharset, mLocalGotEscCharset); std::swap(mGotCSI, mLocalGotCSI); std::swap(mGotOSC, mLocalGotOSC); std::swap(mGotString, mLocalGotString); @@ -588,9 +593,8 @@ void TBuffer::swapParserSequenceState() void TBuffer::translateToPlainText(std::string& incoming, const bool isFromServer) { - // mGotESC/mGotCSI/mGotOSC/mGotString and mIncompleteSequenceBytes persist - // between calls so that a sequence split across Game Server packets still - // parses. + // The mGot... latches and mIncompleteSequenceBytes persist between calls so + // that a sequence split across Game Server packets still parses. // Locally generated text (feedTriggers(), MMCP chat messages, MXP // insertions) runs through the same parser, so swap in a separate set of // that state for the duration of such a feed - otherwise local text @@ -623,6 +627,11 @@ void TBuffer::translateToPlainTextInner(std::string& incoming, const bool isFrom // What can appear in a CSI final byte position - (includes a backslash // which has to be doubled to include it in here): const QByteArray cFinal = QByteArrayLiteral("@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_`abcdefghijklmnopqrstuvwxyz{|}~"); + // The complete two byte escape sequences (DECSC, DECRC, RIS and a stray + // ST) that games do send and that Mudlet has to swallow. Only these: any + // other byte after an ESC is text, and printing it is no worse than what + // Mudlet has always done, whereas eating it loses real output: + const QByteArray cShortEscape = QByteArrayLiteral("78c\\"); // As well as enabling the prepending of left-over bytes from last packet // from the MUD server this may help in high frequency interactions to @@ -749,11 +758,22 @@ void TBuffer::translateToPlainTextInner(std::string& incoming, const bool isFrom } mGotESC = true; + mGotEscCharset = false; ++localBufferPosition; continue; } } + if (mGotEscCharset) { + mGotEscCharset = false; + if (static_cast<unsigned char>(ch) >= 0x30 && static_cast<unsigned char>(ch) <= 0x7E) { + ++localBufferPosition; + continue; + } + // Only a final byte can name a character set, so this was a stray + // ESC after all and the byte is text. + } + if (mGotESC) { mGotESC = false; if (ch == '[' || ch == ']') { @@ -771,16 +791,20 @@ void TBuffer::translateToPlainTextInner(std::string& incoming, const bool isFrom ++localBufferPosition; continue; } - if (static_cast<unsigned char>(ch) >= 0x20) { - // The final byte of some other escape sequence (e.g. ESC 7 - // or ESC M) that Mudlet does not handle - consume it silently - // as a real terminal would instead of showing it as text: + if (ch == '(' || ch == ')' || ch == '*' || ch == '+') { + // An ISO 2022 character set designation such as ESC ( B; the + // byte after this one names the set: + mGotEscCharset = true; ++localBufferPosition; continue; } - // A control character straight after the ESC means the escape - // sequence is malformed - abandon it (the latch was already - // cleared above) and process the character normally: + if (cShortEscape.indexOf(ch) >= 0) { + ++localBufferPosition; + continue; + } + // Any other byte is text: a stray ESC in the game's output must + // not swallow it, and consuming a multibyte character's lead byte + // would orphan its continuation bytes. } if (mGotCSI) { diff --git a/src/TBuffer.h b/src/TBuffer.h index a9dba150d..0bbd87f60 100644 --- a/src/TBuffer.h +++ b/src/TBuffer.h @@ -448,6 +448,9 @@ private: // First stage in decoding SGR/OCS sequences - set true when we see the // ASCII ESC character: bool mGotESC = false; + // Set between the ESC '(', ')', '*' or '+' of an ISO 2022 character set + // designation and the byte that names the set: + bool mGotEscCharset = false; // Second stage in decoding SGR sequences - set true when we see the ASCII // ESC character followed by the '[' one: bool mGotCSI = false; @@ -529,13 +532,14 @@ private: // translateToPlainText()}: std::string mIncompleteSequenceBytes; - // The parser sequence state (mGotESC, mGotCSI, mGotOSC, mGotString and + // The parser sequence state (the mGot... latches and // mIncompleteSequenceBytes) for whichever of the two data channels - Game // Server stream or locally generated text - is not currently being // processed; translateToPlainText() swaps it in around a local feed so // that such text cannot consume or clear a latch belonging to a sequence // split across Game Server packets (and vice versa): bool mLocalGotESC = false; + bool mLocalGotEscCharset = false; bool mLocalGotCSI = false; bool mLocalGotOSC = false; bool mLocalGotString = false; diff --git a/src/mudlet-lua/tests/TBufferOSC_spec.lua b/src/mudlet-lua/tests/TBufferOSC_spec.lua index 8258f537e..2ca6d08d5 100644 --- a/src/mudlet-lua/tests/TBufferOSC_spec.lua +++ b/src/mudlet-lua/tests/TBufferOSC_spec.lua @@ -1,9 +1,22 @@ --- Test for OSC sequence buffer underflow protection --- This test verifies the fix for a buffer underflow bug in TBuffer::translateToPlainText() --- when processing OSC (Operating System Command) sequences at the beginning of a buffer. +-- How TBuffer::translateToPlainText() handles the out-of-band sequences that +-- arrive mixed into the game's text: OSC, the DCS/SOS/PM/APC string sequences +-- and escape sequences that Mudlet does not act on. describe("Tests TBuffer OSC sequence handling", function() - + + -- feedTriggers writes to the main console; fish the line carrying our + -- unique marker back out of the buffer to see what actually rendered + local function findRecentLine(needle) + local lastLine = getLastLineNumber("main") + local lines = getLines("main", math.max(0, lastLine - 15), lastLine + 1) + for i = #lines, 1, -1 do + if lines[i]:find(needle, 1, true) then + return lines[i] + end + end + return nil + end + describe("Tests the protection against buffer underflow in OSC sequences", function() it("should handle OSC sequences at buffer start without crashing", function() @@ -95,19 +108,6 @@ describe("Tests TBuffer OSC sequence handling", function() describe("Tests ANSI string sequence handling (DCS, SOS, PM, APC)", function() - -- feedTriggers writes to the main console; fish the line carrying our - -- unique marker back out of the buffer to see what actually rendered - local function findRecentLine(needle) - local lastLine = getLastLineNumber("main") - local lines = getLines("main", math.max(0, lastLine - 15), lastLine + 1) - for i = #lines, 1, -1 do - if lines[i]:find(needle, 1, true) then - return lines[i] - end - end - return nil - end - it("should swallow an APC sequence terminated by ST", function() assert.is_true(feedTriggers("APCST1(\027_secret apc payload\027\\)APCST1\n")) assert.equals("APCST1()APCST1", findRecentLine("APCST1")) @@ -151,4 +151,125 @@ describe("Tests TBuffer OSC sequence handling", function() end) + describe("Tests escape sequences that Mudlet does not handle", function() + + local previousEncoding + + -- these tests are not encoding agnostic: feedTriggers transcodes its UTF-8 + -- argument into the server encoding, so under anything else the "\195\169" + -- pairs below reach the parser as a single byte and stop exercising the + -- multibyte lead byte that it must not swallow + setup(function() + previousEncoding = getServerEncoding() + setServerEncoding("UTF-8") + end) + + teardown(function() + setServerEncoding(previousEncoding) + end) + + it("should consume the two-byte escapes it recognises", function() + assert.is_true(feedTriggers("TWOBYTE1(\027" .. "7|\027" .. "8|\027c)TWOBYTE1\n")) + assert.equals("TWOBYTE1(||)TWOBYTE1", findRecentLine("TWOBYTE1")) + end) + + it("should keep the byte of a two-byte escape it does not recognise", function() + assert.is_true(feedTriggers("UNKNOWN1(\027M\027D\027>\027=)UNKNOWN1\n")) + assert.equals("UNKNOWN1(MD>=)UNKNOWN1", findRecentLine("UNKNOWN1")) + end) + + it("should consume a character set designation", function() + assert.is_true(feedTriggers("CHARSET1(\027(B)CHARSET1\n")) + assert.equals("CHARSET1()CHARSET1", findRecentLine("CHARSET1")) + end) + + it("should not let a CSI introducer name a character set and start a CSI", function() + assert.is_true(feedTriggers("GUARD1(\027([31mred\027[0m)GUARD1\n")) + assert.equals("GUARD1(31mred)GUARD1", findRecentLine("GUARD1")) + end) + + it("should not let an APC introducer name a character set and start a string sequence", function() + assert.is_true(feedTriggers("GUARD2(\027(_payload)GUARD2\n")) + assert.equals("GUARD2(payload)GUARD2", findRecentLine("GUARD2")) + end) + + it("should restart the sequence when an escape follows a designation", function() + assert.is_true(feedTriggers("RELATCH1(\027(\027[31mred\027[0m)RELATCH1\n")) + assert.equals("RELATCH1(red)RELATCH1", findRecentLine("RELATCH1")) + end) + + it("should keep the letter after a stray escape", function() + assert.is_true(feedTriggers("STRAY1(\027ABC)STRAY1\n")) + assert.equals("STRAY1(ABC)STRAY1", findRecentLine("STRAY1")) + end) + + it("should keep the digit after a stray escape", function() + assert.is_true(feedTriggers("STRAY2(\027" .. "1234)STRAY2\n")) + assert.equals("STRAY2(1234)STRAY2", findRecentLine("STRAY2")) + end) + + it("should keep the text after several stray escapes", function() + assert.is_true(feedTriggers("STRAY3(\027A\027BCD)STRAY3\n")) + assert.equals("STRAY3(ABCD)STRAY3", findRecentLine("STRAY3")) + end) + + it("should keep a run of punctuation after a stray escape", function() + assert.is_true(feedTriggers("PUNCT1(\027--- Hello)PUNCT1\n")) + assert.equals("PUNCT1(--- Hello)PUNCT1", findRecentLine("PUNCT1")) + end) + + it("should keep a space after a stray escape", function() + assert.is_true(feedTriggers("PUNCT2(\027 spaced)PUNCT2\n")) + assert.equals("PUNCT2( spaced)PUNCT2", findRecentLine("PUNCT2")) + end) + + it("should keep a multibyte character that follows a stray escape", function() + assert.is_true(feedTriggers("UTF8ESC1(caf\027\195\169)UTF8ESC1\n")) + assert.equals("UTF8ESC1(caf\195\169)UTF8ESC1", findRecentLine("UTF8ESC1")) + end) + + it("should keep a multibyte character that cannot name a character set", function() + assert.is_true(feedTriggers("UTF8ESC2(\027(\195\169)UTF8ESC2\n")) + assert.equals("UTF8ESC2(\195\169)UTF8ESC2", findRecentLine("UTF8ESC2")) + end) + + it("should keep a line break that follows a stray escape", function() + assert.is_true(feedTriggers("NLESC1(\027\nNLESC2)\n")) + assert.equals("NLESC1(", findRecentLine("NLESC1")) + assert.equals("NLESC2)", findRecentLine("NLESC2")) + end) + + it("should keep a line break that cannot name a character set", function() + assert.is_true(feedTriggers("NLESC3(\027(\nNLESC4)\n")) + assert.equals("NLESC3(", findRecentLine("NLESC3")) + assert.equals("NLESC4)", findRecentLine("NLESC4")) + end) + + it("should apply a trailing escape to the next packet", function() + assert.is_true(feedTriggers("SPLITESC1(\027")) + assert.is_true(feedTriggers("7 then ABC)SPLITESC1\n")) + assert.equals("SPLITESC1( then ABC)SPLITESC1", findRecentLine("SPLITESC1")) + end) + + it("should apply a trailing designation to the next packet", function() + assert.is_true(feedTriggers("SPLITINT1(\027(")) + assert.is_true(feedTriggers("B)SPLITINT1\n")) + assert.equals("SPLITINT1()SPLITINT1", findRecentLine("SPLITINT1")) + end) + + it("should not eat a multibyte character starting the next packet", function() + assert.is_true(feedTriggers("SPLITESC2(\027")) + assert.is_true(feedTriggers("\195\169)SPLITESC2\n")) + assert.equals("SPLITESC2(\195\169)SPLITESC2", findRecentLine("SPLITESC2")) + end) + + it("should keep an 8-bit character that follows a stray escape", function() + setServerEncoding("ISO 8859-1") + assert.is_true(feedTriggers("LATIN1(\027\195\169)LATIN1\n")) + assert.equals("LATIN1(\195\169)LATIN1", findRecentLine("LATIN1")) + setServerEncoding("UTF-8") + end) + + end) + end) From 045a25615897ea0bad76a1c7839645b230b24d27 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Sat, 8 Aug 2026 08:30:14 +0200 Subject: [PATCH 127/155] fix: a profile named "." or ".." deletes every profile when removed (#9722) #### Brief overview of PR changes/additions - Validation: a typed profile name must be a folder of its own - rejects a lone `.` and anything containing `..`. Folders already on disk stay exempt - Containment: `reallyDeleteProfile()` refuses any path that is not a direct child of `profiles/`, and now checks `removeRecursively()` instead of failing mute - Confirmation: the "nothing to delete" shortcut no longer fires when a map, stored password or dictionary is present #### Motivation for adding to Mudlet A profile named `.` or `..` turned **Remove** into a wipe: `.` resolves to `profiles/`, `..` to the whole `~/.config/mudlet`. The name was accepted with no error, and the confirmation was skipped because a fresh profile looks empty - two clicks deep on the first screen every user sees. #### Other info (issues closed, discussion etc) Pre-existing, not a 5.0 regression - shipped 4.22.0 behaves identically. Dots have been allowed deliberately since 2011 (`ee1fd051c`), and `Achaea 2.0` keeps working. **Test case:** name a new profile `.` and press Remove - previously every profile was deleted with no prompt, now the name is refused. New `ProfileDeletionSafetyTest` drives the real dialog against a temporary config dir, plus `profileFolderPath`/`profileNameUsableAsIs` rows in `ProfileNameValidationTest`. 81/81 ctest pass. Assisted-by: Claude:claude-opus-5 --- src/dlgConnectionProfiles.cpp | 143 ++++-- src/dlgConnectionProfiles.h | 6 +- test/ProfileNameValidationTest.cpp | 77 ++- test/functional_tests/CMakeLists.txt | 1 + .../DefaultGameDeleteTest.cpp | 13 +- .../ProfileDeletionSafetyTest.cpp | 453 ++++++++++++++++++ 6 files changed, 645 insertions(+), 48 deletions(-) create mode 100644 test/functional_tests/ProfileDeletionSafetyTest.cpp diff --git a/src/dlgConnectionProfiles.cpp b/src/dlgConnectionProfiles.cpp index 7a35ffecd..dbb58273a 100644 --- a/src/dlgConnectionProfiles.cpp +++ b/src/dlgConnectionProfiles.cpp @@ -41,6 +41,7 @@ #include <QApplication> #include <QColorDialog> #include <QDir> +#include <QFileInfo> #include <QPointer> #include <QRandomGenerator> #include <QSettings> @@ -78,11 +79,31 @@ QChar dlgConnectionProfiles::firstInvalidProfileNameChar(const QString& name) // retrieve its password. Mirrors the pattern used there: const QRegularExpression dlgConnectionProfiles::scmUnusableProfileNameChars{qsl(R"REGEX(\.\.|[/\\<>:"|?*\x00-\x1f])REGEX")}; -// Whether an existing profile folder can be taken as-is instead of being put -// through the stricter rules that apply to names typed into the dialog: +// A lone "." is made entirely of permitted characters, yet every path built +// from it addresses the profiles directory rather than a profile of its own - +// as does "..", which scmUnusableProfileNameChars already covers: bool dlgConnectionProfiles::profileNameUsableAsIs(const QString& name) { - return !name.isEmpty() && !name.contains(scmUnusableProfileNameChars); + return !name.isEmpty() && name != qsl(".") && !name.contains(scmUnusableProfileNameChars); +} + +// Resolved textually rather than with QDir::canonicalPath() so that the answer +// does not depend on the folder existing - a predefined game has none until it +// is saved - and so that a symlinked profile folder still resolves. +QString dlgConnectionProfiles::profileFolderPath(const QString& profilesPath, const QString& profile) +{ + // Must precede the parent check below, which QDir::cleanPath() would + // otherwise satisfy by collapsing "../profiles/Foo" straight back in: + if (profile.isEmpty() || profile.contains(QLatin1Char('/')) || profile.contains(QLatin1Char('\\'))) { + return {}; + } + + const QString profilesDir = QDir::cleanPath(profilesPath); + const QString candidate = QDir::cleanPath(qsl("%1/%2").arg(profilesDir, profile)); + if (candidate == profilesDir || QFileInfo(candidate).path() != profilesDir) { + return {}; + } + return candidate; } dlgConnectionProfiles::dlgConnectionProfiles(QWidget* parent) @@ -1000,29 +1021,40 @@ void dlgConnectionProfiles::slot_addProfile() connect_button->setAccessibleDescription(btn_connOrLoad_disabled_accessDesc); } -// enables the deletion button once the correct text (profile name) is entered -void dlgConnectionProfiles::slot_deleteProfileCheck(const QString& text) +void dlgConnectionProfiles::showRemovalProblem(const QString& message) { - const QString profile = listWidget_profiles->currentItem()->data(csmNameRole).toString(); - if (profile != text) { - delete_button->setEnabled(false); - } else { - delete_button->setEnabled(true); - delete_button->setFocus(); - } -} - -// actually performs the deletion once the correct text has been entered -void dlgConnectionProfiles::slot_reallyDeleteProfile() -{ - const QString profile = listWidget_profiles->currentItem()->data(csmNameRole).toString(); - reallyDeleteProfile(profile); + notificationArea->show(); + notificationAreaIconLabelWarning->show(); + notificationAreaIconLabelError->hide(); + notificationAreaIconLabelInformation->hide(); + notificationAreaMessageBox->show(); + notificationAreaMessageBox->setText(message); } void dlgConnectionProfiles::reallyDeleteProfile(const QString& profile) { - QDir dir(mudlet::getMudletPath(enums::profileHomePath, profile)); - dir.removeRecursively(); + const QString profilesPath = mudlet::getMudletPath(enums::profilesPath); + const QString profileFolder = profileFolderPath(profilesPath, profile); + if (profileFolder.isEmpty()) { + qWarning().nospace() << "dlgConnectionProfiles::reallyDeleteProfile(\"" << profile << "\") ERROR - refusing to delete: that name does not address a folder inside \"" << profilesPath << "\"."; + // rebuild the list first: it re-selects a profile, and that clears the + // notification area on its way through validateProfile() + fillout_form(); + //: %1 is a profile name that does not name a folder of its own, so there is nothing that could be removed for it + showRemovalProblem(tr("'%1' has no profile folder of its own, so there is nothing to remove.").arg(profile)); + return; + } + + QDir dir(profileFolder); + if (!dir.removeRecursively()) { + // the profile is still on disk, so its password and its list entry stay: + // removing either would strand the data that is left + qWarning().nospace() << "dlgConnectionProfiles::reallyDeleteProfile(\"" << profile << "\") ERROR - could not completely remove \"" << profileFolder << "\"."; + fillout_form(); + //: %1 is a profile name. Shown when some of the profile's files could not be deleted, e.g. because another program has them open + showRemovalProblem(tr("Could not remove everything belonging to '%1'. Close it if it is open elsewhere, check that you may write to its folder, and try again.").arg(profile)); + return; + } // Clean up keychain entries for the deleted profile // Note: CredentialManager only supports one operation at a time, so we must @@ -1088,9 +1120,22 @@ void dlgConnectionProfiles::slot_deleteProfile() return; } - const QDir profileDirContents(mudlet::getMudletPath(enums::profileXmlFilesPath, profile)); - if (!profileDirContents.exists() || profileDirContents.isEmpty()) { - // shortcut - don't show profile deletion confirmation if there is no data to delete + // A profile that has never been played holds nothing but the connection + // details written out when it was selected. Listing what is expected rather + // than what to watch out for keeps an unrecognised file - a stored password, + // a personal dictionary - on the side of asking: + static const QStringList connectionDetailFiles{qsl("url"), qsl("port"), qsl("ssl_tsl"), qsl("description"), qsl("website"), qsl("autologin"), qsl("autoreconnect")}; + const QDir profileDir(mudlet::getMudletPath(enums::profileHomePath, profile)); + bool nothingToLose = !profileDir.exists() || profileDir.entryList(QDir::Dirs | QDir::Hidden | QDir::NoDotAndDotDot).isEmpty(); + if (nothingToLose) { + for (const QString& fileName : profileDir.entryList(QDir::Files | QDir::Hidden)) { + if (!connectionDetailFiles.contains(fileName)) { + nothingToLose = false; + break; + } + } + } + if (nothingToLose) { reallyDeleteProfile(profile); return; } @@ -1107,23 +1152,38 @@ void dlgConnectionProfiles::slot_deleteProfile() file.close(); if (!delete_profile_dialog) { + qWarning() << "dlgConnectionProfiles::slot_deleteProfile() ERROR - the deletion confirmation did not load as a dialog."; + //: %1 is a profile name. Shown when the dialog asking the user to confirm a removal could not be built + showRemovalProblem(tr("Could not open the confirmation, so '%1' has not been removed.").arg(profile)); return; } - delete_profile_lineedit = delete_profile_dialog->findChild<QLineEdit*>(qsl("delete_profile_lineedit")); - delete_button = delete_profile_dialog->findChild<QPushButton*>(qsl("delete_button")); - auto* cancel_button = delete_profile_dialog->findChild<QPushButton*>(qsl("cancel_button")); + auto* nameEntry = delete_profile_dialog->findChild<QLineEdit*>(qsl("delete_profile_lineedit")); + auto* deleteButton = delete_profile_dialog->findChild<QPushButton*>(qsl("delete_button")); + auto* cancelButton = delete_profile_dialog->findChild<QPushButton*>(qsl("cancel_button")); - if (!delete_profile_lineedit || !delete_button || !cancel_button) { + if (!nameEntry || !deleteButton || !cancelButton) { + qWarning() << "dlgConnectionProfiles::slot_deleteProfile() ERROR - the deletion confirmation is missing one of its widgets."; + showRemovalProblem(tr("Could not open the confirmation, so '%1' has not been removed.").arg(profile)); + delete delete_profile_dialog; return; } - connect(delete_profile_lineedit, &QLineEdit::textChanged, this, &dlgConnectionProfiles::slot_deleteProfileCheck); - connect(delete_profile_dialog, &QDialog::accepted, this, &dlgConnectionProfiles::slot_reallyDeleteProfile); + // The confirmation is not modal, so by the time it is answered the selection + // may have moved on, or a second confirmation may be open alongside it: + connect(nameEntry, &QLineEdit::textChanged, delete_profile_dialog, [deleteButton, profile](const QString& text) { + deleteButton->setEnabled(text == profile); + if (deleteButton->isEnabled()) { + deleteButton->setFocus(); + } + }); + connect(delete_profile_dialog, &QDialog::accepted, this, [this, profile]() { + reallyDeleteProfile(profile); + }); - delete_profile_lineedit->setPlaceholderText(profile); - delete_profile_lineedit->setFocus(); - delete_button->setEnabled(false); + nameEntry->setPlaceholderText(profile); + nameEntry->setFocus(); + deleteButton->setEnabled(false); delete_profile_dialog->setWindowTitle(tr("Deleting '%1'").arg(profile)); delete_profile_dialog->setAttribute(Qt::WA_DeleteOnClose); @@ -2216,8 +2276,12 @@ bool dlgConnectionProfiles::validateProfile() // whitespace too, as the entered name always arrives trimmed. Names // the rest of Mudlet cannot work with get no exemption: renaming them // is worse for the user than a profile whose password never saves. + // "." and ".." name something that exists without being a profile, so + // the exemption needs a folder that is genuinely the profile's own. const QString selectedName = pItem->data(csmNameRole).toString(); - const bool nameUnchangedAndOnDisk = (name == selectedName.trimmed()) && profileNameUsableAsIs(name) && QDir(mudlet::getMudletPath(enums::profileHomePath, selectedName)).exists(); + const QString selectedFolder = profileFolderPath(mudlet::getMudletPath(enums::profilesPath), selectedName); + const bool nameIsFolderOnDisk = (name == selectedName.trimmed()) && !selectedFolder.isEmpty() && QDir(selectedFolder).exists(); + const bool nameUnchangedAndOnDisk = nameIsFolderOnDisk && profileNameUsableAsIs(name); const QChar invalidChar = nameUnchangedAndOnDisk ? QChar() : firstInvalidProfileNameChar(name); if (!invalidChar.isNull()) { notificationAreaIconLabelWarning->show(); @@ -2227,6 +2291,17 @@ bool dlgConnectionProfiles::validateProfile() profile_name_entry->setText(name); validName = false; valid = false; + } else if (!nameIsFolderOnDisk && !name.isEmpty() && !profileNameUsableAsIs(name)) { + // Nothing to strip here, unlike the branch above: the characters + // are all permitted, it is the whole name that cannot be a folder + notificationAreaIconLabelWarning->show(); + notificationAreaMessageBox->setText( + qsl("%1\n%2\n") + .arg(notificationAreaMessageBox->text(), + //: Shown when a profile name would not name a folder of its own. Keep the quoted dots as they are, they are literal characters the user typed + tr("A profile name cannot be \".\" or contain \"..\", as those refer to other folders on your computer. Please pick a different name."))); + validName = false; + valid = false; } // see if there is an edit that already uses a similar name diff --git a/src/dlgConnectionProfiles.h b/src/dlgConnectionProfiles.h index d6fed63f3..d84c9c26e 100644 --- a/src/dlgConnectionProfiles.h +++ b/src/dlgConnectionProfiles.h @@ -54,6 +54,7 @@ public: static const int csmNameRole{Qt::UserRole}; static QChar firstInvalidProfileNameChar(const QString& name); static bool profileNameUsableAsIs(const QString& name); + static QString profileFolderPath(const QString& profilesPath, const QString& profile); static const QString scmAllowedProfileNameChars; static const QRegularExpression scmUnusableProfileNameChars; @@ -75,13 +76,11 @@ public slots: void slot_updateLogin(const QString&); void slot_updatePassword(const QString&); // Not used: void slot_updateWebsite(const QString&); - void slot_deleteProfileCheck(const QString&); void slot_updateDescription(); void slot_itemClicked(QListWidgetItem*); void slot_addProfile(); void slot_deleteProfile(); - void slot_reallyDeleteProfile(); void slot_updateAutoConnect(int state); void slot_updateAutoReconnect(int state); @@ -135,6 +134,7 @@ private: void deleteSecurePassword(const QString& profile); void setupMudProfile(QListWidgetItem*, const QString& mudServer, const QString& serverDescription, const QString& iconFileName); void reallyDeleteProfile(const QString& profile); + void showRemovalProblem(const QString& message); void continueProfileSave(QListWidgetItem* pItem, const QString& newProfileName, const QString& newProfileHost, const QString& newProfilePort, const int newProfileSslTsl); void setItemName(QListWidgetItem*, const QString&) const; QIcon customIcon(const QString&, const std::optional<QColor>&) const; @@ -164,8 +164,6 @@ private: QTabBar* mpTabBar = nullptr; QPushButton* offline_button = nullptr; QPushButton* connect_button = nullptr; - QLineEdit* delete_profile_lineedit = nullptr; - QPushButton* delete_button = nullptr; QString mDiscordApplicationId; QString mDiscordInviteURL; QAction* mpAction_revealPassword; diff --git a/test/ProfileNameValidationTest.cpp b/test/ProfileNameValidationTest.cpp index 0910a9867..6938e0f34 100644 --- a/test/ProfileNameValidationTest.cpp +++ b/test/ProfileNameValidationTest.cpp @@ -20,15 +20,18 @@ #include "dlgConnectionProfiles.h" #include "utils.h" +#include <QDir> #include <QtTest/QtTest> /* * Tests for the profile name character validation used by the connection * dialog. Guards the character-set half of the fix for profile folders * duplicated outside of Mudlet (e.g. a file manager appending " (2)" to a - * copied folder) which used to be rejected, greying out the Connect/Offline - * buttons. The on-disk exemption half is covered by - * test/functional_tests/ProfileFolderNameTest.cpp. + * copied folder), which Mudlet must not reject - doing so greys out the + * Connect/Offline buttons - and the rule that a name has to address a folder + * of its own, as "." and ".." name the profiles directory and Mudlet's + * configuration directory instead. The on-disk exemption half is covered by + * ProfileFolderNameTest, and the deletion path by ProfileDeletionSafetyTest. */ class ProfileNameValidationTest : public QObject { @@ -92,9 +95,13 @@ private slots: QTest::newRow("non-ascii") << qsl("café") << true; QTest::newRow("exclamation mark") << qsl("test!") << true; QTest::newRow("single dot") << qsl("my.profile") << true; + QTest::newRow("version number") << qsl("Achaea 2.0") << true; QTest::newRow("empty") << QString() << false; - QTest::newRow("parent directory") << qsl("test..2") << false; + QTest::newRow("current directory") << qsl(".") << false; + QTest::newRow("parent directory") << qsl("..") << false; + QTest::newRow("parent directory in a path") << qsl("../..") << false; + QTest::newRow("embedded parent directory") << qsl("test..2") << false; QTest::newRow("path separator") << qsl("test/2") << false; QTest::newRow("windows path separator") << qsl("test\\2") << false; QTest::newRow("colon") << qsl("test:2") << false; @@ -112,6 +119,68 @@ private slots: QFETCH(bool, usable); QCOMPARE(dlgConnectionProfiles::profileNameUsableAsIs(name), usable); } + + // No path at all means nothing for the deletion to act on + void folderPath_data() + { + QTest::addColumn<QString>("name"); + QTest::addColumn<QString>("expectedPath"); + + const QString profilesPath = qsl("/home/user/.config/mudlet/profiles"); + + QTest::newRow("plain") << qsl("Achaea") << qsl("%1/Achaea").arg(profilesPath); + QTest::newRow("version number") << qsl("Achaea 2.0") << qsl("%1/Achaea 2.0").arg(profilesPath); + QTest::newRow("parentheses") << qsl("test (2)") << qsl("%1/test (2)").arg(profilesPath); + QTest::newRow("non-ascii") << qsl("café") << qsl("%1/café").arg(profilesPath); + QTest::newRow("cyrillic") << qsl("Мудлет") << qsl("%1/Мудлет").arg(profilesPath); + QTest::newRow("leading dot") << qsl(".hidden") << qsl("%1/.hidden").arg(profilesPath); + + QTest::newRow("current directory") << qsl(".") << QString(); + QTest::newRow("parent directory") << qsl("..") << QString(); + QTest::newRow("grandparent directory") << qsl("../..") << QString(); + QTest::newRow("traversal back in") << qsl("../profiles/Achaea") << QString(); + QTest::newRow("nested") << qsl("Achaea/current") << QString(); + QTest::newRow("windows separator") << qsl("Achaea\\current") << QString(); + QTest::newRow("absolute path") << qsl("/etc") << QString(); + QTest::newRow("empty") << QString() << QString(); + } + + void folderPath() + { + QFETCH(QString, name); + QFETCH(QString, expectedPath); + QCOMPARE(dlgConnectionProfiles::profileFolderPath(qsl("/home/user/.config/mudlet/profiles"), name), expectedPath); + } + + // The profiles directory is a native path, so every platform's root counts + void folderPathHandlesNativeRoots_data() + { + QTest::addColumn<QString>("profilesPath"); + + QTest::newRow("posix") << qsl("/home/user/.config/mudlet/profiles"); + QTest::newRow("windows drive") << qsl("C:/Users/user/.config/mudlet/profiles"); + QTest::newRow("windows unc") << qsl("//server/share/mudlet/profiles"); + QTest::newRow("macos") << qsl("/Users/user/Library/Application Support/mudlet/profiles"); + } + + void folderPathHandlesNativeRoots() + { + QFETCH(QString, profilesPath); + + // a UNC root keeps its leading "//" on Windows and loses it elsewhere, + // so compare against the cleaned root rather than what was passed in + const QString root = QDir::cleanPath(profilesPath); + QCOMPARE(dlgConnectionProfiles::profileFolderPath(profilesPath, qsl("Achaea")), qsl("%1/Achaea").arg(root)); + QVERIFY(dlgConnectionProfiles::profileFolderPath(profilesPath, qsl(".")).isEmpty()); + QVERIFY(dlgConnectionProfiles::profileFolderPath(profilesPath, qsl("..")).isEmpty()); + QVERIFY(dlgConnectionProfiles::profileFolderPath(profilesPath, qsl("../..")).isEmpty()); + } + + void folderPathIgnoresTrailingSeparator() + { + QCOMPARE(dlgConnectionProfiles::profileFolderPath(qsl("/home/user/.config/mudlet/profiles/"), qsl("Achaea")), qsl("/home/user/.config/mudlet/profiles/Achaea")); + QCOMPARE(dlgConnectionProfiles::profileFolderPath(qsl("/home/user/.config/mudlet/profiles/"), qsl(".")), QString()); + } }; QTEST_GUILESS_MAIN(ProfileNameValidationTest) diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index a49be4441..7a71666c7 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -48,6 +48,7 @@ set(FUNCTIONAL_TEST_SOURCES HostWidgetDecouplingTest.cpp ActionSelfUninstallTest.cpp ProfileFolderNameTest.cpp + ProfileDeletionSafetyTest.cpp DialogTeardownTest.cpp ConnectionDialogCrashTest.cpp EdbeeReinitTest.cpp diff --git a/test/functional_tests/DefaultGameDeleteTest.cpp b/test/functional_tests/DefaultGameDeleteTest.cpp index a83231984..fdb9d7d22 100644 --- a/test/functional_tests/DefaultGameDeleteTest.cpp +++ b/test/functional_tests/DefaultGameDeleteTest.cpp @@ -100,9 +100,9 @@ private slots: void test_deletedDefaultGameStaysInAllGames() { - // an on-disk profile dir makes the game appear under "My games"; no - // saved XMLs inside means slot_deleteProfile() deletes without raising - // the confirmation dialog + // an on-disk profile dir makes the game appear under "My games"; an + // empty one means slot_deleteProfile() deletes it without raising the + // confirmation dialog QVERIFY(QDir().mkpath(mudlet::getMudletPath(enums::profileHomePath, mGame))); auto* dlg = new dlgConnectionProfiles(); @@ -115,9 +115,10 @@ private slots: dlg->fillout_form(); QVERIFY2(gameListed(dlg, mGame), "game with an on-disk profile should show under 'My games'"); - // no saved XMLs is what makes slot_deleteProfile() skip the - // confirmation dialog; assert it so a change there fails loudly - QVERIFY(!QDir(mudlet::getMudletPath(enums::profileXmlFilesPath, mGame)).exists()); + // having no sub-directory of its own - nothing but the connection + // details the dialog wrote there - is what makes slot_deleteProfile() + // skip the confirmation dialog; assert it so a change there fails loudly + QVERIFY(QDir(mudlet::getMudletPath(enums::profileHomePath, mGame)).entryList(QDir::Dirs | QDir::NoDotAndDotDot).isEmpty()); const auto items = dlg->findData(*dlg->listWidget_profiles, mGame, dlgConnectionProfiles::csmNameRole); dlg->listWidget_profiles->setCurrentItem(items.first()); dlg->slot_deleteProfile(); diff --git a/test/functional_tests/ProfileDeletionSafetyTest.cpp b/test/functional_tests/ProfileDeletionSafetyTest.cpp new file mode 100644 index 000000000..52b1e917b --- /dev/null +++ b/test/functional_tests/ProfileDeletionSafetyTest.cpp @@ -0,0 +1,453 @@ +/*************************************************************************** + * Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +/* + * Removing a profile from the connection dialog must never reach outside that + * one profile's folder. A name like "." addresses the profiles directory + * itself and ".." the whole Mudlet configuration directory, so a name that is + * not a folder of its own must never reach removeRecursively(). Also covers + * the confirmation the user gets before any of their data goes, and the names + * that must keep working. + * + * Run with: ctest -R ProfileDeletionSafetyTest -V + */ + +#include <QtTest/QtTest> + +#include "MudletInstanceCoordinator.h" +#include "dlgConnectionProfiles.h" +#include "mudlet.h" + +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); +void initializeQRCResourcesForProfileDeletionSafetyTest(); + +class ProfileDeletionSafetyTest : public QObject +{ + Q_OBJECT + +private: + QTemporaryDir mConfigDir; + QByteArray mSavedXdg; + const QString mKeeper = qsl("QA Keeper"); + + QString profilePath(const QString& profile) const { return mudlet::getMudletPath(enums::profileHomePath, profile); } + + // setupConfig() consults portable.txt ahead of the XDG logic; skip rather + // than run against an unexpected config dir (see ConfigDirOverrideTest) + bool portableMarkerPresent() const + { + return QFileInfo::exists(qsl("%1/portable.txt").arg(QCoreApplication::applicationDirPath())) || QFileInfo::exists(qsl("%1/.config/mudlet/portable.txt").arg(QDir::homePath())); + } + + void makeProfileWithSavedGame(const QString& profile) const + { + QVERIFY(QDir().mkpath(mudlet::getMudletPath(enums::profileXmlFilesPath, profile))); + QFile savedGame(qsl("%1/%2.xml").arg(mudlet::getMudletPath(enums::profileXmlFilesPath, profile), profile)); + QVERIFY(savedGame.open(QIODevice::WriteOnly)); + savedGame.write("<MudletPackage></MudletPackage>"); + savedGame.close(); + } + + // The list takes ownership, and rebuilding it drops the entry again + void addListEntry(dlgConnectionProfiles* dlg, const QString& profile) const + { + auto* item = new QListWidgetItem(); + item->setData(dlgConnectionProfiles::csmNameRole, profile); + dlg->listWidget_profiles->insertItem(0, item); + dlg->listWidget_profiles->setCurrentItem(item); + } + + // slot_itemClicked() ignores a repeat of the profile it was last given + // within 100ms, and that guard is static, so it outlives the dialog + void selectProfile(dlgConnectionProfiles* dlg, const QString& profile) const + { + const auto items = dlg->findData(*dlg->listWidget_profiles, profile, dlgConnectionProfiles::csmNameRole); + QVERIFY2(!items.isEmpty(), qPrintable(qsl("profile '%1' was not listed").arg(profile))); + dlg->listWidget_profiles->setCurrentItem(items.first()); + QTest::qWait(120); + dlg->slot_itemClicked(items.first()); + } + + QDialog* confirmation(dlgConnectionProfiles* dlg) const { return dlg->findChild<QDialog*>(qsl("delete_profile_confirmation")); } + + // The .ui wires the delete button's clicked() to the dialog's accept() + void confirmRemovalOf(dlgConnectionProfiles* dlg, const QString& profile) const + { + auto* confirmationDialog = confirmation(dlg); + QVERIFY(confirmationDialog); + auto* nameEntry = confirmationDialog->findChild<QLineEdit*>(qsl("delete_profile_lineedit")); + auto* deleteButton = confirmationDialog->findChild<QPushButton*>(qsl("delete_button")); + QVERIFY(nameEntry && deleteButton); + + nameEntry->setText(profile.left(profile.size() - 1)); + QVERIFY2(!deleteButton->isEnabled(), "a partial profile name enabled the delete button"); + + nameEntry->setText(profile); + QVERIFY2(deleteButton->isEnabled(), "typing the profile name did not enable this confirmation's delete button"); + deleteButton->click(); + } + + void removeProfileAndConfirm(dlgConnectionProfiles* dlg, const QString& profile) const + { + dlg->slot_deleteProfile(); + if (confirmation(dlg)) { + confirmRemovalOf(dlg, profile); + } + } + + dlgConnectionProfiles* openDialog() const + { + auto* dlg = new dlgConnectionProfiles(); + dlg->show(); + dlg->fillout_form(); + return dlg; + } + + void closeDialog(dlgConnectionProfiles* dlg) const + { + dlg->deleteLater(); + QCoreApplication::sendPostedEvents(nullptr, QEvent::DeferredDelete); + } + + // The Connect and Offline buttons are the dialog's only AcceptRole buttons + bool acceptButtonsEnabled(dlgConnectionProfiles* dlg) const + { + for (auto* button : dlg->dialog_buttonbox->buttons()) { + if (dlg->dialog_buttonbox->buttonRole(button) == QDialogButtonBox::AcceptRole && !button->isEnabled()) { + return false; + } + } + return true; + } + +private slots: + void initTestCase() + { + if (portableMarkerPresent()) { + QSKIP("portable.txt present - cannot redirect the config dir for this test"); + } + initializeQRCResourcesForProfileDeletionSafetyTest(); + + QVERIFY(mConfigDir.isValid()); + // an existing $XDG_CONFIG_HOME/mudlet makes setupConfig() adopt it, so + // the test never goes near the user's own profiles + QVERIFY(QDir().mkpath(qsl("%1/mudlet").arg(mConfigDir.path()))); + mSavedXdg = qgetenv("XDG_CONFIG_HOME"); + qputenv("XDG_CONFIG_HOME", mConfigDir.path().toUtf8()); + + mudlet::start(); + mudlet::self()->setupConfig(); + QCOMPARE(mudlet::getMudletPath(enums::mainPath), qsl("%1/mudlet").arg(mConfigDir.path())); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique<MudletInstanceCoordinator>("MudletInstanceCoordinator")); + mudlet::self()->init(); + mudlet::self()->setStorePasswordsSecurely(false); + + makeProfileWithSavedGame(mKeeper); + mudlet::self()->writeProfileData(mKeeper, qsl("url"), qsl("mudlet.org")); + mudlet::self()->writeProfileData(mKeeper, qsl("port"), qsl("23")); + } + + void cleanupTestCase() + { + delete mudlet::self(); + mSavedXdg.isNull() ? qunsetenv("XDG_CONFIG_HOME") : qputenv("XDG_CONFIG_HOME", mSavedXdg); + } + + void test_removingCurrentDirectoryProfileKeepsEveryProfile() + { + auto* dlg = openDialog(); + addListEntry(dlg, qsl(".")); + + dlg->slot_deleteProfile(); + QVERIFY2(confirmation(dlg), "removal went ahead without asking"); + confirmRemovalOf(dlg, qsl(".")); + + QVERIFY2(QDir(mudlet::getMudletPath(enums::profilesPath)).exists(), "the profiles directory was deleted"); + QVERIFY2(QDir(profilePath(mKeeper)).exists(), "an unrelated profile was deleted"); + QVERIFY2(QFile::exists(qsl("%1/%2.xml").arg(mudlet::getMudletPath(enums::profileXmlFilesPath, mKeeper), mKeeper)), "an unrelated profile's saved game was deleted"); + QVERIFY2(!dlg->notificationAreaMessageBox->text().isEmpty(), "the refusal was not reported to the user"); + + closeDialog(dlg); + } + + void test_removingParentDirectoryProfileKeepsTheConfigurationDirectory() + { + auto* dlg = openDialog(); + addListEntry(dlg, qsl("..")); + + dlg->slot_deleteProfile(); + QVERIFY2(confirmation(dlg), "removal went ahead without asking"); + confirmRemovalOf(dlg, qsl("..")); + + QVERIFY2(QDir(mudlet::getMudletPath(enums::mainPath)).exists(), "Mudlet's configuration directory was deleted"); + QVERIFY2(QDir(mudlet::getMudletPath(enums::profilesPath)).exists(), "the profiles directory was deleted"); + QVERIFY2(QDir(profilePath(mKeeper)).exists(), "an unrelated profile was deleted"); + QVERIFY2(!dlg->notificationAreaMessageBox->text().isEmpty(), "the refusal was not reported to the user"); + + closeDialog(dlg); + } + + void test_onlyDirectChildrenOfTheProfilesDirectoryAreProfiles() + { + const QString profilesPath = mudlet::getMudletPath(enums::profilesPath); + + QCOMPARE(dlgConnectionProfiles::profileFolderPath(profilesPath, mKeeper), qsl("%1/%2").arg(profilesPath, mKeeper)); + QVERIFY(dlgConnectionProfiles::profileFolderPath(profilesPath, qsl(".")).isEmpty()); + QVERIFY(dlgConnectionProfiles::profileFolderPath(profilesPath, qsl("..")).isEmpty()); + QVERIFY(dlgConnectionProfiles::profileFolderPath(profilesPath, qsl("%1/current").arg(mKeeper)).isEmpty()); + + // a predefined game has no folder until it is saved + const QString neverPlayed = qsl("QA Never Played"); + QVERIFY(!QDir(profilePath(neverPlayed)).exists()); + QCOMPARE(dlgConnectionProfiles::profileFolderPath(profilesPath, neverPlayed), qsl("%1/%2").arg(profilesPath, neverPlayed)); + } + + void test_profileWithOnlyAMapIsConfirmedBeforeRemoval() + { + const QString mapped = qsl("QA Mapped"); + QVERIFY(QDir().mkpath(mudlet::getMudletPath(enums::profileMapsPath, mapped))); + QVERIFY(!QDir(mudlet::getMudletPath(enums::profileXmlFilesPath, mapped)).exists()); + + auto* dlg = openDialog(); + selectProfile(dlg, mapped); + + dlg->slot_deleteProfile(); + QVERIFY2(confirmation(dlg), "removal went ahead without asking"); + QVERIFY2(QDir(profilePath(mapped)).exists(), "the profile was deleted before the user confirmed"); + + confirmation(dlg)->reject(); + QVERIFY2(QDir(profilePath(mapped)).exists(), "the profile was deleted after the user cancelled"); + closeDialog(dlg); + } + + void test_profileWithOnlyConnectionDetailsIsRemovedWithoutConfirmation() + { + const QString unplayed = qsl("QA Unplayed"); + QVERIFY(QDir().mkpath(profilePath(unplayed))); + mudlet::self()->writeProfileData(unplayed, qsl("url"), qsl("mudlet.org")); + mudlet::self()->writeProfileData(unplayed, qsl("port"), qsl("23")); + + auto* dlg = openDialog(); + selectProfile(dlg, unplayed); + + dlg->slot_deleteProfile(); + QVERIFY2(!confirmation(dlg), "a profile with nothing but connection details should not need confirming"); + QVERIFY2(!QDir(profilePath(unplayed)).exists(), "the profile was not removed"); + closeDialog(dlg); + } + + // A stored password sits loose in the folder rather than in a sub-directory + void test_profileWithOnlyAStoredPasswordIsConfirmedBeforeRemoval() + { + const QString secretive = qsl("QA Secretive"); + QVERIFY(QDir().mkpath(profilePath(secretive))); + mudlet::self()->writeProfileData(secretive, qsl("password"), qsl("hunter2")); + QVERIFY(QDir(profilePath(secretive)).entryList(QDir::Dirs | QDir::Hidden | QDir::NoDotAndDotDot).isEmpty()); + + auto* dlg = openDialog(); + selectProfile(dlg, secretive); + + dlg->slot_deleteProfile(); + QVERIFY2(confirmation(dlg), "a profile holding a stored password was removed without asking"); + QVERIFY2(QDir(profilePath(secretive)).exists(), "the profile was deleted before the user confirmed"); + + confirmation(dlg)->reject(); + closeDialog(dlg); + } + + // Nothing stops a second confirmation being raised over the first + void test_eachConfirmationRemovesItsOwnProfile() + { + const QString first = qsl("QA First"); + const QString second = qsl("QA Second"); + makeProfileWithSavedGame(first); + makeProfileWithSavedGame(second); + + auto* dlg = openDialog(); + selectProfile(dlg, first); + dlg->slot_deleteProfile(); + auto* firstConfirmation = confirmation(dlg); + QVERIFY(firstConfirmation); + + selectProfile(dlg, second); + dlg->slot_deleteProfile(); + const auto confirmations = dlg->findChildren<QDialog*>(qsl("delete_profile_confirmation")); + QCOMPARE(confirmations.size(), 2); + auto* secondConfirmation = confirmations.first() == firstConfirmation ? confirmations.last() : confirmations.first(); + + auto* nameEntry = firstConfirmation->findChild<QLineEdit*>(qsl("delete_profile_lineedit")); + auto* deleteButton = firstConfirmation->findChild<QPushButton*>(qsl("delete_button")); + QVERIFY(nameEntry && deleteButton); + nameEntry->setText(first); + QVERIFY2(deleteButton->isEnabled(), "the first confirmation did not accept its own profile name"); + deleteButton->click(); + + QVERIFY2(!QDir(profilePath(first)).exists(), "the first confirmation did not remove its own profile"); + QVERIFY2(QDir(profilePath(second)).exists(), "the first confirmation removed the second profile instead"); + + secondConfirmation->reject(); + closeDialog(dlg); + } + + void test_profileWithDataIsStillRemovable() + { + const QString doomed = qsl("QA Doomed"); + makeProfileWithSavedGame(doomed); + + auto* dlg = openDialog(); + selectProfile(dlg, doomed); + + dlg->slot_deleteProfile(); + QVERIFY2(confirmation(dlg), "removal of a profile with data went ahead without asking"); + QVERIFY2(QDir(profilePath(doomed)).exists(), "the profile was deleted before the user confirmed"); + + confirmRemovalOf(dlg, doomed); + + QVERIFY2(!QDir(profilePath(doomed)).exists(), "the confirmed profile was not removed"); + QVERIFY2(QDir(profilePath(mKeeper)).exists(), "an unrelated profile was removed too"); + closeDialog(dlg); + } + + // A name Mudlet would turn down as a new profile is still a profile on disk + void test_nonAsciiProfileIsStillRemovable() + { + const QString doomed = qsl("Мудлет café"); + makeProfileWithSavedGame(doomed); + + auto* dlg = openDialog(); + selectProfile(dlg, doomed); + + removeProfileAndConfirm(dlg, doomed); + + QVERIFY2(!QDir(profilePath(doomed)).exists(), "the confirmed profile was not removed"); + QVERIFY2(QDir(profilePath(mKeeper)).exists(), "an unrelated profile was removed too"); + closeDialog(dlg); + } + + // The confirmation is not modal, so the selection can move on behind it + void test_confirmationRemovesTheProfileItNamed() + { + const QString doomed = qsl("QA Doomed Too"); + makeProfileWithSavedGame(doomed); + + auto* dlg = openDialog(); + selectProfile(dlg, doomed); + dlg->slot_deleteProfile(); + QVERIFY(confirmation(dlg)); + + selectProfile(dlg, mKeeper); + + confirmRemovalOf(dlg, doomed); + + QVERIFY2(QDir(profilePath(mKeeper)).exists(), "the newly selected profile was removed instead"); + QVERIFY2(!QDir(profilePath(doomed)).exists(), "the confirmed profile was not removed"); + closeDialog(dlg); + } + + void test_typedNamesThatAreNotProfilesAreRejected_data() + { + QTest::addColumn<QString>("name"); + + QTest::newRow("current directory") << qsl("."); + QTest::newRow("parent directory") << qsl(".."); + QTest::newRow("embedded parent directory") << qsl("Achaea..Beta"); + } + + void test_typedNamesThatAreNotProfilesAreRejected() + { + QFETCH(QString, name); + + auto* dlg = openDialog(); + selectProfile(dlg, mKeeper); + // else the assertion below also holds for an unrelated reason + QVERIFY2(acceptButtonsEnabled(dlg), "the profile was already unusable before the name was edited"); + + // setText() drives the same textChanged path as typing does + dlg->profile_name_entry->setText(name); + QVERIFY2(!acceptButtonsEnabled(dlg), qPrintable(qsl("'%1' was accepted as a profile name").arg(name))); + QVERIFY(QDir(profilePath(mKeeper)).exists()); + + dlg->profile_name_entry->setText(mKeeper); + closeDialog(dlg); + } + + // A folder on disk is the user's data whatever it is called + void test_folderOnDiskWithATurnedDownNameIsStillUsable() + { + const QString awkward = qsl("QA..Dots"); + QVERIFY(!dlgConnectionProfiles::profileNameUsableAsIs(awkward)); + makeProfileWithSavedGame(awkward); + mudlet::self()->writeProfileData(awkward, qsl("url"), qsl("mudlet.org")); + mudlet::self()->writeProfileData(awkward, qsl("port"), qsl("23")); + + auto* dlg = openDialog(); + selectProfile(dlg, awkward); + + QCOMPARE(dlg->profile_name_entry->text(), awkward); + QVERIFY2(acceptButtonsEnabled(dlg), "a profile folder already on disk was refused"); + QVERIFY2(QDir(profilePath(awkward)).exists(), "the folder was renamed behind the user's back"); + closeDialog(dlg); + } + + void test_typedNamesThatAreProfilesAreAccepted_data() + { + QTest::addColumn<QString>("name"); + + QTest::newRow("version number") << qsl("QA Game 2.0"); + QTest::newRow("parentheses") << qsl("QA Keeper (2)"); + } + + void test_typedNamesThatAreProfilesAreAccepted() + { + QFETCH(QString, name); + + auto* dlg = openDialog(); + selectProfile(dlg, mKeeper); + + dlg->profile_name_entry->setText(name); + QCOMPARE(dlg->profile_name_entry->text(), name); + QVERIFY2(acceptButtonsEnabled(dlg), qPrintable(qsl("'%1' was refused as a profile name").arg(name))); + + // ~QDialog fires editingFinished() into slot_saveName(), which renames + dlg->profile_name_entry->setText(mKeeper); + closeDialog(dlg); + } +}; + +void initializeQRCResourcesForProfileDeletionSafetyTest() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +#include "ProfileDeletionSafetyTest.moc" +QTEST_MAIN(ProfileDeletionSafetyTest) From c6ca30c1d8dfee7cda03bf759dfeebade69332a3 Mon Sep 17 00:00:00 2001 From: mudlet-machine-account <39947211+mudlet-machine-account@users.noreply.github.com> Date: Sat, 8 Aug 2026 08:30:42 +0200 Subject: [PATCH 128/155] Infrastructure: Update autocompletion data in Mudlet (#9720) #### Brief overview of PR changes/additions :crown: An automated PR to update autocompletion data in Mudlet from refs/heads/development (930ea5af5caf771c2b84c69e3d3048ee55bdc43f). #### Motivation for adding to Mudlet So autocompletion works as expected. Co-authored-by: mudlet-machine-account <mudlet-machine-account@users.noreply.github.com> --- src/lua-function-list.json | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/lua-function-list.json b/src/lua-function-list.json index 67db21b6a..3bedb77cf 100644 --- a/src/lua-function-list.json +++ b/src/lua-function-list.json @@ -223,7 +223,7 @@ "getMapLabels": "arealabels = getMapLabels(areaID)", "getMapMenus": "getMapMenus()", "getMapSelection": "getMapSelection()", - "getMapUserData": "getMapUserData( key )", + "getMapUserData": "getMapUserData(key)", "getMapZoom": "getMapZoom([areaID])", "getModuleInfo": "getModuleInfo(moduleName, [info])", "getModulePath": "path = getModulePath(module name)", @@ -307,7 +307,7 @@ "hideGauge": "hideGauge(gaugeName)", "hideToolBar": "hideToolBar(name)", "hideWindow": "hideWindow(name)", - "highlightRoom": "highlightRoom( roomID, color1Red, color1Green, color1Blue, color2Red, color2Green, color2Blue, highlightRadius, color1Alpha, color2Alpha)", + "highlightRoom": "highlightRoom(roomID, color1Red, color1Green, color1Blue, color2Red, color2Green, color2Blue, highlightRadius, color1Alpha, color2Alpha)", "hinsertLink": "hinsertLink([windowName], text, command, hint, true)", "hinsertPopup": "hinsertPopup([windowName], text, {commands}, {hints}, [useCurrentFormatElseDefault])", "holdingModifiers": "holdingModifiers(number)", @@ -444,7 +444,7 @@ "selectCaptureGroup": "selectCaptureGroup(groupNumber)", "selectCmdLineText": "selectCmdLineText([commandLine])", "selectCurrentLine": "selectCurrentLine([windowName])", - "selectSection": "selectSection( [windowName], fromPosition, length )", + "selectSection": "selectSection([windowName], fromPosition, length)", "selectString": "selectString([windowName], text, number_of_match)", "send": "send(command, showOnScreen)", "sendAll": "sendAll([time delay], list of things to send, [echo back or not])", From 0962052edbe503b7eb1d011a2b45ddae3c22c82c Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Sat, 8 Aug 2026 09:15:36 +0200 Subject: [PATCH 129/155] improve: credit seven more contributors in the About Mudlet dialog (#9675) #### Brief overview of PR changes/additions - Adds seven contributors to the credits list in Help -> About Mudlet: Delwing, Zooka, Mike Conley, Edru2, Tim Johnson, Harrison and John McKisson - Delwing and Zooka join the highlighted group; the rest slot into the alphabetical list below it - Descriptions are sized in line with the existing entries #### Motivation for adding to Mudlet Several of Mudlet's most prolific contributors were entirely uncredited - between them they account for most of today's 2D mapper, the media/MXP/encoding stack, the Geyser GUI toolkit, the script editor and preferences, the 3D mapper revival, MMCP, and Mudlet's screen reader support. Delwing and Zooka also build and maintain Mudlet Web and the package repository respectively. #### Other info (issues closed, discussion etc) - Pronouns are not stated publicly for any of the seven, so the entries avoid gendered wording. - Emails are only listed where the contributor commits publicly with a real address; those using GitHub noreply addresses are credited by handle alone. **Test case:** Open Help -> About Mudlet and confirm the seven new entries render in place, with GitHub handle and email links coloured like the rest. Assisted-by: Claude:claude-opus-5 --- src/dlgAboutDialog.cpp | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/src/dlgAboutDialog.cpp b/src/dlgAboutDialog.cpp index 41a899dae..544b43c36 100644 --- a/src/dlgAboutDialog.cpp +++ b/src/dlgAboutDialog.cpp @@ -177,6 +177,16 @@ void dlgAboutDialog::setAboutTab(const QString& htmlHead) const //: about:Leris tr("Does a ton of work in making Mudlet, the website and the wiki accessible to you " "regardless of the language you speak - and promoting our genre!")}); + aboutMakers.append({true, qsl("Piotr Wilczynski"), QString(), qsl("Delwing"), qsl("delwing@gmail.com"), + //: about:Delwing + tr("Joined in 2020, reworking much of the 2D mapper and adding many Lua API features. " + "Outside the client they build Mudlet Web, the documentation extract that powers " + "autocompletion in code editors, and the tools that share Mudlet maps online.")}); + aboutMakers.append({true, qsl("Zooka"), QString(), qsl("ZookaOnGit"), QString(), + //: about:Zooka + tr("Joined in 2023 and works across the whole client - script editor, preferences, package manager " + "and mapper - along with many Lua API additions. Wrote the Mudlet Tutorial profile and " + "maintains the Mudlet package repository.")}); aboutMakers.append({false, qsl("Ahmed Charles"), QString(), qsl("ahmedcharles"), qsl("acharles@outlook.com"), //: about:ahmedcharles tr("Contributions to the Travis integration, CMake and Visual C++ build, " @@ -206,6 +216,10 @@ void dlgAboutDialog::setAboutTab(const QString& htmlHead) const aboutMakers.append({false, qsl("Erik Pettis"), qsl("Etomyutikos#9266"), qsl("Oneymus"), QString(), //: about:Oneymus tr("Developed the Vyzor GUI Manager for Mudlet.")}); + aboutMakers.append({false, qsl("Harrison"), QString(), qsl("Harrison-Teeg"), qsl("harrison.martin@gmail.com"), + //: about:Harrison + tr("Brought the 3D mapper back to life with camera controls, lighting and proper geometry " + "for z-squished rooms, and has fixed a number of console and command line annoyances.")}); aboutMakers.append({false, qsl("ItsTheFae"), qsl("TheFae#9971"), qsl("Kae"), QString(), //: about:TheFae tr("Worked wonders in rejuvenating our Website in 2017 but who prefers a little anonymity - " @@ -221,6 +235,10 @@ void dlgAboutDialog::setAboutTab(const QString& htmlHead) const aboutMakers.append({false, qsl("John Dahlström"), QString(), QString(), qsl("email@johndahlstrom.se"), //: about:John Dahlström tr("Helped develop and debug the Lua API.")}); + aboutMakers.append({false, qsl("John McKisson"), QString(), qsl("jmckisson"), qsl("john.mckisson@gmail.com"), + //: about:John McKisson + tr("Implemented MMCP, so Mudlet can join MudMaster chat networks, and has contributed " + "a range of console and Lua API fixes.")}); aboutMakers.append({false, qsl("Karsten Bock"), QString(), qsl("Beliaar"), QString(), //: about:Beliaar tr("Contributed several improvements and new features for Geyser.")}); @@ -230,6 +248,16 @@ void dlgAboutDialog::setAboutTab(const QString& htmlHead) const aboutMakers.append({false, qsl("Maksym Grinenko"), QString(), QString(), qsl("maksym.grinenko@gmail.com"), //: about:Maksym Grinenko tr("Worked on the manual, forum help and helps with GUI design and documentation.")}); + aboutMakers.append({false, qsl("Manuel Wegmann"), QString(), qsl("Edru2"), QString(), + //: about:Edru2 + tr("Built much of the GUI toolkit you script with between 2020 and 2022: Adjustable Containers, " + "Geyser's ScrollBox, animated labels and Geyser in UserWindows - plus the dark theme toggle " + "and the Package Exporter rework.")}); + aboutMakers.append({false, qsl("Mike Conley"), QString(), qsl("mpconley"), qsl("sousesider@gmail.com"), + //: about:Mike Conley + tr("Joined in 2018 and looks after nearly everything Mudlet plays or negotiates - MCMP media, " + "sound and video, closed captioning, MXP, OSC 8 hyperlinks and text encodings - plus " + "multi-window support with drag-and-drop tabs.")}); aboutMakers.append({false, qsl("Stephen Hansen"), QString(), QString(), qsl("me+mudlet@ixokai.io"), //: about:Stephen Hansen tr("Developed a database Lua API that allows for far easier use of databases and one of the original OSX installers.")}); @@ -237,6 +265,10 @@ void dlgAboutDialog::setAboutTab(const QString& htmlHead) const //: about:Thorsten Wilms tr("Designed our beautiful logo, our splash screen, the about dialog, our website, several icons and badges. " "Visit his homepage at <a href=\"http://thorwil.wordpress.com/\">thorwil.wordpress.com</a>.")}); + aboutMakers.append({false, qsl("Tim Johnson"), QString(), qsl("atari2600tim"), QString(), + //: about:Tim Johnson + tr("Joined in 2020 and made Mudlet work far better with screen readers, alongside secure IRC " + "connections, Discord improvements, and a batch of editor shortcuts and Lua configuration functions.")}); QString aboutMudletBody("<p align=\"center\"><big><b>Credits:</b></big></p>"); QVectorIterator<aboutMaker> iterateMakers(aboutMakers); From c4849b6651d5c58405cccb0e2c82e2535e5210d8 Mon Sep 17 00:00:00 2001 From: Mike Conley <sousesider@gmail.com> Date: Sat, 8 Aug 2026 04:09:32 -0400 Subject: [PATCH 130/155] improve: OSC 8 hyperlink handling, and a setting to turn it off (#9731) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit #### Brief overview of PR changes/additions - Hardens how OSC 8 link payloads and link text are handled before they are run or displayed; link commands are no longer built by string-formatting remote text into Lua source. - Adds a per-profile setting (General → Game protocols) to turn OSC 8 hyperlinks off, which also reports `0` for every `OSC_HYPERLINKS*` NEW-ENVIRON variable and sends an INFO update if toggled mid-session. - Fixes `selected=` callbacks on `send:` links, which never fired, and keeps emoji and Persian/Arabic/Indic text intact in tooltips and menu labels. #### Motivation for adding to Mudlet Inspired by [conversation](https://discord.com/channels/279748146316312576/1416447642472284261/1535109010066251890) on the MUD Discord and updates to terminal emulators. OSC 8 sequences arrive from the game server — and often from another player whose say/tell text the server relays — so they have to be treated as untrusted input rather than as content the user chose to load. #### Other info (issues closed, discussion etc) New unit tests: `LuaLiteralTest` (28 cases, including an exhaustive sweep over the bracket alphabet, each evaluated in a real Lua 5.1 state) and `UntrustedTextTest` (26 cases covering emoji sequences, non-Latin shaping and the two sanitization policies). There is no automated NEW-ENVIRON coverage anywhere in the repo, so that path was verified manually against a live server instead. **Test case:** 1. `say !osc8-docs` — every documented feature still works. 2. Send a link whose command ends in `]`, e.g. `send:say [OOC]` — clicking sends the literal text (previously the click silently did nothing). 3. Settings → General → Game protocols → uncheck "Enable OSC 8 hyperlinks from the server" — links stop rendering and the server is told without a reconnect; re-check and they return. 4. Send a tooltip or menu label containing a multi-part emoji such as 👨‍🍳 — it renders normally, not as its component parts. --------- Signed-off-by: Michael Conley <sousesider@gmail.com> --- src/CMakeLists.txt | 4 + src/GMCPAuthenticator.cpp | 5 +- src/Host.h | 6 + src/LuaLiteral.cpp | 43 +++++++ src/LuaLiteral.h | 34 ++++++ src/TBuffer.cpp | 48 +++++--- src/THyperlinkSelectionManager.cpp | 67 ++++------ src/THyperlinkSelectionManager.h | 9 +- src/THyperlinkStyling.h | 7 ++ src/TMxpLinkTagHandler.cpp | 9 +- src/TTextEdit.cpp | 30 ++++- src/UntrustedText.cpp | 103 ++++++++++++++++ src/UntrustedText.h | 61 ++++++++++ src/XMLexport.cpp | 1 + src/XMLimport.cpp | 1 + src/ctelnet.cpp | 110 +++++++++++------ src/ctelnet.h | 2 + src/dlgProfilePreferences.cpp | 17 +++ src/dlgProfilePreferences.h | 1 + src/ui/profile_preferences.ui | 14 +++ test/CMakeLists.txt | 2 + test/LuaLiteralTest.cpp | 189 +++++++++++++++++++++++++++++ test/OAuthClientFlowTest.cpp | 4 + test/UntrustedTextTest.cpp | 188 ++++++++++++++++++++++++++++ 24 files changed, 852 insertions(+), 103 deletions(-) create mode 100644 src/LuaLiteral.cpp create mode 100644 src/LuaLiteral.h create mode 100644 src/UntrustedText.cpp create mode 100644 src/UntrustedText.h create mode 100644 test/LuaLiteralTest.cpp create mode 100644 test/UntrustedTextTest.cpp diff --git a/src/CMakeLists.txt b/src/CMakeLists.txt index 89fe197d5..ecf5b394c 100644 --- a/src/CMakeLists.txt +++ b/src/CMakeLists.txt @@ -99,6 +99,7 @@ set(mudlet_SRCS KeyUnit.cpp LabelInteractionHandler.cpp LuaInterface.cpp + LuaLiteral.cpp main.cpp mapInfoContributorManager.cpp MiddleMousePanHandler.cpp @@ -212,6 +213,7 @@ set(mudlet_SRCS TTrigger.cpp TUiTour.cpp TVar.cpp + UntrustedText.cpp VarUnit.cpp WideComboBox.cpp XMLexport.cpp @@ -328,6 +330,7 @@ set(mudlet_HDRS KeyUnit.h LabelInteractionHandler.h LuaInterface.h + LuaLiteral.h mapInfoContributorManager.h MiddleMousePanHandler.h MMCP.h @@ -446,6 +449,7 @@ set(mudlet_HDRS TTrigger.h TUiTour.h TVar.h + UntrustedText.h utils.h VarUnit.h widechar_width.h diff --git a/src/GMCPAuthenticator.cpp b/src/GMCPAuthenticator.cpp index 63562781d..9297059de 100644 --- a/src/GMCPAuthenticator.cpp +++ b/src/GMCPAuthenticator.cpp @@ -24,6 +24,7 @@ #include "CredentialManager.h" #include "OAuthClientFlow.h" #include "SecureStringUtils.h" +#include "UntrustedText.h" #include "ctelnet.h" #include "mudlet.h" #include <QAccessible> @@ -468,14 +469,14 @@ void GMCPAuthenticator::offerOrOpenSignInUrl(const QUrl& url, const QString& pro } //: %1 is the sign-in web address the user should open in their browser to sign in. - mpHost->postMessage(tr("[ INFO ] - To sign in, open this link in your browser: %1").arg(url.toString())); + mpHost->postMessage(tr("[ INFO ] - To sign in, open this link in your browser: %1").arg(UntrustedText::forTarget(url.toString()))); } bool GMCPAuthenticator::openSignInUrl(const QUrl& url, const QString& provider) { if (!QDesktopServices::openUrl(url)) { //: %1 is the sign-in web address the user should open manually in their browser. - mpHost->postMessage(tr("[ WARN ] - Could not open your browser. Open this link manually to sign in: %1").arg(url.toString())); + mpHost->postMessage(tr("[ WARN ] - Could not open your browser. Open this link manually to sign in: %1").arg(UntrustedText::forTarget(url.toString()))); return false; } announceBrowserHandoff(provider); diff --git a/src/Host.h b/src/Host.h index 87c23393f..8c49f6b09 100644 --- a/src/Host.h +++ b/src/Host.h @@ -857,6 +857,12 @@ public: bool mAdvertiseScreenReader = false; bool mEnableClosedCaption = false; + // Turning this off both ignores incoming OSC 8 sequences and advertises 0 + // for them, so a server can fall back to MXP or plain text rather than + // sending links Mudlet will not render. It is checked as sequences are + // decoded, so links already drawn in the buffer stay clickable. + bool mEnableOSC8Hyperlinks = true; + enum class BlankLineBehaviour { Show, Hide, ReplaceWithSpace }; Q_ENUM(BlankLineBehaviour) BlankLineBehaviour mBlankLineBehaviour = BlankLineBehaviour::Show; diff --git a/src/LuaLiteral.cpp b/src/LuaLiteral.cpp new file mode 100644 index 000000000..c34ffcf6c --- /dev/null +++ b/src/LuaLiteral.cpp @@ -0,0 +1,43 @@ +/*************************************************************************** + * Copyright (C) 2026 by Mike Conley - mike.conley@stickmud.com * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +#include "LuaLiteral.h" + +#include "utils.h" + +QString LuaLiteral::quote(const QString& text) +{ + // Escalate the bracket level until the text can do none of three things: + // close the literal outright; reopen it, which Lua 5.1 rejects under its + // deprecated-nesting rule; or merge with the closing bracket appended after + // it. That last one is why endsWith is here - text ending in ']' followed + // by this level's '=' run is completed into a closing bracket by the first + // character of the closer, shutting the literal one character early. + // Terminates because none of the three patterns fits in text shorter than + // the '=' run it requires. + QString equals; + while (text.contains(qsl("]%1]").arg(equals)) || text.contains(qsl("[%1[").arg(equals)) || text.endsWith(qsl("]%1").arg(equals))) { + equals += QLatin1Char('='); + } + + // Lua discards a newline immediately after the opening bracket, so the + // added one costs nothing and lets text that itself starts with a newline + // survive the round trip. + return qsl("[%1[\n%2]%1]").arg(equals, text); +} diff --git a/src/LuaLiteral.h b/src/LuaLiteral.h new file mode 100644 index 000000000..18c69b770 --- /dev/null +++ b/src/LuaLiteral.h @@ -0,0 +1,34 @@ +#ifndef MUDLET_LUALITERAL_H +#define MUDLET_LUALITERAL_H + +/*************************************************************************** + * Copyright (C) 2026 by Mike Conley - mike.conley@stickmud.com * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +#include <QString> + +class LuaLiteral +{ +public: + // Quotes arbitrary, possibly hostile text as a Lua long-bracket string + // literal. Callers embedding remote input in generated Lua source must use + // this rather than formatting into "[[%1]]" themselves. + static QString quote(const QString& text); +}; + +#endif // MUDLET_LUALITERAL_H diff --git a/src/TBuffer.cpp b/src/TBuffer.cpp index b40bae218..4b969417e 100644 --- a/src/TBuffer.cpp +++ b/src/TBuffer.cpp @@ -24,6 +24,7 @@ #include "TBuffer.h" #include "Host.h" +#include "LuaLiteral.h" #include "mudlet.h" #include "TConsole.h" #include "TEvent.h" @@ -32,6 +33,7 @@ #include "THyperlinkSelectionManager.h" #include "TStringUtils.h" #include "TTextEdit.h" +#include "UntrustedText.h" #include "TTextProperties.h" #include "widechar_width.h" #include "TEncodingHelper.h" @@ -3287,8 +3289,16 @@ void TBuffer::decodeOSC(const QString& sequence) break; } + // Deliberately below the terminator branch above: the close is the only + // thing that clears mHyperlinkActive, so refusing it would leave a link + // open forever and mark the rest of the session clickable. Turning the + // preference off mid-link must still let that link finish. + if (!mpHost->mEnableOSC8Hyperlinks) { + return; + } + if (!rawUrl.isEmpty()) { - if (rawUrl.length() > 8192) { + if (rawUrl.length() > static_cast<int>(MAX_OSC_SEQUENCE_LENGTH)) { qWarning() << "TBuffer::decodeOSC(...) - Rejected hyperlink: URL too long:" << rawUrl; return; } @@ -3373,7 +3383,7 @@ void TBuffer::decodeOSC(const QString& sequence) QString customTooltip; if (queryParams.contains(qsl("tooltip"))) { - customTooltip = queryParams.value(qsl("tooltip")); + customTooltip = UntrustedText::forAuthoredText(queryParams.value(qsl("tooltip"))); } // Note: title is now parsed directly into mCurrentHyperlinkStyling by parseJsonHyperlinkConfig @@ -3429,19 +3439,25 @@ void TBuffer::decodeOSC(const QString& sequence) if (baseUrl.startsWith(qsl("send:"))) { QString innerCommand = QUrl::fromPercentEncoding(baseUrl.mid(5).toUtf8()); - command = {qsl("send([[%1]], false)").arg(innerCommand)}; - hint = {qsl("%1: %2").arg(QObject::tr("Send"), innerCommand)}; + mCurrentHyperlinkStyling.actionScheme = Mudlet::HyperlinkStyling::ActionSend; + mCurrentHyperlinkStyling.baseCommand = innerCommand; + command = {qsl("send(%1, false)").arg(LuaLiteral::quote(innerCommand))}; + hint = {qsl("%1: %2").arg(QObject::tr("Send"), UntrustedText::forTarget(innerCommand))}; } else if (baseUrl.startsWith(qsl("prompt:"))) { QString innerCommand = QUrl::fromPercentEncoding(baseUrl.mid(7).toUtf8()); - command = {qsl("sendCmdLine([[%1]])").arg(innerCommand)}; - hint = {qsl("%1: %2").arg(QObject::tr("Prompt"), innerCommand)}; + mCurrentHyperlinkStyling.actionScheme = Mudlet::HyperlinkStyling::ActionPrompt; + mCurrentHyperlinkStyling.baseCommand = innerCommand; + command = {qsl("sendCmdLine(%1)").arg(LuaLiteral::quote(innerCommand))}; + hint = {qsl("%1: %2").arg(QObject::tr("Prompt"), UntrustedText::forTarget(innerCommand))}; } else { QUrl qurl(baseUrl); QString scheme = qurl.scheme().toLower(); if (scheme == qsl("http") || scheme == qsl("https") || scheme == qsl("ftp")) { - command = {qsl("openUrl([[%1]])").arg(baseUrl)}; - hint = {qsl("%1: %2").arg(QObject::tr("Open browser to"), baseUrl)}; + mCurrentHyperlinkStyling.actionScheme = Mudlet::HyperlinkStyling::ActionOpenUrl; + mCurrentHyperlinkStyling.baseCommand = baseUrl; + command = {qsl("openUrl(%1)").arg(LuaLiteral::quote(baseUrl))}; + hint = {qsl("%1: %2").arg(QObject::tr("Open browser to"), UntrustedText::forTarget(baseUrl))}; } else { qWarning().noquote().nospace() << "TBuffer::decodeOSC(...) - Ignored untrusted or unsupported URI scheme: \"" << scheme << "\""; return; @@ -3475,20 +3491,20 @@ void TBuffer::decodeOSC(const QString& sequence) // Determine command type based on prefix if (menuCommand.startsWith(qsl("send:"))) { QString innerCommand = QUrl::fromPercentEncoding(menuCommand.mid(5).toUtf8()); - menuCommands.append(qsl("send([[%1]], false)").arg(innerCommand)); - menuHints.append(menuLabel); + menuCommands.append(qsl("send(%1, false)").arg(LuaLiteral::quote(innerCommand))); + menuHints.append(UntrustedText::forAuthoredText(menuLabel)); } else if (menuCommand.startsWith(qsl("prompt:"))) { QString innerCommand = QUrl::fromPercentEncoding(menuCommand.mid(7).toUtf8()); - menuCommands.append(qsl("sendCmdLine([[%1]])").arg(innerCommand)); - menuHints.append(menuLabel); + menuCommands.append(qsl("sendCmdLine(%1)").arg(LuaLiteral::quote(innerCommand))); + menuHints.append(UntrustedText::forAuthoredText(menuLabel)); } else if (menuCommand == qsl("-")) { // Special case: "-" creates a menu separator menuCommands.append(QString()); menuHints.append(QString()); } else { // Treat as direct command - menuCommands.append(qsl("send([[%1]], false)").arg(menuCommand)); - menuHints.append(menuLabel); + menuCommands.append(qsl("send(%1, false)").arg(LuaLiteral::quote(menuCommand))); + menuHints.append(UntrustedText::forAuthoredText(menuLabel)); } } @@ -3884,14 +3900,14 @@ bool TBuffer::parseJsonHyperlinkConfig(const QString& jsonString, QMap<QString, if (root.contains(qsl("title"))) { QJsonValue titleValue = root[qsl("title")]; if (titleValue.isString()) { - styling.menuTitle = titleValue.toString(); + styling.menuTitle = UntrustedText::forAuthoredText(titleValue.toString()); #if defined(DEBUG_OSC_PROCESSING) qDebug() << "[OSC] Title parameter added:" << titleValue.toString(); #endif } else if (titleValue.isObject()) { QJsonObject titleObj = titleValue.toObject(); if (titleObj.contains(qsl("text")) && titleObj[qsl("text")].isString()) { - styling.menuTitle = titleObj[qsl("text")].toString(); + styling.menuTitle = UntrustedText::forAuthoredText(titleObj[qsl("text")].toString()); } if (titleObj.contains(qsl("style")) && titleObj[qsl("style")].isObject()) { parseJsonStateStyle(titleObj[qsl("style")].toObject(), styling.menuTitleStyle); diff --git a/src/THyperlinkSelectionManager.cpp b/src/THyperlinkSelectionManager.cpp index 2a0f322af..d9b18804c 100644 --- a/src/THyperlinkSelectionManager.cpp +++ b/src/THyperlinkSelectionManager.cpp @@ -19,6 +19,7 @@ ***************************************************************************/ #include "THyperlinkSelectionManager.h" +#include "LuaLiteral.h" #include "TConsole.h" #include <QUrl> @@ -83,61 +84,41 @@ void THyperlinkSelectionManager::clearAllSelections() QString THyperlinkSelectionManager::addSelectedParameter(const QString& command, bool isSelected) const { - QUrl url(command); - QUrlQuery query(url); + // Split on '?' by hand rather than parsing the whole thing as a QUrl. This + // is a game command, not a URL: QUrl::path() would drop everything after a + // '#' (an ordinary character in a MUD command) and would percent-decode a + // second time, since the payload was already decoded once when the URI was + // parsed. Only the query portion is ours to rewrite. + const int queryStart = command.indexOf(QLatin1Char('?')); + const QString base = queryStart >= 0 ? command.left(queryStart) : command; + + QUrlQuery query(queryStart >= 0 ? command.mid(queryStart + 1) : QString()); query.removeQueryItem(qsl("selected")); query.addQueryItem(qsl("selected"), isSelected ? qsl("true") : qsl("false")); - QString cleanCommand = url.path(); - if (!query.isEmpty()) { - cleanCommand += qsl("?") + query.query(QUrl::FullyEncoded); - } - return cleanCommand; + return base + QLatin1Char('?') + query.query(QUrl::FullyEncoded); } -QString THyperlinkSelectionManager::modifyUriForSelection(const QString& baseUri, const QString& group, const QString& value) const +QString THyperlinkSelectionManager::modifyUriForSelection(Mudlet::HyperlinkStyling::ActionScheme scheme, const QString& baseCommand, const QString& group, const QString& value) const { - // Query the current selection state from our internal state - bool isSelected = this->isSelected(group, value); + const bool isSelected = this->isSelected(group, value); + const QString command = addSelectedParameter(baseCommand, isSelected); #if defined(DEBUG_OSC_PROCESSING) - qDebug() << "modifyUriForSelection called with baseUri:" << baseUri << "group:" << group << "value:" << value << "isSelected:" << isSelected; + qDebug() << "modifyUriForSelection called with scheme:" << scheme << "baseCommand:" << baseCommand << "group:" << group << "value:" << value << "isSelected:" << isSelected; #endif - // Check if it's a send() or sendCmdLine() call - const QString sendPrefix = qsl("send([["); - const QString sendSuffix = qsl("]])"); - const QString sendCmdLinePrefix = qsl("sendCmdLine([["); - const QString sendCmdLineSuffix = qsl("]])"); - - if (baseUri.startsWith(sendPrefix) && baseUri.endsWith(sendSuffix)) { - const int prefixLength = sendPrefix.length(); - const int suffixLength = sendSuffix.length(); - QString command = baseUri.mid(prefixLength, baseUri.length() - prefixLength - suffixLength); - QString cleanCommand = addSelectedParameter(command, isSelected); - QString result = qsl("send([[%1]], false)").arg(cleanCommand); -#if defined(DEBUG_OSC_PROCESSING) - qDebug() << "Modified to:" << result; -#endif - return result; - } - if (baseUri.startsWith(sendCmdLinePrefix) && baseUri.endsWith(sendCmdLineSuffix)) { - const int prefixLength = sendCmdLinePrefix.length(); - const int suffixLength = sendCmdLineSuffix.length(); - QString command = baseUri.mid(prefixLength, baseUri.length() - prefixLength - suffixLength); - QString cleanCommand = addSelectedParameter(command, isSelected); - QString result = qsl("sendCmdLine([[%1]])").arg(cleanCommand); -#if defined(DEBUG_OSC_PROCESSING) - qDebug() << "Modified to:" << result; -#endif - return result; + switch (scheme) { + case Mudlet::HyperlinkStyling::ActionSend: + return qsl("send(%1, false)").arg(LuaLiteral::quote(command)); + case Mudlet::HyperlinkStyling::ActionPrompt: + return qsl("sendCmdLine(%1)").arg(LuaLiteral::quote(command)); + case Mudlet::HyperlinkStyling::ActionOpenUrl: + case Mudlet::HyperlinkStyling::ActionNone: + break; } - // For other URI formats (like openUrl), return as-is -#if defined(DEBUG_OSC_PROCESSING) - qDebug() << "No modification - returning as-is"; -#endif - return baseUri; + return QString(); } void THyperlinkSelectionManager::registerGroupMember(const QString& group, const QString& value) diff --git a/src/THyperlinkSelectionManager.h b/src/THyperlinkSelectionManager.h index 1d91c0d6c..f8342e935 100644 --- a/src/THyperlinkSelectionManager.h +++ b/src/THyperlinkSelectionManager.h @@ -20,6 +20,8 @@ * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * ***************************************************************************/ +#include "THyperlinkStyling.h" + #include <QHash> #include <QObject> #include <QSet> @@ -50,8 +52,11 @@ public: void setGroupExclusive(const QString& group, bool exclusive); bool isGroupExclusive(const QString& group) const; - // Modifies hyperlink URI to include current selection state - QString modifyUriForSelection(const QString& baseUri, const QString& group, const QString& value) const; + // Builds the Lua call for a link whose selection state just changed, with + // the group's current state appended to the command as &selected=. Returns + // an empty string for schemes that have no selection-aware form (openUrl, + // and links with no parsed action) - callers keep the command they have. + QString modifyUriForSelection(Mudlet::HyperlinkStyling::ActionScheme scheme, const QString& baseCommand, const QString& group, const QString& value) const; signals: void selectionChanged(const QString& group, const QString& value, bool selected); diff --git a/src/THyperlinkStyling.h b/src/THyperlinkStyling.h index 98ee9a4c4..1fb8f50d0 100644 --- a/src/THyperlinkStyling.h +++ b/src/THyperlinkStyling.h @@ -71,6 +71,13 @@ struct HyperlinkStyling { StateDisabled // Disabled state (from selection object) }; + // The link's primary action as parsed from the URI, kept alongside the + // generated Lua so selection callbacks can rebuild the call without + // parsing Lua source back apart. + enum ActionScheme { ActionNone, ActionSend, ActionPrompt, ActionOpenUrl }; + ActionScheme actionScheme = ActionNone; + QString baseCommand; + // State-specific styling containers struct StateStyle { QColor foregroundColor; diff --git a/src/TMxpLinkTagHandler.cpp b/src/TMxpLinkTagHandler.cpp index dde289c27..51bbbbc9f 100644 --- a/src/TMxpLinkTagHandler.cpp +++ b/src/TMxpLinkTagHandler.cpp @@ -19,7 +19,9 @@ ***************************************************************************/ #include "TMxpLinkTagHandler.h" +#include "LuaLiteral.h" #include "TMxpClient.h" +#include "UntrustedText.h" // <A href=URL [hint=text] [expire=name]> TMxpTagHandlerResult TMxpLinkTagHandler::handleStartTag(TMxpContext& ctx, TMxpClient& client, MxpStartTag* tag) @@ -37,9 +39,12 @@ TMxpTagHandlerResult TMxpLinkTagHandler::handleStartTag(TMxpContext& ctx, TMxpCl return MXP_TAG_NOT_HANDLED; } - const QString hint = tag->hasAttribute(qsl("hint")) ? tag->getAttributeValue(qsl("hint")) : href; + // Server-supplied, and lands in the same tooltip as an OSC 8 hint. An + // explicit hint is prose written to be read; falling back to the href makes + // this a link target the user is being asked to trust. + const QString hint = tag->hasAttribute(qsl("hint")) ? UntrustedText::forAuthoredText(tag->getAttributeValue(qsl("hint"))) : UntrustedText::forTarget(href); - href = qsl("openUrl([[%1]])").arg(href); + href = qsl("openUrl(%1)").arg(LuaLiteral::quote(href)); // Use the version of setLink that supports expire names if (!expireName.isEmpty()) { diff --git a/src/TTextEdit.cpp b/src/TTextEdit.cpp index beeec15d3..dd3d9a839 100644 --- a/src/TTextEdit.cpp +++ b/src/TTextEdit.cpp @@ -1582,7 +1582,16 @@ void TTextEdit::updateTextCursor(const QMouseEvent* event, int lineIndex, int tC QStringList tooltip = mpBuffer->mLinkStore.getHints(linkIndex); QStringList commands = mpBuffer->mLinkStore.getLinks(linkIndex); // If a special tooltip hint was given, use that one. - QToolTip::showText(event->globalPosition().toPoint(), tooltip.size() > commands.size() ? tooltip[0] : tooltip.join(QChar::LineFeed)); + // The server chooses this text and QToolTip renders anything + // Qt::mightBeRichText() accepts as HTML, so escape it and wrap it + // in an explicit document rather than letting that guess decide + // whether the markup is live. white-space:pre keeps the line + // breaks the plain-text path used to give. + // An empty string is how QToolTip is told to hide, so it has to + // stay empty rather than becoming an empty document. + const QString tooltipText = tooltip.size() > commands.size() ? tooltip[0] : tooltip.join(QChar::LineFeed); + const QString tooltipMarkup = tooltipText.isEmpty() ? QString() : qsl("<html><body style='white-space:pre'>%1</body></html>").arg(tooltipText.toHtmlEscaped()); + QToolTip::showText(event->globalPosition().toPoint(), tooltipMarkup); // Update hover state for CSS pseudo-class support // Don't set hover state for disabled links - they should stay disabled @@ -2368,6 +2377,9 @@ void TTextEdit::mouseReleaseEvent(QMouseEvent* event) if (!hyperlinkStyling.menuTitle.isEmpty()) { auto titleLabel = new QLabel(hyperlinkStyling.menuTitle, popup); + // The server picks this text and QLabel defaults to Qt::AutoText, + // which would render markup in it. + titleLabel->setTextFormat(Qt::PlainText); titleLabel->setFont(font()); // Build stylesheet from title style properties @@ -3546,7 +3558,18 @@ void TTextEdit::applyHyperlinkSelectionGroupState(int linkIndex, QString& uri, c } const bool newSelected = mgr->isSelected(group, value); - uri = mgr->modifyUriForSelection(uri, group, value); + + // A menu link's commands are built from its menu items and the base URI's + // command is discarded, so baseCommand matches none of what can actually be + // run here. Callers pass the item the user picked; rebuilding from the base + // would send something they did not choose. + if (mpBuffer->mLinkStore.getLinksConst(linkIndex).size() <= 1) { + const Mudlet::HyperlinkStyling styling = mpBuffer->mLinkStore.getStyling(linkIndex); + const QString rebuiltUri = mgr->modifyUriForSelection(styling.actionScheme, styling.baseCommand, group, value); + if (!rebuiltUri.isEmpty()) { + uri = rebuiltUri; + } + } mpBuffer->setLinkSelected(linkIndex, newSelected); mpBuffer->setLinkState(linkIndex, newSelected ? Mudlet::HyperlinkStyling::StateSelected : Mudlet::HyperlinkStyling::StateDefault); @@ -3636,6 +3659,9 @@ void TTextEdit::showLinkContextMenu() if (!hyperlinkStyling.menuTitle.isEmpty()) { auto titleLabel = new QLabel(hyperlinkStyling.menuTitle, popup); + // The server picks this text and QLabel defaults to Qt::AutoText, + // which would render markup in it. + titleLabel->setTextFormat(Qt::PlainText); titleLabel->setFont(font()); QStringList styleProps; diff --git a/src/UntrustedText.cpp b/src/UntrustedText.cpp new file mode 100644 index 000000000..f8dc0e59d --- /dev/null +++ b/src/UntrustedText.cpp @@ -0,0 +1,103 @@ +/*************************************************************************** + * Copyright (C) 2026 by Mike Conley - mike.conley@stickmud.com * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +#include "UntrustedText.h" + +#include "utils.h" + +bool UntrustedText::unsafeCharacter(char32_t codePoint) +{ + // C0 controls, DEL, and C1 controls - which include CR, LF and NEL. + if (codePoint <= 0x1F || (codePoint >= 0x7F && codePoint <= 0x9F)) { + return true; + } + // Arabic letter mark, zero-width space through RLM, the explicit bidi + // embedding and override controls, and the bidi isolates. + if (codePoint == 0x061C || (codePoint >= 0x200B && codePoint <= 0x200F) || (codePoint >= 0x202A && codePoint <= 0x202E) || (codePoint >= 0x2066 && codePoint <= 0x2069)) { + return true; + } + // Line and paragraph separators, which Qt renders as a real line break. + if (codePoint >= 0x2028 && codePoint <= 0x2029) { + return true; + } + // The tag characters, invisible by design. U+E0001 is deprecated; the rest + // are what emoji subdivision flag sequences are built from, so this range + // is deliberately not applied to authored text. + if (codePoint >= 0xE0000 && codePoint <= 0xE007F) { + return true; + } + // Word joiner and byte order mark, both invisible padding. + return codePoint == 0x2060 || codePoint == 0xFEFF; +} + +bool UntrustedText::unsafeAuthoredCharacter(char32_t codePoint) +{ + // ZWNJ and ZWJ carry meaning in text a human is meant to read - emoji + // sequences and Persian, Arabic and Indic shaping - so escaping them + // corrupts legitimate content. They stay unsafe in a link target, where + // they have no such role and would only serve to hide part of it. + if (codePoint == 0x200C || codePoint == 0x200D) { + return false; + } + // Only the assigned tag characters, which is all an emoji subdivision flag + // needs - the lowest any of them uses is U+E0062. U+E0001 is a deprecated + // language tag and U+E0000 and U+E0002 to U+E001F are unassigned, so none + // of them can be needed by text meant to be read, and they keep no hiding + // space they do not have to. + if (codePoint >= 0xE0020 && codePoint <= 0xE007F) { + return false; + } + + return unsafeCharacter(codePoint); +} + +QString UntrustedText::forTarget(const QString& text) +{ + return escapeWith(text, &UntrustedText::unsafeCharacter); +} + +QString UntrustedText::forAuthoredText(const QString& text) +{ + return escapeWith(text, &UntrustedText::unsafeAuthoredCharacter); +} + +QString UntrustedText::escapeWith(const QString& text, bool (*unsafe)(char32_t)) +{ + const QList<uint> codePoints = text.toUcs4(); + + QString result; + result.reserve(text.size()); + for (qsizetype i = 0; i < codePoints.size(); ++i) { + const uint codePoint = codePoints.at(i); + if (unsafe(static_cast<char32_t>(codePoint))) { + // Uppercase the hex digits only - uppercasing the whole fragment + // would turn the \u prefix into \U. + result += qsl("\\u{%1}").arg(QString::number(codePoint, 16).toUpper()); + } else if (codePoint == '\\' && i + 2 < codePoints.size() && codePoints.at(i + 1) == 'u' && codePoints.at(i + 2) == '{') { + // A literal "\u{...}" in server text would read the same as an + // escaped invisible character, so the backslash that starts one is + // itself escaped to keep the output unambiguous. + result += qsl("\\u{5C}"); + } else { + result += QChar::fromUcs4(codePoint); + } + } + + return result; +} diff --git a/src/UntrustedText.h b/src/UntrustedText.h new file mode 100644 index 000000000..4b8879832 --- /dev/null +++ b/src/UntrustedText.h @@ -0,0 +1,61 @@ +#ifndef MUDLET_UNTRUSTEDTEXT_H +#define MUDLET_UNTRUSTEDTEXT_H + +/*************************************************************************** + * Copyright (C) 2026 by Mike Conley - mike.conley@stickmud.com * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +#include <QString> + +// Escapes characters a remote game server could use to make displayed text +// misrepresent itself. Two policies, because the two kinds of text have +// different needs: +// +// forTarget() - a command or URL the user reads to decide whether to +// trust a link. Nothing invisible may survive here. +// forAuthoredText() - a tooltip, menu label or menu title the server author +// wrote to be read. Same policy, except it keeps the +// joiners and tag characters that multi-part emoji and +// Persian, Arabic and Indic text are built from. +class UntrustedText +{ +public: + // True for the enumerated set of code points that render as invisible, + // zero-width, direction reordering, or line breaking text - not a general + // test for those properties. The set is deliberately narrow; widen it in + // the implementation rather than assuming coverage. + static bool unsafeCharacter(char32_t codePoint); + + // As unsafeCharacter(), minus the zero-width joiner and non-joiner and the + // assigned tag characters U+E0020 to U+E007F. Those are load-bearing in + // text meant to be read: ZWJ builds 👨‍🍳 and 🏳️‍🌈, the tag characters build + // subdivision flags like 🏴󠁧󠁢󠁳󠁣󠁴󠁿, and ZWNJ is required for correct Persian + // and Indic shaping. + static bool unsafeAuthoredCharacter(char32_t codePoint); + + // Replace every unsafe code point with a visible \u{...} escape carrying + // its hex value, leaving all other text - including non-Latin scripts and + // astral plane code points - untouched. + static QString forTarget(const QString& text); + static QString forAuthoredText(const QString& text); + +private: + static QString escapeWith(const QString& text, bool (*unsafe)(char32_t)); +}; + +#endif // MUDLET_UNTRUSTEDTEXT_H diff --git a/src/XMLexport.cpp b/src/XMLexport.cpp index 0152641a3..fe4a4b8ac 100644 --- a/src/XMLexport.cpp +++ b/src/XMLexport.cpp @@ -543,6 +543,7 @@ void XMLexport::writeHost(Host* pHost, pugi::xml_node mudletPackage) host.append_attribute("DebugShowAllProblemCodepoints") = pHost->debugShowAllProblemCodepoints() ? "yes" : "no"; host.append_attribute("announceIncomingText") = pHost->mAnnounceIncomingText ? "yes" : "no"; host.append_attribute("advertiseScreenReader") = pHost->mAdvertiseScreenReader ? "yes" : "no"; + host.append_attribute("enableOSC8Hyperlinks") = pHost->mEnableOSC8Hyperlinks ? "yes" : "no"; host.append_attribute("f3SearchEnabled") = pHost->mF3SearchEnabled ? "yes" : "no"; host.append_attribute("enableClosedCaption") = pHost->mEnableClosedCaption ? "yes" : "no"; host.append_attribute("caretShortcut") = QMetaEnum::fromType<Host::CaretShortcut>().valueToKey(static_cast<int>(pHost->mCaretShortcut)); diff --git a/src/XMLimport.cpp b/src/XMLimport.cpp index b2790d206..5e8df4b8f 100644 --- a/src/XMLimport.cpp +++ b/src/XMLimport.cpp @@ -737,6 +737,7 @@ void XMLimport::readHost(Host* pHost) setBoolAttributeWithDefault(qsl("announceIncomingText"), pHost->mAnnounceIncomingText, true); setBoolAttributeWithDefault(qsl("advertiseScreenReader"), pHost->mAdvertiseScreenReader, false); + setBoolAttributeWithDefault(qsl("enableOSC8Hyperlinks"), pHost->mEnableOSC8Hyperlinks, true); setBoolAttributeWithDefault(qsl("enableClosedCaption"), pHost->mEnableClosedCaption, false); setBoolAttributeWithDefault(qsl("mEnableMTTS"), pHost->mEnableMTTS, true); setBoolAttributeWithDefault(qsl("mEnableMNES"), pHost->mEnableMNES, false); diff --git a/src/ctelnet.cpp b/src/ctelnet.cpp index 2fb66f0b2..2309ac092 100644 --- a/src/ctelnet.cpp +++ b/src/ctelnet.cpp @@ -1971,67 +1971,67 @@ QString cTelnet::getNewEnvironOSCColorPalette() QString cTelnet::getNewEnvironOSCHyperlinks() { - return qsl("1"); + return mpHost->mEnableOSC8Hyperlinks ? qsl("1") : qsl("0"); } QString cTelnet::getNewEnvironOSCHyperlinksSend() { - return qsl("1"); + return mpHost->mEnableOSC8Hyperlinks ? qsl("1") : qsl("0"); } QString cTelnet::getNewEnvironOSCHyperlinksPrompt() { - return qsl("1"); + return mpHost->mEnableOSC8Hyperlinks ? qsl("1") : qsl("0"); } QString cTelnet::getNewEnvironOSCHyperlinksStyleBasic() { - return qsl("1"); + return mpHost->mEnableOSC8Hyperlinks ? qsl("1") : qsl("0"); } QString cTelnet::getNewEnvironOSCHyperlinksStyleStates() { - return qsl("1"); + return mpHost->mEnableOSC8Hyperlinks ? qsl("1") : qsl("0"); } QString cTelnet::getNewEnvironOSCHyperlinksTooltip() { - return qsl("1"); + return mpHost->mEnableOSC8Hyperlinks ? qsl("1") : qsl("0"); } QString cTelnet::getNewEnvironOSCHyperlinksMenu() { - return qsl("1"); + return mpHost->mEnableOSC8Hyperlinks ? qsl("1") : qsl("0"); } QString cTelnet::getNewEnvironOSCHyperlinksCompact() { - return qsl("1"); + return mpHost->mEnableOSC8Hyperlinks ? qsl("1") : qsl("0"); } QString cTelnet::getNewEnvironOSCHyperlinksPresets() { - return qsl("1"); + return mpHost->mEnableOSC8Hyperlinks ? qsl("1") : qsl("0"); } QString cTelnet::getNewEnvironOSCHyperlinksVisibility() { - return qsl("1"); + return mpHost->mEnableOSC8Hyperlinks ? qsl("1") : qsl("0"); } QString cTelnet::getNewEnvironOSCHyperlinksSelection() { - return qsl("1"); + return mpHost->mEnableOSC8Hyperlinks ? qsl("1") : qsl("0"); } QString cTelnet::getNewEnvironOSCHyperlinksSpoiler() { - return qsl("1"); + return mpHost->mEnableOSC8Hyperlinks ? qsl("1") : qsl("0"); } QString cTelnet::getNewEnvironOSCHyperlinksDisabled() { - return qsl("1"); + return mpHost->mEnableOSC8Hyperlinks ? qsl("1") : qsl("0"); } bool cTelnet::oscHyperlinkConfigFeatureEnabled() @@ -2128,23 +2128,37 @@ QMap<QString, QPair<bool, QString>> cTelnet::getNewEnvironDataMap() // SEND INFO per https://www.rfc-editor.org/rfc/rfc1572 void cTelnet::sendInfoNewEnvironValue(const QString& var) +{ + sendInfoNewEnvironValues(QStringList{var}); +} + +// RFC 1572 gives INFO the same syntax as IS, so one subnegotiation may carry +// several variables. Preferred when a single preference changes a group of +// them, because the server then sees one consistent change rather than a run of +// partial ones. +void cTelnet::sendInfoNewEnvironValues(const QStringList& vars) { if (!enableNewEnviron || !mpHost->mEnableNEWENVIRON) { return; } - if (mpHost->mEnableMNES && !isMNESVariable(var)) { - return; - } - - if (!newEnvironVariablesSent.contains(var)) { - qDebug() << "We did not update NEW_ENVIRON" << var << "because the server did not request it yet"; - return; - } - const QMap<QString, QPair<bool, QString>> newEnvironDataMap = getNewEnvironDataMap(); - if (newEnvironDataMap.contains(var)) { + std::string payload; + for (const auto& var : vars) { + if (mpHost->mEnableMNES && !isMNESVariable(var)) { + continue; + } + + if (!newEnvironVariablesSent.contains(var)) { + qDebug() << "We did not update NEW_ENVIRON" << var << "because the server did not request it yet"; + continue; + } + + if (!newEnvironDataMap.contains(var)) { + continue; + } + qDebug() << "We updated NEW_ENVIRON" << var; // QPair first: NEW_ENVIRON_USERVAR indicator, second: data @@ -2152,25 +2166,16 @@ void cTelnet::sendInfoNewEnvironValue(const QString& var) const bool isUserVar = !mpHost->mEnableMNES && newEnvironData.first; const QString val = newEnvironData.second; - std::string output; - output += TN_IAC; - output += TN_SB; - output += OPT_NEW_ENVIRON; - output += NEW_ENVIRON_INFO; - output += isUserVar ? NEW_ENVIRON_USERVAR : NEW_ENVIRON_VAR; - output += prepareNewEnvironData(var).toStdString(); - output += NEW_ENVIRON_VAL; + payload += isUserVar ? NEW_ENVIRON_USERVAR : NEW_ENVIRON_VAR; + payload += prepareNewEnvironData(var).toStdString(); + payload += NEW_ENVIRON_VAL; // RFC 1572: If a VALUE is immediately followed by a "type" or IAC, then the // variable is defined, but has no value. if (!val.isEmpty()) { - output += prepareNewEnvironData(val).toStdString(); + payload += prepareNewEnvironData(val).toStdString(); } - output += TN_IAC; - output += TN_SE; - socketOutRaw(output); - if (mpHost->mEnableMNES) { if (!val.isEmpty()) { qDebug() << "WE inform NEW_ENVIRON (MNES) VAR" << var << "VAL" << val; @@ -2189,6 +2194,39 @@ void cTelnet::sendInfoNewEnvironValue(const QString& var) qDebug() << "WE inform NEW_ENVIRON USERVAR" << var << "as an empty VAL"; } } + + // Every candidate was filtered out, so send nothing rather than an empty + // INFO subnegotiation. + if (payload.empty()) { + return; + } + + std::string output; + output += TN_IAC; + output += TN_SB; + output += OPT_NEW_ENVIRON; + output += NEW_ENVIRON_INFO; + output += payload; + output += TN_IAC; + output += TN_SE; + socketOutRaw(output); +} + +void cTelnet::sendInfoNewEnvironOSCHyperlinks() +{ + // Derived from the advertised set rather than a second hand-kept list, so a + // capability added later is announced without touching this - as long as it + // keeps the OSC_HYPERLINKS prefix. + const QMap<QString, QPair<bool, QString>> newEnvironDataMap = getNewEnvironDataMap(); + + QStringList vars; + for (auto it = newEnvironDataMap.cbegin(); it != newEnvironDataMap.cend(); ++it) { + if (it.key().startsWith(qsl("OSC_HYPERLINKS"))) { + vars.append(it.key()); + } + } + + sendInfoNewEnvironValues(vars); } void cTelnet::appendAllNewEnvironValues(std::string& output, const bool isUserVar, const QMap<QString, QPair<bool, QString>>& newEnvironDataMap) diff --git a/src/ctelnet.h b/src/ctelnet.h index 48a8b4e27..52f9ec852 100644 --- a/src/ctelnet.h +++ b/src/ctelnet.h @@ -188,6 +188,8 @@ public: QMap<QString, QPair<bool, QString>> getNewEnvironDataMap(); bool isMNESVariable(const QString&); void sendInfoNewEnvironValue(const QString&); + void sendInfoNewEnvironValues(const QStringList&); + void sendInfoNewEnvironOSCHyperlinks(); void setATCPVariables(const QByteArray&); void setGMCPVariables(const QByteArray&); void setMSSPVariables(const QByteArray&); diff --git a/src/dlgProfilePreferences.cpp b/src/dlgProfilePreferences.cpp index a9eaaea21..98893802b 100644 --- a/src/dlgProfilePreferences.cpp +++ b/src/dlgProfilePreferences.cpp @@ -817,6 +817,8 @@ void dlgProfilePreferences::initWithHost(Host* pHost) checkBox_announceIncomingText->setChecked(pHost->mAnnounceIncomingText); checkBox_advertiseScreenReader->setChecked(pHost->mAdvertiseScreenReader); connect(checkBox_advertiseScreenReader, &QCheckBox::toggled, this, &dlgProfilePreferences::slot_toggleAdvertiseScreenReader); + checkBox_enableOSC8Hyperlinks->setChecked(pHost->mEnableOSC8Hyperlinks); + connect(checkBox_enableOSC8Hyperlinks, &QCheckBox::toggled, this, &dlgProfilePreferences::slot_toggleEnableOSC8Hyperlinks); checkBox_enableClosedCaption->setChecked(pHost->mEnableClosedCaption); connect(checkBox_enableClosedCaption, &QCheckBox::toggled, this, &dlgProfilePreferences::slot_toggleEnableClosedCaption); @@ -3512,6 +3514,7 @@ void dlgProfilePreferences::slot_saveAndClose() pHost->mMMCPShowSnoopInMainConsole = checkBox_mmcpSnoopInMainConsole->isChecked(); pHost->mAnnounceIncomingText = checkBox_announceIncomingText->isChecked(); pHost->mAdvertiseScreenReader = checkBox_advertiseScreenReader->isChecked(); + pHost->mEnableOSC8Hyperlinks = checkBox_enableOSC8Hyperlinks->isChecked(); pHost->mEnableClosedCaption = checkBox_enableClosedCaption->isChecked(); pHost->setHaveColorSpaceId(checkBox_expectCSpaceIdInColonLessMColorCode->isChecked()); @@ -5040,6 +5043,20 @@ void dlgProfilePreferences::slot_toggleAdvertiseScreenReader(const bool state) } } +void dlgProfilePreferences::slot_toggleEnableOSC8Hyperlinks(const bool state) +{ + Host* pHost = mpHost; + + if (!pHost) { + return; + } + + if (pHost->mEnableOSC8Hyperlinks != state) { + pHost->mEnableOSC8Hyperlinks = state; + pHost->mTelnet.sendInfoNewEnvironOSCHyperlinks(); + } +} + void dlgProfilePreferences::slot_toggleEnableClosedCaption(const bool state) { if (mpHost && mpHost->mEnableClosedCaption != state) { diff --git a/src/dlgProfilePreferences.h b/src/dlgProfilePreferences.h index 3420f2597..42c985e9c 100644 --- a/src/dlgProfilePreferences.h +++ b/src/dlgProfilePreferences.h @@ -171,6 +171,7 @@ private slots: void slot_setPostingTimeout(const double); void slot_changeControlCharacterHandling(); void slot_toggleAdvertiseScreenReader(const bool); + void slot_toggleEnableOSC8Hyperlinks(const bool); void slot_changeWrapAt(); void slot_toggleUseMaxBufferSize(bool checked); void slot_deleteMap(); diff --git a/src/ui/profile_preferences.ui b/src/ui/profile_preferences.ui index e079fc822..422c4be76 100644 --- a/src/ui/profile_preferences.ui +++ b/src/ui/profile_preferences.ui @@ -369,6 +369,19 @@ </property> </widget> </item> + <item row="2" column="0" colspan="2"> + <widget class="QCheckBox" name="checkBox_enableOSC8Hyperlinks"> + <property name="toolTip"> + <string><p>OSC 8 lets a game server put clickable links in its output, which can send commands, pre-fill your input line, or open a web page. Uncheck to ignore them and to stop telling servers that Mudlet supports them.</p></string> + </property> + <property name="accessibleDescription"> + <string>When checked, clickable OSC 8 hyperlinks from the game server are shown and Mudlet advertises support for them. When unchecked, the sequences are ignored and the capability is not advertised.</string> + </property> + <property name="text"> + <string>Enable OSC 8 hyperlinks from the server</string> + </property> + </widget> + </item> </layout> </widget> </item> @@ -5185,6 +5198,7 @@ you can use it but there could be issues with aligning columns of text</string> <tabstop>pushButton_chooseProtocols</tabstop> <tabstop>acceptServerGUI</tabstop> <tabstop>acceptServerMedia</tabstop> + <tabstop>checkBox_enableOSC8Hyperlinks</tabstop> <tabstop>mIsToLogInHtml</tabstop> <tabstop>lineEdit_logFileFolder</tabstop> <tabstop>comboBox_logFileNameFormat</tabstop> diff --git a/test/CMakeLists.txt b/test/CMakeLists.txt index 3ff0759fa..ffeb58a97 100644 --- a/test/CMakeLists.txt +++ b/test/CMakeLists.txt @@ -12,6 +12,8 @@ find_package(Qt6 6.8.2 REQUIRED COMPONENTS Test Network Widgets) set(UNIT_TESTS TEntityResolverTest TEntityHandlerTest + LuaLiteralTest + UntrustedTextTest TLinkStoreTest TMxpTagParserTest TMxpSendTagHandlerTest diff --git a/test/LuaLiteralTest.cpp b/test/LuaLiteralTest.cpp new file mode 100644 index 000000000..787470842 --- /dev/null +++ b/test/LuaLiteralTest.cpp @@ -0,0 +1,189 @@ +/*************************************************************************** + * Copyright (C) 2026 by Mike Conley - mike.conley@stickmud.com * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +#include "LuaLiteral.h" + +#include <QtTest/QtTest> + +#include <memory> + +extern "C" { +#if defined(INCLUDE_VERSIONED_LUA_HEADERS) +#include <lua5.1/lauxlib.h> +#include <lua5.1/lua.h> +#include <lua5.1/lualib.h> +#else +#include <lauxlib.h> +#include <lua.h> +#include <lualib.h> +#endif +} + +/* + * A game server controls the payload of an OSC 8 send:/prompt:/http: URI, and + * Mudlet turns that payload into Lua source that is executed when the user + * clicks the link. If the payload can terminate the string literal it is + * embedded in, the remainder of the payload is executed as code. These tests + * assert the property that matters: whatever the payload, evaluating the + * generated literal yields the payload back and runs nothing else. + */ +class LuaLiteralTest : public QObject +{ + Q_OBJECT + +private: + // Evaluates "return <literal>" in a fresh Lua 5.1 state. Returns the + // resulting string, or a null QString if the chunk did not compile or did + // not produce exactly one string. + static QString evaluate(const QString& literal) + { + std::unique_ptr<lua_State, decltype(&lua_close)> state(luaL_newstate(), &lua_close); + if (!state) { + return QString(); + } + + const QByteArray chunk = QString(QLatin1String("return ") + literal).toUtf8(); + if (luaL_loadbuffer(state.get(), chunk.constData(), chunk.size(), "literal") != 0) { + return QString(); + } + if (lua_pcall(state.get(), 0, LUA_MULTRET, 0) != 0) { + return QString(); + } + if (lua_gettop(state.get()) != 1 || !lua_isstring(state.get(), -1)) { + return QString(); + } + + size_t length = 0; + const char* value = lua_tolstring(state.get(), -1, &length); + return QString::fromUtf8(value, static_cast<int>(length)); + } + +private slots: + void initTestCase() {} + + void testRoundTrip_data() + { + QTest::addColumn<QString>("payload"); + + QTest::newRow("plain command") << QStringLiteral("look"); + QTest::newRow("empty") << QStringLiteral(""); + QTest::newRow("spaces") << QStringLiteral("cast fireball at troll"); + QTest::newRow("leading newline") << QStringLiteral("\nlook"); + QTest::newRow("trailing newline") << QStringLiteral("look\n"); + QTest::newRow("embedded newline") << QStringLiteral("look\nnorth"); + QTest::newRow("single close bracket") << QStringLiteral("a]b"); + // A payload ending in "]" merges with the closer appended after it and + // shuts the literal one character early. Ordinary MUD commands and bare + // IPv6 URLs end this way. + QTest::newRow("trailing close bracket") << QStringLiteral("look north]"); + QTest::newRow("bare close bracket") << QStringLiteral("]"); + QTest::newRow("ooc tag") << QStringLiteral("say [OOC]"); + QTest::newRow("inventory slot") << QStringLiteral("get sword from bag[1]"); + QTest::newRow("ipv6 url") << QStringLiteral("http://[::1]"); + QTest::newRow("trailing closer prefix level 1") << QStringLiteral("a]]b]="); + QTest::newRow("trailing closer prefix level 2") << QStringLiteral("a]]b]=]c]=="); + QTest::newRow("level 0 breakout") << QStringLiteral("]],false) os.execute([[touch /tmp/pwned]]) --"); + QTest::newRow("level 1 breakout") << QStringLiteral("]=],false) os.execute([=[x]=]) --"); + QTest::newRow("both levels") << QStringLiteral("a]]b]=]c"); + QTest::newRow("nested open bracket") << QStringLiteral("a[[b"); + QTest::newRow("nested open bracket level 1") << QStringLiteral("a[[b]]c[=[d"); + QTest::newRow("quotes and backslashes") << QStringLiteral("say \"hi\\there\""); + QTest::newRow("percent markers") << QStringLiteral("say %1 %2 %%"); + QTest::newRow("url with fragment") << QStringLiteral("https://example.com/a?b=c#d"); + QTest::newRow("utf8") << QStringLiteral("say éè你好"); + } + + void testRoundTrip() + { + QFETCH(QString, payload); + + const QString literal = LuaLiteral::quote(payload); + const QString result = evaluate(literal); + + QVERIFY2(!result.isNull(), qPrintable(QStringLiteral("literal did not compile to a single string: %1").arg(literal))); + QCOMPARE(result, payload); + } + + void testBreakoutDoesNotExecute() + { + // The classic payload: close the literal, close the send() call, run + // arbitrary code, comment out the tail. Building the same call shape + // Mudlet builds must produce a chunk that assigns the payload as data. + const QString payload = QStringLiteral("]],false) BREAKOUT = 1 --"); + const QString chunkSource = QStringLiteral("captured = %1").arg(LuaLiteral::quote(payload)); + + std::unique_ptr<lua_State, decltype(&lua_close)> state(luaL_newstate(), &lua_close); + QVERIFY(state); + + const QByteArray chunk = chunkSource.toUtf8(); + QCOMPARE(luaL_loadbuffer(state.get(), chunk.constData(), chunk.size(), "chunk"), 0); + QCOMPARE(lua_pcall(state.get(), 0, 0, 0), 0); + + lua_getglobal(state.get(), "BREAKOUT"); + QVERIFY2(lua_isnil(state.get(), -1), "payload escaped the literal and executed"); + lua_pop(state.get(), 1); + + lua_getglobal(state.get(), "captured"); + QVERIFY(lua_isstring(state.get(), -1)); + QCOMPARE(QString::fromUtf8(lua_tostring(state.get(), -1)), payload); + } + + // The hand-picked rows above only catch payload shapes someone thought of; + // the trailing-']' case survived review precisely because nobody did. Every + // string over the bracket alphabet is cheap enough to just enumerate. + void testExhaustiveBracketAlphabet() + { + const QList<QChar> alphabet = {QLatin1Char('['), QLatin1Char(']'), QLatin1Char('='), QLatin1Char('a')}; + + QStringList current = {QString()}; + int checked = 0; + for (int length = 1; length <= 5; ++length) { + QStringList next; + for (const QString& prefix : std::as_const(current)) { + for (const QChar letter : std::as_const(alphabet)) { + next.append(prefix + letter); + } + } + current = next; + + for (const QString& payload : std::as_const(current)) { + const QString result = evaluate(LuaLiteral::quote(payload)); + if (result.isNull() || result != payload) { + QFAIL(qPrintable(QStringLiteral("payload %1 did not round-trip; literal was %2").arg(payload, LuaLiteral::quote(payload)))); + } + ++checked; + } + } + + QCOMPARE(checked, 1364); + } + + void testLevelEscalation() + { + // Spelling is an implementation detail, but the escalation rule is + // worth pinning: a payload that cannot terminate level 0 must not pay + // for a higher level. + QVERIFY(LuaLiteral::quote(QStringLiteral("look")).startsWith(QStringLiteral("[["))); + QVERIFY(LuaLiteral::quote(QStringLiteral("a]]b")).startsWith(QStringLiteral("[=["))); + QVERIFY(LuaLiteral::quote(QStringLiteral("a]]b]=]c")).startsWith(QStringLiteral("[==["))); + } +}; + +QTEST_MAIN(LuaLiteralTest) +#include "LuaLiteralTest.moc" diff --git a/test/OAuthClientFlowTest.cpp b/test/OAuthClientFlowTest.cpp index e8037c046..af18ff718 100644 --- a/test/OAuthClientFlowTest.cpp +++ b/test/OAuthClientFlowTest.cpp @@ -292,6 +292,8 @@ void OAuthClientFlowTest::testDiscoveryFetchFailureFailsFlow() MiniClosingServer discovery; flow.start(discovery.discoveryUrl(), QStringLiteral("test-client"), {QStringLiteral("openid")}, false); QTRY_COMPARE_WITH_TIMEOUT(failedSpy.count(), 1, 15000); + // A failed discovery fetch must not have produced an authorization URL. + QVERIFY(mAuthorizationUrl.isEmpty()); } void OAuthClientFlowTest::testNonLoopbackHttpDiscoveryUrlRejected() @@ -303,6 +305,8 @@ void OAuthClientFlowTest::testNonLoopbackHttpDiscoveryUrlRejected() // before any network activity happens. flow.start(QUrl(QStringLiteral("http://example.com/.well-known/openid-configuration")), QStringLiteral("test-client"), {QStringLiteral("openid")}, false); QCOMPARE(failedSpy.count(), 1); + // The rejected discovery URL must not have produced an authorization URL. + QVERIFY(mAuthorizationUrl.isEmpty()); } void OAuthClientFlowTest::testProviderErrorFailsFlow() diff --git a/test/UntrustedTextTest.cpp b/test/UntrustedTextTest.cpp new file mode 100644 index 000000000..f08956179 --- /dev/null +++ b/test/UntrustedTextTest.cpp @@ -0,0 +1,188 @@ +/*************************************************************************** + * Copyright (C) 2026 by Mike Conley - mike.conley@stickmud.com * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +#include "UntrustedText.h" + +#include <QtTest/QtTest> + +/* + * A game server chooses the tooltip, menu labels and menu title of an OSC 8 + * link, and Mudlet shows the link's target URL in the default hint. Bidi + * overrides and zero-width characters let that text claim one target while the + * link carries another, so they are escaped into a visible form before display. + * + * Test inputs spell invisible code points as \uXXXX escapes rather than + * embedding them raw: editors and review tools that strip invisible characters + * have silently deleted them from source before, which turns a real assertion + * into one that passes for the wrong reason. + */ +class UntrustedTextTest : public QObject +{ + Q_OBJECT + +private slots: + void initTestCase() {} + + void testOrdinaryTextUnchanged() { QCOMPARE(UntrustedText::forTarget(QStringLiteral("Open browser to: https://www.mudlet.org")), QStringLiteral("Open browser to: https://www.mudlet.org")); } + + void testNonLatinTextUnchanged() + { + // Sanitization must not damage legitimate non-Latin tooltips. + const QString text = QStringLiteral("你好 مرحبا Здравствуй"); + QCOMPARE(UntrustedText::forTarget(text), text); + } + + void testAstralPlaneTextUnchanged() + { + // Surrogate pairs must round-trip: an emoji is two QChars, one code point. + const QString text = QStringLiteral("a\U0001F600b"); + QCOMPARE(UntrustedText::forTarget(text), text); + } + + void testRightToLeftOverrideEscaped() { QCOMPARE(UntrustedText::forTarget(QStringLiteral("mudlet\u202Egro.live")), QStringLiteral("mudlet\\u{202E}gro.live")); } + + void testZeroWidthEscaped() { QCOMPARE(UntrustedText::forTarget(QStringLiteral("mud\u200Blet.org")), QStringLiteral("mud\\u{200B}let.org")); } + + void testByteOrderMarkEscaped() { QCOMPARE(UntrustedText::forTarget(QStringLiteral("a\uFEFFb")), QStringLiteral("a\\u{FEFF}b")); } + + void testControlCharactersEscaped() + { + // A newline in a tooltip creates a second visual line that can forge + // trusted-looking UI text below the real target. + QCOMPARE(UntrustedText::forTarget(QStringLiteral("a\nb")), QStringLiteral("a\\u{A}b")); + QCOMPARE(UntrustedText::forTarget(QStringLiteral("a\u0085b")), QStringLiteral("a\\u{85}b")); + } + + void testLineSeparatorEscaped() { QCOMPARE(UntrustedText::forTarget(QStringLiteral("a\u2028b")), QStringLiteral("a\\u{2028}b")); } + + void testEmptyText() { QCOMPARE(UntrustedText::forTarget(QString()), QString()); } + + void testLiteralEscapeSequenceDisambiguated() + { + // Server text containing the six characters \u{202E} must not display + // the same as a sanitized real U+202E. + QCOMPARE(UntrustedText::forTarget(QStringLiteral("a\\u{202E}b")), QStringLiteral("a\\u{5C}u{202E}b")); + // A backslash not starting a \u{ sequence is left alone. + QCOMPARE(UntrustedText::forTarget(QStringLiteral("C:\\mud\\maps")), QStringLiteral("C:\\mud\\maps")); + } + + // Emoji in tooltips and menu labels are a documented OSC 8 feature and are + // used in the wild. The strict policy escapes the joiners and tag + // characters they are assembled from, so authored text must not use it. + void testAuthoredTextKeepsEmoji_data() + { + QTest::addColumn<QString>("emoji"); + + QTest::newRow("rainbow flag") << QStringLiteral("\U0001F3F3\uFE0F\u200D\U0001F308"); + QTest::newRow("pirate flag") << QStringLiteral("\U0001F3F4\u200D☠\uFE0F"); + QTest::newRow("man cook") << QStringLiteral("\U0001F468\u200D\U0001F373"); + QTest::newRow("family") << QStringLiteral("\U0001F468\u200D\U0001F469\u200D\U0001F467"); + QTest::newRow("scotland flag") << QStringLiteral("\U0001F3F4\U000E0067\U000E0062\U000E0073\U000E0063\U000E0074\U000E007F"); + QTest::newRow("plain emoji") << QStringLiteral("⚔\uFE0F"); + QTest::newRow("skin tone") << QStringLiteral("\U0001F44D\U0001F3FD"); + QTest::newRow("regional flag") << QStringLiteral("\U0001F1EC\U0001F1E7"); + } + + void testAuthoredTextKeepsEmoji() + { + QFETCH(QString, emoji); + QCOMPARE(UntrustedText::forAuthoredText(emoji), emoji); + } + + void testAuthoredTextKeepsPersianShaping() + { + // ZWNJ separates the prefix in this Persian verb; escaping it changes + // how the word is shaped and read. + const QString text = QStringLiteral("می\u200Cرود"); + QCOMPARE(UntrustedText::forAuthoredText(text), text); + } + + void testAuthoredTextEscapesUnusableTagCharacters() + { + // The exception covers only what an emoji flag needs. The deprecated + // language tag and the unassigned code points below it are not that. + QCOMPARE(UntrustedText::forAuthoredText(QStringLiteral("a\U000E0001b")), QStringLiteral("a\\u{E0001}b")); + QCOMPARE(UntrustedText::forAuthoredText(QStringLiteral("a\U000E0000b")), QStringLiteral("a\\u{E0000}b")); + QCOMPARE(UntrustedText::forAuthoredText(QStringLiteral("a\U000E001Fb")), QStringLiteral("a\\u{E001F}b")); + // The first assigned tag character is where the exception starts. + QCOMPARE(UntrustedText::forAuthoredText(QStringLiteral("a\U000E0020b")), QStringLiteral("a\U000E0020b")); + } + + void testTargetStillEscapesWhatAuthoredTextKeeps() + { + // The same characters must not survive in a link target, where they + // would hide part of what the user is being asked to trust. + QCOMPARE(UntrustedText::forTarget(QStringLiteral("a\u200Db")), QStringLiteral("a\\u{200D}b")); + QCOMPARE(UntrustedText::forTarget(QStringLiteral("a\u200Cb")), QStringLiteral("a\\u{200C}b")); + QCOMPARE(UntrustedText::forTarget(QStringLiteral("a\U000E0067b")), QStringLiteral("a\\u{E0067}b")); + } + + void testAuthoredTextStillEscapesReordering() + { + // Relaxing the joiners must not relax the characters that let a label + // misrepresent itself or forge a second line of UI. + QCOMPARE(UntrustedText::forAuthoredText(QStringLiteral("mudlet\u202Egro.live")), QStringLiteral("mudlet\\u{202E}gro.live")); + QCOMPARE(UntrustedText::forAuthoredText(QStringLiteral("a\u2066b")), QStringLiteral("a\\u{2066}b")); + QCOMPARE(UntrustedText::forAuthoredText(QStringLiteral("a\nb")), QStringLiteral("a\\u{A}b")); + QCOMPARE(UntrustedText::forAuthoredText(QStringLiteral("a\u2028b")), QStringLiteral("a\\u{2028}b")); + QCOMPARE(UntrustedText::forAuthoredText(QStringLiteral("a\u200Bb")), QStringLiteral("a\\u{200B}b")); + QCOMPARE(UntrustedText::forAuthoredText(QStringLiteral("a\uFEFFb")), QStringLiteral("a\\u{FEFF}b")); + } + + void testClassification() + { + QVERIFY(UntrustedText::unsafeCharacter(0x202E)); + QVERIFY(UntrustedText::unsafeCharacter(0x200B)); + QVERIFY(UntrustedText::unsafeCharacter(0x0000)); + QVERIFY(UntrustedText::unsafeCharacter(0x009F)); + // Bidi embeddings and overrides, and the isolates that replaced them. + QVERIFY(UntrustedText::unsafeCharacter(0x202A)); + QVERIFY(UntrustedText::unsafeCharacter(0x202D)); + QVERIFY(UntrustedText::unsafeCharacter(0x2066)); + QVERIFY(UntrustedText::unsafeCharacter(0x2069)); + // Arabic letter mark, zero-width joiners and the word joiner. + QVERIFY(UntrustedText::unsafeCharacter(0x061C)); + QVERIFY(UntrustedText::unsafeCharacter(0x200C)); + QVERIFY(UntrustedText::unsafeCharacter(0x200D)); + QVERIFY(UntrustedText::unsafeCharacter(0x2060)); + // Both ends of the invisible-by-design tag character block. + QVERIFY(UntrustedText::unsafeCharacter(0xE0000)); + QVERIFY(UntrustedText::unsafeCharacter(0xE007F)); + QVERIFY(!UntrustedText::unsafeCharacter(0x0041)); + QVERIFY(!UntrustedText::unsafeCharacter(0x00A0)); + QVERIFY(!UntrustedText::unsafeCharacter(0x4F60)); + } + + void testAuthoredClassificationDiffersOnlyWhereIntended() + { + // The authored policy is the strict one minus exactly three things. + for (char32_t codePoint = 0; codePoint <= 0xE0100; ++codePoint) { + const bool relaxed = UntrustedText::unsafeCharacter(codePoint) && !UntrustedText::unsafeAuthoredCharacter(codePoint); + const bool expected = codePoint == 0x200C || codePoint == 0x200D || (codePoint >= 0xE0020 && codePoint <= 0xE007F); + if (relaxed != expected) { + QFAIL(qPrintable(QStringLiteral("policies diverge unexpectedly at U+%1").arg(QString::number(static_cast<uint>(codePoint), 16).toUpper()))); + } + // Authored text may never mark something unsafe that strict does not. + QVERIFY(!(UntrustedText::unsafeAuthoredCharacter(codePoint) && !UntrustedText::unsafeCharacter(codePoint))); + } + } +}; + +QTEST_MAIN(UntrustedTextTest) +#include "UntrustedTextTest.moc" From 9a9710b229de5776d66f310cfdfc85795123d61b Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Sat, 8 Aug 2026 11:04:14 +0200 Subject: [PATCH 131/155] fix: new profiles process game text about twice as fast (#9705) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit #### Brief overview of PR changes/additions - The starter UI armed **77 always-active PCRE triggers** (12 chat + 65 vitals) at package load, so every line a game sent was matched against all of them - and every line one matched was then re-walked in Lua with all 77 patterns **recompiled from source**, because `rex.match` given a pattern string compiles it afresh on every call. They are now fronted by 4 triggers (3 chat-routing groups + 1 vitals prefilter) and compiled once. The 65 vitals shapes and 12 chat shapes are byte-identical and still do all the reading. - The plain-text vitals layer now retires itself once GMCP or MSDP holds the source lock, since `applyVitals` discards its readings from that point anyway, and re-arms on disconnect. - `PipelineBenchmark` created its profile through the production new-profile path, so the starter UI was **inside** the `text_lines_per_sec` baseline backing the "no more than 10% throughput loss" gate for #9011 - the guard built to catch this class of regression could not see it. Pipeline metrics now come from a profile with default packages suppressed; the shipped configuration is reported separately as `defaults_*` and gated in its own right. #### Motivation for adding to Mudlet Every new 5.0 profile was paying roughly half its text throughput to a default package, and the perf guard had the cost baked into its own baseline so nothing flagged it. #### Other info (issues closed, discussion etc) Findings C17 and C18 of the 5.0 QA sweep. Bisected there to `69cd06b1c` - "add: starter interface with health bars, map and chat for new players" (#9454); the benchmark half is the interaction of that with `7d67d4bfb` - "infrastructure: perf baseline" (#9509). Measured on a quiet 16-core box, Release, no ASan, alternating paired runs so drift is shared between arms: | workload | before | after | | | --- | --- | --- | --- | | `TelnetBenchmark` `benchLargeData`, 1000 lines that match nothing | 22.25 ms `[22.1-22.6]` | 12.0 ms `[11.9-12.2]` | **1.85x** | | `PipelineBenchmark`, 25k lines of realistic game output, new-user profile | 9,998 lines/s `[9,856-10,072]` | 16,503 lines/s `[16,257-16,632]` | **1.65x** | Complete separation in both (21 and 9 pairs; within-arm spread ±1.7% and ±1.5%, so ~3% is the smallest effect distinguishable from noise - the effect is 85% and 65%). The bare pipeline measures 116,000 lines/s, so the starter UI's remaining cost on that corpus is 7.0x, down from 11.6x; the residual is the capture layer doing its designed work on a corpus where 1 line in 11 is a tell and another 1 in 11 a vitals prompt. Two notes for reviewers: - `config.lua` is bumped to 1.1.0, so mpkg offers the update - but default packages are installed at profile creation, so **profiles already created on a 5.0 PTB keep the old copy** until they update it. - Touches `src/mudlet.cpp` / `src/mudlet.h` / `test/functional_tests/CMakeLists.txt`, which #9695 also touches; the CMakeLists hunk will likely conflict trivially (both append a test file). **Test case:** create a fresh profile against any game without GMCP, confirm the health/mana gauges and chat tabs still appear from prompt and chat lines, then `ctest -R StarterUiTriggerCostTest`. Assisted-by: Claude:claude-opus-5 --- docs/libmudlet-perf-baseline.md | 57 ++- src/TriggerUnit.cpp | 3 +- src/mudlet-lua/tests/UI_spec.lua | 167 +++++++ src/mudlet.cpp | 4 + src/mudlet.h | 3 + src/packages/mudlet-base-ui/config.lua | 2 +- .../mudlet-base-ui/mudlet-base-ui.mpackage | Bin 125619 -> 127430 bytes .../mudlet-base-ui/mudlet-base-ui.xml | 196 +++++++-- test/compare-perf-baseline.py | 7 +- test/functional_tests/CMakeLists.txt | 1 + test/functional_tests/PipelineBenchmark.cpp | 66 ++- .../StarterUiTriggerCostTest.cpp | 406 ++++++++++++++++++ 12 files changed, 868 insertions(+), 44 deletions(-) create mode 100644 test/functional_tests/StarterUiTriggerCostTest.cpp diff --git a/docs/libmudlet-perf-baseline.md b/docs/libmudlet-perf-baseline.md index cff2c99fa..dd5fa4a22 100644 --- a/docs/libmudlet-perf-baseline.md +++ b/docs/libmudlet-perf-baseline.md @@ -78,9 +78,56 @@ METRIC text_mb_per_sec 0.41 METRIC trigger_lines_per_sec 3323.25 METRIC trigger_overhead_ms 1683.64 METRIC peak_rss_kb 1402384 +METRIC defaults_root_triggers ... +METRIC defaults_text_lines_per_sec ... +METRIC defaults_text_best_pass_ms ... +METRIC defaults_peak_rss_kb ... ... ``` +### Two profile configurations, and why the split matters + +The benchmark feeds the corpus under two profile configurations (one slot per +phase, so four profiles are created in all): + +- **`text_*`, `trigger_*`, `peak_rss_kb`** come from a profile with the default + packages suppressed. They describe the pipeline itself, which is what the + libmudlet gate is about. +- **`defaults_*`** comes from a profile carrying the shipped default packages, + the way a new user's profile does. `defaults_root_triggers` records how many + root triggers those packages left armed. + +Keeping them separate means a package regression moves `defaults_*` while the +pipeline numbers stay flat, instead of the two being indistinguishable. + +`defaults_peak_rss_kb` is read after `peak_rss_kb`, and VmHWM is process-wide +and monotonic, so the two are not independent: read `defaults_peak_rss_kb` as +the whole-run high-water mark and its **excess** over `peak_rss_kb` as what the +default packages cost. + +**Run the benchmark under a fresh `HOME` and `XDG_CONFIG_HOME`.** Part of what a +new profile gets - the starter UI - is gated on +`mudlet::experiencedMudletPlayer()`, which answers from the machine's own Mudlet +history, so on a developer machine the `defaults_*` profile would quietly not +get it and `defaults_text_lines_per_sec` would become a second copy of +`text_lines_per_sec`. `benchDefaultPackages` checks the starter UI is installed +and fails the run rather than report that, and `defaults_root_triggers` records +how many root triggers the packages between them armed: + +```bash +scratch=$(mktemp -d) +HOME=$scratch XDG_CONFIG_HOME=$scratch/.config QT_QPA_PLATFORM=offscreen \ + ./test/functional_tests/PipelineBenchmark +``` + +Comparing a build from before this split against one from after it will abort +with "gated metric defaults_text_lines_per_sec is missing from the before run". +That is the script working as intended - the two harnesses are not comparable. +Pass `--gate text_lines_per_sec,trigger_lines_per_sec` to compare across the +change, bearing in mind the older run's `text_lines_per_sec` includes whichever +default packages that machine's `experiencedMudletPlayer()` allowed it - the +older harness had no guard - while the newer one includes none. + ## The before/after workflow (the 10% gate) The gate is a **relative, same-machine** comparison. Never compare numbers taken @@ -115,8 +162,9 @@ on different hardware, or from an ASan build against a release build - only ever test/compare-perf-baseline.py before.txt after.txt ``` -`compare-perf-baseline.py` gates on `text_lines_per_sec` and -`trigger_lines_per_sec` by default (the two throughput numbers); every other +`compare-perf-baseline.py` gates on `text_lines_per_sec`, +`trigger_lines_per_sec` and `defaults_text_lines_per_sec` by default (pipeline +throughput, plus the shipped default packages on the same corpus); every other metric is reported for context. It exits non-zero if any gated metric regressed by more than the threshold, so it drops straight into a script or CI step. Tune it with `--threshold 0.10` and `--gate metric,metric,...`. A `--threshold` of 1 @@ -176,6 +224,11 @@ shape and rough ratios of the output**. Do not treat any figure here as a target or a committed baseline - capture your own "before" on the machine you are testing on and compare against that. +It predates the two-profile split above, so its `text_lines_per_sec` includes +the default packages and there are no `defaults_*` rows. Read the ratios between +the `text_*` and `trigger_*` rows; do not compare any figure here against a +current run. + | Metric | Example value | | --- | --- | | `text_lines_per_sec` | ~4,270 | diff --git a/src/TriggerUnit.cpp b/src/TriggerUnit.cpp index d9ca319f8..305650601 100644 --- a/src/TriggerUnit.cpp +++ b/src/TriggerUnit.cpp @@ -33,6 +33,7 @@ #include <algorithm> #include <functional> #include <limits> +#include <vector> /* We need an explicit constructor in this file as the Host class is forward * declared in the header file and it is problematic to define any dereferencing @@ -436,7 +437,7 @@ void TriggerUnit::processDataStream(const QString& data, int line) // mid-iteration (the underlying std::list::remove frees the iterator's // current node → use-after-free on the next ++). AliasUnit dodges the // same hazard for the same reason — see Mudlet issue #4297. - auto copyOfNodeList = mTriggerRootNodeList; + std::vector<TTrigger*> copyOfNodeList(mTriggerRootNodeList.cbegin(), mTriggerRootNodeList.cend()); // Triggers registered by a script during this pass (tempTrigger() & Co.) // are missing from the snapshot but must still match the current line: // before the snapshot the loop walked the live std::list, which a push_back diff --git a/src/mudlet-lua/tests/UI_spec.lua b/src/mudlet-lua/tests/UI_spec.lua index 2fba3c281..0bd7a11aa 100644 --- a/src/mudlet-lua/tests/UI_spec.lua +++ b/src/mudlet-lua/tests/UI_spec.lua @@ -1872,6 +1872,173 @@ describe("Tests UI functions", function() -- absurd magnitudes are ids or timestamps, never vitals assert.are.same({}, BaseUI.parseVitalsLine("Health: 1234567890123/9999999999999")) end) + + -- The readable sample. The exhaustive version - every label spelling + -- crossed with every layout - is in StarterUiTriggerCostTest.cpp, which + -- installs the package itself and so always runs. + describe("the vitals trigger prefilter", function() + local readableLines = { + -- prompt shapes, labels after and before the numbers + "<523/600hp 210/250m 80/100mv>", + "HP: 523/600 MP: 210/250", + "523/600hp", + "100hp", + "hp100/120", + "<87%hp 80%m>", + "hp: 87%", + "<523hp 210m 80mv>", + "1200/1500 tnl", + "End: 40/60", + "Stamina 40/60", + -- score screens + "Health : 523/600", + "Mana : 210/250", + "Moves : 80/100", + "Experience: 1000/5000", + "Spell Points: 90/95", + "Hit Points: 12,345/23,456", + "Hitpoints: 90 of 90", + "PRACT: 005 Hitpoints: 90 of 90", + "Hit : [ 168/168 ]", + "| Level: 201 Hit Points: 500/500 Moves: 1000/1000 |", + "| Race: Undead Atavian | Health: 4252/4252 |", + "Health: 3600/3600 Mana: 3400/3400", + "Hp: 2331(2331) Gp: 433(459) Xp: 1143225 Burden: 21%", + "Hp: 143 (167) Gp: 240 (240) Xp: 267000", + "Level: 5 HitPoints: 100/ 100 Pager ( )", + "Race : Human Mana : 1000/ 1000 Autoexit (X)", + -- score sentences + "You have 100/120 hit points left.", + "You have 100(100) hit, 90(90) mana, and 100(100) movement points.", + "You have 123 experience points, 45 gold coins, 50 hit points(50).", + "You have 1110 (1110) hit points, 167 (167) guild points, 2 (684) quest points.", + } + + for _, line in ipairs(readableLines) do + it("lets through: " .. line, function() + assert.is_true(#BaseUI.parseVitalsLine(line) > 0, + "sample line no longer produces any reading - fix the sample, not the prefilter") + -- rex.find: rex.match returns false for an unset capture group + assert.is_not_nil(rex.find(line, BaseUI.vitalsPrefilter), + "prefilter drops a line the vitals shapes read: the gauges would never appear") + end) + end + + local ordinaryOutput = { + "You are standing in a dark forest. The trees tower above you.", + "A gentle breeze carries the scent of pine and distant woodsmoke.", + "You are carrying: a rusty sword, a silver ring, and 12 gold coins.", + "The Village Square", + "A glowing ember drifts past the Ancient Tower.", + "Gandalf tells you 'meet me at the tower'", + } + + for _, line in ipairs(ordinaryOutput) do + it("keeps out: " .. line, function() + -- extra parens: rex.find's second return value would land in + -- luassert's message slot + assert.is_nil((rex.find(line, BaseUI.vitalsPrefilter))) + end) + end + + it("is precompiled rather than recompiled per line", function() + assert.is_true(BaseUI.shapesArePrecompiled()) + end) + + -- restore whatever the assertions do: a raised vitalsLock left behind + -- makes createVitalsTriggers a silent no-op for every later test + local savedIds, savedLock + + local function borrowVitalsTriggerState(lock) + savedIds, savedLock = BaseUI.vitalsTriggerIds, BaseUI.vitalsLock + BaseUI.vitalsTriggerIds, BaseUI.vitalsLock = {}, lock + end + + local function returnVitalsTriggerState() + BaseUI.killVitalsTriggers() + BaseUI.vitalsTriggerIds, BaseUI.vitalsLock = savedIds, savedLock + end + + it("arms exactly one trigger, not one per shape", function() + if BaseUI.dormant() then + pending("the starter UI is dormant in this profile") + return + end + borrowVitalsTriggerState(0) + local ok, err = pcall(function() + BaseUI.createVitalsTriggers() + assert.are.equal(1, #BaseUI.vitalsTriggerIds) + end) + returnVitalsTriggerState() + assert.is_true(ok, tostring(err)) + end) + + it("stays retired while a protocol owns the gauges", function() + if BaseUI.dormant() then + pending("the starter UI is dormant in this profile") + return + end + borrowVitalsTriggerState(3) + local ok, err = pcall(function() + assert.is_true(BaseUI.structuredVitalsOwnGauges()) + BaseUI.createVitalsTriggers() + assert.are.same({}, BaseUI.vitalsTriggerIds) + end) + returnVitalsTriggerState() + assert.is_true(ok, tostring(err)) + end) + end) + + describe("the grouped chat triggers", function() + local chatLines = { + "Bob tells you, 'hello there'", + "You tell Bob, 'hi'", + "You tell the group 'incoming'", + "Bob whispers to you, 'psst'", + "Bob tells the group 'incoming'", + "Bob says, 'hello'", + "You say, 'hello'", + "Bob yells, 'help!'", + "You shout, 'hello'", + "[newbie] Ann: how do I get out of here?", + "(gossip) Ann: anyone around?", + "< chat | Ann: anyone around?", + "You are standing in a dark forest.", + "The orc hits you for 14 damage!", + "[combat] 100/120 hp", + "(12) something that is not a channel", + } + + -- chatLikeLine additionally requires the tag to be a known channel name, + -- so the trigger fires on these and routeTaggedChatLine turns them away + local taggedButNotAChannel = { + ["[combat] 100/120 hp"] = true, + ["(12) something that is not a channel"] = true, + } + + it("fires on the same lines the individual shapes did", function() + local grouped = BaseUI.chatTriggerPatterns() + assert.are.equal(3, #grouped) + for _, line in ipairs(chatLines) do + local anyGroupMatches = false + for _, pattern in ipairs(grouped) do + -- rex.find: rex.match returns false for an unset capture group + if rex.find(line, pattern.regex) then + anyGroupMatches = true + break + end + end + -- chatLikeLine walks the shapes individually, so it is the reference + if BaseUI.chatLikeLine(line) then + assert.is_true(anyGroupMatches, + "grouped triggers miss a line the individual shapes captured: " .. line) + elseif not taggedButNotAChannel[line] then + assert.is_false(anyGroupMatches, + "grouped triggers capture a line the individual shapes did not: " .. line) + end + end + end) + end) end) -- when a game installs its own interface (a Client.GUI package), the diff --git a/src/mudlet.cpp b/src/mudlet.cpp index 7a399b842..e430517aa 100644 --- a/src/mudlet.cpp +++ b/src/mudlet.cpp @@ -7497,6 +7497,10 @@ void mudlet::refreshTabBar() // doesn't make sense to make it static since it modifies a class variable void mudlet::setupPreInstallPackages(const QString& gameUrl, const QString& profileName) { + if (mSkipDefaultPackageInstall) { + return; + } + const QHash<QString, QStringList> defaultScripts = { // clang-format off // scripts to pre-install for a profile games this applies to, * means all games diff --git a/src/mudlet.h b/src/mudlet.h index 5464e7cd4..68458ed4b 100644 --- a/src/mudlet.h +++ b/src/mudlet.h @@ -369,6 +369,9 @@ public: QStringList mOnlyShownPredefinedProfiles; QPointer<dlgAboutDialog> mpAboutDlg; QStringList mPackagesToInstallList; + // Test-only: PipelineBenchmark sets this so its profile measures the + // pipeline rather than the shipped default packages. + bool mSkipDefaultPackageInstall = false; QPointer<dlgConnectionProfiles> mpConnectionDialog; QPointer<Host> mpCurrentActiveHost; // Options dialog when there's no active host diff --git a/src/packages/mudlet-base-ui/config.lua b/src/packages/mudlet-base-ui/config.lua index c920ad2a7..a472c6762 100644 --- a/src/packages/mudlet-base-ui/config.lua +++ b/src/packages/mudlet-base-ui/config.lua @@ -23,5 +23,5 @@ Commands: When a game installs an interface of its own, this one quietly stands aside - `baseui show` brings it back if you prefer it. ]] -version = [[1.0.0]] +version = [[1.1.0]] created = "2026-07-25T12:00:00+00:00" diff --git a/src/packages/mudlet-base-ui/mudlet-base-ui.mpackage b/src/packages/mudlet-base-ui/mudlet-base-ui.mpackage index 5fdcbfe60f86e7ea080d8fcf2b14547eb6b127d2..ac4fe806d2a2807a5858501985dfa7badd0e2001 100644 GIT binary patch delta 17813 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 delta 15981 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 bmt64yIRY#`lUqd@m$2~x5C(7Q0RR91{MF!) diff --git a/src/packages/mudlet-base-ui/mudlet-base-ui.xml b/src/packages/mudlet-base-ui/mudlet-base-ui.xml index e3103ad38..74401d37d 100644 --- a/src/packages/mudlet-base-ui/mudlet-base-ui.xml +++ b/src/packages/mudlet-base-ui/mudlet-base-ui.xml @@ -279,7 +279,14 @@ function BaseUI.routeChatLine(family) end function BaseUI.routeTaggedChatLine() - local tag = matches[2]:match("(%S+)") + -- one trigger, three branches: only the matching branch's group is set + local tag + for i = 2, #matches do + tag = type(matches[i]) == "string" and matches[i]:match("(%S+)") + if tag then + break + end + end if not tag then return end @@ -291,16 +298,47 @@ function BaseUI.routeTaggedChatLine() BaseUI.routeChatLine(family) end +-- a group is armed at the position of its FIRST shape, so reordering +-- chatPatterns across families changes which group wins a line both can match +local function chatGroupOf(pattern) + if pattern.tagged then + return "tagged" + end + return pattern.family or "plain" +end + +-- Folding shapes into one alternation is only cheap while every one of them is +-- ^-anchored: trigger regexes compile without PCRE2_MULTILINE, so PCRE tries +-- the union at offset 0 and gives up. An unanchored shape added here would be +-- retried at every offset in the line - give it its own trigger, or a prefilter +-- like the vitals shapes have. +function BaseUI.chatTriggerPatterns() + local order, grouped = {}, {} + for _, pattern in ipairs(chatPatterns) do + local group = chatGroupOf(pattern) + if not grouped[group] then + grouped[group] = {} + order[#order + 1] = group + end + table.insert(grouped[group], "(?:" .. pattern.regex .. ")") + end + local patterns = {} + for _, group in ipairs(order) do + table.insert(patterns, { group = group, regex = table.concat(grouped[group], "|") }) + end + return patterns +end + function BaseUI.createChatTriggers() if BaseUI.dormant() or BaseUI.gmcpChat or next(BaseUI.chatTriggerIds) then return end - for _, pattern in ipairs(chatPatterns) do + for _, pattern in ipairs(BaseUI.chatTriggerPatterns()) do local handler - if pattern.tagged then + if pattern.group == "tagged" then handler = BaseUI.routeTaggedChatLine else - local family = pattern.family + local family = pattern.group ~= "plain" and pattern.group or nil handler = function() BaseUI.routeChatLine(family) end end table.insert(BaseUI.chatTriggerIds, tempRegexTrigger(pattern.regex, handler)) @@ -337,6 +375,28 @@ end local numberFirstGuard = [=[(?<![\d:=])(?<![:=][ ]|[:=][ ]{2}|[:=][ ]{3}|[:=][ ]{4}|[:=][ ]{5}|[:=][ ]{6}|[:=][ ]{7}|[:=][ ]{8})]=] local labelFirstGuard = [=[(?<![\d%])(?<!\d[ ]|\d[ ]{2}|\d[ ]{3}|\d[ ]{4}|\d[ ]{5}|\d[ ]{6}|\d[ ]{7}|\d[ ]{8})]=] +-- Add label spellings here rather than inline in a shape below: anyVitalsLabel +-- is built from these tables, and a spelling that only exists inline is missing +-- from the prefilter, so the shape never sees a line to read. +local promptLabels = { + hp = [=[hp|health|hits?]=], + mp = [=[mp|mana|sp|magic|energy]=], + mv = [=[mv|moves?|movement|end(?:urance)?|st(?:amina)?]=], + xp = [=[xp|exp|tnl]=], +} +-- percentages and current-only prompts need the conservative spellings: a +-- looser one turns ordinary prose into a reading +local coreLabels = { + hp = [=[hp|health]=], + mp = [=[mp|mana|sp]=], +} +-- what a terse prompt abbreviates to once the number has been read: "523h" +local shortLabels = { + hp = [=[h(?:p|its?)?]=], + mp = [=[m(?:p|ana)?]=], + mv = [=[mv|moves?]=], +} + -- score screens across the codebase families (Diku/Merc/ROM, Circle/tbaMUD, -- SMAUG, LPMud, IRE, Aardwolf...) share a handful of label spellings per -- stat; the sets below feed every score-screen shape. Unlike prompts, score @@ -400,49 +460,68 @@ local function scoreSentence(stat, pair) return youHave .. [=[.*?\b]=] .. pair .. [=[\s*]=] .. sentenceLabels[stat] .. sentenceTail end +-- The single trigger fronting every shape below. Its one contract: it must +-- match every line a shape reads a value from, or that game's gauges silently +-- never appear. Being loose the other way only costs a Lua shape walk, so keep +-- it loose - "the orc hits you for 12 damage" gets through and that is fine. +-- +-- (?<![a-z]) / (?![a-z]) rather than \b: a label may abut its number +-- ("hp100/120"), which is not a word boundary. The optional "points" tail is +-- for score sentences that run the two together ("100/120 manapoints"). +local anyVitalsLabel = table.concat({ + promptLabels.hp, promptLabels.mp, promptLabels.mv, promptLabels.xp, + coreLabels.hp, coreLabels.mp, + shortLabels.hp, shortLabels.mp, shortLabels.mv, + scoreLabels.hp, scoreLabels.mp, scoreLabels.mv, scoreLabels.xp, + sentenceLabels.hp, sentenceLabels.mp, sentenceLabels.mv, + -- two prompt shapes spell a lone "m" for mana inline + [=[m]=], +}, "|") +BaseUI.vitalsPrefilter = [=[(?i)(?<![a-z])(?:]=] .. anyVitalsLabel .. [=[)(?:\s*points?)?(?![a-z])]=] + local vitalsLinePatterns = { -- self-sufficient prompt shapes: cur/max with the label after the numbers { stat = "hp", kind = "curmax", gated = true, - regex = [=[(?i)]=] .. numberFirstGuard .. [=[(\d+)\s*/\s*(\d+)\s*(?:hp|health|hits?)\b]=] }, + regex = [=[(?i)]=] .. numberFirstGuard .. [=[(\d+)\s*/\s*(\d+)\s*(?:]=] .. promptLabels.hp .. [=[)\b]=] }, { stat = "mp", kind = "curmax", gated = true, - regex = [=[(?i)]=] .. numberFirstGuard .. [=[(\d+)\s*/\s*(\d+)\s*(?:mp|mana|sp|magic|energy|m)\b]=] }, + regex = [=[(?i)]=] .. numberFirstGuard .. [=[(\d+)\s*/\s*(\d+)\s*(?:]=] .. promptLabels.mp .. [=[|m)\b]=] }, { stat = "mv", kind = "curmax", gated = true, - regex = [=[(?i)]=] .. numberFirstGuard .. [=[(\d+)\s*/\s*(\d+)\s*(?:mv|moves?|movement|end(?:urance)?|st(?:amina)?)\b]=] }, + regex = [=[(?i)]=] .. numberFirstGuard .. [=[(\d+)\s*/\s*(\d+)\s*(?:]=] .. promptLabels.mv .. [=[)\b]=] }, { stat = "xp", kind = "curmax", gated = true, - regex = [=[(?i)]=] .. numberFirstGuard .. [=[(\d+)\s*/\s*(\d+)\s*(?:xp|exp|tnl)\b]=] }, + regex = [=[(?i)]=] .. numberFirstGuard .. [=[(\d+)\s*/\s*(\d+)\s*(?:]=] .. promptLabels.xp .. [=[)\b]=] }, -- self-sufficient prompt shapes: cur/max with the label first. The -- explicit-separator form is trusted anywhere; the separator-less form -- needs the digit lookbehinds so "523/600 hp ..." cannot have its own -- trailing label re-read as the start of a new reading { stat = "hp", kind = "curmax", gated = true, - regex = [=[(?i)(?<!%)\b(?:hp|health|hits?)[:=]\s*(\d+)\s*/\s*(\d+)]=] }, + regex = [=[(?i)(?<!%)\b(?:]=] .. promptLabels.hp .. [=[)[:=]\s*(\d+)\s*/\s*(\d+)]=] }, { stat = "hp", kind = "curmax", gated = true, - regex = [=[(?i)]=] .. labelFirstGuard .. [=[\b(?:hp|health|hits?)\s*(\d+)\s*/\s*(\d+)]=] }, + regex = [=[(?i)]=] .. labelFirstGuard .. [=[\b(?:]=] .. promptLabels.hp .. [=[)\s*(\d+)\s*/\s*(\d+)]=] }, { stat = "mp", kind = "curmax", gated = true, - regex = [=[(?i)(?<!%)\b(?:mp|mana|sp|magic|energy)[:=]\s*(\d+)\s*/\s*(\d+)]=] }, + regex = [=[(?i)(?<!%)\b(?:]=] .. promptLabels.mp .. [=[)[:=]\s*(\d+)\s*/\s*(\d+)]=] }, { stat = "mp", kind = "curmax", gated = true, - regex = [=[(?i)]=] .. labelFirstGuard .. [=[\b(?:mp|mana|sp|magic|energy)\s*(\d+)\s*/\s*(\d+)]=] }, + regex = [=[(?i)]=] .. labelFirstGuard .. [=[\b(?:]=] .. promptLabels.mp .. [=[)\s*(\d+)\s*/\s*(\d+)]=] }, { stat = "mv", kind = "curmax", gated = true, - regex = [=[(?i)(?<!%)\b(?:mv|moves?|movement|end(?:urance)?|st(?:amina)?)[:=]\s*(\d+)\s*/\s*(\d+)]=] }, + regex = [=[(?i)(?<!%)\b(?:]=] .. promptLabels.mv .. [=[)[:=]\s*(\d+)\s*/\s*(\d+)]=] }, { stat = "mv", kind = "curmax", gated = true, - regex = [=[(?i)]=] .. labelFirstGuard .. [=[\b(?:mv|moves?|movement|end(?:urance)?|st(?:amina)?)\s*(\d+)\s*/\s*(\d+)]=] }, + regex = [=[(?i)]=] .. labelFirstGuard .. [=[\b(?:]=] .. promptLabels.mv .. [=[)\s*(\d+)\s*/\s*(\d+)]=] }, { stat = "xp", kind = "curmax", gated = true, - regex = [=[(?i)(?<!%)\b(?:xp|exp|tnl)[:=]\s*(\d+)\s*/\s*(\d+)]=] }, + regex = [=[(?i)(?<!%)\b(?:]=] .. promptLabels.xp .. [=[)[:=]\s*(\d+)\s*/\s*(\d+)]=] }, { stat = "xp", kind = "curmax", gated = true, - regex = [=[(?i)]=] .. labelFirstGuard .. [=[\b(?:xp|exp|tnl)\s*(\d+)\s*/\s*(\d+)]=] }, + regex = [=[(?i)]=] .. labelFirstGuard .. [=[\b(?:]=] .. promptLabels.xp .. [=[)\s*(\d+)\s*/\s*(\d+)]=] }, -- labelled percentages need no maximum at all { stat = "hp", kind = "percent", gated = true, - regex = [=[(?i)]=] .. numberFirstGuard .. [=[(\d+)%\s*(?:hp|health)\b]=] }, + regex = [=[(?i)]=] .. numberFirstGuard .. [=[(\d+)%\s*(?:]=] .. coreLabels.hp .. [=[)\b]=] }, { stat = "hp", kind = "percent", gated = true, - regex = [=[(?i)(?<!%)\b(?:hp|health)[:=]\s*(\d+)%]=] }, + regex = [=[(?i)(?<!%)\b(?:]=] .. coreLabels.hp .. [=[)[:=]\s*(\d+)%]=] }, { stat = "hp", kind = "percent", gated = true, - regex = [=[(?i)]=] .. labelFirstGuard .. [=[\b(?:hp|health)\s*(\d+)%]=] }, + regex = [=[(?i)]=] .. labelFirstGuard .. [=[\b(?:]=] .. coreLabels.hp .. [=[)\s*(\d+)%]=] }, { stat = "mp", kind = "percent", gated = true, - regex = [=[(?i)]=] .. numberFirstGuard .. [=[(\d+)%\s*(?:mp|mana|sp|m)\b]=] }, + regex = [=[(?i)]=] .. numberFirstGuard .. [=[(\d+)%\s*(?:]=] .. coreLabels.mp .. [=[|m)\b]=] }, { stat = "mp", kind = "percent", gated = true, - regex = [=[(?i)(?<!%)\b(?:mp|mana|sp)[:=]\s*(\d+)%]=] }, + regex = [=[(?i)(?<!%)\b(?:]=] .. coreLabels.mp .. [=[)[:=]\s*(\d+)%]=] }, { stat = "mp", kind = "percent", gated = true, - regex = [=[(?i)]=] .. labelFirstGuard .. [=[\b(?:mp|mana|sp)\s*(\d+)%]=] }, + regex = [=[(?i)]=] .. labelFirstGuard .. [=[\b(?:]=] .. coreLabels.mp .. [=[)\s*(\d+)%]=] }, -- score-screen shapes, all trusted on first sight. A single labelled row, -- with or without a separator, possibly behind table borders: -- "Health : 523/600", "| Hit Points 3,600/3,600 |" @@ -507,22 +586,58 @@ local vitalsLinePatterns = { -- current-only prompt shapes; the lookarounds keep them off cur/max and -- percentage lines, which belong to the shapes above { stat = "hp", kind = "bare", gated = true, - regex = [=[(?i)(?<![\d/.,:%])(\d+)\s*h(?:p|its?)?\b(?!\s*[/%])]=] }, + regex = [=[(?i)(?<![\d/.,:%])(\d+)\s*]=] .. shortLabels.hp .. [=[\b(?!\s*[/%])]=] }, { stat = "hp", kind = "bare", gated = true, - regex = [=[(?i)\b(?:hp|health|hits?)[:=]\s*(\d+)\b(?!\s*[/%.])]=] }, + regex = [=[(?i)\b(?:]=] .. promptLabels.hp .. [=[)[:=]\s*(\d+)\b(?!\s*[/%.])]=] }, { stat = "mp", kind = "bare", gated = true, - regex = [=[(?i)(?<![\d/.,:%])(\d+)\s*m(?:p|ana)?\b(?!\s*[/%])]=] }, + regex = [=[(?i)(?<![\d/.,:%])(\d+)\s*]=] .. shortLabels.mp .. [=[\b(?!\s*[/%])]=] }, { stat = "mp", kind = "bare", gated = true, - regex = [=[(?i)\b(?:mp|mana|sp)[:=]\s*(\d+)\b(?!\s*[/%.])]=] }, + regex = [=[(?i)\b(?:]=] .. coreLabels.mp .. [=[)[:=]\s*(\d+)\b(?!\s*[/%.])]=] }, { stat = "mv", kind = "bare", gated = true, - regex = [=[(?i)(?<![\d/.,:%])(\d+)\s*(?:mv|moves?)\b(?!\s*[/%])]=] }, + regex = [=[(?i)(?<![\d/.,:%])(\d+)\s*(?:]=] .. shortLabels.mv .. [=[)\b(?!\s*[/%])]=] }, } +-- rex.match given a pattern STRING compiles it afresh on every call, and a line +-- reaching this layer is tested against up to 77 shapes. Never pass .regex to +-- rex.match directly. +local compiledPattern = setmetatable({}, { + __index = function(cache, regex) + local ok, compiled = pcall(rex.new, regex) + if not ok then + -- keep the string so rex.match still raises on it rather than the shape + -- vanishing; the error is only precise here, not once per line + debugc("[ Mudlet UI ] a vitals/chat shape would not compile, falling back to per-line compilation: " + .. tostring(compiled) .. " in: " .. regex) + end + local value = ok and compiled or regex + rawset(cache, regex, value) + return value + end, +}) + +-- for the test suite: how many shapes parseVitalsLine walks +function BaseUI.vitalsShapeCount() + return #vitalsLinePatterns +end + +-- for the test suite: the fallback above still works, so only an explicit check +-- notices a shape that fell back to per-line compilation +function BaseUI.shapesArePrecompiled() + for _, list in ipairs({ chatPatterns, vitalsLinePatterns }) do + for _, pattern in ipairs(list) do + if type(compiledPattern[pattern.regex]) ~= "userdata" then + return false + end + end + end + return true +end + -- lines the chat layer would route are never harvested for vitals - a tell -- saying "I am on 100/120 hp" is conversation, not a prompt function BaseUI.chatLikeLine(text) for _, pattern in ipairs(chatPatterns) do - local capture = rex.match(text, pattern.regex) + local capture = rex.match(text, compiledPattern[pattern.regex]) if capture then if not pattern.tagged then return true @@ -564,7 +679,7 @@ function BaseUI.parseVitalsLine(text) return readings end for index, pattern in ipairs(vitalsLinePatterns) do - local first, second = rex.match(text, pattern.regex) + local first, second = rex.match(text, compiledPattern[pattern.regex]) local reading if pattern.kind == "curmax" and first then local current, max = parseVitalsNumber(first), parseVitalsNumber(second) @@ -597,8 +712,9 @@ function BaseUI.scoreWindowOpen() return BaseUI.scoreWindowUntil ~= nil and getEpoch() < BaseUI.scoreWindowUntil end --- one handler for every vitals pattern: the first trigger to fire on a line --- processes all shapes on it in one pass, later ones see the marker and stop +-- lastChatLine keeps a line the chat layer routed out of the vitals layer; the +-- refresh after applyVitals is because building the dock rewraps the buffer and +-- renumbers lines, which would otherwise leave the marker on an unrelated line function BaseUI.onVitalsLine() local lineNumber = getLineNumber() if lineNumber == BaseUI.lastVitalsLine or lineNumber == BaseUI.lastChatLine then @@ -635,13 +751,17 @@ function BaseUI.onVitalsLine() end end +-- applyVitals discards prompt readings once a protocol holds the lock, so the +-- plain-text layer is pure per-line cost from then on +function BaseUI.structuredVitalsOwnGauges() + return BaseUI.vitalsLock >= sourceRanks.msdp +end + function BaseUI.createVitalsTriggers() - if BaseUI.dormant() or next(BaseUI.vitalsTriggerIds) then + if BaseUI.dormant() or BaseUI.structuredVitalsOwnGauges() or next(BaseUI.vitalsTriggerIds) then return end - for _, pattern in ipairs(vitalsLinePatterns) do - table.insert(BaseUI.vitalsTriggerIds, tempRegexTrigger(pattern.regex, BaseUI.onVitalsLine)) - end + BaseUI.vitalsTriggerIds = { tempRegexTrigger(BaseUI.vitalsPrefilter, BaseUI.onVitalsLine) } end function BaseUI.killVitalsTriggers() @@ -968,6 +1088,10 @@ function BaseUI.applyVitals(source, readings, snapshot) -- the lock and everything the previous source reported is dropped BaseUI.vitalsData = {} BaseUI.vitalsLock = rank + -- handleDisconnect re-arms these: the next connection may have no protocol + if BaseUI.structuredVitalsOwnGauges() then + BaseUI.killVitalsTriggers() + end end for _, stat in ipairs(vitalsStats) do local reading = readings[stat.key] @@ -1124,6 +1248,8 @@ function BaseUI.handleDisconnect() -- ring already covers the echo race that comes with that) BaseUI.gmcpChat = false BaseUI.createChatTriggers() + -- only re-arms because the lock was cleared above + BaseUI.createVitalsTriggers() end function BaseUI.addChatMessage() diff --git a/test/compare-perf-baseline.py b/test/compare-perf-baseline.py index e6d948000..6541a0d8c 100755 --- a/test/compare-perf-baseline.py +++ b/test/compare-perf-baseline.py @@ -33,12 +33,15 @@ import sys # ASan build to a release build, whose absolute numbers are incomparable. INVARIANTS = ("text_corpus_lines", "text_corpus_bytes", "trigger_count", "build_asan") -# Gated by default: throughput (lines/sec) for the text and trigger pipelines. +# Gated by default: throughput (lines/sec) for the text and trigger pipelines, +# plus the shipped default packages on the same corpus - the pipeline metrics run +# on a bare profile, so only defaults_text_lines_per_sec can see a package +# costing every new user throughput. # trigger_overhead_ms is intentionally NOT here - it is a difference of two noisy # best-passes (up to ~16% run-to-run worst case, wider than the 10% gate), so it # would fire on noise. It stays emitted and reportable, and can be gated # explicitly with --gate trigger_overhead_ms when a change targets matching. -DEFAULT_GATE = ("text_lines_per_sec", "trigger_lines_per_sec") +DEFAULT_GATE = ("text_lines_per_sec", "trigger_lines_per_sec", "defaults_text_lines_per_sec") # Wall-clock ceiling for a single benchmark run under --run. The ASan/offscreen # functional-test build feeds a huge corpus several times, so this is generous. diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index 7a71666c7..1ebc8d9ee 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -54,6 +54,7 @@ set(FUNCTIONAL_TEST_SOURCES EdbeeReinitTest.cpp TMediaLoopTest.cpp DefaultPackagesTest.cpp + StarterUiTriggerCostTest.cpp ProfileSwitchShortcutTest.cpp ExperiencedPlayerGateTest.cpp WindowBackgroundTest.cpp diff --git a/test/functional_tests/PipelineBenchmark.cpp b/test/functional_tests/PipelineBenchmark.cpp index 7612a1c1d..4d14715ad 100644 --- a/test/functional_tests/PipelineBenchmark.cpp +++ b/test/functional_tests/PipelineBenchmark.cpp @@ -28,6 +28,9 @@ * corpus through the production cTelnet::loopbackTest() path and prints one * `METRIC <name> <value>` line per measurement. * + * `text_*`, `trigger_*` and `peak_rss_kb` come from a profile with the default + * packages suppressed; `defaults_*` from one carrying them. + * * Built with the functional tests but deliberately NOT registered with ctest by * default (report-only and slow); run it directly, or configure with * -DREGISTER_PERF_BENCHMARK=ON to also get it under ctest: @@ -364,6 +367,7 @@ private slots: { Host* host = startProfile(); QVERIFY(host); + QVERIFY(noTriggersAreRunningYet(host)); const double seconds = feedCorpusBestPass(host, kFeedPasses); mTextBestPassSeconds = seconds; @@ -383,11 +387,17 @@ private slots: { Host* host = startProfile(); QVERIFY(host); + QVERIFY(noTriggersAreRunningYet(host)); bool triggersOk = true; const int triggerCount = installTriggerSet(host, triggersOk); QVERIFY2(triggerCount > 0, "no triggers were installed"); QVERIFY2(triggersOk, "a trigger failed to compile, register or take its script"); + // trigger_overhead_ms subtracts the text pass, so the count reported has + // to be the count actually running. + const int rootTriggers = static_cast<int>(host->getTriggerUnit()->getTriggerRootNodeList().size()); + QVERIFY2(rootTriggers == triggerCount, + qPrintable(qsl("installed %1 root triggers but %2 are running - something else registered triggers on this profile").arg(triggerCount).arg(rootTriggers))); const double seconds = feedCorpusBestPass(host, kFeedPasses); const int bufferedLines = host->mpConsole->buffer.getLastLineNumber(); @@ -424,6 +434,7 @@ private slots: { Host* host = startProfile(); QVERIFY(host); + QVERIFY(noTriggersAreRunningYet(host)); // Feed one pass so the peak still reflects pipeline work when this slot // runs on its own. feedCorpusBestPass(host, 1); @@ -436,10 +447,59 @@ private slots: } } -private: - // Mirrors the profile-creation helper the other functional tests use. - Host* startProfile() + // Must run after benchPeakMemory: VmHWM is process-wide and monotonic, so + // the bare peak_rss_kb has to be read before any packaged profile exists. + // defaults_peak_rss_kb is then the high-water mark including this pass, and + // its excess over peak_rss_kb is what the packages cost. + void benchDefaultPackages() { + Host* host = startProfile(DefaultPackages::Install); + QVERIFY(host); + const int rootTriggers = static_cast<int>(host->getTriggerUnit()->getTriggerRootNodeList().size()); + // Needs a fresh HOME/XDG_CONFIG_HOME: the starter UI is gated on + // mudlet::experiencedMudletPlayer(), which answers from the machine's + // own Mudlet history, and without it this slot silently measures the + // same thing as benchTextPipeline. A trigger count would not catch that + // - the other default packages register root folders of their own. + QVERIFY2(host->mInstalledPackages.contains(qsl("mudlet-base-ui")), + "the starter UI is not installed, so this profile is not the one a new user gets and defaults_* " + "would describe something else entirely. Re-run under a fresh HOME and XDG_CONFIG_HOME."); + + const double seconds = feedCorpusBestPass(host, kFeedPasses); + const int bufferedLines = host->mpConsole->buffer.getLastLineNumber(); + QVERIFY2(bufferedLines > 1000, qPrintable(qsl("console buffer only holds %1 lines - the pipeline did not process the corpus").arg(bufferedLines))); + + emitMetric("defaults_root_triggers", static_cast<qint64>(rootTriggers)); + emitMetric("defaults_text_lines_per_sec", mCorpusLines / seconds); + emitMetric("defaults_text_best_pass_ms", seconds * 1000.0); + const qint64 peakRssKb = readPeakRssKb(); + if (peakRssKb >= 0) { + emitMetric("defaults_peak_rss_kb", peakRssKb); + } + } + +private: + enum class DefaultPackages { Skip, Install }; + + // Called before the benchmark installs any of its own, so anything running + // came from elsewhere and would be timed as pipeline cost. + bool noTriggersAreRunningYet(Host* host) + { + const size_t rootTriggers = host->getTriggerUnit()->getTriggerRootNodeList().size(); + if (rootTriggers == 0) { + return true; + } + qWarning("%s", + qPrintable(qsl("%1 root triggers are running on a profile that should have none - a package or a " + "leftover profile is being measured as pipeline cost") + .arg(rootTriggers))); + return false; + } + + // Mirrors the profile-creation helper the other functional tests use. + Host* startProfile(DefaultPackages defaultPackages = DefaultPackages::Skip) + { + mudlet::self()->mSkipDefaultPackageInstall = (defaultPackages == DefaultPackages::Skip); const QString port = QString::number(mPort); QTimer::singleShot(0, qApp, [this, port]() { mudlet::self()->startAutoLogin({}); diff --git a/test/functional_tests/StarterUiTriggerCostTest.cpp b/test/functional_tests/StarterUiTriggerCostTest.cpp new file mode 100644 index 000000000..cdf343de2 --- /dev/null +++ b/test/functional_tests/StarterUiTriggerCostTest.cpp @@ -0,0 +1,406 @@ +/*************************************************************************** + * Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +// The starter UI (mudlet-base-ui) is preinstalled into new profiles, so every +// always-active trigger it arms is matched against every line the game sends. +// This pins what that costs and that the capture layers still capture. + +#include <QtTest/QtTest> + +#include "Host.h" +#include "MudletInstanceCoordinator.h" +#include "TLuaInterpreter.h" +#include "TelnetServerStub.h" +#include "TriggerUnit.h" +#include "ctelnet.h" +#include "dlgConnectionProfiles.h" +#include "mudlet.h" + +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); +static void initializeQRCResources(); + +class StarterUiTriggerCostTest : public QObject +{ + Q_OBJECT + +private: + TelnetServerStub* mpServer = nullptr; + const QString mHostname = qsl("Test-StarterUiTriggerCost"); + const QString mLocalhost = qsl("localhost"); + quint16 mPort = 0; + + // A full default-package profile measures 5: the starter UI's three chat + // groups and one vitals prefilter, plus one folder from another package. + // Raising this is a throughput change and wants measuring first. + static constexpr int kMaxRootTriggers = 8; + +private slots: + void initTestCase() { initializeQRCResources(); } + + void init() + { + mpServer = new TelnetServerStub(qApp); + // Ephemeral port so parallel worktree runs never collide. + mpServer->start(mLocalhost, 0); + mPort = mpServer->serverPort(); + mudlet::start(); + mudlet::self()->setupConfig(); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique<MudletInstanceCoordinator>("MudletInstanceCoordinator")); + mudlet::self()->init(); + mudlet::self()->setStorePasswordsSecurely(false); + deleteProfileDirectory(mHostname); + } + + void cleanup() + { + delete mpServer; + mpServer = nullptr; + deleteProfileDirectory(mHostname); + delete mudlet::self(); + } + + void test_captureLayersArmAHandfulOfTriggersNotOnePerShape() + { + Host* host = startProfileWithStarterUi(); + QVERIFY(host); + + const int rootTriggers = static_cast<int>(host->getTriggerUnit()->getTriggerRootNodeList().size()); + QVERIFY2(rootTriggers > 0, "no triggers are registered at all - the profile did not finish loading its packages"); + QVERIFY2(rootTriggers <= kMaxRootTriggers, + qPrintable(qsl("a new user's profile arms %1 always-active root triggers, and every line of game " + "text is matched against all of them") + .arg(rootTriggers))); + + QVERIFY(luaTrue(host, qsl("#BaseUI.vitalsTriggerIds == 1"))); + QVERIFY(luaTrue(host, qsl("#BaseUI.chatTriggerIds == 3"))); + } + + // Miss a line here and that game's gauges silently never appear. + // + // The label list in the script is hand-written, not derived from the + // package's label tables, so this catches a new shape whose spelling is + // missing from the prefilter but not a new spelling bolted onto an existing + // shape - add spellings to promptLabels and friends, not inline. + void test_thePrefilterMatchesEveryLineTheShapesRead() + { + Host* host = startProfileWithStarterUi(); + QVERIFY(host); + + QVERIFY2(runLua(host, prefilterDifferentialScript()), "the prefilter differential did not run - see the profile's error console"); + QVERIFY2(luaTrue(host, qsl("__starterUi.misses == 0")), "the vitals prefilter drops lines the shapes read - the first few are in the error console"); + // Without this the assertion above holds vacuously. + QVERIFY2(luaTrue(host, qsl("__starterUi.readable > 1500")), "the generated corpus stopped producing readings, so the prefilter check proved nothing"); + QVERIFY2(luaTrue(host, qsl("__starterUi.shapesFired == __starterUi.shapeCount")), + "the generated corpus no longer exercises every vitals shape - a new shape needs a layout or label " + "adding to the lists in prefilterDifferentialScript()"); + } + + // The fallback to a pattern string still works, so nothing else fails when + // a shape is recompiled per line. + void test_theShapesArePrecompiled() + { + Host* host = startProfileWithStarterUi(); + QVERIFY(host); + QVERIFY2(luaTrue(host, qsl("BaseUI.shapesArePrecompiled()")), "a chat or vitals shape is not a compiled regex object, so it is recompiled on every line"); + } + + // A label-after-the-numbers prompt is read only by recurrence-gated shapes, + // so this pins the gate as well: nothing until the third sighting. + void test_aPlainTextPromptStillDrivesTheGauges() + { + Host* host = startProfileWithStarterUi(); + QVERIFY(host); + + feedLine(host, qsl("<523/600hp 210/250m 80/100mv>")); + QVERIFY2(luaTrue(host, qsl("BaseUI.vitalsData.hp == nil")), "a gated prompt shape drove the gauges on first sight"); + feedLine(host, qsl("<522/600hp 209/250m 79/100mv>")); + QVERIFY(luaTrue(host, qsl("BaseUI.vitalsData.hp == nil"))); + + feedLine(host, qsl("<521/600hp 208/250m 78/100mv>")); + QVERIFY2(luaTrue(host, qsl("BaseUI.vitalsData.hp ~= nil and BaseUI.vitalsData.hp.max == 600")), + "a recurring cur/max prompt no longer reaches the gauges - the prefilter is dropping lines the " + "vitals shapes read"); + QVERIFY(luaTrue(host, qsl("BaseUI.vitalsData.hp.current == 521"))); + QVERIFY(luaTrue(host, qsl("BaseUI.vitalsData.mv ~= nil and BaseUI.vitalsData.mv.max == 100"))); + } + + void test_aPercentagePromptStillDrivesTheGauges() + { + Host* host = startProfileWithStarterUi(); + QVERIFY(host); + + for (int i = 0; i < 3; ++i) { + feedLine(host, qsl("<87%hp 80%m>")); + } + QVERIFY2(luaTrue(host, qsl("BaseUI.vitalsData.hp ~= nil and BaseUI.vitalsData.hp.percent == 87")), "a recurring percentage prompt no longer reaches the gauges"); + QVERIFY(luaTrue(host, qsl("BaseUI.vitalsData.mp.percent == 80"))); + } + + // A current-only prompt cannot supply a maximum, so the layer sends "score" + // once - the one capture path with a visible side effect on the game. + void test_aCurrentOnlyPromptStillAsksTheGameForItsScoreScreen() + { + Host* host = startProfileWithStarterUi(); + QVERIFY(host); + QVERIFY(luaTrue(host, qsl("not BaseUI.scoreRequested"))); + + for (int i = 0; i < 3; ++i) { + feedLine(host, qsl("<523hp 210m 80mv>")); + } + QVERIFY2(luaTrue(host, qsl("BaseUI.scoreRequested")), + "a current-only prompt no longer reaches BaseUI.maybeRequestScore, so games whose prompt carries no " + "maximum never get gauges"); + } + + // Score-screen rows are trusted on first sight: a score may only be shown once. + void test_aScoreScreenIsStillReadOnFirstSight() + { + Host* host = startProfileWithStarterUi(); + QVERIFY(host); + + feedLine(host, qsl("Health: 3600/3600 Mana: 3400/3400")); + QVERIFY2(luaTrue(host, qsl("BaseUI.vitalsData.hp ~= nil and BaseUI.vitalsData.hp.max == 3600")), "a score-screen row was not read on first sight"); + QVERIFY(luaTrue(host, qsl("BaseUI.vitalsData.mp ~= nil and BaseUI.vitalsData.mp.max == 3400"))); + + // Chat is conversation, not a prompt: a tell quoting numbers must not + // move the gauges, which is the chat shapes being consulted from the + // vitals path. + feedLine(host, qsl("Bob tells you, 'I am somehow alive at 11/12 hp'")); + QVERIFY2(luaTrue(host, qsl("BaseUI.vitalsData.hp.max == 3600")), "a tell was harvested for vitals"); + } + + // Each chat group has to keep routing into the tab its shapes always did. + void test_chatCaptureStillSortsLinesIntoTheirTabs() + { + Host* host = startProfileWithStarterUi(); + QVERIFY(host); + + feedLine(host, qsl("Bob tells you, 'hello there'")); + QVERIFY2(luaTrue(host, qsl("BaseUI.chats ~= nil and BaseUI.unread ~= nil")), "a tell did not build the chat dock"); + // routeChatLine() counts the active tab as read, so the tell lands in + // Tells' unread counter while All (the active tab) does not move. + QVERIFY2(luaTrue(host, qsl("BaseUI.unread.tells == 1")), "a tell was not routed into the Tells tab"); + + // All three tagged branches: each writes its tag into a different + // capture group, and only the matching branch's is set. + feedLine(host, qsl("[newbie] Ann: how do I get out of here?")); + QVERIFY2(luaTrue(host, qsl("BaseUI.unread.channels == 1")), + "a [tag] channel line was not routed into the Channels tab - the grouped tagged trigger is not " + "finding its capture group"); + feedLine(host, qsl("(gossip) Ann: anyone around?")); + QVERIFY2(luaTrue(host, qsl("BaseUI.unread.channels == 2")), "a (tag) channel line was not routed"); + feedLine(host, qsl("< chat | Ann: anyone around?")); + QVERIFY2(luaTrue(host, qsl("BaseUI.unread.channels == 3")), "a < tag | channel line was not routed"); + + // BaseUI.chatChannelNames still has the last word on a captured tag. + feedLine(host, qsl("[inventory] a rusty sword")); + QVERIFY2(luaTrue(host, qsl("BaseUI.unread.channels == 3")), "an unknown tag was routed as a channel"); + } + + void test_theVitalsLayerRetiresOnceAProtocolOwnsTheGauges() + { + Host* host = startProfileWithStarterUi(); + QVERIFY(host); + QVERIFY(luaTrue(host, qsl("#BaseUI.vitalsTriggerIds == 1"))); + + QVERIFY(runLua(host, + qsl("gmcp = gmcp or {}\n" + "gmcp.Char = { Vitals = { hp = 500, maxhp = 600 } }\n" + "BaseUI.updateVitals()"))); + QVERIFY2(luaTrue(host, qsl("BaseUI.structuredVitalsOwnGauges()")), "GMCP vitals did not take the source lock"); + QVERIFY2(luaTrue(host, qsl("#BaseUI.vitalsTriggerIds == 0")), "the plain-text vitals triggers stayed armed after GMCP took the gauges over"); + + // The next connection may have no protocol at all. + QVERIFY(runLua(host, qsl("BaseUI.handleDisconnect()"))); + QVERIFY2(luaTrue(host, qsl("#BaseUI.vitalsTriggerIds == 1")), "the vitals layer did not re-arm after a disconnect"); + } + +private: + // Runs inside the profile's Lua state, against the real + // BaseUI.parseVitalsLine and BaseUI.vitalsPrefilter. + static QString prefilterDifferentialScript() + { + return qsl(R"LUA( +local labels = { + "hp", "health", "hit", "hits", "hitpoint", "hitpoints", "hit point", "hit points", "h", + "mp", "mana", "sp", "magic", "energy", "blood", "spell point", "spell points", "spellpoints", "m", + "mv", "move", "moves", "movement", "movements", "move point", "move points", "movement points", + "stamina", "st", "endurance", "end", "vitality", + "xp", "exp", "experience", "experience point", "experience points", "exp points", "tnl", +} +local templates = { + "@: 100/120", "@ 100/120", "@100/120", "100/120 @", "100/120@", "100 / 120 @", + "@: 87%", "87% @", "@ 87%", "87%@", "@87%", + "@: 100", "100 @", "100@", + "| @: 100/120 |", "| @ : 100/120 |", "@ : 100 of 120", "@: 100(120)", "@ 100 ( 120 )", + "You have 100/120 @.", "You have 100(120) @.", "You have 100/120 @points.", + "You have 100/120 @ and 50/60 mana.", "You have 100/120 @ left.", + "Level: 5 @: 100/120 Pager ( )", "@ : [ 100/120 ]", "@: 12,345/23,456", + "PRACT: 005 @: 90 of 90", " @: 3600/3600 Mana: 3400/3400", + "#### @ 100/120 ####", "50 @(50).", + "| @: 100(120) |", "| @ : 100 of 120 |", "| Race: Undead | @: 4252/4252 |", +} + +__starterUi = { misses = 0, readable = 0, shapeSeen = {} } +local reported = 0 + +for _, label in ipairs(labels) do + for _, template in ipairs(templates) do + for _, spelling in ipairs({ label, label:sub(1, 1):upper() .. label:sub(2), label:upper() }) do + local line = template:gsub("@", spelling) + local readings = BaseUI.parseVitalsLine(line) + if #readings > 0 then + __starterUi.readable = __starterUi.readable + 1 + for _, reading in ipairs(readings) do + __starterUi.shapeSeen[reading.pattern] = true + end + -- rex.find: rex.match returns false for an unset capture group + if not rex.find(line, BaseUI.vitalsPrefilter) then + __starterUi.misses = __starterUi.misses + 1 + if reported < 5 then + reported = reported + 1 + echo("\n[ prefilter MISS ] " .. line .. "\n") + end + end + end + end + end +end + +__starterUi.shapesFired = 0 +for _ in pairs(__starterUi.shapeSeen) do + __starterUi.shapesFired = __starterUi.shapesFired + 1 +end +__starterUi.shapeCount = BaseUI.vitalsShapeCount() +)LUA"); + } + + Host* startProfileWithStarterUi() + { + startProfile(); + Host* host = mudlet::self()->getActiveHost(); + if (!host) { + return nullptr; + } + host->mEchoLuaErrors = true; + // Installed by hand only when the preinstall gate did not, so this test + // says nothing about who counts as a new user. + if (!host->mInstalledPackages.contains(qsl("mudlet-base-ui"))) { + auto [installed, message] = host->installPackage(qsl(":/packages/mudlet-base-ui/mudlet-base-ui.mpackage"), enums::PackageModuleType::Package, true); + if (!installed) { + qWarning("%s", qPrintable(qsl("could not install the starter UI: %1").arg(message))); + return nullptr; + } + } + // A hidden or stood-aside setting would suppress every capture trigger. + if (!luaTrue(host, qsl("type(BaseUI) == 'table' and not BaseUI.dormant()"))) { + qWarning("the starter UI did not load, or loaded dormant"); + return nullptr; + } + return host; + } + + // Mirrors the helper the other functional tests use. + void startProfile() + { + const QString port = QString::number(mPort); + QTimer::singleShot(0, qApp, [this, port]() { + mudlet::self()->startAutoLogin({}); + QTest::qWait(100); + QTest::mouseClick(mudlet::self()->mpConnectionDialog->new_profile_button, Qt::LeftButton); + QTest::qWait(100); + QTest::keyClicks(QApplication::focusWidget(), mHostname); + QTest::qWait(100); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100); + QTest::keyClicks(QApplication::focusWidget(), mLocalhost); + QTest::qWait(100); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100); + QTest::keyClicks(QApplication::focusWidget(), port); + QTest::qWait(100); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Return); + }); + + QSignalSpy loaded(mudlet::self(), &mudlet::signal_profileLoaded); + if (!loaded.wait(5000)) { + QFAIL("Profile took too long to load."); + } + Host* host = mudlet::self()->getActiveHost(); + if (!host) { + QFAIL("No active host available for the test."); + } + QSignalSpy connected(&(host->mTelnet), &cTelnet::signal_connected); + if (!connected.wait(3000)) { + QFAIL("Could not connect to the stub."); + } + } + + void feedLine(Host* host, const QString& text) + { + QByteArray data = text.toUtf8() + "\r\n"; + data.reserve(data.size() + 16); + host->mTelnet.loopbackTest(data); + } + + bool runLua(Host* host, const QString& script) { return host->getLuaInterpreter()->compileAndExecuteScript(script); } + + bool luaTrue(Host* host, const QString& expression) + { + if (!runLua(host, qsl("__starterUiProbe = not not (%1)").arg(expression))) { + qWarning("%s", qPrintable(qsl("probe did not compile: %1").arg(expression))); + return false; + } + const bool result = runLua(host, qsl("assert(__starterUiProbe)")); + if (!result) { + qWarning("%s", qPrintable(qsl("probe is false: %1").arg(expression))); + } + return result; + } + + void deleteProfileDirectory(const QString& profileName) + { + QDir dir(mudlet::getMudletPath(enums::profileHomePath, profileName)); + if (dir.exists()) { + dir.removeRecursively(); + } + } +}; + +static void initializeQRCResources() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +#include "StarterUiTriggerCostTest.moc" +QTEST_MAIN(StarterUiTriggerCostTest) From 964a3aeb7ec5ae050bd3aceb4cb1c05120b217a5 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Sat, 8 Aug 2026 11:15:52 +0200 Subject: [PATCH 132/155] infra: tidy up how CI installs Lua (#9734) #### Brief overview of PR changes/additions - lua.org is reachable again, so the mirror-fallback pre-build step from #9732 is removed. - In its place, `gh-actions-lua`'s build cache is turned on (it was explicitly off since 2022 with no recorded reason): every run restores `.lua/` from the actions cache, so lua.org is only contacted when the cache is cold. - The `lua:5.1.5:linux:x64` cache entry already exists in the repo and is touched daily by other workflows; the macOS entries get created on this PR's own run and the nightly scheduled builds keep all platforms warm from then on. #### Motivation for adding to Mudlet The 35-line shell workaround duplicated the action's build logic in two files and leaned on undocumented action behaviour. The cache achieves nearly the same outage protection using the action as designed - the one remaining exposure is lua.org being down at the same time as a cache eviction (7 days unused). #### Other info (issues closed, discussion etc) Test case: this PR's own CI runs the modified workflow - macOS legs build Lua once from lua.org and save the cache, the Linux leg restores the existing daily-used cache entry. Assisted-by: Claude:claude-fable-5 --- .github/workflows/build-mudlet-pr.yml | 44 ++++++--------------------- .github/workflows/build-mudlet.yml | 44 ++++++--------------------- 2 files changed, 18 insertions(+), 70 deletions(-) diff --git a/.github/workflows/build-mudlet-pr.yml b/.github/workflows/build-mudlet-pr.yml index da3ae93ab..85d36d56b 100644 --- a/.github/workflows/build-mudlet-pr.yml +++ b/.github/workflows/build-mudlet-pr.yml @@ -92,41 +92,15 @@ jobs: cache: true modules: qt5compat qtmultimedia qtspeech - - name: Build Lua (lua.org with mirror fallback) - env: - HOMEBREW_NO_AUTO_UPDATE: "ON" - # sha256 of lua-5.1.5.tar.gz - update when LUA_VERSION changes - LUA_SHA256: '2640fc56a795f29d28ef15e13c34a47e223960b0240e8cb0a82d9b0738695333' - run: | - # Pre-build Lua into .lua/ so the gh-actions-lua steps below skip their - # own download - they only fetch from lua.org, which goes down at times - # and takes all of CI with it. - for url in \ - "https://www.lua.org/ftp/lua-${LUA_VERSION}.tar.gz" \ - "https://sources.buildroot.net/lua/lua-${LUA_VERSION}.tar.gz" \ - "https://distfiles.macports.org/lua/lua-${LUA_VERSION}.tar.gz" \ - "https://ftp.openbsd.org/pub/OpenBSD/distfiles/lua-${LUA_VERSION}.tar.gz"; do - echo "Downloading ${url}" - if curl -fsSL --connect-timeout 15 --max-time 120 -o lua.tar.gz "${url}" \ - && echo "${LUA_SHA256} lua.tar.gz" | shasum -a 256 -c -; then - break - fi - rm -f lua.tar.gz - done - if [ ! -f lua.tar.gz ]; then - echo "::error::could not download Lua ${LUA_VERSION} from any source" - exit 1 - fi - tar xzf lua.tar.gz - if [ "${RUNNER_OS}" = "macOS" ]; then - brew install readline ncurses - make -C "lua-${LUA_VERSION}" -j macosx - else - sudo apt-get install -qy libreadline-dev libncurses-dev - make -C "lua-${LUA_VERSION}" -j linux - fi - make -C "lua-${LUA_VERSION}" INSTALL_TOP="${GITHUB_WORKSPACE}/.lua" install - rm -rf lua.tar.gz "lua-${LUA_VERSION}" + - name: Cache Lua build + uses: actions/cache@v6 + with: + path: .lua + # Not gh-actions-lua's own buildCache: that shares one key across + # runner images, and a .lua built on ubuntu-latest cannot run on + # ubuntu-22.04 (newer glibc). The action skips its lua.org download + # whenever .lua already exists. + key: lua-${{ env.LUA_VERSION }}-${{ matrix.os }}-${{ runner.arch }} - name: (macOS) Install Lua via GitHub Actions if: runner.os == 'macOS' diff --git a/.github/workflows/build-mudlet.yml b/.github/workflows/build-mudlet.yml index 56497b080..755ef11ba 100644 --- a/.github/workflows/build-mudlet.yml +++ b/.github/workflows/build-mudlet.yml @@ -78,41 +78,15 @@ jobs: cache: true modules: qt5compat qtmultimedia qtspeech - - name: Build Lua (lua.org with mirror fallback) - env: - HOMEBREW_NO_AUTO_UPDATE: "ON" - # sha256 of lua-5.1.5.tar.gz - update when LUA_VERSION changes - LUA_SHA256: '2640fc56a795f29d28ef15e13c34a47e223960b0240e8cb0a82d9b0738695333' - run: | - # Pre-build Lua into .lua/ so the gh-actions-lua steps below skip their - # own download - they only fetch from lua.org, which goes down at times - # and takes all of CI with it. - for url in \ - "https://www.lua.org/ftp/lua-${LUA_VERSION}.tar.gz" \ - "https://sources.buildroot.net/lua/lua-${LUA_VERSION}.tar.gz" \ - "https://distfiles.macports.org/lua/lua-${LUA_VERSION}.tar.gz" \ - "https://ftp.openbsd.org/pub/OpenBSD/distfiles/lua-${LUA_VERSION}.tar.gz"; do - echo "Downloading ${url}" - if curl -fsSL --connect-timeout 15 --max-time 120 -o lua.tar.gz "${url}" \ - && echo "${LUA_SHA256} lua.tar.gz" | shasum -a 256 -c -; then - break - fi - rm -f lua.tar.gz - done - if [ ! -f lua.tar.gz ]; then - echo "::error::could not download Lua ${LUA_VERSION} from any source" - exit 1 - fi - tar xzf lua.tar.gz - if [ "${RUNNER_OS}" = "macOS" ]; then - brew install readline ncurses - make -C "lua-${LUA_VERSION}" -j macosx - else - sudo apt-get install -qy libreadline-dev libncurses-dev - make -C "lua-${LUA_VERSION}" -j linux - fi - make -C "lua-${LUA_VERSION}" INSTALL_TOP="${GITHUB_WORKSPACE}/.lua" install - rm -rf lua.tar.gz "lua-${LUA_VERSION}" + - name: Cache Lua build + uses: actions/cache@v6 + with: + path: .lua + # Not gh-actions-lua's own buildCache: that shares one key across + # runner images, and a .lua built on ubuntu-latest cannot run on + # ubuntu-22.04 (newer glibc). The action skips its lua.org download + # whenever .lua already exists. + key: lua-${{ env.LUA_VERSION }}-${{ matrix.os }}-${{ runner.arch }} - name: (macOS) Install Lua via GitHub Actions if: runner.os == 'macOS' From ba44fa184ec74501178dbf1f9c87e363d55e6cb9 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Sat, 8 Aug 2026 13:33:48 +0200 Subject: [PATCH 133/155] Fix: don't offer updates that don't yet have a sha256 sum (#9735) <!-- Keep the title short & concise so anyone non-technical can understand it, the title appears in PTB changelogs --> #### Brief overview of PR changes/additions Don't offer updates that don't yet have a sha256 sum #### Motivation for adding to Mudlet They are incomplete anyhow. #### Other info (issues closed, discussion etc) --- src/updater.cpp | 12 +- src/updater/Feed.cpp | 24 +++- src/updater/Feed.h | 8 ++ test/CMakeLists.txt | 15 ++ test/UpdaterPlatformAssetTest.cpp | 225 ++++++++++++++++++++++++++++++ 5 files changed, 279 insertions(+), 5 deletions(-) create mode 100644 test/UpdaterPlatformAssetTest.cpp diff --git a/src/updater.cpp b/src/updater.cpp index 0fc36ab01..bb7af5d7b 100644 --- a/src/updater.cpp +++ b/src/updater.cpp @@ -265,7 +265,7 @@ bool Updater::downloadReleaseIfValid(const dblsqd::Release& release) } return false; } - feed->downloadRelease(release); + feed->downloadRelease(release, /*requireChecksums=*/true); return true; } @@ -319,8 +319,16 @@ void Updater::setupPlatformUpdater() }); connect(feed.get(), &dblsqd::Feed::downloadError, this, [this](const QString& error) { + // Only a check the user started reaches the console. An automatic one + // runs twice a day whether or not anybody is interested, so its failures + // would just repeat in red; once the update dialog is listening it + // reports them itself. + if (mManualCheckInProgress) { + qWarning() << "Manual update download failed:" << error; + emit signal_updateCheckFailed(error); + return; + } qWarning() << "Automatic update download failed:" << error; - emit signal_updateCheckFailed(error); }); } #endif // !Q_OS_MACOS diff --git a/src/updater/Feed.cpp b/src/updater/Feed.cpp index a826e8deb..a8c511295 100644 --- a/src/updater/Feed.cpp +++ b/src/updater/Feed.cpp @@ -90,12 +90,30 @@ QList<Release> Feed::getReleases() const } QList<Release> Feed::getUpdates(const Release& currentRelease) const +{ + return selectUpdates(mReleases, currentRelease); +} + +QList<Release> Feed::selectUpdates(const QList<Release>& releases, const Release& currentRelease) { QList<Release> updates; - for (const auto& release : mReleases) { - if (currentRelease.getVersion().toLower() != release.getVersion().toLower() && currentRelease < release) { - updates << release; + for (const auto& release : releases) { + if (currentRelease.getVersion().toLower() == release.getVersion().toLower() || !(currentRelease < release)) { + continue; } + const QUrl downloadUrl = release.getDownloadUrl(); + if (!downloadUrl.isValid() || downloadUrl.isEmpty()) { + continue; + } + // Release warns about the missing binary itself; nothing else notices a + // release that has one but cannot be verified, and the user is only + // told they are up to date + const QUrl checksumsUrl = release.getChecksumsUrl(); + if (!checksumsUrl.isValid() || checksumsUrl.isEmpty()) { + qWarning() << "Release" << release.getVersion() << "publishes no checksums to verify its download against - passing it over"; + continue; + } + updates << release; } return updates; } diff --git a/src/updater/Feed.h b/src/updater/Feed.h index facab300e..5a3c8490a 100644 --- a/src/updater/Feed.h +++ b/src/updater/Feed.h @@ -55,7 +55,15 @@ public: // not a checksum file". static QString findChecksum(const QString& checksumData, const QString& downloadFilename, int* entriesParsed = nullptr); + // The releases newer than currentRelease that this platform can install. A + // release with no asset for this platform - a build job that failed, or + // assets that are still uploading - or no SHA256SUMS.txt to verify the + // download against cannot be installed, so offering it only produces a + // download error the user can do nothing about. The changelog is built from + // getReleases() instead, and still covers them. QList<Release> getUpdates(const Release& currentRelease) const; + static QList<Release> selectUpdates(const QList<Release>& releases, const Release& currentRelease); + QList<Release> getReleases() const; QString getDownloadFilePath() const; bool isReady() const; diff --git a/test/CMakeLists.txt b/test/CMakeLists.txt index ffeb58a97..f91b33bf1 100644 --- a/test/CMakeLists.txt +++ b/test/CMakeLists.txt @@ -102,6 +102,21 @@ set_tests_properties(UpdaterChecksumTest PROPERTIES ENVIRONMENT "ASAN_OPTIONS=detect_leaks=0" ) +# Which releases the updater offers as an update. Built from the updater sources +# rather than linked against the Mudlet library, because the library only +# contains them when configured with USE_UPDATER. +add_executable(UpdaterPlatformAssetTest + UpdaterPlatformAssetTest.cpp + ${CMAKE_SOURCE_DIR}/src/updater/Feed.cpp + ${CMAKE_SOURCE_DIR}/src/updater/Release.cpp + ${CMAKE_SOURCE_DIR}/src/updater/SemVer.cpp +) +target_link_libraries(UpdaterPlatformAssetTest PRIVATE Qt6::Test Qt6::Network Qt6::Widgets) +add_test(NAME UpdaterPlatformAssetTest COMMAND $<TARGET_FILE:UpdaterPlatformAssetTest>) +set_tests_properties(UpdaterPlatformAssetTest PROPERTIES + ENVIRONMENT "ASAN_OPTIONS=detect_leaks=0" +) + # Checks the release-publishing scripts that keep SHA256SUMS.txt covering every # release binary - a binary without an entry is one the updater refuses to install if(NOT WIN32) diff --git a/test/UpdaterPlatformAssetTest.cpp b/test/UpdaterPlatformAssetTest.cpp new file mode 100644 index 000000000..fa2a54110 --- /dev/null +++ b/test/UpdaterPlatformAssetTest.cpp @@ -0,0 +1,225 @@ +/*************************************************************************** + * Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +#include "../src/updater/Feed.h" +#include "../src/updater/Release.h" + +#include <QtTest/QtTest> + +#include <QJsonArray> +#include <QJsonObject> + +/* + * Covers which releases the updater is willing to offer as an update. + * + * The 2026-08-07 PTB published a Windows installer and nothing else: the Linux + * and macOS build jobs failed, so their assets were never attached. Linux PTB + * users got a red "no download available for your platform" error on the + * console on every check, because the release was offered as an update and the + * download then had nothing to fetch. A partly published release is valid and + * will happen again, so it has to be passed over instead - as does one that + * published a binary but no SHA256SUMS.txt, since the download refuses to + * install what it cannot verify. + */ + +namespace { +// Only windowsOnlyTag is a real release; the complete, unverifiable and +// installed ones are constructed around it +const auto windowsOnlyTag = QStringLiteral("Mudlet-4.22.0-ptb-2026-08-07-eaa991b9"); +const auto unverifiableTag = QStringLiteral("Mudlet-4.22.0-ptb-2026-08-07-5e4d3c2b"); +const auto completeTag = QStringLiteral("Mudlet-4.22.0-ptb-2026-08-06-1a2b3c4d"); +const auto windowsOnlyVersion = QStringLiteral("4.22.0-ptb-2026-08-07-eaa991b9"); +const auto completeVersion = QStringLiteral("4.22.0-ptb-2026-08-06-1a2b3c4d"); +const auto installedVersion = QStringLiteral("4.22.0-ptb-2026-08-05-9f8e7d6c"); + +const auto windowsSuffix = QStringLiteral("-windows-64.exe"); +const auto linuxSuffix = QStringLiteral("-linux-x64.AppImage.tar"); +const auto intelMacSuffix = QStringLiteral("-x86_64.dmg"); +const auto appleSiliconSuffix = QStringLiteral("-arm64.dmg"); + +QJsonObject makeAsset(const QString& tag, const QString& name) +{ + QJsonObject asset; + asset.insert(QStringLiteral("name"), name); + asset.insert(QStringLiteral("browser_download_url"), QStringLiteral("https://github.com/Mudlet/Mudlet/releases/download/%1/%2").arg(tag, name)); + asset.insert(QStringLiteral("size"), 137252032); + return asset; +} + +QJsonObject releaseJson(const QString& tag, const QString& publishedAt, const QStringList& assetSuffixes, bool withChecksums = true) +{ + QJsonArray assets; + for (const auto& suffix : assetSuffixes) { + assets.append(makeAsset(tag, QStringLiteral("%1%2").arg(tag, suffix))); + } + if (withChecksums) { + assets.append(makeAsset(tag, QStringLiteral("SHA256SUMS.txt"))); + } + + QJsonObject release; + release.insert(QStringLiteral("tag_name"), tag); + release.insert(QStringLiteral("published_at"), publishedAt); + release.insert(QStringLiteral("prerelease"), true); + release.insert(QStringLiteral("draft"), false); + release.insert(QStringLiteral("body"), QStringLiteral("- fixed a thing\n")); + release.insert(QStringLiteral("assets"), assets); + return release; +} + +QJsonObject windowsOnlyRelease() +{ + return releaseJson(windowsOnlyTag, QStringLiteral("2026-08-07T02:14:11Z"), {windowsSuffix}); +} + +// Published its Linux binary, but not the checksums that binary is verified against +QJsonObject unverifiableRelease() +{ + return releaseJson(unverifiableTag, QStringLiteral("2026-08-07T04:22:09Z"), {linuxSuffix}, /*withChecksums=*/false); +} + +QJsonObject completeRelease() +{ + return releaseJson(completeTag, QStringLiteral("2026-08-06T02:11:47Z"), {windowsSuffix, linuxSuffix, intelMacSuffix, appleSiliconSuffix}); +} + +// Newest first, the order Feed sorts its releases into +QList<dblsqd::Release> feedReleases(const QString& os, const QString& arch) +{ + return {dblsqd::Release(windowsOnlyRelease(), os, arch), dblsqd::Release(completeRelease(), os, arch)}; +} + +dblsqd::Release installedRelease() +{ + return dblsqd::Release(installedVersion, QDateTime::fromString(QStringLiteral("2026-08-05T02:09:03Z"), Qt::ISODate)); +} +} // namespace + +class UpdaterPlatformAssetTest : public QObject +{ + Q_OBJECT + +private slots: + void linuxIsNotOfferedTheReleaseWithoutALinuxAsset(); + void windowsIsStillOfferedIt(); + void intelMacIsNotOfferedTheReleaseWithoutADmg(); + void appleSiliconIsNotOfferedTheReleaseWithoutADmg(); + void aReleaseWithOnlyItsChecksumsFileIsNotOffered(); + void aReleaseWithoutChecksumsIsNotOffered(); + void theVerifiableReleaseIsOfferedInsteadOfTheNewerUnverifiableOne(); + void aPlatformWithNoAssetsAtAllIsOfferedNothing(); + void nothingIsOfferedOnceTheOnlyNewerReleaseIsIncomplete(); + void thePassedOverReleaseStaysReadableForTheChangelog(); +}; + +// The regression: this is the update that produced a red console error twice a day +void UpdaterPlatformAssetTest::linuxIsNotOfferedTheReleaseWithoutALinuxAsset() +{ + const auto updates = dblsqd::Feed::selectUpdates(feedReleases(QStringLiteral("linux"), QStringLiteral("x86_64")), installedRelease()); + + QCOMPARE(updates.size(), 1); + QCOMPARE(updates.first().getVersion(), completeVersion); + QVERIFY(updates.first().getDownloadUrl().fileName().endsWith(linuxSuffix)); +} + +void UpdaterPlatformAssetTest::windowsIsStillOfferedIt() +{ + const auto updates = dblsqd::Feed::selectUpdates(feedReleases(QStringLiteral("win"), QStringLiteral("x86_64")), installedRelease()); + + QCOMPARE(updates.size(), 2); + QCOMPARE(updates.first().getVersion(), windowsOnlyVersion); + QCOMPARE(updates.last().getVersion(), completeVersion); +} + +void UpdaterPlatformAssetTest::intelMacIsNotOfferedTheReleaseWithoutADmg() +{ + const auto updates = dblsqd::Feed::selectUpdates(feedReleases(QStringLiteral("mac"), QStringLiteral("x86_64")), installedRelease()); + + QCOMPARE(updates.size(), 1); + QCOMPARE(updates.first().getVersion(), completeVersion); + QVERIFY(updates.first().getDownloadUrl().fileName().endsWith(intelMacSuffix)); +} + +void UpdaterPlatformAssetTest::appleSiliconIsNotOfferedTheReleaseWithoutADmg() +{ + const auto updates = dblsqd::Feed::selectUpdates(feedReleases(QStringLiteral("mac"), QStringLiteral("arm64")), installedRelease()); + + QCOMPARE(updates.size(), 1); + QCOMPARE(updates.first().getVersion(), completeVersion); + QVERIFY(updates.first().getDownloadUrl().fileName().endsWith(appleSiliconSuffix)); +} + +// A release whose binaries are still uploading looks the same as one that lost a build job +void UpdaterPlatformAssetTest::aReleaseWithOnlyItsChecksumsFileIsNotOffered() +{ + const QList<dblsqd::Release> releases{dblsqd::Release(releaseJson(windowsOnlyTag, QStringLiteral("2026-08-07T02:14:11Z"), {}), QStringLiteral("linux"), QStringLiteral("x86_64"))}; + + QVERIFY(dblsqd::Feed::selectUpdates(releases, installedRelease()).isEmpty()); +} + +// The download refuses to install what it cannot verify, so a release whose +// SHA256SUMS.txt is missing is as uninstallable as one missing its binary +void UpdaterPlatformAssetTest::aReleaseWithoutChecksumsIsNotOffered() +{ + const QList<dblsqd::Release> releases{dblsqd::Release(unverifiableRelease(), QStringLiteral("linux"), QStringLiteral("x86_64"))}; + + QVERIFY(dblsqd::Feed::selectUpdates(releases, installedRelease()).isEmpty()); +} + +void UpdaterPlatformAssetTest::theVerifiableReleaseIsOfferedInsteadOfTheNewerUnverifiableOne() +{ + const QList<dblsqd::Release> releases{dblsqd::Release(unverifiableRelease(), QStringLiteral("linux"), QStringLiteral("x86_64")), + dblsqd::Release(completeRelease(), QStringLiteral("linux"), QStringLiteral("x86_64"))}; + + const auto updates = dblsqd::Feed::selectUpdates(releases, installedRelease()); + + QCOMPARE(updates.size(), 1); + QCOMPARE(updates.first().getVersion(), completeVersion); +} + +// Mudlet publishes no binaries for the platforms it is packaged for by others, +// so those builds are told there is no update rather than shown a failure they +// can do nothing about, twice a day, forever +void UpdaterPlatformAssetTest::aPlatformWithNoAssetsAtAllIsOfferedNothing() +{ + QVERIFY(dblsqd::Feed::selectUpdates(feedReleases(QStringLiteral("freebsd"), QStringLiteral("x86_64")), installedRelease()).isEmpty()); +} + +// What a Linux user on the previous PTB sees: no update, rather than an error +void UpdaterPlatformAssetTest::nothingIsOfferedOnceTheOnlyNewerReleaseIsIncomplete() +{ + const QList<dblsqd::Release> releases{dblsqd::Release(windowsOnlyRelease(), QStringLiteral("linux"), QStringLiteral("x86_64"))}; + const dblsqd::Release installed(completeVersion, QDateTime::fromString(QStringLiteral("2026-08-06T02:11:47Z"), Qt::ISODate)); + + QVERIFY(dblsqd::Feed::selectUpdates(releases, installed).isEmpty()); +} + +// A release passed over here still has to carry its version and notes: the +// changelog dialogs render the unfiltered release list +// (UpdateDialog::generateChangelogDocument) +void UpdaterPlatformAssetTest::thePassedOverReleaseStaysReadableForTheChangelog() +{ + const dblsqd::Release release(windowsOnlyRelease(), QStringLiteral("linux"), QStringLiteral("x86_64")); + + QVERIFY(release.getDownloadUrl().isEmpty()); + QCOMPARE(release.getVersion(), windowsOnlyVersion); + QCOMPARE(release.getChangelog(), QStringLiteral("- fixed a thing\n")); +} + +#include "UpdaterPlatformAssetTest.moc" +QTEST_MAIN(UpdaterPlatformAssetTest) From ff6bd8755abaab94d356b22d37b7af1671381a1f Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sat, 8 Aug 2026 13:34:03 +0200 Subject: [PATCH 134/155] Infrastructure: Bump lukka/get-cmake from 4.4.0 to 4.4.2 (#9729) Bumps [lukka/get-cmake](https://github.com/lukka/get-cmake) from 4.4.0 to 4.4.2. <details> <summary>Release notes</summary> <p><em>Sourced from <a href="https://github.com/lukka/get-cmake/releases">lukka/get-cmake's releases</a>.</em></p> <blockquote> <h2>CMake v4.4.2</h2> <p>The <code>get-cmake</code> action downloads and caches CMake and Ninja on your workflows. Versions can be specified using <a href="https://docs.npmjs.com/about-semantic-versioning">semantic versioning ranges</a> using <a href="https://github.com/lukka/get-cmake/blob/latest/action.yml#L13"><code>cmakeVersion</code></a> and <a href="https://github.com/lukka/get-cmake/blob/latest/action.yml#L16"><code>ninjaVersion</code></a> inputs.</p> <p>Changes:</p> <ul> <li><code>latest</code> is now using CMake version <code>v4.4.2</code>, use this one-liner e.g.: <code>uses: lukka/get-cmake@latest</code></li> </ul> <p>Enjoy!</p> </blockquote> </details> <details> <summary>Commits</summary> <ul> <li><a href="https://github.com/lukka/get-cmake/commit/fffaaafeea488556c2c12dad60690008bc1caacb"><code>fffaaaf</code></a> New CMake version(s): cmake-v4.4.2</li> <li><a href="https://github.com/lukka/get-cmake/commit/4a7d025fc60f00db0c7b44ebf783d19b52444830"><code>4a7d025</code></a> New CMake version(s): cmake-v4.4.1</li> <li><a href="https://github.com/lukka/get-cmake/commit/06fec8f1da5f120990504a9da3e9891d71fb89ac"><code>06fec8f</code></a> Bump actions/checkout from 5 to 7</li> <li>See full diff in <a href="https://github.com/lukka/get-cmake/compare/v4.4.0...v4.4.2">compare view</a></li> </ul> </details> <br /> Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Vadim Peretokin <vperetokin@hey.com> --- .github/workflows/codeql-analysis.yml | 2 +- .github/workflows/performance-analysis.yml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/codeql-analysis.yml b/.github/workflows/codeql-analysis.yml index 1f5af9c6c..cdcd2d755 100644 --- a/.github/workflows/codeql-analysis.yml +++ b/.github/workflows/codeql-analysis.yml @@ -98,7 +98,7 @@ jobs: queries: security-extended, security-and-quality - name: Use CMake 3.30.3 - uses: lukka/get-cmake@v4.4.0 + uses: lukka/get-cmake@v4.4.2 - name: (Linux) Install Lua via GitHub Actions uses: leafo/gh-actions-lua@v13 diff --git a/.github/workflows/performance-analysis.yml b/.github/workflows/performance-analysis.yml index 8c511d809..0e9d0029f 100644 --- a/.github/workflows/performance-analysis.yml +++ b/.github/workflows/performance-analysis.yml @@ -28,7 +28,7 @@ jobs: submodules: recursive - name: Use CMake 3.30.3 - uses: lukka/get-cmake@v4.4.0 + uses: lukka/get-cmake@v4.4.2 - name: Install dependencies run: | From 7c03ced91a683d97c2d3e9b0aeebe1e7f73ac5da Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Sat, 8 Aug 2026 18:49:56 +0200 Subject: [PATCH 135/155] improve: the starter UI's chat capture is now a trigger tree players can read and copy (#9736) #### Brief overview of PR changes/additions - Chat capture ships as a permanent trigger tree in the base UI package instead of triggers created at runtime, so it is visible and copyable in the editor: one root folder, three cheap substring gates (tells / speech / channel tags), each gating its Perl regex shapes as children. - Lifecycle moves from `tempRegexTrigger`/`killTrigger` to `enableTrigger`/`disableTrigger` on the three gates, with a `BaseUI.chatTriggersArmed()` probe replacing the id bookkeeping. - Vitals capture is unchanged and stays Lua-armed: its prefilter is machine-built from the label tables, so an XML copy would drift from what `parseVitalsLine` reads. #### Motivation for adding to Mudlet The gate pattern - a cheap substring parent chaining to regex children - is the thing new scripters most need to learn, and shipping it as a readable tree teaches it where invisible runtime triggers could not. #### Other info (issues closed, discussion etc) A non-matching line now costs ~17 substring scans and zero regex work. Tightening the speech gate's literals fixed real leakage in the process: the stems `say`/`ask`/`yell` had been letting "essay", "task", "asked" and "yellow" through to the regex layer. New tests: the tree's leaf shapes are asserted equal to `BaseUI.chatShapeRegexes()`, gates are asserted substring-only, and every gate literal must have a corpus line - the enforcer for the gate contract, since a case-mismatched gate would otherwise drop lines silently. Each was verified to fail by mutating the shipped package. **Test case:** Start a new profile, connect to a game with tells and channels, and confirm chat lines still sort into their tabs; open the Triggers editor and confirm `mudlet-base-ui` -> `Mudlet base UI chat capture` shows three gates with regex children. `ctest -R StarterUiTriggerCost` covers both. Assisted-by: Claude:claude-opus-5 --- src/mudlet-lua/tests/UI_spec.lua | 60 +- src/packages/mudlet-base-ui/config.lua | 2 +- .../mudlet-base-ui/mudlet-base-ui.mpackage | Bin 127430 -> 129317 bytes .../mudlet-base-ui/mudlet-base-ui.xml | 535 +++++++++++++++--- .../StarterUiTriggerCostTest.cpp | 378 ++++++++++++- 5 files changed, 850 insertions(+), 125 deletions(-) diff --git a/src/mudlet-lua/tests/UI_spec.lua b/src/mudlet-lua/tests/UI_spec.lua index 0bd7a11aa..1ac1d7879 100644 --- a/src/mudlet-lua/tests/UI_spec.lua +++ b/src/mudlet-lua/tests/UI_spec.lua @@ -1989,7 +1989,7 @@ describe("Tests UI functions", function() end) end) - describe("the grouped chat triggers", function() + describe("the chat capture shapes", function() local chatLines = { "Bob tells you, 'hello there'", "You tell Bob, 'hi'", @@ -1997,45 +1997,49 @@ describe("Tests UI functions", function() "Bob whispers to you, 'psst'", "Bob tells the group 'incoming'", "Bob says, 'hello'", + "Bob asks, 'where is the bank?'", + "Bob exclaims, 'at last!'", "You say, 'hello'", + "You ask, 'which way?'", + "You exclaim, 'finally!'", "Bob yells, 'help!'", "You shout, 'hello'", "[newbie] Ann: how do I get out of here?", "(gossip) Ann: anyone around?", "< chat | Ann: anyone around?", + } + + -- the last two are captured by a shape and then turned away by + -- chatChannelNames, so they stay available to the vitals layer + local notChatLines = { "You are standing in a dark forest.", "The orc hits you for 14 damage!", "[combat] 100/120 hp", "(12) something that is not a channel", } - -- chatLikeLine additionally requires the tag to be a known channel name, - -- so the trigger fires on these and routeTaggedChatLine turns them away - local taggedButNotAChannel = { - ["[combat] 100/120 hp"] = true, - ["(12) something that is not a channel"] = true, - } - - it("fires on the same lines the individual shapes did", function() - local grouped = BaseUI.chatTriggerPatterns() - assert.are.equal(3, #grouped) + it("recognises every shape of chat line", function() for _, line in ipairs(chatLines) do - local anyGroupMatches = false - for _, pattern in ipairs(grouped) do - -- rex.find: rex.match returns false for an unset capture group - if rex.find(line, pattern.regex) then - anyGroupMatches = true + assert.is_true(BaseUI.chatLikeLine(line), "not recognised as chat: " .. line) + end + end) + + it("leaves ordinary game text to the vitals layer", function() + for _, line in ipairs(notChatLines) do + assert.is_false(BaseUI.chatLikeLine(line), "ordinary game text taken for chat: " .. line) + end + end) + + it("has a shape for every line the trigger tree routes", function() + for _, regex in ipairs(BaseUI.chatShapeRegexes()) do + local matched = false + for _, line in ipairs(chatLines) do + if rex.find(line, regex) then + matched = true break end end - -- chatLikeLine walks the shapes individually, so it is the reference - if BaseUI.chatLikeLine(line) then - assert.is_true(anyGroupMatches, - "grouped triggers miss a line the individual shapes captured: " .. line) - elseif not taggedButNotAChannel[line] then - assert.is_false(anyGroupMatches, - "grouped triggers capture a line the individual shapes did not: " .. line) - end + assert.is_true(matched, "no line above exercises the shape: " .. regex) end end) end) @@ -2062,7 +2066,7 @@ describe("Tests UI functions", function() after_each(function() BaseUI.settings = savedSettings BaseUI.saveSettings() - BaseUI.createChatTriggers() + BaseUI.armChatTriggers() BaseUI.createVitalsTriggers() end) @@ -2074,11 +2078,11 @@ describe("Tests UI functions", function() it("should retire its capture triggers while standing aside", function() BaseUI.standAside("sysServerGuiInstalled", "SomeGameUI") - assert.is_nil(next(BaseUI.chatTriggerIds)) + assert.is_false(BaseUI.chatTriggersArmed()) assert.is_nil(next(BaseUI.vitalsTriggerIds)) - BaseUI.createChatTriggers() + BaseUI.armChatTriggers() BaseUI.createVitalsTriggers() - assert.is_nil(next(BaseUI.chatTriggerIds)) + assert.is_false(BaseUI.chatTriggersArmed()) assert.is_nil(next(BaseUI.vitalsTriggerIds)) end) diff --git a/src/packages/mudlet-base-ui/config.lua b/src/packages/mudlet-base-ui/config.lua index a472c6762..24324c303 100644 --- a/src/packages/mudlet-base-ui/config.lua +++ b/src/packages/mudlet-base-ui/config.lua @@ -23,5 +23,5 @@ Commands: When a game installs an interface of its own, this one quietly stands aside - `baseui show` brings it back if you prefer it. ]] -version = [[1.1.0]] +version = [[1.2.0]] created = "2026-07-25T12:00:00+00:00" diff --git a/src/packages/mudlet-base-ui/mudlet-base-ui.mpackage b/src/packages/mudlet-base-ui/mudlet-base-ui.mpackage index ac4fe806d2a2807a5858501985dfa7badd0e2001..1e7f0c53f304d3777986067c77f88d85cb9ddcce 100644 GIT binary patch delta 19968 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 Tk^kN=+2tv^oZ0Q@_rd=G>MUhf delta 18056 zcmV)7K*ztO@(0G_2Y*mY0|XQR000O80c8eVwuiPGSpon6HUt0w3IG5AV{dL|X=g5M zbzyB&+lt#T5PjEI4BMB4jhzd$g}@d<3S}Qs3f<C&Wg%mGY^#waSC?eBU*D0GkZoCG zWHZ-u&WwrzHmxTM)JQLN2fmjMTB!((g&{PGd{LpJBFOT2P=7P9R0XM;|9!)V^#MCt zi=qJOfvX_=kt3KEYNK1(l`0_IzEP8nWwy@mIdq=?%TafwxRixEczpaf_324q@IAwf zzFqRc4i97<yChe7l@zP7)l08(tqnMjHZqr*&lYQflk`3Ggo-~ES~r6MM?l>`-J_pD zB<`WLW`GkL;8n#03mpywqcum_kSn<de`+g7FV6tp!5Le`4L|OM*uY>o%D(}jWjdq6 z7bXFkPT<Wsd(Aiin_q!*D(29b`XCbEgo1(2fISsuurS#uHGd$b+<e=UZvhy8X&~(r zb$TAjO41Cj!_bj~;w*&G>LshupvQzmBsH-10TnwhvcTlaZu@NpyYHX*WQvw*(`o4v z6^<Il+|1R+l2B5Uo0jm^@HX;J;y4nIgQ0t=cta_R?npNdoEa#Gu~x1(r&5Tm8JJ1q z)<W#}d+{krA0(U~-q08r<@dpVrN$=B%Uwfz#+^egMLkm6>zpQRrJ*9rdROF6M4It9 z7mG}<RZ^Q&rLqyCj9b8ii>SoUo|7<hk($Bqu;P@jUHI-u@4%e&EMH8c34RAjp2g(^ zrYO)wqy_9>wcO`+?$Qrr8^^;+QybUKmx34d$m72(>9Smw3%1p~9G*FU-NDUjvHDOf zJ{GI@56jhhvEcVMoj2kyP)h>@6aWAK2mk?P23;cZf>u33001)O000sI003=uWNc-0 zEn;DFWi54SE_iKh%sXpy+qSZwkADRYdvhwCO0sOHiKE2HxQW|jCQfn_r;{_bn}JA3 z;+P~@g0!W^zQ6tM3w+3ba+==hhnr3<5?Cx2`@-%5eDZ9WChF1@F1Fc0urnG5%4DI9 z;%t5pd_4JixF0-wy7lCrFWx>s`Omu}bzDV>Dc|YvLeC9!bly9N#yi2&t$#c@DdPFu z6dq!m+TwJr<uHl0tFit=8dU5K!!o`!2f@m?0A7E#No0zHAhU>n9N;pYnx|9kOcg)b zrWa~<VG-x$)1RQ@<ExQIWW7|E;ljAn-ShsFZ2=(Q(59)*qNh)`{S!6kOwJob`eeKP zM%{&(o8{Brc<$b_$(j41cXstdzyIvNo@{d`E@Yclf@|DfTjUd5o6S0W_&{W}8Nn^z z$_W;SLZZ~iS8a}e{K;yBAH$*QqL?VHT&j~qxl$LUDO8-n-<b}LDi^v`I?{RRRB6=} zyc*B|Xg6vOn7061Uf9bxGH#^a*m40{1*EI6FaR2<Dl6lp23I;PE0}4eoXH}moJ|c4 znINLexYUUQz-n%s(uGmeDo#o@D{QKMIez|5g$rE(3LqeV(xq0t%oad+>|i1t7S=hO z2~kC{PE1%jnib~BjlLKtkh`)O%s#WcgjsBo$nh%8GInKupswO_L7l12aRj0Z5#TD$ zB6|gdB{rKoSTRDSBlR3RL9JjOqI8~y`RF;Q*$8^F%p{`|vxMOblOe8}7j`xSTT*fP znCL;iu9$y+CUFL+jiMO!L6vM@z*LY!RT#fWRArkHal<6ejB*Q|0~Ni}B#9d+r&sVd zWFlN2y9?mdbfr@3N@2|qgn-BZk!HGx0hwivqxcgR;Kx@==fFrH1b~@+1>hm(;QS-R zL)?f_v<1o^RLQEtB-uVenzn@_z;ZoxED+D?T+<4Fh{L2-2`J!#OrWJjplq`^X(`eI zd<YIlg&+ccVf9()OJY=9D0`Ku830egB2)rw1&k;SULnw$#?GM<s^bqYumRCzW^T)v zbolowHf6E`hMHtHbk%GYhq1{@Bqq&y?ZEX!PhpJ!A6CV7s+Y<Zv<_2*0Nf{qE{n<` zN}G{?aha7W41fdb&_Xwus4*GqJ{V90OaaO+4NQ)xkX^7`4T}K27Y2E(0vZ|+&ygrX zjmG5SDez~AcAJ3IGU4<xPPGV}HQ;Jto$+fS^9XfO#Lxqj6^QauCl%N?jyhT8Mg{B< z1JYZYql<HoeXCl4X#_xBYA+3{w@A--qlkll(bg6_ZgrsK0Z@Ipk=Bv;0N?4~J1`ZP zJqi0mV#^lnT04vx`yr^RvRl21T0_>_JJW!GfCtan^jc%q+B;*|lWm&mR!?Uf8SsaA zz9>N*Tcg(6H_Y_{{o&dy)V2ZkwFNs^gQYfN)mCCd4SRtpX|kWu+78s*l)P)a1V{IO zA})G;H5#d48-@D0ia&esQBvt(i}lNZQ5F~EB~9&eLE8Xf1k*jHcO4=dTb>2<4^-0` z+Bp%?0t^AYpLZ6Tc1d<S;6}jHppwDfwL%y{D68PP57d_}<!3rj!FTs(;f{F}44`#7 zr<R@Rj@jL#7IZ`jH{RcQxDzs%EzoU$VC$Z~zjOaltM!AOG1}ef-p<}W^_1xHvCZro zGrM26y@*q4e)K?(^^}@tmZ|zU1w*Nz>Bh?-(JNb(LOwXTm&6HtS1TMbz84IDJ*XG> zx_2*7Hv<N3fc8c|u7ObtLn0H`vF`2P8sWjwYd3)RcW(iX_S=|SpbtiSUC`ZsN27-x zcHXw)FDiJrkFdeMkRI$mqMt|i8^USG%NiT?v^d8)^V}gq2m5C>AI&gUD0?vW^b~i3 zd10$88iqEp#RMF)&Rnk1-8~kuPSiMG`j_F<mZeQ6YA0WU#wBs2?t#zCag)yG!^F(W ziP{DD^K)Vp>fNYOkG?0YwX6Mq1?q4rPgIuxp{~$TT)ByQutovt^5AZAK%h(p8weTJ z2AVcgh5Ej`H~kaRJmYpZb(S_K-qj1Z-(op-7AWCPFE6jlV!uK*@je2?*<W7H&TRMo zuKs_p92C(8p^<)rL!?NNEr4S>N6t2}7Gqq6F{FC=@dd>t6PP`Tcn4>Hr!-5fMpsQf z8e@6gR(|ydppqaM(t-rs6?oQ?c?5wA#hDZVlP_j&AgaCbJ;W1U#L`7mj?@W4q3bpg zkQ-z40whOjj!eJ_9q<LBl>aUfOQ+SrHj#ag0cgI^KtY;Y7neXCczmP71>*&j2B?LF z%qj>7Da3BA$4WcIDf;(+%81_2s*Ls*aXsZKF+EyhAB0gD*wV9aRh!?DCA#pG_m(@8 z@j$KU?{b%(cPBdoTG3>ziuqLc#sm7V?^{O?9zA+=N7utKXqde1z+=Br&<tc%D-e-0 zP_hb0ue^=Z5`WUP=eL#%+f@kLl@9t_J}n{rpfDCPCSYM}!={0Mykm>cV?}a}tZ6uf zsZ-0bH)+cNOcA03&W)%M41~0yP2UOcmw)P-yAF3B&C54=%X~yu)mi-uGxJVv!CNCx zL%VL5A+twjZx-}r7yT;a1Az6A%dbF&yZf`<u*P}$_1X8ehcuZ<S9b$XclY$30JB%1 zWJXeGjNd^7F~(7UVB)|ApAb*LO<X}nf~h}N4uG+t0rld%07V7SyVnQ722c*m7Zxi6 z=oJh|12Q9Zte5B<$o+6Kcd3gN>c$0RHiVv%h9h!VnT=2*DE|R-C1>D5%m*<aVvDZw z2od)vNrpTcHz?4)3uE#+w@&~9(jQM1<X426+=65*94yLzno?8Daj{_3lraKFvUWDU z^6c{KN>+VLi>o|`{0dj2GfNIen23a<!%Z<|LlqZQV|Kj(TD-DBECU&Dfx*kK)G5&m zw1?7uxz_ICJ#TN1NN@G{F(070+AzX3?KgF7Uf3(*omjST4indHNm)r)vfH3QT@Lvz z^21J@DK060yZ5Sc6(`Y19r|pS;K|uz8oN^C;m&w0ZURM<83VabW>H4q#}d_h_5O&{ z?qvza4JmIcamK(uOLE{mW)aJL0M0yzHDu-IMgAGvX@fzF5g^(o$$}sfOv=TGy$EeB z1(p~VQoo6X0bCGheA(P$3F=DIenRTV=)lKEXb4w-kcWquR-33l>d5~CS%jBA@&V%0 zMGkUc&kAoZ-v#2cCBdesmtX>>S7eBx{E~a&fdSy*bN%$vKgclO-+p`PF?zian$iwU z#~W!%1%IYVkLV2;QOs8xDNJh$>!)M?;E_;o^L$K?gvtLS4X-iPPaph)5Fq`Xw<Ay6 z+FF-?owa`QYxUYn^k)eoVMVJ~*Wt#J*S~~eph=<G$b)4~dHwXMro0*Isb6n7YGYqp z1*u?rAxF~CDE9%Dn9PRNtyzo+k_@Jvh@7j#B9O|f0-`MlAIUDHGKelQ!NL%EK6d@( zLX+J<16Hlbm>8AAgbsEV2nJFlBj#8EeGis@q_F4&*=<K7FFP9f>qd>dBt~Iv$v+_W z&FXkrE1Z8i_74pP>~6gr^Ybl@tY>PCX}upegfxCuHqa2u5(#ck7Aqkb2vMaGV^e(L z+S@kQ0I8aYuGHBI<OhrjFA!I~2c|q|Cgq?>s}w6kfW3e+s^C%MoOxnkQ(feU2K_OA z`S2@=@3^$qDvm>d4yY-q%r3y&2~u1{sV}(dT_+D%KK2#+R<&OHdg4N=HmNfSmIF(v zE2CP`NkU8^BL>_KcK?A|KzM@fxXb%e6cO+qsNwnm1qKId4|K~#__RCl(;cWCb+grt zU)Uj&*Vl6$X9H9>u7e{`Xfp^1Fd2Y<sYomk#KaVKPy{1H;8b_J_C`g6mq&-MPhJKC z(L{Owe0=yR*yMm)BaaW?95&<dZPTdb+Nh&X?~dNTI(qZ`s2SU|ZJhUVZQi%P9vvUO zIcd!;Et^JrC)7gl_T9U;ZxDQa?Q0!`?zXoQds)xSK*|_P^>SS<FfHSLiXsnxsF!MI zh59_;Xd_c`uE7j=0OXEj!tqR%tK9T(TwnbU5Je$nfU?iT$R**+;)EJ7cfwzp3V%*v zhVw1o)x~+R0jI|Z05XaaGW3e*0_0T6U?fzfQ>tz{NjM!=$>ewd%!T`VefJn*BaEHt z<VQ{zXj-Rwtmq@jZJ-woVeG|!usc>aeEfjch$j@Kwd?FgZ~mTrLyrxPl1^PVtQUzB z+JWC)8X<_EXyhPhYEcLrT2&hg<{0^{imKK1fc6&Ff~c9o6PzN#^L|HkUzy75?fO&_ z!%_5ipxUSfz)PJ#HjBNxTeW7YN#?2u^z`ciEF?ZKS_gzy4~U0?e`S(?dYrK28(1SW zbl9?)y1O{fe?|K@>x(ypIR<WV$c18mvWdjWsZ?Apu=wrIeaneI2ldCC%^@b)6&Auq zO3q^__weVZLpk}vy8%+c!V_wn$Nqql_JQV%7x7UAEG``tR4O@s;4O=fwxXt@k;1Nm zaSbKAS_P-2o}Xh}(1VA6et?_{{*{!E!CvR;I)Kf}%;Ke-wb_dDRVM^sxP{ZwhE9ao zBH~o)3evCPMTW<ja;VEvgj8o)8ro+8j*_+#V-2L0A~j}G>#R$TVc!s^c|VhSJw=ar za$G;-VRGli)o=55AK=K$)igGBH@~*Pt#fhSycWEhHgA8laKW~J+y$^Ute@lNF-#yX zsgXbg619-{LmTb|eR2(TVO%zgOm%T#n)U07onnIt_N=HG3*Ppk0d}qD%w4r+{JjE~ z-9_Y^nuVp6Ypv(^%9hPUg-uMJw4_nwEnIP$w)khOhPSyc%C-n~1LzifrsR>V+VaI> zXEO{n%>zp5IV<UZWSB2WXfQ|5?%ITPt(>UsbhQFjSkh6p6a`&VCVZ@BI*q{&fc(<X z**4jyw@SJ;fCkjQIe^xJ#(=+vNg`VrYVbQ<mZr#>AdPP6U}5p#^tZFC)3dAZhv)wm zHD1~3Y<l|JU~>LtJlGrG^qx&7*Mnzg?%${12j~6sgY$uZrw)BRj;Vv8Hs1f(imimv z|L}LBL>>SVlI}H^qCt83XVY&+)vWpo+(VAB2JrUpTKhUr|4w=V4_;xp1_N`~W(k%a zr>^gb-W}i6^aAp`xX4Hlhez>OFm#APOL5m^KmQjpa5#_tOB9^;fP{1SUk!1{&i+mR z?3}pSwZBb&V|zUrx5MN5r;{`Hje}{!de%jto}FE99$m-pbd^GmiQ8#|PLg(V4`#cb zSg=a8U`{$ZB2fN1Qyb9x24CT<gIa%81APl#OnMEzrN>Ix=OP8>5p-oKHU7ZEhZ*2@ zF+X(}&cua@Ch8*Q`lqg8A}kYTwv>to9%aQP?%kAsVrOzSs16jS7=tLCa8Yz>5DGF^ z2$G$N1cwytbMMJ8@21#=FgV=s$wlJ*uY85m$(@PNaBAYO%=ndo^OU9t?J+BReQcW> zV#gcFFEE}JFsuQ2Zmp*@b&R(O_Fx?;z(L+`!tyzXg2ewm?e6)C9wNg4y(Z0|$mb{7 z$$__j^(7sfl@Mr|qM02l4iOE7b+^XVL<2(!1{qx#7yn^g6R~lyH$cA#+(kYEjYK)i z?J>O1U=(rQqoYWnz^VtI3Dj~T8S&vK9&FTd!iy=e%&5wfIK=y8gy~z^S0|ipMl9sq z?Q4P|pb=Qz1h3X)(N7g#Hzb?_0T{_B=+-HJ1VcTtQO`{F)EM-(5uS4Uc{BT_-rG~& zJ!xZ&Yvh~o;#lW+hlwyysx`u+#G>qNyn;0VCn48v_}sCKQ(@{+Zo>uW_>HXYyUlmF z{xt`ew=-@Q$CGlrf7hfto_0!XHoBe@@|Lv&64yh8Q1&Bu*k2g%4~5R~0`r7zx=vev zP_4M{dnb_|UH2<%qXCC3nRv_vvG3$Aw9n))7(3tu*58tj&pC_bx<epmX1;GikG-IG z@52xMpkEhLD5$IR-6^=Ti(3hx=xYadO-+R!J)h8lq&MO<HE$;>lvUk{Pke_DFnWYv zb`{FN+6}JLLTOCE=S;2cW~*t`a`R4q;!|4P$VL|_UP><c#2oJ}pi<Zw<#s>6djH{s z(^xvSEDR+oaw($|$I7*4nu)Gt0!?$ew23~8rvpD$2hLOQO3jwBUgSa4zu=g+vz|CE z;k&$zWMf}1WCh$Ftf%;XnD8CB2I)$i1vO9b5<9A|B<&Q~Te?Gn11UP>^Hj`#g%?KW zxU|H`u_HnP)2Qmr_i}$5q8V7)kNqx8VGA<Hra6xFwS#xh-yiLMKK}Un<kjm}Z;pu9 z*rq6n@m1m~LmF_SoXzl}!k83c9%H$>%17!j0}wwcuLElf{uKMlR<Pqt4HwrDGs#`( zXOwYPUx$EwdroKbC8+|YShW*>umu&)%`8Ud&{=oP1$TdvAY8=D&7)hsrge+e>rZQ2 zm5WlOG8DRfxf$Tq(7GZdvTPNF+L~CGgydR<q?>nWRBg*L-6{Q^w>`&N&jHhd|A^Al z?>Kq?LG55CL3Qd_oeiOj3@b0sCIQ}1^$N<7EnZn=U)FXSc`Ipb@k4BXx#kAZ({KD~ zYkH3Xw;<0M`W@6EHN!&;12MpDa<2o~oHkjP+q|{#Cl=2ep*!zHH-&o}qCz}t@7>m& zR}l#NE;oCpu6#`g*K~)g(1lkMFCt;wLG5hX+9G4r!B;lct+g`g+Lq9r2TuanRgt-O zJCQkZ7|@>DO8_|fwf*3KR>^f!?9yd8)@aiFJ?e@y_Bxt7@Kp4_8f{>La!VmZWO4LW zX_3@LOo+yl5l0(hv$b3FU^U*|i=X0SO=K^HWP?^=mnuT^?F-)jfb6HVp-tpNlaYFx z@g2VPZ!LV$7lUcKt)uzaaYCO%tbKWbiyZK0Bz2$EpY_~`qpf>?=-hS4-(J+Y6(=l1 zE9CI`qLT`6Oh<-*gRU4==?GYsp-&B_8o$M$!$$g`2x~16G1_?+JGobd2j6Y<9`}SV zBgqx0`X&>7&r#2WdnJ{C>+eB|)E}!4Dd5#rX@~x!kit;Cae%&<qDZU<kAQP{35%%o z3!Gb6I<j?!pI6m?Q73)rgQ01C=}W$L@eHBwS02+ofM`-aO2x1f=j=c3a+gnGJ0HUM zqied#JvE`mA}xuI&%;sT#3thWl)n+mh%J0*O&7;37xn9H8gCe&OQ5X0s6r}D%JFvl zTO0g-=&@vio+b3@5a=c&6U}V+-6meXCDUqVuJD@$i(j>WF$;D5WsZDuh)3^oLG=o? zM=G3X6?AY=URf2zkT_1`dBuSdUg@105JV)5hV?_Zj8?+xJLI|8IOrQ8PGEmVp8itd zMcew`Kz-B*0hMU~ka_R#1d!EIRf6JBES5Fr<Zq5Xok+>07rcBoQ9thPZ9f=~)iFGe zMx%hsytwIq)2B<C0xS=d=KU7cB66mh+ip=TB$B^ia=>uvW?6WLatlc(muE7N25Lkv z*nfC$k*odjy_D%A7BwU)>IBjblX#975#>ZRhhD027ga_K^Y<iCju=9cYiUUb?=f1` z-}?5zFfrM@Tr{_p=d?JwMCb743vm_j6DooQvx3ck2lQgUkF?F=rHKSh6E9!lrAj#q zUzasi?t0I#bobBGvuJW~-uG|te5%f`<@d|(P5rpnJl<~}e{3EfG>;FP$Nd|u64zg< zbVayE$i145vk0l6zeoc=?D>cL{^3Xe@W4Mj^bayGa_umR>g&pUHPLZQ4vuO;U#V&g zQRGB_0WF_`cd{YaH?kF9%6yF|5MSK6!vZM46R|?D;B|8al6Nt3OX%iZJx%>JAtI~` ze|1n#>Oh4&B89gTXPT1_+AnnEMa*uNDD2!|2KFxUYrf}qy?{*O8P;XD<km9urup^% z7Wb{oZ5&IQzmJ}x2WJ&-*dR#BmVFGF<Dg}KSyGH7YbE)douD|12GAsX2%r(&4PM67 z{MdbhjhKDG^CX-3W!9}PAVA7<B5aE6uCA`G%F4{j%a<HwcU|(oC)wm$;^a)Lb8U5g zjo7CjuT3};wVRUiykcuZ+W+yotmrS&YZgi0yy8+{ak;!s>Hlgm!;Mc~wqt?}-o><k zRnQ^&)5P9zBq^xct>H)|cTO9=5HktFgGd3VVHD`6R3A}dSb#A<6USXYTb=XdKH>sd z&!o8&E-^A0kBju26GGuXF$tWy2a$$4hJ>TxjG`X#z0;nFUm_{ev4k|Y%WGb}eq;S` zEAghiv1U48Cn|0FsLh3@`Ix52^R^a$g!t#|Y_<D})@k?cudfEtldPD`(%ovDy!!2D zh>&-$4t{$!h+e*VwVDp17jNm{d_bG}BA*=-pVvHM<Z&#f$Ez8$$NDZ@%JG$>3M6TO zPQj&YJQ9_(`f@xDbOY>&Vf5PqhhC)>&5V_Al&`xeGEzfGNLqoWDckv~OpsN7E~-jS zcjDgH0}?;IzS(z9M4FTQWRfn$oH{q_#cvcFtTM6>)88KqzGf%cfPVe@Q~xVsMqhdS zubd_2=^N5IIdsH(oDQ7y{D<<(UHYFrJaoakkA!J|{;_8;@#Z^wx`Sd41?h2se#N4T z=Dg>HY#UNTn#8(se27~I;x)j3SE*?PlweL!7*A<m%R}Hdvo?@b%bd0&?cDG8aDqSP zpWoBG>$vjcHG}#pKc*iov*RsC>-M4ba2$}vE`#_{_~G^GvR~U%)E;|X7$T_EdrBDO z^_ck16l~Kyf9{@VOECSzf$2Y%KLQlO^Z;%NR>@3MIOsJFL|JupJwNY%*Z3zrO#G97 zO2BWw(cPsE;ge1UiL7^aHf$&U%*i})B$&+Zb<52;8&cNXK3{Y5(sXRd#Bc_-PfyNx zm$O+*GRB28m=s3QVH7?1_Ak5ie-s_*e&kS@9xM0=CtY%&@!|@HH%rc0@sh~>#X>%o zU8SS_4@XB|F{K{<D6}kprdLQ$7fqvT{*EM&aI%Aj*5E~@$#AoWK&%sj{d*EHKZ?F4 z&aulsqKKo^>B2XBfqrmo&vhj2BER8v&mc%ZgvrY_cUbc56*GZ-`<Vb>xG^YWimC6H zoB}b59_~Hhes~t&=ni{C?|Nij#hD0r8_gTUOw_|djkK?xya^e98Zyn;(qGW|j2PB9 zXI%|v9y+eYy*F<Up1dDLdwY*)$<}OY2lN2b38b-{_hc2-YMGVBx0aP6Q)j6rjPZJi z`fp;AH5p?j`~2Ybzy9s{)3;BN3ci}0n)Maia9L&aQQ|&zXE7*T?kwqZkGJ{7fgI*^ z&t(07i+_ZF|3mSAVFADT!%s@?!6vgi#gg9jhmxBA<<sHy-~a1>|NX!I&)@&w|NZLE zU;Y!j$RB<>+}V%N+ukP*9EgVMIj>VK>BIw4#*>}@I5O?%p>ICXtx?#>6EZGVQ@;sO zdjsqeKW{PoVj2GM%O4SgQQOal+{2L=O6^wDzhKkB*23O@Ffu+vqJM-;R(sS92tBjA zPpI#Lb@FqOc4qO3Nu<OyfH+fv;@{E%Yedq2%EWL`C8TRDBD2Xx(KintJ>2CVO!%!6 z@`T>iJ|nv1-ijU7q~PYWQMU^iSDlifB+#jb&-+nK3w4`-fp5X7!a$kStpZU@2ZO+I zDo?yaR@9Dv-CJf}=Q;8$1T~;EI4%xShWpmB)11Wzzx)g78N>>DJoUuJp0B8P?u@w| z{rzB%SPlOWgH~S+7%+jz^3r>jtEzQ1{-!3CwJUO4k_=Q>FriS3YNDwyGz!aD;$}UL z$6*@}_w+zMF(Q>=K)h|2SRJbfa^5pHZ3>Gp#9<GAS<O0?)0Eewl%1j++}|Abb)+eg z%(H)TU@1pF5Yar^{T6QpRTNjHWCRML1-NV9f?rfgHZ!kO#accLgM_)x>ACC-=h+l7 zK|M^_au)Z@`{;XMtP9@7!Qp0u5g|QKkV9{{CdZAHU-9@E42xJO^C;$Phw-k@tIV+8 z^LUMa?B*kl=r;5Rw4KAj@Nxf$jycm0<7>|8rGJW)qcezT>G%K9(q*SA*wg{HQUGt( z_L}NlsGfy8;GK@QeFvDSZL()>=!A~hAi>AGJ>t)^HNrD>vI%15f|-y+3`QUaFJ}lD zMlU3TmrvuI!C#G7OEShX2|bdhB>7(-W}(f0j9wz<+0p@Z1cnjjUSC)wuaac;q7uue z7(4{+Wf=Vg5srht7_nitxiA*rNzRs)Bzn0rFTF@+XHXs4MhKHlrH}7KJ@imacrPQk z6Q<b*4@uRb^``B2BHBlhuTD;NLkU*Zv4U4Y{ZpeAi{^f`OMjc+eWTKcvGqH^K%I<# zSK`lI*mGUnJ6(c-JjC(SDnhI!B@)#=<}~-DxDu2E0a79|>Ip&iWU~u@=TA|tW;mG) zzgUTHnXSiFPM>%R4N~8XZLZzfJk`+fRrgKuuJWx;be0%|7v_x%=d}x$O9|oj&Le{; zIDzne&n|)n{@?TZ-{*Lu)@69Asr`L_KB%2s&_l3~q?7Q{yyeolW=HZQt362lQQ#p= z3cP`ObAiMHZxw?eJ;x>+VH4u$4Z)b+7|WnzvH=OY^IdJ(^cYq<GFozljnvOeW)Ed8 zJi5ir7JS{vI@ByEo{+pqHqWPk2u+9@lM!beV$=g$2?pwO^7B)@XjA@d{mh1cQCmJV zW`m0wQq1peZfXQ;CP#Rx29TQJ&Hur}o7=Pbykmgp|KI_hubsckfAIWWwk_|iNf{?b zFktB=z2rE}tlF_wL`jO^>}A#QX(QrDV=SB6ZfBNqq!u-no&@87n@qD4kyF-P#EPJC zje%TAr&JdbbVCgdQm#{w9DtyI#E6S@$9S*sem+8pPmkSR#vJ|`Hl*^Q`!vrt?lkra zc}r)Pv4wu_#vbaPCRLPf9^r<gyCrwHd9LQSnX9|;sx9YgzV%$)j!|teSLe5xt2?pH zZRhHI%elHG*SvYIE^k9ucjMt(&ei2+bk!cLquxS+ia`X7#$$A{6n*x8Gs&d;fgox# zvA0Xf+YYI9!CPPJFZcb=ID(BAxqUL$jA;H3Sf-n`tv_g?+WGw-FfCgxRFlWw_cvhE zA<Ll;>_KRa*8)t57#i%>E%FQP44RgDC^+6Fak|ogW8wv%SX83Gf?STIgP!%UsIH`b z7wZj);N9KD&*-{$vzpO=HjV$*?gnUer&%w+m!4_H`hGVN-nSgV{B|Q~6N$GS!TD`Q z&?;zdIfBbA=D^aj_5YPEZYHD28$fdyxPbPh#@%e;_4PKth^Fa;vF^p4<$D|H4gFEn z={uBeoC6VnXMK>fbM^5#pu^V}#m3RvADGRt97PYl`8tXpeEVI0KYB)gJ^W@bis?t6 znj?r{_vfsfT;#<JLA*Dq;ATavdr8{aneA_;oi@9f-_T8~;?~m5`Py#Ub(&^3m+MEf z)!f*4i@VLunr^n4o9=G5`X~w3xZ4+X^|8(81buKOCxiosc_V}}4kDBKBmYpJ&t`}; zW`kQa&!#(Si`!~{M&MBV40}NOx%(#2e(t;rq@TNQ18;urv=6-bxzk4Q=I2g3!TYY; zZw2q8Zoe12FRE{b4PBruZcpRZlzz5!d?I?#d!0musYIejV*0-prly_swiZFwf%X~p zpzG`I`_Sua{a)Pu8}GD_YTtOLy;S?gE%(!!(~8s6tS(1?B&Y-y8g!w;L=T7G3?G@` zLklSdJ`ap^Ti1l6ZsEw+&f-UV{oyUo1Yux8Jw`I{G;bVKX}?Q!OIVAY!GqJX2IBUd z33js$B%z~HWixsdq3UKbvpFpmI>=vN8=i5yy|roQx7utQcYYg5xM}CN5|3NW`L=s~ zt2y6x^KUhO=i5rxt)^uwk-OELY$b=cnvlA1ZpnI3Yl`@c*cFrj<i12CgCw};$H&%7 zl`Iqw##uro^Ug#PaO?($KYH0Dr9f(RF9?zoH#cn^ewgkK2P012QKPNlae?FBGdTSd zpUijfAKmEo*>oh^dY;@EhOL8`|IyPi-*h@|HIl7=OpP~B#`))*3@;Eph}&>h^5%p{ z@=B3j4kgTpkr6mg%cPgTd;j*u>t_bn0mZ};LFD0r0f<SOB(s^x&N3OF1?SsYC?1RB zRHfp+Wf0)9iX_$UyYF=K45QbGO#)7x;ssQBIKF9Cq?2lPHMH4A7}!+fDwsQ@)jXy7 zWvf$v41@)m#E&0ok}-)kgM30GG)zSR6EsocY+!q(_DlY}m<O;(FM{TZuaKYlS@H@K zt$tyEPyt@Vj9&t$izF*iGlu8Wk7}}<#C3O`EV7d4QW#fS6nSCsI+ipW)D?2>1~MFu zL|iI>lJ+u9$E%Y`+&eUNCx3ep9hs=&au>jVlN#LxC=KpMr(l4(eL%nA`X!8OofbP9 z>CY{YCQFK+z6!zGRW6?%n|YK{Wu#G2L;ls9MU$Z)g1^$FB6rQKL#_}bvLBKQTI65> z2a$)ks_}ieau07HI+q$NrUn}7SClK#Xh)29%?Gb5!@^0nmg!$@#110f%0{BUB3tu+ zBTv`}8GDh1e{RP6*vP=P5dc2ilt+}>EkY+3d2v=E+D;Ou7dAK|0z8xE(q<E6FUk@k zCheGGqSmcg<9p=e4~p~+C(FyU```rtHFfX>zXu>WgSH5#Pj%SgCS(P7>LJ}4eBaup zJ`8{ujs!z`Ri*`3oUCF0>I%?oS`dnV5DOxJ_h24tS4Pt6EfB3RE!hwNnLre?L{FY3 z#ksID{xn5g*g?Xg<f)elim>!vM9G}Dxd{d&5iH2J3$Egel^AF|q6pVkNST+}SqgXy zMso1hWGlQFgATgyxKS*~5I0P>VRl~a(}i0w9()&ck+&e2>2N(f;H*e-vGf&xO;9Yo z(T0d+F|le$X?5T#gK~AW>G)dcMaaqmi3c(6k}P;*LgZtJ1=Tml>9M9(3Pn^djn>kE z$Bq=0&QO8D_~Ib*2JSh)Q$k`l(9!5%bW*Oyac{s5y<WfXAha}mskB9;GKt^MfRU2X zY*xv92}IbFq!<IuLw1Gi1B2FopIp967BX;J-UsP}JyWuPGX@a|jl6BYY7ioM)5{6R z8?X+}*nyRP<l;D=O<m`|YDd2$lPVXqbqs&WB&r$Sj>iI!OHfNP#<7-cW@3pzNZFCH zTNd^<u?V^Ov1)6grVZK=we3z+?ae#8d<v#ChOVa&C4zUE*l#yge>KW~;<1kr!VwrY zc_)=8CMjC*?pLzU7oOM>+7d*Q24>4Z0JeS1jSf3UU&<@*Kt4>BNnUZ)W|P^1T(sAm zM^68_Z`~2d6rRHWNQ<27;&F*0#wgRJOQ&u+lX1B!rV{RcvdF5{6qS*g@TNt+TpFw| z<SYh0@_AOmt;j39Q2jA~V`v!eY+U4Lsn(cl!gbXoz1>(sWcEuGl*&jaw1NyW9Lj+^ zHMw<TXPR#B`G8K)PTLrIQ?Az7I${9^ihOcQ<{o^nVfUt?98cWA9DG(H5IjcOtWUtY zbAxr^x&EN#j(mW}(#^KeI%4);Kt%4jKN%#~XEv6z`{)N~CLsEMU$$_MnnVyplYMtk zGjriMfp;-r4AFjl68Pt*x@aLW(l*5=^km%}yMhdsq06kgsWVNG8>+v{1h7ltGkk2b zD8!~;D6H>h5?c3pK4tjp8_JwNVojT$ssGZb%qxPbCb%?Q+QTXKdF`$_@LK>h3sLLZ zc(yRp%v{oz0m7Mo;V}c#L1%>s%Z*ym%sflmugi4dpK+QkenXLQ;)|qv2!Nx5eZ}&0 zJmM5^ABxvP5Ge$*uarX_p8~;0pec<Cj@yq-_MO2F*38f4a;E7UfSFO8D+^AHFmbNI zU8EO9qJT|f0O-ONhz^Z<7Z?KNjDXCk3qFj`(nPCoDpWClgIh9$Ws%OX);OBi=h_$E z9%$suq7g@J=)^>Lev1G>+EWJdqPy8PK+|5A`(BTBv;v)GMW$T5umlwCucItI)tHUc zz{;zOYkq$n*>ENWhpjsAHm2J{KF^WnZiGJb3O8tjQ<W(`DE1G~wnF@2ZSNnUw0oby zG_{irAKS-&d&1%3%`6A^qp$012u;Exn(4E~gaZbtqaj6coW2#vI;7yo^&&RmO4DF; z$?eD`F;a@&%LCG4=(wqA>Q&AO+k_8_95oMVAslxvZ0tmnok~}?C~OlvSpNX?VGYK~ zr!I!=)W<vpPv_8MG;vQ(^>oNG&C${aMfdp5w&>`8rY{d9y&D}J0e0Krq6fRZ9U0vM zFMHf|nw68Jn3l%xVijoxQnZMZT!mdLlF$VB073q-%ovYxvh!?Nr9%m0Fv6zrGN^-7 z8P~5Di)ToOZ4qOtX7e)0zVa&G4Y}~#IsjPdehUcLH6yE|!k+tmuf>J!cmOI-1KPAb z0dmlPCX4#fr*5dzmQP;;cG~=y&EQVkzUfn-HgFQ|iBSe-j166kOwCL|eNkGJtY$7Z z>|z;8<RycO%QLm<ar#$)Qn}+S>t$M&Fx;JI2%z>VHv-{ikt<%QQh8De+N#00(Mnb> zpTZ!DMpvmM!iC@tf{VAzCOo*+(!fC`vy0?^s@yTj?qSUMV<y3j?IsB@=vSrMiuuGo zuzA<;C@iJ|iyi@6gAuf^*eEHkhUTfcT}C*Hml#61FQ$8QBe{4spDdM21lM2D7SrqN z;pKrg5Re7eCm5bCWe9Ye=QciF8aY9~*)qoKyC$Oj$miw7LNFn~@}9__^!YCq$GMMx zk?$Jbup?{pVU-guJ{YU91r<5c$!Q+<J}g*So?Imh=0u^(hGT-F5Aw{1o<iW|5z7ru zw=Yb-{|+n_(7L(iO@6^$F$mo%^E(F|$@Je>Wi{l>Btz1QuYXwdoITLi32nluTHF-W zYW8tcXt$tZ8=DXnl)&(H=H@gyXn2)>R)zykh7aIM^eDt19WYqD-4R0L11aMexiE2r z@>m7WLn<CStk`3Njlgbu-ey^;sr?8g7c_-d=oZ7T`BdovxHPv$4I(B6J>k#(y}-SJ zOMwlki-^oz@0;I7^uRpsheaD~t9`pjG{o>~uc4_l4sSuJj<49Hx(4ccmM8RomB1n@ z{i-IVUi0i`Sw0kFZ)|S<lFbxT1r7u_S>*`J-LgH)wHwrX_I5H%=S8tv@(SBGA2UYP zj!DdA;<Y)))ATr5&DiYBre!X(SLVT-)J9+1m(y(i@uWzvntSt!b)A|l2kQOYAJq<V zVXN`!Fj_X=nknZFgDICO<IC}X`Wds^nO{!hmE*N{f@a8%G!yg>6Vk^%Hm=hS%r@^j zZ*fSa1q0>GkdV!m^Rzf-93!o<AxJmWVgWrj;b=Pgy!tm;1*vIU(7_LB2vgSaipCw& z`vF4r#P;A917Ti-J#PzVn~}NUa`BFl58tG#s$W-%CHcvWQ`(2mXzrGO$>fZqfo$$K z%@SS4SW5X$#xFPSGF6TuEn)@c1%+QfOHi!^|3@Cq7AU@KHH~r@{hZD+(!1#@v0H(2 z85yRkSTFKb7_$IzFLIh{i5^ZD47nnTN>2m<P`nutX@zNElxagB+5(_N)rz{BWeIIM z)fbpj;96#eDh!>oadJR^>>`kX8qy-QDCG2dtW*r=C1#QRb1lrHwzB(va}+r-bofQ- zmeMN|)7UBN@cGv(v`(|J^{*P7)ZQ7L^5^y2?}@Da2}u-<6I6B_wS7~B_!%aK)xz#K zE>fAL6&GzZzP)I=s;-97>%3CL^+XV`c(vFMd2-4MF?*ePMOMpy6O_}meQG=ju#XK9 zf$lA&nSoB`$T^ANaS*&y#vNxpmzR&m*IfFvpjSUzWpAZ&YYPE{rH4A`fGN%+g#X;X zp?#NB<pa_CY);F-MVehz3D1(0DB-Prfw8*4g>Ob^!F+hx%a}y!8yPdv(?FVe63iQ$ zv$EW@8%%ACE^2pw#MfS;q;|iB>RrJl8dF-RJwu7M-yxnvQ+`hJk7kxD;|{d=M7hj8 z&zdP4_$<95!War(<|4fS@=+uub@%a)1i+z^`QH8BAmS<_+}H4meXLWG>HA1;;CrVj zC|(=LU-JBME)IoLVunNhV}MKVSZ&^qzNf!Vp5!xlk);iPLlQ6S!(2j>-!mH{RQ=PS zv9s}M_zGIFch%J_eRrCsReXw>cv6<G0h9?i;7KAe8}Q^FTC`8?JXt<ZN?VJ~c=_2< zK=k!C&*!M};!D7GW5ugPUVG28`7PaA$nEB0^rZ1eYTRpE6w#ZxueD3#HFFEpI-$P4 zlFr8|%0110F*-;tc+O`TJi|TK8KLmv6XAGXvIBccbEAl*<^WRUP!5?{;RL>nIEqNY za7mg?QnpI5-UH(l>;Obh#3@-pMx>Uh3tiBx8}Rvf&g^u2CGW=RhR!P4l3m;K781{9 zn0#fi;*CHT43;Yw-r``boDnVEnyO+z{HnTARKwMO(i=^ALC>9{++W#Nkg8V1uU6pA z3N)u%@nG8uR(7${ut%Rx*FEBzzwze0E>^?aPPT@{a6-CnrTw5xWw$i%DCB4x?neg@ z;b8DjtX%KfE&fjV?vdFl*fh9dx5>jt!7kBlgEmQ3C8(NCm$CeMy~;??zL#Q)J$nub zZeCV@Ay)${mQJVtF44ivs+eQq5IPiA7x!4ZJ3(;#4%c2UM$!H9u_k|xq6f=M+AT9W z7SPq+Ksz6w*x#f~m%ND%SrsX;t?yCscX;?eF__==4Z%BGNAf9>Cq|=FKHUA@(yTZc zC-L_T15E#ujDNIu|9+pIJUSZaYyH8xkI-R%E90>%uj;kx<7@>iY1<<PN9^)tl?x(2 zbov3E?_}9bZ>&kD*6fze6?_5an{i>|YYS5I6UJoV3N_|60?f!&g3O8cG|wj5+Z^_N zVnFVY#8rP_e@SQOX(<c7s`8i2efA}WZD6my6Le8~^;0MrM3(z%kT2prsqj%`9fy;D zy<!>Rv3hCTuW$SoKG7wqY)P?pw$Z6cw27~e9+U4GV)%T*>}Guf8s|xKYyO<gT?a<z znCK8Yl#VV=8LA=P7ppGP^_-YG{*_IMEC(()2w9*)*-kMo*hqmmtVHlVIUL#8FB=ug zHlrPG=@AdBs*ZYGH~p}0YoGBeq9tR0hfM3;W5+v4|91eX>_>Y8t(A^nO_5RlEAk#o zxInI`&dHe9f{XLsb5X0~|Aj7vY<gdRgMYsL%l%$tN*HEbrh8lq&*jqGb*J@ueYioz z)aggW(bF%(v-HZRVjkCFb`%gYT`L1h{`z4XA*0zgl>Gf*8%nhb@{?IMIeVgi@$S}r zE>)^!f(GWx!n2CM#)sPC2;&!=cpF1R5+{eiF<Nc5$ezf>b@K{R?3&mHd*Ifa@CURD zr<ED+-wNp6F3m@h%}}v#JY!+N7H&C`?Wi%y#9zkZ61JHpa2M-We^I*LoLpqAYueR) z>YDvM8OyR{&SrBJD-l{0NJQd)xA%M!aGYx+W+bJky#>;tnbWe~f&H5|m46u4roJ7; z_r7~?aE!%P+P>$VTHz8`dJ4=ut}gdf*d4RB2aiZkc=VUSgKxiM9*4sB12zw95hdXf z5`<)HN{M?>Dj|4a;>;k2YRauE5+vd0sl*T&OQZ<yU86Cms^Ax{I?wWdRe4V#Hbn!8 zvkK;A`1R=w0yuhR+iEh9p>v~Ct&XeSO4K`+zF2oE*q*@t52>nH8C9mK*|(eo8U`*t zn8iVMRK3a2>a*UOHw|TI^gdTpnJT`W)Bum<f!aH}jsR^Gp}y*^m~^YaspTFtxs;ic znO4-R#S)3EalO}M&%W7zGUlNcTZ49y2$C1cdF@0kQhXs>$fbVpZmrnPZ*Yv%hWQxT z8OYM`v+!Zs(2LH6O-zOmgc|AlYG;o7#MSOk`@Ml12uILXr^9)+h^6;I^!@k!mVl(t zuri4Jsj%vmdLf;%RVSwola?ozVwFhED(R)_-601A_q*Y6S=TauWRb(!RxY}?CB-^1 z*vgmd+;|@^Z{x+@w)TqqZpNvb+pcw<;W?!?2Rt2Fb>&U9j;(dRZkXI~{^FLaepKH2 z5&M~)azL3HcRQ_wrUO<&3R8(0g{_)B&xV&*`Ep<!&S1FGv;ra;+o2GyPe*ywF^S^D zPd?{^=2#LeuDr~DA@28dDX}Dpz{_xW%XvC&`r1Sz@uHxFP)u&DM_>q&uBRd3^Xg^D zxid#%G9##t5D=L(^Wzfro${{>i<FYWDElB9mugYC{%)2N0ppRQjka&PC`oO?2OEl7 zH*6hobG&MA#npRZ*hooZa>|}JOhavDI(=rZqMEvWcA6f4v(KIH{+u5B?`K|uo|Ug~ z%XK+k?JwK!xGvLe=0KHX-0!yhLNDgM$f>*^@ocLlm`7bRZ*?ff=;OJk7_&&2RDn|5 zJb>8C_7HNfQzI2(3gslt<Pfzu26FqSghLPU>wC@rv5);C$Mm>I`gSF!Tze1oYS}jy z_h#XppXe-q9rGu6N~cF)X2spj#<mQ|4TN1w3N&out%O#_%sV{E1XfZf7n2ifZLr+R zM#t7$YmicqEPw}0(5@HgkLw(7)pkuZg20}yfTh$6ml9<VAB7Uo@Hh#+M48HR7?q1; zNfM~i%cLhfd-dcE_~@&5KfmFkNE}KfT~vxXKy=D~A$3ysm$Md4bSW{~5?s1SVHN=| z)(|_<d=<)|Dw0Jhh0mE6qRT~&;2|#0EmgMpsgr!6K=hizi<rbKQ&pC;45e%fDw?7| zIOi^<g@_KobPc#LTP3BF{Ya-TN=b<WZ#Ro>lZC%1BM#-Zaf|?imARwAv*baLP-LJ5 zq^9eC<V>uY5>-n?jE^P)gqGd(A^7pk(z}h(=OdD?j+Zw_ua1HU+C%yM=w4@FES~X` zM7)69HC_aH?4<QEgCF2;6Ep1L=`xHVN=Tqqh`5mHqxt2~9j%e3l?snnGXx-NFDTMe zC1<?G=g5Ju$Gw>uKuDAJEN53KUFHRZeQDBv9Q}ip3vhJNNX-x3$26GNb4l1)%BZ6f zpGfc6Ns2i_H%i4CK)Bt+Mm8c)&Xim?VXH=P+t`inkmcq{t|O8nR1mk-G+YjsS;nTC zVR=P!Ol~sWW3Df&+<KW@<`9GCjvX`(Z&O*Ib?@=hAp$PinhfE$@E>YTgfMsfhHI05 zAp8~^O%XrPt=<RG0UamrS_DBG6IdUci<DmA2=7}twmJPsfMmc4)_ie5(Ef`(jDRuC z>sez?EF6M)#!%3<9!KY{?DFGo{_z?J$Eu!1jo|?TN*wtZ;A=MPN@LMSCK^!cdt2X= zJCGo*cbtPY`YD-`_8qIxa-bPWS+3@P9J^F{1H%U}|G7wrn;yeC{wlc?5j{`Kl21Ok z>Wf7`PG_s#*Qxb%oD2N(gXz!9L~WdEJT36A3_lb5ZyRv>?V!c*aesQB^<%uiw|pGW za#B8n0e=<k4IlNb5yXwc1W5*ivBPl(ct^ATZ_4=s))Z)QEh^oA)8yH7YV-Pk_8Hv0 zKdnt+`_q5a)YXK9XArC(iR)aUe!pcn9WC2UFReUS($72|tcO=ssa3sjxH6{=uJSsc zrgf3L$PtZpGM_B@cFYfY=HF?sy!x)gKbx2GQJCYr@@adPom2S_AKYk13zJJMv))G3 zY|MPy@gcU=XIh~|U>Hp*Bc}9!`=wVqvwnVm>?iosrsN1obA`7lqX7p3&A!LP5PHd@ zo(`hgMGK>BYG3e!t^+{mMhs|CDT4e-Cas=--jH+k8X9-0L`K&@(gi2+NyY_4b9chU zHjB%hHl!^dN~3AYiMT~+0f9I;7Ho^e8gjdiE9`MbEy=4USwtQH0>4IoW?OFtxE(Uf zEsg1hLvQL<Vu6Pn(cyzms!UWB@LHl%sr(Tm)g|?gzUI)<H-}%x(p!-kLcER|j7Pw8 zZ$VjIz!Nn}z8m?r(5mt$1YnvTZ{#dtqMPMWZFJA8*hTk}sOUV9l@w!z`%f(>=SjhF zL}_VP>v1G8*jx;jRN*UsJ@^}wOs?2xSEh_SD}gPVJhIqoTg*WBnOAPPWdh_1+l$I_ zU5x(CEm^kP3GZsz`}NJ6Utd3c{r=<YgI7;`{dG-WKK<*{muSM~CEnF>@9on!zrKCX z>D&vp?Ys8<4xW@Q__jA;9|!h`t?bDriZXNJ*L3qH<L{*I-og!k;LEv<e6{T>7-VuY zz?9k!Vp}5!s94hsX{-w=FN}cO(}e34r$yfsl6MKXKs#hl%E*VTLdBMpk+xw86g!Bu zmnbRjz)U6@zm6C~<G`aCAaHg(^93B{!|08kYSbxXoHeL5Q&s{8SxV%r9h#gT#9z`9 zK3g}Y_*y~JIMZf-n%VPqe}ME*d#I5lYEHTS{V-Ke<adYqQ-8e1d1|+Pf-<*E<N`-L zm>Sj!zk)=j(pblEie!^)q(Gt^oV{8;wx*_gnx+@no5rcol*Uj<eJZYm0Ju~(S&7HY zWKVHTAn8begWL<vDG`AfGB)@NBuQmp>57PuNcV|E(r7q;1tKq#nfTNuIrt+Y&L^id zjKl<4PV#wbG5tglGb%Yv`V$F8sm*Ce<^{)HEReV(W;ugHW6g#aq$x~hX#z{MqDco` zHVkX6jEA-$zx$O;j>o6Xbcxz7Kt1%!kn>i<zlI8-*nV~RUY6D>SkiBxW93C~Z`g!R z>*91ueV`71X1}GZHF7zz^gO0jDe1?&T8d3vY6O*lBIbFtqYG{6B05PIX^~AFX-Q%* z+y6DVhO?XyX9eR0=X#s)tLh?~q^+wT%JSAUvpbzdbV5Ah*GVl6oieB6cp?uwLndYf z;8><;aUpAO_0TfO^eP>2AkBy{z=9!-7(>J@$udoU&Pt3!clT)`dza1FYyvWy65tCM z3==j7&%4=748YSp2diS`l)qWMc~W~I7I{DN2}=<zKRo>I{^8-?&i9W;M_<kb-ZD6{ zUPOMHGj1VRlP>?c_3eXgoQXRWco@fLOh__D$vq}Ha^);Dsc|$$m~nKVavwWk$!#^! z7(zYNl1<tiMH%FZ*-SLf+)?f$*Nl~G7|F;?WM}g9c%I#Tf6woE-sAf|&-eWYK64F+ zN3Tx>`7Op2mDoaYu3`J@2J&x#6~><cjEm!2OeED(6o-rs#t~F2fjUL=f7*ySR0hs% z4~`44eU^L*OvfNOs`6G!E|jhj+f5JJjQ1djxqr;laqnJF5Oi8kH}ac;ZBM85yWuOK zG@aiW=OkNiWWKAE?nL%65MGxA?ujmY(4IzO=$f$!4Fh-;AIkUZiM^9O2|21IH7q>B zpeqq0o;DMsOW-TU=^xj+97tL^i&t}w3+RF6CaHfLd{Aczn}M@lbqE?hn!S*>{;6+3 z^KO6vw*L#iMHwn&Adk%l|HJb3@sY0aIaznkTawBHugp`;ehr1AhYGV4y(4Mz^LP10 z?9CMl?WI?b=f9>|hqjjkU1&oz^&7U-H<pqL3vQ{|K?IydaCw`g<CiFVBP1z$-Fd@j zOrxx0a%D<ex~ZDvPi9D`mQ42Rlc?8Tr;I@u85@0xQK6cT%jhd|47o*B09|`!x>y*c z!RP0y90VlYQOBA)=GvMqWLe{(`s>MEK3C5k+2r8-4lScdzDu#!Q2yi8e&rBFbOea< zAjg8hacB#*@XxKoyfeQj`2;17kDsCYwYLVe;O)M(BWRW2qZfSSf`2&^cT|f**<u+> zwhQInO6_h&>SEkgz-Z}ZPL_~hA1Y=BlOGe}PA+xWkaW!@-vcV%CmJrr5`8n1lE+^g zZCe50Hs1|T_)<mLqTMZ%x3#im^_bZ>BLe>b>GJ9uAITN-k6}e6+fPG_7SB>yC#PLB zJo_UZe9`GeV9`MS)#TvTZk9n*t@7u-Yy`Z@j-pyst?!iujNA(L-)b*9C3N$Y-X=3C zi5YRlUqA;9av^*5X4FrL;IE%!Kl0Lvo=qlRd6hGNTK_&}{#D~!Ai^^9Sh@zVnK0{y z7<Rl#tQZPx#`dN=OWjHJmFb+VxQp(ISmHnVd}2bYB1@h1(q6#40?jxP9ew}1LSC-Z z`Ag`;@|#Ij;RhO-!wZT)@8rbn^Mnh+!QZm<|Dv=mRE<1;UuM*8Z<y<P)}&Y#(r219 z2Sw?i08S&A9FUi5v5MFE1+fbCCIYR=V$xzl#5<7ubZx9b8MpAVo#COHMXm-&<j}va zF*oT6r$>aE+eeRiHDXcqr4k@FwIBg4cNYkmKEMa~wP=5Z3xGWG6>@5vUY=_DTdf33 zA}=0*2vzdNgWuX9DN@rg*a`W^=L%s>_mYkU3H&W@CsGQRxyN^=mF}!g=zfwhaiP*| zQX?J$K!es(k3mex9*fh|@J3H+fqPi<no^lwz5xZ`*ts{j<@P~uN^dV;$IH8xRNd}1 zHJpKgnQ+0u;^AioZJG_>JBN|3pARXnrc4NeutFJ)(+s8M!qd2;u_w*OYG`Ih5|Ezt zD7FgIgx+~Mx4_!a)25Ulu~HL$OYD)wllMCL?5p$p^6-Kei@Eu#eptUwJ4djiULYzo zF$@u%m$*$jth60AibHN_x)??W<Sl2y6A&89c;q0|;4#a>a~i5^6<!xPKCmJOUs%c_ zR^vTBRKEd3_l%lHZ{en1i<@*X3lj>O+wig{odY8^;IJzVgn2sY%mI->|Bpsukcxcc z^viHohNg50wRW?%x29)Ls1yGuwp=tc#eWJKazK+4f%I_H-*}%Qc9l6Oq9`s>89u&Q zuAzh8j$+ypIDMjpL(Le6JrQh<Xblr9`{hNiq8t0+n$`B1MOZee@_Ee`31&0ToSdlL zoP|Yn1&#?@e^^L#>4{;)Z;Pf8F>+j-iq;O?LYrI4h>37v7e5=8T+WJi+CHq@!-)-` zbet2m$_WdUdEx(mNEYrI0LcAhA}`wowAf*QeDa`Ol*_-t8a(yR9+3-p`7dVUq1Xmc zUW%vU1q85Vx@@-VkT;c6=6T);-dr5LJO6RPj)gQZRto%62LL=H8l!)lC1Ho*7vS~z NxlfC0C3c19=O2^W28I9t diff --git a/src/packages/mudlet-base-ui/mudlet-base-ui.xml b/src/packages/mudlet-base-ui/mudlet-base-ui.xml index 74401d37d..e7527037b 100644 --- a/src/packages/mudlet-base-ui/mudlet-base-ui.xml +++ b/src/packages/mudlet-base-ui/mudlet-base-ui.xml @@ -1,7 +1,370 @@ <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE MudletPackage> <MudletPackage version="1.001"> - <TriggerPackage /> + <TriggerPackage> + <TriggerGroup isActive="no" isFolder="yes" isTempTrigger="no" isMultiline="no" isPerlSlashGOption="no" isColorizerTrigger="no" isFilterTrigger="no" isSoundTrigger="no" isColorTrigger="no" isColorTriggerFg="no" isColorTriggerBg="no"> + <name>Mudlet base UI chat capture</name> + <script>-- A gate, then the shapes - the pattern to copy for triggers that have to +-- watch every line. Each gate matches substrings, no regex engine, and Mudlet +-- only offers a line to a trigger's children once its own pattern matched. A +-- trigger with no pattern, like this folder, passes everything through. +-- +-- Substring patterns are case-sensitive, so every literal a child's regex +-- needs must appear in its gate's pattern list, spelled the same way. Miss +-- that and the child silently never sees a line. +-- +-- It is also why the gates spell out "says" and "You say" rather than the +-- "say" they share: a gate hit costs a capture list and a script call before +-- any child regex runs, and "say" would hand all that to every "essay". +-- The channel gate cannot be narrowed like that, since a bare "[", "(" or +-- "<" is all a tagged line has in common. +-- +-- This folder ships inactive and is the only thing the "Mudlet base UI" +-- script switches: it enables the folder on load and disables it again when +-- the game turns out to send its chat over GMCP. Nothing reaches a gate while +-- the folder is off, so one switch retires the whole layer.</script> + <triggerType>0</triggerType> + <conditonLineDelta>0</conditonLineDelta> + <mStayOpen>0</mStayOpen> + <mCommand></mCommand> + <packageName></packageName> + <mFgColor>#ff0000</mFgColor> + <mBgColor>#ffff00</mBgColor> + <mSoundFile></mSoundFile> + <colorTriggerFgColor>#000000</colorTriggerFgColor> + <colorTriggerBgColor>#000000</colorTriggerBgColor> + <regexCodeList /> + <regexCodePropertyList /> + <Trigger isActive="yes" isFolder="no" isTempTrigger="no" isMultiline="no" isPerlSlashGOption="no" isColorizerTrigger="no" isFilterTrigger="no" isSoundTrigger="no" isColorTrigger="no" isColorTriggerFg="no" isColorTriggerBg="no"> + <name>BaseUI chat: tells</name> + <script></script> + <triggerType>0</triggerType> + <conditonLineDelta>0</conditonLineDelta> + <mStayOpen>0</mStayOpen> + <mCommand></mCommand> + <packageName></packageName> + <mFgColor>#ff0000</mFgColor> + <mBgColor>#ffff00</mBgColor> + <mSoundFile></mSoundFile> + <colorTriggerFgColor>#000000</colorTriggerFgColor> + <colorTriggerBgColor>#000000</colorTriggerBgColor> + <regexCodeList> + <string>tells you</string> + <string>tells the</string> + <string>You tell</string> + <string>whispers to you</string> + </regexCodeList> + <regexCodePropertyList> + <integer>0</integer> + <integer>0</integer> + <integer>0</integer> + <integer>0</integer> + </regexCodePropertyList> + <Trigger isActive="yes" isFolder="no" isTempTrigger="no" isMultiline="no" isPerlSlashGOption="no" isColorizerTrigger="no" isFilterTrigger="no" isSoundTrigger="no" isColorTrigger="no" isColorTriggerFg="no" isColorTriggerBg="no"> + <name>someone tells you</name> + <script>BaseUI.routeChatLine("tells")</script> + <triggerType>1</triggerType> + <conditonLineDelta>0</conditonLineDelta> + <mStayOpen>0</mStayOpen> + <mCommand></mCommand> + <packageName></packageName> + <mFgColor>#ff0000</mFgColor> + <mBgColor>#ffff00</mBgColor> + <mSoundFile></mSoundFile> + <colorTriggerFgColor>#000000</colorTriggerFgColor> + <colorTriggerBgColor>#000000</colorTriggerBgColor> + <regexCodeList> + <string>^\w[\w'-]* tells you\b[^,:]{0,30}(?::|,?\s*['"])</string> + </regexCodeList> + <regexCodePropertyList> + <integer>1</integer> + </regexCodePropertyList> + </Trigger> + <Trigger isActive="yes" isFolder="no" isTempTrigger="no" isMultiline="no" isPerlSlashGOption="no" isColorizerTrigger="no" isFilterTrigger="no" isSoundTrigger="no" isColorTrigger="no" isColorTriggerFg="no" isColorTriggerBg="no"> + <name>you tell someone</name> + <script>BaseUI.routeChatLine("tells")</script> + <triggerType>1</triggerType> + <conditonLineDelta>0</conditonLineDelta> + <mStayOpen>0</mStayOpen> + <mCommand></mCommand> + <packageName></packageName> + <mFgColor>#ff0000</mFgColor> + <mBgColor>#ffff00</mBgColor> + <mSoundFile></mSoundFile> + <colorTriggerFgColor>#000000</colorTriggerFgColor> + <colorTriggerBgColor>#000000</colorTriggerBgColor> + <regexCodeList> + <string>^You tell [\w'-]+[^,:]{0,30}(?::|,?\s*['"])</string> + </regexCodeList> + <regexCodePropertyList> + <integer>1</integer> + </regexCodePropertyList> + </Trigger> + <Trigger isActive="yes" isFolder="no" isTempTrigger="no" isMultiline="no" isPerlSlashGOption="no" isColorizerTrigger="no" isFilterTrigger="no" isSoundTrigger="no" isColorTrigger="no" isColorTriggerFg="no" isColorTriggerBg="no"> + <name>you tell the group</name> + <script>BaseUI.routeChatLine("tells")</script> + <triggerType>1</triggerType> + <conditonLineDelta>0</conditonLineDelta> + <mStayOpen>0</mStayOpen> + <mCommand></mCommand> + <packageName></packageName> + <mFgColor>#ff0000</mFgColor> + <mBgColor>#ffff00</mBgColor> + <mSoundFile></mSoundFile> + <colorTriggerFgColor>#000000</colorTriggerFgColor> + <colorTriggerBgColor>#000000</colorTriggerBgColor> + <regexCodeList> + <string>^You tell the (?:group|formation)\b</string> + </regexCodeList> + <regexCodePropertyList> + <integer>1</integer> + </regexCodePropertyList> + </Trigger> + <Trigger isActive="yes" isFolder="no" isTempTrigger="no" isMultiline="no" isPerlSlashGOption="no" isColorizerTrigger="no" isFilterTrigger="no" isSoundTrigger="no" isColorTrigger="no" isColorTriggerFg="no" isColorTriggerBg="no"> + <name>someone whispers to you</name> + <script>BaseUI.routeChatLine("tells")</script> + <triggerType>1</triggerType> + <conditonLineDelta>0</conditonLineDelta> + <mStayOpen>0</mStayOpen> + <mCommand></mCommand> + <packageName></packageName> + <mFgColor>#ff0000</mFgColor> + <mBgColor>#ffff00</mBgColor> + <mSoundFile></mSoundFile> + <colorTriggerFgColor>#000000</colorTriggerFgColor> + <colorTriggerBgColor>#000000</colorTriggerBgColor> + <regexCodeList> + <string>^\w[\w'-]* whispers to you\b[^,:]{0,30}(?::|,?\s*['"])</string> + </regexCodeList> + <regexCodePropertyList> + <integer>1</integer> + </regexCodePropertyList> + </Trigger> + <Trigger isActive="yes" isFolder="no" isTempTrigger="no" isMultiline="no" isPerlSlashGOption="no" isColorizerTrigger="no" isFilterTrigger="no" isSoundTrigger="no" isColorTrigger="no" isColorTriggerFg="no" isColorTriggerBg="no"> + <name>someone tells the group</name> + <script>BaseUI.routeChatLine("tells")</script> + <triggerType>1</triggerType> + <conditonLineDelta>0</conditonLineDelta> + <mStayOpen>0</mStayOpen> + <mCommand></mCommand> + <packageName></packageName> + <mFgColor>#ff0000</mFgColor> + <mBgColor>#ffff00</mBgColor> + <mSoundFile></mSoundFile> + <colorTriggerFgColor>#000000</colorTriggerFgColor> + <colorTriggerBgColor>#000000</colorTriggerBgColor> + <regexCodeList> + <string>^\w[\w'-]* tells the (?:group|formation)\b</string> + </regexCodeList> + <regexCodePropertyList> + <integer>1</integer> + </regexCodePropertyList> + </Trigger> + </Trigger> + <Trigger isActive="yes" isFolder="no" isTempTrigger="no" isMultiline="no" isPerlSlashGOption="no" isColorizerTrigger="no" isFilterTrigger="no" isSoundTrigger="no" isColorTrigger="no" isColorTriggerFg="no" isColorTriggerBg="no"> + <name>BaseUI chat: speech</name> + <script></script> + <triggerType>0</triggerType> + <conditonLineDelta>0</conditonLineDelta> + <mStayOpen>0</mStayOpen> + <mCommand></mCommand> + <packageName></packageName> + <mFgColor>#ff0000</mFgColor> + <mBgColor>#ffff00</mBgColor> + <mSoundFile></mSoundFile> + <colorTriggerFgColor>#000000</colorTriggerFgColor> + <colorTriggerBgColor>#000000</colorTriggerBgColor> + <regexCodeList> + <string>says</string> + <string>asks</string> + <string>exclaims</string> + <string>yells</string> + <string>shouts</string> + <string>You say</string> + <string>You ask</string> + <string>You exclaim</string> + <string>You yell</string> + <string>You shout</string> + </regexCodeList> + <regexCodePropertyList> + <integer>0</integer> + <integer>0</integer> + <integer>0</integer> + <integer>0</integer> + <integer>0</integer> + <integer>0</integer> + <integer>0</integer> + <integer>0</integer> + <integer>0</integer> + <integer>0</integer> + </regexCodePropertyList> + <Trigger isActive="yes" isFolder="no" isTempTrigger="no" isMultiline="no" isPerlSlashGOption="no" isColorizerTrigger="no" isFilterTrigger="no" isSoundTrigger="no" isColorTrigger="no" isColorTriggerFg="no" isColorTriggerBg="no"> + <name>someone says</name> + <script>BaseUI.routeChatLine()</script> + <triggerType>1</triggerType> + <conditonLineDelta>0</conditonLineDelta> + <mStayOpen>0</mStayOpen> + <mCommand></mCommand> + <packageName></packageName> + <mFgColor>#ff0000</mFgColor> + <mBgColor>#ffff00</mBgColor> + <mSoundFile></mSoundFile> + <colorTriggerFgColor>#000000</colorTriggerFgColor> + <colorTriggerBgColor>#000000</colorTriggerBgColor> + <regexCodeList> + <string>^\w[\w'-]* (?:says|asks|exclaims)[^,:]{0,20},?\s*['"]</string> + </regexCodeList> + <regexCodePropertyList> + <integer>1</integer> + </regexCodePropertyList> + </Trigger> + <Trigger isActive="yes" isFolder="no" isTempTrigger="no" isMultiline="no" isPerlSlashGOption="no" isColorizerTrigger="no" isFilterTrigger="no" isSoundTrigger="no" isColorTrigger="no" isColorTriggerFg="no" isColorTriggerBg="no"> + <name>you say</name> + <script>BaseUI.routeChatLine()</script> + <triggerType>1</triggerType> + <conditonLineDelta>0</conditonLineDelta> + <mStayOpen>0</mStayOpen> + <mCommand></mCommand> + <packageName></packageName> + <mFgColor>#ff0000</mFgColor> + <mBgColor>#ffff00</mBgColor> + <mSoundFile></mSoundFile> + <colorTriggerFgColor>#000000</colorTriggerFgColor> + <colorTriggerBgColor>#000000</colorTriggerBgColor> + <regexCodeList> + <string>^You (?:say|ask|exclaim)[^,:]{0,20},?\s*['"]</string> + </regexCodeList> + <regexCodePropertyList> + <integer>1</integer> + </regexCodePropertyList> + </Trigger> + <Trigger isActive="yes" isFolder="no" isTempTrigger="no" isMultiline="no" isPerlSlashGOption="no" isColorizerTrigger="no" isFilterTrigger="no" isSoundTrigger="no" isColorTrigger="no" isColorTriggerFg="no" isColorTriggerBg="no"> + <name>someone yells</name> + <script>BaseUI.routeChatLine()</script> + <triggerType>1</triggerType> + <conditonLineDelta>0</conditonLineDelta> + <mStayOpen>0</mStayOpen> + <mCommand></mCommand> + <packageName></packageName> + <mFgColor>#ff0000</mFgColor> + <mBgColor>#ffff00</mBgColor> + <mSoundFile></mSoundFile> + <colorTriggerFgColor>#000000</colorTriggerFgColor> + <colorTriggerBgColor>#000000</colorTriggerBgColor> + <regexCodeList> + <string>^\w[\w'-]* (?:yells|shouts)[^,:]{0,20},?\s*['"]</string> + </regexCodeList> + <regexCodePropertyList> + <integer>1</integer> + </regexCodePropertyList> + </Trigger> + <Trigger isActive="yes" isFolder="no" isTempTrigger="no" isMultiline="no" isPerlSlashGOption="no" isColorizerTrigger="no" isFilterTrigger="no" isSoundTrigger="no" isColorTrigger="no" isColorTriggerFg="no" isColorTriggerBg="no"> + <name>you yell</name> + <script>BaseUI.routeChatLine()</script> + <triggerType>1</triggerType> + <conditonLineDelta>0</conditonLineDelta> + <mStayOpen>0</mStayOpen> + <mCommand></mCommand> + <packageName></packageName> + <mFgColor>#ff0000</mFgColor> + <mBgColor>#ffff00</mBgColor> + <mSoundFile></mSoundFile> + <colorTriggerFgColor>#000000</colorTriggerFgColor> + <colorTriggerBgColor>#000000</colorTriggerBgColor> + <regexCodeList> + <string>^You (?:yell|shout)[^,:]{0,20},?\s*['"]</string> + </regexCodeList> + <regexCodePropertyList> + <integer>1</integer> + </regexCodePropertyList> + </Trigger> + </Trigger> + <Trigger isActive="yes" isFolder="no" isTempTrigger="no" isMultiline="no" isPerlSlashGOption="no" isColorizerTrigger="no" isFilterTrigger="no" isSoundTrigger="no" isColorTrigger="no" isColorTriggerFg="no" isColorTriggerBg="no"> + <name>BaseUI chat: channel tags</name> + <script></script> + <triggerType>2</triggerType> + <conditonLineDelta>0</conditonLineDelta> + <mStayOpen>0</mStayOpen> + <mCommand></mCommand> + <packageName></packageName> + <mFgColor>#ff0000</mFgColor> + <mBgColor>#ffff00</mBgColor> + <mSoundFile></mSoundFile> + <colorTriggerFgColor>#000000</colorTriggerFgColor> + <colorTriggerBgColor>#000000</colorTriggerBgColor> + <regexCodeList> + <string>[</string> + <string>(</string> + <string><</string> + </regexCodeList> + <regexCodePropertyList> + <integer>2</integer> + <integer>2</integer> + <integer>2</integer> + </regexCodePropertyList> + <Trigger isActive="yes" isFolder="no" isTempTrigger="no" isMultiline="no" isPerlSlashGOption="no" isColorizerTrigger="no" isFilterTrigger="no" isSoundTrigger="no" isColorTrigger="no" isColorTriggerFg="no" isColorTriggerBg="no"> + <name>[tag] channel line</name> + <script>BaseUI.routeTaggedChatLine(matches[2])</script> + <triggerType>1</triggerType> + <conditonLineDelta>0</conditonLineDelta> + <mStayOpen>0</mStayOpen> + <mCommand></mCommand> + <packageName></packageName> + <mFgColor>#ff0000</mFgColor> + <mBgColor>#ffff00</mBgColor> + <mSoundFile></mSoundFile> + <colorTriggerFgColor>#000000</colorTriggerFgColor> + <colorTriggerBgColor>#000000</colorTriggerBgColor> + <regexCodeList> + <string>^\[([\w][\w -]{0,18})\]</string> + </regexCodeList> + <regexCodePropertyList> + <integer>1</integer> + </regexCodePropertyList> + </Trigger> + <Trigger isActive="yes" isFolder="no" isTempTrigger="no" isMultiline="no" isPerlSlashGOption="no" isColorizerTrigger="no" isFilterTrigger="no" isSoundTrigger="no" isColorTrigger="no" isColorTriggerFg="no" isColorTriggerBg="no"> + <name>(tag) channel line</name> + <script>BaseUI.routeTaggedChatLine(matches[2])</script> + <triggerType>1</triggerType> + <conditonLineDelta>0</conditonLineDelta> + <mStayOpen>0</mStayOpen> + <mCommand></mCommand> + <packageName></packageName> + <mFgColor>#ff0000</mFgColor> + <mBgColor>#ffff00</mBgColor> + <mSoundFile></mSoundFile> + <colorTriggerFgColor>#000000</colorTriggerFgColor> + <colorTriggerBgColor>#000000</colorTriggerBgColor> + <regexCodeList> + <string>^\(([\w -]{1,18})\)[:\s]</string> + </regexCodeList> + <regexCodePropertyList> + <integer>1</integer> + </regexCodePropertyList> + </Trigger> + <Trigger isActive="yes" isFolder="no" isTempTrigger="no" isMultiline="no" isPerlSlashGOption="no" isColorizerTrigger="no" isFilterTrigger="no" isSoundTrigger="no" isColorTrigger="no" isColorTriggerFg="no" isColorTriggerBg="no"> + <name>< tag | channel line</name> + <script>BaseUI.routeTaggedChatLine(matches[2])</script> + <triggerType>1</triggerType> + <conditonLineDelta>0</conditonLineDelta> + <mStayOpen>0</mStayOpen> + <mCommand></mCommand> + <packageName></packageName> + <mFgColor>#ff0000</mFgColor> + <mBgColor>#ffff00</mBgColor> + <mSoundFile></mSoundFile> + <colorTriggerFgColor>#000000</colorTriggerFgColor> + <colorTriggerBgColor>#000000</colorTriggerBgColor> + <regexCodeList> + <string>^< ?([\w -]{1,18}) ?\|</string> + </regexCodeList> + <regexCodePropertyList> + <integer>1</integer> + </regexCodePropertyList> + </Trigger> + </Trigger> + </TriggerGroup> + </TriggerPackage> <TimerPackage /> <AliasPackage> <Alias isActive="yes" isFolder="no"> @@ -37,7 +400,6 @@ BaseUI = BaseUI or {} BaseUI.gauges = BaseUI.gauges or {} BaseUI.usedGaugeSlots = BaseUI.usedGaugeSlots or 0 -BaseUI.chatTriggerIds = BaseUI.chatTriggerIds or {} BaseUI.recentCaptures = BaseUI.recentCaptures or {} BaseUI.vitalsTriggerIds = BaseUI.vitalsTriggerIds or {} BaseUI.shapeSightings = BaseUI.shapeSightings or {} @@ -221,14 +583,17 @@ BaseUI.chatChannelNames = { yell = true, form = true, town = true, } --- entries with tagged = true capture a channel tag that must pass the list --- above; family routes a line into the Tells or Channels tab as well as All +-- The same shapes as the "Mudlet base UI chat capture" trigger tree, in the +-- same order (StarterUiTriggerCostTest compares them index by index): the tree +-- routes chat, this copy tells the vitals layer which lines are conversation. +-- tagged = true means the shape captures a channel tag that must pass the +-- list above. local chatPatterns = { - { regex = [=[^\w[\w'-]* tells you\b[^,:]{0,30}(?::|,?\s*['"])]=], family = "tells" }, - { regex = [=[^You tell [\w'-]+[^,:]{0,30}(?::|,?\s*['"])]=], family = "tells" }, - { regex = [=[^You tell the (?:group|formation)\b]=], family = "tells" }, - { regex = [=[^\w[\w'-]* whispers to you\b[^,:]{0,30}(?::|,?\s*['"])]=], family = "tells" }, - { regex = [=[^\w[\w'-]* tells the (?:group|formation)\b]=], family = "tells" }, + { regex = [=[^\w[\w'-]* tells you\b[^,:]{0,30}(?::|,?\s*['"])]=] }, + { regex = [=[^You tell [\w'-]+[^,:]{0,30}(?::|,?\s*['"])]=] }, + { regex = [=[^You tell the (?:group|formation)\b]=] }, + { regex = [=[^\w[\w'-]* whispers to you\b[^,:]{0,30}(?::|,?\s*['"])]=] }, + { regex = [=[^\w[\w'-]* tells the (?:group|formation)\b]=] }, { regex = [=[^\w[\w'-]* (?:says|asks|exclaims)[^,:]{0,20},?\s*['"]]=] }, { regex = [=[^You (?:say|ask|exclaim)[^,:]{0,20},?\s*['"]]=] }, { regex = [=[^\w[\w'-]* (?:yells|shouts)[^,:]{0,20},?\s*['"]]=] }, @@ -245,9 +610,7 @@ local chatTabs = { } function BaseUI.routeChatLine(family) - -- gmcpChat means the trigger layer is retired: killing a trigger does not - -- stop it firing on lines from the batch already being processed - -- several patterns can match the same line - copy it only once + -- several shapes can match the same line - copy it only once if BaseUI.gmcpChat or BaseUI.dormant() or getLineNumber() == BaseUI.lastChatLine then return end @@ -278,15 +641,8 @@ function BaseUI.routeChatLine(family) end end -function BaseUI.routeTaggedChatLine() - -- one trigger, three branches: only the matching branch's group is set - local tag - for i = 2, #matches do - tag = type(matches[i]) == "string" and matches[i]:match("(%S+)") - if tag then - break - end - end +function BaseUI.routeTaggedChatLine(tag) + tag = type(tag) == "string" and tag:match("(%S+)") if not tag then return end @@ -298,58 +654,80 @@ function BaseUI.routeTaggedChatLine() BaseUI.routeChatLine(family) end --- a group is armed at the position of its FIRST shape, so reordering --- chatPatterns across families changes which group wins a line both can match -local function chatGroupOf(pattern) - if pattern.tagged then - return "tagged" - end - return pattern.family or "plain" +-- renaming these in the trigger tree means renaming them here +local chatTree = "Mudlet base UI chat capture" +local chatGates = { "BaseUI chat: tells", "BaseUI chat: speech", "BaseUI chat: channel tags" } + +-- a gate reached through a switched-off folder is not armed whatever its own +-- flag says, and enableTrigger() only reports that it found the name - hence +-- the ancestor check +local function gateArmed(gate) + return isActive(gate, "trigger", true) > 0 end --- Folding shapes into one alternation is only cheap while every one of them is --- ^-anchored: trigger regexes compile without PCRE2_MULTILINE, so PCRE tries --- the union at offset 0 and gives up. An unanchored shape added here would be --- retried at every offset in the line - give it its own trigger, or a prefilter --- like the vitals shapes have. -function BaseUI.chatTriggerPatterns() - local order, grouped = {}, {} - for _, pattern in ipairs(chatPatterns) do - local group = chatGroupOf(pattern) - if not grouped[group] then - grouped[group] = {} - order[#order + 1] = group - end - table.insert(grouped[group], "(?:" .. pattern.regex .. ")") - end - local patterns = {} - for _, group in ipairs(order) do - table.insert(patterns, { group = group, regex = table.concat(grouped[group], "|") }) - end - return patterns +-- enableTrigger and disableTrigger can only name a trigger, and a name is not +-- unique: copying this tree in the editor reproduces every name exactly, so +-- switching ours would switch the player's copy too. Only the folder is ever +-- named here, which keeps a copied gate out of it, and when the folder name +-- itself is shared the layer stops switching altogether - routeChatLine() +-- re-checks gmcpChat and dormant() on every line, so what is captured stays +-- right either way. All that is lost is the scans disarming would have saved. +function BaseUI.chatTreeShared() + return exists(chatTree, "trigger") ~= 1 end -function BaseUI.createChatTriggers() - if BaseUI.dormant() or BaseUI.gmcpChat or next(BaseUI.chatTriggerIds) then +function BaseUI.armChatTriggers() + if BaseUI.dormant() or BaseUI.gmcpChat then return end - for _, pattern in ipairs(BaseUI.chatTriggerPatterns()) do - local handler - if pattern.group == "tagged" then - handler = BaseUI.routeTaggedChatLine - else - local family = pattern.group ~= "plain" and pattern.group or nil - handler = function() BaseUI.routeChatLine(family) end + if BaseUI.chatTreeShared() then + BaseUI.reportSharedChatTree() + return + end + enableTrigger(chatTree) + for _, gate in ipairs(chatGates) do + if not gateArmed(gate) then + BaseUI.reportDeadChatGate(gate) end - table.insert(BaseUI.chatTriggerIds, tempRegexTrigger(pattern.regex, handler)) end end -function BaseUI.killChatTriggers() - for _, id in ipairs(BaseUI.chatTriggerIds) do - killTrigger(id) +function BaseUI.reportSharedChatTree() + if BaseUI.warnedSharedChatTree then + return end - BaseUI.chatTriggerIds = {} + BaseUI.warnedSharedChatTree = true + debugc("[ Mudlet UI ] more than one trigger is called \"" .. chatTree .. "\", so the chat capture is left switched on rather than risk switching yours") +end + +-- debugc alone would not do: it writes to the editor's error console, which is +-- hidden until the player goes looking for it, and is dropped entirely if the +-- editor was never opened. The player-facing line is once per session, because +-- arming runs again on every reconnect. +function BaseUI.reportDeadChatGate(gate) + debugc("[ Mudlet UI ] chat capture gate \"" .. gate .. "\" did not come up, so those lines will not be captured") + if BaseUI.warnedDeadChatGate then + return + end + BaseUI.warnedDeadChatGate = true + cecho("\n<dim_grey>[ Mudlet UI ] Part of the chat capture is switched off, so some chat may not appear here - type <yellow>baseui<dim_grey> for options.<reset>\n") +end + +function BaseUI.disarmChatTriggers() + if BaseUI.chatTreeShared() then + BaseUI.reportSharedChatTree() + return + end + disableTrigger(chatTree) +end + +function BaseUI.chatTriggersArmed() + for _, gate in ipairs(chatGates) do + if not gateArmed(gate) then + return false + end + end + return true end -- vitals from plain text, for games that offer no protocol at all. Only @@ -620,6 +998,16 @@ function BaseUI.vitalsShapeCount() return #vitalsLinePatterns end +-- for the test suite: the shapes chatLikeLine() walks, so a corpus can be held +-- to cover them all +function BaseUI.chatShapeRegexes() + local regexes = {} + for _, pattern in ipairs(chatPatterns) do + regexes[#regexes + 1] = pattern.regex + end + return regexes +end + -- for the test suite: the fallback above still works, so only an explicit check -- notices a shape that fell back to per-line compilation function BaseUI.shapesArePrecompiled() @@ -834,7 +1222,7 @@ end function BaseUI.standAside(_, packageName) BaseUI.settings.standingAside = packageName or "the game's interface" BaseUI.saveSettings() - BaseUI.killChatTriggers() + BaseUI.disarmChatTriggers() BaseUI.killVitalsTriggers() if BaseUI.container then BaseUI.container:hide() @@ -856,7 +1244,7 @@ function BaseUI.serverGuiRemoved(_, packageName) end BaseUI.settings.standingAside = nil BaseUI.saveSettings() - BaseUI.createChatTriggers() + BaseUI.armChatTriggers() BaseUI.createVitalsTriggers() BaseUI.renderVitals() end) @@ -1247,7 +1635,7 @@ function BaseUI.handleDisconnect() -- first GMCP chat message will retire them again, and the recentCaptures -- ring already covers the echo race that comes with that) BaseUI.gmcpChat = false - BaseUI.createChatTriggers() + BaseUI.armChatTriggers() -- only re-arms because the lock was cleared above BaseUI.createVitalsTriggers() end @@ -1260,7 +1648,7 @@ function BaseUI.addChatMessage() -- the game sends chat over GMCP and usually echoes it as plain text too - -- retire the generic triggers for this session so lines are not captured twice BaseUI.gmcpChat = true - BaseUI.killChatTriggers() + BaseUI.disarmChatTriggers() if BaseUI.dormant() then return end @@ -1325,7 +1713,7 @@ end function BaseUI.hide() BaseUI.settings.hidden = true BaseUI.saveSettings() - BaseUI.killChatTriggers() + BaseUI.disarmChatTriggers() BaseUI.killVitalsTriggers() if BaseUI.container then BaseUI.container:hide() @@ -1346,7 +1734,7 @@ function BaseUI.show() end BaseUI.updateVitals() BaseUI.updateMsdpVitals() - BaseUI.createChatTriggers() + BaseUI.armChatTriggers() BaseUI.createVitalsTriggers() BaseUI.renderVitals() if BaseUI.container then @@ -1385,11 +1773,12 @@ function BaseUI.alias(input) end BaseUI.loadSettings() --- the chat triggers exist from the start (unless the UI is hidden) so the --- interface can appear on the first chat line even on games without GMCP; --- the vitals triggers come second so a chat line is routed (and marked as --- chat) before the vitals layer gets a look at it -BaseUI.createChatTriggers() +-- the chat gates are live from the start (unless the UI is dormant) so the +-- interface can appear on the first chat line even on games without GMCP. +-- Their tree is imported ahead of this script, and the vitals trigger is +-- created after it, so a chat line is routed (and marked as chat) before the +-- vitals layer gets a look at it +BaseUI.armChatTriggers() BaseUI.createVitalsTriggers() -- negotiate MSDP up front: it costs nothing on servers without it and gives -- gauges to games that have it but lack GMCP diff --git a/test/functional_tests/StarterUiTriggerCostTest.cpp b/test/functional_tests/StarterUiTriggerCostTest.cpp index cdf343de2..017e3c2fe 100644 --- a/test/functional_tests/StarterUiTriggerCostTest.cpp +++ b/test/functional_tests/StarterUiTriggerCostTest.cpp @@ -26,10 +26,13 @@ #include "Host.h" #include "MudletInstanceCoordinator.h" #include "TLuaInterpreter.h" +#include "TTrigger.h" #include "TelnetServerStub.h" #include "TriggerUnit.h" #include "ctelnet.h" #include "dlgConnectionProfiles.h" +#include "dlgTriggerEditor.h" +#include <QTreeWidget> #include "mudlet.h" extern void qInitResources_mudlet(); @@ -49,10 +52,16 @@ private: const QString mLocalhost = qsl("localhost"); quint16 mPort = 0; - // A full default-package profile measures 5: the starter UI's three chat - // groups and one vitals prefilter, plus one folder from another package. - // Raising this is a throughput change and wants measuring first. - static constexpr int kMaxRootTriggers = 8; + // A full default-package profile measures 3: the starter UI's chat capture + // tree and its vitals prefilter, plus one folder from another package. + // Nesting hides growth from this count, so kMaxGatePatterns is what tracks + // the per-line cost. + static constexpr int kMaxRootTriggers = 5; + + // What every line of game text really pays for: the substrings the chat + // gates scan for before any regex runs. Measures 17. Raising this is a + // throughput change and wants measuring first. + static constexpr int kMaxGatePatterns = 20; private slots: void initTestCase() { initializeQRCResources(); } @@ -92,7 +101,7 @@ private slots: .arg(rootTriggers))); QVERIFY(luaTrue(host, qsl("#BaseUI.vitalsTriggerIds == 1"))); - QVERIFY(luaTrue(host, qsl("#BaseUI.chatTriggerIds == 3"))); + QVERIFY2(luaTrue(host, qsl("BaseUI.chatTriggersArmed()")), "the chat capture tree's gates did not come up armed"); } // Miss a line here and that game's gauges silently never appear. @@ -189,32 +198,177 @@ private slots: QVERIFY2(luaTrue(host, qsl("BaseUI.vitalsData.hp.max == 3600")), "a tell was harvested for vitals"); } - // Each chat group has to keep routing into the tab its shapes always did. + // Every chat shape needs a line here. The tree's gates are + // case-sensitive substrings, so a shape whose literal is spelled differently + // in its gate silently never routes, and only a line exercising that shape + // notices. void test_chatCaptureStillSortsLinesIntoTheirTabs() { Host* host = startProfileWithStarterUi(); QVERIFY(host); - feedLine(host, qsl("Bob tells you, 'hello there'")); - QVERIFY2(luaTrue(host, qsl("BaseUI.chats ~= nil and BaseUI.unread ~= nil")), "a tell did not build the chat dock"); - // routeChatLine() counts the active tab as read, so the tell lands in - // Tells' unread counter while All (the active tab) does not move. - QVERIFY2(luaTrue(host, qsl("BaseUI.unread.tells == 1")), "a tell was not routed into the Tells tab"); + // second is the tab besides All the line has to reach, empty for the + // shapes that only ever reach All + const QList<QPair<QString, QString>> corpus = { + {qsl("Bob tells you, 'hello there'"), qsl("tells")}, + {qsl("You tell Ann, 'on my way'"), qsl("tells")}, + {qsl("You tell the formation you are ready."), qsl("tells")}, + {qsl("Ann whispers to you, 'psst'"), qsl("tells")}, + {qsl("Bob tells the group, 'incoming'"), qsl("tells")}, + {qsl("Bob says, 'hello everyone'"), QString()}, + {qsl("Bob asks, 'where is the bank?'"), QString()}, + {qsl("Bob exclaims, 'at last!'"), QString()}, + {qsl("You say, 'hi there'"), QString()}, + {qsl("You ask, 'which way?'"), QString()}, + {qsl("You exclaim, 'finally!'"), QString()}, + {qsl("Bob yells, 'help!'"), QString()}, + {qsl("Bob shouts, 'to arms!'"), QString()}, + {qsl("You yell, 'wait for me!'"), QString()}, + {qsl("You shout, 'over here!'"), QString()}, + {qsl("[tell] Ann: are you there?"), qsl("tells")}, + {qsl("[newbie] Ann: how do I get out of here?"), qsl("channels")}, + {qsl("(gossip) Ann: anyone around?"), qsl("channels")}, + {qsl("< chat | Ann: anyone around?"), qsl("channels")}, + }; - // All three tagged branches: each writes its tag into a different - // capture group, and only the matching branch's is set. - feedLine(host, qsl("[newbie] Ann: how do I get out of here?")); - QVERIFY2(luaTrue(host, qsl("BaseUI.unread.channels == 1")), - "a [tag] channel line was not routed into the Channels tab - the grouped tagged trigger is not " - "finding its capture group"); - feedLine(host, qsl("(gossip) Ann: anyone around?")); - QVERIFY2(luaTrue(host, qsl("BaseUI.unread.channels == 2")), "a (tag) channel line was not routed"); - feedLine(host, qsl("< chat | Ann: anyone around?")); - QVERIFY2(luaTrue(host, qsl("BaseUI.unread.channels == 3")), "a < tag | channel line was not routed"); + QHash<QString, int> expectedUnread; + for (const auto& [text, family] : corpus) { + feedLine(host, text); + // routeChatLine() records what it copied, and counts the active tab + // (All) as read, so this is what says the line reached the dock + QVERIFY2(luaTrue(host, qsl("BaseUI.recentCaptures[#BaseUI.recentCaptures] ~= nil and BaseUI.recentCaptures[#BaseUI.recentCaptures].text == %1").arg(luaLiteral(text))), + qPrintable(qsl("the chat tree did not route: %1").arg(text))); + if (family.isEmpty()) { + continue; + } + expectedUnread[family] += 1; + QVERIFY2(luaTrue(host, qsl("BaseUI.unread.%1 == %2").arg(family, QString::number(expectedUnread.value(family)))), qPrintable(qsl("did not reach the %1 tab: %2").arg(family, text))); + } - // BaseUI.chatChannelNames still has the last word on a captured tag. + // BaseUI.chatChannelNames has the last word on a captured tag, so this + // line reaches no tab at all rather than only missing Channels. + QVERIFY(runLua(host, qsl("__starterUiCaptures = #BaseUI.recentCaptures"))); feedLine(host, qsl("[inventory] a rusty sword")); - QVERIFY2(luaTrue(host, qsl("BaseUI.unread.channels == 3")), "an unknown tag was routed as a channel"); + QVERIFY2(luaTrue(host, qsl("#BaseUI.recentCaptures == __starterUiCaptures")), "an unknown tag was captured as chat"); + + QVERIFY(runLua(host, chatShapeCoverageScript(corpus))); + QVERIFY2(luaTrue(host, qsl("__starterUi.uncoveredShapes == 0")), + "a chat shape has no line in the corpus above, so nothing would notice if its gate stopped matching - " + "the shapes are named in the error console"); + QVERIFY2(luaTrue(host, qsl("__starterUi.unroutedLines == 0")), + "a corpus line routes through the trigger tree but no chatPatterns shape recognises it, so the vitals " + "layer would harvest it - the lines are in the error console"); + + assertCorpusCoversEveryGateLiteral(host, corpus); + } + + // The gate layer is what every line pays for, so it has to stay substring + // matching, and the shapes hanging off it have to stay the ones the script + // knows about - chatLikeLine() reads that list to keep chat out of the + // vitals layer, and a shape only the tree has would be harvested for gauges. + void test_theChatTreeGatesOnSubstringsAndKeepsTheScriptsShapes() + { + Host* host = startProfileWithStarterUi(); + QVERIFY(host); + + TTrigger* tree = findTrigger(host, qsl("Mudlet base UI chat capture")); + QVERIFY2(tree, "the chat capture tree is not in the profile under the name the script arms"); + QVERIFY2(tree->getPatternsList().isEmpty(), "the chat tree's root folder grew a pattern, so it is a chain now and no longer passes every line to its gates"); + + int gatePatterns = 0; + QStringList shapes; + for (auto gate : *tree->getChildrenList()) { + const QList<int> kinds = gate->getRegexCodePropertyList(); + QVERIFY2(!kinds.isEmpty(), qPrintable(qsl("gate \"%1\" has no patterns, so it passes every line straight to its regexes").arg(gate->getName()))); + for (const int kind : kinds) { + QVERIFY2(kind == REGEX_SUBSTRING || kind == REGEX_BEGIN_OF_LINE_SUBSTRING, + qPrintable(qsl("gate \"%1\" has a pattern of kind %2 - a gate must be substring matching only, or every line pays for a regex").arg(gate->getName(), QString::number(kind)))); + } + gatePatterns += static_cast<int>(kinds.size()); + for (auto shape : *gate->getChildrenList()) { + shapes << shape->getPatternsList(); + } + } + + QVERIFY2(gatePatterns <= kMaxGatePatterns, + qPrintable(qsl("the chat gates scan every line for %1 substrings, over the budget of %2").arg(QString::number(gatePatterns), QString::number(kMaxGatePatterns)))); + + QVERIFY(runLua(host, treeShapeComparisonScript(shapes))); + QVERIFY2(luaTrue(host, qsl("__starterUi.shapeMismatch == nil")), + "the tree's shapes and the script's chatPatterns have drifted apart - chatLikeLine() would stop recognising a " + "line the tree routes, and the vitals layer would read it as a prompt. The first difference is in the error console"); + } + + // A game that sends chat over GMCP does not need the gates, but the next + // connection might. + void test_theChatLayerRetiresOnceGmcpChatAppears() + { + Host* host = startProfileWithStarterUi(); + QVERIFY(host); + QVERIFY(luaTrue(host, qsl("BaseUI.chatTriggersArmed()"))); + + QVERIFY(runLua(host, + qsl("gmcp = gmcp or {}\n" + "gmcp.Comm = { Channel = { Text = { channel = 'chat', text = 'hello there' } } }\n" + "BaseUI.addChatMessage()"))); + QVERIFY2(luaTrue(host, qsl("BaseUI.gmcpChat")), "a GMCP chat message did not retire the trigger layer"); + QVERIFY2(luaTrue(host, qsl("not BaseUI.chatTriggersArmed()")), "the chat gates stayed armed after GMCP chat arrived, so lines would be captured twice"); + + QVERIFY(runLua(host, qsl("BaseUI.handleDisconnect()"))); + QVERIFY2(luaTrue(host, qsl("BaseUI.chatTriggersArmed()")), "the chat gates did not re-arm after a disconnect"); + + QVERIFY(runLua(host, qsl("BaseUI.hide()"))); + QVERIFY2(luaTrue(host, qsl("not BaseUI.chatTriggersArmed()")), "\"baseui hide\" left the chat gates armed"); + QVERIFY(runLua(host, qsl("BaseUI.handleDisconnect()"))); + QVERIFY2(luaTrue(host, qsl("not BaseUI.chatTriggersArmed()")), "a disconnect re-armed the chat gates of a hidden UI"); + + QVERIFY(runLua(host, qsl("BaseUI.show()"))); + QVERIFY2(luaTrue(host, qsl("BaseUI.chatTriggersArmed()")), "\"baseui show\" did not bring the chat gates back"); + } + + // Shipping the tree visible invites players to copy it, and the editor's + // paste keeps every name. enableTrigger()/disableTrigger() can only name a + // trigger, so a lifecycle built on a name a copy reproduces would reach + // into the player's triggers - and their active copy would answer for ours + // when we asked whether the layer was armed. + void test_copyingTheTreeLeavesThePlayersTriggersAlone() + { + Host* host = startProfileWithStarterUi(); + QVERIFY(host); + auto* tree = triggerTreeWidget(host); + QVERIFY2(tree, "could not reach the editor's trigger tree"); + + QVERIFY2(luaTrue(host, qsl("not BaseUI.chatTreeShared()")), "a fresh profile already has more than one chat capture tree"); + QVERIFY(runLua(host, qsl("BaseUI.disarmChatTriggers()"))); + QVERIFY2(luaTrue(host, qsl("not BaseUI.chatTriggersArmed()")), "the layer did not disarm on a profile with no copies"); + QVERIFY(runLua(host, qsl("BaseUI.armChatTriggers()"))); + QVERIFY(luaTrue(host, qsl("BaseUI.chatTriggersArmed()"))); + + // the likely copy: one gate, to adapt for themselves + pasteCopyOf(tree, qsl("BaseUI chat: tells")); + QList<TTrigger*> gates; + collectByName(host, qsl("BaseUI chat: tells"), gates); + QCOMPARE(gates.size(), 2); + QVERIFY(runLua(host, qsl("BaseUI.disarmChatTriggers()"))); + QVERIFY2(gates.at(1)->isActive(), "retiring the chat layer switched off the player's copy of a gate"); + QVERIFY2(luaTrue(host, qsl("not BaseUI.chatTriggersArmed()")), "the player's copy answered for ours when we asked whether the layer was armed"); + QVERIFY(runLua(host, qsl("BaseUI.armChatTriggers()"))); + + // and the whole tree, name and all - now we cannot tell ours apart + pasteCopyOf(tree, qsl("Mudlet base UI chat capture")); + QVERIFY2(luaTrue(host, qsl("BaseUI.chatTreeShared()")), "a second tree with our folder's name went unnoticed"); + QList<TTrigger*> folders; + collectByName(host, qsl("Mudlet base UI chat capture"), folders); + QCOMPARE(folders.size(), 2); + QVERIFY(runLua(host, qsl("BaseUI.disarmChatTriggers()"))); + QVERIFY2(folders.at(1)->isActive(), "retiring the chat layer switched off the player's copy of the whole tree"); + + // giving up the switch is only safe because routeChatLine() re-checks + QVERIFY(runLua(host, qsl("__starterUiCaptures = #BaseUI.recentCaptures\nBaseUI.gmcpChat = true"))); + feedLine(host, qsl("Ann whispers to you, 'psst'")); + QVERIFY2(luaTrue(host, qsl("#BaseUI.recentCaptures == __starterUiCaptures")), + "with the switch given up, a chat line was still captured after GMCP chat took over - the per-line guard is what " + "keeps this correct and it did not hold"); } void test_theVitalsLayerRetiresOnceAProtocolOwnsTheGauges() @@ -236,6 +390,184 @@ private slots: } private: + // Quotes and backslashes in a corpus line have to reach the Lua state + // exactly as they were fed to the trigger engine. + static QString luaLiteral(const QString& text) { return qsl("[==[%1]==]").arg(text); } + + // Drives the editor the way a player does: its copy/paste goes through the + // same XML export/import as a package, so this covers both. + QTreeWidget* triggerTreeWidget(Host* host) + { + dlgTriggerEditor* editor = host->mpEditorDialog; + if (!editor) { + return nullptr; + } + QMetaObject::invokeMethod(editor, "slot_showTriggers"); + QCoreApplication::processEvents(); + auto* tree = editor->findChild<QTreeWidget*>(qsl("treeWidget_triggers")); + return (tree && tree->topLevelItemCount() > 0) ? tree : nullptr; + } + + void pasteCopyOf(QTreeWidget* tree, const QString& name) + { + dlgTriggerEditor* editor = tree->window()->findChild<dlgTriggerEditor*>(); + editor = editor ? editor : qobject_cast<dlgTriggerEditor*>(tree->window()); + QVERIFY(editor); + // the editor rebuilds the tree after a paste, so nothing may be cached + QTreeWidgetItem* base = tree->topLevelItem(0); + QVERIFY(base); + QTreeWidgetItem* item = findItem(base, name); + QVERIFY2(item, qPrintable(qsl("no editor tree item called %1").arg(name))); + tree->setCurrentItem(item); + QCoreApplication::processEvents(); + QMetaObject::invokeMethod(editor, "slot_copyXml"); + QCoreApplication::processEvents(); + tree->setCurrentItem(tree->topLevelItem(0)); + QCoreApplication::processEvents(); + QMetaObject::invokeMethod(editor, "slot_pasteXml"); + QCoreApplication::processEvents(); + } + + static QTreeWidgetItem* findItem(QTreeWidgetItem* parent, const QString& name) + { + if (!parent) { + return nullptr; + } + if (parent->text(0) == name) { + return parent; + } + for (int i = 0; i < parent->childCount(); ++i) { + if (QTreeWidgetItem* found = findItem(parent->child(i), name)) { + return found; + } + } + return nullptr; + } + + static void collectByName(Host* host, const QString& name, QList<TTrigger*>& found) + { + for (auto root : host->getTriggerUnit()->getTriggerRootNodeList()) { + collectByNameIn(root, name, found); + } + } + + static void collectByNameIn(TTrigger* trigger, const QString& name, QList<TTrigger*>& found) + { + if (trigger->getName() == name) { + found << trigger; + } + for (auto child : *trigger->getChildrenList()) { + collectByNameIn(child, name, found); + } + } + + static TTrigger* findTrigger(Host* host, const QString& name) + { + for (auto root : host->getTriggerUnit()->getTriggerRootNodeList()) { + if (TTrigger* found = findTriggerIn(root, name)) { + return found; + } + } + return nullptr; + } + + static TTrigger* findTriggerIn(TTrigger* trigger, const QString& name) + { + if (trigger->getName() == name) { + return trigger; + } + for (auto child : *trigger->getChildrenList()) { + if (TTrigger* found = findTriggerIn(child, name)) { + return found; + } + } + return nullptr; + } + + void assertCorpusCoversEveryGateLiteral(Host* host, const QList<QPair<QString, QString>>& corpus) + { + TTrigger* tree = findTrigger(host, qsl("Mudlet base UI chat capture")); + QVERIFY(tree); + for (auto gate : *tree->getChildrenList()) { + const QStringList patterns = gate->getPatternsList(); + const QList<int> kinds = gate->getRegexCodePropertyList(); + for (int i = 0; i < patterns.size() && i < kinds.size(); ++i) { + const QString& literal = patterns.at(i); + bool exercised = false; + for (const auto& [text, family] : corpus) { + // matching the engine: substrings are indexOf, the rest startsWith + exercised = kinds.at(i) == REGEX_SUBSTRING ? text.contains(literal, Qt::CaseSensitive) : text.startsWith(literal, Qt::CaseSensitive); + if (exercised) { + break; + } + } + QVERIFY2(exercised, + qPrintable(qsl("no corpus line exercises \"%1\" in gate \"%2\", so that literal could be misspelled and " + "the chat it gates would silently stop appearing") + .arg(literal, gate->getName()))); + } + } + } + + static QString treeShapeComparisonScript(const QStringList& treeShapes) + { + QStringList entries; + for (const QString& shape : treeShapes) { + entries << luaLiteral(shape); + } + return qsl(R"LUA( +local tree = { %1 } +local script = BaseUI.chatShapeRegexes() +__starterUi = __starterUi or {} +__starterUi.shapeMismatch = nil +for i = 1, math.max(#tree, #script) do + if tree[i] ~= script[i] then + __starterUi.shapeMismatch = string.format("shape %d: tree has %s, chatPatterns has %s", + i, tostring(tree[i]), tostring(script[i])) + echo("\n[ chat shape drift ] " .. __starterUi.shapeMismatch .. "\n") + break + end +end +)LUA") + .arg(entries.join(qsl(", "))); + } + + // Holds the corpus fed above against the shapes chatLikeLine() walks: every + // shape needs a line, and every line needs a shape. + static QString chatShapeCoverageScript(const QList<QPair<QString, QString>>& corpus) + { + QStringList entries; + for (const auto& entry : corpus) { + entries << luaLiteral(entry.first); + } + return qsl(R"LUA( +local corpus = { %1 } +__starterUi = { uncoveredShapes = 0, unroutedLines = 0 } + +for _, regex in ipairs(BaseUI.chatShapeRegexes()) do + local covered = false + for _, text in ipairs(corpus) do + if rex.find(text, regex) then + covered = true + break + end + end + if not covered then + __starterUi.uncoveredShapes = __starterUi.uncoveredShapes + 1 + echo("\n[ chat shape with no corpus line ] " .. regex .. "\n") + end +end + +for _, text in ipairs(corpus) do + if not BaseUI.chatLikeLine(text) then + __starterUi.unroutedLines = __starterUi.unroutedLines + 1 + echo("\n[ corpus line no chat shape recognises ] " .. text .. "\n") + end +end +)LUA") + .arg(entries.join(qsl(", "))); + } + // Runs inside the profile's Lua state, against the real // BaseUI.parseVitalsLine and BaseUI.vitalsPrefilter. static QString prefilterDifferentialScript() From ed403cabc11345de1b16574127c0a32289a13613 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Sat, 8 Aug 2026 19:30:26 +0200 Subject: [PATCH 136/155] infrastructure: keep the profile-removal file list from going stale (#9739) #### Brief overview of PR changes/additions - Hoists the list `slot_deleteProfile()` checks a never-played profile against out of the function to `dlgConnectionProfiles::scmConnectionDetailFiles`, beside the file's other `scm*` constants, and points at it from both `writeProfileData()` implementations. - Adds a `ProfileDeletionSafetyTest` case that sets a profile up through the real dialog (New profile, name it, fill the connection form in, re-select it) and fails if anything it wrote is missing from the list. - Pins the deliberate exclusions too: a profile holding a stored password or a typed-in character name still asks before removal. #### Motivation for adding to Mudlet Nothing linked that list to the ~15 places profile data gets written, so it could silently go stale; because it is an allowlist a stale entry only ever costs an extra confirmation prompt, but the maintenance trap was worth closing. #### Other info (issues closed, discussion etc) Follows up https://github.com/Mudlet/Mudlet/pull/9722#discussion_r3740581754 on #9722 (fix: a profile named "." or ".." deletes every profile when removed). No behaviour change. **Test case:** `ctest -R ProfileDeletionSafetyTest` (20 cases). Removing an entry from the constant makes it fail naming the file; adding `login` makes the character-name case fail. Assisted-by: Claude:claude-opus-5 --- src/dlgConnectionProfiles.cpp | 16 +++-- src/dlgConnectionProfiles.h | 2 + .../ProfileDeletionSafetyTest.cpp | 71 +++++++++++++++++++ 3 files changed, 83 insertions(+), 6 deletions(-) diff --git a/src/dlgConnectionProfiles.cpp b/src/dlgConnectionProfiles.cpp index dbb58273a..3a64095b9 100644 --- a/src/dlgConnectionProfiles.cpp +++ b/src/dlgConnectionProfiles.cpp @@ -79,6 +79,12 @@ QChar dlgConnectionProfiles::firstInvalidProfileNameChar(const QString& name) // retrieve its password. Mirrors the pattern used there: const QRegularExpression dlgConnectionProfiles::scmUnusableProfileNameChars{qsl(R"REGEX(\.\.|[/\\<>:"|?*\x00-\x1f])REGEX")}; +// Listing what is expected rather than what to watch out for keeps an +// unrecognised file - a stored password, a character name the user typed - on +// the side of asking. ProfileDeletionSafetyTest fails if the connection form +// comes to write anything this does not name: +const QStringList dlgConnectionProfiles::scmConnectionDetailFiles{qsl("url"), qsl("port"), qsl("ssl_tsl"), qsl("description"), qsl("website"), qsl("autologin"), qsl("autoreconnect")}; + // A lone "." is made entirely of permitted characters, yet every path built // from it addresses the profiles directory rather than a profile of its own - // as does "..", which scmUnusableProfileNameChars already covers: @@ -1120,16 +1126,11 @@ void dlgConnectionProfiles::slot_deleteProfile() return; } - // A profile that has never been played holds nothing but the connection - // details written out when it was selected. Listing what is expected rather - // than what to watch out for keeps an unrecognised file - a stored password, - // a personal dictionary - on the side of asking: - static const QStringList connectionDetailFiles{qsl("url"), qsl("port"), qsl("ssl_tsl"), qsl("description"), qsl("website"), qsl("autologin"), qsl("autoreconnect")}; const QDir profileDir(mudlet::getMudletPath(enums::profileHomePath, profile)); bool nothingToLose = !profileDir.exists() || profileDir.entryList(QDir::Dirs | QDir::Hidden | QDir::NoDotAndDotDot).isEmpty(); if (nothingToLose) { for (const QString& fileName : profileDir.entryList(QDir::Files | QDir::Hidden)) { - if (!connectionDetailFiles.contains(fileName)) { + if (!scmConnectionDetailFiles.contains(fileName)) { nothingToLose = false; break; } @@ -1208,6 +1209,9 @@ QString dlgConnectionProfiles::readProfileData(const QString& profile, const QSt return ret; } +// A new item here may need adding to scmConnectionDetailFiles above. Unlike +// mudlet::writeProfileData() this does not create the profile's folder, so a +// write before there is one is quietly dropped. QPair<bool, QString> dlgConnectionProfiles::writeProfileData(const QString& profile, const QString& item, const QString& what) { QSaveFile file(mudlet::getMudletPath(enums::profileDataItemPath, profile, item)); diff --git a/src/dlgConnectionProfiles.h b/src/dlgConnectionProfiles.h index d84c9c26e..affcd9f60 100644 --- a/src/dlgConnectionProfiles.h +++ b/src/dlgConnectionProfiles.h @@ -57,6 +57,8 @@ public: static QString profileFolderPath(const QString& profilesPath, const QString& profile); static const QString scmAllowedProfileNameChars; static const QRegularExpression scmUnusableProfileNameChars; + // files whose presence alone does not warrant confirming a profile's removal + static const QStringList scmConnectionDetailFiles; QString btn_connect_enabled_accessDesc; QString btn_load_enabled_accessDesc; diff --git a/test/functional_tests/ProfileDeletionSafetyTest.cpp b/test/functional_tests/ProfileDeletionSafetyTest.cpp index 52b1e917b..a5dacc78b 100644 --- a/test/functional_tests/ProfileDeletionSafetyTest.cpp +++ b/test/functional_tests/ProfileDeletionSafetyTest.cpp @@ -256,6 +256,57 @@ private slots: closeDialog(dlg); } + // test_profileWithOnlyConnectionDetailsIsRemovedWithoutConfirmation only + // holds while dlgConnectionProfiles::scmConnectionDetailFiles still covers + // what the connection form writes, so fill one in the way a user does and + // hold what lands on disk against that list + void test_newProfileOnlyWritesListedConnectionDetails() + { + const QString unplayed = qsl("QA Just Set Up"); + QVERIFY(!QDir(profilePath(unplayed)).exists()); + + auto* dlg = openDialog(); + dlg->slot_addProfile(); + dlg->profile_name_entry->setText(unplayed); + // what leaving the name field does, and what creates the profile's + // folder - it only gets that far synchronously because initTestCase() + // turned secure password storage off, else it waits on the keychain + dlg->slot_saveName(); + QVERIFY2(QDir(profilePath(unplayed)).exists(), "naming a new profile did not create its folder"); + + // the rest of the connection form. The character name and the password + // are left out on purpose: they are the user's own, so a profile + // holding either is still confirmed - see the two cases below + dlg->host_name_entry->setText(qsl("mudlet.org")); + dlg->port_entry->setText(qsl("23")); + dlg->port_ssl_tsl->setChecked(true); + dlg->autologin_checkBox->setChecked(true); + dlg->auto_reconnect->setChecked(true); + dlg->mud_description_textedit->setPlainText(qsl("a game to try later")); + + // refilling the form by selecting the profile writes through the same + // field signals, so the selection path is covered as well + selectProfile(dlg, unplayed); + + const QStringList written = QDir(profilePath(unplayed)).entryList(QDir::Files | QDir::Hidden); + // a field that stops saving would otherwise quietly shrink what the + // check below covers, while still passing it + for (const QString& expected : {qsl("url"), qsl("port"), qsl("ssl_tsl"), qsl("autologin"), qsl("autoreconnect"), qsl("description")}) { + QVERIFY2(written.contains(expected), qPrintable(qsl("filling the form in no longer writes '%1', so this case has stopped covering it").arg(expected))); + } + for (const QString& fileName : written) { + QVERIFY2(dlgConnectionProfiles::scmConnectionDetailFiles.contains(fileName), + qPrintable(qsl("setting a profile up wrote '%1', which dlgConnectionProfiles::scmConnectionDetailFiles does not list - add it there, or " + "reconsider removing such a profile without confirmation") + .arg(fileName))); + } + + dlg->slot_deleteProfile(); + QVERIFY2(!confirmation(dlg), "a profile that was only ever set up should not need confirming"); + QVERIFY2(!QDir(profilePath(unplayed)).exists(), "the profile was not removed"); + closeDialog(dlg); + } + // A stored password sits loose in the folder rather than in a sub-directory void test_profileWithOnlyAStoredPasswordIsConfirmedBeforeRemoval() { @@ -275,6 +326,26 @@ private slots: closeDialog(dlg); } + // The character name typed into the login field is the user's own text + // rather than one of the connection details the shortcut waves through + void test_profileWithACharacterNameIsConfirmedBeforeRemoval() + { + const QString named = qsl("QA Named"); + QVERIFY(QDir().mkpath(profilePath(named))); + mudlet::self()->writeProfileData(named, qsl("url"), qsl("mudlet.org")); + mudlet::self()->writeProfileData(named, qsl("login"), qsl("Aurelius")); + + auto* dlg = openDialog(); + selectProfile(dlg, named); + + dlg->slot_deleteProfile(); + QVERIFY2(confirmation(dlg), "a profile holding a character name was removed without asking"); + QVERIFY2(QDir(profilePath(named)).exists(), "the profile was deleted before the user confirmed"); + + confirmation(dlg)->reject(); + closeDialog(dlg); + } + // Nothing stops a second confirmation being raised over the first void test_eachConfirmationRemovesItsOwnProfile() { From f1582ad8b8a92f2dfe711ef55fa1d2f752e5f236 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Sun, 9 Aug 2026 10:32:06 +0200 Subject: [PATCH 137/155] fix: MXP frames overlapping UI packages that reserve screen space (#9737) #### Brief overview of PR changes/additions - MXP `<FRAME>` windows were positioned against the whole main window, so an edge-aligned frame landed on top of space a package had reserved with `setBorderRight()` and friends. They now lay out inside the area the user borders leave. - Frames are repositioned when those borders or the window size change, instead of staying where they were first put. - Frames in a window of their own (`EXTERNAL`) are left alone by that repositioning. #### Motivation for adding to Mudlet With the base UI installed, a game using MXP frames drew its frames on top of the UI panel instead of beside it. #### Other info (issues closed, discussion etc) Fixes #9698 New functional test `MxpFramePlacementTest` (16 cases) covers each edge, border changes, window resizes, nested frames, external frames, and a Geyser `Adjustable.Container` attached to the right border, which is how the base UI reserves its space. 8 of the cases fail on `development`. **Test case:** With the base UI installed, connect to `eden-test.rpgframework.de 4000` - the MXP frames sit beside the UI panel rather than under it. Assisted-by: Claude:claude-opus-5 --- src/TConsole.cpp | 6 + src/TMxpFrameManager.cpp | 279 +++++++----- src/TMxpFrameManager.h | 21 +- test/functional_tests/CMakeLists.txt | 1 + .../MxpFramePlacementTest.cpp | 424 ++++++++++++++++++ 5 files changed, 615 insertions(+), 116 deletions(-) create mode 100644 test/functional_tests/MxpFramePlacementTest.cpp diff --git a/src/TConsole.cpp b/src/TConsole.cpp index 53fa98510..9c926401f 100644 --- a/src/TConsole.cpp +++ b/src/TConsole.cpp @@ -747,6 +747,12 @@ void TConsole::resizeEvent(QResizeEvent* event) layerCommandLine->move(0, mpBaseVFrame->height() - layerCommandLine->height()); } + // MXP frames are positioned by hand against the space the borders leave, so + // they have to be moved whenever the window or those borders change + if ((mType & MainConsole) && !mpHost.isNull()) { + mpHost->mMxpFrameManager.scheduleRelayout(); + } + // Sync Host dimensions on resize so wraps and NAWS reflect the current pane width. if ((mType & MainConsole) && !mpHost.isNull() && mUpperPane && !mUpperPane->visibleRegion().isEmpty()) { const int paneWidthPx = mUpperPane->visibleRegion().boundingRect().width(); diff --git a/src/TMxpFrameManager.cpp b/src/TMxpFrameManager.cpp index b3931d5e9..173eaac2b 100644 --- a/src/TMxpFrameManager.cpp +++ b/src/TMxpFrameManager.cpp @@ -124,6 +124,11 @@ bool TMxpFrameManager::createFrame(const QString& name, const QMap<QString, QStr qDebug() << "TMxpFrameManager::createFrame:" << name << "TITLE attr:" << attributes.value(qsl("TITLE")) << "title:" << frame->title << "floating:" << frame->floating; #endif + // relayoutFrames() works off mFrameOrder, so nothing may lay a frame out + // before it is in there + mFrames[name] = frame; + mFrameOrder.append(frame); + // Create the appropriate UI layout if (frame->isInternal) { if (!frame->dockFrame.isEmpty() && frame->align == qsl("client")) { @@ -135,9 +140,6 @@ bool TMxpFrameManager::createFrame(const QString& name, const QMap<QString, QStr layoutExternalFrame(frame); } - // Store the frame - mFrames[name] = frame; - return true; } @@ -176,6 +178,7 @@ bool TMxpFrameManager::closeFrame(const QString& name) // Remove from frames map and delete mFrames.remove(name); + mFrameOrder.removeOne(frame); delete frame; // No need to recalculate borders for tab frames since they don't affect main window borders @@ -200,10 +203,11 @@ bool TMxpFrameManager::closeFrame(const QString& name) removeFrameFromHierarchy(frame); mFrames.remove(name); + mFrameOrder.removeOne(frame); delete frame; - // Recalculate borders after frame removal to reclaim space - recalculateBorders(); + // Reposition what is left so it reclaims the space the frame gave up + relayoutFrames(); return true; } @@ -257,6 +261,7 @@ void TMxpFrameManager::resetAllFrames() closeFrame(name); } + mFrameOrder.clear(); mMxpBorders = QMargins(); if (mpHost) { @@ -350,29 +355,38 @@ QStringList TMxpFrameManager::getFrameNames() const return mFrames.keys(); } -void TMxpFrameManager::layoutInternalFrame(TMxpFrame* frame) +QRect TMxpFrameManager::availableFrameArea() const { - if (!mpHost || !mpHost->mpConsole) { - qWarning() << "TMxpFrameManager::layoutInternalFrame: No console available"; - return; + if (!mpHost || mpHost->mpConsole.isNull()) { + return {}; } - TMainConsole* mainConsole = mpHost->mpConsole.data(); - - // Note: DOCK tabbing is handled in createFrame() when ALIGN=CLIENT is set. - // Per CMUD, ALIGN=CLIENT + DOCK creates tabbed frames. - // This is a CMUD extension, not part of the official MXP 1.0 specification. - - // Check if we're inside a DEST - if so, nest this frame inside the destination - TMxpFrame* parentFrame = nullptr; - if (!mCurrentDestination.isEmpty()) { - parentFrame = getFrame(mCurrentDestination); + // getMainWindowSize() rather than mpMainFrame's own geometry, which + // TConsole::resizeEvent() sets to the full console size until the layout + // corrects it. It is also the size Lua scripts lay themselves out against, + // so taking the user borders off it keeps frames out of the space a package + // such as the base UI has reserved with setBorderRight() and friends. + QRect area = QRect(QPoint(0, 0), mpHost->mpConsole->getMainWindowSize()).marginsRemoved(mpHost->userBorders()); + if (area.width() < 0) { + area.setWidth(0); } + if (area.height() < 0) { + area.setHeight(0); + } + return area; +} +// Works out where a frame goes. An edge aligned top level frame consumes the +// space it takes from mMxpBorders and a nested one advances its parent's +// usedHeight; an absolutely positioned frame consumes neither. Callers are +// responsible for pushing the updated borders to the Host. +QRect TMxpFrameManager::calculateFrameGeometry(TMxpFrame* frame, TMxpFrame* parentFrame) +{ // Determine the container for this frame QSize containerSize; int containerX = 0; int containerY = 0; + QRect area; if (parentFrame && parentFrame->widget) { // Nested frame - position relative to parent @@ -384,12 +398,17 @@ void TMxpFrameManager::layoutInternalFrame(TMxpFrame* frame) containerY += parentFrame->usedHeight; containerSize.setHeight(containerSize.height() - parentFrame->usedHeight); } else { - // Top-level frame - use MXP-specific borders (not Host borders which are for Lua) - containerSize = mainConsole->size(); - containerX = mMxpBorders.left(); - containerY = mMxpBorders.top(); - containerSize.setWidth(containerSize.width() - mMxpBorders.left() - mMxpBorders.right()); - containerSize.setHeight(containerSize.height() - mMxpBorders.top() - mMxpBorders.bottom()); + // A parent with no widget of its own gives nothing to place against, so + // such a frame is placed as a top level one for the rest of this + // calculation - frame->parentFrame still records the hierarchy + parentFrame = nullptr; + // MXP borders stack inwards from the area the user borders leave. + // userBorders() and not borders(), which already carries the MXP borders + // this function is in the middle of recomputing. + area = availableFrameArea(); + containerX = area.x() + mMxpBorders.left(); + containerY = area.y() + mMxpBorders.top(); + containerSize = QSize(area.width() - mMxpBorders.left() - mMxpBorders.right(), area.height() - mMxpBorders.top() - mMxpBorders.bottom()); } // Calculate frame dimensions relative to container @@ -404,13 +423,14 @@ void TMxpFrameManager::layoutInternalFrame(TMxpFrame* frame) } // Ensure minimum size for visibility - if (frameWidth < 50) + if (frameWidth < 50) { frameWidth = 100; + } // For character-based height specs, handle minimum size more carefully - bool isCharacterHeight = frame->height.trimmed().endsWith('c', Qt::CaseInsensitive); - bool isCharacterWidth = frame->width.trimmed().endsWith('c', Qt::CaseInsensitive); - bool willHaveTitle = !frame->floating && frame->hasExplicitTitle; + const bool isCharacterHeight = frame->height.trimmed().endsWith('c', Qt::CaseInsensitive); + const bool isCharacterWidth = frame->width.trimmed().endsWith('c', Qt::CaseInsensitive); + const bool willHaveTitle = !frame->floating && frame->hasExplicitTitle; // Apply minimum size for visibility to non-character-based frames if (frameHeight < 20 && !isCharacterHeight) { @@ -455,7 +475,7 @@ void TMxpFrameManager::layoutInternalFrame(TMxpFrame* frame) // Calculate position based on alignment int x = containerX; int y = containerY; - QString align = frame->align.toLower(); + const QString align = frame->align.toLower(); if (parentFrame) { // Nested frame - position within parent's bounds using VBox/HBox logic @@ -473,62 +493,92 @@ void TMxpFrameManager::layoutInternalFrame(TMxpFrame* frame) y = containerY + containerSize.height() - frameHeight; frameWidth = containerSize.width(); } - } else { - // Top-level frame - position at window edges and update MXP borders - QSize windowSize = mainConsole->size(); - // Check for LEFT/TOP absolute positioning first - these take precedence over alignment - bool hasAbsolutePosition = !frame->left.isEmpty() || !frame->top.isEmpty(); - - if (hasAbsolutePosition) { - // Absolute positioning via LEFT/TOP attributes - if (!frame->left.isEmpty()) { - QSize leftSize = calculateFrameSize(frame->left, windowSize, false); - if (leftSize.width() > 0) { - x = leftSize.width(); - } - } - if (!frame->top.isEmpty()) { - QSize topSize = calculateFrameSize(frame->top, windowSize, true); - if (topSize.height() > 0) { - y = topSize.height(); - } - } - // Absolute positioned frames don't modify MXP borders - } else if (align == qsl("left")) { - // Left-aligned: position at actual left edge (after existing left MXP frames) - x = mMxpBorders.left(); - y = 0; - frameHeight = windowSize.height(); - // Update MXP left border - mMxpBorders.setLeft(mMxpBorders.left() + frameWidth); - } else if (align == qsl("right")) { - // Right-aligned: position at right edge - x = windowSize.width() - mMxpBorders.right() - frameWidth; - y = 0; - frameHeight = windowSize.height(); - mMxpBorders.setRight(mMxpBorders.right() + frameWidth); - } else if (align == qsl("top")) { - // Top-aligned: position at top edge - x = mMxpBorders.left(); - y = mMxpBorders.top(); - frameWidth = windowSize.width() - mMxpBorders.left() - mMxpBorders.right(); - mMxpBorders.setTop(mMxpBorders.top() + frameHeight); - } else if (align == qsl("bottom")) { - // Bottom-aligned: position at bottom edge - x = mMxpBorders.left(); - y = windowSize.height() - mMxpBorders.bottom() - frameHeight; - frameWidth = windowSize.width() - mMxpBorders.left() - mMxpBorders.right(); - mMxpBorders.setBottom(mMxpBorders.bottom() + frameHeight); - } else { - // No alignment and no absolute positioning - use container defaults - x = containerX; - y = containerY; - } - - mpHost->setMxpBorders(mMxpBorders); + return {x, y, frameWidth, frameHeight}; } + // Top-level frame - position at the edges of the available area and update MXP borders + + // Check for LEFT/TOP absolute positioning first - these take precedence over alignment + const bool hasAbsolutePosition = !frame->left.isEmpty() || !frame->top.isEmpty(); + + if (hasAbsolutePosition) { + // Absolute positioning via LEFT/TOP attributes + if (!frame->left.isEmpty()) { + QSize leftSize = calculateFrameSize(frame->left, area.size(), false); + if (leftSize.width() > 0) { + x = area.x() + leftSize.width(); + } + } + if (!frame->top.isEmpty()) { + QSize topSize = calculateFrameSize(frame->top, area.size(), true); + if (topSize.height() > 0) { + y = area.y() + topSize.height(); + } + } + // Absolute positioned frames don't modify MXP borders + } else if (align == qsl("left")) { + // Left-aligned: position at actual left edge (after existing left MXP frames) + x = area.x() + mMxpBorders.left(); + y = area.y(); + frameHeight = area.height(); + // Update MXP left border + mMxpBorders.setLeft(mMxpBorders.left() + frameWidth); + } else if (align == qsl("right")) { + // Right-aligned: position at right edge + x = area.x() + area.width() - mMxpBorders.right() - frameWidth; + y = area.y(); + frameHeight = area.height(); + mMxpBorders.setRight(mMxpBorders.right() + frameWidth); + } else if (align == qsl("top")) { + // Top-aligned: position at top edge + x = area.x() + mMxpBorders.left(); + y = area.y() + mMxpBorders.top(); + frameWidth = area.width() - mMxpBorders.left() - mMxpBorders.right(); + mMxpBorders.setTop(mMxpBorders.top() + frameHeight); + } else if (align == qsl("bottom")) { + // Bottom-aligned: position at bottom edge + x = area.x() + mMxpBorders.left(); + y = area.y() + area.height() - mMxpBorders.bottom() - frameHeight; + frameWidth = area.width() - mMxpBorders.left() - mMxpBorders.right(); + mMxpBorders.setBottom(mMxpBorders.bottom() + frameHeight); + } + + return {x, y, frameWidth, frameHeight}; +} + +void TMxpFrameManager::layoutInternalFrame(TMxpFrame* frame) +{ + if (!mpHost || !mpHost->mpConsole) { + qWarning() << "TMxpFrameManager::layoutInternalFrame: No console available"; + return; + } + + TMainConsole* mainConsole = mpHost->mpConsole.data(); + + // Note: DOCK tabbing is handled in createFrame() when ALIGN=CLIENT is set. + // Per CMUD, ALIGN=CLIENT + DOCK creates tabbed frames. + // This is a CMUD extension, not part of the official MXP 1.0 specification. + + // Check if we're inside a DEST - if so, nest this frame inside the destination + TMxpFrame* parentFrame = nullptr; + if (!mCurrentDestination.isEmpty()) { + parentFrame = getFrame(mCurrentDestination); + } + + const QRect geometry = calculateFrameGeometry(frame, parentFrame); + const int x = geometry.x(); + const int y = geometry.y(); + const int frameWidth = geometry.width(); + const int frameHeight = geometry.height(); + + // A nested frame never touches mMxpBorders, so this hands Host the margins + // it already has and setBorders() drops it + mpHost->setMxpBorders(mMxpBorders); + + const bool isCharacterHeight = frame->height.trimmed().endsWith('c', Qt::CaseInsensitive); + const bool willHaveTitle = !frame->floating && frame->hasExplicitTitle; + // FLOATING attribute, no explicit title, or very small height = borderless frame without header // Exception: character-based frames with explicit titles always show headers bool showHeader = !frame->floating && frame->hasExplicitTitle && (frameHeight >= 50 || (isCharacterHeight && willHaveTitle)); @@ -1002,51 +1052,58 @@ void TMxpFrameManager::layoutTabIntoExistingFrame(TMxpFrame* frame, TMxpFrame* t console->show(); } -void TMxpFrameManager::recalculateBorders() +void TMxpFrameManager::scheduleRelayout() +{ + if (mRelayoutPending || mFrames.isEmpty()) { + return; + } + + // Deferred so that the layout of the widgets frames are placed against has + // settled, and so that pushing new borders from here cannot re-enter the + // resize handling that asked for the relayout. The push at the end of a + // relayout does schedule one more pass, which then finds the same borders + // and stops there because Host::setBorders() ignores an unchanged value. + mRelayoutPending = true; + QTimer::singleShot(0, mpHost, [this]() { + mRelayoutPending = false; + relayoutFrames(); + }); +} + +void TMxpFrameManager::relayoutFrames() { if (!mpHost) { return; } - // Reset borders and recalculate based on remaining frames + // calculateFrameGeometry() accumulates into these, so they have to start + // empty or every pass would count the same frames again mMxpBorders = QMargins(); - if (!mpHost->mpConsole) { + if (mpHost->mpConsole.isNull() || !mpHost->mpConsole->mpMainFrame) { mpHost->setMxpBorders(mMxpBorders); return; } - QSize windowSize = mpHost->mpConsole->size(); + const QWidget* mainFrame = mpHost->mpConsole->mpMainFrame; - // Recalculate borders by examining all remaining top-level frames - // (frames without parents that affect the main window borders) - for (auto* frame : mFrames.values()) { - if (!frame || frame->parentFrame) { - continue; // Skip child frames, only process top-level frames - } + // calculateFrameGeometry() also accumulates into a parent's usedHeight, so + // without this nested frames would march further down on every pass + for (auto* frame : std::as_const(mFrameOrder)) { + frame->usedHeight = 0; + } - // Only frames that were positioned using alignment (not absolute positioning) - // contribute to MXP borders - bool hasAbsolutePosition = !frame->left.isEmpty() || !frame->top.isEmpty(); - if (hasAbsolutePosition) { + for (auto* frame : std::as_const(mFrameOrder)) { + // Skip a frame whose layout never produced a widget, one docked as a tab + // (the QTabWidget places it), and one in a window of its own. An external + // frame keeps mpMainFrame as its parent even after Qt::Window is set on + // it, so isWindow() rather than the parent is what tells them apart. + if (!frame->widget || frame->widget->isWindow() || frame->widget->parentWidget() != mainFrame) { continue; } - QString align = frame->align.toLower(); - QSize widthSize = calculateFrameSize(frame->width, windowSize, false); - QSize heightSize = calculateFrameSize(frame->height, windowSize, true); - - if (align == qsl("left")) { - mMxpBorders.setLeft(mMxpBorders.left() + widthSize.width()); - } else if (align == qsl("right")) { - mMxpBorders.setRight(mMxpBorders.right() + widthSize.width()); - } else if (align == qsl("top")) { - mMxpBorders.setTop(mMxpBorders.top() + heightSize.height()); - } else if (align == qsl("bottom")) { - mMxpBorders.setBottom(mMxpBorders.bottom() + heightSize.height()); - } + frame->widget->setGeometry(calculateFrameGeometry(frame, frame->parentFrame)); } - // Apply the recalculated borders mpHost->setMxpBorders(mMxpBorders); } diff --git a/src/TMxpFrameManager.h b/src/TMxpFrameManager.h index d0db143c4..0c00b514f 100644 --- a/src/TMxpFrameManager.h +++ b/src/TMxpFrameManager.h @@ -27,6 +27,7 @@ #include <QMap> #include <QMargins> #include <QPointer> +#include <QRect> #include <QSize> #include <QString> #include <QStringList> @@ -111,31 +112,41 @@ public: QStringList getFrameNames() const; bool frameExists(const QString& name) const { return mFrames.contains(name); } int frameCount() const { return mFrames.size(); } - + + // Reposition every frame on the next event loop turn, once the space they + // are laid out in has changed. Does nothing while no frames are open. + void scheduleRelayout(); + // Configuration static constexpr int MAX_FRAMES = 20; private: Host* mpHost; QMap<QString, TMxpFrame*> mFrames; + // Frames in creation order: borders accumulate inwards, so the order frames + // were opened in decides where each one sits + QList<TMxpFrame*> mFrameOrder; QString mCurrentDestination; // Current output target (empty = main console) QMargins mMxpBorders; // MXP-specific borders, separate from Host::mBorders - + bool mRelayoutPending = false; + // Layout and sizing helpers void layoutInternalFrame(TMxpFrame* frame); void layoutExternalFrame(TMxpFrame* frame); void layoutTabFrame(TMxpFrame* frame); void layoutTabIntoExistingFrame(TMxpFrame* frame, TMxpFrame* targetFrame); + QRect availableFrameArea() const; + QRect calculateFrameGeometry(TMxpFrame* frame, TMxpFrame* parentFrame); QSize calculateFrameSize(const QString& spec, const QSize& containerSize, bool isHeight); + void relayoutFrames(); Qt::DockWidgetArea alignmentToDockArea(const QString& align); - + // Validation bool validateFrameName(const QString& name) const; bool canCreateFrame() const; - + // Cleanup void removeFrameFromHierarchy(TMxpFrame* frame); - void recalculateBorders(); }; #endif // MUDLET_TMXPFRAMEMANAGER_H diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index 1ebc8d9ee..e460e0689 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -25,6 +25,7 @@ set(FUNCTIONAL_TEST_SOURCES MainConsoleSelectionTest.cpp EnableDisableByNameTest.cpp UnitDeferredDeleteTest.cpp + MxpFramePlacementTest.cpp ColorTriggerFilterChildTest.cpp GMCPCharLoginTest.cpp InsertTextCapTest.cpp diff --git a/test/functional_tests/MxpFramePlacementTest.cpp b/test/functional_tests/MxpFramePlacementTest.cpp new file mode 100644 index 000000000..4150ad0ac --- /dev/null +++ b/test/functional_tests/MxpFramePlacementTest.cpp @@ -0,0 +1,424 @@ +/*************************************************************************** + * Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +#include <QSignalSpy> +#include <QtTest/QtTest> +#include <chrono> + +#include "Host.h" +#include "MudletInstanceCoordinator.h" +#include "TLuaInterpreter.h" +#include "TMainConsole.h" +#include "TelnetServerStub.h" +#include "ctelnet.h" +#include "dlgConnectionProfiles.h" +#include "mudlet.h" + +using namespace std::chrono_literals; + +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); +void initializeQRCResourcesForMxpFramePlacementTest(); + +// Covers issue #9698: a package that reserves space with setBorderRight() and +// friends - the base UI does exactly that - must not have MXP frames placed on +// top of the space it claimed. +class MxpFramePlacementTest : public QObject +{ + Q_OBJECT + +private: + TelnetServerStub* mpServer = nullptr; + Host* mpHost = nullptr; + const QString mHostname = "MxpFramePlacement-Test-Host"; + QString mPort; + const QString mLocalhost = "localhost"; + + void runLua(const QString& script) { QVERIFY2(mpHost->getLuaInterpreter()->compileAndExecuteScript(script), qPrintable(script)); } + + // The space frames may be placed in: the main window, less whatever a + // package has reserved for itself. This repeats TMxpFrameManager's own + // formula, so tests that need an anchor independent of it assert against a + // literal or against another widget's geometry instead. + QRect area() const { return QRect(QPoint(0, 0), mpHost->mpConsole->getMainWindowSize()).marginsRemoved(mpHost->userBorders()); } + + QRect frameGeometry(const QString& name) const + { + const TMxpFrame* frame = mpHost->mMxpFrameManager.getFrame(name); + if (!frame || !frame->widget) { + return {}; + } + return frame->widget->geometry(); + } + + bool createFrame(const QString& name, const QString& align, const QString& width, const QString& height, const QMap<QString, QString>& extraAttributes = {}) + { + QMap<QString, QString> attributes = extraAttributes; + attributes.insert(qsl("NAME"), name); + attributes.insert(qsl("ALIGN"), align); + if (!width.isEmpty()) { + attributes.insert(qsl("WIDTH"), width); + } + if (!height.isEmpty()) { + attributes.insert(qsl("HEIGHT"), height); + } + const bool created = mpHost->mMxpFrameManager.createFrame(name, attributes); + settle(); + return created; + } + + // border changes and window resizes reposition frames from a zero timer + void settle() { QTest::qWait(50ms); } + +private slots: + void initTestCase() + { + initializeQRCResourcesForMxpFramePlacementTest(); + + mpServer = new TelnetServerStub(qApp); + mpServer->start(mLocalhost, 0); + mPort = QString::number(mpServer->serverPort()); + mudlet::start(); + mudlet::self()->setupConfig(); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique<MudletInstanceCoordinator>("MudletInstanceCoordinator")); + mudlet::self()->init(); + mudlet::self()->setStorePasswordsSecurely(false); + + QDir(mudlet::getMudletPath(enums::profileHomePath, mHostname)).removeRecursively(); + + QTimer::singleShot(0ms, qApp, [this]() { + mudlet::self()->startAutoLogin({}); + QTest::qWait(100ms); + QTest::mouseClick(mudlet::self()->mpConnectionDialog->new_profile_button, Qt::LeftButton); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), mHostname); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), mLocalhost); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), mPort); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Return); + }); + + QSignalSpy spy(mudlet::self(), &mudlet::signal_profileLoaded); + if (!spy.wait(5000)) { + QFAIL("Profile took too long to load."); + } + mpHost = mudlet::self()->getActiveHost(); + if (!mpHost) { + QFAIL("No active host available for the test."); + } + + QSignalSpy spy2(&(mpHost->mTelnet), &cTelnet::signal_connected); + if (!spy2.wait(2000)) { + QFAIL("Could not connect with the host."); + } + + mudlet::self()->resize(1200, 800); + QTest::qWait(100ms); + } + + void cleanupTestCase() + { + delete mpServer; + mpServer = nullptr; + mpHost = nullptr; + const QString path = mudlet::getMudletPath(enums::profileHomePath, mHostname); + delete mudlet::self(); + QDir(path).removeRecursively(); + } + + void init() + { + QVERIFY(mpHost); + QVERIFY(mpHost->mpConsole); + mpHost->mMxpProcessor.enable(); + mudlet::self()->resize(1200, 800); + settle(); + } + + // runs even when a QVERIFY aborts a test body, so no state carries into the + // next test - or, through the window geometry Mudlet saves on exit, into the + // next run of this binary + void cleanup() + { + mpHost->mMxpFrameManager.resetAllFrames(); + runLua(qsl("setBorderSizes(0)")); + mudlet::self()->resize(1200, 800); + settle(); + } + + void test_rightFrameKeepsClearOfAReservedRightBorder() + { + runLua(qsl("setBorderRight(300)")); + settle(); + const QRect reservedArea = area(); + + QVERIFY(createFrame(qsl("status"), qsl("right"), qsl("200px"), qsl("100%"))); + + const QRect frame = frameGeometry(qsl("status")); + QCOMPARE(frame.width(), 200); + QCOMPARE(frame.x(), reservedArea.right() + 1 - 200); + // the console and the frame have to tile the unreserved space between them + QCOMPARE(mpHost->mpConsole->mpMainDisplay->geometry().right() + 1, frame.x()); + } + + // the console has to give up room for the frame on top of what the package took + void test_frameBorderStacksOnTopOfTheUserBorder() + { + runLua(qsl("setBorderRight(300)")); + settle(); + + QVERIFY(createFrame(qsl("status"), qsl("right"), qsl("200px"), qsl("100%"))); + + QCOMPARE(mpHost->userBorders().right(), 300); + QCOMPARE(mpHost->borders().right(), 500); + QVERIFY2(mpHost->mpConsole->mpMainDisplay->geometry().right() < frameGeometry(qsl("status")).left(), "the main display overlaps the frame"); + } + + // with nothing reserved a right frame still goes right up to the edge + void test_rightFrameHugsTheEdgeWithoutAUserBorder() + { + QVERIFY(createFrame(qsl("status"), qsl("right"), qsl("200px"), qsl("100%"))); + + QCOMPARE(frameGeometry(qsl("status")).right() + 1, area().width()); + QCOMPARE(mpHost->mpConsole->mpMainDisplay->geometry().right() + 1, frameGeometry(qsl("status")).x()); + } + + void test_frameFollowsABorderThatChangesAfterwards() + { + runLua(qsl("setBorderRight(300)")); + settle(); + + QVERIFY(createFrame(qsl("status"), qsl("right"), qsl("200px"), qsl("100%"))); + + runLua(qsl("setBorderRight(100)")); + settle(); + + QCOMPARE(frameGeometry(qsl("status")).x(), area().right() + 1 - 200); + QCOMPARE(mpHost->borders().right(), 300); + + // growing the reservation is the direction that would leave the frame + // sitting inside it + runLua(qsl("setBorderRight(400)")); + settle(); + + QCOMPARE(frameGeometry(qsl("status")).x(), area().right() + 1 - 200); + QCOMPARE(mpHost->borders().right(), 600); + } + + void test_frameFollowsAWindowResize() + { + runLua(qsl("setBorderRight(300)")); + settle(); + + QVERIFY(createFrame(qsl("status"), qsl("right"), qsl("200px"), qsl("100%"))); + const int widthBefore = mpHost->mpConsole->mpMainFrame->width(); + + mudlet::self()->resize(1000, 700); + settle(); + + QVERIFY2(mpHost->mpConsole->mpMainFrame->width() != widthBefore, "the window did not actually resize"); + QCOMPARE(frameGeometry(qsl("status")).x(), area().right() + 1 - 200); + // a container that moves without its text area following it would look + // to the player like the frame did not move at all + const TMxpFrame* frame = mpHost->mMxpFrameManager.getFrame(qsl("status")); + QVERIFY(frame && frame->console); + QCOMPARE(frame->console->size(), frame->widget->size()); + } + + void test_leftFrameStartsAfterAReservedLeftBorder() + { + runLua(qsl("setBorderLeft(150)")); + settle(); + + QVERIFY(createFrame(qsl("nav"), qsl("left"), qsl("120px"), qsl("100%"))); + + QCOMPARE(frameGeometry(qsl("nav")).x(), 150); + QCOMPARE(mpHost->borders().left(), 270); + } + + void test_topFrameStartsAfterAReservedTopBorder() + { + runLua(qsl("setBorderTop(150)")); + settle(); + + QVERIFY(createFrame(qsl("banner"), qsl("top"), qsl("100%"), qsl("60px"))); + + const QRect frame = frameGeometry(qsl("banner")); + QCOMPARE(frame.y(), 150); + QCOMPARE(frame.height(), 60); + QCOMPARE(mpHost->borders().top(), 210); + } + + void test_bottomFrameKeepsClearOfAReservedBottomBorder() + { + runLua(qsl("setBorderBottom(120)")); + settle(); + const QRect reservedArea = area(); + + QVERIFY(createFrame(qsl("chat"), qsl("bottom"), qsl("100%"), qsl("80px"))); + + const QRect frame = frameGeometry(qsl("chat")); + QCOMPARE(frame.height(), 80); + QCOMPARE(frame.y(), reservedArea.bottom() + 1 - 80); + QCOMPARE(mpHost->borders().bottom(), 200); + // an anchor that does not go through the same formula: the frame has to + // clear the command line as well as the reserved strip + QCOMPARE(frame.bottom() + 1, mpHost->mpConsole->height() - mpHost->mpConsole->mpCommandLine->height() - 120); + } + + // WIDTH defaults to a percentage, which now resolves against the space the + // package left rather than the whole window + void test_percentageWidthResolvesAgainstTheUnreservedSpace() + { + runLua(qsl("setBorderRight(400)")); + settle(); + const QRect reservedArea = area(); + + QVERIFY(createFrame(qsl("status"), qsl("right"), QString(), qsl("100%"))); + + QCOMPARE(frameGeometry(qsl("status")).width(), reservedArea.width() / 4); + } + + // a frame opened while a DEST is active nests inside it and takes no space + // from the main console + void test_nestedFrameLeavesTheBordersAlone() + { + QVERIFY(createFrame(qsl("outer"), qsl("right"), qsl("300px"), qsl("100%"))); + const QMargins bordersWithOuter = mpHost->borders(); + + mpHost->mMxpFrameManager.setDestination(qsl("outer"), false, false); + QVERIFY(createFrame(qsl("nested"), qsl("top"), qsl("100%"), qsl("40px"))); + mpHost->mMxpFrameManager.clearDestination(); + + QCOMPARE(mpHost->borders(), bordersWithOuter); + QVERIFY2(frameGeometry(qsl("outer")).contains(frameGeometry(qsl("nested"))), "the nested frame is not inside its parent"); + + // Relayouts have to be idempotent: a top-aligned nested frame sits at its + // parent's top edge, and usedHeight accumulates, so without a reset each + // pass would march it further down. + for (int i = 0; i < 3; ++i) { + runLua(qsl("setBorderLeft(%1)").arg(i * 10)); + settle(); + QCOMPARE(frameGeometry(qsl("nested")).y(), frameGeometry(qsl("outer")).y()); + } + + QCOMPARE(mpHost->borders().right(), bordersWithOuter.right()); + } + + // frames stack inwards, so the second one has to clear both the reserved + // border and its neighbour + void test_twoRightFramesStackInwardsFromTheReservedBorder() + { + runLua(qsl("setBorderRight(200)")); + settle(); + const QRect reservedArea = area(); + + QVERIFY(createFrame(qsl("outer"), qsl("right"), qsl("150px"), qsl("100%"))); + QVERIFY(createFrame(qsl("inner"), qsl("right"), qsl("100px"), qsl("100%"))); + + QCOMPARE(frameGeometry(qsl("outer")).x(), reservedArea.right() + 1 - 150); + QCOMPARE(frameGeometry(qsl("inner")).x(), reservedArea.right() + 1 - 150 - 100); + QCOMPARE(mpHost->borders().right(), 450); + } + + // an EXTERNAL frame lives in its own window: it neither takes space from the + // main console nor may be dragged into main window coordinates by a relayout + void test_externalFrameIsLeftAloneByARelayout() + { + QVERIFY(createFrame(qsl("popup"), qsl("left"), qsl("200px"), qsl("150px"), {{qsl("EXTERNAL"), qsl("true")}})); + const TMxpFrame* frame = mpHost->mMxpFrameManager.getFrame(qsl("popup")); + QVERIFY(frame); + QVERIFY2(frame->widget && frame->widget->isWindow(), "the external frame is not a window of its own"); + const QRect geometryBefore = frame->widget->geometry(); + QCOMPARE(mpHost->borders(), QMargins()); + + mudlet::self()->resize(1000, 700); + settle(); + + QCOMPARE(mpHost->borders(), QMargins()); + QCOMPARE(frame->widget->geometry(), geometryBefore); + } + + // closing the outer frame has to pull the inner one back out to the edge + void test_closingAFrameRepositionsTheRest() + { + runLua(qsl("setBorderRight(200)")); + settle(); + const QRect reservedArea = area(); + + QVERIFY(createFrame(qsl("outer"), qsl("right"), qsl("150px"), qsl("100%"))); + QVERIFY(createFrame(qsl("inner"), qsl("right"), qsl("100px"), qsl("100%"))); + + QVERIFY(mpHost->mMxpFrameManager.closeFrame(qsl("outer"))); + settle(); + + QCOMPARE(frameGeometry(qsl("inner")).x(), reservedArea.right() + 1 - 100); + QCOMPARE(mpHost->borders().right(), 300); + } + + // How the base UI reserves its space, so this is #9698 as reported. Declared + // last on purpose: an adjustable container leaves deferred timers of its own + // behind that resize the main window out from under whatever runs next, so + // add new tests above this one rather than below it. For the same reason the + // expectation is evaluated at assert time rather than captured up front. + void test_rightFrameKeepsClearOfAnAttachedAdjustableContainer() + { + runLua(qsl("panel = Adjustable.Container:new({name = 'mxpTestPanel', x = '-25%', y = 0, width = '25%', height = '100%', autoSave = false, autoLoad = false})\n" + "panel:attachToBorder('right')")); + settle(); + const int reservedRight = mpHost->userBorders().right(); + QVERIFY2(reservedRight > 0, "the adjustable container did not reserve a border"); + + QVERIFY(createFrame(qsl("status"), qsl("right"), qsl("200px"), qsl("100%"))); + settle(); + + QCOMPARE(frameGeometry(qsl("status")).x(), area().right() + 1 - 200); + QCOMPARE(mpHost->borders().right(), reservedRight + 200); + + runLua(qsl("panel:detach() panel:hide()")); + settle(); + } +}; + +void initializeQRCResourcesForMxpFramePlacementTest() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +#include "MxpFramePlacementTest.moc" +QTEST_MAIN(MxpFramePlacementTest) From 72023317ed2c1a908738d99db2b30a5103a202b8 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Mon, 10 Aug 2026 07:20:00 +0200 Subject: [PATCH 138/155] infrastructure: fix Windows CI losing the per-user luarocks tree (#9752) #### Brief overview of PR changes/additions - Windows CI no longer pipes `luarocks path --lr-path/--lr-cpath` through `cygpath -u`; the raw Windows-form output is exported instead. - Same 4-line block fixed in all 5 places: `CI/build-mudlet-for-windows.sh` and both Windows workflows (QTest + Lua tests steps in each). - Added a short note at each site saying why cygpath must not be reintroduced. #### Motivation for adding to Mudlet `cygpath -u` does not know `;` delimits a list, so it rewrites only the leading entry into a POSIX path the native Windows Lua cannot open - which is exactly the per-user rock tree, so CI silently ran without those rocks. #### Other info (issues closed, discussion etc) Fixes #9750 Verified functionally in a real MSYS2 CLANG64 shell on a Windows 11 VM, with a canary module installed into `$HOME/.luarocks-CLANG64`: Raw luarocks output: ``` C:\msys64\home\Bob\.luarocks-CLANG64\share\lua\5.1\?.lua;C:\msys64\home\Bob\...\?\init.lua;C:\msys64\clang64\share\lua\5.1\?.lua;... ``` After `cygpath -u` (what CI did): ``` /home/Bob/.luarocks-CLANG64/share/lua/5.1/?.lua;C:/msys64/home/Bob/... ``` Only element 1 is genuinely converted, and `C:\home` does not exist on the guest. Running the native `/clang64/bin/lua5.1`: | `LUA_PATH` value | `require 'zzcanary'` | | --- | --- | | raw luarocks output | `true canary-ok` | | `cygpath -u` output | fails: `no file '/home/Bob/.luarocks-CLANG64/share/lua/5.1/zzcanary.lua'` | | `cygpath -u -p` output | worse: `:`-separated, Lua reads the whole list as one filename | `LUA_CPATH` behaves the same (the per-user `.dll` is unreachable after `cygpath -u`, found before it). Also confirmed MSYS2 does not auto-convert these variables when spawning a native child, so nothing was masking the defect. `CI/setup-windows-sdk.sh` already prints the raw form as the recommended Qt Creator environment, so CI now matches its own setup advice. Separately, #9749 (the functional tests never receiving `LUA_PATH`/`LUA_CPATH` at all) is a different root cause and is not addressed here. **Test case:** Windows CI green; the QTest and Lua test steps log `LUA_PATH`/`LUA_CPATH` in `C:\...;C:\...` form and busted/lfs/rex_pcre2 load from the per-user tree. Assisted-by: Claude:claude-opus-5 Signed-off-by: Vadim Peretokin <vadim.peretokin@mudlet.org> --- .github/workflows/build-mudlet-win-pr.yml | 8 ++++---- .github/workflows/build-mudlet-win.yml | 8 ++++---- CI/build-mudlet-for-windows.sh | 5 ++--- 3 files changed, 10 insertions(+), 11 deletions(-) diff --git a/.github/workflows/build-mudlet-win-pr.yml b/.github/workflows/build-mudlet-win-pr.yml index 5eca3f421..dfbda7039 100644 --- a/.github/workflows/build-mudlet-win-pr.yml +++ b/.github/workflows/build-mudlet-win-pr.yml @@ -132,9 +132,9 @@ jobs: - name: (Windows) Run QTest shell: msys2 {0} run: | - LUA_PATH=$(cygpath -u "$(luarocks --lua-version 5.1 path --lr-path)" ) + LUA_PATH=$(luarocks --lua-version 5.1 path --lr-path) export LUA_PATH - LUA_CPATH=$(cygpath -u "$(luarocks --lua-version 5.1 path --lr-cpath)" ) + LUA_CPATH=$(luarocks --lua-version 5.1 path --lr-cpath) export LUA_CPATH ctest --test-dir $GITHUB_WORKSPACE/build-$MSYSTEM/test --output-on-failure @@ -157,9 +157,9 @@ jobs: TESTS_DIRECTORY: ${{github.workspace}}/src/mudlet-lua/tests QUIT_MUDLET_AFTER_TESTS: 'true' run: | - LUA_PATH=$(cygpath -u "$(luarocks --lua-version 5.1 path --lr-path)" ) + LUA_PATH=$(luarocks --lua-version 5.1 path --lr-path) export LUA_PATH - LUA_CPATH=$(cygpath -u "$(luarocks --lua-version 5.1 path --lr-cpath)" ) + LUA_CPATH=$(luarocks --lua-version 5.1 path --lr-cpath) export LUA_CPATH # Linux and macOS start the fixture HTTP server in a step of their own, diff --git a/.github/workflows/build-mudlet-win.yml b/.github/workflows/build-mudlet-win.yml index 358965622..b07d37f99 100644 --- a/.github/workflows/build-mudlet-win.yml +++ b/.github/workflows/build-mudlet-win.yml @@ -109,9 +109,9 @@ jobs: - name: (Windows) Run QTest shell: msys2 {0} run: | - LUA_PATH=$(cygpath -u "$(luarocks --lua-version 5.1 path --lr-path)" ) + LUA_PATH=$(luarocks --lua-version 5.1 path --lr-path) export LUA_PATH - LUA_CPATH=$(cygpath -u "$(luarocks --lua-version 5.1 path --lr-cpath)" ) + LUA_CPATH=$(luarocks --lua-version 5.1 path --lr-cpath) export LUA_CPATH ctest --test-dir $GITHUB_WORKSPACE/build-$MSYSTEM/test --output-on-failure @@ -129,9 +129,9 @@ jobs: TESTS_DIRECTORY: ${{github.workspace}}/src/mudlet-lua/tests QUIT_MUDLET_AFTER_TESTS: 'true' run: | - LUA_PATH=$(cygpath -u "$(luarocks --lua-version 5.1 path --lr-path)" ) + LUA_PATH=$(luarocks --lua-version 5.1 path --lr-path) export LUA_PATH - LUA_CPATH=$(cygpath -u "$(luarocks --lua-version 5.1 path --lr-cpath)" ) + LUA_CPATH=$(luarocks --lua-version 5.1 path --lr-cpath) export LUA_CPATH # Linux and macOS start the fixture HTTP server in a step of their own, diff --git a/CI/build-mudlet-for-windows.sh b/CI/build-mudlet-for-windows.sh index 8f9c13519..567a0a1ca 100644 --- a/CI/build-mudlet-for-windows.sh +++ b/CI/build-mudlet-for-windows.sh @@ -112,10 +112,9 @@ mkdir -p "build-${MSYSTEM}" cd "${GITHUB_WORKSPACE}"/build-"${MSYSTEM}" || exit 1 #### Lua environment setup #### -# Set up Lua 5.1 paths for translation processing and runtime -LUA_PATH=$(cygpath -u "$(luarocks --lua-version 5.1 path --lr-path)" ) +LUA_PATH=$(luarocks --lua-version 5.1 path --lr-path) export LUA_PATH -LUA_CPATH=$(cygpath -u "$(luarocks --lua-version 5.1 path --lr-cpath)" ) +LUA_CPATH=$(luarocks --lua-version 5.1 path --lr-cpath) export LUA_CPATH echo "" From 61c2afd40630ffc013aad33205dc352cae3632d0 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Mon, 10 Aug 2026 22:17:09 +0200 Subject: [PATCH 139/155] Fix an empty XDG config directory hiding every profile (#9712) #### Brief overview of PR changes/additions - An empty `$XDG_CONFIG_HOME/mudlet` silently beat a populated `~/.config/mudlet`, so a stray `mkdir` hid every profile and Mudlet ran its first-launch onboarding as though the user were new. It also stuck: the first such launch wrote `Mudlet.ini` into that directory, which then kept it winning. - The two candidate roots are now ranked (`profiles/` > `Mudlet.ini` > exists > absent) and the stronger claim wins, with `$XDG_CONFIG_HOME/mudlet` taking ties so a fresh install and a deliberate opt-in both still land there. A directory that cannot be listed counts as populated rather than empty, so a permission bit cannot re-enter the bug. - Creating `profiles/` is now the opt-in a test harness uses; the `mudlet` directory alone is not, because other tooling creates that by accident. Where both roots hold profiles, `setupConfig()` names the one it is ignoring instead of leaving those profiles apparently gone. #### Motivation for adding to Mudlet Data-loss-shaped regression from #9552 "improve: honor XDG_CONFIG_HOME for Mudlet's config directory" (`e6c268cb0`). The profiles are orphaned rather than destroyed, but a returning user sees "5.0 wiped my profiles". `src/mudlet-lua/tests/README.md` itself instructed `mkdir -p "$CONFIG_DIR/mudlet"`, so following Mudlet's own test docs triggered it. #### Other info (issues closed, discussion etc) Test case: create `~/.config/mudlet/profiles/{AlphaGame,BetaGame}`, `mkdir -p $XDG_CONFIG_HOME/mudlet`, launch. Before: no profiles and the onboarding dialog. After: both profiles listed. `ConfigDirOverrideTest` covers the resolution table including the sticky `Mudlet.ini` state, both-populated, symlinked and unreadable directories; each new guard was mutation-checked. The busted suite passes 2422/0 against an isolated `$XDG_CONFIG_HOME/mudlet/profiles` root. Not fixed here, and pre-existing rather than 5.0 regressions: `CredentialManager` stores passwords and the OAuth reconnect token under `AppConfigLocation` while the config root is `confPath`, so exporting `XDG_CONFIG_HOME` strands them, and the plaintext-password migration reads one path, writes the other and deletes the original. Both reproduce identically on the 4.22.0 binary and need their own migration path. Assisted-by: Claude:claude-opus-5 --- src/mudlet-lua/tests/README.md | 10 +- src/mudlet.cpp | 12 +- src/utils.h | 103 ++++++--- .../ConfigDirOverrideTest.cpp | 206 +++++++++++++++++- .../DefaultGameDeleteTest.cpp | 6 +- .../ExperiencedPlayerGateTest.cpp | 6 +- .../ProfileFolderNameTest.cpp | 2 +- 7 files changed, 302 insertions(+), 43 deletions(-) diff --git a/src/mudlet-lua/tests/README.md b/src/mudlet-lua/tests/README.md index a3207b826..ed12ab0ea 100644 --- a/src/mudlet-lua/tests/README.md +++ b/src/mudlet-lua/tests/README.md @@ -76,15 +76,17 @@ run is not cleaned up. To give a run its own pristine, isolated config root: - `XDG_CONFIG_HOME` - Mudlet uses `$XDG_CONFIG_HOME/mudlet` as its config root (profiles, sqlite databases, settings, and password storage). Because an - existing `~/.config/mudlet` otherwise wins (so a system-wide `XDG_CONFIG_HOME` - export never strands real profiles), a test harness must **pre-create** - `$XDG_CONFIG_HOME/mudlet` to opt in. + existing `~/.config/mudlet` holding profiles otherwise wins (so a system-wide + `XDG_CONFIG_HOME` export never strands real profiles), a test harness must + **pre-create** `$XDG_CONFIG_HOME/mudlet/profiles` to opt in. The `mudlet` + directory on its own is not enough - other tooling creates that by accident, + and treating it as an opt-in would hide the user's real profiles. - `MUDLET_TEST_FAILURE_MARKER` - absolute path for the failure marker, so it is not shared either. ```sh CONFIG_DIR=$(mktemp -d) -mkdir -p "$CONFIG_DIR/mudlet" # pre-create to opt into the isolated config root +mkdir -p "$CONFIG_DIR/mudlet/profiles" # pre-create to opt into the isolated config root AUTORUN_BUSTED_TESTS=true \ MUDLET_TEST_MODE=1 \ QUIT_MUDLET_AFTER_TESTS=true \ diff --git a/src/mudlet.cpp b/src/mudlet.cpp index e430517aa..da61719dd 100644 --- a/src/mudlet.cpp +++ b/src/mudlet.cpp @@ -174,9 +174,11 @@ mudlet::mudlet() // Initialisation happens later in setupConfig() and init() } +static bool anyProfilesExist(const QString& profilesPath); + void mudlet::init() { - smFirstLaunch = !QFile::exists(mudlet::getMudletPath(enums::profilesPath)); + smFirstLaunch = !anyProfilesExist(mudlet::getMudletPath(enums::profilesPath)); // Must be after setupConfig() created mpSettings and before anything of this run is written rememberFirstLaunch(*mpSettings, mudlet::getMudletPath(enums::profilesPath), QDateTime::currentDateTime()); @@ -948,8 +950,12 @@ void mudlet::setupConfig() const auto resolution = utils::xdgConfigDir(confDirDefault); confPath = resolution.path; if (resolution.migrationPending) { - qInfo().nospace() << "mudlet::setupConfig() INFO: XDG_CONFIG_HOME is set but $XDG_CONFIG_HOME/mudlet is not a Mudlet config directory yet, so the existing " << confPath - << " is still in use. Move it to $XDG_CONFIG_HOME/mudlet to migrate."; + qInfo().nospace() << "mudlet::setupConfig() INFO: XDG_CONFIG_HOME is set but $XDG_CONFIG_HOME/mudlet holds no profiles, so the existing " << confPath + << " is still in use. Move its contents into $XDG_CONFIG_HOME/mudlet to migrate."; + } + if (!resolution.shadowedProfilesPath.isEmpty()) { + qWarning().nospace() << "mudlet::setupConfig() WARN: using $XDG_CONFIG_HOME/mudlet (" << confPath << ") because it holds profiles, but " << resolution.shadowedProfilesPath + << " holds profiles as well and they will not be listed. Unset XDG_CONFIG_HOME to use that directory instead."; } } qDebug() << "mudlet::setupConfig() INFO:" << "using config dir:" << confPath; diff --git a/src/utils.h b/src/utils.h index 1b2d8681f..d2bb3e1cf 100644 --- a/src/utils.h +++ b/src/utils.h @@ -171,43 +171,96 @@ public: struct ConfigDirResolution { QString path; - // True only in the migration-guard case: XDG_CONFIG_HOME is set but - // $XDG_CONFIG_HOME/mudlet is not (yet) Mudlet's, so an existing legacy - // dir is used instead. The caller can then hint the user how to migrate. + // XDG_CONFIG_HOME is set, but an existing legacy dir was used anyway, so + // the caller can hint at the migration bool migrationPending = false; + // legacyDefault, when it holds profiles that the chosen dir now hides. The + // caller has to name it, or those profiles read as gone. + QString shadowedProfilesPath; }; - // Resolve Mudlet's config root honoring XDG_CONFIG_HOME, with a migration - // guard. The caller handles portable.txt first (it still wins); this covers - // the rest: - // - XDG_CONFIG_HOME unset/empty/relative -> legacyDefault (~/.config/mudlet) - // - $XDG_CONFIG_HOME/mudlet is Mudlet's -> it (already migrated / opt-in) - // - not Mudlet's but legacyDefault exists -> legacyDefault, so exporting - // XDG_CONFIG_HOME never strands existing profiles - // - neither is usable -> $XDG_CONFIG_HOME/mudlet (fresh) - // "Mudlet's" means the dir holds a Mudlet.ini or profiles/, or is an empty - // opt-in dir a test harness pre-created. This deliberately ignores the stale - // $XDG_CONFIG_HOME/mudlet/Mudlet.conf that pre-4.19 Mudlet wrote there (its - // NativeFormat settings) while profiles stayed in ~/.config/mudlet - treating - // that leftover as the config root would hide such a user's profiles. + // How strongly a directory claims to be Mudlet's config root; the stronger + // claim wins in xdgConfigDir(), so the order is the contract. + enum class ConfigDirClaim { + absent = 0, + // Exists, but holds nothing Mudlet put there - including the stale + // Mudlet.conf pre-4.19 Mudlet left in $XDG_CONFIG_HOME/mudlet while its + // profiles stayed in ~/.config/mudlet + unclaimed = 1, + settings = 2, + profiles = 3, + }; + + // A directory that cannot be listed must never read as "nothing here": that + // inference is what hides profiles, so assume the strongest content instead. + static bool configDirHoldsProfiles(const QString& dir) + { + if (!QDir(dir).exists()) { + return false; + } + if (!QFileInfo(dir).isReadable()) { + return true; + } + const QDir profiles(qsl("%1/profiles").arg(dir)); + if (!profiles.exists()) { + return false; + } + // Counted as mudlet.cpp's anyProfilesExist() does, so the two cannot disagree + return !QFileInfo(profiles.path()).isReadable() || !profiles.entryList(QDir::Dirs | QDir::NoDotAndDotDot).isEmpty(); + } + + static ConfigDirClaim configDirClaim(const QString& dir) + { + if (!QDir(dir).exists()) { + return ConfigDirClaim::absent; + } + if (configDirHoldsProfiles(dir)) { + return ConfigDirClaim::profiles; + } + if (QFileInfo::exists(qsl("%1/Mudlet.ini").arg(dir))) { + return ConfigDirClaim::settings; + } + return ConfigDirClaim::unclaimed; + } + + // $XDG_CONFIG_HOME/mudlet claims more than it holds, because creating + // profiles/ there is the deliberate opt-in into an isolated config root. The + // legacy dir gets no such credit: an empty profiles/ left behind by deleting + // the last profile would otherwise outrank a config root in active use. + static ConfigDirClaim xdgConfigDirClaim(const QString& dir) + { + if (QDir(qsl("%1/profiles").arg(dir)).exists()) { + return ConfigDirClaim::profiles; + } + return configDirClaim(dir); + } + + // cleanPath() is not enough: a symlinked ~/.config gives one directory two + // spellings, and dotfile managers produce exactly that + static QString configDirIdentity(const QString& dir) + { + const QString canonical = QFileInfo(dir).canonicalFilePath(); + return canonical.isEmpty() ? QDir::cleanPath(dir) : canonical; + } + + // Resolve Mudlet's config root honoring XDG_CONFIG_HOME; the caller handles + // portable.txt first, which still wins. $XDG_CONFIG_HOME/mudlet takes a tie so + // that a fresh install lands there. static ConfigDirResolution xdgConfigDir(const QString& legacyDefault) { const QString xdgConfigHome = qEnvironmentVariable("XDG_CONFIG_HOME"); // The XDG base-dir spec requires an absolute path; a relative (or empty) // value must be ignored, which also avoids a surprising CWD-relative root. if (xdgConfigHome.isEmpty() || !QDir::isAbsolutePath(xdgConfigHome)) { - return {legacyDefault, false}; + return {legacyDefault, false, QString()}; } const QString xdgTarget = QDir::cleanPath(qsl("%1/mudlet").arg(xdgConfigHome)); - const QDir xdgDir(xdgTarget); - const bool xdgIsMudlets = xdgDir.exists() && (QFileInfo::exists(qsl("%1/Mudlet.ini").arg(xdgTarget)) || QDir(qsl("%1/profiles").arg(xdgTarget)).exists() || xdgDir.isEmpty()); - if (xdgIsMudlets) { - return {xdgTarget, false}; + if (xdgConfigDirClaim(xdgTarget) < configDirClaim(legacyDefault)) { + return {legacyDefault, true, QString()}; } - if (QDir(legacyDefault).exists()) { - return {legacyDefault, true}; - } - return {xdgTarget, false}; + // XDG_CONFIG_HOME=$HOME/.config makes both candidates one directory + const bool shadowing = configDirIdentity(legacyDefault) != configDirIdentity(xdgTarget) && configDirHoldsProfiles(legacyDefault); + return {xdgTarget, false, shadowing ? legacyDefault : QString()}; } inline static const auto scmfileSystemUnsafeChars = QRegularExpression(qsl(R"REGEX([/\\:*?"<>|])REGEX")); diff --git a/test/functional_tests/ConfigDirOverrideTest.cpp b/test/functional_tests/ConfigDirOverrideTest.cpp index 201102e90..735ee99dd 100644 --- a/test/functional_tests/ConfigDirOverrideTest.cpp +++ b/test/functional_tests/ConfigDirOverrideTest.cpp @@ -25,6 +25,9 @@ * or the guard, which resurfaces as parallel-run sqlite flakiness or, worse, * users' profiles appearing to vanish on upgrade. * + * Creating $XDG_CONFIG_HOME/mudlet/profiles is the opt-in; the directory above it + * on its own is not, because that is a state other tooling creates by accident. + * * The resolution logic lives in utils::xdgConfigDir(legacyDefault), which takes * the legacy candidate as an argument, so most cases test it directly and stay * platform-independent (no HOME/USERPROFILE juggling). A couple of cases drive @@ -47,6 +50,14 @@ private: QString mudletUnder(const QString& dir) const { return QDir::cleanPath(qsl("%1/mudlet").arg(dir)); } + bool makeProfile(const QString& configDir, const QString& profileName) const { return QDir().mkpath(qsl("%1/profiles/%2").arg(configDir, profileName)); } + + bool makeSettingsFile(const QString& configDir) const + { + QFile ini(qsl("%1/Mudlet.ini").arg(configDir)); + return ini.open(QIODevice::WriteOnly); + } + // setupConfig() consults portable.txt beside the executable and in the home // config dir before the XDG/default logic; the setupConfig() integration // cases skip if one is present rather than report a baffling failure. @@ -101,13 +112,13 @@ private slots: QVERIFY(!r.migrationPending); } - void test_emptyXdgDirIsOptInAndWinsOverLegacy() + void test_emptyXdgDirWinsOverALegacyDirWithoutProfiles() { QTemporaryDir xdg; QTemporaryDir legacyHome; QVERIFY(xdg.isValid() && legacyHome.isValid()); const QString target = mudletUnder(xdg.path()); - QVERIFY(QDir().mkpath(target)); // empty opt-in dir + QVERIFY(QDir().mkpath(target)); const QString legacy = mudletUnder(legacyHome.path() + qsl("/.config")); QVERIFY(QDir().mkpath(legacy)); qputenv("XDG_CONFIG_HOME", xdg.path().toUtf8()); @@ -115,6 +126,78 @@ private slots: const auto r = utils::xdgConfigDir(legacy); QCOMPARE(r.path, target); QVERIFY(!r.migrationPending); + QVERIFY(r.shadowedProfilesPath.isEmpty()); + } + + // A dotfile manager, container script or aborted move leaves this directory behind. + void test_emptyXdgDirDoesNotHideLegacyProfiles() + { + QTemporaryDir xdg; + QTemporaryDir legacyHome; + QVERIFY(xdg.isValid() && legacyHome.isValid()); + QVERIFY(QDir().mkpath(mudletUnder(xdg.path()))); + const QString legacy = mudletUnder(legacyHome.path() + qsl("/.config")); + QVERIFY(makeProfile(legacy, qsl("AlphaGame"))); + qputenv("XDG_CONFIG_HOME", xdg.path().toUtf8()); + + const auto r = utils::xdgConfigDir(legacy); + QCOMPARE(r.path, legacy); + QVERIFY(r.migrationPending); + QVERIFY(r.shadowedProfilesPath.isEmpty()); + } + + // The state one bad launch leaves behind, since Mudlet writes its Mudlet.ini + // into whichever dir it chose. Deleting that dir has to be enough to recover. + void test_xdgSettingsFileDoesNotHideLegacyProfiles() + { + QTemporaryDir xdg; + QTemporaryDir legacyHome; + QVERIFY(xdg.isValid() && legacyHome.isValid()); + const QString target = mudletUnder(xdg.path()); + QVERIFY(QDir().mkpath(qsl("%1/fonts").arg(target))); + QVERIFY(makeSettingsFile(target)); + const QString legacy = mudletUnder(legacyHome.path() + qsl("/.config")); + QVERIFY(makeProfile(legacy, qsl("AlphaGame"))); + QVERIFY(makeProfile(legacy, qsl("BetaGame"))); + qputenv("XDG_CONFIG_HOME", xdg.path().toUtf8()); + + const auto r = utils::xdgConfigDir(legacy); + QCOMPARE(r.path, legacy); + QVERIFY(r.migrationPending); + QVERIFY(r.shadowedProfilesPath.isEmpty()); + } + + void test_xdgProfilesDirWinsAndReportsShadowedLegacyProfiles() + { + QTemporaryDir xdg; + QTemporaryDir legacyHome; + QVERIFY(xdg.isValid() && legacyHome.isValid()); + const QString target = mudletUnder(xdg.path()); + QVERIFY(QDir().mkpath(qsl("%1/profiles").arg(target))); + const QString legacy = mudletUnder(legacyHome.path() + qsl("/.config")); + QVERIFY(makeProfile(legacy, qsl("AlphaGame"))); + qputenv("XDG_CONFIG_HOME", xdg.path().toUtf8()); + + const auto r = utils::xdgConfigDir(legacy); + QCOMPARE(r.path, target); + QVERIFY(!r.migrationPending); + QCOMPARE(r.shadowedProfilesPath, legacy); + } + + void test_noShadowReportedWhenLegacyProfilesDirIsEmpty() + { + QTemporaryDir xdg; + QTemporaryDir legacyHome; + QVERIFY(xdg.isValid() && legacyHome.isValid()); + const QString target = mudletUnder(xdg.path()); + QVERIFY(QDir().mkpath(qsl("%1/profiles").arg(target))); + const QString legacy = mudletUnder(legacyHome.path() + qsl("/.config")); + QVERIFY(QDir().mkpath(qsl("%1/profiles").arg(legacy))); + qputenv("XDG_CONFIG_HOME", xdg.path().toUtf8()); + + const auto r = utils::xdgConfigDir(legacy); + QCOMPARE(r.path, target); + QVERIFY(r.shadowedProfilesPath.isEmpty()); } void test_migratedXdgDirWinsOverLegacy() @@ -147,7 +230,7 @@ private slots: QVERIFY(stale.open(QIODevice::WriteOnly)); stale.close(); const QString legacy = mudletUnder(legacyHome.path() + qsl("/.config")); - QVERIFY(QDir().mkpath(qsl("%1/profiles").arg(legacy))); // real profiles live here + QVERIFY(makeProfile(legacy, qsl("AlphaGame"))); // real profiles live here qputenv("XDG_CONFIG_HOME", xdg.path().toUtf8()); const auto r = utils::xdgConfigDir(legacy); @@ -155,6 +238,26 @@ private slots: QVERIFY2(r.migrationPending, "a stale non-Mudlet XDG dir must not shadow real profiles"); } + // Deleting the last profile leaves an empty legacy profiles/ behind, which + // must not pull a config root in active use back out of $XDG_CONFIG_HOME. + void test_emptyLegacyProfilesDirDoesNotOutrankXdgSettings() + { + QTemporaryDir xdg; + QTemporaryDir legacyHome; + QVERIFY(xdg.isValid() && legacyHome.isValid()); + const QString target = mudletUnder(xdg.path()); + QVERIFY(QDir().mkpath(target)); + QVERIFY(makeSettingsFile(target)); + const QString legacy = mudletUnder(legacyHome.path() + qsl("/.config")); + QVERIFY(QDir().mkpath(qsl("%1/profiles").arg(legacy))); + qputenv("XDG_CONFIG_HOME", xdg.path().toUtf8()); + + const auto r = utils::xdgConfigDir(legacy); + QCOMPARE(r.path, target); + QVERIFY(!r.migrationPending); + QVERIFY(r.shadowedProfilesPath.isEmpty()); + } + void test_guardKeepsLegacyWhenXdgTargetMissing() { QTemporaryDir xdg; @@ -168,6 +271,7 @@ private slots: const auto r = utils::xdgConfigDir(legacy); QCOMPARE(r.path, legacy); QVERIFY(r.migrationPending); + QVERIFY(r.shadowedProfilesPath.isEmpty()); } void test_freshInstallUsesXdgWhenNeitherExists() @@ -202,6 +306,81 @@ private slots: QVERIFY2(!r.migrationPending, "no migration when the XDG target and legacy dir are the same"); } + // XDG_CONFIG_HOME=$HOME/.config is an ordinary export, and would otherwise + // warn on every startup about the directory it is using. + void test_noSelfShadowWhenXdgTargetEqualsLegacyWithProfiles() + { + QTemporaryDir cfg; + QVERIFY(cfg.isValid()); + const QString legacy = mudletUnder(cfg.path()); + QVERIFY(makeProfile(legacy, qsl("AlphaGame"))); + qputenv("XDG_CONFIG_HOME", cfg.path().toUtf8()); + + const auto r = utils::xdgConfigDir(legacy); + QCOMPARE(r.path, legacy); + QVERIFY2(r.shadowedProfilesPath.isEmpty(), "a directory cannot shadow itself"); + } + + void test_noSelfShadowThroughASymlinkedConfigDir() + { + QTemporaryDir real; + QTemporaryDir linkHome; + QVERIFY(real.isValid() && linkHome.isValid()); + const QString legacy = mudletUnder(real.path()); + QVERIFY(makeProfile(legacy, qsl("AlphaGame"))); + const QString linked = qsl("%1/config-link").arg(linkHome.path()); + if (!QFile::link(real.path(), linked)) { + QSKIP("this filesystem does not support symlinks"); + } + qputenv("XDG_CONFIG_HOME", linked.toUtf8()); + + const auto r = utils::xdgConfigDir(legacy); + QVERIFY2(r.shadowedProfilesPath.isEmpty(), "one directory under two names is still one directory"); + } + + // The only case that observes the settings tier, and losing those settings + // drops firstLaunchDate, which re-runs onboarding. + void test_settingsOnlyLegacyOutranksEmptyXdgDir() + { + QTemporaryDir xdg; + QTemporaryDir legacyHome; + QVERIFY(xdg.isValid() && legacyHome.isValid()); + QVERIFY(QDir().mkpath(mudletUnder(xdg.path()))); + const QString legacy = mudletUnder(legacyHome.path() + qsl("/.config")); + QVERIFY(QDir().mkpath(legacy)); + QVERIFY(makeSettingsFile(legacy)); + qputenv("XDG_CONFIG_HOME", xdg.path().toUtf8()); + + const auto r = utils::xdgConfigDir(legacy); + QCOMPARE(r.path, legacy); + QVERIFY(r.migrationPending); + } + + void test_unreadableLegacyDirStillOutranksAnEmptyXdgDir() + { + QTemporaryDir xdg; + QTemporaryDir legacyHome; + QVERIFY(xdg.isValid() && legacyHome.isValid()); + QVERIFY(QDir().mkpath(mudletUnder(xdg.path()))); + const QString legacy = mudletUnder(legacyHome.path() + qsl("/.config")); + QVERIFY(makeProfile(legacy, qsl("AlphaGame"))); + // No traverse bit either, or QDir::exists() on profiles/ still answers and + // the ranking never has to fall back + if (!QFile::setPermissions(legacy, QFileDevice::Permissions())) { + QSKIP("cannot drop permissions on this filesystem"); + } + qputenv("XDG_CONFIG_HOME", xdg.path().toUtf8()); + + const auto r = utils::xdgConfigDir(legacy); + const bool readableAnyway = QFileInfo(legacy).isReadable(); + QVERIFY(QFile::setPermissions(legacy, QFileDevice::ReadOwner | QFileDevice::WriteOwner | QFileDevice::ExeOwner)); + if (readableAnyway) { + QSKIP("running as a user that bypasses permission bits"); + } + QCOMPARE(r.path, legacy); + QVERIFY(r.migrationPending); + } + // --- mudlet::setupConfig() end-to-end wiring ------------------------------ void test_setupConfigUsesPreCreatedXdgTarget() @@ -212,13 +391,32 @@ private slots: QTemporaryDir xdg; QVERIFY(xdg.isValid()); const QString target = mudletUnder(xdg.path()); - QVERIFY(QDir().mkpath(target)); + QVERIFY(QDir().mkpath(qsl("%1/profiles").arg(target))); qputenv("XDG_CONFIG_HOME", xdg.path().toUtf8()); mudlet::self()->setupConfig(); QCOMPARE(mudlet::getMudletPath(enums::mainPath), target); } + // The warning is all that tells an affected user where their other profiles went. + void test_setupConfigWarnsAboutShadowedLegacyProfiles() + { + if (portableMarkerPresent()) { + QSKIP("portable.txt present - setupConfig() takes the portable branch"); + } + const QString legacy = qsl("%1/.config/mudlet").arg(QDir::homePath()); + if (!utils::configDirHoldsProfiles(legacy)) { + QSKIP("no profiles in the real ~/.config/mudlet, so nothing can be shadowed"); + } + QTemporaryDir xdg; + QVERIFY(xdg.isValid()); + QVERIFY(QDir().mkpath(qsl("%1/profiles").arg(mudletUnder(xdg.path())))); + qputenv("XDG_CONFIG_HOME", xdg.path().toUtf8()); + + QTest::ignoreMessage(QtWarningMsg, QRegularExpression(qsl("holds profiles as well"))); + mudlet::self()->setupConfig(); + } + // With XDG unset, the config root is the usual ~/.config/mudlet, so normal // users are unaffected. Uses the real home dir - no HOME override. void test_setupConfigUnsetUsesHomeConfigDir() diff --git a/test/functional_tests/DefaultGameDeleteTest.cpp b/test/functional_tests/DefaultGameDeleteTest.cpp index fdb9d7d22..5b476215c 100644 --- a/test/functional_tests/DefaultGameDeleteTest.cpp +++ b/test/functional_tests/DefaultGameDeleteTest.cpp @@ -76,9 +76,9 @@ private slots: initializeQRCResourcesForDefaultGameDeleteTest(); QVERIFY(mConfigDir.isValid()); - // pre-create $XDG_CONFIG_HOME/mudlet so setupConfig() adopts it and the - // test never touches the real profiles or settings - QVERIFY(QDir().mkpath(qsl("%1/mudlet").arg(mConfigDir.path()))); + // pre-create $XDG_CONFIG_HOME/mudlet/profiles so setupConfig() adopts it + // and the test never touches the real profiles or settings + QVERIFY(QDir().mkpath(qsl("%1/mudlet/profiles").arg(mConfigDir.path()))); mSavedXdg = qgetenv("XDG_CONFIG_HOME"); qputenv("XDG_CONFIG_HOME", mConfigDir.path().toUtf8()); diff --git a/test/functional_tests/ExperiencedPlayerGateTest.cpp b/test/functional_tests/ExperiencedPlayerGateTest.cpp index 6aee13dd5..eab99f5cc 100644 --- a/test/functional_tests/ExperiencedPlayerGateTest.cpp +++ b/test/functional_tests/ExperiencedPlayerGateTest.cpp @@ -296,17 +296,17 @@ private slots: QSKIP("portable.txt present - setupConfig() takes the portable branch"); } QVERIFY(mLiveConfig.isValid()); - // An empty $XDG_CONFIG_HOME/mudlet is the opt-in marker, without which + // $XDG_CONFIG_HOME/mudlet/profiles is the opt-in marker, without which // setupConfig() keeps using a legacy ~/.config/mudlet const QString configDir = qsl("%1/mudlet").arg(mLiveConfig.path()); - QVERIFY(QDir().mkpath(configDir)); + QVERIFY(QDir().mkpath(qsl("%1/profiles").arg(configDir))); qputenv("XDG_CONFIG_HOME", mLiveConfig.path().toUtf8()); initializeQRCResourcesForExperiencedPlayerGateTest(); mudlet::start(); mudlet::self()->setupConfig(); QCOMPARE(mudlet::getMudletPath(enums::mainPath), configDir); - QVERIFY(!QDir(mudlet::getMudletPath(enums::profilesPath)).exists()); + QVERIFY2(QDir(mudlet::getMudletPath(enums::profilesPath)).entryList(QDir::Dirs | QDir::NoDotAndDotDot).isEmpty(), "the opt-in profiles/ dir has to be empty, or this is not a fresh install"); mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique<MudletInstanceCoordinator>("MudletInstanceCoordinator")); mudlet::self()->init(); diff --git a/test/functional_tests/ProfileFolderNameTest.cpp b/test/functional_tests/ProfileFolderNameTest.cpp index 0d040162b..25a2b2c2f 100644 --- a/test/functional_tests/ProfileFolderNameTest.cpp +++ b/test/functional_tests/ProfileFolderNameTest.cpp @@ -129,7 +129,7 @@ private slots: mSavedXdg = qgetenv("XDG_CONFIG_HOME"); QVERIFY(mXdgDir.isValid()); - QVERIFY(QDir().mkpath(qsl("%1/mudlet").arg(mXdgDir.path()))); // empty dir = XDG opt-in + QVERIFY(QDir().mkpath(qsl("%1/mudlet/profiles").arg(mXdgDir.path()))); // profiles/ = XDG opt-in qputenv("XDG_CONFIG_HOME", mXdgDir.path().toUtf8()); mudlet::start(); From b58a93fa3849edcc6b06f0e261771a973910753a Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Mon, 10 Aug 2026 22:17:29 +0200 Subject: [PATCH 140/155] Fix: underscores and descenders no longer clipped at certain font sizes (#9743) **Not for 5.0 - please hold this for the release after 5.0.** #### Brief overview of PR changes/additions - `TTextEdit` lays text out in cells of `QFontMetrics::height()`, a typographic measure rather than the glyph ink box, so at many font sizes the ink of `_ g j p q y $ @ ( )` reaches a pixel past the bottom of its cell. On Bitstream Vera Sans Mono at 14pt the underscore is a 1px bar sitting entirely below the cell, so it disappears completely. - The screen is now rendered with each line's cell backgrounds painted before the previous line's glyphs, the screen pixmap has a spare row for the bottom line's overflow, and partial repaints and scroll blits put back the overflow they would otherwise erase. - With backgrounds no longer able to clobber overflow, the narrowed background-fill condition from #9288 goes back to what #8887 intended. Measured with an offscreen A/B of the same scene: 15.0-15.2ms per frame against 16.5-16.9ms before, on both the full-repaint and the scrolling path (ASan build, so treat the absolute numbers as relative only). #### Motivation for adding to Mudlet #9288 tried to fix this by letting the overflow pixel survive into the next line's cell, but four separate things still erase it: the next line's background fill whenever the colour differs (coloured text, selection, search highlight, caret, background image, alpha), the partial-repaint clear, the bottom edge of the screen pixmap, and the scroll blit. That is why the reporter sees different `print`-style functions behave differently at the same size. #### Other info (issues closed, discussion etc) Fixes #9719. Completes #9070, which #9288 only partly addressed. `GlyphOverflowTest` renders a real console offscreen across two bundled fonts and 22 font sizes and compares the underscore's ink against the same glyph drawn on its own. All five of its cases fail on `development` and pass here: the line below carrying a default, coloured, bright or selected background; the bottom visible line; a partial repaint; a scroll-back; and a miniconsole. Copy-as-image is fixed too: its pixmap is exactly one cell per selected line, so the bottom line's ink was cut off every time. Known limitations, both unchanged from before this PR: - The topmost visible line's ink can overflow above the pixmap and be clipped. Fixing it would mean shifting the whole screen-pixmap coordinate system. - When a pane's height is an exact multiple of the line height there is no leftover strip below the last line, so the bottom line's overflow has no pixel to live in. Measured at roughly 1 pane height in every 22 for both the main console and the split-screen lower pane. The only fix is to drop a row when there is no slack, and because rows are quantised that costs a whole line of text plus a blank line-height strip at the same ~4.5% of heights, which is a worse trade than the pixel it buys. Resizing the pane by one pixel restores it. Test case: `ctest -R GlyphOverflowTest`, or set Bitstream Vera Sans Mono at 14pt and `cecho("<yellow>plain _underscore_\n<white:blue>coloured line\n")`. Assisted-by: Claude:claude-opus-5 https://github.com/user-attachments/assets/cbda2288-1e3e-4f24-9763-7275d2f09134 --- src/TBuffer.cpp | 2 +- src/TTextEdit.cpp | 512 ++++++++------ src/TTextEdit.h | 48 +- test/functional_tests/CMakeLists.txt | 5 + test/functional_tests/GlyphOverflowTest.cpp | 718 ++++++++++++++++++++ 5 files changed, 1067 insertions(+), 218 deletions(-) create mode 100644 test/functional_tests/GlyphOverflowTest.cpp diff --git a/src/TBuffer.cpp b/src/TBuffer.cpp index 4b969417e..8228826c9 100644 --- a/src/TBuffer.cpp +++ b/src/TBuffer.cpp @@ -5845,7 +5845,7 @@ QString TBuffer::bufferToHtml(const bool showTimeStamp /*= false*/, const int ro // we will NOT need a closing "</span>" if (showTimeStamp && !timeBuffer.at(row).isEmpty()) { // Use the console's background so the timestamp blends in with the - // rest of the text, as done in TTextEdit::drawLine(...). + // rest of the text, as done in TTextEdit::layoutLine(...). const QColor timeStampBgColor{mpConsole ? mpConsole->getConsoleBgColor() : QColor(Qt::black)}; s.append(qsl("<span style=\"color: rgb(200,150,0); background: %1; \">%2").arg(timeStampBgColor.name(), timeBuffer.at(row).left(mudlet::smTimeStampFormat.length()))); // Set the current idea of what the formatting is so we can spot if it diff --git a/src/TTextEdit.cpp b/src/TTextEdit.cpp index dd3d9a839..89aecd984 100644 --- a/src/TTextEdit.cpp +++ b/src/TTextEdit.cpp @@ -452,29 +452,30 @@ void TTextEdit::scrollDown(int lines) } } -void TTextEdit::drawLine(QPainter& painter, int lineNumber, int lineOfScreen, int* offset) const +bool TTextEdit::hasBufferLine(int lineNumber) const { + return lineNumber >= 0 && lineNumber < static_cast<int>(mpBuffer->buffer.size()); +} + +TChar TTextEdit::timeStampCharStyle() const +{ + return TChar(QColor(200, 150, 0), mpConsole->getConsoleBgColor()); +} + +void TTextEdit::layoutLine(int lineNumber, int lineOfScreen, const TChar& timeStampStyle, LineLayout& layout, int* offset) const +{ + layout.clear(); QPoint cursor(-mCursorX, lineOfScreen); - QString lineText = mpBuffer->lineBuffer.at(lineNumber); + const QString lineText = mpBuffer->lineBuffer.at(lineNumber); QTextBoundaryFinder boundaryFinder(QTextBoundaryFinder::Grapheme, lineText); int currentSize = lineText.size(); if (mpConsole->showTimeStamps()) { - TChar timeStampStyle(QColor(200, 150, 0), mpConsole->getConsoleBgColor()); - QString timestamp(mpBuffer->timeBuffer.at(lineNumber)); - QVector<QColor> fgColors; - QVector<QRect> textRects; - QVector<int> charWidths; - QVector<QString> graphemes; + const QString timestamp(mpBuffer->timeBuffer.at(lineNumber)); for (const QChar c : timestamp) { // The column argument is not incremented here (is fixed at 0) so // the timestamp does not take up any places when it is clicked on // by the mouse... - cursor.setX(cursor.x() + drawGraphemeBackground(painter, fgColors, textRects, graphemes, charWidths, cursor, c, 0, lineNumber, timeStampStyle)); - } - int index = -1; - for (const QChar c : timestamp) { - ++index; - drawGraphemeForeground(painter, fgColors.at(index), textRects.at(index), c, timeStampStyle); + cursor.setX(cursor.x() + layoutGrapheme(layout, cursor, c, 0, lineNumber, timeStampStyle)); } currentSize += mudlet::smTimeStampFormat.size(); } @@ -485,414 +486,421 @@ void TTextEdit::drawLine(QPainter& painter, int lineNumber, int lineOfScreen, in } int columnWithOutTimestamp = 0; - QVector<QColor> fgColors; - QVector<QRect> textRects; - QVector<int> charWidths; - QVector<QString> graphemes; for (int indexOfChar = 0, total = lineText.size(); indexOfChar < total;) { - int nextBoundary = boundaryFinder.toNextBoundary(); + const int nextBoundary = boundaryFinder.toNextBoundary(); + if (Q_UNLIKELY(nextBoundary <= indexOfChar)) { + // toNextBoundary() reports -1 once it can no longer advance, which + // would send indexOfChar backwards and index the line out of bounds + break; + } - TChar& charStyle = mpBuffer->buffer.at(lineNumber).at(indexOfChar); - int graphemeWidth = drawGraphemeBackground( - painter, fgColors, textRects, graphemes, charWidths, cursor, lineText.mid(indexOfChar, nextBoundary - indexOfChar), columnWithOutTimestamp, lineNumber, charStyle); + const TChar& charStyle = mpBuffer->buffer.at(lineNumber).at(indexOfChar); + const int graphemeWidth = layoutGrapheme(layout, cursor, lineText.mid(indexOfChar, nextBoundary - indexOfChar), columnWithOutTimestamp, lineNumber, charStyle); cursor.setX(cursor.x() + graphemeWidth); indexOfChar = nextBoundary; columnWithOutTimestamp += graphemeWidth; } - boundaryFinder.toStart(); - int index = -1; - for (int indexOfChar = 0, total = lineText.size(); indexOfChar < total;) { - int nextBoundary = boundaryFinder.toNextBoundary(); - - TChar& charStyle = mpBuffer->buffer.at(lineNumber).at(indexOfChar); - ++index; - drawGraphemeForeground(painter, fgColors.at(index), textRects.at(index), graphemes.at(index), charStyle); - indexOfChar = nextBoundary; - } // If caret mode is enabled and the line is empty, still draw the caret. if (mpHost && mpHost->caretEnabled() && mCaretLine == lineNumber && lineText.isEmpty()) { - auto textRect = QRect(0, mFontHeight * lineOfScreen, mFontWidth, mFontHeight); - painter.fillRect(textRect, mCaretColor); + GraphemeRun caretRun; + caretRun.textRect = QRect(0, mFontHeight * lineOfScreen, mFontWidth, mFontHeight); + caretRun.bgColor = mCaretColor; + caretRun.fillsBackground = true; + layout.push_back(std::move(caretRun)); } } -void TTextEdit::replaceControlCharacterWith_Picture(const uint unicode, const QString& grapheme, const int column, QVector<QString>& graphemes, int& charWidth) const +void TTextEdit::paintBackgrounds(QPainter& painter, const LineLayout& layout) const +{ + for (const GraphemeRun& run : layout) { + if (run.fillsBackground) { + painter.fillRect(run.textRect, run.bgColor); + } + } +} + +void TTextEdit::paintForegrounds(QPainter& painter, const LineLayout& layout, const QRect& clip) const +{ + if (layout.empty()) { + return; + } + if (!clip.isNull()) { + painter.save(); + painter.setClipRect(clip); + } + for (const GraphemeRun& run : layout) { + if (run.style) { + paintGraphemeForeground(painter, run); + } + } + if (!clip.isNull()) { + painter.restore(); + } +} + +void TTextEdit::replaceControlCharacterWith_Picture(const uint unicode, const QString& grapheme, const int column, QString& outGrapheme, int& charWidth) const { switch (unicode) { case 0: - graphemes.append(QChar(0x2400)); + outGrapheme = QChar(0x2400); charWidth = 1; break; // NUL - not sure that this can appear case 1: - graphemes.append(QChar(0x2401)); + outGrapheme = QChar(0x2401); charWidth = 1; break; // SOH case 2: - graphemes.append(QChar(0x2402)); + outGrapheme = QChar(0x2402); charWidth = 1; break; // STX case 3: - graphemes.append(QChar(0x2403)); + outGrapheme = QChar(0x2403); charWidth = 1; break; // ETX case 4: - graphemes.append(QChar(0x2404)); + outGrapheme = QChar(0x2404); charWidth = 1; break; // EOT case 5: - graphemes.append(QChar(0x2405)); + outGrapheme = QChar(0x2405); charWidth = 1; break; // ENQ case 6: - graphemes.append(QChar(0x2406)); + outGrapheme = QChar(0x2406); charWidth = 1; break; // ACK case 7: - graphemes.append(QChar(0x2407)); + outGrapheme = QChar(0x2407); charWidth = 1; break; // BEL - the (audio) handling of this gets done when it is received, not when it is displayed here: case 8: - graphemes.append(QChar(0x2408)); + outGrapheme = QChar(0x2408); charWidth = 1; break; // BS case 9: // HT // Makes the spacing behave like a tab charWidth = mTabStopwidth - (column % mTabStopwidth); // But print the "control picture" on top - graphemes.append(QChar(0x2409)); + outGrapheme = QChar(0x2409); break; case 10: - graphemes.append(QChar(0x240A)); + outGrapheme = QChar(0x240A); charWidth = 1; break; // LF - may not ever appear! case 11: - graphemes.append(QChar(0x240B)); + outGrapheme = QChar(0x240B); charWidth = 1; break; // VT case 12: - graphemes.append(QChar(0x240C)); + outGrapheme = QChar(0x240C); charWidth = 1; break; // FF case 13: - graphemes.append(QChar(0x240D)); + outGrapheme = QChar(0x240D); charWidth = 1; break; // CR - shouldn't appear but does seem to crop up somehow! case 14: - graphemes.append(QChar(0x240E)); + outGrapheme = QChar(0x240E); charWidth = 1; break; // SO case 15: - graphemes.append(QChar(0x240F)); + outGrapheme = QChar(0x240F); charWidth = 1; break; // SI case 16: - graphemes.append(QChar(0x2410)); + outGrapheme = QChar(0x2410); charWidth = 1; break; // DLE case 17: - graphemes.append(QChar(0x2411)); + outGrapheme = QChar(0x2411); charWidth = 1; break; // DC1 case 18: - graphemes.append(QChar(0x2412)); + outGrapheme = QChar(0x2412); charWidth = 1; break; // DC2 case 19: - graphemes.append(QChar(0x2413)); + outGrapheme = QChar(0x2413); charWidth = 1; break; // DC3 case 20: - graphemes.append(QChar(0x2414)); + outGrapheme = QChar(0x2414); charWidth = 1; break; // DC4 case 21: - graphemes.append(QChar(0x2415)); + outGrapheme = QChar(0x2415); charWidth = 1; break; // NAK case 22: - graphemes.append(QChar(0x2416)); + outGrapheme = QChar(0x2416); charWidth = 1; break; // SYN case 23: - graphemes.append(QChar(0x2417)); + outGrapheme = QChar(0x2417); charWidth = 1; break; // ETB case 24: - graphemes.append(QChar(0x2418)); + outGrapheme = QChar(0x2418); charWidth = 1; break; // CAN case 25: - graphemes.append(QChar(0x2419)); + outGrapheme = QChar(0x2419); charWidth = 1; break; // EM case 26: - graphemes.append(QChar(0x241A)); + outGrapheme = QChar(0x241A); charWidth = 1; break; // SUB case 27: - graphemes.append(QChar(0x241B)); + outGrapheme = QChar(0x241B); charWidth = 1; break; // ESC - shouldn't appear as will have been intercepted previously case 28: - graphemes.append(QChar(0x241C)); + outGrapheme = QChar(0x241C); charWidth = 1; break; // FS case 29: - graphemes.append(QChar(0x241D)); + outGrapheme = QChar(0x241D); charWidth = 1; break; // GS case 30: - graphemes.append(QChar(0x241E)); + outGrapheme = QChar(0x241E); charWidth = 1; break; // RS case 31: - graphemes.append(QChar(0x241F)); + outGrapheme = QChar(0x241F); charWidth = 1; break; // US case 127: - graphemes.append(QChar(0x2421)); + outGrapheme = QChar(0x2421); charWidth = 1; break; // DEL default: charWidth = getGraphemeWidth(unicode); - graphemes.append((charWidth < 1) ? QChar() : grapheme); + outGrapheme = (charWidth < 1) ? QString() : grapheme; } } -void TTextEdit::replaceControlCharacterWith_OEMFont(const uint unicode, const QString& grapheme, const int column, QVector<QString>& graphemes, int& charWidth) const +void TTextEdit::replaceControlCharacterWith_OEMFont(const uint unicode, const QString& grapheme, const int column, QString& outGrapheme, int& charWidth) const { Q_UNUSED(column) switch (unicode) { case 0: - graphemes.append(QString(QChar::Space)); + outGrapheme = QString(QChar::Space); charWidth = 1; break; // NUL - not sure that this can appear and the OEM font treats it as a space case 1: - graphemes.append(QChar(0x263A)); + outGrapheme = QChar(0x263A); charWidth = 1; break; // SOH - White Smiling Face case 2: - graphemes.append(QChar(0x263B)); + outGrapheme = QChar(0x263B); charWidth = 1; break; // STX - Black Smiling Face case 3: - graphemes.append(QChar(0x2665)); + outGrapheme = QChar(0x2665); charWidth = 1; break; // ETX - Black Heart Suite case 4: - graphemes.append(QChar(0x2666)); + outGrapheme = QChar(0x2666); charWidth = 1; break; // EOT - Black Diamond Suite case 5: - graphemes.append(QChar(0x2663)); + outGrapheme = QChar(0x2663); charWidth = 1; break; // ENQ - Black ClubsSuite case 6: - graphemes.append(QChar(0x2660)); + outGrapheme = QChar(0x2660); charWidth = 1; break; // ACK - Black Spade Suite case 7: - graphemes.append(QChar(0x2022)); + outGrapheme = QChar(0x2022); charWidth = 1; break; // BEL - Bullet - the handling of this gets done when it is received, not when it is displayed here: case 8: - graphemes.append(QChar(0x25D8)); + outGrapheme = QChar(0x25D8); charWidth = 1; break; // BS - Inverse Bullet case 9: // NOTE THAT WE DO NOT USE TAB SPACING FOR THIS MODE: - graphemes.append(QChar(0x25CB)); + outGrapheme = QChar(0x25CB); charWidth = 1; break; // HT - Circle case 10: - graphemes.append(QChar(0x25D9)); + outGrapheme = QChar(0x25D9); charWidth = 1; break; // LF - Inverse Circle case 11: - graphemes.append(QChar(0x2642)); + outGrapheme = QChar(0x2642); charWidth = 1; break; // VT - Male Sign case 12: - graphemes.append(QChar(0x2640)); + outGrapheme = QChar(0x2640); charWidth = 1; break; // FF - Female Sign case 13: - graphemes.append(QChar(0x266A)); + outGrapheme = QChar(0x266A); charWidth = 1; break; // CR - Single Quaver - shouldn't appear but does seem to crop up somehow! case 14: - graphemes.append(QChar(0x266B)); + outGrapheme = QChar(0x266B); charWidth = 1; break; // SO - Double Quaver case 15: - graphemes.append(QChar(0x263C)); + outGrapheme = QChar(0x263C); charWidth = 1; break; // SI - White Sun with Rays case 16: - graphemes.append(QChar(0x25BA)); + outGrapheme = QChar(0x25BA); charWidth = 1; break; // DLE - Black Right-Pointing Pointer case 17: - graphemes.append(QChar(0x25C4)); + outGrapheme = QChar(0x25C4); charWidth = 1; break; // DC1 - Black Left-Pointing Pointer case 18: - graphemes.append(QChar(0x2195)); + outGrapheme = QChar(0x2195); charWidth = 1; break; // DC2 - Up Down ArroW case 19: - graphemes.append(QChar(0x203C)); + outGrapheme = QChar(0x203C); charWidth = 1; break; // DC3 - Double Exclaimation Mark case 20: - graphemes.append(QChar(0x00B6)); + outGrapheme = QChar(0x00B6); charWidth = 1; break; // DC4 - Pilcrow case 21: - graphemes.append(QChar(0x00A7)); + outGrapheme = QChar(0x00A7); charWidth = 1; break; // NAK - Section Sign case 22: - graphemes.append(QChar(0x25AC)); + outGrapheme = QChar(0x25AC); charWidth = 1; break; // SYN - Black Rectangle case 23: - graphemes.append(QChar(0x21A8)); + outGrapheme = QChar(0x21A8); charWidth = 1; break; // ETB - Up Down Arrow With Base case 24: - graphemes.append(QChar(0x2191)); + outGrapheme = QChar(0x2191); charWidth = 1; break; // CAN - Up Arrow case 25: - graphemes.append(QChar(0x2193)); + outGrapheme = QChar(0x2193); charWidth = 1; break; // EM - Down Arrow case 26: - graphemes.append(QChar(0x2192)); + outGrapheme = QChar(0x2192); charWidth = 1; break; // SUB - Right Arrow case 27: - graphemes.append(QChar(0x2190)); + outGrapheme = QChar(0x2190); charWidth = 1; break; // ESC - Left Arrow - shouldn't appear as will have been intercepted previously case 28: - graphemes.append(QChar(0x221F)); + outGrapheme = QChar(0x221F); charWidth = 1; break; // FS - Right Angle case 29: - graphemes.append(QChar(0x2194)); + outGrapheme = QChar(0x2194); charWidth = 1; break; // GS - Left Right Arrow case 30: - graphemes.append(QChar(0x25B2)); + outGrapheme = QChar(0x25B2); charWidth = 1; break; // RS - Black Up-Pointing Pointer case 31: - graphemes.append(QChar(0x25BC)); + outGrapheme = QChar(0x25BC); charWidth = 1; break; // US - Black Down-Pointing Pointer case 127: - graphemes.append(QChar(0x2302)); + outGrapheme = QChar(0x2302); charWidth = 1; break; // DEL - House default: charWidth = getGraphemeWidth(unicode); - graphemes.append((charWidth < 1) ? QChar() : grapheme); + outGrapheme = (charWidth < 1) ? QString() : grapheme; } } -int TTextEdit::drawGraphemeBackground(QPainter& painter, - QVector<QColor>& fgColors, - QVector<QRect>& textRects, - QVector<QString>& graphemes, - QVector<int>& charWidths, - QPoint& cursor, - const QString& grapheme, - const int column, - const int line, - TChar& charStyle) const +int TTextEdit::layoutGrapheme(LineLayout& layout, const QPoint& cursor, const QString& grapheme, const int column, const int line, const TChar& charStyle) const { - uint unicode = graphemeInfo::getBaseCharacter(grapheme); + const uint unicode = graphemeInfo::getBaseCharacter(grapheme); int charWidth = 0; + GraphemeRun run; + run.style = &charStyle; switch (mpConsole->mControlCharacter) { default: // No special handling, except for these: if (Q_UNLIKELY(unicode == '\t')) { charWidth = mTabStopwidth - (column % mTabStopwidth); - graphemes.append(QString(QChar::Tabulation)); + run.grapheme = QString(QChar::Tabulation); } else { charWidth = graphemeInfo::getWidth(unicode, mWideAmbigousWidthGlyphs); - graphemes.append((charWidth < 1) ? QChar() : grapheme); + run.grapheme = (charWidth < 1) ? QString() : grapheme; } break; case ControlCharacterMode::Picture: - replaceControlCharacterWith_Picture(unicode, grapheme, column, graphemes, charWidth); + replaceControlCharacterWith_Picture(unicode, grapheme, column, run.grapheme, charWidth); break; case ControlCharacterMode::OEM: - replaceControlCharacterWith_OEMFont(unicode, grapheme, column, graphemes, charWidth); + replaceControlCharacterWith_OEMFont(unicode, grapheme, column, run.grapheme, charWidth); break; } // End of switch - charWidths.append(charWidth); - QRect textRect; if (charWidth > 0) { - textRect = QRect(mFontWidth * cursor.x(), mFontHeight * cursor.y(), mFontWidth * charWidth, mFontHeight); + run.textRect = QRect(mFontWidth * cursor.x(), mFontHeight * cursor.y(), mFontWidth * charWidth, mFontHeight); } - textRects.append(textRect); - QColor bgColor; - bool caretIsHere = mpHost && mpHost->caretEnabled() && mCaretLine == line && mCaretColumn == column; + const bool caretIsHere = mpHost && mpHost->caretEnabled() && mCaretLine == line && mCaretColumn == column; + const bool swapColors = charStyle.isReversed() != (charStyle.isSelected() != caretIsHere); if (Q_UNLIKELY(charStyle.isFound())) { - if (Q_UNLIKELY(charStyle.isReversed() != (charStyle.isSelected() != caretIsHere))) { - fgColors.append(mSearchHighlightBgColor); - bgColor = mSearchHighlightFgColor; + if (Q_UNLIKELY(swapColors)) { + run.fgColor = mSearchHighlightBgColor; + run.bgColor = mSearchHighlightFgColor; } else { - fgColors.append(mSearchHighlightFgColor); - bgColor = mSearchHighlightBgColor; + run.fgColor = mSearchHighlightFgColor; + run.bgColor = mSearchHighlightBgColor; + } + } else if (Q_UNLIKELY(swapColors)) { + // When colors would be swapped (e.g., during selection) + // and foreground equals background (hidden text), + // only reverse one color to make the text readable + if (charStyle.foreground() == charStyle.background()) { + run.fgColor = charStyle.foreground(); + // Invert background: use white for dark colors, black for light colors + run.bgColor = (charStyle.background().lightness() < 128) ? Qt::white : Qt::black; + } else { + run.fgColor = charStyle.background(); + run.bgColor = charStyle.foreground(); } } else { - if (Q_UNLIKELY(charStyle.isReversed() != (charStyle.isSelected() != caretIsHere))) { - // When colors would be swapped (e.g., during selection) - // and foreground equals background (hidden text), - // only reverse one color to make the text readable - if (charStyle.foreground() == charStyle.background()) { - fgColors.append(charStyle.foreground()); - // Invert background: use white for dark colors, black for light colors - bgColor = (charStyle.background().lightness() < 128) ? Qt::white : Qt::black; - } else { - fgColors.append(charStyle.background()); - bgColor = charStyle.foreground(); - } - } else { - fgColors.append(charStyle.foreground()); - bgColor = charStyle.background(); - } + run.fgColor = charStyle.foreground(); + run.bgColor = charStyle.background(); } if (caretIsHere) { - bgColor = mCaretColor; - } - // Fill the cell background when: - // - the text bg differs from the console bg (e.g. coloured text), or - // - the main console has a background image to paint the text bg over (#8885), or - // - the main console bg is partially transparent and would otherwise let - // the underlying surface bleed through. - // Skipping the fill when the bg matches an opaque console bg lets glyph - // descenders that extend slightly past mFontHeight (e.g. underscores at - // certain font sizes) survive the next line's drawing (#9070). - const bool fillNeeded = bgColor != mpConsole->getConsoleBgColor() - || (mpConsole->getType() == TConsole::MainConsole - && (mpConsole->mBgImageMode > 0 || bgColor.alpha() < 255)); - if (!textRect.isNull() && fillNeeded) { - painter.fillRect(textRect, bgColor); + run.bgColor = mCaretColor; } + // Main console cells are always filled: over a background image or a + // translucent console background the cell has to be opaque (#8885), and + // keeping it unconditional leaves the paint order in drawForeground() as the + // only thing protecting ink that overflows its cell (#9070, #9719). Other + // console types skip cells matching the console background so that the + // widget underneath shows through. + run.fillsBackground = !run.textRect.isNull() && (mpConsole->getType() == TConsole::MainConsole || run.bgColor != mpConsole->getConsoleBgColor()); + layout.push_back(std::move(run)); return charWidth; } -void TTextEdit::drawGraphemeForeground(QPainter& painter, const QColor& fgColor, const QRect& textRect, const QString& grapheme, TChar& charStyle) const +void TTextEdit::paintGraphemeForeground(QPainter& painter, const GraphemeRun& run) const { - TChar::AttributeFlags attributes = charStyle.allDisplayAttributes(); + const QColor& fgColor = run.fgColor; + const QRect& textRect = run.textRect; + const QString& grapheme = run.grapheme; + const TChar& charStyle = *run.style; + const TChar::AttributeFlags attributes = charStyle.allDisplayAttributes(); const bool isBold = attributes & TChar::Bold; const bool isBlinking = attributes & (TChar::Blink | TChar::FastBlink); @@ -953,9 +961,9 @@ void TTextEdit::drawGraphemeForeground(QPainter& painter, const QColor& fgColor, drawCustomDecorations(painter, effectiveFgColor, textRect, charStyle); } -void TTextEdit::drawCustomDecorations(QPainter& painter, const QColor& defaultColor, const QRect& textRect, TChar& charStyle) const +void TTextEdit::drawCustomDecorations(QPainter& painter, const QColor& defaultColor, const QRect& textRect, const TChar& charStyle) const { - TChar::AttributeFlags attributes = charStyle.allDisplayAttributes(); + const TChar::AttributeFlags attributes = charStyle.allDisplayAttributes(); QFontMetrics fm(painter.font()); // Calculate decoration positions @@ -1163,8 +1171,11 @@ void TTextEdit::drawForeground(QPainter& painter, const QRect& r) bool reusedCachedScreenContent = false; qreal dpr = devicePixelRatioF(); - QPixmap screenPixmap; - QPixmap pixmap = QPixmap(mScreenWidth * mFontWidth * dpr, mScreenHeight * mFontHeight * dpr); + // One spare row below the last character cell, so that ink which overflows + // the bottom cell - descenders and underscores do at many font sizes - has + // somewhere to go instead of being cut off by the edge of the pixmap. + const int pixmapHeight = (mScreenHeight + 1) * mFontHeight; + QPixmap pixmap = QPixmap(mScreenWidth * mFontWidth * dpr, pixmapHeight * dpr); pixmap.setDevicePixelRatio(dpr); pixmap.fill(Qt::transparent); @@ -1175,7 +1186,6 @@ void TTextEdit::drawForeground(QPainter& painter, const QRect& r) int y_top = r.top() / mFontHeight; int y_bottom = r.bottom() / mFontHeight; - int x_right = std::min(r.right(), (mScreenWidth * mFontWidth)) / mFontWidth; int lineOffset = imageTopLine(); int from = 0; @@ -1196,7 +1206,7 @@ void TTextEdit::drawForeground(QPainter& painter, const QRect& r) mScrollVector = 0; noScroll = true; } - if ((r.height() < rect().height()) && (lineOffset > 0) && (mScreenWidth * mFontWidth * dpr <= mScreenMap.width()) && (mScreenHeight * mFontHeight * dpr <= mScreenMap.height())) { + if ((r.height() < rect().height()) && (lineOffset > 0) && (mScreenWidth * mFontWidth * dpr <= mScreenMap.width()) && (pixmapHeight * dpr <= mScreenMap.height())) { p.drawPixmap(0, 0, mScreenMap); reusedCachedScreenContent = true; from = y_top; @@ -1208,38 +1218,95 @@ void TTextEdit::drawForeground(QPainter& painter, const QRect& r) mScrollVector = 0; } } - if ((!noScroll) && (mScrollVector >= 0) && (mScrollVector <= mScreenHeight) && (!mForceUpdate)) { - if (mScrollVector * mFontHeight < mScreenMap.height() && mScreenWidth * mFontWidth <= mScreenMap.width() && (mScreenHeight - mScrollVector) * mFontHeight > 0 - && (mScreenHeight - mScrollVector) * mFontHeight <= mScreenMap.height()) { - screenPixmap = mScreenMap.copy(0, mScrollVector * mFontHeight * dpr, mScreenWidth * mFontWidth * dpr, (mScreenHeight - mScrollVector) * mFontHeight * dpr); - p.drawPixmap(0, 0, screenPixmap); + const int scrolledRows = qAbs(mScrollVector); + if (!noScroll && !mForceUpdate && scrolledRows <= mScreenHeight) { + if (scrolledRows * mFontHeight < mScreenMap.height() && mScreenWidth * mFontWidth <= mScreenMap.width() && (mScreenHeight - scrolledRows) * mFontHeight > 0 + && (mScreenHeight - scrolledRows) * mFontHeight <= mScreenMap.height()) { + p.drawPixmap(0, -mScrollVector * mFontHeight, mScreenMap); reusedCachedScreenContent = true; - from = mScreenHeight - mScrollVector - 1; - } - } else if ((!noScroll) && (mScrollVector < 0 && mScrollVector >= ((-1) * mScreenHeight)) && (!mForceUpdate)) { - if (abs(mScrollVector) * mFontHeight < mScreenMap.height() && mScreenWidth * mFontWidth <= mScreenMap.width() && (mScreenHeight - abs(mScrollVector)) * mFontHeight > 0 - && (mScreenHeight - abs(mScrollVector)) * mFontHeight <= mScreenMap.height()) { - screenPixmap = mScreenMap.copy(0, 0, mScreenWidth * mFontWidth * dpr, (mScreenHeight - abs(mScrollVector)) * mFontHeight * dpr); - p.drawPixmap(0, abs(mScrollVector) * mFontHeight, screenPixmap); - reusedCachedScreenContent = true; - from = 0; - y_bottom = abs(mScrollVector); + if (mScrollVector >= 0) { + from = mScreenHeight - mScrollVector - 1; + } else { + from = 0; + y_bottom = scrolledRows; + } } } + const int lastRow = mScreenHeight - 1; + const int drawFrom = qMax(0, from); + // One row past the dirty region: the last dirty row's ink can spill into the + // row below, which would otherwise be left showing the ink of whatever used + // to be on that last row. + const int drawTo = qMin(y_bottom + 1, lastRow); + const bool bottomRowIsRepainted = drawTo == lastRow; + //delete non used characters. //needed for horizontal scrolling because there sometimes characters didn't get cleared - QRect deleteRect = QRect(0, from * mFontHeight, x_right * mFontWidth, (y_bottom + 1) * mFontHeight); + int clearHeight = (drawTo + 1 - drawFrom) * mFontHeight; + if (bottomRowIsRepainted) { + clearHeight += mFontHeight; + } + const QRect deleteRect(0, drawFrom * mFontHeight, mScreenWidth * mFontWidth, clearHeight); p.setCompositionMode(QPainter::CompositionMode_Source); p.fillRect(deleteRect, Qt::transparent); + // Scrolling shifts the cached screen by whole cells, which drops a complete + // line of text into the spare row. Nothing but the bottom line's overflow + // belongs there, so rebuild it from scratch whenever it is not already part + // of the band above. + QRect spareRowRect; + if (!bottomRowIsRepainted) { + spareRowRect = QRect(0, mScreenHeight * mFontHeight, mScreenWidth * mFontWidth, mFontHeight); + p.fillRect(spareRowRect, Qt::transparent); + } p.setCompositionMode(QPainter::CompositionMode_SourceOver); - for (int i = from; i <= y_bottom; ++i) { - if (static_cast<int>(mpBuffer->buffer.size()) <= i + lineOffset) { + const TChar timeStampStyle = timeStampCharStyle(); + + // The line above the cleared band keeps its cell but loses whatever it had + // spilled into the band, so put its glyphs back clipped to the band. Drawing + // the whole line again would paint it on top of itself and thicken its + // antialiasing. + mOverflowLineLayout.clear(); + if (drawFrom > 0 && hasBufferLine(drawFrom - 1 + lineOffset)) { + layoutLine(drawFrom - 1 + lineOffset, drawFrom - 1, timeStampStyle, mOverflowLineLayout); + } + + // Each line's backgrounds go down before the previous line's glyphs, so that + // no background fill can wipe out ink which overflowed out of its cell. + mPreviousLineLayout.clear(); + bool lineAboveRestored = false; + for (int i = drawFrom; i <= drawTo; ++i) { + if (!hasBufferLine(i + lineOffset)) { break; } - drawLine(p, i + lineOffset, i, &mScreenOffset); + layoutLine(i + lineOffset, i, timeStampStyle, mCurrentLineLayout, &mScreenOffset); + paintBackgrounds(p, mCurrentLineLayout); + if (!lineAboveRestored) { + paintForegrounds(p, mOverflowLineLayout, deleteRect); + lineAboveRestored = true; + } + paintForegrounds(p, mPreviousLineLayout); + mPreviousLineLayout.swap(mCurrentLineLayout); } + if (!lineAboveRestored) { + paintForegrounds(p, mOverflowLineLayout, deleteRect); + } + // Anything below the band is cached content that already holds this line's + // overflow, so clip it away rather than compositing the same ink twice. + const QRect bandRect(0, drawFrom * mFontHeight, mScreenWidth * mFontWidth, (drawTo + 1 - drawFrom) * mFontHeight); + paintForegrounds(p, mPreviousLineLayout, bottomRowIsRepainted ? QRect() : bandRect); + + if (!spareRowRect.isNull() && hasBufferLine(lastRow + lineOffset)) { + layoutLine(lastRow + lineOffset, lastRow, timeStampStyle, mOverflowLineLayout); + paintForegrounds(p, mOverflowLineLayout, spareRowRect); + } + // The layouts borrow TChar pointers from the buffer, so do not keep them + // past the paint they were built for. + mPreviousLineLayout.clear(); + mCurrentLineLayout.clear(); + mOverflowLineLayout.clear(); + calculateHMaxRange(); if (Q_UNLIKELY(mpConsole->mHScrollBarEnabled && mpConsole->mpHScrollBar)) { updateHorizontalScrollBar(); @@ -2184,7 +2251,9 @@ void TTextEdit::slot_copySelectionToClipboardImage() auto widthpx = std::min(65500, largestLine); auto rect = QRect(mPA.x(), mPA.y(), widthpx, heightpx); - auto pixmap = QPixmap(widthpx, heightpx); + // The bottom line's ink can reach past its cell, so paint into a spare row + // and keep only as much of it as the glyphs actually used. + auto pixmap = QPixmap(widthpx, std::min(65500, heightpx + mFontHeight)); auto solidColor = QColor(mBgColor); solidColor.setAlpha(255); pixmap.fill(solidColor); @@ -2199,17 +2268,33 @@ void TTextEdit::slot_copySelectionToClipboardImage() mSelectedRegion = QRegion(0, 0, 0, 0); auto result = drawTextForClipboard(painter, rect, lineOffset); + painter.end(); highlightSelection(); - // if we cut didn't finish painting the complete picture, trim the bottom of the image + const QImage image = pixmap.toImage(); + int keepHeight = heightpx + overflowRowsUsed(image, heightpx, solidColor); if (!result.first) { - const auto& smallerPixmap = pixmap.scaled(QSize(widthpx, result.second * mFontHeight), Qt::KeepAspectRatio); - QApplication::clipboard()->setImage(smallerPixmap.toImage()); - return; + // ran out of time, so cut back to the lines that did get painted + keepHeight = std::max(1, result.second * mFontHeight); } + QApplication::clipboard()->setImage(image.copy(0, 0, widthpx, std::min(image.height(), keepHeight))); +} - QApplication::clipboard()->setImage(pixmap.toImage()); +// How many rows below fromRow the glyph ink actually reached into. +int TTextEdit::overflowRowsUsed(const QImage& image, const int fromRow, const QColor& background) +{ + const QRgb backgroundPixel = background.rgb(); + int used = 0; + for (int y = std::max(0, fromRow); y < image.height(); ++y) { + for (int x = 0; x < image.width(); ++x) { + if ((image.pixel(x, y) | 0xff000000) != backgroundPixel) { + used = y - fromRow + 1; + break; + } + } + } + return used; } // a stateless version of drawForeground that doesn't do any caching @@ -2222,17 +2307,26 @@ std::pair<bool, int> TTextEdit::drawTextForClipboard(QPainter& painter, QRect re int lineCount = rectangle.height() / mFontHeight; int linesDrawn = 0; auto timeout = mudlet::self()->mCopyAsImageTimeout; - for (int i = 0; i <= lineCount; i++, linesDrawn++) { - if (static_cast<int>(mpBuffer->buffer.size()) <= i + lineOffset) { + const TChar timeStampStyle = timeStampCharStyle(); + LineLayout previousLine; + LineLayout currentLine; + for (int i = 0; i < lineCount; i++, linesDrawn++) { + if (!hasBufferLine(i + lineOffset)) { break; } - drawLine(painter, i + lineOffset, i); + // A line's backgrounds have to go down before the previous line's glyphs + layoutLine(i + lineOffset, i, timeStampStyle, currentLine); + paintBackgrounds(painter, currentLine); + paintForegrounds(painter, previousLine); + previousLine.swap(currentLine); if (std::chrono::duration_cast<std::chrono::seconds>(std::chrono::high_resolution_clock::now() - mCopyImageStartTime).count() >= timeout) { qDebug().nospace() << "timeout for image copy (" << timeout << "s) reached, managed to draw " << i << " lines"; + paintForegrounds(painter, previousLine); return {false, linesDrawn}; } } + paintForegrounds(painter, previousLine); return {true, linesDrawn}; } @@ -3025,10 +3119,7 @@ void TTextEdit::slot_analyseSelection() quint8 columnsToUse = qMax(size_t{2}, utf8Width); if (includeThisCodePoint) { - utf16indexes.append(qsl("<th colspan=\"%1\"><center>%2 & %3</center></th>") - .arg(QString::number(columnsToUse), - QString::number(index + 1), - QString::number(index + 2))); + utf16indexes.append(qsl("<th colspan=\"%1\"><center>%2 & %3</center></th>").arg(QString::number(columnsToUse), QString::number(index + 1), QString::number(index + 2))); // The use of one qsl inside another is because it is // impossible to force an upper-case alphabet to Hex digits otherwise @@ -3036,19 +3127,18 @@ void TTextEdit::slot_analyseSelection() // 
 is the Unicode Line Separator. // The static casts are only needed since Qt 6.9.0 but they // shouldn't do any harm prior to that: - utf16Vals.append(qsl("<td colspan=\"%1\" style=\"white-space:no-wrap vertical-align:top\"><center>%2</center>
<center>(0x%3:0x%4)</center></td>") - .arg(QString::number(columnsToUse), - qsl("%1").arg(static_cast<uint32_t>(QChar::surrogateToUcs4(mpBuffer->lineBuffer.at(line).at(index), - mpBuffer->lineBuffer.at(line).at(index + 1))), - 4, 16, zero).toUpper()) - .arg(static_cast<uint16_t>(mpBuffer->lineBuffer.at(line).at(index).unicode()), 4, 16, zero) - .arg(static_cast<uint16_t>(mpBuffer->lineBuffer.at(line).at(index + 1).unicode()), 4, 16, zero)); + utf16Vals.append( + qsl("<td colspan=\"%1\" style=\"white-space:no-wrap vertical-align:top\"><center>%2</center>
<center>(0x%3:0x%4)</center></td>") + .arg(QString::number(columnsToUse), + qsl("%1") + .arg(static_cast<uint32_t>(QChar::surrogateToUcs4(mpBuffer->lineBuffer.at(line).at(index), mpBuffer->lineBuffer.at(line).at(index + 1))), 4, 16, zero) + .toUpper()) + .arg(static_cast<uint16_t>(mpBuffer->lineBuffer.at(line).at(index).unicode()), 4, 16, zero) + .arg(static_cast<uint16_t>(mpBuffer->lineBuffer.at(line).at(index + 1).unicode()), 4, 16, zero)); // Note the addition to the index here to jump over the low-surrogate: graphemes.append(qsl("<td colspan=\"%1\">%2</td>") - .arg(QString::number(columnsToUse), - convertWhitespaceToVisual(mpBuffer->lineBuffer.at(line).at(index), - mpBuffer->lineBuffer.at(line).at(index + 1)))); + .arg(QString::number(columnsToUse), convertWhitespaceToVisual(mpBuffer->lineBuffer.at(line).at(index), mpBuffer->lineBuffer.at(line).at(index + 1)))); } switch (utf8Width) { diff --git a/src/TTextEdit.h b/src/TTextEdit.h index fbc82cb0e..5b721c0d1 100644 --- a/src/TTextEdit.h +++ b/src/TTextEdit.h @@ -28,14 +28,18 @@ ***************************************************************************/ +#include <QColor> #include <QElapsedTimer> #include <QMap> #include <QPointer> +#include <QImage> +#include <QRect> #include <QTimer> #include <QWidget> #include <chrono> #include <string> +#include <vector> #include "THyperlinkStyling.h" @@ -62,10 +66,6 @@ public: void paintEvent(QPaintEvent*) override; void contextMenuEvent(QContextMenuEvent* event) override; void drawForeground(QPainter&, const QRect&); - void drawLine(QPainter& painter, int lineNumber, int rowOfScreen, int* offset = nullptr) const; - int drawGraphemeBackground(QPainter&, QVector<QColor>&, QVector<QRect>&, QVector<QString>&, QVector<int>&, QPoint&, const QString&, const int, const int, TChar&) const; - void drawGraphemeForeground(QPainter&, const QColor&, const QRect&, const QString&, TChar&) const; - void drawCustomDecorations(QPainter&, const QColor&, const QRect&, TChar&) const; void showNewLines(); void forceUpdate(); void needUpdate(int, int); @@ -191,10 +191,46 @@ private: bool establishSelectedText(); void expandSelectionToWords(); void expandSelectionToLine(int); - inline void replaceControlCharacterWith_Picture(const uint, const QString&, const int, QVector<QString>&, int&) const; - inline void replaceControlCharacterWith_OEMFont(const uint, const QString&, const int, QVector<QString>&, int&) const; + inline void replaceControlCharacterWith_Picture(const uint, const QString&, const int, QString&, int&) const; + inline void replaceControlCharacterWith_OEMFont(const uint, const QString&, const int, QString&, int&) const; int offsetForPosition(int line, int column) const; + bool hasBufferLine(int lineNumber) const; + static int overflowRowsUsed(const QImage& image, const int fromRow, const QColor& background); + TChar timeStampCharStyle() const; + // One grapheme's painted cell (or cells, for a wide glyph): where it goes, + // the colours resolved for it, and the style they were resolved from. + struct GraphemeRun + { + QRect textRect; + QColor fgColor; + QColor bgColor; + QString grapheme; + // Borrowed from TBuffer::buffer, or from the caller's timestamp style. + // Only valid for the duration of one paint, during which the buffer must + // not be modified. A null pointer marks a background-only run, such as + // the caret block on an empty line. + const TChar* style = nullptr; + bool fillsBackground = false; + }; + using LineLayout = std::vector<GraphemeRun>; + + // Laying a line out without painting it lets the callers put line N's + // backgrounds down before line N-1's glyphs, so that ink overflowing out of + // the bottom of a cell cannot be erased by the line below it. Both callers + // depend on that order, which is why none of this is reachable from outside. + void layoutLine(int lineNumber, int lineOfScreen, const TChar& timeStampStyle, LineLayout& layout, int* offset = nullptr) const; + void paintBackgrounds(QPainter&, const LineLayout&) const; + void paintForegrounds(QPainter&, const LineLayout&, const QRect& clip = QRect()) const; + void drawCustomDecorations(QPainter&, const QColor&, const QRect&, const TChar&) const; + int layoutGrapheme(LineLayout& layout, const QPoint& cursor, const QString& grapheme, const int column, const int line, const TChar& charStyle) const; + void paintGraphemeForeground(QPainter&, const GraphemeRun&) const; + + // Reused between paints to keep their capacity rather than reallocating a + // line's worth of graphemes on every repaint. + mutable LineLayout mPreviousLineLayout; + mutable LineLayout mCurrentLineLayout; + mutable LineLayout mOverflowLineLayout; int mFontHeight; int mFontWidth; bool mForceUpdate = false; diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index e460e0689..8587226c1 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -27,6 +27,7 @@ set(FUNCTIONAL_TEST_SOURCES UnitDeferredDeleteTest.cpp MxpFramePlacementTest.cpp ColorTriggerFilterChildTest.cpp + GlyphOverflowTest.cpp GMCPCharLoginTest.cpp InsertTextCapTest.cpp SetScriptCallbackTest.cpp @@ -149,6 +150,10 @@ set_tests_properties(TriggerSameLineMatchTest PROPERTIES # GMCPCharLoginTest creates a fresh profile per test method, so it needs a longer timeout set_tests_properties(GMCPCharLoginTest PROPERTIES TIMEOUT 600) +# GlyphOverflowTest creates a fresh profile per test method and sweeps two font +# families across 22 sizes, so it needs a longer timeout +set_tests_properties(GlyphOverflowTest PROPERTIES TIMEOUT 600) + # InsertTextCapTest creates a fresh profile per test method, so it needs a longer timeout set_tests_properties(InsertTextCapTest PROPERTIES TIMEOUT 300) diff --git a/test/functional_tests/GlyphOverflowTest.cpp b/test/functional_tests/GlyphOverflowTest.cpp new file mode 100644 index 000000000..4adb40c60 --- /dev/null +++ b/test/functional_tests/GlyphOverflowTest.cpp @@ -0,0 +1,718 @@ +/*************************************************************************** + * Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +#include <QClipboard> +#include <QFontDatabase> +#include <QPainter> +#include <QtTest/QtTest> + +#include "Host.h" +#include "MudletInstanceCoordinator.h" +#include "TLuaInterpreter.h" +#include "TMainConsole.h" +#include "TTextEdit.h" +#include "TelnetServerStub.h" +#include "ctelnet.h" +#include "dlgConnectionProfiles.h" +#include "mudlet.h" + +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); +void initializeQRCResources(); + +// TTextEdit lays text out in cells of QFontMetrics::height(), which is a +// typographic measure rather than the glyph ink box. At a good number of font +// sizes the ink of a glyph such as "_" reaches a pixel past the bottom of its +// cell, so it only renders completely if nothing paints over that pixel +// afterwards. #9070 and #9719 are both reports of underscores vanishing because +// something did. +class GlyphOverflowTest : public QObject +{ + Q_OBJECT + +private: + TelnetServerStub* mpServer = nullptr; + const QString mHostname = "Test-GlyphOverflow"; + QString mPort; + const QString mLocalhost = "localhost"; + + // What the line below the underscores looks like. Each one takes a different + // branch of the background fill in layoutGrapheme(). + struct Underlay + { + QString name; + QString colourTag; + bool selected = false; + }; + + static QVector<Underlay> underlays() + { + return { + {qsl("the console background"), qsl("<white>")}, + {qsl("an explicit background colour"), qsl("<white:blue>")}, + {qsl("a bright background colour"), qsl("<black:yellow>")}, + {qsl("a selection"), qsl("<blue>"), true}, + }; + } + + static constexpr int kUnderscoreCount = 40; + static constexpr int kFillerCount = 60; + // Column used to sample what a pixel row looks like where no glyph was + // drawn; whatever the line below paints there is the reference for its own + // pixel row. + static constexpr int kBackgroundSampleColumn = 50; + // How far a channel has to move from its row's background before the pixel + // counts as glyph ink rather than antialiasing noise. + static constexpr int kInkThreshold = 24; + // How far past the bottom of a cell to look for ink that overflowed out of it + static constexpr int kOverflowScanRows = 4; + static const inline QStringList kTestFamilies = {qsl("Bitstream Vera Sans Mono"), qsl("Ubuntu Mono")}; + static constexpr int kFirstSize = 9; + static constexpr int kLastSize = 30; + + static bool pixelIsInk(QRgb pixel, QRgb background) + { + return qAbs(qRed(pixel) - qRed(background)) > kInkThreshold || qAbs(qGreen(pixel) - qGreen(background)) > kInkThreshold || qAbs(qBlue(pixel) - qBlue(background)) > kInkThreshold; + } + +private slots: + void initTestCase() + { + initializeQRCResources(); +#ifndef INCLUDE_FONTS + QSKIP("Built with WITH_FONTS=NO, so the fonts whose metrics this measures are not available"); +#else + // src/main.cpp extracts the bundled fonts into the config directory and + // FontManager picks them up from there, but QTEST_MAIN never runs + // main(), so on a machine that has not run Mudlet before there is + // nothing on disk to pick up and Qt quietly substitutes another family. + for (const QString& file : {qsl(":/fonts/ttf-bitstream-vera-1.10/VeraMono.ttf"), + qsl(":/fonts/ttf-bitstream-vera-1.10/VeraMoBd.ttf"), + qsl(":/fonts/ubuntu-font-family-0.83/UbuntuMono-R.ttf"), + qsl(":/fonts/ubuntu-font-family-0.83/UbuntuMono-B.ttf")}) { + QVERIFY2(QFontDatabase::addApplicationFont(file) != -1, qPrintable(qsl("Could not register the bundled font %1").arg(file))); + } + for (const QString& family : kTestFamilies) { + QVERIFY2(QFontDatabase::families().contains(family), qPrintable(qsl("'%1' is missing from the font database after registering the bundled files").arg(family))); + } +#endif + } + + void init() + { + mpServer = new TelnetServerStub(qApp); + // Port 0 asks the OS for an ephemeral port so parallel test runs do not + // collide on a hardcoded one + mpServer->start(mLocalhost, 0); + QVERIFY2(mpServer->isListening(), "TelnetServerStub failed to bind a loopback port"); + mPort = QString::number(mpServer->serverPort()); + mudlet::start(); + mudlet::self()->setupConfig(); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique<MudletInstanceCoordinator>("MudletInstanceCoordinator")); + mudlet::self()->init(); + mudlet::self()->setStorePasswordsSecurely(false); + deleteProfileDirectory(mHostname); + } + + // A line has to render all of its ink whatever the line below it looks like, + // and that ink has to match the same glyph drawn on its own with the same + // font, cell geometry and painter flags. + void test_lineBelowDoesNotEraseOverflowingInk() + { + Host* host = startOfflineProfile(); + QVERIFY2(host, "Could not start an offline profile"); + TTextEdit* pane = host->mpConsole->mUpperPane; + QVERIFY2(pane, "No upper pane available"); + + int sizesWithOverflow = 0; + for (const QString& family : kTestFamilies) { + for (int size = kFirstSize; size <= kLastSize; ++size) { + applyFont(host, family, size); + QVERIFY2(pane->getColumnCount() > kBackgroundSampleColumn, + qPrintable(qsl("%1 %2pt narrowed the pane to %3 columns, too few for the background sample at column %4") + .arg(family) + .arg(size) + .arg(pane->getColumnCount()) + .arg(kBackgroundSampleColumn))); + const int cellHeight = cellHeightOf(pane); + const QPair<int, int> expected = referenceInkExtent(pane->font(), qsl("_"), cellWidthOf(pane), cellHeight); + if (expected.second >= cellHeight) { + ++sizesWithOverflow; + } + + for (const Underlay& underlay : underlays()) { + const QVector<QPoint> ink = renderAndCollectInk(host, underlay); + const QString where = qsl("%1 %2pt below %3").arg(family).arg(size).arg(underlay.name); + QVERIFY2(!ink.isEmpty(), qPrintable(qsl("%1: no underscore ink rendered at all").arg(where))); + + const QPair<int, int> actual = inkExtent(ink); + QVERIFY2(actual == expected, + qPrintable(qsl("%1: underscore ink occupies %2 of its cell, expected %3 (cell is %4 tall)").arg(where, describeExtent(actual), describeExtent(expected)).arg(cellHeight))); + } + } + } + + if (sizesWithOverflow == 0) { + // The comparisons above all ran and passed, so this is a coverage + // warning rather than a skip + QWARN("None of the tested font sizes overflow their cell on this platform, so the overflow case went unexercised"); + } + } + + // The screen is rendered into a pixmap sized from the number of whole + // character cells that fit, so the bottom line's overflow only survives if + // that pixmap has somewhere to put it. + void test_bottomLineOverflowSurvivesThePixmapEdge() + { + Host* host = startOfflineProfile(); + QVERIFY2(host, "Could not start an offline profile"); + TTextEdit* pane = host->mpConsole->mUpperPane; + QVERIFY2(pane, "No upper pane available"); + + int checkedSizes = 0; + for (int size = kFirstSize; size <= kLastSize; ++size) { + applyFont(host, kTestFamilies.first(), size); + const int cellHeight = cellHeightOf(pane); + const int cellWidth = cellWidthOf(pane); + const QPair<int, int> expected = referenceInkExtent(pane->font(), qsl("_"), cellWidth, cellHeight); + if (expected.second < cellHeight) { + continue; // this size keeps its ink inside the cell, nothing to check + } + // A pane whose height is an exact multiple of the cell height has no + // pixel left over for the bottom line's overflow to appear in. + if (pane->height() % cellHeight == 0) { + continue; + } + ++checkedSizes; + + const int screenHeight = pane->getScreenHeight(); + runLua(host, qsl("clearWindow()")); + runLua(host, qsl("cecho('<white>' .. string.rep('filler\\n', %1) .. '%2\\n')").arg(screenHeight - 1).arg(QString(kUnderscoreCount, QLatin1Char('_')))); + pane->forceUpdate(); + QApplication::processEvents(); + + const QImage rendered = renderPane(host); + const int cellTop = (screenHeight - 1) * cellHeight; + const QPair<int, int> actual = inkExtent(collectInk(rendered, cellTop, cellHeight, cellWidth)); + QVERIFY2(actual == expected, + qPrintable(qsl("%1pt: the bottom line's underscore ink occupies %2 of its cell, expected %3").arg(QString::number(size), describeExtent(actual), describeExtent(expected)))); + } + + if (checkedSizes == 0) { + QSKIP("No font size produced an overflowing bottom line on this platform, so nothing here is being proved"); + } + } + + // Repainting part of the pane clears whole character cells, which takes the + // previous line's overflow pixel with it. That line sits outside the dirty + // region and is not redrawn, so the pixel has to be put back explicitly. + void test_partialRepaintKeepsTheLineAboveIntact() + { + Host* host = startOfflineProfile(); + QVERIFY2(host, "Could not start an offline profile"); + TTextEdit* pane = host->mpConsole->mUpperPane; + QVERIFY2(pane, "No upper pane available"); + + int checkedSizes = 0; + for (int size = kFirstSize; size <= kLastSize; ++size) { + applyFont(host, kTestFamilies.first(), size); + const int cellHeight = cellHeightOf(pane); + const int cellWidth = cellWidthOf(pane); + const QPair<int, int> expected = referenceInkExtent(pane->font(), qsl("_"), cellWidth, cellHeight); + if (expected.second < cellHeight) { + continue; + } + ++checkedSizes; + + // More lines than fit, so imageTopLine() is past zero - the + // precondition for the partial repaint below to reach + // drawForeground()'s cached-pixmap path. + runLua(host, qsl("clearWindow()")); + runLua(host, qsl("cecho('<white>' .. string.rep('%1\\n', %2))").arg(QString(kUnderscoreCount, QLatin1Char('_'))).arg(pane->getScreenHeight() * 2)); + pane->forceUpdate(); + QApplication::processEvents(); + QVERIFY2(pane->imageTopLine() > 0, "The pane did not scroll, so the partial repaint would not reach the cached-pixmap path"); + + // Simulate a partial repaint: the previous frame, the damaged band + // reset to the console background, then only that band re-rendered. + QImage rendered = renderPane(host); + const int row = pane->getScreenHeight() / 2; + const QRect damaged(0, row * cellHeight, pane->width(), cellHeight * 2); + QPainter eraser(&rendered); + eraser.fillRect(damaged, host->mpConsole->getConsoleBgColor()); + eraser.end(); + pane->render(&rendered, damaged.topLeft(), QRegion(damaged), QWidget::DrawChildren); + + // Only the bottom of the ink can be pinned here: every line is + // underscores, so the top rows of the cell hold the overflow of the + // line above it rather than this line's own glyph. + const QPair<int, int> actual = inkExtent(collectInk(rendered, (row - 1) * cellHeight, cellHeight, cellWidth)); + QVERIFY2(actual.second == expected.second, + qPrintable(qsl("%1pt: after a partial repaint the line above the dirty region ends at row %2 of its cell, expected %3").arg(size).arg(actual.second).arg(expected.second))); + } + + if (checkedSizes == 0) { + QSKIP("No font size produced an overflowing line on this platform, so nothing here is being proved"); + } + } + + // Scrolling reuses the cached screen by blitting it a whole number of cells + // up or down, which lands a complete line of text in the strip below the + // last one. Only the bottom line's own overflow belongs there. + void test_scrollingLeavesNoGhostLineBelowTheBottomOne() + { + Host* host = startOfflineProfile(); + QVERIFY2(host, "Could not start an offline profile"); + TTextEdit* pane = host->mpConsole->mUpperPane; + QVERIFY2(pane, "No upper pane available"); + + int checkedSizes = 0; + for (int size = kFirstSize; size <= kLastSize; ++size) { + applyFont(host, kTestFamilies.first(), size); + const int cellHeight = cellHeightOf(pane); + const int cellWidth = cellWidthOf(pane); + const QPair<int, int> expected = referenceInkExtent(pane->font(), qsl("_"), cellWidth, cellHeight); + const int spareTop = pane->getScreenHeight() * cellHeight; + if (expected.second < cellHeight || pane->height() - spareTop <= kOverflowScanRows) { + continue; + } + ++checkedSizes; + + // Underscores for the overflow, letters past them so that a whole + // ghost line would be unmistakable in the strip. + const QString line = QString(kUnderscoreCount, QLatin1Char('_')) + QString(20, QLatin1Char('M')); + runLua(host, qsl("clearWindow()")); + runLua(host, qsl("cecho('<white>' .. string.rep('%1\\n', %2))").arg(line).arg(pane->getScreenHeight() * 4)); + pane->forceUpdate(); + QApplication::processEvents(); + // primes the cached screen the scroll below is blitted from + renderPane(host); + + // drawForeground() ignores the cache entirely below ten scrolled-off + // lines, so there has to be more scrollback than that + const int topLineBeforeScroll = pane->imageTopLine(); + QVERIFY2(topLineBeforeScroll >= 10, "Not enough scrollback for drawForeground() to take its scrolling path"); + + // Render straight after the scroll so the frame under test is the + // one drawForeground() builds from the shifted cache. + pane->scrollUp(3); + QVERIFY2(pane->imageTopLine() < topLineBeforeScroll, "The pane did not scroll back, so the frame below is not built from a shifted cache"); + const QImage rendered = renderPane(host); + + for (int y = spareTop + kOverflowScanRows; y < pane->height(); ++y) { + int litPixels = 0; + for (int x = 0; x < rendered.width(); ++x) { + if (pixelIsInk(rendered.pixel(x, y), consoleBackground(host))) { + ++litPixels; + } + } + QVERIFY2(litPixels == 0, qPrintable(qsl("%1pt: %2 stray pixels %3 rows below the last character cell after scrolling back").arg(size).arg(litPixels).arg(y - spareTop))); + } + + // As above, the top of the cell holds the previous line's overflow + const QPair<int, int> actual = inkExtent(collectInk(rendered, spareTop - cellHeight, cellHeight, cellWidth)); + QVERIFY2(actual.second == expected.second, + qPrintable(qsl("%1pt: after scrolling back the bottom line's underscore ink ends at row %2 of its cell, expected %3").arg(size).arg(actual.second).arg(expected.second))); + } + + if (checkedSizes == 0) { + QSKIP("No font size produced an overflowing bottom line on this platform, so nothing here is being proved"); + } + } + + // Miniconsoles keep the fill rule the main console does not, so check the + // paint order protects their overflow too. + void test_miniConsoleKeepsOverflowingInk() + { + Host* host = startOfflineProfile(); + QVERIFY2(host, "Could not start an offline profile"); + runLua(host, qsl("createMiniConsole('overflowMini', 0, 0, 800, 400)")); + auto* mini = host->mpConsole->mSubConsoleMap.value(qsl("overflowMini")); + QVERIFY2(mini, "The miniconsole was not created"); + TTextEdit* pane = mini->mUpperPane; + QVERIFY2(pane, "The miniconsole has no pane"); + + int checkedSizes = 0; + for (int size = kFirstSize; size <= kLastSize; ++size) { + runLua(host, qsl("setFont('overflowMini', '%1')").arg(kTestFamilies.first())); + runLua(host, qsl("setMiniConsoleFontSize('overflowMini', %1)").arg(size)); + QApplication::processEvents(); + // this one goes through the miniconsole API rather than applyFont(), + // so it needs its own check that the family was not substituted + QVERIFY2(QFontInfo(pane->font()).family() == kTestFamilies.first(), + qPrintable(qsl("The miniconsole resolved to '%1' rather than '%2', so this would measure the wrong glyph").arg(QFontInfo(pane->font()).family(), kTestFamilies.first()))); + const int cellHeight = cellHeightOf(pane); + const int cellWidth = cellWidthOf(pane); + const QPair<int, int> expected = referenceInkExtent(pane->font(), qsl("_"), cellWidth, cellHeight); + if (expected.second < cellHeight || pane->getColumnCount() <= kBackgroundSampleColumn) { + continue; + } + ++checkedSizes; + + runLua(host, qsl("clearWindow('overflowMini')")); + runLua(host, qsl("cecho('overflowMini', '<white>%1\\n')").arg(QString(kUnderscoreCount, QLatin1Char('_')))); + runLua(host, qsl("cecho('overflowMini', '<white:blue>%1\\n')").arg(QString(kFillerCount, QLatin1Char(' ')))); + pane->forceUpdate(); + QApplication::processEvents(); + + QImage rendered(pane->size(), QImage::Format_ARGB32_Premultiplied); + rendered.fill(mini->getConsoleBgColor()); + pane->render(&rendered, QPoint(), QRegion(), QWidget::DrawChildren); + + const QPair<int, int> actual = inkExtent(collectInk(rendered, 0, cellHeight, cellWidth)); + QVERIFY2(actual == expected, + qPrintable(qsl("%1pt: a miniconsole's underscore ink occupies %2 of its cell, expected %3").arg(QString::number(size), describeExtent(actual), describeExtent(expected)))); + } + + if (checkedSizes == 0) { + QSKIP("No font size produced an overflowing line in a miniconsole on this platform, so nothing here is being proved"); + } + } + + // Copy-as-image sizes its pixmap at exactly one cell per selected line, so + // the bottom line's overflow has nowhere to go unless the paint leaves room + // for it and the image is trimmed back afterwards. + void test_copyAsImageKeepsTheBottomLineOverflow() + { + Host* host = startOfflineProfile(); + QVERIFY2(host, "Could not start an offline profile"); + TTextEdit* pane = host->mpConsole->mUpperPane; + QVERIFY2(pane, "No upper pane available"); + + int checkedSizes = 0; + for (int size = kFirstSize; size <= kLastSize; ++size) { + applyFont(host, kTestFamilies.first(), size); + const int cellHeight = cellHeightOf(pane); + const int cellWidth = cellWidthOf(pane); + const QPair<int, int> expected = referenceInkExtent(pane->font(), qsl("_"), cellWidth, cellHeight); + if (expected.second < cellHeight) { + continue; + } + ++checkedSizes; + + const int selectedLines = 5; + runLua(host, qsl("clearWindow()")); + runLua(host, qsl("cecho('<white>' .. string.rep('%1\\n', %2))").arg(QString(kUnderscoreCount, QLatin1Char('_'))).arg(selectedLines)); + pane->forceUpdate(); + QApplication::processEvents(); + + selectRows(pane, 0, selectedLines - 1, cellHeight, cellWidth); + QMetaObject::invokeMethod(pane, "slot_copySelectionToClipboardImage", Qt::DirectConnection); + QApplication::processEvents(); + + const QImage copied = QApplication::clipboard()->image(); + QVERIFY2(!copied.isNull(), qPrintable(qsl("%1pt: copy as image produced nothing").arg(size))); + const QPair<int, int> actual = inkExtentOnFlat(copied, (selectedLines - 1) * cellHeight, cellHeight, consoleBackground(host)); + QVERIFY2(actual.second == expected.second, + qPrintable(qsl("%1pt: the copied image's bottom line ends at row %2 of its cell, expected %3").arg(size).arg(actual.second).arg(expected.second))); + // the spare row must not survive as blank padding, nor bring an + // extra line of text with it + QVERIFY2(copied.height() <= selectedLines * cellHeight + kOverflowScanRows, + qPrintable(qsl("%1pt: the copied image is %2px tall for %3 lines of %4px").arg(size).arg(copied.height()).arg(selectedLines).arg(cellHeight))); + } + + if (checkedSizes == 0) { + QSKIP("No font size produced an overflowing line on this platform, so nothing here is being proved"); + } + } + + void cleanup() + { + const QString profilePath = mudlet::getMudletPath(enums::profileHomePath, mHostname); + delete mudlet::self(); + delete mpServer; + mpServer = nullptr; + deleteDirectory(profilePath); + } + +private: + // The pane paints its cells onto whatever the parent widget is showing, so + // start from the console background rather than letting render() lay down + // the default palette colour where no cell was filled. + static QImage renderPane(Host* host) + { + TTextEdit* pane = host->mpConsole->mUpperPane; + QImage image(pane->size(), QImage::Format_ARGB32_Premultiplied); + image.fill(host->mpConsole->getConsoleBgColor()); + pane->render(&image, QPoint(), QRegion(), QWidget::DrawChildren); + return image; + } + + // For images too narrow to carry a background sample column, such as the + // copy-as-image output, which is only as wide as the selected text. + static QPair<int, int> inkExtentOnFlat(const QImage& image, int cellTop, int cellHeight, QRgb background) + { + int top = -1; + int bottom = -1; + for (int y = qMax(0, cellTop); y < qMin(image.height(), cellTop + cellHeight + kOverflowScanRows); ++y) { + for (int x = 0; x < image.width(); ++x) { + if (pixelIsInk(image.pixel(x, y), background)) { + if (top < 0) { + top = y; + } + bottom = y; + break; + } + } + } + return {top - cellTop, bottom - cellTop}; + } + + static QRgb consoleBackground(Host* host) { return host->mpConsole->getConsoleBgColor().rgb(); } + + static int cellHeightOf(const TTextEdit* pane) { return QFontMetrics(pane->font()).height(); } + static int cellWidthOf(const TTextEdit* pane) { return QFontMetrics(pane->font()).averageCharWidth(); } + + // First and last pixel row of a set of ink, as offsets from the cell top. + // Empty ink reports {-1, -1} so a completely erased glyph never matches a + // real reference extent. + static QPair<int, int> inkExtent(const QVector<QPoint>& ink) + { + if (ink.isEmpty()) { + return {-1, -1}; + } + int top = ink.first().y(); + int bottom = top; + for (const QPoint& point : ink) { + top = qMin(top, point.y()); + bottom = qMax(bottom, point.y()); + } + return {top, bottom}; + } + + static QString describeExtent(const QPair<int, int>& extent) { return qsl("rows %1..%2").arg(extent.first).arg(extent.second); } + + void applyFont(Host* host, const QString& family, int size) + { + QFont font(family, size); + font.setFixedPitch(true); + QVERIFY2(QFontInfo(font).family() == family, qPrintable(qsl("Qt substituted '%1' for the requested '%2', so this would measure the wrong glyph").arg(QFontInfo(font).family(), family))); + const auto result = host->setDisplayFont(font); + QVERIFY2(result.first, qPrintable(qsl("Could not set the display font to %1 %2pt: %3").arg(family).arg(size).arg(result.second))); + QApplication::processEvents(); + } + + // Prints a line of underscores followed by a filler line dressed up as the + // given underlay, repaints, and returns the ink of the underscore line. + QVector<QPoint> renderAndCollectInk(Host* host, const Underlay& underlay) + { + TTextEdit* pane = host->mpConsole->mUpperPane; + runLua(host, qsl("clearWindow()")); + runLua(host, qsl("cecho('<white>%1\\n')").arg(QString(kUnderscoreCount, QLatin1Char('_')))); + runLua(host, qsl("cecho('%1%2\\n')").arg(underlay.colourTag, QString(kFillerCount, QLatin1Char(' ')))); + + const int underscoreLine = findLine(host, QString(kUnderscoreCount, QLatin1Char('_'))); + if (underscoreLine < 0) { + return {}; + } + if (underlay.selected) { + if (underscoreLine + 1 >= static_cast<int>(host->mpConsole->buffer.buffer.size())) { + return {}; + } + auto& below = host->mpConsole->buffer.buffer.at(underscoreLine + 1); + for (TChar& character : below) { + character.select(); + } + } + pane->forceUpdate(); + QApplication::processEvents(); + + const QImage rendered = renderPane(host); + const int cellHeight = cellHeightOf(pane); + return collectInk(rendered, (underscoreLine - pane->imageTopLine()) * cellHeight, cellHeight, cellWidthOf(pane)); + } + + static int findLine(Host* host, const QString& text) + { + TBuffer& buffer = host->mpConsole->buffer; + for (int i = 0; i <= buffer.getLastLineNumber(); ++i) { + if (buffer.line(i) == text) { + return i; + } + } + return -1; + } + + // Every pixel of the underscore run that differs from what its own pixel row + // looks like away from the glyphs, as offsets from the cell's top left. + // Reaches a few rows past the bottom of the cell so overflow is included. + // That only avoids picking up the line below because every caller leaves it + // blank or puts underscores on it, whose ink sits at the bottom of a cell. + static QVector<QPoint> collectInk(const QImage& image, int cellTop, int cellHeight, int cellWidth) + { + QVector<QPoint> ink; + const int sampleX = kBackgroundSampleColumn * cellWidth + cellWidth / 2; + if (sampleX >= image.width() || cellTop < 0) { + return ink; + } + const int lastX = qMin(kUnderscoreCount * cellWidth, image.width()) - 1; + const int lastY = qMin(cellTop + cellHeight + kOverflowScanRows, image.height()) - 1; + for (int y = cellTop; y <= lastY; ++y) { + const QRgb background = image.pixel(sampleX, y); + for (int x = 0; x <= lastX; ++x) { + if (pixelIsInk(image.pixel(x, y), background)) { + ink.append(QPoint(x, y - cellTop)); + } + } + } + return ink; + } + + // Where the ink of a run of graphemes starts and ends relative to the top of + // its cell, drawn cell by cell the way TTextEdit::paintGraphemeForeground() + // draws it. The whole run is rendered rather than a single glyph because + // neighbouring cells' antialiasing overlaps at the cell boundaries, which + // moves the faintest row of the ink. + static QPair<int, int> referenceInkExtent(const QFont& font, const QString& grapheme, int cellWidth, int cellHeight) + { + QImage image(kUnderscoreCount * cellWidth, cellHeight * 3, QImage::Format_ARGB32_Premultiplied); + image.fill(Qt::black); + QPainter painter(&image); + painter.setFont(font); + painter.setPen(Qt::white); + for (int cell = 0; cell < kUnderscoreCount; ++cell) { + painter.drawText(QRect(cell * cellWidth, cellHeight, cellWidth, cellHeight), Qt::AlignCenter | Qt::TextDontClip | Qt::TextSingleLine, grapheme); + } + painter.end(); + + int top = -1; + int bottom = -1; + for (int y = 0; y < image.height(); ++y) { + for (int x = 0; x < image.width(); ++x) { + if (pixelIsInk(image.pixel(x, y), qRgb(0, 0, 0))) { + if (top < 0) { + top = y; + } + bottom = y; + break; + } + } + } + return {top - cellHeight, bottom - cellHeight}; + } + + void runLua(Host* host, const QString& script) { QVERIFY2(host->getLuaInterpreter()->compileAndExecuteScript(script), qPrintable(qsl("Lua script failed: %1").arg(script))); } + + Host* startOfflineProfile() + { + startProfile(mHostname, mLocalhost, mPort); + auto* host = mudlet::self()->getActiveHost(); + if (!host) { + return nullptr; + } + host->mEchoLuaErrors = true; + + mudlet::self()->resize(1400, 900); + QApplication::processEvents(); + + // cecho() into a live connection would race with the stub's traffic + host->mTelnet.disconnectIt(); + if (!QTest::qWaitFor( + [host]() { + return host->mTelnet.getConnectionState() == QAbstractSocket::UnconnectedState; + }, + 5000)) { + qWarning() << "Profile did not go offline in time; stub traffic may interleave with the printed lines"; + } + return host; + } + + // Starts a profile the way a user would via the GUI (mirrors the helper in + // TelnetTextDisplayedTest). + void startProfile(const QString& hostname, const QString& address, const QString& port) + { + QTimer::singleShot(0, qApp, [hostname, address, port]() { + mudlet::self()->startAutoLogin({}); + QTest::qWait(100); + QTest::mouseClick(mudlet::self()->mpConnectionDialog->new_profile_button, Qt::LeftButton); + QTest::qWait(100); + QTest::keyClicks(QApplication::focusWidget(), hostname); + QTest::qWait(100); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100); + QTest::keyClicks(QApplication::focusWidget(), address); + QTest::qWait(100); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100); + QTest::keyClicks(QApplication::focusWidget(), port); + QTest::qWait(100); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Return); + }); + + QSignalSpy spy(mudlet::self(), &mudlet::signal_profileLoaded); + if (!spy.wait(5000)) { + QFAIL("Profile took too long to load."); + } + if (!mudlet::self()->getActiveHost()) { + QFAIL("No active host available for the test."); + } + + QSignalSpy spy2(&(mudlet::self()->getActiveHost()->mTelnet), &cTelnet::signal_connected); + if (!spy2.wait(2000)) { + QFAIL("Could not connect with the host."); + } + } + + // Drag-selects whole rows, which is the only way in from outside the class. + static void selectRows(TTextEdit* pane, int firstRow, int lastRow, int cellHeight, int cellWidth) + { + auto send = [pane](QEvent::Type type, Qt::MouseButton button, Qt::MouseButtons buttons, const QPointF& pos) { + QMouseEvent event(type, pos, pane->mapToGlobal(pos.toPoint()), button, buttons, Qt::NoModifier); + QApplication::sendEvent(pane, &event); + }; + const QPointF start(2, firstRow * cellHeight + 2); + const QPointF end(kUnderscoreCount * cellWidth - 2, lastRow * cellHeight + cellHeight / 2); + send(QEvent::MouseButtonPress, Qt::LeftButton, Qt::LeftButton, start); + send(QEvent::MouseMove, Qt::NoButton, Qt::LeftButton, end); + send(QEvent::MouseButtonRelease, Qt::LeftButton, Qt::NoButton, end); + QApplication::processEvents(); + } + + void deleteProfileDirectory(const QString& profileName) { deleteDirectory(mudlet::getMudletPath(enums::profileHomePath, profileName)); } + + void deleteDirectory(const QString& path) + { + QDir dir(path); + if (!dir.exists()) { + return; + } + dir.removeRecursively(); + } +}; + +void initializeQRCResources() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +#include "GlyphOverflowTest.moc" +QTEST_MAIN(GlyphOverflowTest) From 15e52faef91d29fa0e514798c90e67b7bc1686f9 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Mon, 10 Aug 2026 22:17:53 +0200 Subject: [PATCH 141/155] infrastructure: a media player no longer announces its own destruction (#9746) #### Brief overview of PR changes/additions - `TMediaPlayer::~TMediaPlayer()` blocks its `QMediaPlayer`'s signals before the `stop()`/`setSource(QUrl())` that unloads the media, so no handler is called with a player whose members are going away. The unload itself is unchanged, and Qt still emits `destroyed()`. - New `TMediaLoopTest::test_destroyingAPlayerAnnouncesNothing()`, with a control unload on a player that is not being destroyed so it cannot pass vacuously. - `test_continuingToTheNextPassClearsTheEarlierAnnouncement()` declares its flag ahead of the player, so a lambda connected to that player always has live stack to write to. #### Motivation for adding to Mudlet Emitting signals from a destructor is a landmine for any connected code: today TMedia's own handlers survive it only because each one locks an already-expired `weak_ptr`, and the test suite, which does not, aborted. #### Other info (issues closed, discussion etc) Closes #9740 "TMediaLoopTest aborts under AddressSanitizer with stack-use-after-scope". Reproduced and verified on Linux with a clang ASan Debug build (`USE_SANITIZER=address`): pre-fix `TMediaLoopTest` aborts with `stack-use-after-scope` in `~TMediaPlayer` -> `QMediaPlayer::setSource()`, post-fix the suite is clean. The new test fails without the destructor change (counts 1 announcement) and passes with it. GCC does not poison per-variable within a scope, so the abort only shows up under clang/AppleClang. **Test case:** `cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Debug -DCMAKE_CXX_COMPILER=clang++` then `cmake --build build --target TMediaLoopTest && ctest --test-dir build -R TMediaLoopTest` - passes instead of `***Exception`. Assisted-by: Claude:claude-opus-5 --- src/TMedia.h | 8 ++++ test/functional_tests/TMediaLoopTest.cpp | 60 +++++++++++++++++++++++- 2 files changed, 67 insertions(+), 1 deletion(-) diff --git a/src/TMedia.h b/src/TMedia.h index 9fb74c062..51cf0474e 100644 --- a/src/TMedia.h +++ b/src/TMedia.h @@ -57,6 +57,14 @@ public: ~TMediaPlayer() { if (mMediaPlayer) { + // The unload below releases the media file, and announces itself wherever it + // changes something - sourceChanged from clearing the source, playbackStateChanged + // from a stop that had something to stop - synchronously, into handlers reading a + // TMediaPlayer whose members are about to go. The handlers TMedia installs decline + // by way of a weak_ptr that has already expired by now; blocking makes that + // structural rather than something each new handler has to remember. The unload + // still happens, and Qt unblocks in ~QObject so destroyed() still arrives. + mMediaPlayer->blockSignals(true); mMediaPlayer->stop(); mMediaPlayer->setSource(QUrl()); } diff --git a/test/functional_tests/TMediaLoopTest.cpp b/test/functional_tests/TMediaLoopTest.cpp index d9a34c5a9..47942270c 100644 --- a/test/functional_tests/TMediaLoopTest.cpp +++ b/test/functional_tests/TMediaLoopTest.cpp @@ -209,10 +209,12 @@ private slots: file.close(); TMediaData data{}; + // Declared ahead of the player: should a player ever emit while being destroyed again, + // the lambda below has to have somewhere live to write to. + bool announcedFromInsideSetSource = false; TMediaPlayer player(nullptr, data); QVERIFY(player.isInitialized()); - bool announcedFromInsideSetSource = false; connect(player.mediaPlayer(), &QMediaPlayer::sourceChanged, player.mediaPlayer(), [&](const QUrl&) { player.noteEndAnnounced(); announcedFromInsideSetSource = true; @@ -225,6 +227,62 @@ private slots: QVERIFY2(!player.endAnnounced(), "The new pass started already counted as announced, so its own ending would be swallowed as a duplicate."); } + // Destroying a player unloads whatever it still holds, and nothing may hear that: a handler + // that does would be reading a TMediaPlayer whose members are about to go. The handlers + // TMedia installs decline anyway, each by way of a weak_ptr already expired by then, so + // what this holds to is that no future one has to. Staged rather than played, since the + // unload needs a source and not a backend that can decode it (#9740). + void test_destroyingAPlayerAnnouncesNothing() + { + const QString path = qsl("%1/teardown.wav").arg(mProbeDir.path()); + QFile file(path); + QVERIFY(file.open(QIODevice::WriteOnly)); + file.write(wavBytes()); + file.close(); + + int announcementsWhileBeingDestroyed = 0; + bool beingDestroyed = false; + const auto count = [&]() { + if (beingDestroyed) { + ++announcementsWhileBeingDestroyed; + } + }; + + TMediaData data{}; + + { + TMediaPlayer player(nullptr, data); + QVERIFY(player.isInitialized()); + + connect(player.mediaPlayer(), &QMediaPlayer::sourceChanged, player.mediaPlayer(), count); + connect(player.mediaPlayer(), &QMediaPlayer::playbackStateChanged, player.mediaPlayer(), count); + + player.continuePlaying(QUrl::fromLocalFile(path)); + QVERIFY2(!player.mediaPlayer()->source().isEmpty(), "The player holds no source, so its destructor has nothing to unload and this test proves nothing."); + + beingDestroyed = true; + } + + QVERIFY2(announcementsWhileBeingDestroyed == 0, "A player announced its own teardown, so every handler connected to it ran against a player being deleted."); + + // The same unload on a player that is not being destroyed, to keep the assertion above + // from passing on a Qt that has stopped announcing unloads at all. + int announcementsFromAnUnblockedUnload = 0; + const auto countUnblocked = [&]() { + ++announcementsFromAnUnblockedUnload; + }; + + QMediaPlayer unblocked; + connect(&unblocked, &QMediaPlayer::sourceChanged, &unblocked, countUnblocked); + connect(&unblocked, &QMediaPlayer::playbackStateChanged, &unblocked, countUnblocked); + unblocked.setSource(QUrl::fromLocalFile(path)); + announcementsFromAnUnblockedUnload = 0; + unblocked.stop(); + unblocked.setSource(QUrl()); + + QVERIFY2(announcementsFromAnUnblockedUnload > 0, "An unload announced nothing even unblocked, so the assertion above passes without the destructor having to block anything."); + } + // The deferred cleanup must still fire for a genuinely finished track, otherwise the // media source release added by #9237 is lost. Releasing the source is what this asserts // on because playingMedia() has already dropped the player by the time the cleanup runs. From 8901b59d84edee988e45f20bccda5d0057040134 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Mon, 10 Aug 2026 22:18:08 +0200 Subject: [PATCH 142/155] infrastructure: keep QTest's output visible when ctest runs on Windows (#9751) #### Brief overview of PR changes/additions - Appends `QT_ASSUME_STDERR_HAS_CONSOLE=1` to the `ENVIRONMENT` test property of every registered test - 95 of 95 confirmed with `ctest --show-only=json-v1` - leaving each test's existing `ASAN_OPTIONS`, `QT_QPA_PLATFORM` and `ENVIRONMENT_MODIFICATION` untouched. - One `cmake_language(DEFER CALL)` per directory that registers tests, rather than the variable copy-pasted into a dozen strings, so a test added later cannot miss it wherever in the file it lands. - Drops the 8 `QT_FORCE_STDERR_LOGGING` entries from the four workflows. `shouldLogToStderr()` is `forceStderrLogging() || stderrHasConsoleAttached()`, so the test property now covers what CI was setting by hand, and every one of those steps runs nothing but `ctest`. #### Motivation for adding to Mudlet Qt on Windows diverts QTest's output to `OutputDebugString` unless it believes stderr has a console attached, and an MSYS2 shell gives it none, so a failing test reported an exit code with no `FAIL!` lines, no compared values and no totals. Setting it as a test property fixes local runs and CI from one place instead of two. #### Other info (issues closed, discussion etc) **Test case:** full Linux `ctest` suite 95/95 pass; `ctest --show-only=json-v1` shows all 95 tests carrying the variable with no other property changed; `ctest -V` shows it in the test process environment. The Windows behaviour itself is not reproducible on Linux - it rests on the reporter's 219 vs 12233 byte A/B and on `QPlainTestLogger::outputMessage`, which only calls `OutputDebugStringA` when `!QtPrivate::shouldLogToStderr()`. Closes #9747 Assisted-by: Claude:claude-opus-5 --- .github/workflows/build-mudlet-pr.yml | 5 ----- .github/workflows/build-mudlet-win-pr.yml | 1 - .github/workflows/build-mudlet-win.yml | 2 -- .github/workflows/build-mudlet.yml | 5 ----- test/CMakeLists.txt | 13 +++++++++++++ test/functional_tests/CMakeLists.txt | 3 +++ 6 files changed, 16 insertions(+), 13 deletions(-) diff --git a/.github/workflows/build-mudlet-pr.yml b/.github/workflows/build-mudlet-pr.yml index 85d36d56b..b8eaad714 100644 --- a/.github/workflows/build-mudlet-pr.yml +++ b/.github/workflows/build-mudlet-pr.yml @@ -417,7 +417,6 @@ jobs: run: ctest --output-on-failure env: QT_QPA_PLATFORM: offscreen - QT_FORCE_STDERR_LOGGING: 1 # This runner has Qt's FFmpeg backend and can decode, so TMediaLoopTest must # demonstrate every media behaviour rather than skip any of them. Without a floor # somewhere, a lost codec or a changed default backend would turn the whole file @@ -428,15 +427,11 @@ jobs: if: runner.os == 'macOS' working-directory: '${{runner.workspace}}/b/ninja' run: ctest --output-on-failure - env: - QT_FORCE_STDERR_LOGGING: 1 # the full ctest run above already covers every functional-labelled test - name: Run QTest if: matrix.run_tests != 'true' run: ctest --test-dir ${{runner.workspace}}/b/ninja -L functional --output-on-failure - env: - QT_FORCE_STDERR_LOGGING: 1 - name: add ssh-agent for release uploads if: (runner.os == 'Linux' || runner.os == 'macOS') && matrix.deploy == 'deploy' && startsWith(github.ref, 'refs/tags/Mudlet-') diff --git a/.github/workflows/build-mudlet-win-pr.yml b/.github/workflows/build-mudlet-win-pr.yml index dfbda7039..ebe425210 100644 --- a/.github/workflows/build-mudlet-win-pr.yml +++ b/.github/workflows/build-mudlet-win-pr.yml @@ -139,7 +139,6 @@ jobs: ctest --test-dir $GITHUB_WORKSPACE/build-$MSYSTEM/test --output-on-failure env: - QT_FORCE_STDERR_LOGGING: 1 # This runner has Qt's FFmpeg backend and can decode, so TMediaLoopTest must # demonstrate every media behaviour rather than skip any of them. Without a floor # somewhere, a lost codec or a changed default backend would turn the whole file diff --git a/.github/workflows/build-mudlet-win.yml b/.github/workflows/build-mudlet-win.yml index b07d37f99..109b5b634 100644 --- a/.github/workflows/build-mudlet-win.yml +++ b/.github/workflows/build-mudlet-win.yml @@ -115,8 +115,6 @@ jobs: export LUA_CPATH ctest --test-dir $GITHUB_WORKSPACE/build-$MSYSTEM/test --output-on-failure - env: - QT_FORCE_STDERR_LOGGING: 1 - name: (Windows) Run Lua tests timeout-minutes: 2 diff --git a/.github/workflows/build-mudlet.yml b/.github/workflows/build-mudlet.yml index 755ef11ba..e850ba3e9 100644 --- a/.github/workflows/build-mudlet.yml +++ b/.github/workflows/build-mudlet.yml @@ -403,21 +403,16 @@ jobs: run: ctest --output-on-failure env: QT_QPA_PLATFORM: offscreen - QT_FORCE_STDERR_LOGGING: 1 - name: (macOS) Run C++ tests if: runner.os == 'macOS' working-directory: '${{runner.workspace}}/b/ninja' run: ctest --output-on-failure - env: - QT_FORCE_STDERR_LOGGING: 1 # the full ctest run above already covers every functional-labelled test - name: Run QTest if: matrix.run_tests != 'true' run: ctest --test-dir ${{runner.workspace}}/b/ninja -L functional --output-on-failure - env: - QT_FORCE_STDERR_LOGGING: 1 - name: add ssh-agent for release uploads if: (runner.os == 'Linux' || runner.os == 'macOS') && matrix.deploy == 'deploy' && startsWith(github.ref, 'refs/tags/Mudlet-') diff --git a/test/CMakeLists.txt b/test/CMakeLists.txt index f91b33bf1..e853a3663 100644 --- a/test/CMakeLists.txt +++ b/test/CMakeLists.txt @@ -9,6 +9,19 @@ endif() find_package(Qt6 6.8.2 REQUIRED COMPONENTS Test Network Widgets) +# On Windows Qt diverts QTest's stdout to OutputDebugString unless it believes +# stderr has a console attached, which an MSYS2 shell or a CI runner does not give +# it, so a failing test reports an exit code and nothing else (#9747). Deferred so +# that tests registered further down the file are covered too; TESTS does not +# descend into subdirectories, hence the second call in functional_tests. +function(restore_windows_test_output) + get_property(registeredTests DIRECTORY PROPERTY TESTS) + foreach(testName ${registeredTests}) + set_property(TEST ${testName} APPEND PROPERTY ENVIRONMENT "QT_ASSUME_STDERR_HAS_CONSOLE=1") + endforeach() +endfunction() +cmake_language(DEFER CALL restore_windows_test_output) + set(UNIT_TESTS TEntityResolverTest TEntityHandlerTest diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index 8587226c1..c9df0527a 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -2,6 +2,9 @@ if(NOT WIN32) include(${CMAKE_SOURCE_DIR}/src/cmake/EnableSanitizers.cmake) endif() +# Defined in the parent test/CMakeLists.txt; TESTS is per-directory, so call it here too. +cmake_language(DEFER CALL restore_windows_test_output) + set(FUNCTIONAL_TEST_SOURCES ConfigDirOverrideTest.cpp TelnetTextDisplayedTest.cpp From ed37c8eec2ee146d0899d1169963c94ed49f6481 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Tue, 11 Aug 2026 01:50:14 +0200 Subject: [PATCH 143/155] infrastructure: fix two tests still opting in with an empty XDG config dir (#9810) #### Brief overview of PR changes/additions - `61c2afd40` (#9712) made `$XDG_CONFIG_HOME/mudlet/profiles` the opt-in marker for an isolated config root, and an empty `$XDG_CONFIG_HOME/mudlet` no longer qualifies. It updated three functional tests to the new recipe and missed two, so `ProfileDeletionSafetyTest` and `ConnectionDialogCrashTest` resolved to the real `~/.config/mudlet` and failed in `initTestCase()` on every leg (run 31428353403). Every open PR inherits that red, because PR builds merge the dev tip. - Both now pre-create `mudlet/profiles`, matching the ten sibling tests and `src/mudlet-lua/tests/README.md`. Product code is untouched. - An empty `profiles/` still reads as a fresh install (`anyProfilesExist()` counts subdirectories), so neither test's first-launch expectations move. Test case: `ctest -R "ProfileDeletionSafetyTest|ConnectionDialogCrashTest"` against a `~/.config/mudlet` that holds profiles - both fail on `development`, both pass here; the full functional suite is otherwise unchanged. Assisted-by: Claude:claude-opus-5 --- test/functional_tests/ConnectionDialogCrashTest.cpp | 2 +- test/functional_tests/ProfileDeletionSafetyTest.cpp | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/test/functional_tests/ConnectionDialogCrashTest.cpp b/test/functional_tests/ConnectionDialogCrashTest.cpp index 743c26689..c6afcc3c7 100644 --- a/test/functional_tests/ConnectionDialogCrashTest.cpp +++ b/test/functional_tests/ConnectionDialogCrashTest.cpp @@ -170,7 +170,7 @@ private slots: mSavedXdg = qgetenv("XDG_CONFIG_HOME"); QVERIFY(mXdgDir.isValid()); - QVERIFY(QDir().mkpath(qsl("%1/mudlet").arg(mXdgDir.path()))); // empty dir = XDG opt-in + QVERIFY(QDir().mkpath(qsl("%1/mudlet/profiles").arg(mXdgDir.path()))); // profiles/ = XDG opt-in qputenv("XDG_CONFIG_HOME", mXdgDir.path().toUtf8()); mudlet::start(); diff --git a/test/functional_tests/ProfileDeletionSafetyTest.cpp b/test/functional_tests/ProfileDeletionSafetyTest.cpp index a5dacc78b..e31cc2ac3 100644 --- a/test/functional_tests/ProfileDeletionSafetyTest.cpp +++ b/test/functional_tests/ProfileDeletionSafetyTest.cpp @@ -149,9 +149,9 @@ private slots: initializeQRCResourcesForProfileDeletionSafetyTest(); QVERIFY(mConfigDir.isValid()); - // an existing $XDG_CONFIG_HOME/mudlet makes setupConfig() adopt it, so - // the test never goes near the user's own profiles - QVERIFY(QDir().mkpath(qsl("%1/mudlet").arg(mConfigDir.path()))); + // $XDG_CONFIG_HOME/mudlet/profiles is the opt-in that makes setupConfig() + // adopt it, so the test never goes near the user's own profiles + QVERIFY(QDir().mkpath(qsl("%1/mudlet/profiles").arg(mConfigDir.path()))); mSavedXdg = qgetenv("XDG_CONFIG_HOME"); qputenv("XDG_CONFIG_HOME", mConfigDir.path().toUtf8()); From b741663a1ce746256d006ae3f401072ceb328a96 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Tue, 11 Aug 2026 08:06:16 +0200 Subject: [PATCH 144/155] infrastructure: drop comments that restate the code beside them (#9681) #### Brief overview of PR changes/additions - Removed 8 comments that only repeated the statement or assertion message next to them - Kept 1 of the 16 identical copies of the `lua_next()` key-copy note in `TLuaInterpreterMedia.cpp` - Comment-only: zero code lines changed #### Motivation for adding to Mudlet Reading a comment and then the code that says the same thing is wasted effort; the rationale comments that document real gotchas are all untouched. #### Other info (issues closed, discussion etc) Result of a pass over the last month of commits on `development`. The vast majority of comments added there explain *why* rather than restate *what*, so this is deliberately a small diff. **Test case:** `git diff development...HEAD` shows only comment lines removed; build and test suites are unaffected. Assisted-by: Claude:claude-opus-5 Signed-off-by: Vadim Peretokin <vadim.peretokin@mudlet.org> --- src/TLuaInterpreterMedia.cpp | 30 ------------------- src/TMedia.cpp | 1 - src/TMxpProcessor.cpp | 1 - src/mudlet-lua/tests/Other_spec.lua | 1 - src/mudlet-lua/tests/Trigger_spec.lua | 1 - test/DiscordTest.cpp | 1 - test/SecureStringUtilsTest.cpp | 9 ++---- .../TFeedTriggersRecursionTest.cpp | 1 - .../TelnetSgrDefaultColorTest.cpp | 1 - 9 files changed, 2 insertions(+), 44 deletions(-) diff --git a/src/TLuaInterpreterMedia.cpp b/src/TLuaInterpreterMedia.cpp index a7cc0bca8..b46d9a812 100644 --- a/src/TLuaInterpreterMedia.cpp +++ b/src/TLuaInterpreterMedia.cpp @@ -442,8 +442,6 @@ int TLuaInterpreter::playMusicFileAsTableArgument(lua_State* L, const char* func break; } - // read the key from a copy: lua_tostring() on the slot itself converts a - // numeric key in place, which makes the next lua_next() fail lua_pushvalue(L, -2); const QString key = QString{lua_tostring(L, -1)}.toLower(); lua_pop(L, 1); @@ -807,8 +805,6 @@ int TLuaInterpreter::playSoundFileAsTableArgument(lua_State* L, const char* func break; } - // read the key from a copy: lua_tostring() on the slot itself converts a - // numeric key in place, which makes the next lua_next() fail lua_pushvalue(L, -2); const QString key = QString{lua_tostring(L, -1)}.toLower(); lua_pop(L, 1); @@ -980,8 +976,6 @@ int TLuaInterpreter::playVideoFileAsTableArgument(lua_State* L, const char* func break; } - // read the key from a copy: lua_tostring() on the slot itself converts a - // numeric key in place, which makes the next lua_next() fail lua_pushvalue(L, -2); const QString key{lua_tostring(L, -1)}; lua_pop(L, 1); @@ -1255,8 +1249,6 @@ int TLuaInterpreter::getPlayingMusicAsTableArgument(lua_State* L, const char* fu break; } - // read the key from a copy: lua_tostring() on the slot itself converts a - // numeric key in place, which makes the next lua_next() fail lua_pushvalue(L, -2); const QString key = QString{lua_tostring(L, -1)}.toLower(); lua_pop(L, 1); @@ -1421,8 +1413,6 @@ int TLuaInterpreter::getPlayingSoundsAsTableArgument(lua_State* L, const char* f break; } - // read the key from a copy: lua_tostring() on the slot itself converts a - // numeric key in place, which makes the next lua_next() fail lua_pushvalue(L, -2); const QString key = QString{lua_tostring(L, -1)}.toLower(); lua_pop(L, 1); @@ -1518,8 +1508,6 @@ int TLuaInterpreter::getPlayingVideosAsTableArgument(lua_State* L, const char* f break; } - // read the key from a copy: lua_tostring() on the slot itself converts a - // numeric key in place, which makes the next lua_next() fail lua_pushvalue(L, -2); const QString key = QString{lua_tostring(L, -1)}.toLower(); lua_pop(L, 1); @@ -1651,8 +1639,6 @@ int TLuaInterpreter::getPausedSoundsAsTableArgument(lua_State* L, const char* fu break; } - // read the key from a copy: lua_tostring() on the slot itself converts a - // numeric key in place, which makes the next lua_next() fail lua_pushvalue(L, -2); const QString key = QString{lua_tostring(L, -1)}.toLower(); lua_pop(L, 1); @@ -1734,8 +1720,6 @@ int TLuaInterpreter::getPausedMusicAsTableArgument(lua_State* L, const char* fun break; } - // read the key from a copy: lua_tostring() on the slot itself converts a - // numeric key in place, which makes the next lua_next() fail lua_pushvalue(L, -2); const QString key = QString{lua_tostring(L, -1)}.toLower(); lua_pop(L, 1); @@ -1817,8 +1801,6 @@ int TLuaInterpreter::getPausedVideosAsTableArgument(lua_State* L, const char* fu break; } - // read the key from a copy: lua_tostring() on the slot itself converts a - // numeric key in place, which makes the next lua_next() fail lua_pushvalue(L, -2); const QString key = QString{lua_tostring(L, -1)}.toLower(); lua_pop(L, 1); @@ -1996,8 +1978,6 @@ int TLuaInterpreter::stopMusicAsTableArgument(lua_State* L, const char* func) break; } - // read the key from a copy: lua_tostring() on the slot itself converts a - // numeric key in place, which makes the next lua_next() fail lua_pushvalue(L, -2); const QString key = QString{lua_tostring(L, -1)}.toLower(); lua_pop(L, 1); @@ -2216,8 +2196,6 @@ int TLuaInterpreter::stopSoundsAsTableArgument(lua_State* L, const char* func) break; } - // read the key from a copy: lua_tostring() on the slot itself converts a - // numeric key in place, which makes the next lua_next() fail lua_pushvalue(L, -2); const QString key = QString{lua_tostring(L, -1)}.toLower(); lua_pop(L, 1); @@ -2341,8 +2319,6 @@ int TLuaInterpreter::stopVideosAsTableArgument(lua_State* L, const char* func) break; } - // read the key from a copy: lua_tostring() on the slot itself converts a - // numeric key in place, which makes the next lua_next() fail lua_pushvalue(L, -2); const QString key = QString{lua_tostring(L, -1)}.toLower(); lua_pop(L, 1); @@ -2452,8 +2428,6 @@ int TLuaInterpreter::pauseSoundsAsTableArgument(lua_State* L, const char* func) break; } - // read the key from a copy: lua_tostring() on the slot itself converts a - // numeric key in place, which makes the next lua_next() fail lua_pushvalue(L, -2); const QString key = QString{lua_tostring(L, -1)}.toLower(); lua_pop(L, 1); @@ -2541,8 +2515,6 @@ int TLuaInterpreter::pauseMusicAsTableArgument(lua_State* L, const char* func) break; } - // read the key from a copy: lua_tostring() on the slot itself converts a - // numeric key in place, which makes the next lua_next() fail lua_pushvalue(L, -2); const QString key = QString{lua_tostring(L, -1)}.toLower(); lua_pop(L, 1); @@ -2630,8 +2602,6 @@ int TLuaInterpreter::pauseVideosAsTableArgument(lua_State* L, const char* func) break; } - // read the key from a copy: lua_tostring() on the slot itself converts a - // numeric key in place, which makes the next lua_next() fail lua_pushvalue(L, -2); const QString key = QString{lua_tostring(L, -1)}.toLower(); lua_pop(L, 1); diff --git a/src/TMedia.cpp b/src/TMedia.cpp index 037f72061..abae83fc8 100644 --- a/src/TMedia.cpp +++ b/src/TMedia.cpp @@ -1246,7 +1246,6 @@ void TMedia::connectMediaPlayer(std::shared_ptr<TMediaPlayer>& player) } }); - // Error connection disconnect(player->mediaPlayer(), &QMediaPlayer::errorOccurred, nullptr, nullptr); connect(player->mediaPlayer(), &QMediaPlayer::errorOccurred, this, [this, weakPlayer](QMediaPlayer::Error error, const QString& errorString) { const auto lockedPlayer = weakPlayer.lock(); diff --git a/src/TMxpProcessor.cpp b/src/TMxpProcessor.cpp index 19a754e2b..1a4276937 100644 --- a/src/TMxpProcessor.cpp +++ b/src/TMxpProcessor.cpp @@ -390,7 +390,6 @@ TMxpProcessingResult TMxpProcessor::processMxpInput(char& ch, bool resolveCustom return HANDLER_INSERT_ENTITY_LIT; } } - // ask for the next char return HANDLER_NEXT_CHAR; } diff --git a/src/mudlet-lua/tests/Other_spec.lua b/src/mudlet-lua/tests/Other_spec.lua index 5faa50256..a0662a3a9 100644 --- a/src/mudlet-lua/tests/Other_spec.lua +++ b/src/mudlet-lua/tests/Other_spec.lua @@ -1091,7 +1091,6 @@ describe("Tests the timer API", function() "a delay rounding up to a whole day wraps to a zero interval and must be rejected") assert.is_truthy(tostring(err):find("bad argument #1", 1, true), "the delay should be reported as the offending argument, got: " .. tostring(err)) - -- while a delay still under the day once rounded stays acceptable local id = trackTemp(tempTimer(86399.4, [[]])) assert.is_true(id > 0, "a delay under the day once rounded should still be accepted") assert.is_true(killTimer(id)) diff --git a/src/mudlet-lua/tests/Trigger_spec.lua b/src/mudlet-lua/tests/Trigger_spec.lua index 9ac67c2bf..5a61a397f 100644 --- a/src/mudlet-lua/tests/Trigger_spec.lua +++ b/src/mudlet-lua/tests/Trigger_spec.lua @@ -365,7 +365,6 @@ describe("Trigger processing", function() _G.TrigSpec = {count = 0} local id = tempExactMatchTrigger("exact_line_only", function() _G.TrigSpec.count = _G.TrigSpec.count + 1 end) assert.is_number(id) - -- superset line must NOT match an exact trigger feedTriggers("\nexact_line_only and more\n") assert.is_equal(0, _G.TrigSpec.count, "an exact-match trigger must not fire on a superset line") feedTriggers("\nexact_line_only\n") diff --git a/test/DiscordTest.cpp b/test/DiscordTest.cpp index 7952f06f6..aa088569c 100644 --- a/test/DiscordTest.cpp +++ b/test/DiscordTest.cpp @@ -294,7 +294,6 @@ private slots: ++checked; } } - // All 22 Discord Lua API functions should have been categorised: QVERIFY2(checked >= 22, qPrintable(qsl("only categorised %1 Discord Lua functions - has the source moved?").arg(checked))); } diff --git a/test/SecureStringUtilsTest.cpp b/test/SecureStringUtilsTest.cpp index 7b5aed37b..14321591b 100644 --- a/test/SecureStringUtilsTest.cpp +++ b/test/SecureStringUtilsTest.cpp @@ -143,22 +143,17 @@ void SecureStringUtilsTest::testSecureMemoryClearing() QString testString = "sensitive_data"; QString originalContent = testString; - // Clear the string SecureStringUtils::secureStringClear(testString); - - // String should be empty after clearing QVERIFY(testString.isEmpty()); QVERIFY(testString != originalContent); - - // Test QByteArray clearing + QByteArray testArray = "sensitive_bytes"; QByteArray originalArray = testArray; - + SecureStringUtils::secureByteArrayClear(testArray); QVERIFY(testArray.isEmpty()); QVERIFY(testArray != originalArray); - // Test std::string clearing std::string testStdString = "sensitive_std_data"; std::string originalStdString = testStdString; diff --git a/test/functional_tests/TFeedTriggersRecursionTest.cpp b/test/functional_tests/TFeedTriggersRecursionTest.cpp index b0e32bc31..0b52a0fb4 100644 --- a/test/functional_tests/TFeedTriggersRecursionTest.cpp +++ b/test/functional_tests/TFeedTriggersRecursionTest.cpp @@ -97,7 +97,6 @@ private slots: lua_pop(L, 1); QVERIFY2(bufferContains(qsl("trigger '%1'").arg(loopTriggerId)), "Expected the abort message to name the offending trigger by its id"); - // The trigger should have fired exactly up to the limit and no further. host->getLuaInterpreter()->compileAndExecuteScript(qsl("echo('LOOPCOUNT='..loopCount..'\\n')")); QVERIFY2(bufferContains(qsl("LOOPCOUNT=%1").arg(TriggerUnit::scmMaxProcessingDepth)), qPrintable(qsl("Expected the trigger to fire exactly %1 times").arg(TriggerUnit::scmMaxProcessingDepth))); } diff --git a/test/functional_tests/TelnetSgrDefaultColorTest.cpp b/test/functional_tests/TelnetSgrDefaultColorTest.cpp index 293d66144..2df195ee0 100644 --- a/test/functional_tests/TelnetSgrDefaultColorTest.cpp +++ b/test/functional_tests/TelnetSgrDefaultColorTest.cpp @@ -182,7 +182,6 @@ private slots: QCOMPARE(brightChar->foreground(), mpHost->mLightRed); } - // Regression guard: bold of an explicit color still brightens it. void boldColorStillBrightens() { injectData(QByteArrayLiteral("\x1b[31;1mbright")); From 669c586f62216f8251d181267f4f1cb2fcd98884 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Tue, 11 Aug 2026 08:07:10 +0200 Subject: [PATCH 145/155] infrastructure: rename the six tests Windows refuses to launch without elevation (#9753) #### Brief overview of PR changes/additions - Renames the six test executables whose filenames trip Windows' UAC installer detection: `UpdaterChecksumTest` to `ReleaseChecksumPairingTest`, `UpdaterPlatformAssetTest` to `ReleasePlatformAssetTest`, `UpdaterTeardownTest` to `NewReleaseDialogTeardownTest`, `PackageSelfUninstallTest` to `PackageSelfRemovalTest`, `PackageUninstallSaveTeardownTest` to `PackageRemovalSaveTeardownTest`, `ActionSelfUninstallTest` to `ActionSelfRemovalTest`. Assertions are untouched. - Adds a configure-time gate in `test/CMakeLists.txt` that fails with an actionable message if any test executable name contains install, setup, update or patch. It checks both the targets a configuration builds and the test source filenames, so conditionally registered tests cannot slip past it. - Documents the naming rule in `test/README.md`. #### Motivation for adding to Mudlet Windows treats an unsigned executable named that way as an installer and refuses to start it, so those six tests reported `BAD_COMMAND` for anyone running the suite from an ordinary Windows shell - and because CI runners are elevated, nothing caught it as more tests were added. #### Other info (issues closed, discussion etc) Fixes #9748 The gate was verified to fire on a target named after the guard statement, on one in a subdirectory, on `EventDispatcherTest` (the message names the offending substring, since "dispatch" contains "patch"), on a test registered only under `USE_UPDATER` when configuring with the updater off, and to fail loudly if the walk ever stops finding executables. **Test case:** `cmake --build build && ctest --test-dir build` - 92/92 pass; adding a test named e.g. `FooUpdateTest` fails the configure with an explanation. Assisted-by: Claude:claude-opus-5 --- test/CMakeLists.txt | 83 ++++++++++++++++--- test/README.md | 2 +- ...est.cpp => ReleaseChecksumPairingTest.cpp} | 28 +++---- ...tTest.cpp => ReleasePlatformAssetTest.cpp} | 26 +++--- ...tallTest.cpp => ActionSelfRemovalTest.cpp} | 8 +- test/functional_tests/CMakeLists.txt | 14 ++-- ...t.cpp => NewReleaseDialogTeardownTest.cpp} | 10 +-- ...cpp => PackageRemovalSaveTeardownTest.cpp} | 16 ++-- ...allTest.cpp => PackageSelfRemovalTest.cpp} | 16 ++-- 9 files changed, 133 insertions(+), 70 deletions(-) rename test/{UpdaterChecksumTest.cpp => ReleaseChecksumPairingTest.cpp} (92%) rename test/{UpdaterPlatformAssetTest.cpp => ReleasePlatformAssetTest.cpp} (92%) rename test/functional_tests/{ActionSelfUninstallTest.cpp => ActionSelfRemovalTest.cpp} (98%) rename test/functional_tests/{UpdaterTeardownTest.cpp => NewReleaseDialogTeardownTest.cpp} (94%) rename test/functional_tests/{PackageUninstallSaveTeardownTest.cpp => PackageRemovalSaveTeardownTest.cpp} (97%) rename test/functional_tests/{PackageSelfUninstallTest.cpp => PackageSelfRemovalTest.cpp} (98%) diff --git a/test/CMakeLists.txt b/test/CMakeLists.txt index e853a3663..87728abf8 100644 --- a/test/CMakeLists.txt +++ b/test/CMakeLists.txt @@ -103,30 +103,30 @@ set_tests_properties(CMakeListsConsistencyTest PROPERTIES # Pairing of a release's assets with its SHA256SUMS.txt. Built from the updater # sources rather than linked against the Mudlet library, because the library only # contains them when configured with USE_UPDATER. -add_executable(UpdaterChecksumTest - UpdaterChecksumTest.cpp +add_executable(ReleaseChecksumPairingTest + ReleaseChecksumPairingTest.cpp ${CMAKE_SOURCE_DIR}/src/updater/Feed.cpp ${CMAKE_SOURCE_DIR}/src/updater/Release.cpp ${CMAKE_SOURCE_DIR}/src/updater/SemVer.cpp ) -target_link_libraries(UpdaterChecksumTest PRIVATE Qt6::Test Qt6::Network Qt6::Widgets) -add_test(NAME UpdaterChecksumTest COMMAND $<TARGET_FILE:UpdaterChecksumTest>) -set_tests_properties(UpdaterChecksumTest PROPERTIES +target_link_libraries(ReleaseChecksumPairingTest PRIVATE Qt6::Test Qt6::Network Qt6::Widgets) +add_test(NAME ReleaseChecksumPairingTest COMMAND $<TARGET_FILE:ReleaseChecksumPairingTest>) +set_tests_properties(ReleaseChecksumPairingTest PROPERTIES ENVIRONMENT "ASAN_OPTIONS=detect_leaks=0" ) # Which releases the updater offers as an update. Built from the updater sources # rather than linked against the Mudlet library, because the library only # contains them when configured with USE_UPDATER. -add_executable(UpdaterPlatformAssetTest - UpdaterPlatformAssetTest.cpp +add_executable(ReleasePlatformAssetTest + ReleasePlatformAssetTest.cpp ${CMAKE_SOURCE_DIR}/src/updater/Feed.cpp ${CMAKE_SOURCE_DIR}/src/updater/Release.cpp ${CMAKE_SOURCE_DIR}/src/updater/SemVer.cpp ) -target_link_libraries(UpdaterPlatformAssetTest PRIVATE Qt6::Test Qt6::Network Qt6::Widgets) -add_test(NAME UpdaterPlatformAssetTest COMMAND $<TARGET_FILE:UpdaterPlatformAssetTest>) -set_tests_properties(UpdaterPlatformAssetTest PROPERTIES +target_link_libraries(ReleasePlatformAssetTest PRIVATE Qt6::Test Qt6::Network Qt6::Widgets) +add_test(NAME ReleasePlatformAssetTest COMMAND $<TARGET_FILE:ReleasePlatformAssetTest>) +set_tests_properties(ReleasePlatformAssetTest PROPERTIES ENVIRONMENT "ASAN_OPTIONS=detect_leaks=0" ) @@ -156,3 +156,66 @@ if(NOT WIN32) endif() add_subdirectory(functional_tests) + +# CI runners are elevated, so nothing there catches a test executable Windows +# refuses to launch for looking like an installer (#9748) - hence this gate, +# whose message spells the heuristic out. +function(mudlet_reject_uac_installer_name name) + string(TOLOWER "${name}" lowercaseName) + if(lowercaseName MATCHES "install|setup|update|patch") + message(FATAL_ERROR + "'${name}' cannot be used as a test name: Windows takes an unsigned executable whose name " + "contains '${CMAKE_MATCH_0}' for an installer and refuses to launch it without elevation " + "(#9748), so ctest reports BAD_COMMAND for it in an ordinary developer shell. Rename the " + "source file and its target to describe what the test asserts, watching for install, setup, " + "update and patch as substrings - Dispatch carries one.") + endif() +endfunction() + +function(mudlet_reject_uac_installer_target_names directory) + get_property(targets DIRECTORY "${directory}" PROPERTY BUILDSYSTEM_TARGETS) + foreach(target ${targets}) + get_target_property(targetType ${target} TYPE) + if(NOT targetType STREQUAL "EXECUTABLE") + continue() + endif() + set_property(GLOBAL APPEND PROPERTY mudletUacCheckedExecutables "${target}") + get_target_property(executableName ${target} OUTPUT_NAME) + if(NOT executableName) + set(executableName ${target}) + endif() + mudlet_reject_uac_installer_name("${executableName}") + endforeach() + + get_property(subdirectories DIRECTORY "${directory}" PROPERTY SUBDIRECTORIES) + foreach(subdirectory ${subdirectories}) + mudlet_reject_uac_installer_target_names("${subdirectory}") + endforeach() +endfunction() + +# Both passes are needed. Targets carry the name that actually reaches disk, +# OUTPUT_NAME included, but only for the tests this configuration builds: +# NewReleaseDialogTeardownTest, for one, is registered only under USE_UPDATER. +# Source names are what the registration loops derive executable names from, +# and are present whatever the configuration. +function(mudlet_check_test_executable_names directory) + mudlet_reject_uac_installer_target_names("${directory}") + + get_property(checkedExecutables GLOBAL PROPERTY mudletUacCheckedExecutables) + if(NOT checkedExecutables) + message(FATAL_ERROR "The test executable name check found no executables under ${directory}, so it is checking nothing.") + endif() + + file(GLOB_RECURSE testSources "${directory}/*.cpp") + if(NOT testSources) + message(FATAL_ERROR "The test executable name check found no sources under ${directory}, so it is checking nothing.") + endif() + foreach(testSource ${testSources}) + get_filename_component(sourceName "${testSource}" NAME_WE) + mudlet_reject_uac_installer_name("${sourceName}") + endforeach() +endfunction() + +# Deferred rather than called outright, so that targets registered below this +# line, and in subdirectories added below it, are checked as well +cmake_language(DEFER CALL mudlet_check_test_executable_names "${CMAKE_CURRENT_SOURCE_DIR}") diff --git a/test/README.md b/test/README.md index 7463e9c4a..6449cead2 100644 --- a/test/README.md +++ b/test/README.md @@ -79,7 +79,7 @@ QTEST_MAIN(MyComponentTest) ### Adding a New Test -1. **Create Test File**: Create `YourTestName.cpp` in the `test/` directory +1. **Create Test File**: Create `YourTestName.cpp` in the `test/` directory. Keep the words `install`, `uninstall`, `setup`, `update` and `patch` out of the name: Windows takes an unsigned executable named that way for an installer and will not start it from an ordinary, non-elevated Windows shell. CMake rejects such a name at configure time. 2. **Implement Test Class**: Follow the structure above, inheriting from `QObject` and using `Q_OBJECT` macro diff --git a/test/UpdaterChecksumTest.cpp b/test/ReleaseChecksumPairingTest.cpp similarity index 92% rename from test/UpdaterChecksumTest.cpp rename to test/ReleaseChecksumPairingTest.cpp index f1fd72c17..2f913948e 100644 --- a/test/UpdaterChecksumTest.cpp +++ b/test/ReleaseChecksumPairingTest.cpp @@ -95,7 +95,7 @@ QJsonObject releaseJson() } } // namespace -class UpdaterChecksumTest : public QObject +class ReleaseChecksumPairingTest : public QObject { Q_OBJECT @@ -115,7 +115,7 @@ private slots: // The updater picks the first asset matching its platform, so this is the file // whose checksum has to be present -void UpdaterChecksumTest::windowsDownloadIsThePlatformExe() +void ReleaseChecksumPairingTest::windowsDownloadIsThePlatformExe() { const dblsqd::Release release(releaseJson(), QStringLiteral("win"), QStringLiteral("x86_64")); @@ -124,21 +124,21 @@ void UpdaterChecksumTest::windowsDownloadIsThePlatformExe() } // The regression: this is why Windows auto-update failed -void UpdaterChecksumTest::publishedChecksumsDoNotCoverTheWindowsDownload() +void ReleaseChecksumPairingTest::publishedChecksumsDoNotCoverTheWindowsDownload() { const dblsqd::Release release(releaseJson(), QStringLiteral("win"), QStringLiteral("x86_64")); QVERIFY(dblsqd::Feed::findChecksum(publishedChecksums(), release.getDownloadUrl().fileName()).isEmpty()); } -void UpdaterChecksumTest::mergedChecksumsCoverTheWindowsDownload() +void ReleaseChecksumPairingTest::mergedChecksumsCoverTheWindowsDownload() { const dblsqd::Release release(releaseJson(), QStringLiteral("win"), QStringLiteral("x86_64")); QCOMPARE(dblsqd::Feed::findChecksum(mergedChecksums(), release.getDownloadUrl().fileName()), windowsHash); } -void UpdaterChecksumTest::everyOtherPlatformWasAlreadyCovered() +void ReleaseChecksumPairingTest::everyOtherPlatformWasAlreadyCovered() { const dblsqd::Release linuxRelease(releaseJson(), QStringLiteral("linux"), QStringLiteral("x86_64")); QCOMPARE(linuxRelease.getDownloadUrl().fileName(), linuxAsset); @@ -155,7 +155,7 @@ void UpdaterChecksumTest::everyOtherPlatformWasAlreadyCovered() // sha256sum writes two spaces in text mode and " *" in binary mode; the Windows // build produces the latter -void UpdaterChecksumTest::binaryAndTextModeLinesBothParse() +void ReleaseChecksumPairingTest::binaryAndTextModeLinesBothParse() { QCOMPARE(dblsqd::Feed::findChecksum(QStringLiteral("%1 *%2").arg(windowsHash, windowsAsset), windowsAsset), windowsHash); QCOMPARE(dblsqd::Feed::findChecksum(QStringLiteral("%1 %2").arg(windowsHash, windowsAsset), windowsAsset), windowsHash); @@ -166,7 +166,7 @@ void UpdaterChecksumTest::binaryAndTextModeLinesBothParse() // The rebuilt installer's entry must not be accepted for a different file, or the // updater would check the download against the wrong hash -void UpdaterChecksumTest::anotherBuildsEntryDoesNotCoverThisDownload() +void ReleaseChecksumPairingTest::anotherBuildsEntryDoesNotCoverThisDownload() { const QString rebuiltOnly = QStringLiteral("%1 *%2\n").arg(rebuiltWindowsHash, rebuiltWindowsAsset); @@ -177,7 +177,7 @@ void UpdaterChecksumTest::anotherBuildsEntryDoesNotCoverThisDownload() // SHA256SUMS.txt accumulates entries across builds, so a name that merely contains // the download's name must not hand back its hash - the updater would then reject a // perfectly good download as corrupt -void UpdaterChecksumTest::aLongerNameContainingThisOneDoesNotCoverIt() +void ReleaseChecksumPairingTest::aLongerNameContainingThisOneDoesNotCoverIt() { const QString longerName = QStringLiteral("old-%1").arg(windowsAsset); @@ -186,12 +186,12 @@ void UpdaterChecksumTest::aLongerNameContainingThisOneDoesNotCoverIt() QVERIFY(dblsqd::Feed::findChecksum(QStringLiteral("%1 %2.tar\n").arg(rebuiltWindowsHash, linuxAsset), linuxAsset).isEmpty()); } -void UpdaterChecksumTest::aPathPrefixedEntryStillCoversTheDownload() +void ReleaseChecksumPairingTest::aPathPrefixedEntryStillCoversTheDownload() { QCOMPARE(dblsqd::Feed::findChecksum(QStringLiteral("%1 *upload/%2\n").arg(windowsHash, windowsAsset), windowsAsset), windowsHash); } -void UpdaterChecksumTest::malformedLinesAreIgnored() +void ReleaseChecksumPairingTest::malformedLinesAreIgnored() { // too short, non-hex, and no separator respectively, then the real entry const QString data = QStringLiteral("abc123 %1\n" @@ -203,7 +203,7 @@ void UpdaterChecksumTest::malformedLinesAreIgnored() QCOMPARE(dblsqd::Feed::findChecksum(data, windowsAsset), windowsHash); } -void UpdaterChecksumTest::emptyInputsYieldNoChecksum() +void ReleaseChecksumPairingTest::emptyInputsYieldNoChecksum() { QVERIFY(dblsqd::Feed::findChecksum(QString(), windowsAsset).isEmpty()); QVERIFY(dblsqd::Feed::findChecksum(mergedChecksums(), QString()).isEmpty()); @@ -211,7 +211,7 @@ void UpdaterChecksumTest::emptyInputsYieldNoChecksum() // A release that forgot one platform and a payload that was never a checksum file // both yield no hash, but they need different messages -void UpdaterChecksumTest::entriesParsedTellsAnUnreadableFileFromAMissingEntry() +void ReleaseChecksumPairingTest::entriesParsedTellsAnUnreadableFileFromAMissingEntry() { int entriesParsed = -1; QVERIFY(dblsqd::Feed::findChecksum(publishedChecksums(), windowsAsset, &entriesParsed).isEmpty()); @@ -226,5 +226,5 @@ void UpdaterChecksumTest::entriesParsedTellsAnUnreadableFileFromAMissingEntry() QCOMPARE(entriesParsed, 5); } -#include "UpdaterChecksumTest.moc" -QTEST_MAIN(UpdaterChecksumTest) +#include "ReleaseChecksumPairingTest.moc" +QTEST_MAIN(ReleaseChecksumPairingTest) diff --git a/test/UpdaterPlatformAssetTest.cpp b/test/ReleasePlatformAssetTest.cpp similarity index 92% rename from test/UpdaterPlatformAssetTest.cpp rename to test/ReleasePlatformAssetTest.cpp index fa2a54110..ed06c757e 100644 --- a/test/UpdaterPlatformAssetTest.cpp +++ b/test/ReleasePlatformAssetTest.cpp @@ -110,7 +110,7 @@ dblsqd::Release installedRelease() } } // namespace -class UpdaterPlatformAssetTest : public QObject +class ReleasePlatformAssetTest : public QObject { Q_OBJECT @@ -128,7 +128,7 @@ private slots: }; // The regression: this is the update that produced a red console error twice a day -void UpdaterPlatformAssetTest::linuxIsNotOfferedTheReleaseWithoutALinuxAsset() +void ReleasePlatformAssetTest::linuxIsNotOfferedTheReleaseWithoutALinuxAsset() { const auto updates = dblsqd::Feed::selectUpdates(feedReleases(QStringLiteral("linux"), QStringLiteral("x86_64")), installedRelease()); @@ -137,7 +137,7 @@ void UpdaterPlatformAssetTest::linuxIsNotOfferedTheReleaseWithoutALinuxAsset() QVERIFY(updates.first().getDownloadUrl().fileName().endsWith(linuxSuffix)); } -void UpdaterPlatformAssetTest::windowsIsStillOfferedIt() +void ReleasePlatformAssetTest::windowsIsStillOfferedIt() { const auto updates = dblsqd::Feed::selectUpdates(feedReleases(QStringLiteral("win"), QStringLiteral("x86_64")), installedRelease()); @@ -146,7 +146,7 @@ void UpdaterPlatformAssetTest::windowsIsStillOfferedIt() QCOMPARE(updates.last().getVersion(), completeVersion); } -void UpdaterPlatformAssetTest::intelMacIsNotOfferedTheReleaseWithoutADmg() +void ReleasePlatformAssetTest::intelMacIsNotOfferedTheReleaseWithoutADmg() { const auto updates = dblsqd::Feed::selectUpdates(feedReleases(QStringLiteral("mac"), QStringLiteral("x86_64")), installedRelease()); @@ -155,7 +155,7 @@ void UpdaterPlatformAssetTest::intelMacIsNotOfferedTheReleaseWithoutADmg() QVERIFY(updates.first().getDownloadUrl().fileName().endsWith(intelMacSuffix)); } -void UpdaterPlatformAssetTest::appleSiliconIsNotOfferedTheReleaseWithoutADmg() +void ReleasePlatformAssetTest::appleSiliconIsNotOfferedTheReleaseWithoutADmg() { const auto updates = dblsqd::Feed::selectUpdates(feedReleases(QStringLiteral("mac"), QStringLiteral("arm64")), installedRelease()); @@ -165,7 +165,7 @@ void UpdaterPlatformAssetTest::appleSiliconIsNotOfferedTheReleaseWithoutADmg() } // A release whose binaries are still uploading looks the same as one that lost a build job -void UpdaterPlatformAssetTest::aReleaseWithOnlyItsChecksumsFileIsNotOffered() +void ReleasePlatformAssetTest::aReleaseWithOnlyItsChecksumsFileIsNotOffered() { const QList<dblsqd::Release> releases{dblsqd::Release(releaseJson(windowsOnlyTag, QStringLiteral("2026-08-07T02:14:11Z"), {}), QStringLiteral("linux"), QStringLiteral("x86_64"))}; @@ -174,14 +174,14 @@ void UpdaterPlatformAssetTest::aReleaseWithOnlyItsChecksumsFileIsNotOffered() // The download refuses to install what it cannot verify, so a release whose // SHA256SUMS.txt is missing is as uninstallable as one missing its binary -void UpdaterPlatformAssetTest::aReleaseWithoutChecksumsIsNotOffered() +void ReleasePlatformAssetTest::aReleaseWithoutChecksumsIsNotOffered() { const QList<dblsqd::Release> releases{dblsqd::Release(unverifiableRelease(), QStringLiteral("linux"), QStringLiteral("x86_64"))}; QVERIFY(dblsqd::Feed::selectUpdates(releases, installedRelease()).isEmpty()); } -void UpdaterPlatformAssetTest::theVerifiableReleaseIsOfferedInsteadOfTheNewerUnverifiableOne() +void ReleasePlatformAssetTest::theVerifiableReleaseIsOfferedInsteadOfTheNewerUnverifiableOne() { const QList<dblsqd::Release> releases{dblsqd::Release(unverifiableRelease(), QStringLiteral("linux"), QStringLiteral("x86_64")), dblsqd::Release(completeRelease(), QStringLiteral("linux"), QStringLiteral("x86_64"))}; @@ -195,13 +195,13 @@ void UpdaterPlatformAssetTest::theVerifiableReleaseIsOfferedInsteadOfTheNewerUnv // Mudlet publishes no binaries for the platforms it is packaged for by others, // so those builds are told there is no update rather than shown a failure they // can do nothing about, twice a day, forever -void UpdaterPlatformAssetTest::aPlatformWithNoAssetsAtAllIsOfferedNothing() +void ReleasePlatformAssetTest::aPlatformWithNoAssetsAtAllIsOfferedNothing() { QVERIFY(dblsqd::Feed::selectUpdates(feedReleases(QStringLiteral("freebsd"), QStringLiteral("x86_64")), installedRelease()).isEmpty()); } // What a Linux user on the previous PTB sees: no update, rather than an error -void UpdaterPlatformAssetTest::nothingIsOfferedOnceTheOnlyNewerReleaseIsIncomplete() +void ReleasePlatformAssetTest::nothingIsOfferedOnceTheOnlyNewerReleaseIsIncomplete() { const QList<dblsqd::Release> releases{dblsqd::Release(windowsOnlyRelease(), QStringLiteral("linux"), QStringLiteral("x86_64"))}; const dblsqd::Release installed(completeVersion, QDateTime::fromString(QStringLiteral("2026-08-06T02:11:47Z"), Qt::ISODate)); @@ -212,7 +212,7 @@ void UpdaterPlatformAssetTest::nothingIsOfferedOnceTheOnlyNewerReleaseIsIncomple // A release passed over here still has to carry its version and notes: the // changelog dialogs render the unfiltered release list // (UpdateDialog::generateChangelogDocument) -void UpdaterPlatformAssetTest::thePassedOverReleaseStaysReadableForTheChangelog() +void ReleasePlatformAssetTest::thePassedOverReleaseStaysReadableForTheChangelog() { const dblsqd::Release release(windowsOnlyRelease(), QStringLiteral("linux"), QStringLiteral("x86_64")); @@ -221,5 +221,5 @@ void UpdaterPlatformAssetTest::thePassedOverReleaseStaysReadableForTheChangelog( QCOMPARE(release.getChangelog(), QStringLiteral("- fixed a thing\n")); } -#include "UpdaterPlatformAssetTest.moc" -QTEST_MAIN(UpdaterPlatformAssetTest) +#include "ReleasePlatformAssetTest.moc" +QTEST_MAIN(ReleasePlatformAssetTest) diff --git a/test/functional_tests/ActionSelfUninstallTest.cpp b/test/functional_tests/ActionSelfRemovalTest.cpp similarity index 98% rename from test/functional_tests/ActionSelfUninstallTest.cpp rename to test/functional_tests/ActionSelfRemovalTest.cpp index f520ad078..021e144f4 100644 --- a/test/functional_tests/ActionSelfUninstallTest.cpp +++ b/test/functional_tests/ActionSelfRemovalTest.cpp @@ -45,13 +45,13 @@ void initializeQRCResources(); // free the very TAction that TAction::execute() was running on, which then read // this->mpHost after the Lua call returned (heap-use-after-free). ActionUnit now // defers that delete until execute() has unwound. -class ActionSelfUninstallTest : public QObject +class ActionSelfRemovalTest : public QObject { Q_OBJECT private: TelnetServerStub* mpServer = nullptr; - const QString mpHostname = "Test-ActionSelfUninstall"; + const QString mpHostname = "Test-ActionSelfRemoval"; const QString mpPort = "4009"; const QString mpLocalhost = "localhost"; @@ -259,5 +259,5 @@ void initializeQRCResources() qInitResources_qm(); } -#include "ActionSelfUninstallTest.moc" -QTEST_MAIN(ActionSelfUninstallTest) +#include "ActionSelfRemovalTest.moc" +QTEST_MAIN(ActionSelfRemovalTest) diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index c9df0527a..e84f4002d 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -40,9 +40,9 @@ set(FUNCTIONAL_TEST_SOURCES LogRestartDuplicateLineTest.cpp ProfileRoundTripTest.cpp ProfileLoadTempFileTest.cpp - PackageSelfUninstallTest.cpp + PackageSelfRemovalTest.cpp UnitProcessingDepthTest.cpp - PackageUninstallSaveTeardownTest.cpp + PackageRemovalSaveTeardownTest.cpp ModuleSaveTeardownTest.cpp MapRoundTripTest.cpp MapProgressDialogSeamTest.cpp @@ -51,7 +51,7 @@ set(FUNCTIONAL_TEST_SOURCES UndoServerWrapTest.cpp NarrowWindowWrapTest.cpp HostWidgetDecouplingTest.cpp - ActionSelfUninstallTest.cpp + ActionSelfRemovalTest.cpp ProfileFolderNameTest.cpp ProfileDeletionSafetyTest.cpp DialogTeardownTest.cpp @@ -69,7 +69,7 @@ set(FUNCTIONAL_TEST_SOURCES # The updater sources are only built with USE_UPDATER, and on macOS the # Updater wraps Sparkle instead of creating an UpdateDialog if(USE_UPDATER AND NOT APPLE) - list(APPEND FUNCTIONAL_TEST_SOURCES UpdaterTeardownTest.cpp) + list(APPEND FUNCTIONAL_TEST_SOURCES NewReleaseDialogTeardownTest.cpp) endif() set(FUNCTIONAL_TEST_UTILS @@ -107,11 +107,11 @@ endif() # These still leak and stay unchecked until their defects are fixed: # - dlgTriggerEditorUndoRedoTest: never destroys its dlgTriggerEditor, leaving # ~3.4MB of tree-item QIcon/QPixmap behind -# - UpdaterTeardownTest: Qt's one-time system CA-certificate store load on -# first TLS use, cached for the process lifetime +# - NewReleaseDialogTeardownTest: Qt's one-time system CA-certificate store load +# on first TLS use, cached for the process lifetime set(leakCheckExcludedTests dlgTriggerEditorUndoRedoTest - UpdaterTeardownTest + NewReleaseDialogTeardownTest ) # mudlet_lsan_hooks has to be linked explicitly, see src/CMakeLists.txt diff --git a/test/functional_tests/UpdaterTeardownTest.cpp b/test/functional_tests/NewReleaseDialogTeardownTest.cpp similarity index 94% rename from test/functional_tests/UpdaterTeardownTest.cpp rename to test/functional_tests/NewReleaseDialogTeardownTest.cpp index 55d779be0..345ddea1f 100644 --- a/test/functional_tests/UpdaterTeardownTest.cpp +++ b/test/functional_tests/NewReleaseDialogTeardownTest.cpp @@ -54,7 +54,7 @@ * QTEST_APPLESS_MAIN is used because the test itself must own the * QApplication lifetime to walk it through quit and destruction. */ -class UpdaterTeardownTest : public QObject +class NewReleaseDialogTeardownTest : public QObject { Q_OBJECT @@ -62,7 +62,7 @@ private slots: void updateDialogDestroyedBeforeApplicationTeardown(); }; -void UpdaterTeardownTest::updateDialogDestroyedBeforeApplicationTeardown() +void NewReleaseDialogTeardownTest::updateDialogDestroyedBeforeApplicationTeardown() { // Keeps checkUpdatesOnStart() away from real user data - on Windows it // deletes stale installer files from the genuine GenericDataLocation @@ -73,7 +73,7 @@ void UpdaterTeardownTest::updateDialogDestroyedBeforeApplicationTeardown() QSettings settings(settingsDir.filePath(qsl("updater-test.ini")), QSettings::IniFormat); int argc = 1; - char appName[] = "UpdaterTeardownTest"; + char appName[] = "NewReleaseDialogTeardownTest"; char* argv[] = {appName, nullptr}; const auto app = std::make_unique<QApplication>(argc, argv); @@ -118,5 +118,5 @@ void UpdaterTeardownTest::updateDialogDestroyedBeforeApplicationTeardown() QVERIFY2(dialog.isNull(), "UpdateDialog must be destroyed when the application quits: deleting it any later (from ~Updater, inside the application's destructor) corrupts the heap - see #9122"); } -QTEST_APPLESS_MAIN(UpdaterTeardownTest) -#include "UpdaterTeardownTest.moc" +QTEST_APPLESS_MAIN(NewReleaseDialogTeardownTest) +#include "NewReleaseDialogTeardownTest.moc" diff --git a/test/functional_tests/PackageUninstallSaveTeardownTest.cpp b/test/functional_tests/PackageRemovalSaveTeardownTest.cpp similarity index 97% rename from test/functional_tests/PackageUninstallSaveTeardownTest.cpp rename to test/functional_tests/PackageRemovalSaveTeardownTest.cpp index dfc438714..2d7565224 100644 --- a/test/functional_tests/PackageUninstallSaveTeardownTest.cpp +++ b/test/functional_tests/PackageRemovalSaveTeardownTest.cpp @@ -40,7 +40,7 @@ * contract the fix rests on, and a sanitizer run over the uninstall/close/ * destroy/pump sequence itself. * - * Run with: ctest -R PackageUninstallSaveTeardownTest -V + * Run with: ctest -R PackageRemovalSaveTeardownTest -V */ #include <QtTest/QtTest> @@ -64,16 +64,16 @@ extern void qInitResources_qm(); extern void qInitResources_additional_splash_screens(); extern void qInitResources_mudlet_fonts_common(); extern void qInitResources_mudlet_fonts_posix(); -void initializeQRCResourcesForPackageUninstallSaveTeardownTest(); +void initializeQRCResourcesForPackageRemovalSaveTeardownTest(); -class PackageUninstallSaveTeardownTest : public QObject +class PackageRemovalSaveTeardownTest : public QObject { Q_OBJECT private: TelnetServerStub* mpServer = nullptr; Host* mpHost = nullptr; - const QString mProfileName = qsl("PackageUninstallSaveTeardown-Test"); + const QString mProfileName = qsl("PackageRemovalSaveTeardown-Test"); const QString mLocalhost = qsl("localhost"); QString mPort; // the stub's actual ephemeral port, assigned in initTestCase() // The refusal test below installs an archive that names itself ".." - that @@ -177,7 +177,7 @@ private: private slots: void initTestCase() { - initializeQRCResourcesForPackageUninstallSaveTeardownTest(); + initializeQRCResourcesForPackageRemovalSaveTeardownTest(); // Keep the test hermetic: point the config dir resolution at a temporary // directory instead of the user's real profiles - one of the tests below @@ -384,7 +384,7 @@ private slots: } }; -void initializeQRCResourcesForPackageUninstallSaveTeardownTest() +void initializeQRCResourcesForPackageRemovalSaveTeardownTest() { #ifdef INCLUDE_VARIABLE_SPLASH_SCREEN qInitResources_additional_splash_screens(); @@ -399,5 +399,5 @@ void initializeQRCResourcesForPackageUninstallSaveTeardownTest() qInitResources_qm(); } -#include "PackageUninstallSaveTeardownTest.moc" -QTEST_MAIN(PackageUninstallSaveTeardownTest) +#include "PackageRemovalSaveTeardownTest.moc" +QTEST_MAIN(PackageRemovalSaveTeardownTest) diff --git a/test/functional_tests/PackageSelfUninstallTest.cpp b/test/functional_tests/PackageSelfRemovalTest.cpp similarity index 98% rename from test/functional_tests/PackageSelfUninstallTest.cpp rename to test/functional_tests/PackageSelfRemovalTest.cpp index 5f4052b62..2028bc0cb 100644 --- a/test/functional_tests/PackageSelfUninstallTest.cpp +++ b/test/functional_tests/PackageSelfRemovalTest.cpp @@ -42,7 +42,7 @@ * is outstanding is still registered, and must not be written back into the * profile by a save taken before the unit goes idle. * - * Run with: ctest -R PackageSelfUninstallTest -V + * Run with: ctest -R PackageSelfRemovalTest -V */ #include <QtTest/QtTest> @@ -85,7 +85,7 @@ extern void qInitResources_qm(); extern void qInitResources_additional_splash_screens(); extern void qInitResources_mudlet_fonts_common(); extern void qInitResources_mudlet_fonts_posix(); -void initializeQRCResourcesForPackageSelfUninstallTest(); +void initializeQRCResourcesForPackageSelfRemovalTest(); // TriggerUnit only holds its depth inside processDataStream(), so a save at // depth has to come from a trigger's own script. Stands in for the Lua @@ -119,12 +119,12 @@ static int exportProfileMidPass(lua_State* L) return 0; } -class PackageSelfUninstallTest : public QObject +class PackageSelfRemovalTest : public QObject { Q_OBJECT private: - const QString mProfileName = qsl("PackageSelfUninstall-Test"); + const QString mProfileName = qsl("PackageSelfRemoval-Test"); QTemporaryDir mConfigDir; QByteArray mSavedXdg; Host* mpHost = nullptr; @@ -132,7 +132,7 @@ private: private slots: void initTestCase() { - initializeQRCResourcesForPackageSelfUninstallTest(); + initializeQRCResourcesForPackageSelfRemovalTest(); // Keep the test hermetic: point the config dir resolution at a // temporary directory instead of the user's real profiles. @@ -655,7 +655,7 @@ private: } }; -void initializeQRCResourcesForPackageSelfUninstallTest() +void initializeQRCResourcesForPackageSelfRemovalTest() { #ifdef INCLUDE_VARIABLE_SPLASH_SCREEN qInitResources_additional_splash_screens(); @@ -670,5 +670,5 @@ void initializeQRCResourcesForPackageSelfUninstallTest() qInitResources_qm(); } -#include "PackageSelfUninstallTest.moc" -QTEST_MAIN(PackageSelfUninstallTest) +#include "PackageSelfRemovalTest.moc" +QTEST_MAIN(PackageSelfRemovalTest) From da17cd8939bbc256db087b36e607c3d657ae2452 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Tue, 11 Aug 2026 08:08:03 +0200 Subject: [PATCH 146/155] infrastructure: test coverage for the IRC configuration and media playback APIs (#9772) #### Brief overview of PR changes/additions - **49 busted specs** for the last uncovered IRC and media functions: the IRC configuration round-trips through the profile with no client and no connection, and both the ordered-argument and table-argument form of every public media call is now exercised, which is what reaches the ~26 private `*AsOrderedArguments`/`*AsTableArgument` helpers. - The **video family gets its first coverage at all** - `playVideoFile`, `getPlayingVideos`, `pauseVideos`, `getPausedVideos`, `stopVideos` and the widget lookup behind them, both when the request's key names a label and when it names nothing. - Two things found on the way and fixed here: busted's `finally()` holds one function rather than a list, so `Media_spec.lua` specs with two things to undo kept only the last (a moved-aside media directory stayed moved, handlers outlived their spec, the speech rate/pitch/volume were never restored); and handing a player a video widget is the only thing in the suite that brings a GL context up, whose driver initialisation leaks unsuppressibly on the leak job's Mesa - so that one spec stands aside there, the way `Other_spec` already does for `show3dMapView`. #### Motivation for adding to Mudlet Part of the Lua API test-coverage programme; this is the residue wave for `net-media-tts`. Two behaviours these specs pin were previously unheld anywhere: the numeric-key protection all fourteen media table parsers carry, and a video request being silently refused when its key matches no widget. Bugs found while writing them, none of them specced (filed separately): a preload that has to download its file then plays it; the load family never sets a media type; `loadSoundFile`/`loadVideoFile` report a missing name as `loadMusicFile`; `playMusicFile`'s ordered fade errors name `playSoundFile`; `setIrcServer` blanks the stored IRC password whenever it is called without one, and rejects an explicit `nil` where it accepts an omission. #### Other info (issues closed, discussion etc) `Networking_spec.lua` is appended to only, and no `mmcp*` function is touched, to stay clear of the open #9744 (Fix: Several identified MMCP issues) which edits the middle of that file. `openIRC` is left pending with its reason: it creates an IRC dialog nothing in the Lua API closes again, after which the getters stop reading the profile from disk for the rest of the run. **Test case:** full busted suite green twice on a fresh profile and twice on a reused one (2477 successes, 0 failures, ~+2s), with leak detection on; 19 sabotage edits were verified to fail 23 of the 49 new specs. Assisted-by: Claude:claude-opus-5 --- src/mudlet-lua/tests/Media_spec.lua | 515 ++++++++++++++++++++++- src/mudlet-lua/tests/Networking_spec.lua | 228 ++++++++++ 2 files changed, 734 insertions(+), 9 deletions(-) diff --git a/src/mudlet-lua/tests/Media_spec.lua b/src/mudlet-lua/tests/Media_spec.lua index 5986cf5b8..7a7b7af79 100644 --- a/src/mudlet-lua/tests/Media_spec.lua +++ b/src/mudlet-lua/tests/Media_spec.lua @@ -171,6 +171,136 @@ describe("Media playback functions validate their parameters", function() end) end) +describe("Media load functions validate their parameters", function() + -- loadMusicFile/loadSoundFile/loadVideoFile are one preload request behind + -- three names: they share a pair of parsers which set no media type at all, + -- so what actually differs between them is the name in their error messages + -- and loadVideoFile taking the table form only. Nothing here names a file + -- that exists, so no preload gets as far as the media engine. + it("each raises a Lua error when called with no arguments", function() + assertArgError(function() loadMusicFile() end, "loadMusicFile: need at least one argument") + assertArgError(function() loadSoundFile() end, "loadSoundFile: need at least one argument") + assertArgError(function() loadVideoFile() end, "loadVideoFile: need at least one argument") + end) + + it("loadVideoFile raises a Lua error when its argument is not a table", function() + -- the video calls take the table form only + assertArgError(function() loadVideoFile("busted-media-absent.mkv") end, "loadVideoFile: needs to be a table") + end) + + it("the ordered form returns nil when it is given no file name", function() + local ok, err = loadSoundFile(nil) + assert.is_nil(ok) + assert.is_true(contains(err, "missing argument 1"), tostring(err)) + + ok, err = loadMusicFile("") + assert.is_nil(ok) + assert.is_true(contains(err, "missing argument 1"), tostring(err)) + end) + + it("the table form raises a Lua error when it is given no name", function() + -- Only the tail of the message: all three loads report this one as + -- loadMusicFile, whichever was called, and pinning that here would hold + -- that in place. + assertArgError(function() loadSoundFile({}) end, "missing name") + end) + + it("the ordered form raises a Lua error when the url is not a string", function() + assertArgError(function() loadSoundFile("busted-media-absent.wav", {}) end, "url as string expected, got table!") + end) + + it("the table form raises a Lua error for a wrongly typed name or url", function() + assertArgError(function() loadMusicFile({name = {}}) end, "value for name as string expected, got table!") + assertArgError(function() loadMusicFile({name = "busted-media-absent.mp3", url = {}}) end, "value for url as string expected, got table!") + end) +end) + +describe("Media query and stop functions validate their parameters", function() + -- The video calls, the pause calls and the paused-media queries take a table + -- and nothing else; the sound and music queries and stops take either form. + -- pauseSounds and pauseMusic have this same refusal checked above + local tableOnly = { + "getPlayingVideos", "getPausedSounds", "getPausedMusic", "getPausedVideos", + "pauseVideos", "stopVideos", + } + + for _, fnName in ipairs(tableOnly) do + it(fnName .. " raises a Lua error when its argument is not a table", function() + assertArgError(function() _G[fnName](5) end, fnName .. ": needs to be a table") + end) + end + + it("the ordered query forms raise a Lua error for a wrongly typed filter", function() + assertArgError(function() getPlayingSounds("busted-media-absent.wav", {}) end, "key as string expected, got table!") + assertArgError(function() getPlayingSounds("busted-media-absent.wav", "k", {}) end, "tag as string expected, got table!") + assertArgError(function() getPlayingSounds("busted-media-absent.wav", "k", "t", "loud") end, "priority as number expected, got string!") + assertArgError(function() getPlayingMusic("busted-media-absent.mp3", {}) end, "key as string expected, got table!") + end) + + it("the table query forms raise a Lua error for a wrongly typed filter", function() + assertArgError(function() getPlayingMusic({name = {}}) end, "value for name as string expected, got table!") + assertArgError(function() getPausedSounds({key = {}}) end, "value for key as string expected, got table!") + assertArgError(function() getPausedMusic({tag = {}}) end, "value for tag as string expected, got table!") + assertArgError(function() getPausedVideos({name = {}}) end, "value for name as string expected, got table!") + assertArgError(function() getPlayingVideos({key = {}}) end, "value for key as string expected, got table!") + end) + + it("the ordered stop forms raise a Lua error for a wrongly typed argument", function() + assertArgError(function() stopSounds("busted-media-absent.wav", "k", "t", "loud") end, "priority as number expected, got string!") + assertArgError(function() stopSounds("busted-media-absent.wav", "k", "t", 10, "yes") end, "fadeaway as boolean expected, got string!") + assertArgError(function() stopMusic("busted-media-absent.mp3", "k", "t", "yes") end, "fadeaway as boolean expected, got string!") + assertArgError(function() stopMusic("busted-media-absent.mp3", "k", "t", true, -1) end, "bad argument range for fadeout") + end) + + it("the table pause and stop forms raise a Lua error for a wrongly typed filter", function() + assertArgError(function() pauseSounds({name = {}}) end, "value for name as string expected, got table!") + assertArgError(function() pauseMusic({key = {}}) end, "value for key as string expected, got table!") + assertArgError(function() pauseVideos({tag = {}}) end, "value for tag as string expected, got table!") + assertArgError(function() stopVideos({name = {}}) end, "value for name as string expected, got table!") + end) + + it("the ordered play forms raise a Lua error for a wrongly typed argument", function() + assertArgError(function() playMusicFile("busted-media-absent.mp3", {}) end, "volume as number expected, got table!") + assertArgError(function() playMusicFile("busted-media-absent.mp3", 50, 0, 0, 0, 1, {}) end, "key as string expected, got table!") + assertArgError(function() playSoundFile("busted-media-absent.wav", 50, 0, 0, 0, 1, "k", {}) end, "tag as string expected, got table!") + end) + + it("a numeric key in a table argument does not stop the rest of it being read", function() + -- Reading a numeric key with lua_tostring() converts it in place, and the + -- step of the iteration that follows then refuses the key it is handed, so + -- every table parser reads its keys from a copy. Lua walks a table's array + -- part first, which puts the numeric key ahead of the named ones here. + assert.is_true(playSoundFile({[1] = "junk", name = "busted-media-absent.wav"})) + assert.is_true(stopSounds({[1] = "junk", key = "busted-media-no-such-key"})) + assert.is_table(getPlayingMusic({[1] = "junk", name = "busted-media-absent.mp3"})) + assert.is_table(getPausedVideos({[1] = "junk", key = "busted-media-no-such-key"})) + end) + + it("the ordered play forms refuse a negative fade", function() + -- Only the range refusal, not the whole message: the music parser's fade + -- messages name playSoundFile, and pinning that here would hold it in + -- place. + assertArgError(function() playMusicFile("busted-media-absent.mp3", 50, -1) end, "bad argument range for fadein") + assertArgError(function() playSoundFile("busted-media-absent.wav", 50, 0, -1) end, "bad argument range for fadeout") + end) + + it("every query returns an empty table while nothing is playing", function() + -- with everything stopped, each of the six queries answers with a table + -- rather than with nil or a false-plus-message pair + assert.is_true(stopSounds()) + assert.is_true(stopMusic()) + assert.is_true(stopVideos()) + + for _, query in ipairs({getPlayingSounds, getPlayingMusic, getPlayingVideos, getPausedSounds, getPausedMusic, getPausedVideos}) do + local result = query() + assert.is_table(result) + assert.equals(0, #result) + -- and the same with a filter that matches nothing + assert.same({}, query({key = "busted-media-no-such-key"})) + end + end) +end) + describe("Media playback effects with a generated sound file", function() -- The API media functions play files out of the profile's own media -- directory, so instead of shipping a binary fixture these specs write a @@ -229,6 +359,18 @@ describe("Media playback effects with a generated sound file", function() writeMediaFile(otherLongSoundFile, 10000) end + -- Cleanups to run at the end of the current spec. busted's finally() holds + -- one function rather than a list (busted/init.lua: `env.finally = + -- function(fn) finally = fn end`), so a spec that has two things to undo - + -- and several here do - would keep only the last of them. after_each drains + -- this instead, in reverse, and runs whatever a failed spec got as far as + -- registering. + local cleanups = {} + + local function onCleanup(undo) + cleanups[#cleanups + 1] = undo + end + -- purgeMediaCache() empties the whole media directory, not just the fixtures -- these specs wrote, and the self-test profile persists between runs on a -- developer's machine. Anything else already in there is moved aside for the @@ -248,7 +390,7 @@ describe("Media playback effects with a generated sound file", function() for _, entry in ipairs(preserved) do os.rename(mediaDirectory .. "/" .. entry, stash .. "/" .. entry) end - finally(function() + onCleanup(function() lfs.mkdir(mediaDirectory) for _, entry in ipairs(preserved) do os.rename(stash .. "/" .. entry, mediaDirectory .. "/" .. entry) @@ -265,7 +407,7 @@ describe("Media playback effects with a generated sound file", function() local handler = registerAnonymousEventHandler(eventName, function(_, file, path, mediaType, key, tag) into[#into + 1] = {file = file, path = path, mediaType = mediaType, key = key, tag = tag} end) - finally(function() killAnonymousEventHandler(handler) end) + onCleanup(function() killAnonymousEventHandler(handler) end) end -- Waits until collected holds count entries. A media event can be raised @@ -317,9 +459,93 @@ describe("Media playback effects with a generated sound file", function() return true end + -- The fixture server of CI/http-fixture-server.py, when the harness started + -- one and handed its ephemeral port over. A preload's only observable effect + -- is the fetch it starts for a file the profile does not have, so the two + -- load specs below are the media ones that need a server to talk to. + local httpPort = os.getenv("MUDLET_TEST_HTTP_PORT") + local requireFixture = os.getenv("MUDLET_TEST_REQUIRE_HTTP_FIXTURE") + -- the file CI/http-fixtures/ serves, and its contents + local fixtureFile = "fixture.txt" + local fixtureBody = "Mudlet self-test HTTP fixture.\n" + + local function noFixtureServer() + if httpPort then + return false + end + if requireFixture then + assert.is_true(false, "MUDLET_TEST_REQUIRE_HTTP_FIXTURE is set but MUDLET_TEST_HTTP_PORT is not - the fixture server was not started") + end + pending("no local HTTP fixture server (set MUDLET_TEST_HTTP_PORT)") + return true + end + + -- The url a media request is given is a directory: TMedia appends the file + -- name to it. + local function fixtureUrl() + return "http://127.0.0.1:" .. httpPort + end + + local function readFile(path) + local handle = io.open(path, "rb") + if not handle then + return nil + end + local contents = handle:read("*a") + handle:close() + return contents + end + + -- Video playback draws into a widget the request names with its key: + -- TMainConsole::setupVideoOutput() looks that key up among the profile's + -- labels and user windows, and refuses the request when it finds neither. The + -- label is not deleted afterwards, because the player that was handed its + -- video widget outlives the spec - it is only hidden again, so it does not + -- sit over the main console for every spec that runs later. + local videoLabel = "busted-media-video-label" + local videoLabelReady + + -- Handing a player that widget is the only thing this suite does that brings + -- a GL context up: Qt loads its XCB GL integration, and Mesa initialises and + -- then - at shutdown, with the context - unloads a driver. On the leak job's + -- Mesa that driver initialisation leaks around 240 bytes, and by the time + -- LeakSanitizer looks, the library holding the allocating frame is gone, so + -- no leak: line in asan-suppressions.txt can name it. That file asks for + -- exactly this: keep the context from being created test-side, which is also + -- why Other_spec leaves show3dMapView alone. The refusal spec below needs no + -- widget and no context, and every leg without leak checking - Windows CI and + -- a developer's own run - still plays the video. + local leakChecked = (os.getenv("ASAN_OPTIONS") or ""):find("detect_leaks=1", 1, true) ~= nil + + local function videoWidgetUnavailable() + if leakChecked then + pending("a video widget's GL context leaks in this job's GL driver, where nothing is left to suppress by name") + return true + end + return false + end + + local function withVideoLabel() + if not videoLabelReady then + createLabel(videoLabel, 0, 0, 40, 40, 1) + assert.equals("label", windowType(videoLabel)) + videoLabelReady = true + end + onCleanup(function() hideWindow(videoLabel) end) + end + after_each(function() + -- before the stops below, not after: a spec's own event handlers have to + -- be gone before anything raises sysMediaFinished at them, or a handler + -- that starts a sound of its own leaves one playing into the next spec + for index = #cleanups, 1, -1 do + cleanups[index]() + end + cleanups = {} + stopSounds() stopMusic() + stopVideos() end) it("playSoundFile plays the file and reports it from start to finish", function() @@ -564,7 +790,7 @@ describe("Media playback effects with a generated sound file", function() reentered = reentered + 1 playSoundFile({name = otherLongSoundFile, key = "busted-handler-sound"}) end) - finally(function() killAnonymousEventHandler(handler) end) + onCleanup(function() killAnonymousEventHandler(handler) end) assert.is_true(playSoundFile({name = longSoundFile, key = "busted-quiet", priority = 10})) -- stops the sound above while it is still loading, which raises @@ -682,7 +908,7 @@ describe("Media playback effects with a generated sound file", function() handle:write("pinned") handle:close() os.execute("chmod 500 '" .. lockedDirectory .. "'") - finally(function() + onCleanup(function() os.execute("chmod 700 '" .. lockedDirectory .. "'") os.remove(pinnedFile) lfs.rmdir(lockedDirectory) @@ -705,7 +931,7 @@ describe("Media playback effects with a generated sound file", function() local handler = registerAnonymousEventHandler("sysDownloadError", function(_, message, path) errors[#errors + 1] = {message = message, path = path} end) - finally(function() killAnonymousEventHandler(handler) end) + onCleanup(function() killAnonymousEventHandler(handler) end) -- a file the media directory does not have, so the url is the only way to get it assert.is_true(playSoundFile({name = "busted-media-absent-scheme.wav", url = "ftp://example.invalid/sounds"})) @@ -714,6 +940,264 @@ describe("Media playback effects with a generated sound file", function() assert.is_true(contains(errors[1].message, "http"), tostring(errors[1].message)) assert.is_true(contains(errors[1].path, "busted-media-absent-scheme.wav"), tostring(errors[1].path)) end) + + it("loadSoundFile fetches a file the media directory does not have and keeps it", function() + if noFixtureServer() then + return + end + local downloaded = mediaDirectory .. "/" .. fixtureFile + lfs.mkdir(mediaDirectory) + -- the download has to be the only file of that name, and a reused profile + -- may well have one of its own already + preserveMediaDirectory() + os.remove(downloaded) + onCleanup(function() os.remove(downloaded) end) + + local done = {} + collect("sysDownloadDone", done) + assert.is_true(loadSoundFile({name = fixtureFile, url = fixtureUrl()})) + waitForCount("sysDownloadDone", done, 1) + + assert.equals(1, #done) + assert.equals(fixtureBody, readFile(downloaded)) + end) + + it("loadMusicFile fetches from the url given in the ordered argument form", function() + if noFixtureServer() then + return + end + -- name[,url]: the ordered form has a parser of its own + local downloaded = mediaDirectory .. "/" .. fixtureFile + lfs.mkdir(mediaDirectory) + -- the download has to be the only file of that name, and a reused profile + -- may well have one of its own already + preserveMediaDirectory() + os.remove(downloaded) + onCleanup(function() os.remove(downloaded) end) + + local done = {} + collect("sysDownloadDone", done) + assert.is_true(loadMusicFile(fixtureFile, fixtureUrl())) + waitForCount("sysDownloadDone", done, 1) + + assert.equals(1, #done) + assert.equals(fixtureBody, readFile(downloaded)) + end) + + it("loadVideoFile reports a download error for a url it cannot fetch from", function() + -- The preload reaches the same fetch as a play would, so the refusal of a + -- url that is not http(s) is where a spec can see a load act on its url + -- without a server to answer it. + local errors = {} + local handler = registerAnonymousEventHandler("sysDownloadError", function(_, message, path) + errors[#errors + 1] = {message = message, path = path} + end) + onCleanup(function() killAnonymousEventHandler(handler) end) + + assert.is_true(loadVideoFile({name = "busted-media-absent-load.mkv", url = "ftp://example.invalid/videos"})) + waitForCount("sysDownloadError", errors, 1) + + -- picked out by name rather than by position: the collector sees every + -- download error, not only this one's + local reported + for _, failure in ipairs(errors) do + if contains(failure.path, "busted-media-absent-load.mkv") then + reported = failure + end + end + assert.is_not_nil(reported, "no download error named the file the load asked for") + assert.is_true(contains(reported.message, "http"), tostring(reported.message)) + end) + + it("playMusicFile starts a track given in the ordered argument form", function() + if mediaPlaybackUnavailable() then + return + end + writeSoundFiles() + -- name[,volume][,fadein][,fadeout][,start][,loops][,key][,tag] + assert.is_true(playMusicFile(longSoundFile, 70, 0, 0, 0, 1, "busted-music-ordered", "busted-music-ordered-tag")) + assert.equals("sysMediaStarted", (waitForEvent("sysMediaStarted", 5000))) + + local music = getPlayingMusic() + assert.equals(1, #music) + assert.equals(longSoundFile, music[1].name) + assert.equals(70, music[1].volume) + assert.equals("busted-music-ordered", music[1].key) + assert.equals("busted-music-ordered-tag", music[1].tag) + end) + + it("getPlayingMusic filters by name in both argument forms", function() + if mediaPlaybackUnavailable() then + return + end + writeSoundFiles() + assert.is_true(playMusicFile({name = longSoundFile, key = "busted-music-filter"})) + assert.equals("sysMediaStarted", (waitForEvent("sysMediaStarted", 5000))) + + -- name[,key][,tag] as ordered arguments + assert.equals(1, #getPlayingMusic(longSoundFile)) + assert.equals(1, #getPlayingMusic(longSoundFile, "busted-music-filter")) + assert.equals(0, #getPlayingMusic(longSoundFile, "busted-music-elsewhere")) + assert.equals(0, #getPlayingMusic(otherLongSoundFile)) + -- and the same filters as a table + assert.equals(1, #getPlayingMusic({name = longSoundFile})) + assert.equals(0, #getPlayingMusic({key = "busted-music-elsewhere"})) + end) + + it("getPlayingSounds filters by name, key and tag in the ordered argument form", function() + if mediaPlaybackUnavailable() then + return + end + writeSoundFiles() + assert.is_true(playSoundFile({name = longSoundFile, key = "busted-ordered-key", tag = "busted-ordered-tag"})) + assert.equals("sysMediaStarted", (waitForEvent("sysMediaStarted", 5000))) + + -- name[,key][,tag][,priority] + assert.equals(1, #getPlayingSounds(longSoundFile)) + assert.equals(1, #getPlayingSounds(longSoundFile, "busted-ordered-key", "busted-ordered-tag")) + assert.equals(0, #getPlayingSounds(longSoundFile, "busted-ordered-key", "busted-other-tag")) + assert.equals(0, #getPlayingSounds(otherLongSoundFile)) + end) + + it("stopSounds stops only the sound named in the ordered argument form", function() + if mediaPlaybackUnavailable() then + return + end + local started = {} + collect("sysMediaStarted", started) + + writeSoundFiles() + assert.is_true(playSoundFile({name = longSoundFile, key = "busted-stop-named"})) + waitForCount("sysMediaStarted", started, 1) + assert.is_true(playSoundFile({name = otherLongSoundFile, key = "busted-stop-spared"})) + waitForCount("sysMediaStarted", started, 2) + assert.equals(2, #getPlayingSounds()) + + -- name[,key][,tag][,priority][,fadeaway][,fadeout] + assert.is_true(stopSounds(longSoundFile)) + local playing = getPlayingSounds() + assert.equals(1, #playing) + assert.equals(otherLongSoundFile, playing[1].name) + end) + + it("stopMusic stops only the track named in the ordered argument form", function() + if mediaPlaybackUnavailable() then + return + end + local started = {} + collect("sysMediaStarted", started) + + writeSoundFiles() + assert.is_true(playMusicFile({name = longSoundFile, key = "busted-music-stop-named"})) + waitForCount("sysMediaStarted", started, 1) + assert.is_true(playMusicFile({name = otherLongSoundFile, key = "busted-music-stop-spared"})) + waitForCount("sysMediaStarted", started, 2) + assert.equals(2, #getPlayingMusic()) + + -- name[,key][,tag][,fadeaway][,fadeout] + assert.is_true(stopMusic(longSoundFile)) + local music = getPlayingMusic() + assert.equals(1, #music) + assert.equals(otherLongSoundFile, music[1].name) + end) + + it("pauseMusic and getPausedMusic take the same key filter", function() + if mediaPlaybackUnavailable() then + return + end + local started = {} + collect("sysMediaStarted", started) + + writeSoundFiles() + assert.is_true(playMusicFile({name = longSoundFile, key = "busted-music-parked-key"})) + waitForCount("sysMediaStarted", started, 1) + assert.is_true(playMusicFile({name = otherLongSoundFile, key = "busted-music-playing-key"})) + waitForCount("sysMediaStarted", started, 2) + + assert.is_true(pauseMusic({key = "busted-music-parked-key"})) + assert.equals(1, #getPlayingMusic()) + local paused = getPausedMusic() + assert.equals(1, #paused) + assert.equals(longSoundFile, paused[1].name) + assert.equals(1, #getPausedMusic({key = "busted-music-parked-key"})) + assert.equals(0, #getPausedMusic({key = "busted-music-playing-key"})) + end) + + it("getPausedSounds takes the same key filter as the sound that was paused", function() + if mediaPlaybackUnavailable() then + return + end + local started = {} + collect("sysMediaStarted", started) + + writeSoundFiles() + assert.is_true(playSoundFile({name = longSoundFile, key = "busted-sound-parked-key"})) + waitForCount("sysMediaStarted", started, 1) + assert.is_true(pauseSounds({key = "busted-sound-parked-key"})) + + assert.equals(1, #getPausedSounds({key = "busted-sound-parked-key"})) + assert.equals(0, #getPausedSounds({key = "busted-sound-never-played"})) + assert.equals(0, #getPausedSounds({name = otherLongSoundFile})) + end) + + it("playVideoFile plays into the label its key names and the video family reports it", function() + if videoWidgetUnavailable() or mediaPlaybackUnavailable() then + return + end + -- The file is the same silent WAV the sound specs use: what makes this a + -- video request is the type it is made as, which is what decides the widget + -- setup, the list it is tracked in and the media type its events carry. A + -- decodable picture would only change what the video widget draws. + withVideoLabel() + writeSoundFiles() + assert.equals(0, #getPlayingVideos()) + + assert.is_true(playVideoFile({name = longSoundFile, key = videoLabel, tag = "busted-video-tag"})) + local event, file, _, mediaType, key, tag = waitForEvent("sysMediaStarted", 5000) + assert.equals("sysMediaStarted", event) + assert.equals(longSoundFile, file) + assert.equals("video", mediaType) + assert.equals(videoLabel, key) + assert.equals("busted-video-tag", tag) + + local playing = getPlayingVideos() + assert.equals(1, #playing) + assert.equals(longSoundFile, playing[1].name) + assert.equals(videoLabel, playing[1].key) + -- videos are tracked apart from sounds and music + assert.equals(0, #getPlayingSounds()) + assert.equals(0, #getPlayingMusic()) + assert.equals(1, #getPlayingVideos({key = videoLabel})) + assert.equals(0, #getPlayingVideos({key = "busted-video-other-key"})) + + assert.is_true(pauseVideos()) + assert.equals(0, #getPlayingVideos()) + local paused = getPausedVideos() + assert.equals(1, #paused) + assert.equals(longSoundFile, paused[1].name) + assert.equals(1, #getPausedVideos({name = longSoundFile})) + + -- resumed by playing the same file again, like sounds and music are + assert.is_true(playVideoFile({name = longSoundFile, key = videoLabel})) + assert.equals(1, #getPlayingVideos()) + assert.equals(0, #getPausedVideos()) + + assert.is_true(stopVideos()) + assert.equals(0, #getPlayingVideos()) + end) + + it("playVideoFile starts nothing when its key names no widget to draw into", function() + if mediaPlaybackUnavailable() then + return + end + writeSoundFiles() + -- The request is understood, so it reports success; the widget lookup then + -- turns up nothing and the playback never starts. Nothing but the video + -- list says so, which is why this is worth holding to. + assert.is_true(playVideoFile({name = longSoundFile, key = "busted-media-no-such-widget"})) + assert.equals(0, #getPlayingVideos()) + assert.equals(0, #getPausedVideos()) + end) end) describe("receiveMSP reports MSP is not enabled while offline", function() @@ -783,6 +1267,15 @@ describe("Tests the text-to-speech Lua API", function() return true end + -- Undone at the end of the current spec, for the same reason the media + -- specs above keep a list: busted's finally() holds one function, not a + -- list, and these specs have several things to put back. + local cleanups = {} + + local function onCleanup(undo) + cleanups[#cleanups + 1] = undo + end + -- Collects every occurrence of an event for the duration of one spec. -- The mock engine changes state inside the ttsSpeak()/ttsSkip() call -- itself, so the matching event is raised before a waitForEvent() could @@ -791,7 +1284,7 @@ describe("Tests the text-to-speech Lua API", function() local handler = registerAnonymousEventHandler(eventName, function(_, first) into[#into + 1] = first == nil and true or first end) - finally(function() killAnonymousEventHandler(handler) end) + onCleanup(function() killAnonymousEventHandler(handler) end) end -- The mock engine speaks in real time at roughly a tenth of a second per @@ -803,6 +1296,10 @@ describe("Tests the text-to-speech Lua API", function() ttsClearQueue() ttsSkip() end + for index = #cleanups, 1, -1 do + cleanups[index]() + end + cleanups = {} end) it("ttsSpeak rejects whitespace-only text", function() @@ -1092,7 +1589,7 @@ describe("Tests the text-to-speech Lua API", function() collect("ttsPitchChanged", pitches) collect("ttsVolumeChanged", volumes) local rate, pitch, volume = ttsGetRate(), ttsGetPitch(), ttsGetVolume() - finally(function() + onCleanup(function() ttsSetRate(rate) ttsSetPitch(pitch) ttsSetVolume(volume) @@ -1132,7 +1629,7 @@ describe("Tests the text-to-speech Lua API", function() local changes = {} local originalVoice = ttsGetCurrentVoice() collect("ttsVoiceChanged", changes) - finally(function() ttsSetVoiceByName(originalVoice) end) + onCleanup(function() ttsSetVoiceByName(originalVoice) end) assert.is_true(ttsSetVoiceByName(voices[2])) assert.equals(voices[2], ttsGetCurrentVoice()) @@ -1239,7 +1736,7 @@ describe("Tests the text-to-speech Lua API", function() local changes = {} collect("ttsVoiceChanged", changes) local originalVoice = ttsGetCurrentVoice() - finally(function() ttsSetVoiceByName(originalVoice) end) + onCleanup(function() ttsSetVoiceByName(originalVoice) end) assert.is_true(ttsSetVoiceByName(voices[2])) assert.equals(voices[2], ttsGetCurrentVoice()) diff --git a/src/mudlet-lua/tests/Networking_spec.lua b/src/mudlet-lua/tests/Networking_spec.lua index df3975d2b..677fe190d 100644 --- a/src/mudlet-lua/tests/Networking_spec.lua +++ b/src/mudlet-lua/tests/Networking_spec.lua @@ -1736,3 +1736,231 @@ describe("Discord Lua API availability contract", function() end) end) end) + +describe("The IRC configuration functions round-trip through the profile", function() + -- While a profile has no IRC dialog - none of these specs opens one - the + -- getters read the profile's own configuration off disk, which is what the + -- setters write to. So the round trip is testable with no IRC server and no + -- connection anywhere in sight. + -- + -- The profile's own IRC configuration is put back afterwards, because the + -- self-test profile is reused between runs. Two things the restore cannot + -- reach, both of which matter to a developer running the suite against a + -- config root that is not a throwaway one: + -- + -- - the IRC password. setIrcServer() writes it on every call and blanks it + -- when none is passed, and no getter reads it back, so any password the + -- profile had is gone either way. + -- - the last-used nick, which setIrcNick() also writes to a file shared by + -- every profile (mudlet's data directory, not the profile's). Putting the + -- profile's nick back writes that file again rather than restoring it. + local function restoreIrcConfiguration() + local nick = getIrcNick() + local hostName, port, secure = getIrcServer() + local channels = getIrcChannels() + finally(function() + setIrcNick(nick) + setIrcServer(hostName, port, secure) + setIrcChannels(channels) + end) + end + + describe("getIrcNick, getIrcServer and getIrcChannels", function() + it("report a nick, a server and a channel list without an IRC client", function() + -- with nothing configured each getter falls back to a built-in default + -- rather than to nil, which is what makes them safe to read before + -- anything has been set + local nick = getIrcNick() + assert.is_string(nick) + assert.is_true(#nick > 0) + + local hostName, port, secure = getIrcServer() + assert.is_string(hostName) + assert.is_true(#hostName > 0) + assert.is_number(port) + assert.is_true(port >= 1 and port <= 65535, tostring(port)) + assert.is_boolean(secure) + + local channels = getIrcChannels() + assert.is_table(channels) + assert.is_true(#channels > 0) + for _, channel in ipairs(channels) do + assert.is_string(channel) + end + end) + end) + + describe("setIrcNick", function() + it("raises a Lua error when the nick is missing or not a string", function() + assertArgError(function() setIrcNick() end, "setIrcNick: bad argument #1 type (nick as string expected") + assertArgError(function() setIrcNick({}) end, "setIrcNick: bad argument #1 type (nick as string expected, got table!)") + end) + + it("returns nil and a message for an empty nick, leaving the stored one alone", function() + restoreIrcConfiguration() + assert.is_true(setIrcNick("BustedKeptNick")) + + local ok, err = setIrcNick("") + assert.is_nil(ok) + assert.is_true(contains(err, "nick must not be empty"), tostring(err)) + assert.equals("BustedKeptNick", getIrcNick()) + end) + + it("stores the nick where getIrcNick reads it back", function() + restoreIrcConfiguration() + assert.is_true(setIrcNick("BustedNickOne")) + assert.equals("BustedNickOne", getIrcNick()) + + assert.is_true(setIrcNick("BustedNickTwo")) + assert.equals("BustedNickTwo", getIrcNick()) + end) + end) + + describe("setIrcServer", function() + it("raises a Lua error when the hostname or an optional argument is wrongly typed", function() + assertArgError(function() setIrcServer() end, "setIrcServer: bad argument #1 type (hostname as string expected") + assertArgError(function() setIrcServer({}) end, "setIrcServer: bad argument #1 type (hostname as string expected, got table!)") + assertArgError(function() setIrcServer("irc.busted.invalid", {}) end, "port number") + assertArgError(function() setIrcServer("irc.busted.invalid", 6667, "yes") end, "secure") + assertArgError(function() setIrcServer("irc.busted.invalid", 6667, false, {}) end, "server password") + end) + + it("returns nil and a message for an empty hostname or an out-of-range port", function() + restoreIrcConfiguration() + assert.is_true(setIrcServer("irc.busted-kept.invalid", 6690)) + + local ok, err = setIrcServer("") + assert.is_nil(ok) + assert.is_true(contains(err, "hostname must not be empty"), tostring(err)) + + ok, err = setIrcServer("irc.busted.invalid", 70000) + assert.is_nil(ok) + assert.is_true(contains(err, "invalid port number 70000"), tostring(err)) + + ok, err = setIrcServer("irc.busted.invalid", 0) + assert.is_nil(ok) + assert.is_true(contains(err, "invalid port number 0"), tostring(err)) + + -- a refused call stored nothing + local hostName, port = getIrcServer() + assert.equals("irc.busted-kept.invalid", hostName) + assert.equals(6690, port) + end) + + it("stores the hostname, port and secure flag where getIrcServer reads them back", function() + restoreIrcConfiguration() + -- it reports success as true plus a nil second value + local ok, extra = setIrcServer("irc.busted-one.invalid", 6697, true) + assert.is_true(ok) + assert.is_nil(extra) + + local hostName, port, secure = getIrcServer() + assert.equals("irc.busted-one.invalid", hostName) + assert.equals(6697, port) + assert.is_true(secure) + + -- the secure flag is stored, not merely defaulted: turn it back off + assert.is_true(setIrcServer("irc.busted-two.invalid", 6668, false)) + hostName, port, secure = getIrcServer() + assert.equals("irc.busted-two.invalid", hostName) + assert.equals(6668, port) + assert.is_false(secure) + end) + + it("falls back to port 6667 and an insecure connection when only a hostname is given", function() + restoreIrcConfiguration() + assert.is_true(setIrcServer("irc.busted-secure.invalid", 6697, true)) + + assert.is_true(setIrcServer("irc.busted-default.invalid")) + local hostName, port, secure = getIrcServer() + assert.equals("irc.busted-default.invalid", hostName) + assert.equals(6667, port) + assert.is_false(secure) + end) + end) + + describe("setIrcChannels", function() + it("raises a Lua error when the channels are not a table", function() + assertArgError(function() setIrcChannels("#mudlet") end, "setIrcChannels: bad argument #1 type (channels as table expected, got string!)") + assertArgError(function() setIrcChannels() end, "setIrcChannels: bad argument #1 type (channels as table expected, got no value!)") + end) + + it("returns nil and a message when no entry is a usable channel name", function() + restoreIrcConfiguration() + assert.is_true(setIrcChannels({"#busted-kept"})) + + local ok, err = setIrcChannels({}) + assert.is_nil(ok) + assert.is_true(contains(err, "no (valid) channel names provided"), tostring(err)) + + -- a channel name has to start with #, & or +, and only strings are read + ok, err = setIrcChannels({"mudlet", 42, ""}) + assert.is_nil(ok) + assert.is_true(contains(err, "no (valid) channel names provided"), tostring(err)) + assert.same({"#busted-kept"}, getIrcChannels()) + end) + + it("stores the channel list where getIrcChannels reads it back", function() + restoreIrcConfiguration() + assert.is_true(setIrcChannels({"#busted-one", "&busted-two", "+busted-three"})) + assert.same({"#busted-one", "&busted-two", "+busted-three"}, getIrcChannels()) + end) + + it("keeps the usable channel names out of a mixed list and drops the rest", function() + restoreIrcConfiguration() + assert.is_true(setIrcChannels({"#busted-good", "busted-bad", "&busted-also-good"})) + assert.same({"#busted-good", "&busted-also-good"}, getIrcChannels()) + end) + end) + + describe("getIrcConnectedHost and restartIrc without a client", function() + -- Both of these read whether the profile has an IRC dialog, and nothing in + -- the suite creates one - see the openIRC spec below for why. Should + -- something start doing so, these are where it shows up first. + it("getIrcConnectedHost returns false and says there is no client", function() + local ok, err = getIrcConnectedHost() + assert.is_false(ok) + assert.equals("no client active", err) + end) + + it("restartIrc returns false", function() + -- there is no client to restart, and it says so by returning false + -- rather than by opening one + assert.is_false(restartIrc(), "something in this run opened an IRC client") + end) + end) + + describe("sendIrc", function() + -- Both arguments are checked before the IRC dialog would be created, so + -- these calls open no client. A well-formed sendIrc() does create one, + -- which is why there is no spec here for the delivery path. + it("raises a Lua error when the target or the message is missing or wrongly typed", function() + assertArgError(function() sendIrc() end, "sendIrc: bad argument #1 type (target as string expected") + assertArgError(function() sendIrc("#mudlet") end, "sendIrc: bad argument #2 type (message as string expected") + assertArgError(function() sendIrc({}, "hello") end, "sendIrc: bad argument #1 type (target as string expected, got table!)") + assertArgError(function() sendIrc("#mudlet", {}) end, "sendIrc: bad argument #2 type (message as string expected, got table!)") + end) + end) + + describe("openIRC", function() + it("opens the IRC client window", function() + pending("openIRC creates the profile's IRC dialog and nothing in the Lua API closes it again. " + .. "From then on the getters answer out of the copy the dialog read when it was constructed - " + .. "a setIrcNick() while it is open is not seen by getIrcNick() until restartIrc() - so the " + .. "round trips above would stop working for the rest of the run, and the dialog dials the " + .. "configured server and raises a window over the specs that follow") + end) + end) +end) + +describe("getNetworkLatency", function() + it("reports zero on a profile whose game socket has never been timed", function() + -- The latency is measured between a command going out and the prompt that + -- answers it, and nothing in the suite connects the game socket - so the + -- untouched value is what this reads, which is also what pins it to the + -- right member. A meaningful reading needs a game server. + local latency = getNetworkLatency() + assert.is_number(latency) + assert.equals(0, latency) + end) +end) From 4c2d438d9b941f582885907e58a648a198dc2009 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Tue, 11 Aug 2026 08:08:16 +0200 Subject: [PATCH 147/155] infrastructure: busted specs for the last uncovered lua-lib functions (#9774) #### Brief overview of PR changes/additions - **+244 busted specs** covering the last uncovered lua-lib rows: the 20 `db:_*` internals (against real sqlite, not strings), IDManager's private event/timer stores, `saveMap`/`loadMap` round-trips including the `.xml` import branch, and the Geyser residue (label movies, callback registration, nested labels, adjustable container mouse handlers, MiniConsole command line actions, UserWindow constraints). - **Two new fixtures, both cheap**: a committed 30-line map XML, and a 1x1 two-frame animated GIF written from Lua at run time so no binary is committed. - **No runtime cost**: suite goes 2412 -> 2656 specs at the same ~42s, and passes on a fresh profile and twice on a reused one. #### Motivation for adding to Mudlet These are the functions every public `db:`, named-handler and Geyser call is built out of, and the SQL escaping and quoting rules were nowhere written down. `saveMap`/`loadMap` had no round-trip at all - the format that holds a player's whole map was only exercised by hand. #### Other info (issues closed, discussion etc) Six bugs found and deliberately *not* specced, filed separately: `table.contains` stack-overflows on a self-referential table (so on any Geyser object); `_index = "name"` as a bare string crashes `db:create` although `_unique` accepts one; `setDoubleClickCallback` stores `doubleclickCallback` while everything else reads `doubleClickCallback`; `saveMap` accepts a bare relative path and writes it to Mudlet's working directory; `saveMap` accepts a format version below `mMinVersion`; `db:_extract_table_constraints` cannot see a `UNIQUE` with no `ON CONFLICT`. Pre-existing and untouched: UI_spec's `getMainWindowSize returns a positive width and height` already fails on a second run against the same profile on `development`. **Test case:** full suite 2656/0/0 + 140 pending, green on a fresh profile and twice on a reused one; 21 sabotage runs proved 57+ of the new specs fail when the behaviour under them is broken. Assisted-by: Claude:claude-opus-5 --- src/mudlet-lua/tests/DB_spec.lua | 788 ++++++++++++++++++ .../tests/GeyserAdjustableContainer_spec.lua | 314 +++++++ src/mudlet-lua/tests/GeyserContainer_spec.lua | 17 + src/mudlet-lua/tests/GeyserLabel_spec.lua | 573 +++++++++++++ .../tests/GeyserMiniConsole_spec.lua | 66 ++ .../tests/GeyserUserWindow_spec.lua | 93 +++ src/mudlet-lua/tests/IDManager_spec.lua | 248 ++++++ src/mudlet-lua/tests/Mapper_spec.lua | 317 +++++++ src/mudlet-lua/tests/TableUtils_spec.lua | 57 ++ .../tests/fixtures/maps/minimal-map.xml | 30 + 10 files changed, 2503 insertions(+) create mode 100644 src/mudlet-lua/tests/fixtures/maps/minimal-map.xml diff --git a/src/mudlet-lua/tests/DB_spec.lua b/src/mudlet-lua/tests/DB_spec.lua index f9e95f841..71a5b2f3e 100644 --- a/src/mudlet-lua/tests/DB_spec.lua +++ b/src/mudlet-lua/tests/DB_spec.lua @@ -2175,3 +2175,791 @@ describe("Tests db:echo_sql", function() assert.is_falsy(saved) end) end) + +-- The helpers below all begin with an underscore: they are db's internals, not +-- its public API. They are specced directly because every public db function is +-- built out of them, so a change to one of them moves behaviour everywhere at +-- once, and because the SQL they produce is the only place the escaping and +-- quoting rules are actually written down. +describe("Tests db's internal SQL helpers", function() + + describe("Tests db:_sql_type", function() + it("maps a number to REAL", function() + assert.are.equal("REAL", db:_sql_type(0)) + assert.are.equal("REAL", db:_sql_type(-1.5)) + end) + + it("maps nil to NULL", function() + assert.are.equal("NULL", db:_sql_type(nil)) + end) + + it("maps a timestamp to INTEGER, including the empty one", function() + assert.are.equal("INTEGER", db:_sql_type(db:Timestamp(1234))) + assert.are.equal("INTEGER", db:_sql_type(db:Timestamp("CURRENT_TIMESTAMP"))) + -- db:Timestamp(nil) stores false rather than nil, so it is still a + -- timestamp column and must not fall through to TEXT + assert.are.equal("INTEGER", db:_sql_type(db:Timestamp(nil))) + end) + + it("maps db:Null to NULL", function() + assert.are.equal("NULL", db:_sql_type(db:Null())) + end) + + it("maps everything else, including a plain table, to TEXT", function() + assert.are.equal("TEXT", db:_sql_type("")) + assert.are.equal("TEXT", db:_sql_type("some text")) + assert.are.equal("TEXT", db:_sql_type(true)) + assert.are.equal("TEXT", db:_sql_type({})) + end) + end) + + describe("Tests db:_sql_convert", function() + it("double quotes a string default and doubles up single quotes in it", function() + assert.are.equal('""', db:_sql_convert("")) + assert.are.equal('"plain"', db:_sql_convert("plain")) + assert.are.equal([["it''s"]], db:_sql_convert("it's")) + end) + + it("renders nil and db:Null as the NULL keyword", function() + assert.are.equal("NULL", db:_sql_convert(nil)) + assert.are.equal("NULL", db:_sql_convert(db:Null())) + end) + + it("renders a timestamp as its raw epoch number", function() + assert.are.equal("1234", db:_sql_convert(db:Timestamp(1234))) + end) + + it("renders the empty timestamp as NULL rather than as false", function() + assert.are.equal("NULL", db:_sql_convert(db:Timestamp(nil))) + end) + + it("renders anything else with tostring, unquoted", function() + assert.are.equal("42", db:_sql_convert(42)) + assert.are.equal("true", db:_sql_convert(true)) + end) + end) + + describe("Tests db:_index_name", function() + it("names a single column index after the sheet and the column", function() + assert.are.equal("idx_people_c_city", db:_index_name("people", "city")) + end) + + it("joins every column of a compound index into one name", function() + assert.are.equal("idx_people_c_name_city", db:_index_name("people", {"name", "city"})) + end) + + it("gives two different indexes on one sheet two different names", function() + -- the names have to differ or CREATE INDEX IF NOT EXISTS silently keeps + -- the first index and the second one is never made + assert.are_not.equal(db:_index_name("people", "city"), db:_index_name("people", "name")) + assert.are_not.equal(db:_index_name("people", {"name", "city"}), db:_index_name("people", {"city", "name"})) + end) + + it("refuses anything that is not a string or a table", function() + local ok, err = pcall(function() return db:_index_name("people", 42) end) + assert.is_false(ok) + assert.is_truthy(string.find(err, "Indexes must be either a string or a table.", 1, true)) + end) + end) + + describe("Tests db:_index_valid", function() + local columns = {name = "TEXT", city = "TEXT"} + + it("accepts a single column index that names a real column", function() + assert.is_true(db:_index_valid(columns, "city")) + end) + + it("rejects a single column index that names a column the sheet lacks", function() + assert.is_false(db:_index_valid(columns, "nosuchcolumn")) + end) + + it("accepts a compound index whose columns all exist", function() + assert.is_true(db:_index_valid(columns, {"name", "city"})) + end) + + it("rejects a compound index as soon as one column is missing", function() + assert.is_false(db:_index_valid(columns, {"name", "nosuchcolumn"})) + end) + + it("accepts an empty compound index", function() + assert.is_true(db:_index_valid(columns, {})) + end) + end) + + describe("Tests db:_sql_columns", function() + it("lower cases and double quotes a single column name", function() + assert.are.equal('"city"', db:_sql_columns("City")) + end) + + it("comma separates a list of column names", function() + assert.are.equal('"name","city"', db:_sql_columns({"name", "City"})) + end) + + it("attaches a sort direction to the column before it instead of quoting it", function() + -- db:fetch appends "DESC" as its own list entry, so it must not come out + -- as a column name of its own + assert.are.equal('"name" DESC', db:_sql_columns({"name", "DESC"})) + assert.are.equal('"name" asc,"city" desc', db:_sql_columns({"name", "asc", "city", "desc"})) + end) + + it("refuses anything that is not a string or a table", function() + local ok, err = pcall(function() return db:_sql_columns(42) end) + assert.is_false(ok) + assert.is_truthy(string.find(err, "Must specify either a table array or string for index, not number", 1, true)) + end) + end) + + describe("Tests db:_sql_fields", function() + it("wraps one quoted field name in parentheses", function() + assert.are.equal('("name")', db:_sql_fields({name = "Bob"})) + end) + + it("keeps the case of the field name, unlike db:_sql_columns", function() + assert.are.equal('("Name")', db:_sql_fields({Name = "Bob"})) + end) + + it("produces an empty list for an empty row", function() + assert.are.equal("()", db:_sql_fields({})) + end) + end) + + describe("Tests db:_sql_values", function() + it("single quotes a string and doubles up single quotes in it", function() + assert.are.equal("('plain')", db:_sql_values({name = "plain"})) + assert.are.equal("('it''s')", db:_sql_values({name = "it's"})) + end) + + it("leaves a number unquoted", function() + assert.are.equal("(42)", db:_sql_values({kills = 42})) + end) + + it("turns CURRENT_TIMESTAMP into a call to sqlite's datetime", function() + assert.are.equal("(datetime('now'))", db:_sql_values({when_ = db:Timestamp("CURRENT_TIMESTAMP")})) + end) + + it("turns an epoch timestamp into a unixepoch conversion", function() + assert.are.equal("(datetime('1234', 'unixepoch'))", db:_sql_values({when_ = db:Timestamp(1234)})) + end) + + it("turns the empty timestamp and db:Null into NULL", function() + assert.are.equal("(NULL)", db:_sql_values({when_ = db:Timestamp(nil)})) + assert.are.equal("(NULL)", db:_sql_values({whatever = db:Null()})) + end) + + it("produces an empty list for an empty row", function() + assert.are.equal("()", db:_sql_values({})) + end) + end) + + describe("Tests db:_sql_fields and db:_sql_values together", function() + it("lists the fields and the values of one row in the same order", function() + -- this is the only thing that makes the pair usable: db:add writes + -- "INSERT INTO sheet <fields> VALUES <values>", and both walk the row + -- with pairs(), so the two walks have to agree or every column of every + -- insert lands in the wrong one + local row = {alpha = "a", bravo = "b", charlie = "c", delta = 4, echo = "e"} + + local fields = db:_sql_fields(row):match("^%((.*)%)$") + local values = db:_sql_values(row):match("^%((.*)%)$") + local names, contents = string.split(fields, ","), string.split(values, ",") + + assert.are.equal(5, #names) + assert.are.equal(#names, #contents) + for index, name in ipairs(names) do + local column = name:match('^"(.*)"$') + local expected = type(row[column]) == "string" and ("'" .. row[column] .. "'") or tostring(row[column]) + assert.are.equal(expected, contents[index], "column " .. column .. " did not line up with its value") + end + end) + end) + + describe("Tests db:_validate_validations", function() + it("accepts every documented conflict resolution", function() + for _, option in ipairs({"ABORT", "FAIL", "IGNORE", "REPLACE", "ROLLBACK"}) do + local valid, msg = db:_validate_validations(option) + assert.is_true(valid, option .. " should be a valid _violations option") + assert.are.equal("", msg) + end + end) + + it("rejects an option it does not know and says what it wanted", function() + local valid, msg = db:_validate_validations("NONSENSE") + assert.is_false(valid) + assert.is_truthy(string.find(msg, "_validations must be one of", 1, true)) + assert.is_truthy(string.find(msg, "NONSENSE", 1, true)) + end) + + it("rejects a non-string and names the type it got", function() + local valid, msg = db:_validate_validations(42) + assert.is_false(valid) + assert.are.equal("_validations must be a string. Received number", msg) + end) + + it("is case sensitive", function() + assert.is_false((db:_validate_validations("fail"))) + end) + end) + + describe("Tests db:_validate_unique_contraints", function() + it("accepts a bare column name", function() + local valid, msg = db:_validate_unique_contraints("name") + assert.is_true(valid) + assert.are.equal("", msg) + end) + + it("accepts a list of column names", function() + assert.is_true((db:_validate_unique_contraints({"name", "city"}))) + end) + + it("accepts a compound constraint", function() + assert.is_true((db:_validate_unique_contraints({{"name", "city"}}))) + end) + + it("accepts an empty list", function() + assert.is_true((db:_validate_unique_contraints({}))) + end) + + it("rejects a compound constraint holding something other than a column name", function() + local valid, msg = db:_validate_unique_contraints({{"name", 42}}) + assert.is_false(valid) + assert.is_truthy(string.find(msg, "Multi-column definitions for _unique must be a list of strings", 1, true)) + end) + + it("rejects a member that is neither a string nor a table", function() + local valid, msg = db:_validate_unique_contraints({42}) + assert.is_false(valid) + assert.are.equal("Members of _unique must be a string or table. Received number.", msg) + end) + + it("rejects a constraint that is neither a string nor a table", function() + local valid, msg = db:_validate_unique_contraints(42) + assert.is_false(valid) + assert.are.equal("_unique must be a string or a table. Received number.", msg) + end) + + it("reports every bad member rather than only the first", function() + local valid, msg = db:_validate_unique_contraints({42, true}) + assert.is_false(valid) + assert.are.equal(2, #string.split(msg, "\n")) + end) + end) + + describe("Tests db:_extract_table_constraints", function() + it("returns nothing for no SQL at all", function() + assert.are.equal("", db:_extract_table_constraints(nil)) + assert.are.equal("", db:_extract_table_constraints("")) + end) + + it("returns nothing for SQL that is not a CREATE TABLE", function() + assert.are.equal("", db:_extract_table_constraints("SELECT * FROM people")) + end) + + it("returns nothing for a table with no unique constraints", function() + assert.are.equal("", db:_extract_table_constraints('CREATE TABLE people ("name" TEXT NULL DEFAULT "")')) + end) + + it("extracts a column level unique constraint", function() + assert.are.equal("unique on conflict replace", + db:_extract_table_constraints('CREATE TABLE people ("name" TEXT NULL DEFAULT "" UNIQUE ON CONFLICT REPLACE)')) + end) + + it("extracts a table level unique constraint with its columns", function() + assert.are.equal('unique("name", "city") on conflict fail', + db:_extract_table_constraints('CREATE TABLE people ("name" TEXT NULL, "city" TEXT NULL, UNIQUE("name", "city") ON CONFLICT FAIL)')) + end) + + it("ignores case, newlines and repeated whitespace", function() + local oneLine = 'CREATE TABLE people ("name" TEXT NULL DEFAULT "" UNIQUE ON CONFLICT REPLACE)' + local sprawling = 'create table people\n(\n "name" text null default ""\n unique on conflict replace\n)' + assert.are.equal(db:_extract_table_constraints(oneLine), db:_extract_table_constraints(sprawling)) + end) + + it("orders the constraints so that the same table always compares equal", function() + -- db:_migrate compares this string against the one it built to decide + -- whether to rebuild the table, so two spellings of one schema must match + local first = 'CREATE TABLE people ("a" TEXT UNIQUE ON CONFLICT FAIL, UNIQUE("b", "c") ON CONFLICT IGNORE)' + local second = 'CREATE TABLE people (UNIQUE("b", "c") ON CONFLICT IGNORE, "a" TEXT UNIQUE ON CONFLICT FAIL)' + assert.are.equal(db:_extract_table_constraints(first), db:_extract_table_constraints(second)) + assert.are.equal('unique on conflict fail|unique("b", "c") on conflict ignore', db:_extract_table_constraints(first)) + end) + + it("separates a change of conflict resolution from an unchanged one", function() + local fail = 'CREATE TABLE people ("name" TEXT UNIQUE ON CONFLICT FAIL)' + local replace = 'CREATE TABLE people ("name" TEXT UNIQUE ON CONFLICT REPLACE)' + assert.are_not.equal(db:_extract_table_constraints(fail), db:_extract_table_constraints(replace)) + end) + + it("ignores a column that was added or removed", function() + -- the whole point of comparing constraints instead of the whole statement + local before = 'CREATE TABLE people ("name" TEXT UNIQUE ON CONFLICT FAIL)' + local after = 'CREATE TABLE people ("name" TEXT UNIQUE ON CONFLICT FAIL, "city" TEXT NULL DEFAULT "")' + assert.are.equal(db:_extract_table_constraints(before), db:_extract_table_constraints(after)) + end) + end) + + describe("Tests db:_build_create_table_sql", function() + it("always gives the sheet an autoincrementing _row_id", function() + local sql = db:_build_create_table_sql({columns = {name = ""}, options = {}}, "people") + assert.are.equal('CREATE TABLE people ("_row_id" INTEGER PRIMARY KEY AUTOINCREMENT, "name" TEXT NULL DEFAULT "")', sql) + end) + + it("types a column from its default value", function() + local sql = db:_build_create_table_sql({columns = {kills = 0}, options = {}}, "people") + assert.is_truthy(string.find(sql, '"kills" REAL NULL DEFAULT 0', 1, true)) + end) + + it("adds a column level unique constraint for a single unique column", function() + local sql = db:_build_create_table_sql({columns = {name = ""}, options = {_unique = "name"}}, "people") + assert.is_truthy(string.find(sql, '"name" TEXT NULL DEFAULT "" UNIQUE ON CONFLICT FAIL', 1, true)) + end) + + it("accepts the unique column as a one entry list too", function() + local sql = db:_build_create_table_sql({columns = {name = ""}, options = {_unique = {"name"}}}, "people") + assert.is_truthy(string.find(sql, 'UNIQUE ON CONFLICT FAIL', 1, true)) + end) + + it("adds a table level unique constraint for a compound one", function() + local sql = db:_build_create_table_sql({columns = {name = ""}, options = {_unique = {{"name", "city"}}}}, "people") + assert.is_truthy(string.find(sql, 'UNIQUE("name", "city") ON CONFLICT FAIL', 1, true)) + end) + + it("uses the sheet's conflict resolution rather than the default", function() + local sql = db:_build_create_table_sql({columns = {name = ""}, options = {_unique = "name", _violations = "REPLACE"}}, "people") + assert.is_truthy(string.find(sql, "ON CONFLICT REPLACE", 1, true)) + assert.is_nil(string.find(sql, "ON CONFLICT FAIL", 1, true)) + end) + + it("leaves a column that is not unique alone", function() + local sql = db:_build_create_table_sql({columns = {city = ""}, options = {_unique = "name"}}, "people") + assert.is_nil(string.find(sql, "UNIQUE", 1, true)) + end) + end) +end) + +-- These four run against a real sqlite database rather than against strings: +-- they are the parts of db:create that touch the file on disk. +describe("Tests db's internals against a real database", function() + local dbName = "dbinternalstestingonly" + local dbFile = getMudletHomeDir() .. "/Database_" .. dbName .. ".db" + local mydb + + local function indexNames(sheetName) + local conn = db.__conn[dbName] + local cursor = conn:execute( + "SELECT name FROM sqlite_master WHERE type = 'index' AND tbl_name = '" .. sheetName .. "' AND sql IS NOT NULL" + ) + local names = {} + local row = cursor:fetch({}, "a") + while row do + names[#names + 1] = row.name + row = cursor:fetch({}, "a") + end + cursor:close() + table.sort(names) + return names + end + + before_each(function() + mydb = db:create(dbName, { + people = { + name = "", + city = "", + kills = 0, + seen = db:Timestamp("CURRENT_TIMESTAMP"), + _index = {"city"} + } + }) + end) + + after_each(function() + db:close() + os.remove(dbFile) + mydb = nil + end) + + describe("Tests db:_isActiveDBName", function() + it("reports an open database whose file is on disk as active", function() + assert.is_truthy(db:_isActiveDBName(dbName)) + end) + + it("sanitises the name it is given first", function() + -- db:create sanitises too, so a caller passing the unsanitised name has + -- to reach the same connection or db:create opens a second one + assert.is_truthy(db:_isActiveDBName("DB Internals Testing Only")) + end) + + it("reports a database that was never created as inactive", function() + assert.is_falsy(db:_isActiveDBName("nosuchdatabaseatall")) + end) + + it("reports a closed database as inactive", function() + assert.is_true((db:close(dbName))) + assert.is_falsy(db:_isActiveDBName(dbName)) + end) + + it("reports an open connection whose file has gone as inactive", function() + -- the file is what db:create reconnects to, so a live handle to a deleted + -- file must not count as active + os.remove(dbFile) + if io.exists(dbFile) then + -- Windows will not unlink a file sqlite still has open, so there is no + -- open-connection-without-a-file state to ask about there + pending("this platform keeps a database file that is still open") + end + assert.is_falsy(db:_isActiveDBName(dbName)) + end) + end) + + describe("Tests db:get_database", function() + it("hands back a reference to a database that db:create already made", function() + local reference = db:get_database(dbName) + assert.is_table(reference) + assert.are.equal("people", reference.people._sht_name) + assert.are.equal("name", reference.people.name.name) + end) + + it("sanitises the name it is given", function() + assert.are.equal(dbName, db:get_database("DB Internals Testing Only")._db_name) + end) + + it("hands back a reference that reads the same rows as db:create's", function() + db:add(mydb.people, {name = "Bob", city = "Ankh-Morpork"}) + local rows = db:fetch(db:get_database(dbName).people) + assert.are.equal(1, #rows) + assert.are.equal("Bob", rows[1].name) + end) + + it("refuses a database that does not exist", function() + local ok, err = pcall(function() return db:get_database("nosuchdatabaseatall") end) + assert.is_false(ok) + assert.is_truthy(string.find(err, "Attempt to access database that does not exist.", 1, true)) + end) + + it("refuses a sheet the database does not have", function() + local ok, err = pcall(function() return db:get_database(dbName).nosuchsheet end) + assert.is_false(ok) + assert.is_truthy(string.find(err, "does not exist", 1, true)) + end) + end) + + describe("Tests db:fetch_sql", function() + before_each(function() + db:add(mydb.people, {name = "Bob", city = "Ankh-Morpork", kills = 3}) + db:add(mydb.people, {name = "Carrot", city = "Ankh-Morpork", kills = 7}) + end) + + it("returns one coerced row per result", function() + local rows = db:fetch_sql(mydb.people, "SELECT * FROM people ORDER BY name") + assert.are.equal(2, #rows) + assert.are.equal("Bob", rows[1].name) + assert.are.equal("Carrot", rows[2].name) + end) + + it("coerces the values it read to the types the sheet declares", function() + local rows = db:fetch_sql(mydb.people, "SELECT * FROM people WHERE name = 'Bob'") + assert.are.equal(3, rows[1].kills) + assert.is_number(rows[1]._row_id) + assert.is_number(rows[1].seen:as_number()) + end) + + it("returns an empty list rather than nil when nothing matched", function() + local rows = db:fetch_sql(mydb.people, "SELECT * FROM people WHERE name = 'Nobody'") + assert.are.same({}, rows) + end) + + it("honours the SQL it is handed rather than fetching the whole sheet", function() + local rows = db:fetch_sql(mydb.people, "SELECT * FROM people WHERE kills > 5") + assert.are.equal(1, #rows) + assert.are.equal("Carrot", rows[1].name) + end) + + it("returns nil for SQL sqlite could not run", function() + assert.is_nil(db:fetch_sql(mydb.people, "SELECT * FROM")) + assert.is_nil(db:fetch_sql(mydb.people, "SELECT * FROM nosuchsheet")) + end) + end) + + describe("Tests db:_coerce", function() + it("passes a raw expression through untouched", function() + assert.are.equal("upper(name)", db:_coerce(mydb.people.name, db:exp("upper(name)"))) + end) + + it("renders db:Null as the NULL keyword", function() + assert.are.equal("NULL", db:_coerce(mydb.people.name, db:Null())) + end) + + it("leaves a number field's value as a number", function() + assert.are.equal(7, db:_coerce(mydb.people.kills, 7)) + assert.are.equal(7, db:_coerce(mydb.people.kills, "7")) + end) + + it("quotes a value a number field cannot hold", function() + assert.are.equal("'lots'", db:_coerce(mydb.people.kills, "lots")) + end) + + it("renders a datetime field's value through sqlite's datetime", function() + assert.are.equal("datetime('now')", db:_coerce(mydb.people.seen, db:Timestamp("CURRENT_TIMESTAMP"))) + assert.are.equal("datetime('1234', 'unixepoch')", db:_coerce(mydb.people.seen, db:Timestamp(1234))) + assert.are.equal("NULL", db:_coerce(mydb.people.seen, db:Timestamp(nil))) + end) + + it("single quotes a text field's value and doubles up single quotes in it", function() + assert.are.equal("'Bob'", db:_coerce(mydb.people.name, "Bob")) + assert.are.equal("'it''s'", db:_coerce(mydb.people.name, "it's")) + end) + end) + + describe("Tests db:_coerce_sheet", function() + it("returns nothing at all when there is no row", function() + assert.is_nil(db:_coerce_sheet(mydb.people, nil)) + end) + + it("turns the sqlite text a row arrives as into the sheet's types", function() + local row = db:_coerce_sheet(mydb.people, {_row_id = "4", name = "Bob", kills = "3", seen = "2020-01-02 03:04:05"}) + assert.are.equal(4, row._row_id) + assert.are.equal(3, row.kills) + assert.are.equal("Bob", row.name) + assert.is_number(row.seen:as_number()) + end) + + it("leaves a number column that does not hold a number alone", function() + local row = db:_coerce_sheet(mydb.people, {_row_id = "1", kills = "lots"}) + assert.are.equal("lots", row.kills) + end) + + it("gives an empty datetime column an empty timestamp", function() + local row = db:_coerce_sheet(mydb.people, {_row_id = "1", seen = nil}, {"seen"}) + assert.is_false(row.seen._timestamp) + assert.is_nil((row.seen:as_number())) + end) + + it("only converts the columns it is told about", function() + local row = db:_coerce_sheet(mydb.people, {_row_id = "1", kills = "3", name = "Bob"}, {"name"}) + assert.are.equal("3", row.kills) + assert.are.equal("Bob", row.name) + end) + end) + + describe("Tests db:_migrate", function() + it("creates a sheet that the schema has but the file does not", function() + db.__schema[dbName].pets = {columns = {name = "", legs = 0}, options = {}} + db:_migrate(dbName, "pets") + + local pets = db:get_database(dbName).pets + db:add(pets, {name = "Gaspode", legs = 4}) + local rows = db:fetch(pets) + assert.are.equal(1, #rows) + assert.are.equal(4, rows[1].legs) + end) + + it("adds a column that the schema gained without losing the rows", function() + db:add(mydb.people, {name = "Bob", city = "Ankh-Morpork"}) + db.__schema[dbName].people.columns.rank = "" + db:_migrate(dbName, "people") + + local rows = db:fetch(db:get_database(dbName).people) + assert.are.equal(1, #rows) + assert.are.equal("Bob", rows[1].name) + assert.are.equal("", rows[1].rank) + end) + + it("runs again over an unchanged sheet without disturbing it", function() + db:add(mydb.people, {name = "Bob", city = "Ankh-Morpork", kills = 3}) + db:_migrate(dbName, "people") + db:_migrate(dbName, "people") + + local rows = db:fetch(mydb.people) + assert.are.equal(1, #rows) + assert.are.equal(3, rows[1].kills) + end) + + it("refuses to drop a column that still holds data unless forced", function() + db:add(mydb.people, {name = "Bob", city = "Ankh-Morpork"}) + db.__schema[dbName].people.columns.city = nil + + local ok, err = pcall(function() db:_migrate(dbName, "people") end) + assert.is_false(ok) + assert.is_truthy(string.find(err, "data present in undefined columns", 1, true)) + end) + + it("drops that column when it is forced to", function() + db:add(mydb.people, {name = "Bob", city = "Ankh-Morpork"}) + db.__schema[dbName].people.columns.city = nil + db:_migrate(dbName, "people", true) + + local rows = db:fetch(db:get_database(dbName).people) + assert.are.equal(1, #rows) + assert.are.equal("Bob", rows[1].name) + assert.is_nil(rows[1].city) + end) + + it("creates the indexes the schema asks for", function() + local conn = db.__conn[dbName] + conn:execute("DROP INDEX IF EXISTS " .. db:_index_name("people", "city")) + assert.are.same({}, indexNames("people")) + + db:_migrate(dbName, "people") + + assert.are.same({db:_index_name("people", "city")}, indexNames("people")) + end) + end) + + describe("Tests db:_drop_orphaned_indexes", function() + it("keeps an index the schema still asks for", function() + local schema = db.__schema[dbName].people + local ok, err = db:_drop_orphaned_indexes(db.__conn[dbName], "people", schema) + assert.is_true(ok) + assert.is_nil(err) + assert.are.same({db:_index_name("people", "city")}, indexNames("people")) + end) + + it("drops every index once the schema asks for none", function() + local schema = db.__schema[dbName].people + schema.options._index = nil + assert.is_true((db:_drop_orphaned_indexes(db.__conn[dbName], "people", schema))) + assert.are.same({}, indexNames("people")) + end) + + it("drops an index whose columns are no longer in the schema's index list", function() + local schema = db.__schema[dbName].people + schema.options._index = {"name"} + assert.is_true((db:_drop_orphaned_indexes(db.__conn[dbName], "people", schema))) + -- the city index is gone and the name one is not made here, only dropped + assert.are.same({}, indexNames("people")) + end) + + it("matches a compound index by its columns rather than by its name", function() + local conn = db.__conn[dbName] + conn:execute('CREATE INDEX IF NOT EXISTS idx_people_c_handmade ON people ("city", "name")') + local schema = db.__schema[dbName].people + schema.options._index = {{"name", "city"}} + assert.is_true((db:_drop_orphaned_indexes(conn, "people", schema))) + -- the column order differs and the name is nothing db would have picked, + -- but the index covers what the schema asked for, so it stays + assert.are.same({"idx_people_c_handmade"}, indexNames("people")) + end) + + it("drops a unique index, which db does not make any more", function() + local conn = db.__conn[dbName] + conn:execute('CREATE UNIQUE INDEX IF NOT EXISTS idx_people_c_name ON people ("name")') + local schema = db.__schema[dbName].people + schema.options._index = {"name", "city"} + assert.is_true((db:_drop_orphaned_indexes(conn, "people", schema))) + assert.are.same({db:_index_name("people", "city")}, indexNames("people")) + end) + + it("has nothing to do for a sheet that is not in the file", function() + -- it asks sqlite_master which indexes the sheet has rather than the sheet + -- itself, so an unknown sheet is an empty answer and not an error + local ok, err = db:_drop_orphaned_indexes(db.__conn[dbName], "nosuchsheet", db.__schema[dbName].people) + assert.is_true(ok) + assert.is_nil(err) + assert.are.same({db:_index_name("people", "city")}, indexNames("people")) + end) + end) + + describe("Tests db:_migrate_indexes", function() + local columns = {name = "TEXT", city = "TEXT", kills = "REAL"} + + it("creates an index the sheet does not have yet", function() + local conn = db.__conn[dbName] + db:_migrate_indexes(conn, "people", {columns = {}, options = {_index = {"name"}}}, columns) + assert.are.same({db:_index_name("people", "city"), db:_index_name("people", "name")}, indexNames("people")) + end) + + it("creates a compound index under its compound name", function() + local conn = db.__conn[dbName] + db:_migrate_indexes(conn, "people", {columns = {}, options = {_index = {{"name", "city"}}}}, columns) + assert.is_truthy(table.contains(indexNames("people"), db:_index_name("people", {"name", "city"}))) + end) + + it("skips an index that names a column the sheet does not have", function() + -- silently, on purpose: db:create would otherwise be unable to run at all + -- against a schema that lost a column + local conn = db.__conn[dbName] + db:_migrate_indexes(conn, "people", {columns = {}, options = {_index = {"nosuchcolumn"}}}, columns) + assert.are.same({db:_index_name("people", "city")}, indexNames("people")) + end) + + it("does nothing at all for a sheet with no indexes", function() + local conn = db.__conn[dbName] + db:_migrate_indexes(conn, "people", {columns = {}, options = {}}, columns) + assert.are.same({db:_index_name("people", "city")}, indexNames("people")) + end) + + it("runs again over an index that already exists without complaining", function() + local conn = db.__conn[dbName] + db:_migrate_indexes(conn, "people", {columns = {}, options = {_index = {"city"}}}, columns) + assert.are.same({db:_index_name("people", "city")}, indexNames("people")) + end) + end) +end) + +-- db:_closeAll is what db:close() with no name does and what the profile calls +-- on shutdown, so the rest of this file already leans on it. These specs pin +-- the two things it reports and the state it leaves behind. +describe("Tests db:_closeAll", function() + local first = "closealltestingonlyone" + local second = "closealltestingonlytwo" + + local function makeDatabases() + db:create(first, {sheet = {name = ""}}) + db:create(second, {sheet = {name = ""}}) + end + + after_each(function() + -- the specs below leave the environment closed about half the time, and + -- closing a closed one is an error rather than a no-op + if db.__env then + db:_closeAll() + end + os.remove(getMudletHomeDir() .. "/Database_" .. first .. ".db") + os.remove(getMudletHomeDir() .. "/Database_" .. second .. ".db") + end) + + it("closes every open database at once and says so", function() + makeDatabases() + local ok, msg = db:_closeAll() + assert.is_true(ok) + assert.are.equal("", msg) + assert.are.same({}, db.__conn) + assert.is_nil(db.__env) + end) + + it("leaves the databases reopenable, with their rows intact", function() + makeDatabases() + local mydb = db:get_database(first) + db:add(mydb.sheet, {name = "survivor"}) + db:_closeAll() + + local reopened = db:create(first, {sheet = {name = ""}}) + local rows = db:fetch(reopened.sheet) + assert.are.equal(1, #rows) + assert.are.equal("survivor", rows[1].name) + end) + + it("refuses when there is no database environment to close", function() + makeDatabases() + db:_closeAll() + local ok, msg = db:_closeAll() + assert.is_false(ok) + assert.are.equal("database environment is nil, did you forget to call db:create?", msg) + end) + + it("names the database that was already closed behind its back", function() + makeDatabases() + db.__conn[first]:close() + local ok, msg = db:_closeAll() + assert.is_false(ok) + assert.are.equal("database object for " .. first .. " is already closed.", msg) + -- the rest still closed, and the environment is still gone + assert.are.same({}, db.__conn) + assert.is_nil(db.__env) + end) + + it("is what db:close() with no name does", function() + makeDatabases() + assert.is_true((db:close())) + assert.is_nil(db.__env) + end) +end) diff --git a/src/mudlet-lua/tests/GeyserAdjustableContainer_spec.lua b/src/mudlet-lua/tests/GeyserAdjustableContainer_spec.lua index 8061eda63..b66bfa08f 100644 --- a/src/mudlet-lua/tests/GeyserAdjustableContainer_spec.lua +++ b/src/mudlet-lua/tests/GeyserAdjustableContainer_spec.lua @@ -441,3 +441,317 @@ describe("Tests functionality of Adjustable.Container", function() end) end) end) + +-- The handlers Adjustable.Container hangs off its own labels. A real mouse is +-- what normally calls them, with the event table Mudlet builds for a label +-- callback ({button = ..., x = ..., y = ..., globalX = ..., globalY = ...}), so +-- these specs hand them that table directly and read back what they did. +describe("Tests the Adjustable.Container mouse handlers", function() + local container + local containerName = "gahContainer" + + local function mouseEvent(button, x, y) + x, y = x or 5, y or 5 + return {button = button, buttons = {button}, x = x, y = y, globalX = x, globalY = y} + end + + before_each(function() + container = Adjustable.Container:new({ + name = containerName, + x = 20, y = 30, width = 200, height = 200, + autoLoad = false, + autoSave = false, + }) + -- Adjustable.Container keeps which edge is being dragged in one table + -- shared by every container, and only a completed left click empties it, + -- so start each spec from a released mouse rather than from whatever the + -- last spec left mid-drag + container:onClick(container.adjLabel, mouseEvent("LeftButton", 100, 100)) + container:onRelease(container.adjLabel, mouseEvent("LeftButton", 100, 100)) + end) + + after_each(function() + -- onEnterAtt and the right click path both open a nest, which arms a timer + -- that would fire on deleted labels seconds later + if Geyser.Label.closeAllTimer then + killTimer(Geyser.Label.closeAllTimer) + Geyser.Label.closeAllTimer = nil + end + if container then + -- and leave the drag state pointing at nothing rather than at a label + -- about to be deleted: Adjustable.Container:reposition reads it. A locked + -- container refuses the click, so unlock before making it + if container.locked then + container:unlockContainer() + end + container:onClick(container.adjLabel, mouseEvent("LeftButton", 100, 100)) + container:onRelease(container.adjLabel, mouseEvent("LeftButton", 100, 100)) + for _, label in ipairs({container.adjLabel, container.attLabel, container.rCLabel}) do + if label then + -- keyed by the label object, so an entry outlives the label + Geyser.Label.scrollV[label] = nil + Geyser.Label.scrollH[label] = nil + end + end + container:deleteSaveFile() + if Geyser.windowList[containerName] == container then + container:delete() + end + end + container = nil + Adjustable.Container.all[containerName] = nil + local index = table.index_of(Adjustable.Container.all_windows, containerName) + if index then + table.remove(Adjustable.Container.all_windows, index) + end + end) + + describe("Adjustable.Container:onClick and onRelease", function() + it("raises the reposition event once a left click is let go of", function() + local seen + local handler = registerAnonymousEventHandler("AdjustableContainerRepositionFinish", + function(_, name, width, height, x, y) seen = {name, width, height, x, y} end) + finally(function() killAnonymousEventHandler(handler) end) + + container:onClick(container.adjLabel, mouseEvent("LeftButton")) + container:onRelease(container.adjLabel, mouseEvent("LeftButton")) + + assert.is_table(seen) + assert.are.same({containerName, container:get_width(), container:get_height(), container:get_x(), container:get_y()}, seen) + end) + + it("stays quiet when the release was not of a left click", function() + local raised = false + local handler = registerAnonymousEventHandler("AdjustableContainerRepositionFinish", function() raised = true end) + finally(function() killAnonymousEventHandler(handler) end) + + container:onClick(container.adjLabel, mouseEvent("LeftButton")) + container:onRelease(container.adjLabel, mouseEvent("RightButton")) + + assert.is_false(raised) + end) + + it("stays quiet for a label that was not the one clicked", function() + local raised = false + local handler = registerAnonymousEventHandler("AdjustableContainerRepositionFinish", function() raised = true end) + finally(function() killAnonymousEventHandler(handler) end) + + container:onClick(container.adjLabel, mouseEvent("LeftButton")) + container:onRelease(container.exitLabel, mouseEvent("LeftButton")) + + assert.is_false(raised) + end) + + it("only raises the event once per click", function() + local raises = 0 + local handler = registerAnonymousEventHandler("AdjustableContainerRepositionFinish", function() raises = raises + 1 end) + finally(function() killAnonymousEventHandler(handler) end) + + container:onClick(container.adjLabel, mouseEvent("LeftButton")) + container:onRelease(container.adjLabel, mouseEvent("LeftButton")) + container:onRelease(container.adjLabel, mouseEvent("LeftButton")) + + assert.are.equal(1, raises) + end) + + it("takes the grabbing hand back after the drag", function() + container.adjLabel:setCursor("ClosedHand") + container:onClick(container.adjLabel, mouseEvent("LeftButton")) + container:onRelease(container.adjLabel, mouseEvent("LeftButton")) + assert.are.equal("OpenHand", container.adjLabel.cursorShape) + end) + + it("ignores a left click on a locked container that is on its own", function() + local raised = false + local handler = registerAnonymousEventHandler("AdjustableContainerRepositionFinish", function() raised = true end) + finally(function() killAnonymousEventHandler(handler) end) + + container:lockContainer() + container:onClick(container.adjLabel, mouseEvent("LeftButton")) + container:onRelease(container.adjLabel, mouseEvent("LeftButton")) + + -- the click never registered, so there is no drag to finish + assert.is_false(raised) + end) + end) + + describe("Adjustable.Container:onMove", function() + it("turns the container's position into a percentage of the main window", function() + local originalX, originalY = container:get_x(), container:get_y() + + container:onClick(container.adjLabel, mouseEvent("LeftButton")) + container:onMove(container.adjLabel, mouseEvent("LeftButton")) + + -- the mouse has not actually moved between the two, so the container + -- lands where it already was, but now expressed against the window + assert.is_truthy(tostring(container.x):find("%%$")) + assert.is_truthy(tostring(container.y):find("%%$")) + assert.is_true(math.abs(container:get_x() - originalX) <= 1) + assert.is_true(math.abs(container:get_y() - originalY) <= 1) + -- moving does not touch the size, which is what tells this apart from + -- the resize branch below + assert.are.equal("200px", container.width) + assert.are.equal("200px", container.height) + end) + + it("shows the grabbing hand while the container is being dragged", function() + container:onClick(container.adjLabel, mouseEvent("LeftButton")) + container:onMove(container.adjLabel, mouseEvent("LeftButton")) + assert.are.equal("ClosedHand", container.adjLabel.cursorShape) + end) + + it("takes the cursor away again and moves nothing while locked", function() + container.adjLabel:setCursor("OpenHand") + container:lockContainer() + + container:onMove(container.adjLabel, mouseEvent("NoButton")) + + assert.are.equal(0, container.adjLabel.cursorShape) + -- still the pixel position the constructor was given: a drag would have + -- made it a percentage of the main window, whatever pixel that works out + -- to. Geyser rewrites the plain number into "20px" when it constrains it + assert.are.equal("20px", container.x) + end) + + -- a click that lands within ten pixels of an edge grabs that edge, and the + -- next click sees it and switches from moving to resizing + it("resizes rather than moves when the drag started on an edge", function() + container:onClick(container.adjLabel, mouseEvent("LeftButton", 5, 5)) + container:onClick(container.adjLabel, mouseEvent("LeftButton", 5, 5)) + container:onMove(container.adjLabel, mouseEvent("LeftButton", 5, 5)) + + -- resizing rewrites the size as well as the position, where moving left + -- the size alone + assert.is_truthy(tostring(container.width):find("%%$")) + assert.is_truthy(tostring(container.height):find("%%$")) + -- the mouse did not move, so the left edge it grabbed stays where it was + assert.is_true(math.abs(container:get_width() - 200) <= 1) + end) + end) + + describe("Adjustable.Container:onClickL", function() + it("locks an unlocked container and hides its buttons", function() + assert.is_false(container.locked) + container:onClickL() + assert.is_true(container.locked) + assert.is_false(windowVisible(container.exitLabel.name)) + assert.is_false(windowVisible(container.minimizeLabel.name)) + end) + + it("unlocks a locked one and gives the buttons back", function() + container:onClickL() + container:onClickL() + assert.is_false(container.locked) + assert.is_true(windowVisible(container.exitLabel.name)) + assert.is_true(windowVisible(container.minimizeLabel.name)) + end) + end) + + describe("Adjustable.Container:onClickMin", function() + it("minimizes an open container down to its title bar", function() + assert.is_false(container.minimized) + container:onClickMin() + assert.is_true(container.minimized) + -- Inside is a plain Geyser.Container with no widget of its own, so its + -- own flag is the only place its visibility is readable + assert.is_true(container.Inside.hidden) + assert.are.equal(container.buttonsize + 10, container:get_height()) + end) + + it("restores a minimized one to the height it had", function() + local originalHeight = container:get_height() + container:onClickMin() + container:onClickMin() + assert.is_false(container.minimized) + assert.is_false(container.Inside.hidden) + assert.are.equal(originalHeight, container:get_height()) + end) + end) + + describe("Adjustable.Container:onClickSave and onClickLoad", function() + local saveFile + + before_each(function() + saveFile = string.format("%s%s.lua", container.defaultDir, containerName) + container:deleteSaveFile() + end) + + it("writes the container's layout to its save file", function() + assert.is_false(io.exists(saveFile)) + container:onClickSave() + assert.is_true(io.exists(saveFile)) + end) + + it("puts a saved layout back over whatever the container has now", function() + container:onClickSave() + container:move(300, 400) + assert.are.equal(300, container:get_x()) + + container:onClickLoad() + + assert.are.equal(20, container:get_x()) + assert.are.equal(30, container:get_y()) + end) + + it("brings the locked state back with the layout", function() + container:onClickL() + container:onClickSave() + container:onClickL() + assert.is_false(container.locked) + + container:onClickLoad() + + assert.is_true(container.locked) + end) + + it("does nothing to a container that has never been saved", function() + container:move(300, 400) + container:onClickLoad() + assert.are.equal(300, container:get_x()) + end) + end) + + describe("Adjustable.Container:onEnterAtt", function() + it("fills the attach menu with the borders the container can reach", function() + local positions = container:validAttachPositions() + assert.is_true(#positions > 0, "a container at the top left should be able to attach somewhere") + + container:onEnterAtt() + + assert.are.equal(#positions, #container.attLabel.nestedLabels) + for index = 1, #positions do + assert.are.equal(container.att[index], container.attLabel.nestedLabels[index]) + assert.are.equal("Adjustable.Container.attachToBorder", container.att[index].clickCallback) + end + end) + + it("opens the menu it just built", function() + container:onEnterAtt() + assert.is_true(windowVisible(container.att[1].name)) + end) + + it("rebuilds the menu rather than adding to it when hovered again", function() + container:onEnterAtt() + local first = #container.attLabel.nestedLabels + container:onEnterAtt() + assert.are.equal(first, #container.attLabel.nestedLabels) + end) + + it("drops the borders the container has moved away from", function() + -- the container starts at (20, 30), within reach of the top and left + assert.is_truthy(table.contains(container:validAttachPositions(), "top")) + assert.is_truthy(table.contains(container:validAttachPositions(), "left")) + + local winWidth, winHeight = getMainWindowSize() + container:move(winWidth * 0.5, winHeight * 0.5) + local reachable = container:validAttachPositions() + -- half a window away is out of reach of both, whatever the window size + assert.is_false(table.contains(reachable, "top")) + assert.is_false(table.contains(reachable, "left")) + + container:onEnterAtt() + + assert.are.equal(#reachable, #container.attLabel.nestedLabels) + end) + end) +end) diff --git a/src/mudlet-lua/tests/GeyserContainer_spec.lua b/src/mudlet-lua/tests/GeyserContainer_spec.lua index 1ee8d7c54..e3770cc98 100644 --- a/src/mudlet-lua/tests/GeyserContainer_spec.lua +++ b/src/mudlet-lua/tests/GeyserContainer_spec.lua @@ -766,3 +766,20 @@ describe("Tests functionality of Geyser.Container", function() end) end) end) + +-- GeyserTests.lua is Geyser's own hand-driven demo set, not a test suite. Every +-- one of these builds a screenful of widgets under a fixed global name and +-- leaves them there for a person to look at and click, so running them here +-- would leak a hundred labels and two globals into every spec file that follows +-- and still assert nothing. They are recorded rather than covered. +describe("Tests Geyser's built-in demos", function() + pending("Geyser.testLabels builds 101 labels for a person to look at - leaves labelTestContainer behind") + + pending("Geyser.testGauges builds 100 gauges for a person to look at - leaves gaugeTestContainer behind") + + pending("Geyser.demo1 builds a demo UI for a person to resize and click - leaves geyserDemoContainer behind") + + pending("demoCallback1 only runs from Geyser.demo1's label, off that demo's own gauges and consoles") + + pending("demoCallback2 only runs from Geyser.demo1's label, and moves that demo's own container") +end) diff --git a/src/mudlet-lua/tests/GeyserLabel_spec.lua b/src/mudlet-lua/tests/GeyserLabel_spec.lua index 2b81484e6..0efa628ec 100644 --- a/src/mudlet-lua/tests/GeyserLabel_spec.lua +++ b/src/mudlet-lua/tests/GeyserLabel_spec.lua @@ -521,3 +521,576 @@ describe("Tests functionality of Geyser.Label widget state", function() end) end) end) + +-- The movie wrappers, the callback registration bookkeeping and the nested +-- label machinery. All three are places where Geyser keeps state of its own +-- alongside the widget's, and the state is what these specs read back: a real +-- mouse is what fires the callbacks and what drives the nest, and Lua cannot +-- make one. +describe("Tests Geyser.Label movies, callbacks and nesting", function() + local created + local container + local gifPath = getMudletHomeDir() .. "/geyser_label_spec.gif" + + local function geometry(name) + local x, y, width, height = getWindowGeometry(name) + return {x = x, y = y, width = width, height = height} + end + + local function track(object) + created[#created + 1] = object + return object + end + + local function alive(object) + if not object or not object.container or not object.container.windowList then + return false + end + return object.container.windowList[object.name] == object + end + + -- The smallest animated GIF there is: 1x1 pixels, two frames, a two entry + -- colour table. Written at run time so that no binary has to be committed. + local function writeAnimatedGif(path) + local bytes = { + 0x47, 0x49, 0x46, 0x38, 0x39, 0x61, -- "GIF89a" + 0x01, 0x00, 0x01, 0x00, 0x80, 0x00, 0x00, -- 1x1, global colour table of 2 + 0x00, 0x00, 0x00, 0xFF, 0xFF, 0xFF, -- black, white + 0x21, 0xFF, 0x0B, -- application extension + 0x4E, 0x45, 0x54, 0x53, 0x43, 0x41, 0x50, 0x45, -- "NETSCAPE" + 0x32, 0x2E, 0x30, -- "2.0" + 0x03, 0x01, 0x00, 0x00, 0x00, -- loop forever + 0x21, 0xF9, 0x04, 0x00, 0x0A, 0x00, 0x00, 0x00, -- frame 1 control block + 0x2C, 0x00, 0x00, 0x00, 0x00, 0x01, 0x00, 0x01, 0x00, 0x00, + 0x02, 0x02, 0x44, 0x01, 0x00, -- frame 1: the black pixel + 0x21, 0xF9, 0x04, 0x00, 0x0A, 0x00, 0x00, 0x00, -- frame 2 control block + 0x2C, 0x00, 0x00, 0x00, 0x00, 0x01, 0x00, 0x01, 0x00, 0x00, + 0x02, 0x02, 0x4C, 0x01, 0x00, -- frame 2: the white pixel + 0x3B, -- trailer + } + local characters = {} + for index, byte in ipairs(bytes) do + characters[index] = string.char(byte) + end + local file = assert(io.open(path, "wb"), "could not write the GIF fixture") + file:write(table.concat(characters)) + file:close() + end + + setup(function() + writeAnimatedGif(gifPath) + end) + + teardown(function() + os.remove(gifPath) + end) + + before_each(function() + created = {} + container = track(Geyser.Container:new({name = "glnHost", x = 0, y = 0, width = 600, height = 400})) + end) + + after_each(function() + -- doNestShow/doNestLeave arm a timer that closes the nest seconds later, + -- long after the labels it closes have been deleted + if Geyser.Label.closeAllTimer then + killTimer(Geyser.Label.closeAllTimer) + Geyser.Label.closeAllTimer = nil + end + for _, object in ipairs(created) do + -- the scroll tables are keyed by the label object and outlive it + Geyser.Label.scrollV[object] = nil + Geyser.Label.scrollH[object] = nil + if alive(object) then + object:delete() + end + end + created = {} + end) + + describe("Geyser.Label movie wrappers", function() + local label + + before_each(function() + label = track(Geyser.Label:new({name = "glnMovie", x = 0, y = 0, width = 60, height = 40}, container)) + end) + + it("setMovie puts the GIF on the label", function() + assert.is_true(label:setMovie(gifPath)) + end) + + it("setMovie reports a file that is not a movie", function() + local ok, message = label:setMovie(getMudletHomeDir() .. "/nosuchmovie.gif") + assert.is_nil(ok) + assert.is_string(message) + assert.is_truthy(message:find("no valid movie", 1, true)) + end) + + it("startMovie and pauseMovie drive the movie that was set", function() + label:setMovie(gifPath) + assert.is_true(label:startMovie()) + assert.is_true(label:pauseMovie()) + assert.is_true(label:startMovie()) + end) + + it("the movie functions all refuse a label with no movie on it", function() + local bare = track(Geyser.Label:new({name = "glnNoMovie", x = 0, y = 0, width = 60, height = 40}, container)) + for _, call in ipairs({ + function() return bare:startMovie() end, + function() return bare:pauseMovie() end, + function() return bare:setMovieSpeed(200) end, + function() return bare:setMovieFrame(0) end, + function() return bare:scaleMovie() end, + }) do + local ok, message = call() + assert.is_nil(ok) + assert.is_truthy(message:find("no movie found at label 'glnNoMovie'", 1, true)) + end + end) + + it("setMovieSpeed takes a percentage and refuses anything else", function() + label:setMovie(gifPath) + assert.is_true(label:setMovieSpeed(200)) + assert.is_true(label:setMovieSpeed(50)) + assert.has_error(function() label:setMovieSpeed("double") end) + end) + + it("setMovieFrame reports whether the frame could be reached", function() + label:setMovie(gifPath) + assert.is_true(label:setMovieFrame(0)) + -- the fixture has two frames, so this one is out of reach + assert.is_false(label:setMovieFrame(99)) + assert.has_error(function() label:setMovieFrame("first") end) + end) + + -- whether the movie is actually being kept at the label's size is not + -- readable from Lua: the connection scaleMovie(true) makes lives on the + -- widget and there is no getter for the movie's scaled size + pending("the movie following the label's size needs a getter for the scaled size") + + it("scaleMovie turns scaling on unless it is explicitly told false", function() + -- the argument is what carries the meaning and the return value is true + -- either way, so watch what the wrapper passes on + local scaling = spy.on(_G, "scaleMovie") + finally(function() scaling:revert() end) + label:setMovie(gifPath) + + assert.is_true(label:scaleMovie(false)) + assert.spy(scaling).was.called_with("glnMovie", false) + + assert.is_true(label:scaleMovie(true)) + assert.spy(scaling).was.called_with("glnMovie", true) + end) + + it("scaleMovie treats anything that is not false as a yes", function() + local scaling = spy.on(_G, "scaleMovie") + finally(function() scaling:revert() end) + label:setMovie(gifPath) + + -- no argument at all, and a nil one, both mean scale + assert.is_true(label:scaleMovie()) + assert.is_true(label:scaleMovie(nil)) + -- so does something that is not a boolean, rather than raising + assert.is_true(label:scaleMovie("nonsense")) + assert.spy(scaling).was.called(3) + assert.spy(scaling).was_not.called_with("glnMovie", false) + end) + end) + + describe("Geyser.Label callback registration", function() + local label + + before_each(function() + label = track(Geyser.Label:new({name = "glnCallback", x = 0, y = 0, width = 60, height = 40}, container)) + end) + + -- firing needs a real mouse over a real widget, which the suite has no way + -- of producing; what is checked here is that the registration reached the + -- widget and that Geyser remembers it + pending("the label callbacks firing on a real mouse event needs GUI automation") + + it("remembers the function and the arguments it registered", function() + local handler = function() end + label:setClickCallback(handler, "first", 2) + assert.are.equal(handler, label.clickCallback) + assert.are.same({"first", 2}, label.clickArgs) + end) + + it("passes the label name, the function and the arguments straight through", function() + -- no getter for a registered callback, so spy on the global; spy.on + -- leaves the real registration in place + local registration = spy.on(_G, "setLabelClickCallback") + finally(function() registration:revert() end) + local handler = function() end + label:setClickCallback(handler, "first", 2) + assert.spy(registration).was.called_with("glnCallback", handler, "first", 2) + end) + + it("registers each kind of callback through its own global", function() + local handler = function() end + local globals = { + setClickCallback = "setLabelClickCallback", + setDoubleClickCallback = "setLabelDoubleClickCallback", + setReleaseCallback = "setLabelReleaseCallback", + setMoveCallback = "setLabelMoveCallback", + setWheelCallback = "setLabelWheelCallback", + setOnEnter = "setLabelOnEnter", + setOnLeave = "setLabelOnLeave", + } + -- reverting inside the loop would be skipped by a failing assertion, and + -- a spy left on a Mudlet global is picked up as the "real" function by + -- the next spy.on in any later spec file + local spied = {} + finally(function() + for _, global in ipairs(spied) do + _G[global]:revert() + end + end) + + for method, global in pairs(globals) do + local registration = spy.on(_G, global) + spied[#spied + 1] = global + label[method](label, handler, "arg") + assert.spy(registration).was.called_with("glnCallback", handler, "arg") + end + end) + + it("deregisters when it is handed nil instead of a function", function() + label:setClickCallback(function() end, "first") + label:setClickCallback(nil) + assert.is_nil(label.clickCallback) + assert.are.same({}, label.clickArgs) + end) + + -- setDoubleClickCallback is missing from the readback below on purpose: it + -- stores self.doubleclickCallback/doubleclickArgs while the constructor and + -- every other setter use the doubleClickCallback/doubleClickArgs spelling, + -- so there is nothing here worth freezing until that is settled + it("remembers what the other callbacks registered too", function() + local handler = function() end + label:setReleaseCallback(handler, "r") + label:setMoveCallback(handler, "m") + label:setWheelCallback(handler, "w") + label:setOnEnter(handler, "e") + label:setOnLeave(handler, "l") + assert.are.same({"r"}, label.releaseArgs) + assert.are.same({"m"}, label.moveArgs) + assert.are.same({"w"}, label.wheelArgs) + assert.are.same({"e"}, label.onEnterArgs) + assert.are.same({"l"}, label.onLeaveArgs) + assert.are.equal(handler, label.releaseCallback) + assert.are.equal(handler, label.moveCallback) + assert.are.equal(handler, label.wheelCallback) + assert.are.equal(handler, label.onEnter) + assert.are.equal(handler, label.onLeave) + end) + + it("hard-errors on a callback that is neither a function nor nil", function() + assert.has_error(function() label:setClickCallback(42) end) + assert.has_error(function() label:setWheelCallback({}) end) + end) + + it("registers the callbacks the constructor was given", function() + local built = track(Geyser.Label:new({ + name = "glnConsCallback", x = 0, y = 0, width = 60, height = 40, + clickCallback = "echo", clickArgs = {"hello"}, + onEnter = "echo", onEnterArgs = "hello", + }, container)) + assert.are.equal("echo", built.clickCallback) + assert.are.same({"hello"}, built.clickArgs) + assert.are.equal("echo", built.onEnter) + assert.are.same({"hello"}, built.onEnterArgs) + end) + end) + + describe("Geyser.Label:addChild", function() + local parent + + before_each(function() + parent = track(Geyser.Label:new({name = "glnParent", x = 100, y = 100, width = 50, height = 20}, container)) + end) + + it("hands back a hidden nested label that knows its parent", function() + local child = track(parent:addChild({name = "glnChild", width = 50, height = 20}, container)) + assert.are.equal("nestedLabel", child.type) + assert.are.equal(parent, child.nestParent) + assert.is_true(child.hidden) + assert.is_false(windowVisible("glnChild")) + assert.are.same({child}, parent.nestedLabels) + end) + + it("defaults to flying out to the left, laid out vertically", function() + local child = track(parent:addChild({name = "glnChildDefault", width = 50, height = 20}, container)) + assert.are.equal("L", child.flyDir) + assert.are.equal("V", child.layoutDir) + end) + + it("splits layoutDir into a fly direction and a layout axis", function() + local child = track(parent:addChild({name = "glnChildRH", width = 50, height = 20, layoutDir = "RH"}, container)) + assert.are.equal("R", child.flyDir) + assert.are.equal("H", child.layoutDir) + end) + + it("wires the child up so that hovering it opens its own nest", function() + local child = track(parent:addChild({name = "glnChildHover", width = 50, height = 20}, container)) + assert.are.equal("doNestEnter", child.onEnter) + assert.are.equal("doNestLeave", child.onLeave) + end) + + it("keeps the children in the order they were added", function() + local first = track(parent:addChild({name = "glnChildOne", width = 50, height = 20}, container)) + local second = track(parent:addChild({name = "glnChildTwo", width = 50, height = 20}, container)) + assert.are.same({first, second}, parent.nestedLabels) + end) + + it("puts a child with an index where the index says", function() + local first = track(parent:addChild({name = "glnIndexOne", width = 50, height = 20}, container)) + local jumped = track(parent:addChild({name = "glnIndexTwo", width = 50, height = 20, index = 1}, container)) + assert.are.same({jumped, first}, parent.nestedLabels) + end) + + it("nests a child under a child", function() + local child = track(parent:addChild({name = "glnGrandParent", width = 50, height = 20}, container)) + local grandChild = track(child:addChild({name = "glnGrandChild", width = 50, height = 20}, container)) + assert.are.equal(child, grandChild.nestParent) + assert.are.same({grandChild}, child.nestedLabels) + end) + + it("gives a nestable label the click callback that opens its nest", function() + local nestable = track(Geyser.Label:new({name = "glnNestable", x = 0, y = 0, width = 50, height = 20, nestable = true}, container)) + assert.are.equal("doNestShow", nestable.clickCallback) + end) + + it("gives a nestflyout label the hover callback that opens its nest", function() + local flyout = track(Geyser.Label:new({name = "glnFlyout", x = 0, y = 0, width = 50, height = 20, nestflyout = true}, container)) + assert.are.equal("doNestShow", flyout.onEnter) + end) + end) + + describe("Geyser.Label nest display and closing", function() + local parent, child + + before_each(function() + parent = track(Geyser.Label:new({name = "glnNestParent", x = 100, y = 100, width = 50, height = 20}, container)) + child = track(parent:addChild({name = "glnNestChild", width = 50, height = 20, layoutDir = "RV"}, container)) + end) + + it("displayNest shows the children and lays them out beside the parent", function() + parent:displayNest() + assert.is_true(windowVisible("glnNestChild")) + -- flyDir R puts the child past the parent's right edge, at its own top + assert.are.same({x = 150, y = 100, width = 50, height = 20}, geometry("glnNestChild")) + end) + + it("displayNest stacks a second child below the first", function() + local second = track(parent:addChild({name = "glnNestChildTwo", width = 50, height = 20, layoutDir = "RV"}, container)) + parent:displayNest() + assert.is_true(windowVisible("glnNestChildTwo")) + assert.are.equal(100, geometry("glnNestChild").y) + assert.are.equal(120, geometry(second.name).y) + end) + + it("displayNest lays a horizontal nest out sideways instead", function() + -- two children, because one H child lands on the same pixel as one V + -- child would: only the second one shows which axis the nest grew along + local first = track(parent:addChild({name = "glnNestSideways", width = 50, height = 20, layoutDir = "RH"}, container)) + local second = track(parent:addChild({name = "glnNestSidewaysTwo", width = 50, height = 20, layoutDir = "RH"}, container)) + parent:displayNest() + + assert.is_true(windowVisible(first.name)) + assert.is_true(windowVisible(second.name)) + assert.are.same({x = 150, y = 100}, {x = geometry(first.name).x, y = geometry(first.name).y}) + -- along x, where the vertical nest would have gone along y + assert.are.same({x = 200, y = 100}, {x = geometry(second.name).x, y = geometry(second.name).y}) + end) + + it("closeNestChildren hides the children again", function() + parent:displayNest() + closeNestChildren(parent) + assert.is_false(windowVisible("glnNestChild")) + end) + + it("closeNestChildren reaches grandchildren too", function() + local grandChild = track(child:addChild({name = "glnNestGrandChild", width = 50, height = 20}, container)) + parent:displayNest() + child:displayNest() + assert.is_true(windowVisible(grandChild.name)) + + closeNestChildren(parent) + assert.is_false(windowVisible("glnNestChild")) + assert.is_false(windowVisible(grandChild.name)) + end) + + it("closeNestChildren does nothing for a label with no nest", function() + local lonely = track(Geyser.Label:new({name = "glnLonely", x = 0, y = 0, width = 50, height = 20}, container)) + assert.has_no.errors(function() closeNestChildren(lonely) end) + assert.is_true(windowVisible("glnLonely")) + end) + + it("closeAllLevels hides every nested label in the container", function() + local other = track(Geyser.Label:new({name = "glnOtherParent", x = 300, y = 100, width = 50, height = 20}, container)) + local otherChild = track(other:addChild({name = "glnOtherChild", width = 50, height = 20}, container)) + parent:displayNest() + other:displayNest() + + closeAllLevels(parent) + + assert.is_false(windowVisible("glnNestChild")) + assert.is_false(windowVisible(otherChild.name)) + -- the parents themselves have no nestParent, so they stay put + assert.is_true(windowVisible("glnNestParent")) + assert.is_true(windowVisible(other.name)) + end) + + it("closeNeighbourChildren closes the nests either side of a child", function() + local sibling = track(parent:addChild({name = "glnSibling", width = 50, height = 20}, container)) + local siblingChild = track(sibling:addChild({name = "glnSiblingChild", width = 50, height = 20}, container)) + parent:displayNest() + sibling:displayNest() + assert.is_true(windowVisible(siblingChild.name)) + + closeNeighbourChildren(child) + + assert.is_false(windowVisible(siblingChild.name)) + end) + + it("doNestShow opens a closed nest and arms the timer that closes it", function() + assert.is_false(windowVisible("glnNestChild")) + doNestShow(parent) + assert.is_true(windowVisible("glnNestChild")) + assert.is_number(Geyser.Label.closeAllTimer) + assert.is_number(remainingTime(Geyser.Label.closeAllTimer)) + end) + + it("doNestShow closes a nest that is already open", function() + -- it is the click handler of a nestable label, so clicking twice has to + -- put the nest away again: it always closes everything first and only + -- reopens when the first child was hidden + doNestShow(parent) + assert.is_true(windowVisible("glnNestChild")) + doNestShow(parent) + assert.is_false(windowVisible("glnNestChild")) + end) + + it("doNestShow replaces the timer rather than stacking a second one", function() + doNestShow(parent) + local firstTimer = Geyser.Label.closeAllTimer + doNestShow(parent) + assert.are_not.equal(firstTimer, Geyser.Label.closeAllTimer) + assert.is_nil(remainingTime(firstTimer)) + end) + + it("doNestEnter opens the nest of a child that flies out", function() + local grandChild = track(child:addChild({name = "glnEnterGrandChild", width = 50, height = 20}, container)) + child.flyOut = true + doNestEnter(child) + assert.is_true(windowVisible(grandChild.name)) + end) + + it("doNestEnter leaves the nest of a child that does not fly out closed", function() + local grandChild = track(child:addChild({name = "glnNoFlyGrandChild", width = 50, height = 20}, container)) + child.flyOut = nil + doNestEnter(child) + assert.is_false(windowVisible(grandChild.name)) + end) + + it("doNestEnter cancels the timer that would have closed everything", function() + doNestShow(parent) + local armed = Geyser.Label.closeAllTimer + doNestEnter(child) + assert.is_nil(remainingTime(armed)) + end) + + it("doNestEnter ignores being handed nothing", function() + assert.has_no.errors(function() doNestEnter(nil) end) + end) + + it("doNestLeave arms the timer that closes everything", function() + doNestLeave(child) + assert.is_number(Geyser.Label.closeAllTimer) + assert.is_number(remainingTime(Geyser.Label.closeAllTimer)) + end) + end) + + describe("Geyser.Label:addScrollbars and doNestScroll", function() + local parent, first, second + + before_each(function() + parent = track(Geyser.Label:new({name = "glnScrollParent", x = 100, y = 100, width = 50, height = 20}, container)) + first = track(parent:addChild({name = "glnScrollOne", width = 50, height = 20, layoutDir = "RV"}, container)) + second = track(parent:addChild({name = "glnScrollTwo", width = 50, height = 20, layoutDir = "RV"}, container)) + end) + + local function makeScrollbars() + local bars = Geyser.Label:addScrollbars(parent, "RV") + track(bars[1]) + track(bars[2]) + Geyser.Label.scrollV[parent] = bars + finally(function() Geyser.Label.scrollV[parent] = nil end) + return bars[1], bars[2] + end + + it("makes a backward and a forward label named after the nest", function() + local backward, forward = makeScrollbars() + assert.are.equal("backScrollglnScrollOneRV", backward.name) + assert.are.equal("forScrollglnScrollOneRV", forward.name) + assert.are.equal(parent, backward.nestParent) + assert.are.equal(parent, forward.nestParent) + assert.are.equal("More...", forward.message) + end) + + it("sizes the forward scrollbar's reach to the nest it scrolls", function() + local _, forward = makeScrollbars() + -- two children in the nest, plus the scroll window's own end marker + assert.are.equal(3, forward.maxScroll) + end) + + it("wires both scrollbars up to doNestScroll", function() + local backward, forward = makeScrollbars() + assert.are.equal("doNestScroll", backward.clickCallback) + assert.are.equal("doNestScroll", forward.clickCallback) + assert.are.equal("doNestEnter", forward.onEnter) + assert.are.equal("doNestLeave", forward.onLeave) + end) + + it("doNestScroll moves the window forward when the forward bar is clicked", function() + local backward, forward = makeScrollbars() + backward.scroll, forward.scroll, forward.maxScroll = 0, 3, 5 + + doNestScroll(forward) + + assert.are.equal(1, backward.scroll) + assert.are.equal(4, forward.scroll) + end) + + it("doNestScroll moves the window back when the backward bar is clicked", function() + local backward, forward = makeScrollbars() + backward.scroll, forward.scroll, forward.maxScroll = 1, 4, 5 + + doNestScroll(backward) + + assert.are.equal(0, backward.scroll) + assert.are.equal(3, forward.scroll) + end) + + it("doNestScroll will not scroll back past the first entry", function() + local backward, forward = makeScrollbars() + backward.scroll, forward.scroll, forward.maxScroll = 0, 3, 5 + + doNestScroll(backward) + + assert.are.equal(0, backward.scroll) + assert.are.equal(3, forward.scroll, "the window has to keep its size when it hits the top") + end) + + it("doNestScroll will not scroll on past the last entry", function() + local backward, forward = makeScrollbars() + backward.scroll, forward.scroll, forward.maxScroll = 2, 5, 5 + + doNestScroll(forward) + + assert.are.equal(2, backward.scroll) + assert.are.equal(5, forward.scroll) + end) + end) +end) diff --git a/src/mudlet-lua/tests/GeyserMiniConsole_spec.lua b/src/mudlet-lua/tests/GeyserMiniConsole_spec.lua index 8e9d81d12..de7c92037 100644 --- a/src/mudlet-lua/tests/GeyserMiniConsole_spec.lua +++ b/src/mudlet-lua/tests/GeyserMiniConsole_spec.lua @@ -277,6 +277,72 @@ describe("Tests functionality of Geyser.MiniConsole", function() console:enableCommandLine() assert.are.equal("still here", console:getCmdLine()) end) + + -- An action only runs when the user presses return in the command line, + -- which nothing in Lua can make happen, so what is pinned here is the + -- registration: which function and arguments reached the widget, and what + -- the console remembers about them + pending("a command line action running on a real return keypress needs GUI automation") + + it("setCmdAction registers the function with the console's command line", function() + local action = spy.on(_G, "setCmdLineAction") + finally(function() action:revert() end) + local handler = function() end + + console:setCmdAction(handler, "first", 2) + + assert.spy(action).was.called_with("gmcCmd", handler, "first", 2) + assert.are.equal(handler, console.actionFunc) + assert.are.same({"first", 2}, console.actionArgs) + end) + + it("setCmdAction replaces the action rather than adding a second one", function() + local action = spy.on(_G, "setCmdLineAction") + finally(function() action:revert() end) + local first = function() end + local second = function() end + + console:setCmdAction(first, "one") + console:setCmdAction(second) + + -- the widget holds one action, so the second registration has to reach it + -- and the console has to forget the first one's arguments + assert.spy(action).was.called(2) + assert.spy(action).was.called_with("gmcCmd", second) + assert.are.equal(second, console.actionFunc) + assert.are.same({}, console.actionArgs) + end) + + it("setCmdAction takes the name of a function as a string too", function() + -- setCmdLineAction is wrapped in Lua, and that wrapper compiles a string + -- into a call of the function it names + assert.has_no.errors(function() console:setCmdAction("echo") end) + assert.are.equal("echo", console.actionFunc) + end) + + it("setCmdAction hard-errors on anything it cannot call", function() + assert.has_error(function() console:setCmdAction({}) end) + -- unlike the label callbacks, a command line action cannot be cleared by + -- registering nil: resetCmdAction is the way to put it back + assert.has_error(function() console:setCmdAction(nil) end) + end) + + it("resetCmdAction puts the command line back to sending to the game", function() + local reset = spy.on(_G, "resetCmdLineAction") + finally(function() reset:revert() end) + console:setCmdAction(function() end, "first") + + console:resetCmdAction() + + assert.spy(reset).was.called_with("gmcCmd") + assert.is_nil(console.actionFunc) + assert.is_nil(console.actionArgs) + end) + + it("resetCmdAction is safe on a command line that never had an action", function() + assert.has_no.errors(function() console:resetCmdAction() end) + assert.is_nil(console.actionFunc) + end) end) describe("Geyser.MiniConsole:setBufferSize", function() diff --git a/src/mudlet-lua/tests/GeyserUserWindow_spec.lua b/src/mudlet-lua/tests/GeyserUserWindow_spec.lua index 7bf1b8241..b941c1a7d 100644 --- a/src/mudlet-lua/tests/GeyserUserWindow_spec.lua +++ b/src/mudlet-lua/tests/GeyserUserWindow_spec.lua @@ -489,3 +489,96 @@ describe("Tests functionality of Geyser.UserWindow", function() end) end) end) + +-- set_uwconstr is what move() and resize() call before they touch the dock: it +-- re-reads the window's own x/y/width/height against the main window rather +-- than against the user window's insides, which is what every other Geyser +-- object's set_constraints does. resetWindow() puts the usual behaviour back, +-- so the two are specced against each other here. +describe("Tests Geyser.UserWindow:set_uwconstr", function() + local created + + local function track(object) + created[#created + 1] = object + return object + end + + local function alive(object) + if not object or not object.container or not object.container.windowList then + return false + end + return object.container.windowList[object.name] == object + end + + before_each(function() + created = {} + end) + + after_each(function() + for _, object in ipairs(created) do + if alive(object) then + object:delete() + end + end + created = {} + end) + + it("resolves percentages against the main window", function() + local userWindow = track(Geyser.UserWindow:new({name = "guwConstr", x = 10, y = 20, width = 200, height = 150})) + local mainWidth, mainHeight = getMainWindowSize() + + userWindow.x, userWindow.y = "50%", "25%" + userWindow.width, userWindow.height = "20%", "10%" + userWindow:set_uwconstr() + + assert.are.equal(mainWidth * 0.5, userWindow:get_x()) + assert.are.equal(mainHeight * 0.25, userWindow:get_y()) + assert.are.equal(mainWidth * 0.2, userWindow:get_width()) + assert.are.equal(mainHeight * 0.1, userWindow:get_height()) + end) + + it("resolves pixels as pixels", function() + local userWindow = track(Geyser.UserWindow:new({name = "guwConstrPixels", x = 10, y = 20, width = 200, height = 150})) + + userWindow.x, userWindow.y = 120, 130 + userWindow.width, userWindow.height = 240, 260 + userWindow:set_uwconstr() + + assert.are.equal(120, userWindow:get_x()) + assert.are.equal(130, userWindow:get_y()) + assert.are.equal(240, userWindow:get_width()) + assert.are.equal(260, userWindow:get_height()) + end) + + it("is undone by resetWindow, which sizes the window against itself again", function() + local userWindow = track(Geyser.UserWindow:new({name = "guwConstrReset", x = 10, y = 20, width = 200, height = 150})) + local mainWidth = getMainWindowSize() + + userWindow.width = "100%" + userWindow:set_uwconstr() + assert.are.equal(mainWidth, userWindow:get_width()) + + userWindow:resetWindow() + -- back to filling itself: "100%" now means the usable area inside the dock, + -- which is nothing like the main window's width + local usableWidth = getUserWindowSize("guwConstrReset") + assert.are.equal(usableWidth, userWindow:get_width()) + assert.is_true(usableWidth < mainWidth) + end) + + it("is what move and resize position the dock with", function() + local userWindow = track(Geyser.UserWindow:new({name = "guwConstrMove", x = 10, y = 20, width = 200, height = 150})) + + -- move()/resize() hand their arguments to set_uwconstr and then move the + -- real dock to what it worked out, so a percentage has to land on the same + -- pixel that set_uwconstr resolves it to + userWindow.x, userWindow.y = "10%", "10%" + userWindow:set_uwconstr() + local expectedX, expectedY = userWindow:get_x(), userWindow:get_y() + + userWindow:move("10%", "10%") + local x, y = getWindowGeometry("guwConstrMove") + assert.are.equal(math.floor(expectedX), x) + assert.are.equal(math.floor(expectedY), y) + end) +end) diff --git a/src/mudlet-lua/tests/IDManager_spec.lua b/src/mudlet-lua/tests/IDManager_spec.lua index 89ac8d6bc..85f117ed7 100644 --- a/src/mudlet-lua/tests/IDManager_spec.lua +++ b/src/mudlet-lua/tests/IDManager_spec.lua @@ -738,5 +738,253 @@ describe("Tests the functionality of IDMgr", function() assert.are.same({"re"}, mgr:getTriggers()) end) end) + + -- The event store is reached through the shared per-user managers elsewhere + -- in this file. Here it is driven directly, so that the answers a private + -- manager gives are pinned even for a package that keeps its own. + describe("Tests the functionality of IDMgr:getEvents", function() + local eventName = "privateMgrEventListEvent" + + it("Should return an empty list for a fresh manager", function() + assert.are.same({}, mgr:getEvents()) + end) + + it("Should list every registered handler name, sorted", function() + mgr:registerEvent("charlie", eventName, function() end) + mgr:registerEvent("alpha", eventName, function() end) + mgr:registerEvent("bravo", eventName, function() end) + assert.are.same({"alpha", "bravo", "charlie"}, mgr:getEvents()) + end) + + it("Should keep listing a handler that was stopped but not deleted", function() + mgr:registerEvent("stopped", eventName, function() end) + mgr:stopEvent("stopped") + assert.are.same({"stopped"}, mgr:getEvents()) + end) + + it("Should not report timers or triggers as event handlers", function() + mgr:registerTimer("timer", 100, function() end) + mgr:registerTrigger("trigger", "private_mgr_events_not_triggers", function() end) + assert.are.same({}, mgr:getEvents()) + end) + end) + + describe("Tests the functionality of IDMgr:stopEvent and IDMgr:resumeEvent", function() + local eventName = "privateMgrStopResumeEvent" + local fired + + before_each(function() + fired = 0 + mgr:registerEvent("handler", eventName, function() fired = fired + 1 end) + end) + + it("Should stop the handler firing while leaving it registered", function() + raiseEvent(eventName) + assert.are.equal(1, fired) + + assert.is_true(mgr:stopEvent("handler")) + raiseEvent(eventName) + assert.are.equal(1, fired) + assert.are.equal(-1, mgr.events["handler"].handlerID) + assert.are.same({"handler"}, mgr:getEvents()) + end) + + it("Should return false for a name it does not know", function() + assert.is_false(mgr:stopEvent("no such handler")) + end) + + it("Should let a stopped handler fire again once resumed", function() + mgr:stopEvent("handler") + assert.is_true(mgr:resumeEvent("handler")) + assert.are_not.equal(-1, mgr.events["handler"].handlerID) + raiseEvent(eventName) + assert.are.equal(1, fired) + end) + + it("Should leave a resumed handler registered exactly once", function() + -- resume goes through register, which stops the old registration first; + -- if it did not, the handler would run twice for one event + mgr:resumeEvent("handler") + raiseEvent(eventName) + assert.are.equal(1, fired) + assert.are.same({"handler"}, mgr:getEvents()) + end) + + it("Should return false when resuming a name it does not know", function() + assert.is_false(mgr:resumeEvent("no such handler")) + end) + end) + + describe("Tests the functionality of IDMgr:deleteEvent", function() + local eventName = "privateMgrDeleteEvent" + + it("Should stop the handler firing and forget its name", function() + local fired = 0 + mgr:registerEvent("handler", eventName, function() fired = fired + 1 end) + + assert.is_true(mgr:deleteEvent("handler")) + + raiseEvent(eventName) + assert.are.equal(0, fired) + assert.are.same({}, mgr:getEvents()) + assert.is_nil(mgr.events["handler"]) + end) + + it("Should leave a deleted handler beyond resuming", function() + mgr:registerEvent("handler", eventName, function() end) + mgr:deleteEvent("handler") + assert.is_false(mgr:resumeEvent("handler")) + end) + + it("Should return false for a name it does not know", function() + assert.is_false(mgr:deleteEvent("no such handler")) + end) + end) + + describe("Tests the functionality of IDMgr:stopAllEvents", function() + local eventName = "privateMgrStopAllEvent" + + it("Should stop every handler while leaving them all registered", function() + local fired = 0 + mgr:registerEvent("one", eventName, function() fired = fired + 1 end) + mgr:registerEvent("two", eventName, function() fired = fired + 1 end) + raiseEvent(eventName) + assert.are.equal(2, fired) + + assert.is_true(mgr:stopAllEvents()) + + raiseEvent(eventName) + assert.are.equal(2, fired) + assert.are.equal(-1, mgr.events["one"].handlerID) + assert.are.equal(-1, mgr.events["two"].handlerID) + assert.are.same({"one", "two"}, mgr:getEvents()) + end) + + it("Should leave the stopped handlers resumable one at a time", function() + local fired = 0 + mgr:registerEvent("one", eventName, function() fired = fired + 1 end) + mgr:registerEvent("two", eventName, function() fired = fired + 1 end) + mgr:stopAllEvents() + + mgr:resumeEvent("one") + raiseEvent(eventName) + assert.are.equal(1, fired) + end) + + it("Should not raise for a manager with no handlers", function() + assert.is_true(mgr:stopAllEvents()) + end) + + it("Should leave timers alone", function() + mgr:registerTimer("timer", 100, function() end) + mgr:stopAllEvents() + assert.is_number(mgr:remainingTime("timer")) + end) + end) + + -- stopAll and deleteAll are the store-agnostic bodies behind the seven + -- stopAll*/deleteAll* wrappers, so they are driven by store name here + describe("Tests the functionality of IDMgr:stopAll and IDMgr:deleteAll", function() + local eventName = "privateMgrStoreLoopEvent" + + it("Should stop everything in the store it is named", function() + mgr:registerEvent("event", eventName, function() end) + mgr:registerTimer("timer", 100, function() end) + + assert.is_true(mgr:stopAll("events")) + + assert.are.equal(-1, mgr.events["event"].handlerID) + -- the timer store was not named, so it is untouched + assert.is_number(mgr:remainingTime("timer")) + end) + + it("Should stop the timer store when that is the one named", function() + local handlerID + mgr:registerTimer("timer", 100, function() end) + handlerID = mgr.timers["timer"].handlerID + + assert.is_true(mgr:stopAll("timers")) + + assert.are.equal(-1, mgr.timers["timer"].handlerID) + -- the bookkeeping alone would say inactive, so check the real tempTimer + assert.is_nil(remainingTime(handlerID)) + end) + + it("Should not raise on an empty store", function() + assert.is_true(mgr:stopAll("events")) + assert.is_true(mgr:stopAll("regexTriggers")) + end) + + it("Should empty the store it is named and stop what was in it", function() + local fired = 0 + mgr:registerEvent("event", eventName, function() fired = fired + 1 end) + mgr:registerTimer("timer", 100, function() end) + + assert.is_true(mgr:deleteAll("events")) + + raiseEvent(eventName) + assert.are.equal(0, fired) + assert.are.same({}, mgr:getEvents()) + assert.are.same({"timer"}, mgr:getTimers()) + end) + + it("Should not raise on an empty store for deleteAll either", function() + assert.is_true(mgr:deleteAll("events")) + assert.is_true(mgr:deleteAll("timers")) + end) + end) + + describe("Tests the functionality of IDMgr:resumeTimer and IDMgr:deleteTimer", function() + it("Should give a stopped timer a running tempTimer again", function() + mgr:registerTimer("timer", 100, function() end) + mgr:stopTimer("timer") + assert.is_nil((mgr:remainingTime("timer"))) + + assert.is_true(mgr:resumeTimer("timer")) + + assert.are_not.equal(-1, mgr.timers["timer"].handlerID) + assert.is_number(mgr:remainingTime("timer")) + end) + + it("Should restart a timer that was still running rather than add a second one", function() + mgr:registerTimer("timer", 5000, function() end) + local firstID = mgr.timers["timer"].handlerID + + assert.is_true(mgr:resumeTimer("timer")) + + assert.are_not.equal(firstID, mgr.timers["timer"].handlerID) + assert.is_nil(remainingTime(firstID), "resuming has to kill the tempTimer it replaces") + assert.are.same({"timer"}, mgr:getTimers()) + end) + + it("Should return false when resuming a name it does not know", function() + assert.is_false(mgr:resumeTimer("no such timer")) + end) + + it("Should kill the underlying tempTimer and forget the name", function() + mgr:registerTimer("timer", 100, function() end) + local handlerID = mgr.timers["timer"].handlerID + + assert.is_true(mgr:deleteTimer("timer")) + + assert.is_nil(remainingTime(handlerID)) + assert.are.same({}, mgr:getTimers()) + local remaining, err = mgr:remainingTime("timer") + assert.is_nil(remaining) + assert.are.equal("timer not found", err) + end) + + it("Should leave the other timers alone", function() + mgr:registerTimer("keep", 100, function() end) + mgr:registerTimer("drop", 100, function() end) + mgr:deleteTimer("drop") + assert.are.same({"keep"}, mgr:getTimers()) + assert.is_number(mgr:remainingTime("keep")) + end) + + it("Should return false for a name it does not know", function() + assert.is_false(mgr:deleteTimer("no such timer")) + end) + end) end) end) diff --git a/src/mudlet-lua/tests/Mapper_spec.lua b/src/mudlet-lua/tests/Mapper_spec.lua index 7ead97749..7659fd453 100644 --- a/src/mudlet-lua/tests/Mapper_spec.lua +++ b/src/mudlet-lua/tests/Mapper_spec.lua @@ -1929,3 +1929,320 @@ describe("Tests deleteMap", function() assert.is_nil(next(getRooms())) end) end) + +-- saveMap/loadMap replace the whole map, so this block runs last, after +-- deleteMap has already emptied it, and puts back whatever it found: the map is +-- shared with everything that runs after this file. +describe("Tests saveMap and loadMap", function() + local specDirectory = debug.getinfo(1, "S").source:match("^@(.*)[/\\]") + assert(specDirectory, "Mapper_spec.lua has to be run from a file so that it can find its fixtures") + local fixtureMap = specDirectory .. "/fixtures/maps/minimal-map.xml" + + -- Scratch names inside the self-test profile that nothing else writes. A run + -- that died between the setup below and its teardown leaves them behind, and + -- the backup one would then be a map from a different run, so they are + -- cleared on the way in rather than trusted. + local mapDirectory = getMudletHomeDir() .. "/map" + local backupPath = mapDirectory .. "/mapper_spec_backup.dat" + local savePath = mapDirectory .. "/mapper_spec_roundtrip.dat" + local brokenXmlPath = getMudletHomeDir() .. "/mapper_spec_broken.xml" + + -- saveMap() with no arguments writes a timestamped file of its own choosing, + -- so the only way to clear up after it is to spot what appeared + local function mapFiles() + local files = {} + for entry in lfs.dir(mapDirectory) do + if entry:lower():match("%.dat$") then + files[entry] = true + end + end + return files + end + + local function removeNewMapFiles(before) + for entry in pairs(mapFiles()) do + if not before[entry] then + os.remove(mapDirectory .. "/" .. entry) + end + end + end + + -- three rooms in one area, carrying a value for every kind of room data the + -- binary format stores separately, so a round-trip that dropped one shows up + local roomA, roomB, roomC + local function buildMap() + deleteMap() + local area = addAreaName("MapperSpecSaveArea") + roomA, roomB, roomC = createRoomID(), nil, nil + addRoom(roomA) + roomB = createRoomID(); addRoom(roomB) + roomC = createRoomID(); addRoom(roomC) + for _, id in ipairs({roomA, roomB, roomC}) do + setRoomArea(id, area) + end + setRoomCoordinates(roomA, 0, 0, 0) + setRoomCoordinates(roomB, 3, -4, 5) + setRoomCoordinates(roomC, 1, 1, 1) + setRoomName(roomA, "Saved Room A") + setRoomName(roomB, "Saved Room B") + setRoomEnv(roomB, 42) + setRoomWeight(roomB, 7) + setExit(roomA, roomB, "east") + setExit(roomB, roomA, "west") + addSpecialExit(roomB, roomC, "squeeze through") + setDoor(roomA, "e", 2) + setRoomUserData(roomA, "spec key", "spec value") + setRoomIDbyHash(roomA, "mapperSpecSavedHash") + -- the room symbol is stored as a number below format version 19 and as a + -- string from 19 up, and the custom environment colours are their own + -- section, so both are here for the versioned round-trip below + setRoomChar(roomB, "X") + setCustomEnvColor(42, 10, 20, 30, 255) + return area + end + + local function assertMapRestored() + assert.is_true(roomExists(roomA)) + assert.is_true(roomExists(roomB)) + assert.are.equal("Saved Room A", getRoomName(roomA)) + assert.are.equal("Saved Room B", getRoomName(roomB)) + assert.are.same({3, -4, 5}, {getRoomCoordinates(roomB)}) + assert.are.equal(42, getRoomEnv(roomB)) + assert.are.equal(7, getRoomWeight(roomB)) + assert.are.equal(roomB, getRoomExits(roomA)["east"]) + assert.are.equal(roomC, getSpecialExitsSwap(roomB)["squeeze through"]) + assert.are.equal(2, getDoors(roomA)["e"]) + assert.are.equal("spec value", getRoomUserData(roomA, "spec key")) + assert.are.equal(roomA, getRoomIDbyHash("mapperSpecSavedHash")) + assert.are.equal("MapperSpecSaveArea", getRoomAreaName(getRoomArea(roomA))) + assert.are.equal("X", getRoomChar(roomB)) + assert.are.same({10, 20, 30, 255}, getCustomEnvColorTable()[42]) + end + + setup(function() + os.remove(backupPath) + os.remove(savePath) + os.remove(brokenXmlPath) + -- snapshot whatever map the rest of the suite left behind, so that the + -- teardown can hand it back untouched + assert.is_true(saveMap(backupPath), "the map to be replaced could not be saved first") + end) + + teardown(function() + assert.is_true(loadMap(backupPath), "the map this block replaced could not be put back") + -- loadMap shows the mapper wherever it last was; the block above this one + -- guarantees an open, right-docked widget to everything that follows, so + -- put that back rather than leaving it wherever the loads left it + openMapWidget("r") + os.remove(backupPath) + os.remove(savePath) + os.remove(brokenXmlPath) + end) + + describe("Tests the saveMap argument contract", function() + it("hard-errors on a save location that is not a string", function() + -- a table rather than a number: Lua coerces a number to a string, and + -- saveMap takes it, writing a map file named after the number + assert.has_error(function() saveMap({}) end) + end) + + it("hard-errors on a format version that is not a number", function() + assert.has_error(function() saveMap(savePath, "twenty") end) + end) + + it("reports failure rather than raising when the file cannot be written", function() + -- false means the save failed: saveMap answers with success, not with an + -- error flag, which is worth pinning because it reads the other way round + assert.is_false(saveMap("/nosuchdirectory/mapper_spec.dat")) + end) + + it("refuses a format version this Mudlet cannot write", function() + finally(function() + -- a refused save leaves the map flagged as unsaved, which puts a + -- warning on the mapper for every spec that runs after this one + saveMap(savePath) + os.remove(savePath) + end) + assert.is_false(saveMap(savePath, 9999)) + end) + end) + + -- Careful with the order of anything added here: a load that fails still + -- empties the map first, both for a missing binary file (TMainConsole::loadMap + -- clears before it restores) and for an XML one (TMap::readXmlMapFile clears + -- before it parses), so none of these leave a map behind for the next spec. + describe("Tests the loadMap argument contract", function() + it("hard-errors on a path that is not a string", function() + assert.has_error(function() loadMap({}) end) + end) + + it("returns false for a binary map file that is not there", function() + assert.is_false(loadMap(mapDirectory .. "/nosuchmapfile.dat")) + end) + + it("returns nil and a message naming the missing XML file", function() + local ok, message = loadMap(mapDirectory .. "/nosuchmapfile.xml") + assert.is_nil(ok) + assert.is_string(message) + assert.is_truthy(message:find("was not found", 1, true)) + assert.is_truthy(message:find("nosuchmapfile.xml", 1, true)) + end) + + it("returns nil and a message for an XML file it cannot parse", function() + local file = assert(io.open(brokenXmlPath, "w")) + file:write("<map><areas><area id=\"1\" name=\"unterminated\">") + file:close() + + local ok, message = loadMap(brokenXmlPath) + assert.is_nil(ok) + assert.is_string(message) + assert.is_truthy(message:find("failure to import XML map file", 1, true)) + end) + end) + + describe("Tests the saveMap and loadMap round-trip", function() + it("puts every kind of room data back exactly as it was saved", function() + buildMap() + assert.is_true(saveMap(savePath)) + + -- wipe the lot, so that a loadMap which did nothing at all cannot pass + deleteMap() + assert.is_false(roomExists(roomA)) + + assert.is_true(loadMap(savePath)) + assertMapRestored() + end) + + it("replaces what is on the map rather than merging into it", function() + buildMap() + saveMap(savePath) + + local strayArea = addAreaName("MapperSpecStrayArea") + local stray = createRoomID() + addRoom(stray) + setRoomArea(stray, strayArea) + + assert.is_true(loadMap(savePath)) + assert.is_false(roomExists(stray)) + assert.is_nil(getAreaTable()["MapperSpecStrayArea"]) + assertMapRestored() + end) + + it("round-trips through the oldest format version Mudlet still writes", function() + buildMap() + assert.is_true(saveMap(savePath, 17)) + deleteMap() + + assert.is_true(loadMap(savePath)) + -- everything, including the room symbol, which version 17 writes as a + -- number where 19 and up write a string: the older spelling has to come + -- back as the same character + assertMapRestored() + end) + + it("saves into the profile's own map folder when given no path", function() + local before = mapFiles() + finally(function() removeNewMapFiles(before) end) + + buildMap() + assert.is_true(saveMap()) + + local added = 0 + for entry in pairs(mapFiles()) do + if not before[entry] then + added = added + 1 + end + end + -- the name it picks is a timestamp to the second, so a second save + -- inside the same second would land on the same file rather than a new + -- one; what matters is that it wrote into the profile at all + assert.is_true(added >= 1, "saveMap() with no path should write a map file of its own") + end) + + it("restores the profile's most recent map when given no path", function() + local before = mapFiles() + finally(function() removeNewMapFiles(before) end) + + buildMap() + -- the other map files in this folder also hold a buildMap() map, so mark + -- this one: loadMap() picks the newest file and has to pick this one + setRoomName(roomC, "Only In The Newest Save") + assert.is_true(saveMap()) + deleteMap() + + assert.is_true(loadMap()) + assertMapRestored() + assert.are.equal("Only In The Newest Save", getRoomName(roomC)) + end) + end) + + describe("Tests loadMap importing an XML map", function() + -- the fixture's own IDs, so that a load which quietly did nothing cannot + -- be mistaken for a successful import + local importedRoomA, importedRoomB = 4001, 4002 + + before_each(function() + deleteMap() + assert.is_true(loadMap(fixtureMap)) + end) + + it("creates the rooms the file describes", function() + assert.is_true(roomExists(importedRoomA)) + assert.is_true(roomExists(importedRoomB)) + assert.are.equal("Import Room One", getRoomName(importedRoomA)) + assert.are.equal("Import Room Two", getRoomName(importedRoomB)) + end) + + it("puts the rooms in the area the file names", function() + assert.are.equal(4001, getAreaTable()["Mapper Spec Import Area"]) + assert.are.equal(4001, getRoomArea(importedRoomA)) + assert.are.equal(4001, getRoomArea(importedRoomB)) + end) + + it("reads the coordinates and the environment of each room", function() + assert.are.same({0, 0, 0}, {getRoomCoordinates(importedRoomA)}) + assert.are.same({1, 2, 3}, {getRoomCoordinates(importedRoomB)}) + assert.are.equal(169, getRoomEnv(importedRoomA)) + assert.are.equal(170, getRoomEnv(importedRoomB)) + end) + + it("reads normal exits, doors and IRE-style special exits", function() + assert.are.equal(importedRoomB, getRoomExits(importedRoomA)["east"]) + assert.are.equal(importedRoomA, getRoomExits(importedRoomB)["west"]) + assert.are.equal(2, getDoors(importedRoomB)["w"]) + -- an exit with no direction but a command is how IRE maps spell a + -- special exit, and it has to arrive as one + assert.are.equal(importedRoomB, getSpecialExitsSwap(importedRoomA)["enter gate"]) + end) + + it("turns a hidden exit into a locked door", function() + -- IRE maps mark an exit the player cannot see with hidden="1" rather than + -- with a door type, and it arrives as door type 3, a locked door + assert.are.equal(importedRoomA, getRoomExits(importedRoomB)["north"]) + assert.are.equal(3, getDoors(importedRoomB)["n"]) + end) + + it("turns a room feature into room user data", function() + assert.are.equal("true", getRoomUserData(importedRoomA, "feature-shop")) + end) + + -- the file's <environments> block fills TMap::mEnvColors, which maps an + -- environment id to a stock colour index. getCustomEnvColorTable() reads + -- mCustomEnvColors, a different map, so there is nothing to read this back + -- with from Lua + pending("the environment colours an XML map declares have no Lua getter") + + it("throws away the map that was there before the import", function() + local stray = createRoomID() + addRoom(stray) + assert.is_true(loadMap(fixtureMap)) + assert.is_false(roomExists(stray)) + end) + end) + + -- setMapPerspective/shiftMapPerspective only exist in a build made with 3D + -- mapper support, which the CI and release builds are not + pending("setMapPerspective needs a Mudlet built with the 3D mapper") + + pending("shiftMapPerspective needs a Mudlet built with the 3D mapper") +end) diff --git a/src/mudlet-lua/tests/TableUtils_spec.lua b/src/mudlet-lua/tests/TableUtils_spec.lua index 0e871d866..46f0b4483 100644 --- a/src/mudlet-lua/tests/TableUtils_spec.lua +++ b/src/mudlet-lua/tests/TableUtils_spec.lua @@ -534,6 +534,63 @@ describe("Tests TableUtils.lua functions", function() end) + -- table.contains is a loop over table._contains, one pass per value it was + -- asked about. Everything the search itself does lives in _contains, and it + -- is the only one of the two that reports being handed something that is not + -- a table: table.contains treats that report as "not found". + describe("Tests the functionality of table._contains", function() + + it("should return true for a value in the table", function() + assert.is_true(table._contains({"one", "two"}, "two")) + end) + + it("should return true for a key in the table", function() + assert.is_true(table._contains({one = 1, two = 2}, "two")) + end) + + it("should find a value nested inside another table", function() + assert.is_true(table._contains({outer = {inner = {"needle"}}}, "needle")) + assert.is_true(table._contains({outer = {inner = {"needle"}}}, "inner")) + end) + + it("should return false for something the table does not hold", function() + assert.is_false(table._contains({one = 1}, "two")) + end) + + it("should return false for an empty table", function() + assert.is_false(table._contains({}, "anything")) + end) + + it("should report being handed something that is not a table", function() + local found, message = table._contains("not a table", "anything") + assert.is_nil(found) + assert.are.equal("first parameter passed isn't a table", message) + + found, message = table._contains(nil, "anything") + assert.is_nil(found) + assert.are.equal("first parameter passed isn't a table", message) + end) + + it("should let table.contains turn that report into a plain false", function() + -- the caller of table.contains never sees the message, so a script that + -- wants to know it passed a table has to ask _contains + assert.is_false(table.contains("not a table", "anything")) + end) + + it("should search for exactly one value, unlike table.contains", function() + -- table.contains loops over its extra arguments, _contains ignores them + assert.is_false(table._contains({"one"}, "two", "one")) + assert.is_true(table.contains({"one"}, "two", "one")) + end) + + it("should find a false value stored in the table", function() + -- returning the search result rather than the value found is what makes + -- a stored false distinguishable from "not there" + assert.is_true(table._contains({flag = false}, false)) + assert.is_false(table._contains({flag = true}, false)) + end) + end) + describe("Tests the functionality of table.index_of", function() it("should return the index of the item being searched", function() local tbl = { diff --git a/src/mudlet-lua/tests/fixtures/maps/minimal-map.xml b/src/mudlet-lua/tests/fixtures/maps/minimal-map.xml new file mode 100644 index 000000000..3d88301bc --- /dev/null +++ b/src/mudlet-lua/tests/fixtures/maps/minimal-map.xml @@ -0,0 +1,30 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- Smallest map that reaches the Lua-observable parts of XMLimport::readMap(): + an area, two rooms with coordinates and a bidirectional exit, a special + exit in the IRE spelling (an exit with no direction but a command), a door, + a hidden exit (which arrives as a locked door), a room feature (which + arrives as room user data) and an environment colour. Used by Mapper_spec's + loadMap(".xml") specs. --> +<map> + <areas> + <area id="4001" name="Mapper Spec Import Area"/> + </areas> + <rooms> + <room id="4001" area="4001" title="Import Room One" environment="169"> + <coord x="0" y="0" z="0"/> + <exit direction="east" target="4002"/> + <exit special="1" command="enter gate" target="4002"/> + <features> + <feature type="shop"/> + </features> + </room> + <room id="4002" area="4001" title="Import Room Two" environment="170"> + <coord x="1" y="2" z="3"/> + <exit direction="west" target="4001" door="2"/> + <exit direction="north" target="4001" hidden="1"/> + </room> + </rooms> + <environments> + <environment id="169" color="8"/> + </environments> +</map> From 3c64303e65bfe834af1dab250dd1674ef74d3742 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Tue, 11 Aug 2026 08:08:27 +0200 Subject: [PATCH 148/155] Infrastructure: busted specs for the last uncovered UI functions (#9775) #### Brief overview of PR changes/additions - 134 new busted specs in `UI_spec.lua` for 24 UI functions that had no coverage anywhere: label movies, console buffer sizing, main window size, saved window layout, the application/profile style sheets, toolbar buttons, command line actions, `setPopup` and `createLabel` into a user window. - Effects are read back for real, not just return values: movies through `getProfileStats().gifs`, buffer limits through observed line trimming, `setAppStyleSheet` through the `sysAppStyleSheetChange` it raises, toolbars through `isActive()`, and the user window label by hiding its parent. No binary fixture is committed - the movie specs assemble a three-frame GIF89a at run time. - The button specs install a tiny action package for the block, because Lua cannot make a push-down button and cannot remove a `tempButton` again; everything created is taken away in teardown, including the two layout files that live outside the profile. #### Motivation for adding to Mudlet Last of the busted-reachable UI rows in the Lua API test-coverage program. Nine functions turned out to have no reachable readback at all and are marked `pending()` with the reason rather than given a spec that cannot fail. #### Other info (issues closed, discussion etc) Bugs found while writing these, all left unspecced and marked `pending()` instead: - `Host::setMovie` hands the `QMovie` to the gif tracker before reading the file, so a refused `setMovie` still counts one in `getProfileStats()`, and over a working movie it leaves the label driving a dead one. - `createLabel` puts the label in the main window and answers `true` when the parent window name is not a window. - `showToolBar`/`hideToolBar` only answer to a package's name, never a packaged toolbar's own name, and move every toolbar in the package at once; an unmatched name is a silent no-op. - `setPopup` takes a `luaL_ref` per function command before its size check and window lookup, so both error paths strand registry references. - `clearCmdLineSuggestions` gates on `n == 1` where `addCmdLineSuggestion` gates on `n > 1`, so a second argument silently retargets the main command line. - `setConsoleBufferSize` never floors the batch deletion size, so `0` stops the buffer shrinking at all. Pre-existing and untouched here: on a reused profile the suite's second run fails `getMainWindowSize returns a positive width and height` - it reproduces identically on development. **Test case:** full busted suite green on a fresh profile (2534 successes, 141 pending, +2.7s in `UI_spec`), and twice on one reused profile with the same single pre-existing failure development has; 35 of the 134 new specs (26%) verified to fail when the underlying C++ is locally broken, and the new `MUDLET_TEST_REQUIRE_WINDOW_RESIZE` gate proven to fail rather than skip when a resize stops working. Assisted-by: Claude:claude-opus-5 --- .github/workflows/build-mudlet-pr.yml | 5 + src/mudlet-lua/tests/UI_spec.lua | 1262 +++++++++++++++++++++++++ 2 files changed, 1267 insertions(+) diff --git a/.github/workflows/build-mudlet-pr.yml b/.github/workflows/build-mudlet-pr.yml index b8eaad714..ec9b077ab 100644 --- a/.github/workflows/build-mudlet-pr.yml +++ b/.github/workflows/build-mudlet-pr.yml @@ -599,6 +599,11 @@ jobs: # environment quirk. macOS runners start no player at all, so the gate # stays off there. MUDLET_TEST_REQUIRE_MEDIA: 1 + # Xvfb has no window manager to overrule a resize request, so the main + # window here follows setMainWindowSize exactly and one that stops + # following it is a regression rather than an environment quirk. The + # macOS runners are not gated: their window server can refuse a resize. + MUDLET_TEST_REQUIRE_WINDOW_RESIZE: 1 # The fake Discord IPC server's socket lives in this runtime directory, # and the bundled discord-rpc library is only reachable through this # library path - without both the Discord specs have nothing to talk to. diff --git a/src/mudlet-lua/tests/UI_spec.lua b/src/mudlet-lua/tests/UI_spec.lua index 1ac1d7879..a217b9b5c 100644 --- a/src/mudlet-lua/tests/UI_spec.lua +++ b/src/mudlet-lua/tests/UI_spec.lua @@ -4722,3 +4722,1265 @@ describe("Command line argument handling", function() end) end) end) + +-- The movie API needs a real animated GIF to work on. Rather than commit a +-- binary fixture, one is assembled here: three frames so setMovieFrame() has +-- somewhere to jump to, and a 60 second frame delay so the animation never +-- advances on its own while a spec is reading the movie back. +local function threeFrameGif() + -- 1x1 logical screen, global colour table of four entries + local logicalScreen = "GIF89a" .. string.char(1, 0, 1, 0, 0x91, 0, 0) + local globalColourTable = string.char(255, 0, 0, 0, 255, 0, 0, 0, 255, 0, 0, 0) + -- graphic control extension: 0x1770 hundredths of a second per frame + local graphicControl = string.char(0x21, 0xF9, 0x04, 0x00, 0x70, 0x17, 0x00, 0x00) + local imageDescriptor = string.char(0x2C, 0, 0, 0, 0, 1, 0, 1, 0, 0) + -- LZW, minimum code size 2: a clear code, one pixel, end of information + local imageData = string.char(0x02, 0x02, 0x4C, 0x01, 0x00) + local frame = graphicControl .. imageDescriptor .. imageData + return logicalScreen .. globalColourTable .. frame:rep(3) .. string.char(0x3B) +end + +-- The fixtures below are generated at run time rather than committed, and they +-- go in the profile directory the way DB_spec's and Package_spec's do: it is +-- writable on every platform, where /tmp does not exist on Windows at all. +-- Every one of them is removed again in teardown. +local function specFilePath(name) + return ("%s/%s"):format(getMudletHomeDir(), name) +end + +-- binary mode: the GIF must not be newline-translated +local function writeSpecFile(path, contents) + local handle = io.open(path, "wb") + assert.is_not_nil(handle, "could not open " .. path .. " for writing") + assert.is_not_nil(handle:write(contents), "could not write " .. path) + handle:close() +end + +describe("Label movies", function() + local suffix = ("-%d-%d"):format(os.time(), math.random(100000)) + local giffile = specFilePath(("mudlet-spec-movie%s.gif"):format(suffix)) + local notAGifFile = specFilePath(("mudlet-spec-notamovie%s.gif"):format(suffix)) + local missingFile = specFilePath(("mudlet-spec-there-is-no-such%s.gif"):format(suffix)) + + -- every movie function takes a label name first and rejects the same three + -- ways, so the shared cases are driven over the whole family + -- an array rather than a keyed table so the specs are always generated in + -- the same order + local movieFunctions = { + {"setMovie", function(labelName) return setMovie(labelName, giffile) end}, + {"startMovie", startMovie}, + {"pauseMovie", pauseMovie}, + {"scaleMovie", scaleMovie}, + {"setMovieSpeed", function(labelName) return setMovieSpeed(labelName, 100) end}, + {"setMovieFrame", function(labelName) return setMovieFrame(labelName, 0) end}, + } + -- setMovie reports a missing label itself, the rest go through the shared + -- label lookup, so the two say it differently + local ownsItsLabelLookup = {setMovie = true} + + local function gifStats() + local gifs = getProfileStats().gifs + return gifs.total, gifs.active + end + + setup(function() + writeSpecFile(giffile, threeFrameGif()) + writeSpecFile(notAGifFile, "this is not a GIF at all") + end) + + teardown(function() + os.remove(giffile) + os.remove(notAGifFile) + end) + + describe("setMovie", function() + local label = "movieSetLabel" .. suffix + + before_each(function() + createLabel(label, 10, 10, 60, 30, 1) + end) + + after_each(function() + deleteLabel(label) + end) + + it("returns true and registers the gif with the profile", function() + local totalBefore, activeBefore = gifStats() + assert.is_true(setMovie(label, giffile)) + local totalAfter, activeAfter = gifStats() + assert.are.equal(totalBefore + 1, totalAfter) + -- setMovie starts the movie as well as loading it + assert.are.equal(activeBefore + 1, activeAfter) + end) + + it("reuses the same movie when called twice on one label", function() + assert.is_true(setMovie(label, giffile)) + local totalAfterFirst = gifStats() + assert.is_true(setMovie(label, giffile)) + local totalAfterSecond = gifStats() + assert.are.equal(totalAfterFirst, totalAfterSecond) + end) + + it("deleting the label unregisters its gif again", function() + local totalBefore = gifStats() + assert.is_true(setMovie(label, giffile)) + assert.are.equal(totalBefore + 1, gifStats()) + assert.is_true(deleteLabel(label)) + assert.are.equal(totalBefore, gifStats()) + end) + + it("returns nil and a message for a file that is not a movie", function() + local ok, err = setMovie(label, notAGifFile) + assert.is_nil(ok) + assert.are.equal(("no valid movie found at '%s'"):format(notAGifFile), err) + end) + + it("returns nil and a message for a file that is not there", function() + local ok, err = setMovie(label, missingFile) + assert.is_nil(ok) + assert.are.equal(("no valid movie found at '%s'"):format(missingFile), err) + end) + + it("a refused movie leaves no gif registered", function() + pending("the QMovie is made and handed to the gif tracker before the file is read, so a refused setMovie still leaves one counted in getProfileStats()") + end) + + it("a refused movie over a working one leaves the label driving the dead movie", function() + pending("Host::setMovie calls setFileName on the label's live QMovie before it finds out the new file is not a movie, so the label keeps a movie the call said it would not have") + end) + + it("a refused movie leaves the label without a movie to drive", function() + assert.is_nil(setMovie(label, notAGifFile)) + local ok, err = startMovie(label) + assert.is_nil(ok) + assert.are.equal(("no movie found at label '%s'"):format(label), err) + end) + + it("hard-errors when the movie path is missing", function() + local ok, err = pcall(setMovie, label) + assert.is_false(ok) + assert.is_truthy(tostring(err):find("setMovie: bad argument #2 type", 1, true)) + end) + + it("hard-errors on a non-string movie path", function() + local ok, err = pcall(setMovie, label, {}) + assert.is_false(ok) + assert.is_truthy(tostring(err):find("setMovie: bad argument #2 type", 1, true)) + end) + end) + + describe("start, pause and the other movie functions", function() + local label = "movieRunLabel" .. suffix + local labelWithoutMovie = "movieBareLabel" .. suffix + + setup(function() + createLabel(labelWithoutMovie, 10, 50, 60, 30, 1) + end) + + teardown(function() + deleteLabel(labelWithoutMovie) + end) + + before_each(function() + createLabel(label, 10, 10, 60, 30, 1) + assert.is_true(setMovie(label, giffile)) + end) + + after_each(function() + deleteLabel(label) + end) + + it("pauseMovie stops the gif counting as active", function() + local _, activeWhileRunning = gifStats() + assert.is_true(pauseMovie(label)) + local _, activeWhilePaused = gifStats() + assert.are.equal(activeWhileRunning - 1, activeWhilePaused) + end) + + it("startMovie makes a paused gif count as active again", function() + assert.is_true(pauseMovie(label)) + local _, activeWhilePaused = gifStats() + assert.is_true(startMovie(label)) + local _, activeAfterStart = gifStats() + assert.are.equal(activeWhilePaused + 1, activeAfterStart) + end) + + it("startMovie on an already running movie leaves it active", function() + local _, activeWhileRunning = gifStats() + assert.is_true(startMovie(label)) + local _, activeAfterStart = gifStats() + assert.are.equal(activeWhileRunning, activeAfterStart) + end) + + it("setMovieSpeed returns true and does not stop the movie", function() + local _, activeBefore = gifStats() + assert.is_true(setMovieSpeed(label, 50)) + local _, activeAfter = gifStats() + assert.are.equal(activeBefore, activeAfter) + assert.is_true(setMovieSpeed(label, 100)) + end) + + it("setMovieSpeed hard-errors on a non-number speed", function() + local ok, err = pcall(setMovieSpeed, label, "fast") + assert.is_false(ok) + assert.is_truthy(tostring(err):find("setMovieSpeed: bad argument #2 type", 1, true)) + end) + + it("setMovieFrame answers whether the frame could be jumped to", function() + assert.is_true(setMovieFrame(label, 1)) + -- the fixture only has three frames + assert.is_false(setMovieFrame(label, 99)) + assert.is_false(setMovieFrame(label, -1)) + end) + + it("setMovieFrame hard-errors on a non-number frame", function() + local ok, err = pcall(setMovieFrame, label, "second") + assert.is_false(ok) + assert.is_truthy(tostring(err):find("setMovieFrame: bad argument #2 type", 1, true)) + end) + + -- the scaling itself is not readable from Lua: all these can check is that + -- turning it on and off is accepted and leaves the movie alone + it("scaleMovie returns true with, without and against its optional argument", function() + assert.is_true(scaleMovie(label)) + assert.is_true(scaleMovie(label, true)) + assert.is_true(scaleMovie(label, false)) + -- turning scaling off and on again must leave the movie usable + assert.is_true(scaleMovie(label, true)) + assert.is_true(startMovie(label)) + end) + + it("scaleMovie hard-errors on a non-boolean second argument", function() + local ok, err = pcall(scaleMovie, label, "yes") + assert.is_false(ok) + assert.is_truthy(tostring(err):find("scaleMovie: bad argument #2 type", 1, true)) + end) + + for _, movieFunction in ipairs(movieFunctions) do + local functionName, call = movieFunction[1], movieFunction[2] + + it(functionName .. " hard-errors on a label name that is no string", function() + local ok, err = pcall(call, {}) + assert.is_false(ok) + assert.is_truthy(tostring(err):find(functionName .. ": bad argument #1 type", 1, true)) + end) + + it(functionName .. " returns nil and a message for an empty label name", function() + local ok, err = call("") + assert.is_nil(ok) + assert.are.equal("label name cannot be an empty string", err) + end) + + it(functionName .. " returns nil and a message naming an unknown label", function() + local unknown = "movieNoSuchLabel" .. suffix + local ok, err = call(unknown) + assert.is_nil(ok) + if ownsItsLabelLookup[functionName] then + assert.are.equal(("label '%s' does not exist"):format(unknown), err) + else + assert.are.equal(('label "%s" not found'):format(unknown), err) + end + end) + end + + for _, movieFunction in ipairs(movieFunctions) do + local functionName, call = movieFunction[1], movieFunction[2] + if functionName ~= "setMovie" then + it(functionName .. " returns nil and a message for a label with no movie", function() + local ok, err = call(labelWithoutMovie) + assert.is_nil(ok) + assert.are.equal(("no movie found at label '%s'"):format(labelWithoutMovie), err) + end) + end + end + end) +end) + +describe("Console buffer size", function() + local suffix = ("-%d-%d"):format(os.time(), math.random(100000)) + local console = "bufferSizeConsole" .. suffix + local mainLinesLimit, mainBatchSize + + setup(function() + createMiniConsole(console, 0, 0, 400, 200) + mainLinesLimit, mainBatchSize = getConsoleBufferSize() + end) + + teardown(function() + deleteMiniConsole(console) + setConsoleBufferSize(mainLinesLimit, mainBatchSize) + end) + + it("getConsoleBufferSize reports two numbers for the main console", function() + local linesLimit, batchSize = getConsoleBufferSize() + assert.are.equal("number", type(linesLimit)) + assert.are.equal("number", type(batchSize)) + assert.is_true(linesLimit >= 100) + assert.is_true(batchSize > 0) + end) + + it("setConsoleBufferSize round-trips through getConsoleBufferSize", function() + assert.is_true(setConsoleBufferSize(console, 5000, 500)) + assert.are.same({5000, 500}, {getConsoleBufferSize(console)}) + assert.is_true(setConsoleBufferSize(console, 1000, 100)) + assert.are.same({1000, 100}, {getConsoleBufferSize(console)}) + end) + + it("setConsoleBufferSize round-trips on the main console too", function() + assert.is_true(setConsoleBufferSize(2500, 250)) + assert.are.same({2500, 250}, {getConsoleBufferSize()}) + assert.is_true(setConsoleBufferSize(mainLinesLimit, mainBatchSize)) + assert.are.same({mainLinesLimit, mainBatchSize}, {getConsoleBufferSize()}) + end) + + it("a lines limit under the hundred line floor is raised to it", function() + assert.is_true(setConsoleBufferSize(console, 10, 5)) + local linesLimit = getConsoleBufferSize(console) + assert.are.equal(100, linesLimit) + end) + + it("a batch deletion size that is not smaller than the limit is cut to a tenth", function() + assert.is_true(setConsoleBufferSize(console, 1000, 1000)) + assert.are.same({1000, 100}, {getConsoleBufferSize(console)}) + end) + + it("the buffer actually stops growing past the limit that was set", function() + clearWindow(console) + assert.is_true(setConsoleBufferSize(console, 100, 10)) + for lineNumber = 1, 400 do + echo(console, ("buffer line %d\n"):format(lineNumber)) + end + local lineCount = getLineCount(console) + -- the buffer is trimmed a batch at a time once it is over the limit, so it + -- settles within one batch of the limit rather than exactly on it + assert.is_true(lineCount <= 110, "line count was " .. lineCount) + assert.is_true(lineCount >= 90, "line count was " .. lineCount) + end) + + it("a bigger limit lets the same buffer hold more", function() + clearWindow(console) + assert.is_true(setConsoleBufferSize(console, 300, 10)) + for lineNumber = 1, 400 do + echo(console, ("buffer line %d\n"):format(lineNumber)) + end + local lineCount = getLineCount(console) + assert.is_true(lineCount >= 290, "line count was " .. lineCount) + assert.is_true(lineCount <= 310, "line count was " .. lineCount) + end) + + it("useMaximum raises the main console to the buffer maximum", function() + -- the main console has to be named for this one: with three arguments the + -- first is read as a window name, so the four argument form only lines up + -- when it is actually given one. The lines limit is then discarded and the + -- machine's maximum used instead + local before = getConsoleBufferSize() + assert.is_true(setConsoleBufferSize("main", 1000, 100, true)) + local maximum = getConsoleBufferSize() + assert.is_true(maximum > 1000, "maximum was " .. maximum) + assert.is_true(setConsoleBufferSize(before, mainBatchSize)) + assert.are.equal(before, getConsoleBufferSize()) + end) + + it("the useMaximum flag needs the window to be named", function() + -- without a name the flag lands in the batch deletion size's place + local ok, err = pcall(setConsoleBufferSize, 1000, 100, true) + assert.is_false(ok) + assert.is_truthy(tostring(err):find("setConsoleBufferSize: bad argument #3 type", 1, true)) + end) + + it("useMaximum is refused for anything but the main console", function() + local ok, err = setConsoleBufferSize(console, 1000, 100, true) + assert.is_nil(ok) + assert.are.equal("useMaximum parameter is only supported for the main console", err) + end) + + it("setConsoleBufferSize hard-errors on a non-number lines limit", function() + local ok, err = pcall(setConsoleBufferSize, console, "lots", 100) + assert.is_false(ok) + assert.is_truthy(tostring(err):find("setConsoleBufferSize: bad argument #2 type", 1, true)) + end) + + it("setConsoleBufferSize hard-errors on a non-number batch deletion size", function() + local ok, err = pcall(setConsoleBufferSize, console, 1000, "some") + assert.is_false(ok) + assert.is_truthy(tostring(err):find("setConsoleBufferSize: bad argument #3 type", 1, true)) + end) + + it("both functions return nil and a message naming an unknown window", function() + local unknown = "bufferSizeNoSuchWindow" .. suffix + local getOk, getErr = getConsoleBufferSize(unknown) + assert.is_nil(getOk) + assert.are.equal(('window "%s" not found'):format(unknown), getErr) + local setOk, setErr = setConsoleBufferSize(unknown, 1000, 100) + assert.is_nil(setOk) + assert.are.equal(('window "%s" not found'):format(unknown), setErr) + end) +end) + +describe("Main window size and saved layout", function() + -- resizing is a window manager request, so the size that comes back is only + -- ever an approximation of what was asked for; these specs check that the + -- request lands and that the reported size follows it, not that it matches + local testMode = os.getenv("MUDLET_TEST_MODE") ~= nil + local originalWidth, originalHeight + -- whether the console reports a size to measure against at all, and whether + -- this display honours a resize request - without a window manager it need + -- not, and then there is nothing here to measure or to put back + local measurable = false + local resizable = false + -- on a platform where resizing is known to work, a resize that stops working + -- is a regression rather than an environment quirk, so the CI legs that can + -- resize set this and turn the skips below into failures + local resizeRequired = os.getenv("MUDLET_TEST_REQUIRE_WINDOW_RESIZE") ~= nil + + local function resizableWindowAvailable() + if not measurable then + -- a console that latches to a zero size is a defect of its own, and the + -- console metrics specs earlier in this file report it; the resize gate + -- is not about that, so it stays out of the way here + pending("the console reports no size to measure a resize against") + return false + end + if resizeRequired then + assert.is_true(resizable, + "MUDLET_TEST_REQUIRE_WINDOW_RESIZE is set, but this display did not honour a resize request") + return true + end + if not resizable then + pending("this display does not honour a resize request, so there is nothing to measure") + return false + end + return true + end + + -- setMainWindowSize sizes the whole application window while + -- getMainWindowSize reports the console area inside it, and the chrome + -- between the two (menu bar, profile tabs, toolbars, command line) is not + -- readable from Lua. So the size is put back by asking for the console size + -- that was wanted and correcting by however much came back short. + local function restoreMainWindowSize() + if not measurable then + return false + end + local requestedWidth, requestedHeight = originalWidth, originalHeight + for _ = 1, 4 do + setMainWindowSize(requestedWidth, requestedHeight) + pumpEvents(100) + local width, height = getMainWindowSize() + if width == originalWidth and height == originalHeight then + return true + end + requestedWidth = requestedWidth + (originalWidth - width) + requestedHeight = requestedHeight + (originalHeight - height) + end + return false + end + + setup(function() + originalWidth, originalHeight = getMainWindowSize() + measurable = testMode and originalWidth > 0 and originalHeight > 0 + if not measurable then + return + end + setMainWindowSize(originalWidth + 300, originalHeight + 300) + pumpEvents(200) + local width, height = getMainWindowSize() + resizable = width > originalWidth and height > originalHeight + restoreMainWindowSize() + end) + + teardown(restoreMainWindowSize) + + it("setMainWindowSize hard-errors on a non-number width", function() + local ok, err = pcall(setMainWindowSize, "wide", 600) + assert.is_false(ok) + assert.is_truthy(tostring(err):find("setMainWindowSize: bad argument #1 type", 1, true)) + end) + + it("setMainWindowSize hard-errors on a non-number height", function() + local ok, err = pcall(setMainWindowSize, 800, "tall") + assert.is_false(ok) + assert.is_truthy(tostring(err):find("setMainWindowSize: bad argument #2 type", 1, true)) + end) + + it("a bigger main window is reported as bigger", function() + if not resizableWindowAvailable() then + return + end + finally(restoreMainWindowSize) + local smallWidth, smallHeight = 700, 500 + -- and it answers nothing at all while it is at it + assert.are.equal(0, select("#", setMainWindowSize(smallWidth, smallHeight))) + pumpEvents(200) + local narrowWidth, shortHeight = getMainWindowSize() + + setMainWindowSize(smallWidth + 300, smallHeight + 300) + pumpEvents(200) + local wideWidth, tallHeight = getMainWindowSize() + + assert.is_true(wideWidth > narrowWidth, ("%d was not wider than %d"):format(wideWidth, narrowWidth)) + assert.is_true(tallHeight > shortHeight, ("%d was not taller than %d"):format(tallHeight, shortHeight)) + -- the console never claims more room than the window it sits in + assert.is_true(wideWidth <= smallWidth + 300) + assert.is_true(tallHeight <= smallHeight + 300) + end) + + it("the main window can be put back the size it was", function() + if not resizableWindowAvailable() then + return + end + setMainWindowSize(640, 480) + pumpEvents(200) + assert.is_true(restoreMainWindowSize(), "the window could not be put back") + assert.are.same({originalWidth, originalHeight}, {getMainWindowSize()}) + end) + + describe("saveWindowLayout and loadWindowLayout", function() + -- the layout lives beside the profiles directory rather than inside the + -- profile, so these specs write outside the profile and have to put both + -- files back the way they found them + local configurationDirectory = getMudletHomeDir():match("^(.*)/profiles/[^/]*$") + assert(configurationDirectory, "could not work out the configuration directory from " .. getMudletHomeDir()) + local layoutFiles = { + configurationDirectory .. "/windowLayout.dat", + configurationDirectory .. "/windowLayoutGeometry.dat", + } + local contentsBefore = {} + + setup(function() + for _, path in ipairs(layoutFiles) do + local handle = io.open(path, "rb") + if handle then + contentsBefore[path] = handle:read("*a") + handle:close() + end + end + end) + + -- after every spec rather than at the end of the block: these are the + -- shared files the next Mudlet start reads its layout from, so no more than + -- one spec's worth of writing to them is ever outstanding + after_each(function() + for _, path in ipairs(layoutFiles) do + if contentsBefore[path] then + writeSpecFile(path, contentsBefore[path]) + else + os.remove(path) + end + end + end) + + it("saveWindowLayout returns true and writes the layout file", function() + local layoutFile = layoutFiles[1] + -- taking the file away first is what makes this about the call rather + -- than about a file an earlier session left behind + os.remove(layoutFile) + assert.is_nil(lfs.attributes(layoutFile, "mode")) + assert.is_true(saveWindowLayout()) + assert.is_not_nil(lfs.attributes(layoutFile, "mode"), layoutFile .. " was not written") + assert.is_true(lfs.attributes(layoutFile, "size") > 0) + end) + + it("saving twice in a row keeps returning true", function() + -- the underlying save refuses a second time in a row, but the Lua + -- function clears that flag before every call + assert.is_true(saveWindowLayout()) + assert.is_true(saveWindowLayout()) + end) + + it("loadWindowLayout reads back a layout that was saved", function() + assert.is_true(saveWindowLayout()) + assert.is_true(loadWindowLayout()) + -- loading twice is not refused the way saving twice would be + assert.is_true(loadWindowLayout()) + end) + + it("verifying the restored dock geometry", function() + pending("dock widget geometry is not readable from Lua - needs a functional test") + end) + end) +end) + +describe("Application and profile style sheets", function() + local suffix = ("-%d-%d"):format(os.time(), math.random(100000)) + + teardown(function() + -- leave no styling behind for the rest of the suite + setAppStyleSheet("") + setProfileStyleSheet("") + end) + + -- sysAppStyleSheetChange is raised from inside setAppStyleSheet(), before a + -- waitForEvent() could be armed, so the handler has to be there first + local function collectStyleSheetEvents() + local events = {} + local handler = registerAnonymousEventHandler("sysAppStyleSheetChange", function(_, ...) + events[#events + 1] = {...} + end) + finally(function() killAnonymousEventHandler(handler) end) + return events + end + + describe("setAppStyleSheet", function() + it("returns true and raises sysAppStyleSheetChange with the tag and profile", function() + local events = collectStyleSheetEvents() + local tag = "appStyleTag" .. suffix + assert.is_true(setAppStyleSheet("QLabel { color: rgb(1,2,3); }", tag)) + assert.are.equal(1, #events) + assert.are.equal(tag, events[1][1]) + assert.are.equal(getProfileName(), events[1][2]) + end) + + it("raises the event with an empty tag when none is given", function() + local events = collectStyleSheetEvents() + assert.is_true(setAppStyleSheet("QLabel { color: rgb(4,5,6); }")) + assert.are.equal(1, #events) + assert.are.equal("", events[1][1]) + assert.are.equal(getProfileName(), events[1][2]) + end) + + it("accepts an empty style sheet and still announces the change", function() + local events = collectStyleSheetEvents() + assert.is_true(setAppStyleSheet("")) + assert.are.equal(1, #events) + end) + + it("hard-errors on a non-string style sheet", function() + local ok, err = pcall(setAppStyleSheet, {}) + assert.is_false(ok) + assert.is_truthy(tostring(err):find("setAppStyleSheet: bad argument #1 type", 1, true)) + end) + + it("hard-errors on a non-string tag", function() + local ok, err = pcall(setAppStyleSheet, "", {}) + assert.is_false(ok) + assert.is_truthy(tostring(err):find("setAppStyleSheet: bad argument #2 type", 1, true)) + end) + + it("a rejected call raises no event", function() + local events = collectStyleSheetEvents() + pcall(setAppStyleSheet, {}) + assert.are.equal(0, #events) + end) + end) + + describe("setProfileStyleSheet", function() + it("returns true for a style sheet and for an empty one", function() + assert.is_true(setProfileStyleSheet("QWidget { color: rgb(7,8,9); }")) + assert.is_true(setProfileStyleSheet("")) + end) + + it("raises no sysAppStyleSheetChange - it is per profile, not per application", function() + local events = collectStyleSheetEvents() + assert.is_true(setProfileStyleSheet("QWidget { color: rgb(9,8,7); }")) + assert.are.equal(0, #events) + setProfileStyleSheet("") + end) + + it("hard-errors on a non-string style sheet", function() + local ok, err = pcall(setProfileStyleSheet, {}) + assert.is_false(ok) + assert.is_truthy(tostring(err):find("setProfileStyleSheet: bad argument #1 type", 1, true)) + end) + + it("verifying what the profile style sheet actually paints", function() + pending("there is no getProfileStyleSheet, and the effect is only visible in a screenshot") + end) + end) +end) + +-- Lua can create a toolbar and buttons (tempButtonToolbar/tempButton) but not a +-- push-down one, and it cannot remove either again - so the buttons the button +-- specs need come from a package that is installed for the block and +-- uninstalled after it, which takes them away again with it. Installing starts +-- a profile save, and the uninstall is refused until that save has drained, +-- which only happens when the event loop runs. +if not os.getenv("MUDLET_TEST_MODE") then + +describe("Toolbar buttons", function() + it("needs test mode", function() + pending("the button specs install a package for a push-down button, which needs pumpEvents()") + end) +end) + +else + +describe("Toolbar buttons", function() + local suffix = ("-%d-%d"):format(os.time(), math.random(100000)) + local packageName = "mudlet-spec-buttons" .. suffix + local toolbar = "buttonSpecToolbar" .. suffix + local pushDownButton = "buttonSpecPushDown" .. suffix + local plainButton = "buttonSpecPlain" .. suffix + local packageFile = specFilePath(packageName .. ".xml") + + local function actionXml(name, pushButton, isFolder) + return ([[<Action isActive="yes" isFolder="%s" isPushButton="%s" isFlatButton="no" useCustomLayout="no"> + <name>%s</name> + <script></script> + <css></css> + <commandButtonUp></commandButtonUp> + <commandButtonDown></commandButtonDown> + <icon></icon> + <orientation>0</orientation> + <location>0</location> + <buttonRotation>0</buttonRotation> + <sizeX>0</sizeX> + <sizeY>0</sizeY> + <mButtonState>1</mButtonState> + <buttonColumn>1</buttonColumn> + <buttonFillerOffset>0</buttonFillerOffset> + <posX>0</posX> + <posY>0</posY> + ]]):format(isFolder, pushButton, name) + end + + local function packageXml() + return table.concat({ + [[<?xml version="1.0" encoding="UTF-8"?>]], + [[<!DOCTYPE MudletPackage>]], + [[<MudletPackage version="1.001">]], + [[<ActionPackage>]], + actionXml(toolbar, "no", "yes"), + actionXml(pushDownButton, "yes", "no"), "</Action>", + actionXml(plainButton, "no", "no"), "</Action>", + "</Action>", + [[</ActionPackage>]], + [[</MudletPackage>]], + }, "\n") + end + + local function waitUntil(condition, timeoutMilliseconds) + local waited = 0 + while waited < timeoutMilliseconds do + if condition() then + return true + end + pumpEvents(50) + waited = waited + 50 + end + return condition() and true or false + end + + local function packageIsInstalled() + for _, name in ipairs(getPackages()) do + if name == packageName then + return true + end + end + return false + end + + -- Installing and uninstalling each start a profile save, and Lua cannot ask + -- whether one is running - but installPackage() gives it away: while a save is + -- in flight it postpones whatever it was asked to do and answers true, even + -- for the empty path it would otherwise refuse outright. + local function waitForProfileSaveToPass() + return waitUntil(function() return installPackage("") == nil end, 5000) + end + + setup(function() + writeSpecFile(packageFile, packageXml()) + assert.is_true(waitForProfileSaveToPass(), "a profile save was already running, so this install would be postponed") + assert.is_true(installPackage(packageFile), "could not install " .. packageFile) + assert.is_true(waitUntil(packageIsInstalled, 5000), packageName .. " did not turn up in getPackages()") + end) + + teardown(function() + -- asking whether the package is here rather than whether setup thought it + -- arrived: installPackage() postpones itself behind a running profile save, + -- so it can still land after setup gave up waiting, and then nothing else + -- would ever take it out of the reused profile again + if packageIsInstalled() then + -- uninstalling is refused while the save the install started is still + -- draining, and that only finishes when the event loop runs + assert.is_true(waitUntil(function() return uninstallPackage(packageName) == true end, 5000), + packageName .. " could not be uninstalled") + assert.is_true(waitUntil(function() return not packageIsInstalled() end, 5000), + packageName .. " was still installed after being uninstalled") + end + -- The save uninstallPackage() asks for is queued, not started there and + -- then, so it has to be given the event loop before anything can see it + -- running - ask too early and the wait below passes while the save is still + -- only pending. It has to finish here rather than during Mudlet's shutdown, + -- which gives up waiting after a thousand iterations and tears down around + -- the writer that is still going (a segfault on the quicker runners). + pumpEvents(300) + assert.is_true(waitForProfileSaveToPass(), "the profile save the uninstall queued never finished") + pumpEvents(100) + assert.is_true(waitForProfileSaveToPass(), "another profile save was queued behind the first") + os.remove(packageFile) + end) + + describe("setButtonState and getButtonState", function() + after_each(function() + setButtonState(pushDownButton, false) + end) + + it("round-trips a button state by name", function() + assert.is_false(getButtonState(pushDownButton)) + assert.is_true(setButtonState(pushDownButton, true)) + assert.is_true(getButtonState(pushDownButton)) + assert.is_true(setButtonState(pushDownButton, false)) + assert.is_false(getButtonState(pushDownButton)) + end) + + it("setButtonState answers false when the state was already what was asked for", function() + assert.is_true(setButtonState(pushDownButton, true)) + assert.is_false(setButtonState(pushDownButton, true)) + -- and the state it reported no change to is still the one that was asked for + assert.is_true(getButtonState(pushDownButton)) + end) + + it("both refuse an item ID that is no button", function() + local getOk, getErr = getButtonState(999999) + assert.is_nil(getOk) + assert.are.equal("no button item with ID 999999 found", getErr) + local setOk, setErr = setButtonState(999999, true) + assert.is_nil(setOk) + assert.are.equal("no button item with ID 999999 found", setErr) + end) + + it("getButtonState with no arguments answers the console's own button state", function() + -- with no arguments this answers TConsole::mButtonState, which is 1 or 2 + -- rather than the boolean the named form answers, and which only a real + -- click on a push-down button writes - setButtonState never touches it + local before = getButtonState() + assert.is_true(before == 1 or before == 2, "state was " .. tostring(before)) + setButtonState(pushDownButton, true) + assert.are.equal(before, getButtonState()) + end) + + it("both refuse a button that is not a push-down one", function() + local getOk, getErr = getButtonState(plainButton) + assert.is_nil(getOk) + assert.are.equal(("item with name '%s' is not a push-down button"):format(plainButton), getErr) + local setOk, setErr = setButtonState(plainButton, true) + assert.is_nil(setOk) + assert.are.equal(("item with name '%s' is not a push-down button"):format(plainButton), setErr) + end) + + it("both refuse a name that is no button at all", function() + local unknown = "buttonSpecNoSuchButton" .. suffix + local getOk, getErr = getButtonState(unknown) + assert.is_nil(getOk) + assert.are.equal(("no button item with name '%s' found"):format(unknown), getErr) + local setOk, setErr = setButtonState(unknown, true) + assert.is_nil(setOk) + assert.are.equal(("no button item with name '%s' found"):format(unknown), setErr) + end) + + it("both refuse an empty button name", function() + local getOk, getErr = getButtonState("") + assert.is_nil(getOk) + assert.are.equal("item name must not be an empty string", getErr) + local setOk, setErr = setButtonState("", true) + assert.is_nil(setOk) + assert.are.equal("item name must not be an empty string", setErr) + end) + + it("both refuse a negative item ID", function() + local getOk, getErr = getButtonState(-1) + assert.is_nil(getOk) + assert.is_truthy(tostring(getErr):find("must be equal or greater than zero", 1, true)) + local setOk, setErr = setButtonState(-1, true) + assert.is_nil(setOk) + assert.is_truthy(tostring(setErr):find("must be equal or greater than zero", 1, true)) + end) + + it("setButtonState hard-errors when the state is not a boolean", function() + local ok, err = pcall(setButtonState, pushDownButton, "down") + assert.is_false(ok) + assert.is_truthy(tostring(err):find("setButtonState: bad argument #2 type", 1, true)) + end) + + it("both hard-error when the button is given as neither a name nor an ID", function() + local getOk, getErr = pcall(getButtonState, {}) + assert.is_false(getOk) + assert.is_truthy(tostring(getErr):find("getButtonState: bad argument #1 type", 1, true)) + local setOk, setErr = pcall(setButtonState, {}, true) + assert.is_false(setOk) + assert.is_truthy(tostring(setErr):find("setButtonState: bad argument #1 type", 1, true)) + end) + end) + + describe("setButtonStyleSheet", function() + it("returns true for an existing button", function() + assert.is_true(setButtonStyleSheet(pushDownButton, "QPushButton { color: rgb(3,2,1); }")) + assert.is_true(setButtonStyleSheet(plainButton, "")) + end) + + it("styles a button that is not a push-down one too", function() + assert.is_true(setButtonStyleSheet(plainButton, "QPushButton { color: rgb(9,9,9); }")) + end) + + it("returns nil and a message naming a button that is not there", function() + local unknown = "buttonSpecNoSuchButton" .. suffix + local ok, err = setButtonStyleSheet(unknown, "") + assert.is_nil(ok) + assert.are.equal(("no button named '%s' found"):format(unknown), err) + end) + + it("hard-errors on a non-string name", function() + local ok, err = pcall(setButtonStyleSheet, {}, "") + assert.is_false(ok) + assert.is_truthy(tostring(err):find("setButtonStyleSheet: bad argument #1 type", 1, true)) + end) + + it("hard-errors on a non-string style sheet", function() + local ok, err = pcall(setButtonStyleSheet, pushDownButton, {}) + assert.is_false(ok) + assert.is_truthy(tostring(err):find("setButtonStyleSheet: bad argument #2 type", 1, true)) + end) + + it("verifying what the button style sheet actually paints", function() + pending("there is no getButtonStyleSheet, and the effect is only visible in a screenshot") + end) + end) + + describe("showToolBar and hideToolBar", function() + -- both answer nothing at all, but they flip the active flag of the action + -- the toolbar was built from, which isActive() reads back. For a toolbar + -- that came out of a package that action is the package's own folder + -- rather than the toolbar, so the package's name is what they answer to + local function toolbarActive() + return isActive(packageName, "button") + end + + after_each(function() + showToolBar(packageName) + end) + + it("hideToolBar deactivates the toolbar and showToolBar activates it again", function() + assert.are.equal(1, toolbarActive()) + assert.are.equal(0, select("#", hideToolBar(packageName))) + assert.are.equal(0, toolbarActive()) + assert.are.equal(0, select("#", showToolBar(packageName))) + assert.are.equal(1, toolbarActive()) + end) + + it("hiding and showing repeatedly ends up where it started", function() + hideToolBar(packageName) + showToolBar(packageName) + hideToolBar(packageName) + showToolBar(packageName) + assert.are.equal(1, toolbarActive()) + assert.is_true(setButtonStyleSheet(pushDownButton, "")) + end) + + it("a name that is no toolbar is refused", function() + pending("both walk the toolbar list and do nothing at all when no name matches, so a typo is silent") + end) + + it("a packaged toolbar answering to its own name", function() + pending("regenerateEasyButtonBars builds a package's toolbars against the package's own action, so hideToolBar only answers to the package name and moves every toolbar in the package at once") + end) + + it("both hard-error on a non-string toolbar name", function() + local hideOk, hideErr = pcall(hideToolBar, {}) + assert.is_false(hideOk) + assert.is_truthy(tostring(hideErr):find("bad argument #1", 1, true)) + local showOk, showErr = pcall(showToolBar, {}) + assert.is_false(showOk) + assert.is_truthy(tostring(showErr):find("bad argument #1", 1, true)) + end) + + it("verifying that the toolbar is really on screen", function() + pending("toolbar visibility is not readable from Lua - needs a functional test") + end) + end) +end) + +end + +describe("Command line actions and suggestions", function() + local suffix = ("-%d-%d"):format(os.time(), math.random(100000)) + local cmdLine = "cmdActionLine" .. suffix + local unknown = "cmdActionNoSuchLine" .. suffix + + setup(function() + createCommandLine(cmdLine, 10, 10, 150, 30) + end) + + teardown(function() + deleteCommandLine(cmdLine) + end) + + describe("setCmdLineAction", function() + after_each(function() + resetCmdLineAction(cmdLine) + end) + + it("returns true for a command line that exists", function() + assert.is_true(setCmdLineAction(cmdLine, function() end)) + end) + + it("replacing an action returns true again", function() + assert.is_true(setCmdLineAction(cmdLine, function() end)) + assert.is_true(setCmdLineAction(cmdLine, function() end)) + end) + + it("returns nil and a message naming a command line that is not there", function() + local ok, err = setCmdLineAction(unknown, function() end) + assert.is_nil(ok) + assert.are.equal(("command line name '%s' not found"):format(unknown), err) + end) + + it("refuses the main command line, which takes no action", function() + -- only command lines made with createCommandLine can carry an action + local ok, err = setCmdLineAction("main", function() end) + assert.is_nil(ok) + assert.are.equal("command line name 'main' not found", err) + end) + + it("returns nil and a message for an empty command line name", function() + local ok, err = setCmdLineAction("", function() end) + assert.is_nil(ok) + assert.are.equal("command line name cannot be an empty string", err) + end) + + it("hard-errors on a non-string command line name", function() + local ok, err = pcall(setCmdLineAction, {}, function() end) + assert.is_false(ok) + assert.is_truthy(tostring(err):find("setCmdLineAction: bad argument #1 type", 1, true)) + end) + + it("takes the action as the name of a function to call, not only as a function", function() + -- the Lua wrapper compiles a string argument as "return <string>(...)", so + -- it has to name something callable rather than be a statement + assert.is_true(setCmdLineAction(cmdLine, "echo")) + end) + + it("hard-errors when the action is neither a function nor a string", function() + local ok, err = pcall(setCmdLineAction, cmdLine, {}) + assert.is_false(ok) + assert.is_truthy(tostring(err):find("setCmdLineAction: bad argument #2 type (function expected, got table!)", 1, true)) + end) + + it("hard-errors when no action is given at all", function() + local ok, err = pcall(setCmdLineAction, cmdLine) + assert.is_false(ok) + assert.is_truthy(tostring(err):find("setCmdLineAction: bad argument #2 type (function expected, got nil!)", 1, true)) + end) + + it("the action actually running on a typed command", function() + pending("the callback only fires on a typed Enter - needs a functional test") + end) + end) + + describe("resetCmdLineAction", function() + it("returns true after an action was set", function() + assert.is_true(setCmdLineAction(cmdLine, function() end)) + assert.is_true(resetCmdLineAction(cmdLine)) + end) + + it("returns true even when no action was ever set", function() + assert.is_true(resetCmdLineAction(cmdLine)) + end) + + it("returns nil and a message naming a command line that is not there", function() + local ok, err = resetCmdLineAction(unknown) + assert.is_nil(ok) + assert.are.equal(("command line name '%s' not found"):format(unknown), err) + end) + + it("returns nil and a message for an empty command line name", function() + local ok, err = resetCmdLineAction("") + assert.is_nil(ok) + assert.are.equal("command line name cannot be an empty string", err) + end) + + it("hard-errors on a non-string command line name", function() + local ok, err = pcall(resetCmdLineAction, {}) + assert.is_false(ok) + assert.is_truthy(tostring(err):find("resetCmdLineAction: bad argument #1 type", 1, true)) + end) + end) + + describe("clearCmdLineSuggestions", function() + it("returns nothing at all for the main command line", function() + assert.are.equal(0, select("#", clearCmdLineSuggestions())) + end) + + it("returns nothing at all for a named command line", function() + addCmdLineSuggestion(cmdLine, "suggested") + assert.are.equal(0, select("#", clearCmdLineSuggestions(cmdLine))) + end) + + it("returns nil and a message naming a command line that is not there", function() + local ok, err = clearCmdLineSuggestions(unknown) + assert.is_nil(ok) + assert.are.equal(('command line "%s" not found'):format(unknown), err) + end) + + it("hard-errors on a non-string command line name", function() + local ok, err = pcall(clearCmdLineSuggestions, {}) + assert.is_false(ok) + assert.is_truthy(tostring(err):find("bad argument #1", 1, true)) + end) + + it("checking that the suggestion list is really empty", function() + pending("there is no getCmdLineSuggestions to read the list back with") + end) + end) +end) + +describe("setPopup", function() + local suffix = ("-%d-%d"):format(os.time(), math.random(100000)) + local console = "popupConsole" .. suffix + local unknown = "popupNoSuchWindow" .. suffix + + setup(function() + createMiniConsole(console, 0, 0, 400, 200) + end) + + teardown(function() + deleteMiniConsole(console) + end) + + before_each(function() + clearWindow(console) + echo(console, "popup me\n") + moveCursor(console, 0, 0) + selectString(console, "popup me", 1) + end) + + it("returns true for matching command and hint tables", function() + assert.is_true(setPopup(console, {"one", "two"}, {"first", "second"})) + end) + + it("accepts one extra hint for the popup's own title", function() + assert.is_true(setPopup(console, {"one", "two"}, {"title", "first", "second"})) + end) + + it("accepts functions in place of command strings", function() + assert.is_true(setPopup(console, {function() end, function() end}, {"first", "second"})) + end) + + it("returns nil and a message when there are too few hints", function() + local ok, err = setPopup(console, {"one", "two"}, {"only one"}) + assert.is_nil(ok) + assert.is_truthy(tostring(err):find("command table and hint table sizes do not match up", 1, true)) + end) + + it("returns nil and a message when there are too many hints", function() + local ok, err = setPopup(console, {"one"}, {"first", "second", "third"}) + assert.is_nil(ok) + assert.is_truthy(tostring(err):find("command table and hint table sizes do not match up", 1, true)) + end) + + it("hard-errors when the commands are not a table", function() + local ok, err = pcall(setPopup, console, "one", {"first"}) + assert.is_false(ok) + assert.is_truthy(tostring(err):find("setPopup: bad argument", 1, true)) + end) + + it("hard-errors when the hints are not a table", function() + local ok, err = pcall(setPopup, console, {"one"}, "first") + assert.is_false(ok) + assert.is_truthy(tostring(err):find("setPopup: bad argument", 1, true)) + end) + + it("returns nil and a message naming a window that is not there", function() + local ok, err = setPopup(unknown, {"one"}, {"first"}) + assert.is_nil(ok) + assert.are.equal(('window "%s" not found'):format(unknown), err) + end) + + it("opening the popup menu and picking an entry", function() + pending("the menu only opens on a real right-click - needs a functional test") + end) +end) + +describe("Labels inside a user window", function() + -- user windows cannot be deleted from Lua, only hidden, so the name is + -- unique per run + local suffix = ("-%d-%d"):format(os.time(), math.random(100000)) + local userWindow = "labelUserWindow" .. suffix + local label = "labelInUserWindow" .. suffix + + setup(function() + -- loadLayout is off so a saved layout cannot move the window under us + openUserWindow(userWindow, false) + end) + + teardown(function() + hideWindow(userWindow) + end) + + before_each(function() + createLabel(userWindow, label, 5, 6, 120, 40, 1) + end) + + after_each(function() + deleteLabel(label) + end) + + it("the label really is inside the user window, not the main window", function() + -- createLabel falls back to the main window without a word when the parent + -- window name matches nothing, so a spec that only reads the label back + -- would pass either way; hiding the parent is what tells them apart + assert.is_true(windowVisible(label)) + hideWindow(userWindow) + assert.is_false(windowVisible(label)) + showWindow(userWindow) + assert.is_true(windowVisible(label)) + end) + + it("a parent window name that matches nothing is refused", function() + pending("createLabel puts the label in the main window and answers true when the parent window name is not a window") + end) + + it("echo puts text on a label that lives in a user window", function() + echo(label, "in the user window") + assert.is_truthy(getLabelText(label):find("in the user window", 1, true)) + end) + + it("resizeWindow and moveWindow work on it just as in the main window", function() + resizeWindow(label, 200, 60) + moveWindow(label, 15, 25) + assert.are.same({15, 25, 200, 60}, {getWindowGeometry(label)}) + end) + + it("hideWindow and showWindow work on it", function() + -- hideWindow answers nothing at all where showWindow answers a boolean + assert.are.equal(0, select("#", hideWindow(label))) + assert.is_false(windowVisible(label)) + assert.is_true(showWindow(label)) + assert.is_true(windowVisible(label)) + end) + + it("takes the fill background flag as a number as well as a boolean", function() + local numberFlag = "labelNumberFlag" .. suffix + local booleanFlag = "labelBooleanFlag" .. suffix + finally(function() + deleteLabel(numberFlag) + deleteLabel(booleanFlag) + end) + assert.is_true(createLabel(userWindow, numberFlag, 0, 0, 20, 10, 1)) + assert.is_true(createLabel(userWindow, booleanFlag, 0, 15, 20, 10, true)) + end) + + it("takes the optional clickthrough flag", function() + local clickthrough = "labelClickthrough" .. suffix + finally(function() deleteLabel(clickthrough) end) + assert.is_true(createLabel(userWindow, clickthrough, 0, 30, 20, 10, 1, 1)) + end) + + it("hard-errors on a non-boolean, non-number fill background flag", function() + local ok, err = pcall(createLabel, userWindow, "labelBadFill" .. suffix, 0, 0, 20, 10, "fill") + assert.is_false(ok) + assert.is_truthy(tostring(err):find("createLabel: bad argument #7 type", 1, true)) + end) + + it("hard-errors on a non-boolean, non-number clickthrough flag", function() + local ok, err = pcall(createLabel, userWindow, "labelBadClick" .. suffix, 0, 0, 20, 10, 1, "through") + assert.is_false(ok) + assert.is_truthy(tostring(err):find("createLabel: bad argument #8 type", 1, true)) + end) + + it("hard-errors on a non-number label width", function() + local ok, err = pcall(createLabel, userWindow, "labelBadWidth" .. suffix, 0, 0, "wide", 10, 1) + assert.is_false(ok) + assert.is_truthy(tostring(err):find("createLabel: bad argument #5 type (label width", 1, true)) + end) +end) From 6c0e399a9a93afa852dc5316fc80520919ba2249 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Tue, 11 Aug 2026 08:08:38 +0200 Subject: [PATCH 149/155] infrastructure: Add functional tests for the profile lifecycle Lua API (#9776) #### Brief overview of PR changes/additions - New `ProfileLifecycleTest` (18 test functions) covering the profile-lifecycle Lua API the busted suite cannot reach, since busted runs inside a single profile of an application it must leave standing: `loadProfile`, `setActiveProfile`, `closeProfile`, `closeMudlet`, and the cross-profile half of `raiseGlobalEvent`. - Drives each function from a profile's own Lua state and checks the application state that follows - host pool, tab, main console, active profile, socket - not just the return value. Teardown is asserted with `QPointer`s, so the closed profile's objects have to be genuinely gone. - Runs against a `QTemporaryDir` config dir and an ephemeral stub port, so it never touches the developer's own profiles and does not collide with parallel test runs. #### Motivation for adding to Mudlet These five functions had no automated coverage at all. Between them they disagree on almost every convention - `loadProfile`/`closeProfile` refuse with `nil`, `setActiveProfile` with `false`; all three resolve names case-insensitively; `raiseGlobalEvent` serialises its arguments to strings and appends the sender - and none of that was pinned anywhere. Bug found while writing it, not fixed here: `raiseGlobalEvent`'s argument-type rejection is a `lua_error()`, which longjmps out of the C function so the `TEvent` being filled in on the stack is never destroyed. `raiseGlobalEvent('name', {})` leaks the arguments collected before the bad one (170 bytes, confirmed under LeakSanitizer). The test asserts the refusal with the argument-#1 form, which has collected nothing yet; a comment marks the realistic form as untested until the leak is fixed. #### Other info (issues closed, discussion etc) Coordinated with #9706 (fix-host-child-teardown): no overlap - that PR covers notepad/IRC/toolbar teardown, this one the Lua API and the host pool, and both insert into `test/functional_tests/CMakeLists.txt` at different points. **Test case:** `ctest -R ProfileLifecycleTest` - 18 tests, ~8s, LeakSanitizer-checked; full functional suite 59/59 twice; sabotage-verified by breaking `setActiveProfile`'s tab switch, `raiseGlobalEvent`'s sender exclusion, `closeProfile`'s close request and `loadProfile`'s offline flag - 6 of the 18 fail, and only those. Assisted-by: Claude:claude-opus-5 --- test/functional_tests/CMakeLists.txt | 5 + .../functional_tests/ProfileLifecycleTest.cpp | 684 ++++++++++++++++++ 2 files changed, 689 insertions(+) create mode 100644 test/functional_tests/ProfileLifecycleTest.cpp diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index e84f4002d..cf739738b 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -28,6 +28,7 @@ set(FUNCTIONAL_TEST_SOURCES MainConsoleSelectionTest.cpp EnableDisableByNameTest.cpp UnitDeferredDeleteTest.cpp + ProfileLifecycleTest.cpp MxpFramePlacementTest.cpp ColorTriggerFilterChildTest.cpp GlyphOverflowTest.cpp @@ -163,6 +164,10 @@ set_tests_properties(InsertTextCapTest PROPERTIES TIMEOUT 300) # LogRestartDuplicateLineTest creates a fresh profile per test method, so it needs a longer timeout set_tests_properties(LogRestartDuplicateLineTest PROPERTIES TIMEOUT 300) +# ProfileLifecycleTest opens and closes several profiles, and every open is a +# full profile load and every close a full save, so it needs a longer timeout +set_tests_properties(ProfileLifecycleTest PROPERTIES TIMEOUT 300) + # TMediaLoopTest probes the audio backend and creates a fresh profile per test method, # and each clip has to be waited out in real time, so it needs a longer timeout. # QTEST_MAIN does not run src/main.cpp, so pin QT_MEDIA_BACKEND to what main.cpp picks for diff --git a/test/functional_tests/ProfileLifecycleTest.cpp b/test/functional_tests/ProfileLifecycleTest.cpp new file mode 100644 index 000000000..a54ed5bf5 --- /dev/null +++ b/test/functional_tests/ProfileLifecycleTest.cpp @@ -0,0 +1,684 @@ +/*************************************************************************** + * Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +/* + * The profile lifecycle API - loadProfile(), setActiveProfile(), + * closeProfile(), closeMudlet() and the cross-profile half of + * raiseGlobalEvent() - is out of reach of the busted suite, which runs inside + * one profile of an application it must leave standing. Each test here drives + * the API from a profile's own Lua state and checks the application state that + * follows, plus the refusals the three name-taking functions return. + * + * Left uncovered on purpose: closeProfile() reports true as soon as it has + * asked for the close, so a close that Host::requestClose() then refuses still + * reads as a success. Reaching that needs the modal save prompt the fixture + * below is deliberately built to avoid. + * + * Run with: ctest -R ProfileLifecycleTest -V + */ + +#include <QtTest/QtTest> +#include <chrono> + +#include "Host.h" +#include "HostManager.h" +#include "MudletInstanceCoordinator.h" +#include "TLuaInterpreter.h" +#include "TMainConsole.h" +#include "TTabBar.h" +#include "TelnetServerStub.h" +#include "ctelnet.h" +#include "dlgConnectionProfiles.h" +#include "mudlet.h" + +extern "C" { +#if defined(INCLUDE_VERSIONED_LUA_HEADERS) +#include <lua5.1/lauxlib.h> +#include <lua5.1/lua.h> +#include <lua5.1/lualib.h> +#else +#include <lauxlib.h> +#include <lua.h> +#include <lualib.h> +#endif +} + +using namespace std::chrono_literals; + +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); +void initializeQRCResourcesForProfileLifecycleTest(); + +class ProfileLifecycleTest : public QObject +{ + Q_OBJECT + +private: + // What a Lua call returned: the type of the first value matters as much as + // the value, since these functions disagree on whether a refusal is a nil + // or a false + struct LuaOutcome + { + QString error; // non-null when the chunk failed, at compile or at run time + QString firstType; + bool first = false; + QString message; + }; + + // enough for a real connection to the local stub on a loaded machine + static constexpr int csmConnectBudgetMs = 15000; + // What an offline profile is given to prove it does not connect. Shorter + // than the budget above deliberately - the online test is what shows a + // connection is noticed well inside a wait of this size. + static constexpr int csmStayOfflineBudgetMs = 3000; + static constexpr int csmTeardownBudgetMs = 30000; + + QTemporaryDir mConfigDir; + QByteArray mSavedXdgConfigHome; + TelnetServerStub* mpServer = nullptr; + QString mPort; + Host* mpFirstHost = nullptr; + + const QString mLocalhost = qsl("localhost"); + const QString mFirstProfile = qsl("ProfileLifecycle-First"); + const QString mSecondProfile = qsl("ProfileLifecycle-Second"); + const QString mThirdProfile = qsl("ProfileLifecycle-Third"); + const QString mOnlineProfile = qsl("ProfileLifecycle-Online"); + const QString mUnloadedProfile = qsl("ProfileLifecycle-Unloaded"); + const QString mAbsentProfile = qsl("ProfileLifecycle-Absent"); + + // setupConfig() consults portable.txt ahead of the XDG logic; skip rather + // than run against an unexpected config dir (see ConfigDirOverrideTest) + bool portableMarkerPresent() const + { + return QFileInfo::exists(qsl("%1/portable.txt").arg(QCoreApplication::applicationDirPath())) || QFileInfo::exists(qsl("%1/.config/mudlet/portable.txt").arg(QDir::homePath())); + } + + Host* hostFor(const QString& profileName) const { return mudlet::self()->getHostManager().getHost(profileName); } + + bool profileHasATab(const QString& profileName) const { return mudlet::self()->mpTabBar->tabIndex(profileName) != -1; } + + // Compares against the pool itself rather than a name, since a Host that + // has been closed cannot be asked for one + bool stillInTheHostPool(Host* pHost) const + { + if (!pHost) { + return false; + } + for (auto pLoadedHost : mudlet::self()->getHostManager()) { + if (pLoadedHost == pHost) { + return true; + } + } + return false; + } + + static bool reachedTheGame(Host* pHost) + { + const auto [address, port, connected] = pHost->mTelnet.getConnectionInfo(); + return connected; + } + + // The folder is all getCanonicalProfileName() matches a name against; the + // url and port are what the load then needs to reach the stub, as the Host + // constructor reads both back out of the profile's data files. + bool provisionProfileOnDisk(const QString& profileName) const + { + return QDir().mkpath(mudlet::getMudletPath(enums::profileHomePath, profileName)) && mudlet::self()->writeProfileData(profileName, qsl("url"), mLocalhost).first + && mudlet::self()->writeProfileData(profileName, qsl("port"), mPort).first; + } + + // Returns the Lua error, or a null QString when the chunk ran + QString runLua(Host* pHost, const QString& code) const + { + lua_State* L = pHost->getLuaInterpreter()->getLuaGlobalState(); + if (luaL_dostring(L, code.toUtf8().constData()) == 0) { + return QString(); + } + // an error object that is neither a string nor a number gives back a + // nullptr here, and QString::fromUtf8(nullptr) is null - which every + // caller would read as "the chunk ran" + const char* message = lua_tostring(L, -1); + const QString error = message ? QString::fromUtf8(message) : qsl("(a Lua error that is not a string)"); + lua_pop(L, 1); + return error; + } + + LuaOutcome callLua(Host* pHost, const QString& expression) const + { + LuaOutcome outcome; + outcome.error = runLua(pHost, qsl("_lifecycleResult, _lifecycleMessage = %1").arg(expression)); + if (!outcome.error.isNull()) { + return outcome; + } + + lua_State* L = pHost->getLuaInterpreter()->getLuaGlobalState(); + lua_getglobal(L, "_lifecycleResult"); + outcome.firstType = QString::fromUtf8(luaL_typename(L, -1)); + outcome.first = lua_toboolean(L, -1); + lua_pop(L, 1); + lua_getglobal(L, "_lifecycleMessage"); + if (lua_type(L, -1) == LUA_TSTRING) { + outcome.message = QString::fromUtf8(lua_tostring(L, -1)); + } + lua_pop(L, 1); + return outcome; + } + + QString luaGlobalString(Host* pHost, const QString& globalName) const + { + lua_State* L = pHost->getLuaInterpreter()->getLuaGlobalState(); + lua_getglobal(L, globalName.toUtf8().constData()); + QString value; + if (lua_type(L, -1) == LUA_TSTRING) { + value = QString::fromUtf8(lua_tostring(L, -1)); + } + lua_pop(L, 1); + return value; + } + + int luaGlobalNumber(Host* pHost, const QString& globalName) const + { + lua_State* L = pHost->getLuaInterpreter()->getLuaGlobalState(); + lua_getglobal(L, globalName.toUtf8().constData()); + const int value = static_cast<int>(lua_tointeger(L, -1)); + lua_pop(L, 1); + return value; + } + + // _lifecycleHandler holds one handler at a time, so forgetEvent() has to + // run before the next rememberEvent() or the previous handler is orphaned + // and goes on writing the same globals + QString rememberEvent(Host* pHost, const QString& eventName) const + { + return runLua(pHost, + qsl("_lifecyclePayload, _lifecycleSender, _lifecycleCalls = nil, nil, 0\n" + "_lifecycleHandler = registerAnonymousEventHandler('%1', function(_, payload, sender)\n" + " _lifecyclePayload, _lifecycleSender = payload, sender\n" + " _lifecycleCalls = _lifecycleCalls + 1\n" + "end)") + .arg(eventName)); + } + + QString forgetEvent(Host* pHost) const { return runLua(pHost, qsl("if _lifecycleHandler then killAnonymousEventHandler(_lifecycleHandler) _lifecycleHandler = nil end")); } + + void startFirstProfile() + { + const QString profileName = mFirstProfile; + const QString address = mLocalhost; + const QString port = mPort; + QTimer::singleShot(0ms, qApp, [profileName, address, port]() { + mudlet::self()->startAutoLogin({}); + QTest::qWait(100ms); + QTest::mouseClick(mudlet::self()->mpConnectionDialog->new_profile_button, Qt::LeftButton); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), profileName); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), address); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), port); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Return); + }); + + QSignalSpy spy(mudlet::self(), &mudlet::signal_profileLoaded); + QVERIFY2(spy.wait(csmConnectBudgetMs), "the first profile took too long to load"); + mpFirstHost = mudlet::self()->getActiveHost(); + QVERIFY2(mpFirstHost, "no active host after creating the first profile"); + // otherwise closing a profile asks whether to save it, and the modal + // question would hang the test + QVERIFY2(mpFirstHost->mFORCE_SAVE_ON_EXIT, "profiles must save without asking, or a close puts up a modal question"); + } + + // test_closeProfileNamedByAnotherProfileTearsItDown takes the second + // profile away again, and any one test can also be run on its own with + // -functions, so a test that needs another profile opens it itself. The + // declaration order still matters for the closeMudlet test, which has to + // stay last. + Host* loadProfileThroughLua(const QString& profileName) + { + if (auto* pHost = hostFor(profileName)) { + return pHost; + } + if (!provisionProfileOnDisk(profileName)) { + qWarning() << "loadProfileThroughLua: could not provision" << profileName; + return nullptr; + } + const LuaOutcome outcome = callLua(mpFirstHost, qsl("loadProfile('%1', true)").arg(profileName)); + if (!outcome.error.isNull()) { + qWarning() << "loadProfileThroughLua:" << outcome.error; + return nullptr; + } + if (!outcome.first) { + qWarning() << "loadProfileThroughLua: loadProfile() refused:" << outcome.message; + return nullptr; + } + return hostFor(profileName); + } + + bool waitFor(const std::function<bool()>& condition) const + { + QElapsedTimer timer; + timer.start(); + while (timer.elapsed() < csmTeardownBudgetMs) { + if (condition()) { + return true; + } + QTest::qWait(50ms); + } + return condition(); + } + + // Removal from the host pool is finished off from a zero-timer, so the + // Host is still there until the event loop has run - even though the + // console has been closed and the profile saved by the time closeProfile() + // returns + bool waitForProfileToClose(const QString& profileName) const + { + return waitFor([this, profileName]() { + return !hostFor(profileName); + }); + } + +private slots: + void initTestCase() + { + if (portableMarkerPresent()) { + QSKIP("portable.txt present - cannot redirect the config dir for this test"); + } + initializeQRCResourcesForProfileLifecycleTest(); + + QVERIFY(mConfigDir.isValid()); + // an existing $XDG_CONFIG_HOME/mudlet makes setupConfig() adopt it, so + // the profiles these tests enumerate are only ever their own + QVERIFY(QDir().mkpath(qsl("%1/mudlet").arg(mConfigDir.path()))); + mSavedXdgConfigHome = qgetenv("XDG_CONFIG_HOME"); + qputenv("XDG_CONFIG_HOME", mConfigDir.path().toUtf8()); + + mpServer = new TelnetServerStub(qApp); + mpServer->start(mLocalhost, 0); // ephemeral OS-assigned port avoids collisions across concurrent test runs + // TelnetServerStub::start() only logs a failed bind, so check the port + // here: otherwise every profile is pointed at port 0 and the run fails + // later on, nowhere near the stub + QVERIFY2(mpServer->serverPort() != 0, "the telnet stub did not start listening"); + mPort = QString::number(mpServer->serverPort()); + + mudlet::start(); + mudlet::self()->setupConfig(); + QCOMPARE(mudlet::getMudletPath(enums::mainPath), qsl("%1/mudlet").arg(mConfigDir.path())); + // Written before init(), which is where a config with no keys at all + // gets stamped as a first launch. A settings file that already holds + // something is how mudletUsedBefore() recognises an existing player, so + // this both suppresses the first-run UI tour and keeps the starter UI + // package out of every profile these tests open. + mudlet::getQSettings()->setValue(qsl("uiTourShown"), true); + mudlet::getQSettings()->sync(); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique<MudletInstanceCoordinator>(qsl("MudletInstanceCoordinator"))); + mudlet::self()->init(); + mudlet::self()->setStorePasswordsSecurely(false); + QVERIFY2(mudlet::self()->experiencedMudletPlayer(), "the first-run UI would open over these tests"); + + startFirstProfile(); + // a failed assertion in there only returns from it, so stop the whole + // run here rather than let every test dereference a null host + QVERIFY(mpFirstHost); + } + + void cleanupTestCase() + { + delete mpServer; + mpServer = nullptr; + // null once the closeMudlet test has run, and deleting that is a no-op + delete mudlet::self(); + mSavedXdgConfigHome.isNull() ? qunsetenv("XDG_CONFIG_HOME") : qputenv("XDG_CONFIG_HOME", mSavedXdgConfigHome); + } + + void test_loadProfileRefusesAnEmptyName() + { + const LuaOutcome outcome = callLua(mpFirstHost, qsl("loadProfile('')")); + + QVERIFY2(outcome.error.isNull(), qPrintable(outcome.error)); + QCOMPARE(outcome.firstType, qsl("nil")); + QVERIFY2(outcome.message.contains(qsl("cannot be empty")), qPrintable(qsl("unexpected message: %1").arg(outcome.message))); + } + + void test_loadProfileRefusesAProfileThatDoesNotExist() + { + QVERIFY2(!QDir(mudlet::getMudletPath(enums::profileHomePath, mAbsentProfile)).exists(), "the profile this test needs to be absent exists"); + + const LuaOutcome outcome = callLua(mpFirstHost, qsl("loadProfile('%1')").arg(mAbsentProfile)); + + QVERIFY2(outcome.error.isNull(), qPrintable(outcome.error)); + QCOMPARE(outcome.firstType, qsl("nil")); + QVERIFY2(outcome.message.contains(qsl("does not exist")), qPrintable(qsl("unexpected message: %1").arg(outcome.message))); + QVERIFY2(!hostFor(mAbsentProfile), "a profile that does not exist was loaded anyway"); + } + + void test_loadProfileRefusesAProfileThatIsAlreadyLoaded() + { + const int loadedBefore = mudlet::self()->getHostManager().getHostCount(); + + // asked for in the wrong case, and the refusal names the profile as it + // is spelt on disk: the case-insensitive lookup all three of these + // functions share + const LuaOutcome outcome = callLua(mpFirstHost, qsl("loadProfile('%1')").arg(mFirstProfile.toLower())); + + QVERIFY2(outcome.error.isNull(), qPrintable(outcome.error)); + QCOMPARE(outcome.firstType, qsl("nil")); + QVERIFY2(outcome.message.contains(qsl("'%1' is already loaded").arg(mFirstProfile)), qPrintable(qsl("unexpected message: %1").arg(outcome.message))); + QCOMPARE(mudlet::self()->getHostManager().getHostCount(), loadedBefore); + } + + void test_loadProfileOpensASecondProfile() + { + QVERIFY(provisionProfileOnDisk(mSecondProfile)); + QVERIFY2(!hostFor(mSecondProfile), "the second profile was already loaded"); + const int loadedBefore = mudlet::self()->getHostManager().getHostCount(); + + const LuaOutcome outcome = callLua(mpFirstHost, qsl("loadProfile('%1', true)").arg(mSecondProfile)); + + QVERIFY2(outcome.error.isNull(), qPrintable(outcome.error)); + QCOMPARE(outcome.firstType, qsl("boolean")); + QVERIFY2(outcome.first, qPrintable(qsl("loadProfile() refused: %1").arg(outcome.message))); + + Host* pSecondHost = hostFor(mSecondProfile); + QVERIFY2(pSecondHost, "loadProfile() reported success but the profile is not in the host pool"); + QVERIFY2(pSecondHost->mpConsole, "the loaded profile has no main console, so nothing of it is on screen"); + QVERIFY2(profileHasATab(mSecondProfile), "the loaded profile got no tab"); + QCOMPARE(mudlet::self()->getHostManager().getHostCount(), loadedBefore + 1); + + // An online load reaches the game some event loop turns later, so the + // socket is unconnected on the line after the call either way - only a + // wait that runs out says the offline flag was honoured. + // test_loadProfileConnectsWhenNotAskedForOffline is the control. + QSignalSpy connectionSpy(&pSecondHost->mTelnet, &cTelnet::signal_connected); + QVERIFY2(!connectionSpy.wait(csmStayOfflineBudgetMs) && !reachedTheGame(pSecondHost), "loadProfile(name, true) connected the profile despite being asked for offline"); + } + + // Connecting is what loadProfile() does when it is not told otherwise + void test_loadProfileConnectsWhenNotAskedForOffline() + { + QVERIFY(provisionProfileOnDisk(mOnlineProfile)); + QVERIFY2(!hostFor(mOnlineProfile), "the profile this test opens was already loaded"); + + const LuaOutcome outcome = callLua(mpFirstHost, qsl("loadProfile('%1')").arg(mOnlineProfile)); + + QVERIFY2(outcome.error.isNull(), qPrintable(outcome.error)); + QVERIFY2(outcome.first, qPrintable(qsl("loadProfile() refused: %1").arg(outcome.message))); + Host* pOnlineHost = hostFor(mOnlineProfile); + QVERIFY(pOnlineHost); + QSignalSpy connectionSpy(&pOnlineHost->mTelnet, &cTelnet::signal_connected); + QVERIFY2(reachedTheGame(pOnlineHost) || connectionSpy.wait(csmConnectBudgetMs), "loadProfile() with no offline argument did not connect the profile to the game"); + + QVERIFY(callLua(mpFirstHost, qsl("closeProfile('%1')").arg(mOnlineProfile)).first); + QVERIFY(waitForProfileToClose(mOnlineProfile)); + } + + void test_setActiveProfileRefusesAnEmptyName() + { + const LuaOutcome outcome = callLua(mpFirstHost, qsl("setActiveProfile('')")); + + QVERIFY2(outcome.error.isNull(), qPrintable(outcome.error)); + QCOMPARE(outcome.firstType, qsl("boolean")); + QVERIFY(!outcome.first); + QVERIFY2(outcome.message.contains(qsl("cannot be empty")), qPrintable(qsl("unexpected message: %1").arg(outcome.message))); + } + + void test_setActiveProfileRefusesAProfileThatDoesNotExist() + { + const LuaOutcome outcome = callLua(mpFirstHost, qsl("setActiveProfile('%1')").arg(mAbsentProfile)); + + QVERIFY2(outcome.error.isNull(), qPrintable(outcome.error)); + // unlike loadProfile()/closeProfile(), this one refuses with false + QCOMPARE(outcome.firstType, qsl("boolean")); + QVERIFY(!outcome.first); + QVERIFY2(outcome.message.contains(qsl("does not exist")), qPrintable(qsl("unexpected message: %1").arg(outcome.message))); + } + + void test_setActiveProfileRefusesAProfileThatIsNotLoaded() + { + QVERIFY(provisionProfileOnDisk(mUnloadedProfile)); + QVERIFY2(!hostFor(mUnloadedProfile), "the profile this test needs unloaded is loaded"); + Host* pActiveBefore = mudlet::self()->getActiveHost(); + + const LuaOutcome outcome = callLua(mpFirstHost, qsl("setActiveProfile('%1')").arg(mUnloadedProfile)); + + QVERIFY2(outcome.error.isNull(), qPrintable(outcome.error)); + QCOMPARE(outcome.firstType, qsl("boolean")); + QVERIFY(!outcome.first); + QVERIFY2(outcome.message.contains(qsl("is not loaded")), qPrintable(qsl("unexpected message: %1").arg(outcome.message))); + QCOMPARE(mudlet::self()->getActiveHost(), pActiveBefore); + } + + void test_setActiveProfileSwitchesTheActiveProfile() + { + Host* pSecondHost = loadProfileThroughLua(mSecondProfile); + QVERIFY(pSecondHost); + + LuaOutcome outcome = callLua(mpFirstHost, qsl("setActiveProfile('%1')").arg(mFirstProfile)); + QVERIFY2(outcome.error.isNull(), qPrintable(outcome.error)); + QVERIFY2(outcome.first, qPrintable(qsl("setActiveProfile() refused: %1").arg(outcome.message))); + QCOMPARE(mudlet::self()->getActiveHost(), mpFirstHost); + + outcome = callLua(mpFirstHost, qsl("setActiveProfile('%1')").arg(mSecondProfile)); + QVERIFY2(outcome.error.isNull(), qPrintable(outcome.error)); + QCOMPARE(outcome.firstType, qsl("boolean")); + QVERIFY2(outcome.first, qPrintable(qsl("setActiveProfile() refused: %1").arg(outcome.message))); + QCOMPARE(mudlet::self()->getActiveHost(), pSecondHost); + QVERIFY(profileHasATab(mSecondProfile)); + QCOMPARE(mudlet::self()->mpTabBar->currentIndex(), mudlet::self()->mpTabBar->tabIndex(mSecondProfile)); + + // leave the profile the rest of the tests drive from in charge + QVERIFY(callLua(mpFirstHost, qsl("setActiveProfile('%1')").arg(mFirstProfile)).first); + } + + // Every other loaded profile is told the name of the profile that raised + // the event, and the one that raised it never hears it come back + void test_raiseGlobalEventReachesEveryOtherProfileOnly() + { + Host* pSecondHost = loadProfileThroughLua(mSecondProfile); + Host* pThirdHost = loadProfileThroughLua(mThirdProfile); + QVERIFY(pSecondHost && pThirdHost); + const QString eventName = qsl("ProfileLifecycleGlobalEvent"); + QVERIFY(rememberEvent(mpFirstHost, eventName).isNull()); + QVERIFY(rememberEvent(pSecondHost, eventName).isNull()); + QVERIFY(rememberEvent(pThirdHost, eventName).isNull()); + + QVERIFY(runLua(mpFirstHost, qsl("raiseGlobalEvent('%1', 'from the first')").arg(eventName)).isNull()); + + for (Host* pReceiver : {pSecondHost, pThirdHost}) { + QCOMPARE(luaGlobalString(pReceiver, qsl("_lifecyclePayload")), qsl("from the first")); + QCOMPARE(luaGlobalString(pReceiver, qsl("_lifecycleSender")), mFirstProfile); + QCOMPARE(luaGlobalNumber(pReceiver, qsl("_lifecycleCalls")), 1); + } + QCOMPARE(luaGlobalNumber(mpFirstHost, qsl("_lifecycleCalls")), 0); + + QVERIFY(runLua(pSecondHost, qsl("raiseGlobalEvent('%1', 'from the second')").arg(eventName)).isNull()); + + QCOMPARE(luaGlobalString(mpFirstHost, qsl("_lifecyclePayload")), qsl("from the second")); + QCOMPARE(luaGlobalString(mpFirstHost, qsl("_lifecycleSender")), mSecondProfile); + QCOMPARE(luaGlobalNumber(mpFirstHost, qsl("_lifecycleCalls")), 1); + QCOMPARE(luaGlobalNumber(pSecondHost, qsl("_lifecycleCalls")), 1); + + QVERIFY(forgetEvent(mpFirstHost).isNull()); + QVERIFY(forgetEvent(pSecondHost).isNull()); + QVERIFY(forgetEvent(pThirdHost).isNull()); + } + + // Arguments cross the profile boundary as strings and are rebuilt on the + // other side, so their types have to survive the trip - and the sending + // profile's name is appended after all of them, however many there are + void test_raiseGlobalEventKeepsArgumentTypesAndPutsTheSenderLast() + { + Host* pSecondHost = loadProfileThroughLua(mSecondProfile); + QVERIFY(pSecondHost); + const QString eventName = qsl("ProfileLifecycleTypedEvent"); + QVERIFY(runLua(pSecondHost, + qsl("_lifecycleTypes, _lifecycleValues = nil, nil\n" + "_lifecycleHandler = registerAnonymousEventHandler('%1', function(_, ...)\n" + " local given, types = {...}, {}\n" + " for i = 1, select('#', ...) do types[i] = type(given[i]) end\n" + " _lifecycleTypes = table.concat(types, ',')\n" + " _lifecycleValues = table.concat({tostring(given[1]), tostring(given[2]), tostring(given[4]), tostring(given[5])}, '|')\n" + "end)") + .arg(eventName)) + .isNull()); + + QVERIFY(runLua(mpFirstHost, qsl("raiseGlobalEvent('%1', 3.5, true, nil, 'text')").arg(eventName)).isNull()); + + QCOMPARE(luaGlobalString(pSecondHost, qsl("_lifecycleTypes")), qsl("number,boolean,nil,string,string")); + QCOMPARE(luaGlobalString(pSecondHost, qsl("_lifecycleValues")), qsl("3.5|true|text|%1").arg(mFirstProfile)); + + QVERIFY(forgetEvent(pSecondHost).isNull()); + } + + // Unlike raiseEvent(), which can hand a handler in the same profile a + // table through the Lua registry, nothing survives the trip to another + // profile that cannot be turned into a string. + // + // The table is passed as the very first argument on purpose. Rejecting one + // is a lua_error(), which longjmps straight out of the C function, so the + // TEvent being filled in on the stack is never destroyed and whatever it + // has already collected leaks. Refusing argument #1 is the one case that + // has collected nothing yet - a leaking case here would fail the whole + // binary under LeakSanitizer, so the realistic + // raiseGlobalEvent('name', {}) form stays untested until that is fixed. + void test_raiseGlobalEventRefusesArgumentsItCannotCarry() + { + const QString tableError = runLua(mpFirstHost, qsl("raiseGlobalEvent({})")); + QVERIFY2(!tableError.isNull(), "raiseGlobalEvent() accepted a table"); + QVERIFY2(tableError.contains(qsl("bad argument type #1")), qPrintable(tableError)); + + const QString noNameError = runLua(mpFirstHost, qsl("raiseGlobalEvent()")); + QVERIFY2(!noNameError.isNull(), "raiseGlobalEvent() accepted a call with no event name"); + QVERIFY2(noNameError.contains(qsl("missing argument #1")), qPrintable(noNameError)); + } + + void test_closeProfileRefusesAProfileThatDoesNotExist() + { + const LuaOutcome outcome = callLua(mpFirstHost, qsl("closeProfile('%1')").arg(mAbsentProfile)); + + QVERIFY2(outcome.error.isNull(), qPrintable(outcome.error)); + QCOMPARE(outcome.firstType, qsl("nil")); + QVERIFY2(outcome.message.contains(qsl("does not exist")), qPrintable(qsl("unexpected message: %1").arg(outcome.message))); + } + + void test_closeProfileRefusesAProfileThatIsNotLoaded() + { + QVERIFY(provisionProfileOnDisk(mUnloadedProfile)); + QVERIFY2(!hostFor(mUnloadedProfile), "the profile this test needs unloaded is loaded"); + + const LuaOutcome outcome = callLua(mpFirstHost, qsl("closeProfile('%1')").arg(mUnloadedProfile)); + + QVERIFY2(outcome.error.isNull(), qPrintable(outcome.error)); + QCOMPARE(outcome.firstType, qsl("nil")); + QVERIFY2(outcome.message.contains(qsl("is not loaded")), qPrintable(qsl("unexpected message: %1").arg(outcome.message))); + } + + void test_closeProfileNamedByAnotherProfileTearsItDown() + { + QPointer<Host> pSecondHost = loadProfileThroughLua(mSecondProfile); + QVERIFY(pSecondHost); + QPointer<TMainConsole> pSecondConsole = pSecondHost->mpConsole; + QVERIFY(pSecondConsole); + const int loadedBefore = mudlet::self()->getHostManager().getHostCount(); + + const LuaOutcome outcome = callLua(mpFirstHost, qsl("closeProfile('%1')").arg(mSecondProfile)); + + QVERIFY2(outcome.error.isNull(), qPrintable(outcome.error)); + QCOMPARE(outcome.firstType, qsl("boolean")); + QVERIFY(outcome.first); + QVERIFY2(waitForProfileToClose(mSecondProfile), "the profile was still in the host pool long after closeProfile() said it was closing"); + QVERIFY2(pSecondHost.isNull(), "the closed profile's Host outlived its removal from the host pool"); + // the console goes on a deferred delete of its own, so give it the + // same budget rather than assume it landed inside the wait above + QVERIFY2(waitFor([&pSecondConsole]() { + return pSecondConsole.isNull(); + }), + "the closed profile's main console was left behind"); + QVERIFY2(!profileHasATab(mSecondProfile), "the closed profile kept its tab"); + QCOMPARE(mudlet::self()->getHostManager().getHostCount(), loadedBefore - 1); + QVERIFY2(hostFor(mFirstProfile), "closing one profile took the other one with it"); + QVERIFY2(stillInTheHostPool(mudlet::self()->getActiveHost()), "closing a profile left the active profile pointing at a Host that has been destroyed"); + } + + void test_closeProfileWithNoArgumentClosesTheCallingProfile() + { + QPointer<Host> pThirdHost = loadProfileThroughLua(mThirdProfile); + QVERIFY(pThirdHost); + + const LuaOutcome outcome = callLua(pThirdHost, qsl("closeProfile()")); + + QVERIFY2(outcome.error.isNull(), qPrintable(outcome.error)); + QCOMPARE(outcome.firstType, qsl("boolean")); + QVERIFY(outcome.first); + QVERIFY2(waitForProfileToClose(mThirdProfile), "a profile that closed itself was still in the host pool long afterwards"); + QVERIFY2(pThirdHost.isNull(), "the self-closed profile's Host outlived its removal from the host pool"); + QVERIFY2(!profileHasATab(mThirdProfile), "the self-closed profile kept its tab"); + QVERIFY2(hostFor(mFirstProfile), "a profile closing itself took another profile with it"); + } + + // Last on purpose: this takes the main window with it, so no test slot can + // run after it - only cleanupTestCase(), which is written for a Mudlet + // that has already gone + void test_closeMudletShutsDownEveryProfileAndTheMainWindow() + { + QPointer<Host> pSecondHost = loadProfileThroughLua(mSecondProfile); + QVERIFY(pSecondHost); + QPointer<Host> pFirstHost = mpFirstHost; + QPointer<mudlet> pMainWindow = mudlet::self(); + + QVERIFY(runLua(mpFirstHost, qsl("closeMudlet()")).isNull()); + mpFirstHost = nullptr; + + // the main window is WA_DeleteOnClose, so it goes on a deferred delete + // once the close it arranges for has been accepted + QVERIFY2(waitFor([&pMainWindow]() { + return pMainWindow.isNull(); + }), + "closeMudlet() left the main window standing"); + QVERIFY2(pFirstHost.isNull(), "closeMudlet() left a profile loaded"); + QVERIFY2(pSecondHost.isNull(), "closeMudlet() closed one profile but not the other"); + } +}; + +void initializeQRCResourcesForProfileLifecycleTest() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +#include "ProfileLifecycleTest.moc" +QTEST_MAIN(ProfileLifecycleTest) From e42bd1e2853257b3502ef14c08213f82d7193c71 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Tue, 11 Aug 2026 08:08:50 +0200 Subject: [PATCH 150/155] infrastructure: Add tests for the core and misc Lua functions that had none (#9802) #### Brief overview of PR changes/additions - 139 new busted specs (Miscallaneous_spec +126, Package_spec +13) for the last core and misc Lua functions with no test presence at all: the profile description/icon/stats/list accessors, time, process and encoding info, logging, file watches, the user dictionary and spell checking, `unzipAsync`, `loadReplay`, `findItems`, `insertHTML`, `send`, `denyCurrentSend`, `isAncestorsActive`, `raiseGlobalEvent` and the verbose-install / drag-and-drop package helpers. - Contract plus effect wherever the effect can be seen offline - the file that was written, the event that was raised, the line that reached the console - with no mocking. The functions that reach a browser, the tray, a modal dialog or the keyboard get their refusals covered instead, which is all that can be driven headlessly. - Six bugs turned up while writing them. None is specced: five are marked `pending` with the reason so they light up when fixed. #### Motivation for adding to Mudlet Wave 4 of the Lua API test coverage program. Nothing in the suite touched these functions, so a regression in any of them was invisible. #### Other info (issues closed, discussion etc) Bugs found, all left unspecced: - `setSaveCommandHistory()` and `setSaveCommandHistory(name)` raise instead of turning saving on; both count their arguments one too high, and the branch that would read the boolean after a name is unreachable. - `setProfileInformation` and `clearProfileInformation` for a profile that does not exist return true and create the folder, so a phantom profile appears in the connection dialog and in `getProfiles()`. - `raiseGlobalEvent` refuses an unsupported argument with `lua_error()` after building the event, which longjmps past the event's destructor and leaks it. - `insertHTML` hands its text straight to `insertText`, so the markup its name and the wiki promise is printed literally. - `verbosePackageInstall` strips the profile folder off the announced name using that folder as a Lua pattern, so a profile path holding a `-` gets the whole path announced. **Test case:** full busted suite 2544 passed / 0 failed / 136 pending - green on a fresh profile, again on that same profile, and once more on another fresh one (+2.5s of runtime); 97 of the 139 new specs were each shown to fail against a matching sabotage of the C++ or Lua behaviour, which was then reverted. Assisted-by: Claude:claude-opus-5 --- src/mudlet-lua/tests/Miscallaneous_spec.lua | 1437 +++++++++++++++++++ src/mudlet-lua/tests/Package_spec.lua | 254 ++++ 2 files changed, 1691 insertions(+) diff --git a/src/mudlet-lua/tests/Miscallaneous_spec.lua b/src/mudlet-lua/tests/Miscallaneous_spec.lua index 6278bc677..cf45d219b 100644 --- a/src/mudlet-lua/tests/Miscallaneous_spec.lua +++ b/src/mudlet-lua/tests/Miscallaneous_spec.lua @@ -1,3 +1,84 @@ +-- Everything here drives the real API: no mocking, and each function gets both +-- what it answers (including when it is misused) and, where it can be reached +-- offline, what it actually did - the file it wrote, the event it raised, the +-- line it put on screen. +-- +-- Console readback goes through textFrom()/wrapped(): the main console wraps +-- long lines, and a wrap swallows the space it broke at, so the text is +-- compared with all whitespace removed rather than line by line. + +local function contains(haystack, needle) + return type(haystack) == "string" and haystack:find(needle, 1, true) ~= nil +end + +-- Asserts that calling fn raises a Lua error whose message contains needle. +-- Matching a message substring (rather than merely "did it error?") ensures the +-- function is actually registered and reached its own argument validation: an +-- unregistered/nil function would raise a different "attempt to call" error. +local function assertArgError(fn, needle) + local ok, err = pcall(fn) + assert.is_false(ok) + assert.is_true(contains(err, needle), tostring(err)) +end + +-- Everything the main console gained since it was at line `mark`, joined up. +local function textFrom(mark) + return table.concat(getLines("main", mark, getLastLineNumber("main") + 1), "") +end + +local function wrapped(text) + return (tostring(text):gsub("%s+", "")) +end + +local function containsWrapped(haystack, needle) + return contains(wrapped(haystack), wrapped(needle)) +end + +local function fileExists(path) + return lfs.attributes(path, "mode") ~= nil +end + +local function readFile(path) + local handle = io.open(path, "rb") + if not handle then + return nil + end + local contents = handle:read("*a") + handle:close() + return contents +end + +local function writeFile(path, contents) + local handle = io.open(path, "wb") + assert.is_not_nil(handle, "could not write to " .. path) + handle:write(contents) + handle:close() +end + +-- Takes a copy of the encoding in use, to be put back once a spec has changed +-- it. setServerEncoding() also writes the profile's "encoding" file, and a +-- profile that never had one must not be left with one. +local function restoreServerEncoding() + local encodingFile = getMudletHomeDir() .. "/encoding" + local hadFile = fileExists(encodingFile) + local original = getServerEncoding() + return function() + setServerEncoding(original) + if not hadFile then + os.remove(encodingFile) + end + end +end + +local specDirectory = debug.getinfo(1, "S").source:match("^@(.*)[/\\]") +assert(specDirectory, "Miscallaneous_spec.lua has to be run from a file so that it can find its fixtures") +local fixtureDirectory = specDirectory .. "/fixtures/packages" + +-- waitForEvent() and pumpEvents() answer nil and a message outside test mode, +-- so the specs that need an event to arrive say so instead of failing on a +-- developer's interactive run. +local testMode = os.getenv("MUDLET_TEST_MODE") + describe("Tests C++ functions in the Miscallaneous category", function() describe("Tests the functionality of sendMSDP", function() it("should return nil and an error message when MSDP cannot be sent", function() @@ -94,4 +175,1360 @@ describe("Tests C++ functions in the Miscallaneous category", function() end) end) + describe("Tests the functionality of getCommandSeparator", function() + it("returns the separator the profile splits commands on", function() + assert.equals(";;", getCommandSeparator()) + end) + + it("returns the separator that actually splits a command", function() + local fired = {} + local first = tempAlias("^mudletSpecSeparatorA$", function() fired[#fired + 1] = "A" end) + local second = tempAlias("^mudletSpecSeparatorB$", function() fired[#fired + 1] = "B" end) + finally(function() + killAlias(tostring(first)) + killAlias(tostring(second)) + end) + + expandAlias("mudletSpecSeparatorA" .. getCommandSeparator() .. "mudletSpecSeparatorB", false) + + assert.same({"A", "B"}, fired) + end) + end) + + describe("Tests the functionality of getTime", function() + it("raises a Lua error when the first argument is not a boolean", function() + assertArgError(function() getTime("yes") end, "getTime: bad argument #1 type") + end) + + it("raises a Lua error when the format is not a string", function() + assertArgError(function() getTime(true, {}) end, "getTime: bad argument #2 type") + end) + + it("returns the time as a string in the documented default format", function() + local time = getTime(true) + assert.is_string(time) + assert.is_truthy(time:match("^%d%d%d%d%.%d%d%.%d%d %d%d:%d%d:%d%d%.%d%d%d$"), time) + end) + + it("honours a custom format", function() + assert.equals(getTime(true, "yyyy"), tostring(getTime().year)) + assert.is_truthy(getTime(true, "hh:mm"):match("^%d%d:%d%d$")) + end) + + it("returns a table of the parts when not asked for a string", function() + local time = getTime() + assert.is_table(time) + for _, field in ipairs({"year", "month", "day", "hour", "min", "sec", "msec"}) do + assert.is_number(time[field], field .. " is missing") + end + assert.is_true(time.month >= 1 and time.month <= 12) + assert.is_true(time.day >= 1 and time.day <= 31) + assert.is_true(time.hour >= 0 and time.hour <= 23) + assert.is_true(time.min >= 0 and time.min <= 59) + assert.is_true(time.sec >= 0 and time.sec <= 60) + assert.is_true(time.msec >= 0 and time.msec <= 999) + end) + + it("returns the same date in both forms", function() + -- each call reads the clock afresh, so a run that steps over midnight + -- between the two would see different dates: the table form is read + -- between two string forms and has to match one of them + local before = getTime(true, "yyyy-MM-dd") + local asTable = getTime() + local after = getTime(true, "yyyy-MM-dd") + + local asDate = string.format("%04d-%02d-%02d", asTable.year, asTable.month, asTable.day) + assert.is_true(asDate == before or asDate == after, asDate .. " is neither " .. before .. " nor " .. after) + end) + end) + + describe("Tests the functionality of getProcessID", function() + it("returns this process's own id", function() + local pid = getProcessID() + assert.is_number(pid) + assert.equals(math.floor(pid), pid) + assert.equals(pid, getProcessID()) + if getOS() == "linux" then + -- the number is only worth anything if the operating system agrees + -- that it is this process + assert.equals("directory", lfs.attributes("/proc/" .. pid, "mode")) + else + assert.is_true(pid > 0) + end + end) + end) + + describe("Tests the functionality of getServerEncodingsList", function() + it("lists ASCII first and then every encoding Mudlet can be switched to", function() + local encodings = getServerEncodingsList() + assert.is_table(encodings) + assert.equals("ASCII", encodings[1]) + assert.is_true(#encodings > 1) + + local seen = {} + for _, encoding in ipairs(encodings) do + assert.is_string(encoding) + -- the "M_" prefix marks Mudlet's own codecs and is not part of the + -- name the rest of the API uses + assert.is_nil(encoding:find("^M_"), encoding .. " leaked its internal prefix") + assert.is_nil(seen[encoding], encoding .. " is listed twice") + seen[encoding] = true + end + assert.is_true(seen[getServerEncoding()], "the encoding in use is not in the list") + end) + + it("names every encoding in the form setServerEncoding accepts", function() + finally(restoreServerEncoding()) + + for _, encoding in ipairs(getServerEncodingsList()) do + assert.is_true(setServerEncoding(encoding), "the list offered " .. encoding .. " but setServerEncoding refused it") + assert.equals(encoding, getServerEncoding()) + end + end) + end) + + describe("Tests the functionality of getMudletInfo", function() + it("returns nothing and reports the encodings on the main console", function() + local mark = getLastLineNumber("main") + + assert.equals(0, select('#', getMudletInfo())) + + local text = textFrom(mark) + -- a profile that has not been switched to a real encoding reports the + -- ASCII it falls back to in quotes + local encoding = getServerEncoding() + local reported = containsWrapped(text, "Current encoding: " .. encoding) or containsWrapped(text, 'Current encoding: "' .. encoding .. '"') + assert.is_true(reported, text) + assert.is_true(containsWrapped(text, "Available encodings:"), text) + for _, encoding in ipairs(getServerEncodingsList()) do + assert.is_true(containsWrapped(text, encoding), encoding .. " was not reported") + end + end) + end) + + describe("Tests the functionality of getWindowsCodepage", function() + it("only answers on Windows", function() + local codepage, err = getWindowsCodepage() + if getOS() == "windows" then + assert.is_string(codepage) + assert.is_nil(err) + return + end + assert.is_nil(codepage) + assert.is_true(contains(err, "only needed on Windows"), tostring(err)) + end) + end) + + describe("Tests the functionality of getCharacterName", function() + it("returns nil+msg while no character name is set", function() + local name, err = getCharacterName() + if name ~= nil then + -- a profile that has a login set answers with it instead + assert.is_string(name) + assert.is_true(#name > 0) + return + end + assert.equals("no character name set", err) + end) + end) + + describe("Tests the profile description accessors", function() + -- The description is profile data on disk, so every spec here puts back + -- what it found: the self-test profile is reused between runs. + local descriptionFile = getMudletHomeDir() .. "/description" + + local function restoreDescription() + local original = getProfileInformation() + -- a profile that has never had a description has no file for one, and + -- writing the empty string back would leave one behind + local hadFile = fileExists(descriptionFile) + return function() + setProfileInformation(original) + if not hadFile then + os.remove(descriptionFile) + end + end + end + + describe("Tests the functionality of getProfileInformation", function() + it("raises a Lua error when the profile name is not a string", function() + assertArgError(function() getProfileInformation({}) end, "getProfileInformation: bad argument #1 type") + end) + + it("returns nil+msg for an empty profile name", function() + local info, err = getProfileInformation("") + assert.is_nil(info) + assert.equals("getProfileInformation: profile name cannot be empty", err) + end) + + it("returns nil+msg for a profile that does not exist", function() + local info, err = getProfileInformation("mudlet-spec-never-a-profile") + assert.is_nil(info) + assert.is_true(contains(err, "does not exist"), tostring(err)) + end) + + it("returns a string for this profile", function() + assert.is_string(getProfileInformation()) + assert.equals(getProfileInformation(), getProfileInformation(getProfileName())) + end) + end) + + describe("Tests the functionality of setProfileInformation", function() + it("raises a Lua error when called with no arguments", function() + assertArgError(function() setProfileInformation() end, "setProfileInformation: bad argument #1 type") + end) + + it("raises a Lua error when the two argument form has no text", function() + assertArgError(function() setProfileInformation(getProfileName(), {}) end, "setProfileInformation: bad argument #2 type") + end) + + it("round-trips a description through getProfileInformation", function() + finally(restoreDescription()) + + assert.is_true(setProfileInformation("set by the Miscallaneous specs")) + assert.equals("set by the Miscallaneous specs", getProfileInformation()) + assert.equals("set by the Miscallaneous specs", getProfileInformation(getProfileName())) + end) + + it("round-trips a description named by profile", function() + finally(restoreDescription()) + + assert.is_true(setProfileInformation(getProfileName(), "named form")) + assert.equals("named form", getProfileInformation()) + end) + + it("is what getProfiles reports as the description", function() + finally(restoreDescription()) + setProfileInformation("as seen by getProfiles") + + assert.equals("as seen by getProfiles", getProfiles()[getProfileName()].description) + end) + + it("refuses a profile that does not exist", function() + -- BUG: writeProfileData() creates the profile folder it is given, so + -- naming a profile that is not there makes one, description file and + -- all - a phantom that the connection dialog and getProfiles() then + -- both list. Left pending rather than pinning it as correct. + pending("setProfileInformation() creates a folder for a profile that does not exist") + local ok, err = setProfileInformation("mudlet-spec-never-a-profile", "text") + assert.is_false(ok) + assert.is_string(err) + end) + end) + + describe("Tests the functionality of clearProfileInformation", function() + it("raises a Lua error when the profile name is not a string", function() + assertArgError(function() clearProfileInformation({}) end, "clearProfileInformation: bad argument #1 type") + end) + + it("refuses a profile that does not exist", function() + -- BUG: the same as setProfileInformation's - the write creates the + -- folder it was told to write into, so clearing the description of a + -- profile that is not there conjures one up. + pending("clearProfileInformation() creates a folder for a profile that does not exist") + local ok, err = clearProfileInformation("mudlet-spec-never-a-profile") + assert.is_false(ok) + assert.is_string(err) + end) + + it("puts back the description a bundled game ships with", function() + finally(restoreDescription()) + setProfileInformation("something else entirely") + + assert.is_true(clearProfileInformation()) + + -- the self-test profile is one of Mudlet's own games, so clearing + -- restores its built-in blurb rather than emptying the description + local restored = getProfileInformation() + assert.is_string(restored) + assert.are_not.equals("something else entirely", restored) + assert.is_true(contains(restored, "Busted"), restored) + end) + end) + end) + + describe("Tests the command history saving accessors", function() + describe("Tests the functionality of getSaveCommandHistory", function() + it("returns nil+msg for a command line that does not exist", function() + local saving, err = getSaveCommandHistory("mudlet-spec-no-such-command-line") + assert.is_nil(saving) + assert.is_true(contains(err, "not found"), tostring(err)) + end) + + it("answers for the main command line when not told which one", function() + local saving, message = getSaveCommandHistory() + assert.is_boolean(saving) + assert.is_string(message) + -- the name it defaults to is what makes the two forms the same call, + -- so the state is set through the named form and read back through both + finally(function() setSaveCommandHistory("main", saving) end) + assert.is_true(setSaveCommandHistory("main", not saving)) + assert.equals(not saving, (getSaveCommandHistory())) + assert.equals(not saving, (getSaveCommandHistory("main"))) + end) + end) + + describe("Tests the functionality of setSaveCommandHistory", function() + it("raises a Lua error when the argument is neither a name nor a boolean", function() + assertArgError(function() setSaveCommandHistory(5) end, "setSaveCommandHistory: bad argument #1 type") + end) + + it("turns saving on when told which command line, or none at all, but not whether to", function() + -- BUG: both forms are meant to default to turning saving on - the + -- implementation says so, and the branch that would read a second + -- argument after a name is unreachable without one. Both count their + -- arguments one too high, so they reach the type check and raise + -- instead. Left pending rather than pinning the raise as the contract. + pending("setSaveCommandHistory() and setSaveCommandHistory(name) raise instead of turning saving on") + local original = getSaveCommandHistory() + finally(function() setSaveCommandHistory(original) end) + setSaveCommandHistory(false) + + assert.is_true(setSaveCommandHistory()) + assert.is_true((getSaveCommandHistory())) + + setSaveCommandHistory(false) + assert.is_true(setSaveCommandHistory("main")) + assert.is_true((getSaveCommandHistory())) + end) + + it("round-trips through getSaveCommandHistory", function() + local original = getSaveCommandHistory() + finally(function() setSaveCommandHistory(original) end) + + assert.is_true(setSaveCommandHistory(false)) + assert.is_false((getSaveCommandHistory())) + assert.equals("disabled", (select(2, getSaveCommandHistory()))) + + assert.is_true(setSaveCommandHistory("main", true)) + local saving, message = getSaveCommandHistory("main") + assert.is_true(saving) + assert.equals("enabled (" .. getConfig("commandLineHistorySaveSize") .. " lines will be saved)", message) + end) + + it("is refused, and the getter reports off, while the profile has history saving turned off", function() + local savedLines = getConfig("commandLineHistorySaveSize") + finally(function() setConfig("commandLineHistorySaveSize", savedLines) end) + + setConfig("commandLineHistorySaveSize", 0) + + local saving, getterMessage = getSaveCommandHistory() + assert.is_false(saving) + assert.equals("disabled by profile global preference", getterMessage) + + local ok, setterMessage = setSaveCommandHistory(true) + assert.is_nil(ok) + assert.equals("disabled by profile global preference", setterMessage) + end) + end) + end) + + describe("Tests the logging functions", function() + describe("Tests the functionality of startLogging", function() + it("raises a Lua error when called with no arguments", function() + assertArgError(function() startLogging() end, "startLogging: bad argument #1 type") + end) + + it("starts and stops logging, reporting the file it uses", function() + local logPath + finally(function() + startLogging(false) + if logPath then + os.remove(logPath) + end + end) + + local started, startMessage, startPath, startState = startLogging(true) + logPath = startPath + assert.is_true(started) + assert.is_string(startPath) + assert.equals(1, startState) + assert.is_true(contains(startMessage, startPath), startMessage) + assert.is_true(fileExists(startPath), "no log file was created") + + echo("mudlet-spec-logged-line\n") + + local stopped, stopMessage, stopPath, stopState = startLogging(false) + assert.is_true(stopped) + assert.equals(startPath, stopPath) + assert.equals(0, stopState) + assert.is_true(contains(stopMessage, "stopped being logged"), stopMessage) + -- the line logged most recently is held back for duplicate detection + -- and only written out when logging stops, so read the file after + assert.is_true(contains(readFile(startPath), "mudlet-spec-logged-line"), "the console output did not reach the log") + end) + + it("reports, rather than repeats, a state it is already in", function() + local logPath + finally(function() + startLogging(false) + if logPath then + os.remove(logPath) + end + end) + + local alreadyOff, offMessage, offPath, offState = startLogging(false) + assert.is_nil(alreadyOff) + assert.equals("Main console output was already not being logged to a file.", offMessage) + assert.is_nil(offPath) + assert.equals(-2, offState) + + logPath = select(3, startLogging(true)) + local alreadyOn, onMessage, onPath, onState = startLogging(true) + assert.is_nil(alreadyOn) + assert.equals(logPath, onPath) + assert.equals(-1, onState) + assert.is_true(contains(onMessage, "already being logged"), onMessage) + end) + end) + + describe("Tests the functionality of appendLog", function() + it("raises a Lua error when called with no arguments", function() + assertArgError(function() appendLog() end, "appendLog: bad argument #1 type") + end) + + it("writes the text into the log file", function() + local logPath + finally(function() + startLogging(false) + if logPath then + os.remove(logPath) + end + end) + logPath = select(3, startLogging(true)) + + appendLog("mudlet-spec-appended-line") + + -- read only once logging has stopped: the log stream is buffered + startLogging(false) + local contents = readFile(logPath) + assert.is_string(contents) + assert.is_true(contains(contents, "mudlet-spec-appended-line"), "the appended text is not in the log") + end) + + it("writes nothing while logging is off", function() + local logPath + finally(function() + startLogging(false) + if logPath then + os.remove(logPath) + end + end) + logPath = select(3, startLogging(true)) + startLogging(false) + + assert.equals(0, select('#', appendLog("mudlet-spec-never-logged"))) + + local contents = readFile(logPath) + assert.is_string(contents, "the log file that was closed is not readable") + assert.is_false(contains(contents, "mudlet-spec-never-logged"), "the text was appended to a log that was closed") + end) + end) + end) + + describe("Tests the file watching functions", function() + local watchedFile = getMudletHomeDir() .. "/mudlet-spec-watched.txt" + + describe("Tests the functionality of addFileWatch", function() + it("raises a Lua error when called with no arguments", function() + assertArgError(function() addFileWatch() end, "addFileWatch: bad argument #1 type") + end) + + it("returns nil+msg for a path that is not there", function() + local ok, err = addFileWatch(getMudletHomeDir() .. "/mudlet-spec-no-such-path") + assert.is_nil(ok) + assert.is_true(contains(err, "does not exist"), tostring(err)) + end) + end) + + describe("Tests the functionality of removeFileWatch", function() + it("raises a Lua error when called with no arguments", function() + assertArgError(function() removeFileWatch() end, "removeFileWatch: bad argument #1 type") + end) + + it("returns false for a path nobody is watching", function() + assert.is_false(removeFileWatch(getMudletHomeDir() .. "/mudlet-spec-no-such-path")) + end) + end) + + describe("Tests watching a file for changes", function() + it("watches a file that is there, and stops when told to", function() + -- adding and removing a watch needs no events, so unlike the spec + -- below this one runs outside test mode too + finally(function() os.remove(watchedFile) end) + writeFile(watchedFile, "first\n") + + assert.is_true(addFileWatch(watchedFile)) + + assert.is_true(removeFileWatch(watchedFile)) + assert.is_false(removeFileWatch(watchedFile), "the watch was removed twice") + end) + + it("raises sysPathChanged until the watch is removed", function() + if not testMode then + pending("waiting for sysPathChanged needs MUDLET_TEST_MODE") + return + end + finally(function() + removeFileWatch(watchedFile) + os.remove(watchedFile) + end) + writeFile(watchedFile, "first\n") + + assert.is_true(addFileWatch(watchedFile)) + -- Windows works out that a file changed by comparing its modification + -- time against the one noted when the watch was added - the contents + -- and the size are not looked at - and that stamp only moves as fast + -- as the system clock ticks, about every 16ms. Rewriting the file in + -- the same tick would be invisible there, so leave the stamp room to + -- move before writing again. + pumpEvents(250) + writeFile(watchedFile, "second\n") + local event, path = waitForEvent("sysPathChanged", 5000) + assert.equals("sysPathChanged", event) + -- the watcher can report the path with the platform's own separators + assert.equals(watchedFile, (tostring(path):gsub("\\", "/"))) + + -- one write can produce more than one notification, so let the rest of + -- them arrive before the watch goes away: a straggler would otherwise + -- look like the removed watch still reporting + pumpEvents(250) + assert.is_true(removeFileWatch(watchedFile)) + writeFile(watchedFile, "third\n") + -- a watch that has been taken away must not report anything further, + -- so this one is meant to time out + assert.is_nil((waitForEvent("sysPathChanged", 750))) + end) + end) + end) + + describe("Tests the dictionary functions", function() + -- The words go into the profile's own dictionary file, which outlives the + -- run, so every spec takes back out what it put in. + local function withWords(...) + local words = {...} + finally(function() + for _, word in ipairs(words) do + removeWordFromDictionary(word) + end + end) + for _, word in ipairs(words) do + assert.is_true(addWordToDictionary(word), "could not add " .. word) + end + end + + local function indexOf(list, word) + for index, entry in ipairs(list) do + if entry == word then + return index + end + end + end + + describe("Tests the functionality of addWordToDictionary", function() + it("raises a Lua error when called with no arguments", function() + assertArgError(function() addWordToDictionary() end, "addWordToDictionary: bad argument #1 type") + end) + + it("adds a word that getDictionaryWordList then lists", function() + withWords("mudletspecwibble") + + assert.is_not_nil(indexOf(getDictionaryWordList(), "mudletspecwibble")) + end) + + it("returns nil+msg for a word that is already there", function() + withWords("mudletspecwibble") + + local ok, err = addWordToDictionary("mudletspecwibble") + assert.is_nil(ok) + assert.is_true(contains(err, "already seems to be in the user dictionary"), tostring(err)) + end) + end) + + describe("Tests the functionality of removeWordFromDictionary", function() + it("raises a Lua error when called with no arguments", function() + assertArgError(function() removeWordFromDictionary() end, "removeWordFromDictionary: bad argument #1 type") + end) + + it("takes the word back out of the list", function() + withWords("mudletspecwibble") + assert.is_not_nil(indexOf(getDictionaryWordList(), "mudletspecwibble")) + + assert.is_true(removeWordFromDictionary("mudletspecwibble")) + + assert.is_nil(indexOf(getDictionaryWordList(), "mudletspecwibble")) + end) + + it("returns nil+msg for a word that was never added", function() + local ok, err = removeWordFromDictionary("mudletspecnosuchword") + assert.is_nil(ok) + assert.is_true(contains(err, "does not seem to be in the user dictionary"), tostring(err)) + end) + end) + + describe("Tests the functionality of getDictionaryWordList", function() + it("returns the words sorted", function() + withWords("mudletspeczebra", "mudletspecapple") + + local words = getDictionaryWordList() + assert.is_table(words) + local apple = indexOf(words, "mudletspecapple") + local zebra = indexOf(words, "mudletspeczebra") + assert.is_not_nil(apple) + assert.is_not_nil(zebra) + assert.is_true(apple < zebra, "the word list came back unsorted") + end) + end) + + describe("Tests the functionality of spellCheckWord", function() + it("raises a Lua error when called with no arguments", function() + assertArgError(function() spellCheckWord() end, "spellCheckWord: bad argument #1 type") + end) + + it("raises a Lua error when the dictionary choice is not a boolean", function() + assertArgError(function() spellCheckWord("word", "user") end, "spellCheckWord: bad argument #2 type") + end) + + it("knows a word that was added to the profile dictionary, and not one that was not", function() + withWords("mudletspecwibble") + + assert.is_true(spellCheckWord("mudletspecwibble", true)) + assert.is_false(spellCheckWord("mudletspecwobble", true)) + end) + + it("answers from the system dictionary, or says it has none", function() + local known, err = spellCheckWord("hello") + if known == nil then + assert.is_true(contains(err, "no main dictionaries found"), tostring(err)) + return + end + assert.is_boolean(known) + -- which words a system dictionary knows depends on the language it is + -- for, so the only answer worth asserting is for something no language + -- spells that way + assert.is_false(spellCheckWord("mudletspecqqzzxxvv")) + end) + end) + + describe("Tests the functionality of spellSuggestWord", function() + it("raises a Lua error when called with no arguments", function() + assertArgError(function() spellSuggestWord() end, "spellSuggestWord: bad argument #1 type") + end) + + it("raises a Lua error when the dictionary choice is not a boolean", function() + assertArgError(function() spellSuggestWord("word", "user") end, "spellSuggestWord: bad argument #2 type") + end) + + it("suggests a word the profile dictionary knows", function() + withWords("mudletspecwibble") + + local suggestions = spellSuggestWord("mudletspecwobble", true) + assert.is_table(suggestions) + assert.is_not_nil(indexOf(suggestions, "mudletspecwibble"), "the added word was not suggested") + end) + + it("returns a table from the system dictionary, or says it has none", function() + local suggestions, err = spellSuggestWord("helo") + if suggestions == nil then + assert.is_true(contains(err, "no main dictionaries found"), tostring(err)) + return + end + assert.is_table(suggestions) + for index, suggestion in ipairs(suggestions) do + assert.is_string(suggestion, "suggestion " .. index .. " is not a word") + assert.is_true(#suggestion > 0, "suggestion " .. index .. " is empty") + end + end) + end) + end) + + describe("Tests the functionality of unzipAsync", function() + local extractDirectory = getMudletHomeDir() .. "/mudlet-spec-unzipped" + + local function removeExtractDirectory() + if fileExists(extractDirectory .. "/readme.txt") then + os.remove(extractDirectory .. "/readme.txt") + end + lfs.rmdir(extractDirectory) + end + + it("raises a Lua error when called with no arguments", function() + assertArgError(function() unzipAsync() end, "unzipAsync: bad argument #1 type") + end) + + it("raises a Lua error when given no place to extract to", function() + assertArgError(function() unzipAsync("archive.zip") end, "unzipAsync: bad argument #2 type") + end) + + it("extracts the archive and raises sysUnzipDone", function() + if not testMode then + pending("waiting for sysUnzipDone needs MUDLET_TEST_MODE") + return + end + finally(removeExtractDirectory) + local archive = fixtureDirectory .. "/mudlet-spec-emptyarchive.mpackage" + + assert.is_true(unzipAsync(archive, extractDirectory)) + + local event, zipLocation, extractLocation = waitForEvent("sysUnzipDone", 10000) + assert.equals("sysUnzipDone", event) + assert.equals(archive, zipLocation) + -- the extract location comes back with the trailing separator the + -- function adds, whether or not the caller gave one + assert.equals(extractDirectory .. "/", extractLocation) + assert.is_true(fileExists(extractDirectory .. "/readme.txt"), "the archive was not unpacked") + end) + + it("raises sysUnzipError for a file that is not an archive", function() + if not testMode then + pending("waiting for sysUnzipError needs MUDLET_TEST_MODE") + return + end + finally(removeExtractDirectory) + local notAnArchive = fixtureDirectory .. "/mudlet-spec-notazip.mpackage" + + -- the call itself cannot tell: unzipping happens on another thread, so + -- it answers true and reports the failure through the event + assert.is_true(unzipAsync(notAnArchive, extractDirectory)) + + local event, zipLocation = waitForEvent("sysUnzipError", 10000) + assert.equals("sysUnzipError", event) + assert.equals(notAnArchive, zipLocation) + assert.is_false(fileExists(extractDirectory .. "/readme.txt")) + end) + end) + + describe("Tests the functionality of loadReplay", function() + -- A replay file is a run of (offset, length, bytes) records written by + -- QDataStream, which is big-endian, so one can be built here rather than + -- committed as a binary fixture. + local function bigEndian32(value) + return string.char(math.floor(value / 16777216) % 256, math.floor(value / 65536) % 256, math.floor(value / 256) % 256, value % 256) + end + + local function writeReplay(path, payload) + writeFile(path, bigEndian32(0) .. bigEndian32(#payload) .. payload) + end + + it("raises a Lua error when called with no arguments", function() + assertArgError(function() loadReplay() end, "loadReplay: bad argument #1 type") + end) + + it("returns nil+msg for a blank file name", function() + local ok, err = loadReplay("") + assert.is_nil(ok) + assert.equals("a blank string is not a valid replay file name", err) + end) + + it("returns nil+msg for a file that is not there", function() + local ok, err = loadReplay(getMudletHomeDir() .. "/mudlet-spec-no-such-replay.dat") + assert.is_nil(ok) + assert.is_true(contains(err, "Cannot read file"), tostring(err)) + end) + + it("returns nil+msg for a file that is not a replay", function() + local corrupt = getMudletHomeDir() .. "/mudlet-spec-corrupt-replay.dat" + finally(function() os.remove(corrupt) end) + writeFile(corrupt, "this is not a replay") + + local ok, err = loadReplay(corrupt) + assert.is_nil(ok) + assert.is_true(contains(err, "replay file seems to be corrupt"), tostring(err)) + end) + + it("plays the recorded bytes back into the main console", function() + if not testMode then + pending("letting the replay timer run needs MUDLET_TEST_MODE") + return + end + local replay = getMudletHomeDir() .. "/mudlet-spec-replay.dat" + finally(function() os.remove(replay) end) + writeReplay(replay, "mudlet-spec-replayed-line\r\n") + local mark = getLastLineNumber("main") + + assert.is_true(loadReplay(replay)) + + local arrived = false + for _ = 1, 40 do + pumpEvents(50) + arrived = contains(textFrom(mark), "mudlet-spec-replayed-line") + if arrived then + break + end + end + assert.is_true(arrived, "the replay did not reach the console") + -- whether a replay is running is application-wide, so let this one run + -- out before the next spec asks for one + pumpEvents(200) + end) + end) + + describe("Tests the functionality of findItems", function() + -- Named items can only be made permanently, and a permanent item cannot + -- be removed again from Lua, so the name matching below is checked + -- against the nested triggers the run-tests package (the one running + -- these specs) ships: "Test selectCaptureGroup with nested hierarchy" > + -- "Filter" > "Not Filter" > "Trigger". + local function ids(...) + local found = findItems(...) + assert.is_table(found) + table.sort(found) + return found + end + + local function joined(list) + return table.concat(list, ",") + end + + it("raises a Lua error when called with no arguments", function() + assertArgError(function() findItems() end, "findItems: bad argument #1 type") + end) + + it("raises a Lua error when given no item type", function() + assertArgError(function() findItems("name") end, "findItems: bad argument #2 type") + end) + + it("returns nil+msg for an item type it does not know", function() + local ok, err = findItems("name", "sandwich") + assert.is_nil(ok) + assert.is_true(contains(err, "invalid item type 'sandwich' given"), tostring(err)) + end) + + it("returns an empty table when nothing matches", function() + assert.same({}, findItems("mudletSpecNeverAnItem", "alias")) + assert.same({}, findItems("mudletSpecNeverAnItem", "trigger")) + end) + + it("returns the id of a temporary item, which is named after that id", function() + local aliasId = tempAlias("^mudletSpecFindAlias$", function() end) + local triggerId = tempTrigger("mudletSpecFindTrigger", function() end) + finally(function() + killAlias(tostring(aliasId)) + killTrigger(tostring(triggerId)) + end) + + assert.same({aliasId}, findItems(tostring(aliasId), "alias")) + assert.same({triggerId}, findItems(tostring(triggerId), "trigger")) + end) + + it("finds items of every kind it accepts", function() + for _, itemType in ipairs({"timer", "trigger", "alias", "keybind", "button", "script"}) do + assert.is_table(findItems("mudletSpecNeverAnItem", itemType), itemType .. " was not accepted") + end + -- the harness's own scripts are the ones that are always there + assert.is_true(#findItems("test scripts", "script") > 0, "the run-tests package's scripts are not installed") + end) + + it("matches by exactly the name it was given", function() + local exact = ids("Filter", "trigger") + assert.is_true(#exact > 0, "the run-tests package's nested triggers are not installed") + assert.same({}, findItems("ilte", "trigger")) + end) + + it("matches part of a name when not asked for an exact match", function() + local exact = ids("Filter", "trigger") + local notFilter = ids("Not Filter", "trigger") + assert.is_true(#notFilter > 0) + + local partial = ids("Filter", "trigger", false) + + -- "Not Filter" only shows up once an exact match is no longer required + assert.is_true(#partial > #exact, joined(partial)) + for _, id in ipairs(notFilter) do + assert.is_truthy(table.contains(partial, id), "the partial match missed " .. id) + end + end) + + it("ignores case when asked to", function() + local exact = ids("Filter", "trigger") + + assert.same({}, findItems("FILTER", "trigger")) + assert.same(exact, ids("FILTER", "trigger", true, false)) + end) + end) + + describe("Tests the functionality of insertHTML", function() + it("raises a Lua error when called with no arguments", function() + assertArgError(function() insertHTML() end, "insertHTML: bad argument #1 type") + end) + + it("inserts the text at the cursor", function() + finally(function() moveCursorEnd() end) + echo("mudlet-spec-insert-target\n") + moveCursor(0, getLastLineNumber("main") - 1) + + assert.equals(0, select('#', insertHTML("mudlet-spec-inserted"))) + + assert.equals("mudlet-spec-insertedmudlet-spec-insert-target", getCurrentLine()) + end) + + it("renders the markup it is given", function() + -- BUG: insertHTML() hands the text straight to insertText(), so the + -- markup its name and the wiki both promise is put on the line as + -- literal characters. Left pending rather than pinning that as the + -- contract. + pending("insertHTML() does not interpret HTML, it is an alias for insertText") + finally(function() moveCursorEnd() end) + echo("mudlet-spec-html-target\n") + moveCursor(0, getLastLineNumber("main") - 1) + + insertHTML("<b>mudlet-spec-bold</b>") + + assert.equals("mudlet-spec-boldmudlet-spec-html-target", getCurrentLine()) + end) + end) + + describe("Tests the functionality of setMergeTables", function() + it("raises a Lua error when a module is not a string", function() + assertArgError(function() setMergeTables({}) end, "setMergeTables: bad argument #1 type") + end) + + it("raises a Lua error naming the argument that is wrong", function() + assertArgError(function() setMergeTables("MudletSpec.NeverAModule", {}) end, "setMergeTables: bad argument #2 type") + end) + + it("returns nothing for any number of modules, including none", function() + -- keys can be registered but never taken off again, so these are names + -- no game will ever send rather than the real Char.* ones + assert.equals(0, select('#', setMergeTables())) + assert.equals(0, select('#', setMergeTables("MudletSpec.NeverAModule"))) + assert.equals(0, select('#', setMergeTables("MudletSpec.NeverAModule", "MudletSpec.NeverAnother"))) + end) + + it("merges the keys it was given into an incoming GMCP table", function() + -- The merge only happens as GMCP or MSDP arrives from a server, and + -- the self-test profile's socket is never in the unconnected state that + -- feedTelnet() needs, so there is no way to deliver one from Lua. + pending("delivering GMCP to the profile needs a server connection") + end) + end) + + describe("Tests the functionality of send", function() + -- send() is registered from the C++ sendRaw(), which is the name its own + -- error messages use. + it("raises a Lua error when called with no arguments", function() + assertArgError(function() send() end, "sendRaw: bad argument #1 type") + end) + + it("raises a Lua error when whether to show the command is not a boolean", function() + assertArgError(function() send("mudletSpecSend", "yes") end, "sendRaw: bad argument #2 type") + end) + + it("shows the command on the main console, unless told not to", function() + -- whether the argument is listened to at all is the profile's to decide: + -- the other two modes show every command, or none + local originalMode = getConfig("showSentText", true) + finally(function() setConfig("showSentText", originalMode) end) + assert.is_true(setConfig("showSentText", "script")) + local mark = getLastLineNumber("main") + + assert.is_true(send("mudletSpecShownCommand", true)) + + assert.is_true(contains(textFrom(mark), "mudletSpecShownCommand"), textFrom(mark)) + + mark = getLastLineNumber("main") + assert.is_true(send("mudletSpecHiddenCommand", false)) + assert.is_false(contains(textFrom(mark), "mudletSpecHiddenCommand"), textFrom(mark)) + + mark = getLastLineNumber("main") + assert.is_true(send("mudletSpecDefaultCommand")) + assert.is_true(contains(textFrom(mark), "mudletSpecDefaultCommand"), textFrom(mark)) + end) + end) + + describe("Tests the functionality of denyCurrentSend", function() + it("returns nothing", function() + finally(function() + -- the flag is consumed by the next send, so hand it one rather than + -- leaving the following specs' sends blocked + send("", false) + end) + + assert.equals(0, select('#', denyCurrentSend())) + end) + + it("stops the command that follows it from being sent", function() + -- Nothing goes on the wire offline, so what makes a send observable is + -- the warning Mudlet posts when a command cannot be encoded for the + -- game: it is only reached once the send has been allowed. Switching + -- the encoding first clears the once-per-encoding warning flag. + local probeEncoding = (getServerEncoding() == "ISO 8859-1") and "ISO 8859-2" or "ISO 8859-1" + finally(restoreServerEncoding()) + assert.is_true(setServerEncoding(probeEncoding)) + -- U+4E00, which no ISO 8859 encoding can represent + local unencodable = "\228\184\128" + + denyCurrentSend() + local mark = getLastLineNumber("main") + send("mudletSpecDenied" .. unencodable, false) + local afterDeny = textFrom(mark) + + mark = getLastLineNumber("main") + send("mudletSpecAllowed" .. unencodable, false) + local afterAllow = textFrom(mark) + + -- checked first: without it a silent deny spec would pass even if the + -- warning had stopped being posted at all + assert.is_true(contains(afterAllow, "mudletSpecAllowed"), "the allowed send was not reported, so this spec cannot tell the two apart") + assert.is_false(contains(afterDeny, "mudletSpecDenied"), "the denied command was sent anyway") + end) + end) + + describe("Tests the functionality of isAncestorsActive", function() + it("raises a Lua error when called with no arguments", function() + assertArgError(function() isAncestorsActive() end, "isAncestorsActive: bad argument #1 type") + end) + + it("raises a Lua error when given no item type", function() + assertArgError(function() isAncestorsActive(1) end, "isAncestorsActive: bad argument #2 type") + end) + + it("returns nil+msg for a negative item ID", function() + local ok, err = isAncestorsActive(-1, "alias") + assert.is_nil(ok) + assert.is_true(contains(err, "does not seem to be parseable as a positive integer"), tostring(err)) + end) + + it("returns nil+msg for an item that does not exist", function() + local ok, err = isAncestorsActive(9999999, "alias") + assert.is_nil(ok) + assert.is_true(contains(err, "does not exist"), tostring(err)) + end) + + it("returns nil+msg for an item type it does not know", function() + local ok, err = isAncestorsActive(1, "sandwich") + assert.is_nil(ok) + assert.is_true(contains(err, "invalid item type 'sandwich' given"), tostring(err)) + end) + + it("is true for a temporary item, which has no ancestors at all", function() + local triggerId = tempTrigger("mudletSpecAncestorTrigger", function() end) + local timerId = tempTimer(60, function() end) + finally(function() + killTrigger(tostring(triggerId)) + killTimer(timerId) + end) + + assert.is_true(isAncestorsActive(triggerId, "trigger")) + assert.is_true(isAncestorsActive(timerId, "timer")) + end) + + it("follows the state of a nested item's parent group", function() + -- Nesting needs permanent items, which cannot be removed again from + -- Lua, so this uses the hierarchy the run-tests package (the one + -- running these specs) already ships and puts its state back. + local parentGroup = "Not Filter" + local nested = findItems("Trigger", "trigger") + -- both names have to be the harness's own, or this would be toggling + -- some other package's trigger and asking about an unrelated item + assert.equals(1, #nested, "expected exactly the run-tests package's nested 'Trigger'") + assert.equals(1, #findItems(parentGroup, "trigger"), "expected exactly the run-tests package's '" .. parentGroup .. "' group") + local childId = nested[1] + finally(function() enableTrigger(parentGroup) end) + + assert.is_true(isAncestorsActive(childId, "trigger")) + + assert.is_true(disableTrigger(parentGroup)) + assert.is_false(isAncestorsActive(childId, "trigger")) + + assert.is_true(enableTrigger(parentGroup)) + assert.is_true(isAncestorsActive(childId, "trigger")) + end) + end) + + describe("Tests the functionality of getProfiles", function() + it("lists this profile as loaded, with what it was set up with", function() + local profiles = getProfiles() + assert.is_table(profiles) + + local own = profiles[getProfileName()] + assert.is_table(own, "the running profile is not in the list") + assert.is_true(own.loaded) + assert.is_boolean(own.connected) + assert.equals(getProfileInformation(), own.description) + if own.host then + assert.is_string(own.host) + assert.is_string(own.port) + end + + assert.is_nil(profiles["mudlet-spec-never-a-profile"]) + end) + + it("lists a profile that is not loaded", function() + local profilesDirectory = getMudletHomeDir():match("^(.*)[/\\]") + assert.is_string(profilesDirectory, "could not work out the profiles folder from " .. getMudletHomeDir()) + local unloaded = profilesDirectory .. "/mudlet-spec-unloaded" + -- a folder left behind would be listed as a profile by every later run, + -- and by the connection dialog + finally(function() assert.is_true(lfs.rmdir(unloaded), "could not remove " .. unloaded) end) + assert.is_true(lfs.mkdir(unloaded)) + + local entry = getProfiles()["mudlet-spec-unloaded"] + assert.is_table(entry, "a profile folder that is not open was not listed") + assert.is_false(entry.loaded) + -- only a loaded profile has a connection to report on + assert.is_nil(entry.connected) + assert.equals("", entry.description) + end) + end) + + describe("Tests the functionality of getProfileStats", function() + it("reports a count for every kind of item", function() + local stats = getProfileStats() + assert.is_table(stats) + for _, kind in ipairs({"triggers", "aliases", "timers", "keys", "scripts"}) do + assert.is_number(stats[kind].total, kind .. " has no total") + assert.is_number(stats[kind].temp, kind .. " has no temp count") + assert.is_number(stats[kind].active, kind .. " has no active count") + end + assert.is_number(stats.triggers.patterns.total) + assert.is_number(stats.triggers.patterns.active) + assert.is_number(stats.gifs.total) + end) + + it("counts a temporary item that has just been created", function() + local before = getProfileStats() + local timerId = tempTimer(60, function() end) + local triggerId = tempTrigger("mudletSpecStatsTrigger", function() end) + finally(function() + killTimer(timerId) + killTrigger(triggerId) + end) + + local after = getProfileStats() + assert.equals(before.timers.total + 1, after.timers.total) + assert.equals(before.timers.temp + 1, after.timers.temp) + assert.equals(before.triggers.total + 1, after.triggers.total) + assert.equals(before.triggers.temp + 1, after.triggers.temp) + end) + end) + + describe("Tests the profile icon functions", function() + local iconSource = getMudletHomeDir() .. "/mudlet-spec-icon.png" + local profileIcon = getMudletHomeDir() .. "/profileicon" + + -- The icon a player chose is theirs, and the profile outlives the run, so + -- the specs below take a copy of it, work from a profile with no icon, and + -- put the copy back. + local function withNoProfileIcon() + local original = readFile(profileIcon) + finally(function() + os.remove(iconSource) + resetProfileIcon() + if original then + writeFile(profileIcon, original) + end + end) + if original then + assert.is_true(resetProfileIcon()) + end + assert.is_false(fileExists(profileIcon), "the profile still has an icon") + end + + describe("Tests the functionality of setProfileIcon", function() + it("raises a Lua error when called with no arguments", function() + assertArgError(function() setProfileIcon() end, "setProfileIcon: bad argument #1 type") + end) + + it("returns nil+msg for a blank path", function() + local ok, err = setProfileIcon("") + assert.is_nil(ok) + assert.equals("a blank string is not a valid icon file path", err) + end) + + it("returns nil+msg for a file that is not there", function() + local ok, err = setProfileIcon(getMudletHomeDir() .. "/mudlet-spec-no-such-icon.png") + assert.is_nil(ok) + assert.is_true(contains(err, "doesn't exist"), tostring(err)) + end) + + it("copies the icon into the profile", function() + withNoProfileIcon() + writeFile(iconSource, "mudlet-spec-icon-bytes") + + assert.is_true(setProfileIcon(iconSource)) + + assert.is_true(fileExists(profileIcon), "no icon was copied into the profile") + assert.equals("mudlet-spec-icon-bytes", readFile(profileIcon)) + end) + end) + + describe("Tests the functionality of resetProfileIcon", function() + it("takes the icon back out of the profile", function() + withNoProfileIcon() + writeFile(iconSource, "mudlet-spec-icon-bytes") + assert.is_true(setProfileIcon(iconSource)) + assert.is_true(fileExists(profileIcon)) + + assert.is_true(resetProfileIcon()) + + assert.is_false(fileExists(profileIcon), "the icon was left in the profile") + end) + + it("is happy to be asked when there is no icon to remove", function() + withNoProfileIcon() + + assert.is_true(resetProfileIcon()) + + assert.is_false(fileExists(profileIcon)) + end) + end) + end) + + describe("Tests the functionality of raiseGlobalEvent", function() + it("raises a Lua error when called with no arguments", function() + assertArgError(function() raiseGlobalEvent() end, "raiseGlobalEvent: missing argument #1") + end) + + it("raises a Lua error for a first argument it cannot carry", function() + -- safe to assert, unlike the spec below: nothing has been put into the + -- event yet, so the raise has nothing to strand + assertArgError(function() raiseGlobalEvent({}) end, "raiseGlobalEvent: bad argument type #1") + end) + + it("raises a Lua error for a later argument it cannot carry", function() + -- BUG: the refusal is right, but it is raised with lua_error() after the + -- event has been built, and that longjmps past the destructor of the + -- TEvent holding the arguments read so far, which LeakSanitizer reports + -- and which would turn the leak-checking CI job red. Refusing the first + -- argument (above) is safe because nothing has been appended yet. Left + -- pending until the raise happens before the event is built. + pending("raiseGlobalEvent() leaks the event it was building when it refuses a later argument") + assertArgError(function() raiseGlobalEvent("mudletSpecGlobalEvent", {}) end, "raiseGlobalEvent: bad argument type #2") + end) + + it("does not deliver the event back to the profile that sent it", function() + -- Only the half that one profile can see: that the sender is left out. + -- Whether the other profiles receive it needs a second profile, so it + -- belongs to the functional tests rather than here. + local received = 0 + local handler = registerAnonymousEventHandler("mudletSpecGlobalEvent", function() received = received + 1 end) + finally(function() killAnonymousEventHandler(handler) end) + + assert.is_true(raiseGlobalEvent("mudletSpecGlobalEvent", 1, "two", true, nil)) + + if testMode then + pumpEvents(200) + end + assert.equals(0, received) + -- raiseEvent() is what a profile uses to talk to itself, and it proves + -- the handler the count above is being read from does work + raiseEvent("mudletSpecGlobalEvent") + assert.equals(1, received) + end) + end) + + describe("Tests the functionality of wait", function() + it("raises a Lua error when called with no arguments", function() + assertArgError(function() wait() end, "Wait: wrong number of arguments") + end) + + it("raises a Lua error when the delay is not a number", function() + assertArgError(function() wait("soon") end, "Wait: bad argument #1 type") + end) + + it("returns nothing and blocks for at least as long as it was asked to", function() + local before = getEpoch() + + assert.equals(0, select('#', wait(10))) + + -- getEpoch() is in seconds; wait() blocks the whole thread, which is + -- why nothing here waits any longer than it has to + assert.is_true(getEpoch() - before >= 0.009) + end) + end) + + describe("Tests the functions whose effect needs a desktop or a person", function() + -- These reach a browser, the system tray, a modal dialog or the physical + -- keyboard, so only the refusals can be driven from here: every spec below + -- gets the call turned away before it can do anything. That the call is + -- reached at all is the point - it proves the function is registered and + -- validates what it was handed. + + describe("Tests the functionality of openWebPage", function() + it("raises a Lua error, rather than opening anything, when given no URL", function() + assertArgError(function() openWebPage() end, "openWebPage: bad argument #1 type") + end) + end) + + describe("Tests the functionality of showNotification", function() + it("raises a Lua error when called with no arguments", function() + assertArgError(function() showNotification() end, "showNotification: bad argument #1 type") + end) + + it("raises a Lua error when the expiry time is not a number", function() + assertArgError(function() showNotification("title", "message", "soon") end, "showNotification: bad argument #3 type") + end) + end) + + describe("Tests the functionality of invokeFileDialog", function() + it("raises a Lua error, rather than opening a dialog, when not told what to ask for", function() + assertArgError(function() invokeFileDialog() end, "invokeFileDialog: bad argument #1 type") + end) + + it("raises a Lua error when given no title", function() + assertArgError(function() invokeFileDialog(true) end, "invokeFileDialog: bad argument #2 type") + end) + end) + + describe("Tests the functionality of holdingModifiers", function() + it("raises a Lua error when the modifier is not a number", function() + -- what it answers depends on which keys are held down as the specs + -- run, so only the refusal can be asserted on + assertArgError(function() holdingModifiers("ctrl") end, "holdingModifiers: bad argument #1 type") + end) + end) + + describe("Tests the functionality of showHandlerError", function() + it("raises a Lua error when called with no arguments", function() + assertArgError(function() showHandlerError() end, "showHandlerError: bad argument #1 type") + end) + + it("raises a Lua error when given no error message", function() + -- where the message goes is the editor's error console and, only for a + -- profile that opted into echoing Lua errors, the main console; + -- neither can be turned on from Lua + assertArgError(function() showHandlerError("mudletSpecEvent") end, "showHandlerError: bad argument #2 type") + end) + end) + + describe("Tests the functionality of clearCmdLineBlacklist", function() + it("returns nil+msg for a command line that does not exist", function() + local ok, err = clearCmdLineBlacklist("mudlet-spec-no-such-command-line") + assert.is_nil(ok) + assert.is_true(contains(err, "not found"), tostring(err)) + end) + + it("returns nothing for the main command line", function() + -- what it cleared cannot be read back: there is no getter for a + -- command line's blacklist + assert.equals(0, select('#', clearCmdLineBlacklist())) + assert.equals(0, select('#', clearCmdLineBlacklist("main"))) + end) + end) + + describe("Tests the functionality of showUnzipProgress", function() + it("says it does nothing, having been removed", function() + local ok, err = showUnzipProgress() + assert.is_nil(ok) + assert.equals("removed command, this function is now inactive and does nothing", err) + end) + end) + end) + + describe("The Miscallaneous specs clean up after themselves", function() + it("leaves no file or folder of its own behind", function() + -- the specs above write into the profile, and one of them into the + -- folder profiles live in, which no other spec file watches: anything + -- left there would be listed as a profile from the next run onwards + for entry in lfs.dir(getMudletHomeDir()) do + assert.is_nil(entry:find("mudlet%-spec%-"), "left " .. entry .. " in the profile") + end + local profilesDirectory = getMudletHomeDir():match("^(.*)[/\\]") + for entry in lfs.dir(profilesDirectory) do + assert.is_nil(entry:find("mudlet%-spec%-"), "left " .. entry .. " among the profiles") + end + end) + end) + end) diff --git a/src/mudlet-lua/tests/Package_spec.lua b/src/mudlet-lua/tests/Package_spec.lua index 047da11d4..4020e8909 100644 --- a/src/mudlet-lua/tests/Package_spec.lua +++ b/src/mudlet-lua/tests/Package_spec.lua @@ -118,6 +118,29 @@ local function fileExists(path) return lfs.attributes(path, "mode") ~= nil end +-- Everything the main console gained since it was at line `mark`, joined up. +-- The console wraps long lines and a wrap swallows the space it broke at, so +-- the announcements below are matched with all whitespace removed. +local function textFrom(mark) + return table.concat(getLines("main", mark, getLastLineNumber("main") + 1), "") +end + +local function containsWrapped(haystack, needle) + return contains((tostring(haystack):gsub("%s+", "")), (needle:gsub("%s+", ""))) +end + +-- A file: URL for a local path, in the three-slash form that keeps a Windows +-- drive letter from being read as the host name. The checkout these fixtures +-- live in can sit anywhere, so the characters that would otherwise end the path +-- early - a space, a fragment, a query, a half-written escape - are encoded. +local function fileUrl(path) + local normalised = path:gsub("\\", "/"):gsub("[%%#%?%s]", function(character) return string.format("%%%02X", character:byte()) end) + if normalised:sub(1, 1) ~= "/" then + normalised = "/" .. normalised + end + return "file://" .. normalised +end + local function copyFile(from, to) local source = io.open(from, "rb") assert.is_not_nil(source, "could not read the fixture " .. from) @@ -926,6 +949,237 @@ describe("Tests installing an archive with nothing in it for Mudlet", function() end) end) +describe("Tests the functionality of verbosePackageInstall", function() + it("installs the package and says so on the main console", function() + defer(function() removeFixturePackage(minimalPackage) end) + local path = fixtureDirectory .. "/" .. minimalPackage .. ".mpackage" + -- an install asked for while a save is running is postponed, and would be + -- announced as a success without anything being installed + assert.is_true(waitForProfileSaveToPass(), "a profile save was still running") + local mark = getLastLineNumber("main") + + verbosePackageInstall(path) + + assert.is_true(packageInstalled(minimalPackage), "the package was not installed") + assert.is_true(containsWrapped(textFrom(mark), "Package '" .. path .. "' installed successfully."), textFrom(mark)) + end) + + it("says why an install failed", function() + -- a path that is not there fails without installing anything, so this spec + -- costs none of the profile saves an install-then-reinstall would + local path = fixtureDirectory .. "/mudlet-spec-there-is-no-such-package.mpackage" + assert.is_true(waitForProfileSaveToPass(), "a profile save was still running") + local mark = getLastLineNumber("main") + + verbosePackageInstall(path) + + local text = textFrom(mark) + assert.is_true(containsWrapped(text, "Installing '" .. path .. "' failed:"), text) + assert.is_true(containsWrapped(text, "could not open file"), text) + assert.is_false(packageInstalled("mudlet-spec-there-is-no-such-package")) + end) +end) + +describe("Tests the functionality of verboseModuleInstall", function() + -- A module is installed from a copy inside the profile for the same reason + -- installFixtureModule() does it: a save rewrites a synced module's own + -- .mpackage, which must not be the committed fixture. + local function stageModule() + lfs.mkdir(scratchDirectory) + local path = scratchDirectory .. "/" .. moduleName .. ".mpackage" + copyFile(fixtureDirectory .. "/" .. moduleName .. ".mpackage", path) + return path + end + + it("installs the module and says so on the main console", function() + defer(function() removeFixtureModule(moduleName) end) + local path = stageModule() + assert.is_true(waitForProfileSaveToPass(), "a profile save was still running") + local mark = getLastLineNumber("main") + + verboseModuleInstall(path) + + assert.is_true(moduleInstalled(moduleName), "the module was not installed") + assert.is_true(containsWrapped(textFrom(mark), "Module '" .. path .. "' installed successfully."), textFrom(mark)) + end) + + it("says why an install failed", function() + local path = fixtureDirectory .. "/mudlet-spec-there-is-no-such-module.mpackage" + assert.is_true(waitForProfileSaveToPass(), "a profile save was still running") + local mark = getLastLineNumber("main") + + verboseModuleInstall(path) + + local text = textFrom(mark) + -- the module and package failures are announced in the same words, so it is + -- the spec above, not this one, that tells the two functions apart + assert.is_true(containsWrapped(text, "Installing '" .. path .. "' failed:"), text) + assert.is_true(containsWrapped(text, "could not open file"), text) + assert.is_false(moduleInstalled("mudlet-spec-there-is-no-such-module")) + end) +end) + +describe("Tests the functionality of installPackageFromUrl", function() + local downloadedName = minimalPackage .. ".mpackage" + + it("downloads the package, installs it and tidies the download away", function() + defer(function() + removeFixturePackage(minimalPackage) + os.remove(getMudletHomeDir() .. "/" .. downloadedName) + end) + assert.is_true(waitForProfileSaveToPass(), "a profile save was still running") + local mark = getLastLineNumber("main") + -- a file: URL keeps this off the network while still going through + -- downloadFile() and the sysDownloadDone handler the function registers + local url = fileUrl(fixtureDirectory .. "/" .. downloadedName) + + installPackageFromUrl(downloadedName, url) + + local event, installedName = waitForEvent("sysInstallPackage", 10000) + assert.equals("sysInstallPackage", event) + assert.equals(minimalPackage, installedName) + assert.is_true(packageInstalled(minimalPackage)) + local text = textFrom(mark) + assert.is_true(containsWrapped(text, "Downloading package from " .. url), text) + assert.is_true(containsWrapped(text, "installed successfully."), text) + assert.is_false(fileExists(getMudletHomeDir() .. "/" .. downloadedName), "the downloaded copy was left in the profile") + end) + + it("names the file, not the whole path, in the announcement", function() + -- BUG: verbosePackageInstall() strips the profile folder off the name it + -- announces, but uses that folder as a Lua pattern - a profile path holding + -- a "-" (a home folder with one will do it) never matches, so the whole + -- path is announced instead of the file. + pending("verbosePackageInstall() strips the profile folder with an unescaped Lua pattern") + defer(function() + removeFixturePackage(minimalPackage) + os.remove(getMudletHomeDir() .. "/" .. downloadedName) + end) + assert.is_true(waitForProfileSaveToPass(), "a profile save was still running") + local mark = getLastLineNumber("main") + + installPackageFromUrl(downloadedName, fileUrl(fixtureDirectory .. "/" .. downloadedName)) + + waitForEvent("sysInstallPackage", 10000) + assert.is_true(containsWrapped(textFrom(mark), "Package '" .. downloadedName .. "' installed successfully."), textFrom(mark)) + end) + + it("reports a download that failed and installs nothing", function() + local missingName = "mudlet-spec-never-downloadable.mpackage" + defer(function() os.remove(getMudletHomeDir() .. "/" .. missingName) end) + local mark = getLastLineNumber("main") + + installPackageFromUrl(missingName, fileUrl(fixtureDirectory .. "/" .. missingName)) + + local event = waitForEvent("sysDownloadError", 10000) + assert.equals("sysDownloadError", event) + pumpEvents(200) + assert.is_false(packageInstalled("mudlet-spec-never-downloadable")) + local text = textFrom(mark) + -- the warning only means something paired with the download it reports on + assert.is_true(containsWrapped(text, "Downloading package from"), text) + assert.is_true(containsWrapped(text, "[ WARN ]"), text) + end) +end) + +describe("Tests the functionality of packageDrop", function() + it("hands a dropped package file to the installer", function() + -- The file is one that is not there: what this is about is that dropping + -- reaches the installer with the path that was dropped, and installing for + -- real costs two profile saves that verbosePackageInstall's own spec has + -- already paid for. + local path = fixtureDirectory .. "/mudlet-spec-there-is-no-such-drop.mpackage" + assert.is_true(waitForProfileSaveToPass(), "a profile save was still running") + local mark = getLastLineNumber("main") + + -- raised rather than called so that the handler registration in Other.lua + -- is what is being tested as well + raiseEvent("sysDropEvent", path, "mpackage", 10, 10, "main") + + local text = textFrom(mark) + assert.is_true(containsWrapped(text, "Installing '" .. path .. "' failed:"), text) + assert.is_false(packageInstalled("mudlet-spec-there-is-no-such-drop")) + end) + + it("hands on every kind of file Mudlet installs", function() + -- same trick as above, so that narrowing the list of suffixes Mudlet + -- accepts cannot go unnoticed + assert.is_true(waitForProfileSaveToPass(), "a profile save was still running") + + for _, suffix in ipairs({"xml", "zip", "trigger"}) do + local path = fixtureDirectory .. "/mudlet-spec-there-is-no-such-drop." .. suffix + local mark = getLastLineNumber("main") + + packageDrop("sysDropEvent", path, suffix) + + local text = textFrom(mark) + assert.is_true(containsWrapped(text, "Installing '" .. path .. "' failed:"), suffix .. ": " .. text) + end + end) + + it("ignores a file whose type Mudlet does not install", function() + -- an install that arrives while a save is running is postponed and would + -- land after this spec rather than in it + assert.is_true(waitForProfileSaveToPass(), "a profile save was still running") + local mark = getLastLineNumber("main") + + assert.equals(0, select('#', packageDrop("sysDropEvent", fixtureDirectory .. "/" .. minimalPackage .. ".mpackage", "exe"))) + + assert.is_false(packageInstalled(minimalPackage)) + -- an install that was attempted says so either way round, so neither + -- announcement having been made is what proves the drop was turned away + local text = textFrom(mark) + assert.is_false(containsWrapped(text, "installed successfully."), text) + assert.is_false(containsWrapped(text, "failed:"), text) + end) +end) + +describe("Tests the functionality of packageUrlDrop", function() + -- installPackageFromUrl() announces the download while the call is still on + -- the stack, so that line on the console separates a drop that was passed on + -- from one that was turned away without any waiting. Nothing listens on the + -- port below, so the download a passed-on drop starts cannot leave the + -- machine. + local droppedUrl = "http://127.0.0.1:1/mudlet-spec-dropped.mpackage" + + local function announcedADownload(mark) + return containsWrapped(textFrom(mark), "Downloading package from") + end + + it("hands a dropped package URL to the downloader", function() + defer(function() os.remove(getMudletHomeDir() .. "/mudlet-spec-dropped.mpackage") end) + local mark = getLastLineNumber("main") + + packageUrlDrop("sysDropUrlEvent", droppedUrl, "http") + + assert.is_true(containsWrapped(textFrom(mark), "Downloading package from " .. droppedUrl), textFrom(mark)) + -- let the refused connection be reported here rather than in a later spec + waitForEvent("sysDownloadError", 5000) + assert.is_false(packageInstalled("mudlet-spec-dropped")) + end) + + it("ignores a URL whose scheme it does not handle", function() + -- the scheme is a separate argument from the URL, so the URL is one the + -- spec above proved would otherwise be downloaded + local mark = getLastLineNumber("main") + + assert.equals(0, select('#', packageUrlDrop("sysDropUrlEvent", droppedUrl, "ftp"))) + + assert.is_false(announcedADownload(mark)) + end) + + it("does not download a URL that is not a package file", function() + -- no save to wait for: a URL with the wrong suffix is handed to the plain + -- installer, which gives up on opening it as a file before installing + -- anything + local mark = getLastLineNumber("main") + + packageUrlDrop("sysDropUrlEvent", "http://127.0.0.1:1/mudlet-spec-not-a-package.txt", "http") + + assert.is_false(announcedADownload(mark)) + end) +end) + describe("The package specs clean up after themselves", function() it("leaves no fixture package, module or folder behind", function() for _, name in ipairs(getPackages()) do From b9d210d966dce3de4b2a1657cb7b14fd5ecf9600 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Tue, 11 Aug 2026 10:56:38 +0200 Subject: [PATCH 151/155] infrastructure: fix a test running against the real config dir, and guard the recipe (#9811) #### Brief overview of PR changes/additions - `ProfileLifecycleTest` (merged this morning in #9776) seeds `$XDG_CONFIG_HOME/mudlet` without the `profiles/` subdirectory that #9712 made the opt-in, so on any machine whose `~/.config/mudlet` holds profiles it resolves to that instead and fails its own line 331 assertion. Reproduced here before the one-line fix. Its build legs all finished on 10 Aug 13:52-14:55 UTC and #9712 merged at 22:17 that evening, so it was merged 16 hours later on green CI that predates the rule it breaks. - `XdgRecipeConsistencyTest` stops the next one. It scans `test/*.cpp` and `test/functional_tests/*.cpp` the way `CMakeListsConsistencyTest` scans `src/`, and fails on a `mkpath()`/`mkdir()` whose argument spells a path ending in `/mudlet` unless the file also creates the `profiles/` opt-in. A test that means it says so with an `xdg-recipe-guard: allow` comment. - Comments, strings and raw strings are parsed out first, so a recipe in prose is not code and an assertion against a `"%1/mudlet"` literal is not a creation. The sweep reads this file too: its own fixtures spell the stale recipe out inside string literals. Test case: the sweep names `ProfileLifecycleTest.cpp:317` before the fix, and both pre-#9810 files at lines 154 and 173 when those are checked out of `8901b59d8`; the other 99 test sources are clean, and the suite is 98/98 locally. Assisted-by: Claude:claude-opus-5 --- test/CMakeLists.txt | 10 + test/XdgRecipeConsistencyTest.cpp | 380 ++++++++++++++++++ .../functional_tests/ProfileLifecycleTest.cpp | 6 +- 3 files changed, 393 insertions(+), 3 deletions(-) create mode 100644 test/XdgRecipeConsistencyTest.cpp diff --git a/test/CMakeLists.txt b/test/CMakeLists.txt index 87728abf8..23fbea6a4 100644 --- a/test/CMakeLists.txt +++ b/test/CMakeLists.txt @@ -130,6 +130,16 @@ set_tests_properties(ReleasePlatformAssetTest PROPERTIES ENVIRONMENT "ASAN_OPTIONS=detect_leaks=0" ) +# The $XDG_CONFIG_HOME opt-in recipe the tests isolate themselves with. Reads the +# test sources at runtime, so like CMakeListsConsistencyTest it links nothing. +add_executable(XdgRecipeConsistencyTest XdgRecipeConsistencyTest.cpp) +target_link_libraries(XdgRecipeConsistencyTest PRIVATE Qt6::Test) +target_compile_definitions(XdgRecipeConsistencyTest PRIVATE MUDLET_TEST_DIR="${CMAKE_CURRENT_SOURCE_DIR}") +add_test(NAME XdgRecipeConsistencyTest COMMAND $<TARGET_FILE:XdgRecipeConsistencyTest>) +set_tests_properties(XdgRecipeConsistencyTest PROPERTIES + ENVIRONMENT "ASAN_OPTIONS=detect_leaks=0" +) + # Checks the release-publishing scripts that keep SHA256SUMS.txt covering every # release binary - a binary without an entry is one the updater refuses to install if(NOT WIN32) diff --git a/test/XdgRecipeConsistencyTest.cpp b/test/XdgRecipeConsistencyTest.cpp new file mode 100644 index 000000000..15eaaa0aa --- /dev/null +++ b/test/XdgRecipeConsistencyTest.cpp @@ -0,0 +1,380 @@ +/*************************************************************************** + * Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +/* + * A test that drives setupConfig() has to point XDG_CONFIG_HOME at a temporary + * directory and opt that directory in. Since #9712 the opt-in marker is + * $XDG_CONFIG_HOME/mudlet/profiles - the mudlet directory on its own no longer + * counts, because other tooling creates that by accident - so a test that + * creates only that directory gets the developer's own ~/.config/mudlet instead + * whenever theirs holds profiles or a Mudlet.ini. Where there is no config + * directory to lose the stale recipe still resolves to the temporary one, so + * the mistake hides on exactly the machines it cannot hurt. + * + * Nothing about it fails: the test reads and writes the user's own profiles, + * and some of these tests delete profiles. + * + * So creating a directory whose path ends in /mudlet is an error here, unless + * the same file creates the profiles/ opt-in somewhere. That is deliberately + * coarse - a file isolating two config roots is trusted once it gets one of + * them right. A test that means it says so with an "xdg-recipe-guard: allow" + * comment on the line its call starts on, or the line above. + * + * The path has to be spelled out in the call. A file that builds the config + * root through a helper or a local first is out of range; ConfigDirOverrideTest + * does that, and creates every shape of config root deliberately, the + * resolution rules being its subject. + * + * The test directory is provided at configure time via MUDLET_TEST_DIR. Like + * CMakeListsConsistencyTest this pulls in no Mudlet headers, hence QStringLiteral + * rather than utils.h's qsl(). + * + * Run with: ctest -R XdgRecipeConsistencyTest -V + */ + +#include <QtTest/QtTest> + +#include <QDir> +#include <QFile> +#include <QRegularExpression> +#include <QSet> +#include <QString> +#include <QStringList> +#include <QVector> + +class XdgRecipeConsistencyTest : public QObject +{ + Q_OBJECT + + struct DirectoryCreation + { + int line = 0; + QString argument; + }; + + static QString testDir() { return QStringLiteral(MUDLET_TEST_DIR); } + + static QString allowToken() { return QStringLiteral("xdg-recipe-guard: allow"); } + + // Blanks out comment bodies so a recipe quoted in prose cannot read as code, + // keeping the newlines so line numbers survive. The lines spanned by a + // comment holding the allow token are collected on the way through. + static QString withoutComments(const QString& source, QSet<int>& allowedLines) + { + enum class State { code, lineComment, blockComment, string, character }; + State state = State::code; + QString stripped; + stripped.reserve(source.size()); + QString comment; + int line = 1; + int commentStart = 1; + + auto endComment = [&]() { + if (comment.contains(allowToken())) { + for (int marked = commentStart; marked <= line; ++marked) { + allowedLines.insert(marked); + } + } + comment.clear(); + }; + + for (qsizetype i = 0; i < source.size(); ++i) { + const QChar current = source.at(i); + const QChar next = i + 1 < source.size() ? source.at(i + 1) : QChar(u'\0'); + switch (state) { + case State::code: + if (current == u'/' && (next == u'/' || next == u'*')) { + state = next == u'/' ? State::lineComment : State::blockComment; + commentStart = line; + stripped.append(QStringLiteral(" ")); + ++i; + continue; + } + if (current == u'R' && next == u'"') { + // A raw string carries unbalanced quotes as ordinary text, so + // one read as a normal string desynchronises everything after + // it. Blanked whole rather than parsed: no path is spelled + // this way, and a missed one is only a missed report. + const qsizetype open = source.indexOf(u'(', i + 2); + const QString terminator = open < 0 ? QString() : QStringLiteral(")%1\"").arg(source.mid(i + 2, open - i - 2)); + const qsizetype close = open < 0 ? -1 : source.indexOf(terminator, open); + if (close >= 0) { + for (const qsizetype end = close + terminator.size(); i < end; ++i) { + const QChar skipped = source.at(i); + stripped.append(skipped == u'\n' ? skipped : QChar(u' ')); + if (skipped == u'\n') { + ++line; + } + } + --i; + continue; + } + } + if (current == u'"') { + state = State::string; + } else if (current == u'\'') { + state = State::character; + } + stripped.append(current); + break; + case State::string: + case State::character: + stripped.append(current); + if (current == u'\\' && i + 1 < source.size()) { + stripped.append(next); + ++i; + if (next == u'\n') { + ++line; + } + continue; + } + if ((state == State::string && current == u'"') || (state == State::character && current == u'\'')) { + state = State::code; + } + break; + case State::lineComment: + if (current == u'\n') { + endComment(); + state = State::code; + stripped.append(current); + } else { + comment.append(current); + stripped.append(u' '); + } + break; + case State::blockComment: + if (current == u'*' && next == u'/') { + endComment(); + state = State::code; + stripped.append(QStringLiteral(" ")); + ++i; + continue; + } + comment.append(current); + stripped.append(current == u'\n' ? current : QChar(u' ')); + break; + } + if (current == u'\n') { + ++line; + } + } + if (state == State::lineComment || state == State::blockComment) { + endComment(); + } + return stripped; + } + + static int lineOf(const QString& code, qsizetype offset) { return static_cast<int>(QStringView(code).left(offset).count(u'\n')) + 1; } + + // The argument text of every mkpath()/mkdir() call, found by matching + // parentheses rather than by line, so a call wrapped over several lines and + // one nesting further calls both come out whole. + static QVector<DirectoryCreation> directoryCreations(const QString& code) + { + static const QRegularExpression call(QStringLiteral("\\b(?:mkpath|mkdir)\\s*\\(")); + QVector<DirectoryCreation> creations; + auto matches = call.globalMatch(code); + while (matches.hasNext()) { + const QRegularExpressionMatch match = matches.next(); + const qsizetype start = match.capturedEnd(); + int depth = 1; + QChar quote(u'\0'); + qsizetype end = start; + for (; end < code.size() && depth > 0; ++end) { + const QChar current = code.at(end); + if (quote != QChar(u'\0')) { + if (current == u'\\') { + ++end; + } else if (current == quote) { + quote = QChar(u'\0'); + } + } else if (current == u'"' || current == u'\'') { + quote = current; + } else if (current == u'(') { + ++depth; + } else if (current == u')') { + --depth; + } + } + if (depth > 0) { + continue; + } + creations.append({lineOf(code, match.capturedStart()), code.mid(start, end - 1 - start)}); + } + return creations; + } + + static bool mentionsConfigRoot(const QString& argument) + { + static const QRegularExpression configRoot(QStringLiteral("\"(?:[^\"]*/)?mudlet\"")); + return argument.contains(configRoot); + } + + // The opt-in either spelled in one literal or assembled from two, so that + // filePath("profiles") off a config root counts as much as "%1/mudlet/profiles" + static bool createsOptIn(const QString& argument) + { + static const QRegularExpression optIn(QStringLiteral("\"(?:[^\"]*/)?mudlet/profiles(?:/[^\"]*)?\"")); + static const QRegularExpression profiles(QStringLiteral("\"(?:[^\"]*/)?profiles(?:/[^\"]*)?\"")); + return argument.contains(optIn) || (mentionsConfigRoot(argument) && argument.contains(profiles)); + } + + static bool createsConfigRootOnly(const QString& argument) { return mentionsConfigRoot(argument) && !createsOptIn(argument); } + + static QStringList staleRecipes(const QString& source) + { + QSet<int> allowedLines; + const QString code = withoutComments(source, allowedLines); + const QVector<DirectoryCreation> creations = directoryCreations(code); + + bool optedIn = false; + for (const DirectoryCreation& creation : creations) { + if (createsOptIn(creation.argument)) { + optedIn = true; + break; + } + } + if (optedIn) { + return {}; + } + + QStringList problems; + for (const DirectoryCreation& creation : creations) { + if (!createsConfigRootOnly(creation.argument) || allowedLines.contains(creation.line) || allowedLines.contains(creation.line - 1)) { + continue; + } + problems.append(QStringLiteral("line %1 creates the config root itself (%2) - create its profiles/ subdirectory instead, that is the opt-in") + .arg(QString::number(creation.line), creation.argument.simplified())); + } + return problems; + } + +private slots: + void test_theStaleRecipeIsFlagged() + { + const QString source = QStringLiteral("void initTestCase()\n{\n QVERIFY(QDir().mkpath(qsl(\"%1/mudlet\").arg(mConfigDir.path())));\n}\n"); + const QStringList problems = staleRecipes(source); + QCOMPARE(problems.size(), 1); + QVERIFY2(problems.first().startsWith(QStringLiteral("line 3 ")), qPrintable(problems.first())); + } + + void test_theCurrentRecipeIsAccepted() + { + const QString recipe = QStringLiteral("qsl(\"%1/mudlet/profiles\").arg(mConfigDir.path())"); + QVERIFY(createsOptIn(recipe)); + QVERIFY(!createsConfigRootOnly(recipe)); + const QString source = QStringLiteral("QVERIFY(QDir().mkpath(%1));\n").arg(recipe); + QVERIFY2(staleRecipes(source).isEmpty(), qPrintable(staleRecipes(source).join(QChar(u'\n')))); + } + + void test_aProfileUnderTheOptInIsAccepted() + { + const QString source = QStringLiteral("QVERIFY(QDir().mkpath(qsl(\"%1/mudlet\").arg(dir)));\nQVERIFY(QDir().mkpath(qsl(\"%1/mudlet/profiles/%2\").arg(dir, name)));\n"); + QVERIFY2(staleRecipes(source).isEmpty(), qPrintable(staleRecipes(source).join(QChar(u'\n')))); + } + + void test_theOptInSpelledRelativelyOrAssembledCounts() + { + const QString relative = QStringLiteral("QVERIFY(QDir(root).mkdir(qsl(\"mudlet\")));\nQVERIFY(QDir(root).mkpath(qsl(\"mudlet/profiles\")));\n"); + QVERIFY2(staleRecipes(relative).isEmpty(), qPrintable(staleRecipes(relative).join(QChar(u'\n')))); + + const QString inOneCall = QStringLiteral("QVERIFY(QDir().mkpath(QDir(qsl(\"%1/mudlet\").arg(dir)).filePath(qsl(\"profiles\"))));\n"); + QVERIFY2(staleRecipes(inOneCall).isEmpty(), qPrintable(staleRecipes(inOneCall).join(QChar(u'\n')))); + } + + // Several tests compare the resolved config root against a "%1/mudlet" + // literal, which creates nothing + void test_anAssertionOnTheConfigRootIsNotSeeding() + { + const QString source = QStringLiteral("QCOMPARE(mudlet::getMudletPath(enums::mainPath), qsl(\"%1/mudlet\").arg(mConfigDir.path()));\n"); + QVERIFY2(staleRecipes(source).isEmpty(), qPrintable(staleRecipes(source).join(QChar(u'\n')))); + } + + void test_theRecipeQuotedInACommentIsNotCode() + { + const QString source = QStringLiteral("// never QDir().mkpath(qsl(\"%1/mudlet\").arg(dir))\n/* nor QDir().mkdir(qsl(\"%1/mudlet\")) */\n"); + QVERIFY2(staleRecipes(source).isEmpty(), qPrintable(staleRecipes(source).join(QChar(u'\n')))); + } + + void test_aRawStringCannotDesynchroniseTheScan() + { + const QString source = QStringLiteral("const auto text = R\"(he said \"hi)\";\n" + "// QDir().mkpath(qsl(\"%1/mudlet\").arg(dir))\n" + "QVERIFY(QDir().mkpath(qsl(\"%1/mudlet\").arg(dir)));\n"); + const QStringList problems = staleRecipes(source); + QCOMPARE(problems.size(), 1); + QVERIFY2(problems.first().startsWith(QStringLiteral("line 3 ")), qPrintable(problems.first())); + } + + void test_theOptInElsewhereInTheFileForgivesTheSeed() + { + const QString source = QStringLiteral("QVERIFY(QDir().mkpath(qsl(\"%1/mudlet\").arg(dir)));\nQVERIFY(QDir().mkpath(qsl(\"%1/mudlet/profiles\").arg(dir)));\n"); + QVERIFY2(staleRecipes(source).isEmpty(), qPrintable(staleRecipes(source).join(QChar(u'\n')))); + } + + void test_theAllowTokenExemptsTheCallItSitsOn() + { + const QString onTheLine = QStringLiteral("QVERIFY(QDir().mkpath(qsl(\"%1/mudlet\").arg(dir))); // xdg-recipe-guard: allow, the legacy branch is the subject here\n"); + QVERIFY2(staleRecipes(onTheLine).isEmpty(), qPrintable(staleRecipes(onTheLine).join(QChar(u'\n')))); + + const QString aboveTheLine = QStringLiteral("// xdg-recipe-guard: allow, the legacy branch is the subject here\nQVERIFY(QDir().mkpath(qsl(\"%1/mudlet\").arg(dir)));\n"); + QVERIFY2(staleRecipes(aboveTheLine).isEmpty(), qPrintable(staleRecipes(aboveTheLine).join(QChar(u'\n')))); + + const QString twoLinesAbove = QStringLiteral("// xdg-recipe-guard: allow\n\nQVERIFY(QDir().mkpath(qsl(\"%1/mudlet\").arg(dir)));\n"); + QCOMPARE(staleRecipes(twoLinesAbove).size(), 1); + } + + void test_aMultiLineCallIsStillOneCall() + { + const QString source = QStringLiteral("QVERIFY(QDir().mkpath(\n qsl(\"%1/mudlet\")\n .arg(mConfigDir.path())));\n"); + const QStringList problems = staleRecipes(source); + QCOMPARE(problems.size(), 1); + QVERIFY2(problems.first().startsWith(QStringLiteral("line 1 ")), qPrintable(problems.first())); + } + + void test_everyTestSourceOptsInTheCurrentWay() + { + const QStringList directories = {testDir(), QStringLiteral("%1/functional_tests").arg(testDir())}; + QStringList problems; + int scanned = 0; + for (const QString& directory : directories) { + const QDir dir(directory); + QVERIFY2(dir.exists(), qPrintable(QStringLiteral("no such directory: %1 - is MUDLET_TEST_DIR right?").arg(directory))); + const QStringList sources = dir.entryList({QStringLiteral("*.cpp")}, QDir::Files, QDir::Name); + // This file is scanned along with the rest: its fixtures spell the + // stale recipe out inside string literals, so the sweep staying + // green is what says a quoted recipe does not read as a call. + for (const QString& name : sources) { + QFile source(dir.filePath(name)); + QVERIFY2(source.open(QIODevice::ReadOnly | QIODevice::Text), qPrintable(source.fileName())); + ++scanned; + const QStringList stale = staleRecipes(QString::fromUtf8(source.readAll())); + for (const QString& problem : stale) { + problems.append(QStringLiteral("%1 %2").arg(name, problem)); + } + } + } + QVERIFY2(scanned > 50, qPrintable(QStringLiteral("only %1 sources scanned, so this test would pass whatever they hold").arg(scanned))); + QVERIFY2(problems.isEmpty(), qPrintable(QStringLiteral("tests seeding the pre-#9712 XDG opt-in, which can resolve to the real ~/.config/mudlet:\n%1").arg(problems.join(QChar(u'\n'))))); + } +}; + +QTEST_GUILESS_MAIN(XdgRecipeConsistencyTest) + +#include "XdgRecipeConsistencyTest.moc" diff --git a/test/functional_tests/ProfileLifecycleTest.cpp b/test/functional_tests/ProfileLifecycleTest.cpp index a54ed5bf5..3da8d3469 100644 --- a/test/functional_tests/ProfileLifecycleTest.cpp +++ b/test/functional_tests/ProfileLifecycleTest.cpp @@ -312,9 +312,9 @@ private slots: initializeQRCResourcesForProfileLifecycleTest(); QVERIFY(mConfigDir.isValid()); - // an existing $XDG_CONFIG_HOME/mudlet makes setupConfig() adopt it, so - // the profiles these tests enumerate are only ever their own - QVERIFY(QDir().mkpath(qsl("%1/mudlet").arg(mConfigDir.path()))); + // $XDG_CONFIG_HOME/mudlet/profiles is the opt-in that makes setupConfig() + // adopt it, so the profiles these tests enumerate are only ever their own + QVERIFY(QDir().mkpath(qsl("%1/mudlet/profiles").arg(mConfigDir.path()))); mSavedXdgConfigHome = qgetenv("XDG_CONFIG_HOME"); qputenv("XDG_CONFIG_HOME", mConfigDir.path().toUtf8()); From 02a29fd6f4b00ad8188720898d8f00c7403ec22e Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Tue, 11 Aug 2026 12:56:57 +0200 Subject: [PATCH 152/155] infrastructure: fix the main window restore baseline the map dock invalidates (#9828) #### Brief overview of PR changes/additions - The "Main window size and saved layout" specs read the size to put the window back to before the first resize of the run. A dock another spec file leaves open - the map widget - only takes its width out of the console at the next re-layout, which is that resize, so the baseline is a size the window can no longer be put back to and `restoreMainWindowSize()` never converges. - The baseline is now read after asking for the original size again, so it is a size the window has actually been. - This is the failure development's ubuntu Lua leg is red on: `UI_spec.lua @ 5228 the main window can be put back the size it was`. **Test case:** running `Mapper_spec` and `UI_spec` together reproduces the CI failure exactly and this clears it; `UI_spec` on its own and a second run over the same profile are unaffected. Assisted-by: Claude:claude-opus-5 --- src/mudlet-lua/tests/UI_spec.lua | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/src/mudlet-lua/tests/UI_spec.lua b/src/mudlet-lua/tests/UI_spec.lua index a217b9b5c..578e8c285 100644 --- a/src/mudlet-lua/tests/UI_spec.lua +++ b/src/mudlet-lua/tests/UI_spec.lua @@ -5177,15 +5177,24 @@ describe("Main window size and saved layout", function() end setup(function() - originalWidth, originalHeight = getMainWindowSize() - measurable = testMode and originalWidth > 0 and originalHeight > 0 + local firstWidth, firstHeight = getMainWindowSize() + measurable = testMode and firstWidth > 0 and firstHeight > 0 if not measurable then return end - setMainWindowSize(originalWidth + 300, originalHeight + 300) + setMainWindowSize(firstWidth + 300, firstHeight + 300) pumpEvents(200) local width, height = getMainWindowSize() - resizable = width > originalWidth and height > originalHeight + resizable = width > firstWidth and height > firstHeight + + -- A dock another spec file left open - the map widget is the one that does + -- this - only takes its width out of the console at the next re-layout, + -- which is the resize just above. So the size to put the window back to is + -- read after asking for the first one again rather than before: a size the + -- window has actually been is a size it can be put back to. + setMainWindowSize(firstWidth, firstHeight) + pumpEvents(200) + originalWidth, originalHeight = getMainWindowSize() restoreMainWindowSize() end) From 9ac4f72050ff6f1894a80fde7c4d78a678d18ad3 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Tue, 11 Aug 2026 19:13:19 +0200 Subject: [PATCH 153/155] fix: notepad, IRC client and toolbars outliving their profile (#9706) #### Brief overview of PR changes/additions - The notepad and IRC client are parentless windows freed only in `Host::closeChildren()`; a `Host` destroyed without that call orphaned them. `~Host()` now closes and deletes them, nulling each `QPointer` first so both teardown paths stay single-delete. Closing (not just deleting) the notepad also saves the notes and window state. - The toolbars are not leaked at exit, but survived their profile on screen holding a freed `TAction`; `~Host()` now deletes them synchronously. #### Motivation for adding to Mudlet Same defect class PR #9700 "fix: trigger editor and deleted item subtrees leaking memory" fixed for the editor. Two narrow production paths reach `~Host()` without `closeChildren()` (`requestClose()` returns early when `mpConsole` is already gone, and `~HostManager` runs from `~mudlet`), and the test harness takes the second on every run. #### Other info (issues closed, discussion etc) Test case: new `HostChildTeardownTest` - three teardown orderings, each fails without the fix; under ASan+LSan the binary goes from 851,208 to 3,334 leaked bytes (residue is the settings floor fixed in #9694). 79/79 functional tests pass twice; profile-close/quit with the notepad open are clean under ASan on Xvfb. Assisted-by: Claude:claude-opus-5 --- 3rdparty/edbee-lib | 2 +- src/Host.cpp | 18 + test/functional_tests/CMakeLists.txt | 1 + .../HostChildTeardownTest.cpp | 347 ++++++++++++++++++ 4 files changed, 367 insertions(+), 1 deletion(-) create mode 100644 test/functional_tests/HostChildTeardownTest.cpp diff --git a/3rdparty/edbee-lib b/3rdparty/edbee-lib index 62ca70905..a3ae51bbb 160000 --- a/3rdparty/edbee-lib +++ b/3rdparty/edbee-lib @@ -1 +1 @@ -Subproject commit 62ca70905d5d60ccafeb45137596bfb5e55e2936 +Subproject commit a3ae51bbb82158366b3d5c4030a54981db688892 diff --git a/src/Host.cpp b/src/Host.cpp index f23f17635..5a23f9c8a 100644 --- a/src/Host.cpp +++ b/src/Host.cpp @@ -465,6 +465,24 @@ Host::~Host() delete pEditor; } + if (auto* pNotePad = mpNotePad.data()) { + if (mudlet::self()) { + pNotePad->save(); + pNotePad->close(); + } + mpNotePad = nullptr; + delete pNotePad; + } + + if (auto* pDlgIRC = mpDlgIRC.data()) { + mpDlgIRC = nullptr; + delete pDlgIRC; + } + + for (const auto& pToolBar : mActionUnit.getToolBarList()) { + delete pToolBar.data(); + } + // This needs to be cleared here while the Host object is still valid, // otherwise it'll be cleared when the Host object is being destroyed, // which can lead to a crash when closing multiple profiles at once. diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index cf739738b..6f23abef7 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -56,6 +56,7 @@ set(FUNCTIONAL_TEST_SOURCES ProfileFolderNameTest.cpp ProfileDeletionSafetyTest.cpp DialogTeardownTest.cpp + HostChildTeardownTest.cpp ConnectionDialogCrashTest.cpp EdbeeReinitTest.cpp TMediaLoopTest.cpp diff --git a/test/functional_tests/HostChildTeardownTest.cpp b/test/functional_tests/HostChildTeardownTest.cpp new file mode 100644 index 000000000..973ae9611 --- /dev/null +++ b/test/functional_tests/HostChildTeardownTest.cpp @@ -0,0 +1,347 @@ +/*************************************************************************** + * Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +/* + * The notepad, the IRC client and the toolbars an action puts on the main + * window are created without a Host parent, so nothing disposes of them along + * with the profile unless the teardown does it by hand. Each test takes one of + * the three orderings a Host goes away in and asserts the same thing: once the + * Host is gone, so are its windows. The QPointers make a leak provable in any + * build; an AddressSanitizer build additionally catches a double delete. + * + * Run with: ctest -R HostChildTeardownTest -V + */ + +#include <QtTest/QtTest> +#include <chrono> + +#include <QJsonArray> +#include <QJsonDocument> +#include <QJsonObject> +#include <QPlainTextEdit> + +#include "ActionUnit.h" +#include "Host.h" +#include "HostManager.h" +#include "MudletInstanceCoordinator.h" +#include "TAction.h" +#include "TMainConsole.h" +#include "TToolBar.h" +#include "TelnetServerStub.h" +#include "dlgConnectionProfiles.h" +#include "dlgIRC.h" +#include "dlgNotepad.h" +#include "mudlet.h" + +using namespace std::chrono_literals; + +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); +void initializeQRCResourcesForHostChildTeardownTest(); + +class HostChildTeardownTest : public QObject +{ + Q_OBJECT + +private: + TelnetServerStub* mpServer = nullptr; + QString mPort; + const QString mLocalhost = qsl("localhost"); + + void deleteProfileDirectory(const QString& profileName) + { + QDir dir(mudlet::getMudletPath(enums::profileHomePath, profileName)); + if (dir.exists()) { + dir.removeRecursively(); + } + } + + Host* startProfile(const QString& profileName) + { + deleteProfileDirectory(profileName); + + const QString address = mLocalhost; + const QString port = mPort; + QTimer::singleShot(0ms, qApp, [profileName, address, port]() { + mudlet::self()->startAutoLogin({}); + QTest::qWait(100ms); + QTest::mouseClick(mudlet::self()->mpConnectionDialog->new_profile_button, Qt::LeftButton); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), profileName); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), address); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), port); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Return); + }); + + QSignalSpy spy(mudlet::self(), &mudlet::signal_profileLoaded); + if (!spy.wait(5000)) { + return nullptr; + } + return mudlet::self()->getActiveHost(); + } + + // A root action set to be a floating toolbar is what puts a TToolBar on the + // main window, once the unit is asked to regenerate its toolbars. + void createToolBarAction(Host* pHost, const QString& name) + { + auto* pAction = new TAction(name, pHost); + pAction->setCommandButtonUp(QString()); + pAction->setCommandButtonDown(QString()); + pAction->setIsPushDownButton(false); + pAction->setIsFolder(true); + pAction->mLocation = 4; // floating/dockable toolbar + pAction->mOrientation = 1; + pAction->setScript(QString()); + pAction->setIsActive(true); + pAction->registerAction(); + } + + struct OpenWindows + { + QPointer<dlgNotepad> notePad; + QPointer<dlgIRC> dlgIrc; + // two of them, so that the loop in ~Host() is made to iterate + QList<QPointer<TToolBar>> toolBars; + }; + + OpenWindows openEveryChildWindow(Host* pHost) + { + OpenWindows windows; + + mudlet::self()->slot_notes(); + windows.notePad = pHost->mpNotePad; + if (windows.notePad) { + if (auto* note = qobject_cast<QPlainTextEdit*>(windows.notePad->tabWidget->widget(0))) { + note->setPlainText(csmNoteText); + } + } + + // built directly rather than through openIrc(), which would connect to + // the network + pHost->mpDlgIRC = new dlgIRC(pHost); + pHost->mpDlgIRC->show(); + windows.dlgIrc = pHost->mpDlgIRC; + + createToolBarAction(pHost, qsl("HostChildTeardown toolbar")); + createToolBarAction(pHost, qsl("HostChildTeardown second toolbar")); + pHost->getActionUnit()->updateAllToolbars(); + for (const auto& pToolBar : pHost->getActionUnit()->getToolBarList()) { + windows.toolBars.append(pToolBar); + } + return windows; + } + + static QStringList windowsLeftBehind(const OpenWindows& windows) + { + QStringList leftBehind; + if (windows.notePad) { + leftBehind << qsl("the notepad"); + } + if (windows.dlgIrc) { + leftBehind << qsl("the IRC client"); + } + for (const auto& pToolBar : windows.toolBars) { + if (pToolBar) { + leftBehind << qsl("a toolbar"); + } + } + return leftBehind; + } + + static bool everyWindowWasOpened(const OpenWindows& windows) { return windows.notePad && windows.dlgIrc && windows.toolBars.size() == 2 && windows.toolBars.at(0) && windows.toolBars.at(1); } + + static inline const QString csmNoteText = qsl("HostChildTeardown note text"); + + QString noteContentOnDisk(const QString& profileName) const + { + QFile file(mudlet::getMudletPath(enums::profileDataItemPath, profileName, qsl("notes.json"))); + if (!file.open(QIODevice::ReadOnly)) { + return QString(); + } + const QJsonObject root = QJsonDocument::fromJson(file.readAll()).object(); + const QJsonArray tabs = root.value(qsl("tabs")).toArray(); + if (tabs.isEmpty()) { + return QString(); + } + return tabs.at(0).toObject().value(qsl("content")).toString(); + } + + OpenWindows mWindowsLeftOpenAtTheEnd; + bool mLeftOpenProfileWasSetUp = false; + const QString mProfileLeftOpenAtTheEnd = qsl("HostChildTeardown-LeftOpen"); + +private slots: + void initTestCase() + { + initializeQRCResourcesForHostChildTeardownTest(); + + mpServer = new TelnetServerStub(qApp); + mpServer->start(mLocalhost, 0); // ephemeral OS-assigned port avoids collisions across concurrent test runs + // a stub that failed to bind only warns, and every test would then + // report the profile as slow to load instead + QVERIFY2(mpServer->serverPort() != 0, "The telnet stub did not start listening"); + mPort = QString::number(mpServer->serverPort()); + mudlet::start(); + mudlet::self()->setupConfig(); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique<MudletInstanceCoordinator>(qsl("MudletInstanceCoordinator"))); + mudlet::self()->init(); + mudlet::self()->setStorePasswordsSecurely(false); + } + + // A test that stops at a failed assertion leaves its Host in the pool, and + // getActiveHost() could then hand the next test the wrong one. The profile + // the last test leaves open on purpose is deliberately not named here. + void cleanup() + { + for (const QString& profileName : {qsl("HostChildTeardown-NoCloseChildren"), qsl("HostChildTeardown-CloseChildren")}) { + if (mudlet::self()->getHostManager().getHost(profileName)) { + mudlet::self()->getHostManager().deleteHost(profileName); + } + deleteProfileDirectory(profileName); + } + } + + void cleanupTestCase() + { + delete mpServer; + mpServer = nullptr; + + // getMudletPath() reads the main window, so the path has to be taken + // while there still is one + const QString leftOpenProfilePath = mudlet::getMudletPath(enums::profileHomePath, mProfileLeftOpenAtTheEnd); + + // The third ordering: a profile still loaded when the main window goes, + // so the Host is destroyed with no close of any kind asked for. + QVERIFY2(mLeftOpenProfileWasSetUp, "The profile this checks on was never opened, so the check below would pass on three null pointers"); + delete mudlet::self(); + // Only the notepad and the IRC client carry weight here: the toolbars + // are children of the main window, so ~QWidget frees them either way. + const QStringList leftBehind = windowsLeftBehind(mWindowsLeftOpenAtTheEnd); + QVERIFY2(leftBehind.isEmpty(), qPrintable(qsl("Destroying the main window left %1 of the profile that was still loaded behind").arg(leftBehind.join(qsl(" and "))))); + + QDir(leftOpenProfilePath).removeRecursively(); + } + + // Nothing calls closeChildren(): the host pool simply lets go of the Host. + // Mudlet reaches this whenever the profile's main console has already gone, + // as Host::requestClose() then returns before it gets to closeChildren(). + void test_destroyingTheHostTakesItsWindowsWithIt() + { + const QString profileName = qsl("HostChildTeardown-NoCloseChildren"); + Host* pHost = startProfile(profileName); + QVERIFY2(pHost, "Profile took too long to load"); + + const OpenWindows windows = openEveryChildWindow(pHost); + QVERIFY2(everyWindowWasOpened(windows), "Not all of the profile's windows were opened"); + + // forceClose() stops TMainConsole::closeEvent() asking whether to save, + // which would block on a modal dialog here + pHost->forceClose(); + pHost->mpConsole->close(); + QTRY_VERIFY2(pHost->mpConsole.isNull(), "The main console did not go away"); // Qt 6 disposes of a WA_DeleteOnClose widget by deleteLater() + QVERIFY2(pHost->requestClose(), "Closing the profile was refused"); + QVERIFY2(pHost->mpNotePad, "requestClose() reached closeChildren() after all - this no longer tests a Host that skips it"); + + const QPointer<Host> hostGuard(pHost); + pHost = nullptr; + mudlet::self()->getHostManager().deleteHost(profileName); + QVERIFY2(hostGuard.isNull(), "The Host outlived deleteHost(), so ~Host() never ran"); + + const QStringList leftBehind = windowsLeftBehind(windows); + QVERIFY2(leftBehind.isEmpty(), qPrintable(qsl("Destroying the Host left %1 behind").arg(leftBehind.join(qsl(" and "))))); + // only reaches the disk if ~Host() closed the notepad rather than just + // deleting it + QCOMPARE(noteContentOnDisk(profileName), csmNoteText); + + deleteProfileDirectory(profileName); + } + + // closeChildren() disposes of these windows through deleteLater(), and + // mudlet::closeEvent() destroys the Host in the same call stack, so ~Host() + // meets windows whose deferred delete has not run yet. + void test_closeChildrenFollowedByDestructionIsSafe() + { + const QString profileName = qsl("HostChildTeardown-CloseChildren"); + Host* pHost = startProfile(profileName); + QVERIFY2(pHost, "Profile took too long to load"); + + const OpenWindows windows = openEveryChildWindow(pHost); + QVERIFY2(everyWindowWasOpened(windows), "Not all of the profile's windows were opened"); + + pHost->forceClose(); + QVERIFY2(pHost->requestClose(), "Closing the profile was refused"); + QVERIFY2(windows.notePad, "The notepad was disposed of before this could test what happens when it has not been"); + // deliberately no event loop turn before this: mudlet::closeEvent() does + // not give one either, which is what leaves the deferred deletes pending + const QPointer<Host> hostGuard(pHost); + pHost = nullptr; + mudlet::self()->getHostManager().deleteHost(profileName); + QVERIFY2(hostGuard.isNull(), "The Host outlived deleteHost(), so ~Host() never ran"); + + // checked before the event loop gets a turn, so that the deletes + // closeChildren() deferred cannot be what satisfies it + for (const auto& pToolBar : windows.toolBars) { + QVERIFY2(pToolBar.isNull(), "Destroying the Host did not delete a toolbar closeChildren() had only queued"); + } + + // letting what closeChildren() deferred run is where a second delete of + // anything ~Host() already took would land + QTRY_VERIFY2(windowsLeftBehind(windows).isEmpty(), "Closing and then destroying the Host left one of its windows behind"); + deleteProfileDirectory(profileName); + } + + // cleanupTestCase() is what destroys the main window on top of it. + void test_leaveAProfileOpenForTheMainWindowToTakeDown() + { + Host* pHost = startProfile(mProfileLeftOpenAtTheEnd); + QVERIFY2(pHost, "Profile took too long to load"); + + mWindowsLeftOpenAtTheEnd = openEveryChildWindow(pHost); + QVERIFY2(everyWindowWasOpened(mWindowsLeftOpenAtTheEnd), "Not all of the profile's windows were opened"); + mLeftOpenProfileWasSetUp = true; + } +}; + +void initializeQRCResourcesForHostChildTeardownTest() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +#include "HostChildTeardownTest.moc" +QTEST_MAIN(HostChildTeardownTest) From 074c6ef08dd6ec8526f21f32e3071b74e70479db Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Tue, 11 Aug 2026 19:13:35 +0200 Subject: [PATCH 154/155] improve: "Copy as image" now works without selecting text first (#9738) #### Brief overview of PR changes/additions - "Copy as image" with nothing selected now copies the visible screen (timestamps included) instead of doing nothing. With a selection it is unchanged. - Copy, Copy HTML and Search on ... genuinely need a selection, so without one they are greyed out with a tooltip saying so rather than silently doing nothing. - Copy as image no longer wipes the clipboard when it runs out of its 3s budget, crops the drawn lines instead of squashing the whole selection to fit, and copies a run of blank lines rather than nothing. #### Motivation for adding to Mudlet Right-clicking the console and picking "Copy as image" left nothing on the clipboard, with no hint that a selection was needed. #### Other info (issues closed, discussion etc) Fixes #9715 Also fixes two ways a selection could outlive the lines it covers: clearing a console now clears its selection (`clearWindow()` then "Copy as image" aborted on Qt's bounds assert), and a selection stranded by the buffer hitting its size limit is followed down with its lines instead of copying whatever took their place. New `CopyAsImageTest` functional test, 15 cases. Verified on X11 with `xclip -selection clipboard -t image/png -o`. Assisted-by: Claude:claude-opus-5 **Test case:** Right-click the main console with nothing selected, pick "Copy as image", and paste - you get a picture of the screen. Select some text and repeat - you get just the selection. --- src/TConsole.cpp | 3 + src/TTextEdit.cpp | 142 +++++- src/TTextEdit.h | 3 + test/functional_tests/CMakeLists.txt | 4 + test/functional_tests/CopyAsImageTest.cpp | 589 ++++++++++++++++++++++ 5 files changed, 720 insertions(+), 21 deletions(-) create mode 100644 test/functional_tests/CopyAsImageTest.cpp diff --git a/src/TConsole.cpp b/src/TConsole.cpp index 9c926401f..3386245cd 100644 --- a/src/TConsole.cpp +++ b/src/TConsole.cpp @@ -880,6 +880,9 @@ void TConsole::refresh() void TConsole::clear() { mUpperPane->resetHScrollbar(); + // before the buffer goes, or the selection is left pointing at lines that + // no longer exist and the copy actions work on out of range indices + clearSelection(); buffer.clear(); clearSplit(); mUpperPane->update(); diff --git a/src/TTextEdit.cpp b/src/TTextEdit.cpp index 89aecd984..3b1ed66ca 100644 --- a/src/TTextEdit.cpp +++ b/src/TTextEdit.cpp @@ -39,6 +39,7 @@ #include "widechar_width.h" #include "TTextProperties.h" +#include <algorithm> #include <chrono> #include <cmath> #include <QtEvents> @@ -2166,20 +2167,24 @@ void TTextEdit::slot_copySelectionToClipboardHTML() // matches slot_copySelectionToClipboard(), which also keeps the selection. } +// The part of establishSelectedText()'s bail-out that is cheap enough to check +// while building the context menu; its remaining checks (font metrics, pane +// size) hold for any console the user can right-click on. +bool TTextEdit::hasSelectedText() const +{ + return !mpBuffer->lineBuffer.isEmpty() && !mSelectedRegion.isEmpty(); +} + bool TTextEdit::establishSelectedText() { - if (mpBuffer->lineBuffer.isEmpty()) { - // Prevent problems with trying to do a copy when TBuffer is empty: + if (!hasSelectedText()) { return false; } // if selection was made backwards swap // right to left if (mFontWidth <= 0 || mFontHeight <= 0) { - return false; - } - - if (mSelectedRegion == QRegion(0, 0, 0, 0)) { + qWarning().nospace() << "TTextEdit::establishSelectedText() ERROR - font is " << mFontWidth << "x" << mFontHeight << " so the selection cannot be worked out"; return false; } @@ -2187,6 +2192,7 @@ bool TTextEdit::establishSelectedText() mScreenHeight = height() / mFontHeight; mScreenWidth = 100; if (mScreenHeight <= 0) { + qWarning().nospace() << "TTextEdit::establishSelectedText() ERROR - pane is only " << height() << "px high, too short for a line of text"; return false; } if (mpConsole->getType() == TConsole::MainConsole && !mIsLowerPane) { @@ -2201,6 +2207,18 @@ bool TTextEdit::establishSelectedText() return true; } +// [first, last] line numbers, not clamped to the buffer - the caller must do that. +std::pair<int, int> TTextEdit::visibleLines() +{ + if (mScreenHeight <= 0) { + // imageTopLine() works the top line out from mScreenHeight, so repair it + // first or the two disagree by a whole screen + mScreenHeight = std::max(1, height() / mFontHeight); + } + const int firstLine = std::max(0, imageTopLine()); + return {firstLine, firstLine + mScreenHeight - 1}; +} + // Technically this copies whole lines into the image even if the selection does // not start at the beginning of the first line or end at the last grapheme on // the last line. @@ -2208,17 +2226,55 @@ void TTextEdit::slot_copySelectionToClipboardImage() { mCopyImageStartTime = std::chrono::high_resolution_clock::now(); - if (!establishSelectedText()) { + if (mFontWidth <= 0 || mFontHeight <= 0) { + qWarning().nospace() << "TTextEdit::slot_copySelectionToClipboardImage() ERROR - font is " << mFontWidth << "x" << mFontHeight << ", nothing was copied to the clipboard"; return; } + // drawLine() reads both halves of the buffer, so neither may be indexed past + // its end: + const int lastBufferLine = std::min(mpBuffer->lineBuffer.size(), static_cast<qsizetype>(mpBuffer->buffer.size())) - 1; + if (lastBufferLine < 0) { + qWarning() << "TTextEdit::slot_copySelectionToClipboardImage() ERROR - there is nothing in this console to copy"; + return; + } + + // Unlike Copy and Copy HTML, "as image" has an obvious default when nothing + // is selected: a picture of what the user is looking at (#9715). + bool copyingSelection = establishSelectedText(); + if (copyingSelection && mPB.y() > lastBufferLine) { + // Lines lost off the front of a buffer that reached its limit shift every + // remaining index down; getSelectedText() compensates the same way. mPA + // and mPB move rather than a copy of them, so that the deselect below + // still finds the characters that are about to be drawn. + const int shift = mpBuffer->mBatchDeleteSize; + if (mPA.y() - shift >= 0 && mPB.y() - shift <= lastBufferLine) { + mPA.ry() -= shift; + mPB.ry() -= shift; + } else { + // The selected lines are gone for good, so copy the visible area + // rather than whatever has since taken their place in the buffer. + copyingSelection = false; + } + } + + int firstLine = mPA.y(); + int lastLine = mPB.y(); + if (!copyingSelection) { + const auto [firstVisible, lastVisible] = visibleLines(); + firstLine = firstVisible; + lastLine = lastVisible; + } + firstLine = std::clamp(firstLine, 0, lastBufferLine); + lastLine = std::clamp(lastLine, firstLine, lastBufferLine); + // Qt says: "Maximum supported image dimension is 65500 pixels" in stdout - auto heightpx = std::min(65500, (mPB.y() - mPA.y() + 1) * mFontHeight); - auto lineOffset = mPA.y(); + auto heightpx = std::min(65500, (lastLine - firstLine + 1) * mFontHeight); + auto lineOffset = firstLine; // find the biggest width of text we need to work with int largestLine{}; - for (int y = mPA.y(), total = mPB.y() + 1; y < total; ++y) { + for (int y = firstLine, total = lastLine + 1; y < total; ++y) { const QString lineText{mpBuffer->lineBuffer.at(y)}; // Will accumulate the width in pixels of the current line: auto lineWidth{(mpConsole->showTimeStamps() ? mudlet::smTimeStampFormat.size() : 0) * mFontWidth}; @@ -2249,8 +2305,11 @@ void TTextEdit::slot_copySelectionToClipboardImage() largestLine = std::max(static_cast<int>(lineWidth), largestLine); } - auto widthpx = std::min(65500, largestLine); - auto rect = QRect(mPA.x(), mPA.y(), widthpx, heightpx); + // A zero width pixmap is null, so the painter below never activates and + // nothing at all reaches the clipboard. Floor the width at one character so a + // run of only blank lines (which is what makes largestLine zero) still copies: + auto widthpx = std::max(mFontWidth, std::min(65500, largestLine)); + auto rect = QRect(0, 0, widthpx, heightpx); // The bottom line's ink can reach past its cell, so paint into a spare row // and keep only as much of it as the glyphs actually used. auto pixmap = QPixmap(widthpx, std::min(65500, heightpx + mFontHeight)); @@ -2260,23 +2319,34 @@ void TTextEdit::slot_copySelectionToClipboardImage() QPainter painter(&pixmap); if (!painter.isActive()) { + qWarning().nospace() << "TTextEdit::slot_copySelectionToClipboardImage() ERROR - cannot paint a " << widthpx << "x" << heightpx << " image, nothing was copied to the clipboard"; return; } - // deselect to prevent inverted colours in image - unHighlight(); - mSelectedRegion = QRegion(0, 0, 0, 0); + if (copyingSelection) { + // deselect to prevent inverted colours in image + unHighlight(); + mSelectedRegion = QRegion(0, 0, 0, 0); + } auto result = drawTextForClipboard(painter, rect, lineOffset); - painter.end(); - highlightSelection(); + if (copyingSelection) { + highlightSelection(); + } + // the pixmap cannot be read back while a painter is still active on it + painter.end(); const QImage image = pixmap.toImage(); int keepHeight = heightpx + overflowRowsUsed(image, heightpx, solidColor); if (!result.first) { - // ran out of time, so cut back to the lines that did get painted - keepHeight = std::max(1, result.second * mFontHeight); + // Crop rather than scale an abandoned copy: scaling to fit would squash + // the lines that did get drawn instead of dropping the rest. + keepHeight = result.second * mFontHeight; + if (keepHeight <= 0) { + qWarning() << "TTextEdit::slot_copySelectionToClipboardImage() ERROR - ran out of time before drawing a single line, nothing was copied to the clipboard"; + return; + } } QApplication::clipboard()->setImage(image.copy(0, 0, widthpx, std::min(image.height(), keepHeight))); } @@ -2310,7 +2380,7 @@ std::pair<bool, int> TTextEdit::drawTextForClipboard(QPainter& painter, QRect re const TChar timeStampStyle = timeStampCharStyle(); LineLayout previousLine; LineLayout currentLine; - for (int i = 0; i < lineCount; i++, linesDrawn++) { + for (int i = 0; i < lineCount; ++i) { if (!hasBufferLine(i + lineOffset)) { break; } @@ -2319,9 +2389,12 @@ std::pair<bool, int> TTextEdit::drawTextForClipboard(QPainter& painter, QRect re paintBackgrounds(painter, currentLine); paintForegrounds(painter, previousLine); previousLine.swap(currentLine); + // counted here rather than in the loop's increment, so that the timeout + // below reports the line it just drew instead of the one before it + ++linesDrawn; if (std::chrono::duration_cast<std::chrono::seconds>(std::chrono::high_resolution_clock::now() - mCopyImageStartTime).count() >= timeout) { - qDebug().nospace() << "timeout for image copy (" << timeout << "s) reached, managed to draw " << i << " lines"; + qDebug().nospace() << "timeout for image copy (" << timeout << "s) reached, managed to draw " << linesDrawn << " lines"; paintForegrounds(painter, previousLine); return {false, linesDrawn}; } @@ -2548,6 +2621,10 @@ void TTextEdit::mouseReleaseEvent(QMouseEvent* event) popup->setAttribute(Qt::WA_DeleteOnClose); popup->setToolTipsVisible(true); // Not the default... + //: Tooltip shown on the console context menu's copy and search entries while they are disabled because nothing is selected + const QString noSelectionHint = utils::richText(tr("Select some text in the console first.")); + const bool selectionAvailable = hasSelectedText(); + QAction* action = new QAction(tr("Copy"), popup); // According to the Qt Documentation: // "This text is used for the tooltip." @@ -2564,6 +2641,7 @@ void TTextEdit::mouseReleaseEvent(QMouseEvent* event) connect(action2, &QAction::triggered, this, &TTextEdit::slot_copySelectionToClipboardHTML); auto* actionCopyImage = new QAction(tr("Copy as image"), popup); + actionCopyImage->setToolTip(QString()); connect(actionCopyImage, &QAction::triggered, this, &TTextEdit::slot_copySelectionToClipboardImage); QAction* action3 = new QAction(tr("Select all"), popup); @@ -2574,6 +2652,28 @@ void TTextEdit::mouseReleaseEvent(QMouseEvent* event) QAction* action4 = new QAction(tr("Search on %1").arg(selectedEngine), popup); action4->setToolTip(QString()); connect(action4, &QAction::triggered, this, &TTextEdit::slot_searchSelectionOnline); + + // These have no sensible whole-console fallback, so they are disabled with + // a reason rather than left as entries that quietly do nothing. "Copy as + // image" is not among them: it falls back to the visible area (#9715). + // The object names let tests find each entry without matching translated text: + const QVector<std::pair<QAction*, QString>> selectionActions{{action, qsl("consoleCopy")}, {action2, qsl("consoleCopyHtml")}, {action4, qsl("consoleSearchOnline")}}; + for (const auto& [selectionAction, objectName] : selectionActions) { + selectionAction->setObjectName(objectName); + selectionAction->setEnabled(selectionAvailable); + if (!selectionAvailable) { + selectionAction->setToolTip(noSelectionHint); + } + } + action3->setObjectName(qsl("consoleSelectAll")); + + actionCopyImage->setObjectName(qsl("consoleCopyAsImage")); + if (mpBuffer->lineBuffer.isEmpty()) { + actionCopyImage->setEnabled(false); + //: Tooltip shown on the console context menu's "Copy as image" entry while it is disabled because the console holds no text at all + actionCopyImage->setToolTip(utils::richText(tr("This console is empty, there is nothing to copy."))); + } + if (!qApp->testAttribute(Qt::AA_DontShowIconsInMenus)) { action->setIcon(QIcon::fromTheme(qsl("edit-copy"), QIcon(qsl(":/icons/edit-copy.png")))); action3->setIcon(QIcon::fromTheme(qsl("edit-select-all"), QIcon(qsl(":/icons/edit-select-all.png")))); diff --git a/src/TTextEdit.h b/src/TTextEdit.h index 5b721c0d1..fa6a02985 100644 --- a/src/TTextEdit.h +++ b/src/TTextEdit.h @@ -125,6 +125,7 @@ public: // long enough again. int mOldCaretColumn = 0; + friend class CopyAsImageTest; friend class TTextEditBlinkTest; static bool shouldRegisterBlinkClient(bool enableBlinkText, bool hasBlinkingContentInRedrawnRegion, bool isBlinkClientRegistered, bool reusedCachedScreenContent); @@ -189,6 +190,8 @@ private: void normaliseSelection(); void updateTextCursor(const QMouseEvent* event, int lineIndex, int tCharIndex, bool isOutOfbounds); bool establishSelectedText(); + bool hasSelectedText() const; + std::pair<int, int> visibleLines(); void expandSelectionToWords(); void expandSelectionToLine(int); inline void replaceControlCharacterWith_Picture(const uint, const QString&, const int, QString&, int&) const; diff --git a/test/functional_tests/CMakeLists.txt b/test/functional_tests/CMakeLists.txt index 6f23abef7..50eaf52d9 100644 --- a/test/functional_tests/CMakeLists.txt +++ b/test/functional_tests/CMakeLists.txt @@ -31,6 +31,7 @@ set(FUNCTIONAL_TEST_SOURCES ProfileLifecycleTest.cpp MxpFramePlacementTest.cpp ColorTriggerFilterChildTest.cpp + CopyAsImageTest.cpp GlyphOverflowTest.cpp GMCPCharLoginTest.cpp InsertTextCapTest.cpp @@ -202,6 +203,9 @@ set_tests_properties(ConnectionDialogCrashTest PROPERTIES TIMEOUT 300) # NarrowWindowWrapTest creates a fresh profile per test method, so it needs a longer timeout set_tests_properties(NarrowWindowWrapTest PROPERTIES TIMEOUT 300) +# CopyAsImageTest creates a fresh profile per test method, so it needs a longer timeout +set_tests_properties(CopyAsImageTest PROPERTIES TIMEOUT 300) + # TDiscordModeTest drives the real discord-rpc library end-to-end. The library's # reconnect backoff is a process-global (60s ceiling) that the suite's # init/shutdown churn can inflate, so a fresh handshake can take a while (see diff --git a/test/functional_tests/CopyAsImageTest.cpp b/test/functional_tests/CopyAsImageTest.cpp new file mode 100644 index 000000000..918766d21 --- /dev/null +++ b/test/functional_tests/CopyAsImageTest.cpp @@ -0,0 +1,589 @@ +/*************************************************************************** + * Copyright (C) 2026 by Vadim Peretokin - vadim.peretokin@mudlet.org * + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + * This program is distributed in the hope that it will be useful, * + * but WITHOUT ANY WARRANTY; without even the implied warranty of * + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * + * GNU General Public License for more details. * + * * + * You should have received a copy of the GNU General Public License * + * along with this program; if not, write to the * + * Free Software Foundation, Inc., * + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + ***************************************************************************/ + +#include <QClipboard> +#include <QtTest/QtTest> +#include <chrono> + +#include "Host.h" +#include "MudletInstanceCoordinator.h" +#include "TBuffer.h" +#include "TMainConsole.h" +#include "TTextEdit.h" +#include "TelnetServerStub.h" +#include "ctelnet.h" +#include "dlgConnectionProfiles.h" +#include "mudlet.h" + +using namespace std::chrono_literals; + +extern void qInitResources_mudlet(); +extern void qInitResources_qm(); +extern void qInitResources_additional_splash_screens(); +extern void qInitResources_mudlet_fonts_common(); +extern void qInitResources_mudlet_fonts_posix(); +void initializeQRCResources(); + +// Regression tests for #9715: the console's "Copy as image" context menu entry +// leaving nothing on the clipboard. +class CopyAsImageTest : public QObject +{ + Q_OBJECT + +private: + TelnetServerStub* mpServer = nullptr; + const QString mpHostname = "Test-CopyAsImage"; + QString mpPort; // assigned the stub's actual ephemeral port in init() + const QString mpLocalhost = "localhost"; + + QString fillerText() const + { + const QString line = QString(100, QLatin1Char('X')); + QString message; + for (int i = 0; i < 80; ++i) { + message.append(line); + message.append(QStringLiteral("\r\n")); + } + return message; + } + + TTextEdit* upperPane() const + { + auto host = mudlet::self()->getActiveHost(); + if (!host || !host->mpConsole) { + return nullptr; + } + return host->mpConsole->mUpperPane; + } + + void sendMouse(QWidget* w, QEvent::Type type, Qt::MouseButton button, Qt::MouseButtons buttons, const QPointF& localPos) + { + const QPointF globalPos = w->mapToGlobal(localPos.toPoint()); + QMouseEvent event(type, localPos, globalPos, button, buttons, Qt::NoModifier); + QApplication::sendEvent(w, &event); + } + + TTextEdit* preparePane() + { + mpServer->setWelcomeMessage(fillerText()); + if (!startProfile(mpHostname, mpLocalhost, mpPort)) { + return nullptr; + } + if (!waitForTextInBuffer(QString(100, QLatin1Char('X')))) { + return nullptr; + } + + // big enough for the multi-line drags the tests make across the pane + mudlet::self()->resize(1200, 800); + QTest::qWait(100ms); + + TTextEdit* pane = upperPane(); + if (!pane) { + return nullptr; + } + pane->unHighlight(); + pane->mSelectedRegion = QRegion(); + return pane; + } + + void dragSelection(TTextEdit* pane, const QPointF& dragOffset) + { + const QPointF startPos = QRectF(pane->rect()).center(); + const QPointF endPos = startPos + dragOffset; + sendMouse(pane, QEvent::MouseButtonPress, Qt::LeftButton, Qt::LeftButton, startPos); + sendMouse(pane, QEvent::MouseMove, Qt::NoButton, Qt::LeftButton, endPos); + sendMouse(pane, QEvent::MouseButtonRelease, Qt::LeftButton, Qt::NoButton, endPos); + } + + TTextEdit* prepareSelectedPane(const QPointF& dragOffset) + { + TTextEdit* pane = preparePane(); + if (!pane) { + return nullptr; + } + dragSelection(pane, dragOffset); + return pane; + } + + static void copyAsImage(TTextEdit* pane) + { + QApplication::clipboard()->clear(); + pane->slot_copySelectionToClipboardImage(); + } + + // mouseReleaseEvent() parents the menu to the pane, so it can be read back + // from there rather than having to be intercepted as it pops up. + QMenu* openContextMenu(TTextEdit* pane) + { + const QPointF pos = QRectF(pane->rect()).center(); + sendMouse(pane, QEvent::MouseButtonPress, Qt::RightButton, Qt::RightButton, pos); + sendMouse(pane, QEvent::MouseButtonRelease, Qt::RightButton, Qt::NoButton, pos); + return pane->findChildren<QMenu*>().value(0); + } + + static QAction* menuEntry(QMenu* menu, const QString& objectName) + { + for (QAction* action : menu->actions()) { + if (action->objectName() == objectName) { + return action; + } + } + return nullptr; + } + + // "Copy as image" is deliberately not one of these: it falls back to the + // visible screen instead of needing a selection. + static QStringList selectionEntryNames() { return {QStringLiteral("consoleCopy"), QStringLiteral("consoleCopyHtml"), QStringLiteral("consoleSearchOnline")}; } + + static int backgroundPixels(const QImage& image, const QColor& backgroundColour) + { + const QRgb background = backgroundColour.rgb() | 0xff000000; + int count = 0; + for (int y = 0; y < image.height(); ++y) { + for (int x = 0; x < image.width(); ++x) { + if ((image.pixel(x, y) | 0xff000000) == background) { + ++count; + } + } + } + return count; + } + + static bool blankImage(const QImage& image, const QColor& backgroundColour) { return backgroundPixels(image, backgroundColour) == image.width() * image.height(); } + + // Text drawn normally leaves most of the cell as background; a line drawn + // with its selection still on has the two swapped over. + static bool invertedImage(const QImage& image, const QColor& backgroundColour) { return backgroundPixels(image, backgroundColour) * 2 < image.width() * image.height(); } + + // Mimics TBuffer::shrinkBuffer() dropping the oldest lines once the buffer + // reaches its size limit, which shifts every remaining line's index down. + void shrinkBuffer(TBuffer& buffer, int lines) + { + buffer.mBatchDeleteSize = lines; + for (int i = 0; i < lines; ++i) { + buffer.lineBuffer.pop_front(); + buffer.promptBuffer.pop_front(); + buffer.timeBuffer.pop_front(); + buffer.buffer.pop_front(); + buffer.mCursorY--; + } + } + +private slots: + void initTestCase() { initializeQRCResources(); } + + void init() + { + mpServer = new TelnetServerStub(qApp); + mpServer->start(mpLocalhost, 0); // ephemeral OS-assigned port avoids collisions across concurrent test runs + mpPort = QString::number(mpServer->serverPort()); + mudlet::start(); + mudlet::self()->setupConfig(); + mudlet::self()->takeOwnershipOfInstanceCoordinator(std::make_unique<MudletInstanceCoordinator>("MudletInstanceCoordinator")); + mudlet::self()->init(); + mudlet::self()->setStorePasswordsSecurely(false); + deleteProfileDirectory(mpHostname); + } + + // #9715 as reported, driven through the menu so a mis-wired entry is caught too. + void test_noSelectionCopiesTheVisibleScreen() + { + TTextEdit* pane = preparePane(); + QVERIFY2(pane, "Could not prepare a console"); + QVERIFY(pane->mSelectedRegion.isEmpty()); + + QMenu* menu = openContextMenu(pane); + QVERIFY2(menu, "Right-clicking the console opened no context menu"); + QAction* copyAsImageEntry = menuEntry(menu, QStringLiteral("consoleCopyAsImage")); + QVERIFY2(copyAsImageEntry, "No \"Copy as image\" entry in the console context menu"); + QVERIFY2(copyAsImageEntry->isEnabled(), "\"Copy as image\" was not offered with nothing selected (regression of #9715)"); + + QApplication::clipboard()->clear(); + copyAsImageEntry->trigger(); + + const QImage image = QApplication::clipboard()->image(); + QVERIFY2(!image.isNull(), "\"Copy as image\" put nothing on the clipboard (regression of #9715)"); + QVERIFY2(!blankImage(image, pane->mBgColor), "The copied image is entirely background, no text was drawn into it"); + QCOMPARE(image.height() % pane->mFontHeight, 0); + QVERIFY2(image.height() >= 10 * pane->mFontHeight, qPrintable(QStringLiteral("Only %1 lines copied, expected a screenful").arg(image.height() / pane->mFontHeight))); + QVERIFY2(image.height() <= pane->height(), qPrintable(QStringLiteral("Copied %1px, taller than the %2px pane").arg(image.height()).arg(pane->height()))); + } + + void test_visibleScreenCopyIncludesTimestamps() + { + TTextEdit* pane = preparePane(); + QVERIFY2(pane, "Could not prepare a console"); + auto console = mudlet::self()->getActiveHost()->mpConsole; + QVERIFY(!console->showTimeStamps()); + + copyAsImage(pane); + const int widthWithoutTimestamps = QApplication::clipboard()->image().width(); + QVERIFY(widthWithoutTimestamps > 0); + + console->slot_toggleTimeStamps(true); + QVERIFY(console->showTimeStamps()); + QTest::qWait(100ms); + + copyAsImage(pane); + const QImage image = QApplication::clipboard()->image(); + QVERIFY2(!image.isNull(), "\"Copy as image\" put nothing on the clipboard with timestamps showing"); + QCOMPARE(image.width(), widthWithoutTimestamps + mudlet::smTimeStampFormat.size() * pane->mFontWidth); + } + + void test_contextMenuOffersNoSelectionOnlyEntriesWithoutSelection() + { + TTextEdit* pane = preparePane(); + QVERIFY2(pane, "Could not prepare a console"); + QVERIFY(pane->mSelectedRegion.isEmpty()); + + QMenu* menu = openContextMenu(pane); + QVERIFY2(menu, "Right-clicking the console opened no context menu"); + + for (const QString& name : selectionEntryNames()) { + QAction* entry = menuEntry(menu, name); + QVERIFY2(entry, qPrintable(QStringLiteral("No \"%1\" entry in the console context menu").arg(name))); + QVERIFY2(!entry->isEnabled(), qPrintable(QStringLiteral("\"%1\" was offered as usable with nothing selected").arg(name))); + QVERIFY2(!entry->toolTip().isEmpty(), qPrintable(QStringLiteral("\"%1\" is disabled without saying why").arg(name))); + } + + QAction* selectAll = menuEntry(menu, QStringLiteral("consoleSelectAll")); + QVERIFY(selectAll); + QVERIFY2(selectAll->isEnabled(), "\"Select all\" should not need an existing selection"); + } + + void test_contextMenuOffersCopyEntriesWithSelection() + { + TTextEdit* pane = prepareSelectedPane(QPointF(60, 0)); + QVERIFY2(pane, "Could not prepare a console with a selection"); + QVERIFY(!pane->mSelectedRegion.isEmpty()); + + QMenu* menu = openContextMenu(pane); + QVERIFY2(menu, "Right-clicking the console opened no context menu"); + + for (const QString& name : selectionEntryNames() + QStringList{QStringLiteral("consoleCopyAsImage")}) { + QAction* entry = menuEntry(menu, name); + QVERIFY2(entry, qPrintable(QStringLiteral("No \"%1\" entry in the console context menu").arg(name))); + QVERIFY2(entry->isEnabled(), qPrintable(QStringLiteral("\"%1\" was disabled even though text is selected").arg(name))); + } + } + + void test_selectionCopiesOnlyTheSelectedLines() + { + TTextEdit* pane = prepareSelectedPane(QPointF(60, 0)); + QVERIFY2(pane, "Could not prepare a console with a selection"); + + copyAsImage(pane); + + const QImage image = QApplication::clipboard()->image(); + QVERIFY2(!image.isNull(), "\"Copy as image\" put nothing on the clipboard (regression of #9715)"); + QCOMPARE(image.height(), pane->mFontHeight); + QVERIFY2(!blankImage(image, pane->mBgColor), "The copied image is entirely background, no text was drawn into it"); + } + + // The height must come from the dragged distance, not from a recomputed + // mScreenHeight. + void test_multiLineSelectionCopiesEveryLine() + { + TTextEdit* pane = preparePane(); + QVERIFY2(pane, "Could not prepare a console"); + const int expectedLines = 4; + dragSelection(pane, QPointF(60, (expectedLines - 1) * pane->mFontHeight)); + QVERIFY2(!pane->mSelectedRegion.isEmpty(), "The drag failed to create a selection"); + + copyAsImage(pane); + + const QImage image = QApplication::clipboard()->image(); + QVERIFY2(!image.isNull(), "\"Copy as image\" put nothing on the clipboard (regression of #9715)"); + QCOMPARE(image.height(), expectedLines * pane->mFontHeight); + QVERIFY2(!blankImage(image, pane->mBgColor), "The copied image is entirely background, no text was drawn into it"); + } + + void test_repeatedCopyKeepsWorking() + { + TTextEdit* pane = prepareSelectedPane(QPointF(60, 60)); + QVERIFY2(pane, "Could not prepare a console with a selection"); + + copyAsImage(pane); + const QImage first = QApplication::clipboard()->image(); + QVERIFY2(!first.isNull(), "The first \"Copy as image\" put nothing on the clipboard"); + + copyAsImage(pane); + const QImage second = QApplication::clipboard()->image(); + QVERIFY2(!second.isNull(), "A second \"Copy as image\" of the same selection put nothing on the clipboard"); + // the first copy deselects and reselects to keep inverted colours out of + // the image, so a mismatch here means it did not put the state back + QCOMPARE(second, first); + } + + // A selection can be a whole buffer long, so the copy gives up on a timeout - + // whatever it drew by then still has to reach the clipboard at its own scale. + void test_abandonedCopyKeepsTheLinesItDrew() + { + TTextEdit* pane = prepareSelectedPane(QPointF(60, 60)); + QVERIFY2(pane, "Could not prepare a console with a selection"); + + const int originalTimeout = mudlet::self()->mCopyAsImageTimeout; + // 0s of budget stops the drawing after the very first line + mudlet::self()->mCopyAsImageTimeout = 0; + copyAsImage(pane); + const QImage abandoned = QApplication::clipboard()->image(); + mudlet::self()->mCopyAsImageTimeout = originalTimeout; + + QVERIFY2(!abandoned.isNull(), "A copy that ran out of time left nothing at all on the clipboard"); + QCOMPARE(abandoned.height(), pane->mFontHeight); + + copyAsImage(pane); + const QImage complete = QApplication::clipboard()->image(); + QVERIFY2(complete.height() > abandoned.height(), "The unrestricted copy is no taller, so the abandoned one was not actually cut short"); + // scaling the abandoned copy to fit would have shrunk its width in + // proportion and resampled the one line it did draw + QCOMPARE(abandoned.width(), complete.width()); + QCOMPARE(abandoned, complete.copy(QRect(0, 0, complete.width(), abandoned.height()))); + } + + void test_blankLineSelectionCopiesAnImage() + { + TTextEdit* pane = preparePane(); + QVERIFY2(pane, "Could not prepare a console"); + // with timestamps on, a blank line is still 13 characters wide, which is + // not the zero width case this covers + QVERIFY(!mudlet::self()->getActiveHost()->mpConsole->showTimeStamps()); + + const int blankLine = firstBlankLine(); + QVERIFY2(blankLine >= 0, "The console has no blank line to select"); + + pane->mDragStart = QPoint(0, blankLine); + pane->mDragSelectionEnd = pane->mDragStart; + pane->normaliseSelection(); + pane->highlightSelection(); + QVERIFY2(!pane->mSelectedRegion.isEmpty(), "Could not select a blank line"); + + copyAsImage(pane); + + const QImage image = QApplication::clipboard()->image(); + QVERIFY2(!image.isNull(), "Copying a selection of blank lines left nothing on the clipboard"); + QCOMPARE(image.height(), pane->mFontHeight); + QCOMPARE(image.width(), pane->mFontWidth); + QVERIFY2(blankImage(image, pane->mBgColor), "A blank line copied as something other than background"); + } + + void test_emptyBufferCopiesNothingAndKeepsTheClipboard() + { + TTextEdit* pane = preparePane(); + QVERIFY2(pane, "Could not prepare a console"); + // TConsole::clear() leaves an empty line behind, so empty it by hand + auto& buffer = mudlet::self()->getActiveHost()->mpConsole->buffer; + buffer.lineBuffer.clear(); + buffer.timeBuffer.clear(); + buffer.promptBuffer.clear(); + buffer.buffer.clear(); + buffer.mCursorY = 0; + + QMenu* menu = openContextMenu(pane); + QVERIFY2(menu, "Right-clicking the console opened no context menu"); + QAction* copyAsImageEntry = menuEntry(menu, QStringLiteral("consoleCopyAsImage")); + QVERIFY(copyAsImageEntry); + QVERIFY2(!copyAsImageEntry->isEnabled(), "\"Copy as image\" was offered for a console holding no text at all"); + QVERIFY2(!copyAsImageEntry->toolTip().isEmpty(), "\"Copy as image\" is disabled without saying why"); + + QApplication::clipboard()->setText(QStringLiteral("something the user copied earlier")); + pane->slot_copySelectionToClipboardImage(); + QCOMPARE(QApplication::clipboard()->text(), QStringLiteral("something the user copied earlier")); + } + + // Clearing a console strands the selection on lines that no longer exist. + void test_copyAfterClearingTheConsole() + { + TTextEdit* pane = prepareSelectedPane(QPointF(60, 60)); + QVERIFY2(pane, "Could not prepare a console with a selection"); + + mudlet::self()->getActiveHost()->mpConsole->TConsole::clear(); + QVERIFY2(pane->mSelectedRegion.isEmpty(), "Clearing the console left a selection behind pointing at lines that are gone"); + + copyAsImage(pane); + const QImage image = QApplication::clipboard()->image(); + QVERIFY2(!image.isNull(), "Copying a cleared console put nothing on the clipboard"); + QVERIFY2(blankImage(image, pane->mBgColor), "A cleared console copied as something other than background"); + } + + // Lines dropped off the front of a full buffer shift every remaining index + // down, so the selection has to be followed down with them. + void test_copyFollowsTheSelectionThroughABufferShrink() + { + TTextEdit* pane = preparePane(); + QVERIFY2(pane, "Could not prepare a console"); + auto& buffer = mudlet::self()->getActiveHost()->mpConsole->buffer; + + dragSelection(pane, QPointF(60, 3 * pane->mFontHeight)); + QVERIFY2(!pane->mSelectedRegion.isEmpty(), "The drag failed to create a selection"); + const int selectedLines = pane->mPB.y() - pane->mPA.y() + 1; + + // enough to push the selection past the end of the buffer, so that the + // shift is what has to bring it back rather than it happening to still fit + const int droppedLines = buffer.lineBuffer.size() - pane->mPB.y() + 2; + QVERIFY2(droppedLines > 0 && droppedLines <= pane->mPA.y(), "Could not size a buffer shrink that strands the selection"); + shrinkBuffer(buffer, droppedLines); + QVERIFY2(pane->mPB.y() > buffer.getLastLineNumber(), "The selection still fits, so the shift is not being exercised"); + + copyAsImage(pane); + + const QImage image = QApplication::clipboard()->image(); + QVERIFY2(!image.isNull(), "Copying after a buffer shrink put nothing on the clipboard"); + QCOMPARE(image.height(), selectedLines * pane->mFontHeight); + QVERIFY2(!blankImage(image, pane->mBgColor), "The copied image is entirely background, the selection was not followed down"); + QVERIFY2(!invertedImage(image, pane->mBgColor), "The copied image still has the selection's inverted colours on it"); + } + + // A selection outliving its lines must not be reinterpreted as whatever now + // sits at those buffer indices. + void test_copyOfASelectionPastTheEndOfTheBuffer() + { + TTextEdit* pane = preparePane(); + QVERIFY2(pane, "Could not prepare a console"); + auto console = mudlet::self()->getActiveHost()->mpConsole; + const int lastLine = console->buffer.getLastLineNumber(); + + // beyond the buffer and beyond any batch-delete adjustment, i.e. gone + pane->mDragStart = QPoint(0, lastLine + console->buffer.mBatchDeleteSize + 10); + pane->mDragSelectionEnd = QPoint(6, lastLine + console->buffer.mBatchDeleteSize + 12); + pane->normaliseSelection(); + pane->mSelectedRegion = QRegion(0, 0, 10, 10); + + copyAsImage(pane); + + const QImage image = QApplication::clipboard()->image(); + QVERIFY2(!image.isNull(), "Copying a selection that outlived its lines put nothing on the clipboard"); + QVERIFY2(image.height() >= 10 * pane->mFontHeight, qPrintable(QStringLiteral("Only %1 lines copied, expected the visible screen").arg(image.height() / pane->mFontHeight))); + QVERIFY2(!blankImage(image, pane->mBgColor), "The copied image is entirely background, no text was drawn into it"); + } + + void cleanup() + { + const QString profilePath = mudlet::getMudletPath(enums::profileHomePath, mpHostname); + + // Tear down Mudlet (and with it the live cTelnet connection) before the + // stub server it is talking to, so the socket is closed from the client + // side rather than being yanked out from under an active connection. + delete mudlet::self(); + delete mpServer; + mpServer = nullptr; + deleteDirectory(profilePath); + } + +private: + // Returns false rather than QVERIFYing, which would only abort the caller's + // helper and let the test go on to dereference a host that never appeared. + bool startProfile(const QString& hostname, const QString& address, const QString& port) + { + QTimer::singleShot(0ms, qApp, [hostname, address, port]() { + mudlet::self()->startAutoLogin({}); + QTest::qWait(100ms); + QTest::mouseClick(mudlet::self()->mpConnectionDialog->new_profile_button, Qt::LeftButton); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), hostname); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), address); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Tab); + QTest::qWait(100ms); + QTest::keyClicks(QApplication::focusWidget(), port); + QTest::qWait(100ms); + QTest::keyClick(QApplication::focusWidget(), Qt::Key_Return); + }); + + QSignalSpy spy(mudlet::self(), &mudlet::signal_profileLoaded); + if (!spy.wait(5000)) { + qWarning() << "Profile took too long to load."; + return false; + } + auto host = mudlet::self()->getActiveHost(); + if (!host || !host->mpConsole) { + qWarning() << "No active host available for the test."; + return false; + } + + QSignalSpy spy2(&(host->mTelnet), &cTelnet::signal_connected); + if (!spy2.wait(2000)) { + qWarning() << "Could not connect with the host."; + return false; + } + return true; + } + + int firstBlankLine() const + { + auto console = mudlet::self()->getActiveHost()->mpConsole; + for (int i = 0; i <= console->buffer.getLastLineNumber(); ++i) { + if (console->buffer.lineBuffer.at(i).isEmpty()) { + return i; + } + } + return -1; + } + + bool waitForTextInBuffer(const QString& text, int timeoutMs = 5000) + { + auto console = mudlet::self()->getActiveHost()->mpConsole; + return QTest::qWaitFor( + [&]() { + for (int i = 0; i <= console->buffer.getLastLineNumber(); ++i) { + if (console->buffer.line(i) == text) { + return true; + } + } + return false; + }, + timeoutMs); + } + + void deleteProfileDirectory(const QString& profileName) + { + const QString path = mudlet::getMudletPath(enums::profileHomePath, profileName); + deleteDirectory(path); + } + + void deleteDirectory(const QString& path) + { + QDir dir(path); + if (!dir.exists()) { + return; + } + dir.removeRecursively(); + } +}; + +void initializeQRCResources() +{ +#ifdef INCLUDE_VARIABLE_SPLASH_SCREEN + qInitResources_additional_splash_screens(); +#endif +#ifdef INCLUDE_FONTS + qInitResources_mudlet_fonts_common(); +#if defined(Q_OS_LINUX) || defined(Q_OS_FREEBSD) + qInitResources_mudlet_fonts_posix(); +#endif +#endif + qInitResources_mudlet(); + qInitResources_qm(); +} + +#include "CopyAsImageTest.moc" +QTEST_MAIN(CopyAsImageTest) From 8d95c1c6016ccf51fc4ebb4c8f4e820257bb8591 Mon Sep 17 00:00:00 2001 From: Vadim Peretokin <vperetokin@hey.com> Date: Tue, 11 Aug 2026 19:13:52 +0200 Subject: [PATCH 155/155] fix: deleting a big Geyser layout no longer freezes Mudlet (#9760) #### Brief overview of PR changes/additions - `Geyser.Container:delete()` now defers the layout of the container it is emptying for the length of its child loop, so tearing down an `HBox`/`VBox` no longer lays the box out once per child. - The deferral is restored even if a child's delete raises, so a container that survives a failed cascade still lays itself out. - Seven busted specs, counting layout passes rather than timing them. #### Motivation for adding to Mudlet `HBox:remove`/`VBox:remove` lay the box out on every removal (#9680, right on its own) and `Container:delete()` removes children one at a time, so a cascading delete re-laid-out the whole box once per child; Mudlet is single-threaded, so a UI package unloading or rebuilding a large layout froze the main thread for seconds. Every one of those passes was laying out windows the same loop went on to destroy. Building a box is unaffected and unchanged: `HBox:add` has always organized per add, and the documented `begin_update`/`end_update` idiom already makes a bulk build linear. #### Other info (issues closed, discussion etc) Closes #9756. One RelWithDebInfo build, Lua swapped between runs, `organize` = layout passes: | case | before | after | | --- | --- | --- | | hbox100 | 0.2228 s, 100 passes | 0.0009 s, 0 | | hbox200 | 0.9851 s, 200 | 0.0017 s, 0 | | hbox400 | 4.1680 s, 400 | 0.0076 s, 0 | | vbox200 | 0.9978 s, 200 | 0.0018 s, 0 | | plain Container 200 (control) | 0.0035 s, 0 | 0.0017 s, 0 | Busted suite: 2507 successes / 0 failures / 0 errors / 41 pending. **Test case:** run `local box = Geyser.HBox:new({name = "b", x = 0, y = 0, width = 600, height = 400}) for i = 1, 400 do Geyser.Label:new({name = "l" .. i}, box) end box:delete()` - the delete is instant instead of a multi-second freeze. Assisted-by: Claude:claude-opus-5 --- src/mudlet-lua/lua/geyser/GeyserContainer.lua | 33 +++++++-- src/mudlet-lua/lua/geyser/GeyserHBox.lua | 3 +- src/mudlet-lua/lua/geyser/GeyserVBox.lua | 3 +- src/mudlet-lua/tests/GeyserContainer_spec.lua | 36 +++++++++ src/mudlet-lua/tests/GeyserHBox_spec.lua | 74 +++++++++++++++++++ src/mudlet-lua/tests/GeyserVBox_spec.lua | 32 ++++++++ 6 files changed, 173 insertions(+), 8 deletions(-) diff --git a/src/mudlet-lua/lua/geyser/GeyserContainer.lua b/src/mudlet-lua/lua/geyser/GeyserContainer.lua index 9f3b88fc0..552c8a0ce 100644 --- a/src/mudlet-lua/lua/geyser/GeyserContainer.lua +++ b/src/mudlet-lua/lua/geyser/GeyserContainer.lua @@ -382,6 +382,17 @@ function Geyser.Container:new(cons, container) return me end +-- Internal function: deletes a container's children. A named function rather +-- than an inline loop so that delete() can pcall it without allocating a closure +-- @param container the container whose children are to be deleted +local function deleteChildren(container) + for _, child in pairs(container.windowList) do + if child and child.delete then + child:delete() + end + end +end + --- Deletes this window and removes it from its container's tracking. -- Recursively deletes all child windows first. -- Properly unregisters from all tracking structures including: @@ -389,13 +400,23 @@ end -- - Geyser.parentWindows (for UserWindows and ScrollBoxes) -- - Geyser.windowList (for top-level Geyser objects) function Geyser.Container:delete() - -- Delete all children first - for _, child in pairs(self.windowList) do - if child and child.delete then - child:delete() - end + -- An HBox/VBox lays itself out whenever a child unlinks, so deleting children + -- one at a time costs a layout pass per child, every one of them laying out + -- windows the same loop goes on to destroy. Only self needs the flag: each + -- container in the cascade defers itself when its own delete runs. rawget, so + -- a container inheriting the flag from Geyser goes back to inheriting it. + local wasDeferring = rawget(self, "defer_updates") + self.defer_updates = true + local ok, err = pcall(deleteChildren, self) + self.defer_updates = wasDeferring + if not ok then + -- a container whose cascade failed stays in the tree, holding whatever + -- children the cascade did not reach - and they are still laid out for the + -- child count it started with, so it owes them the pass that was deferred + self:reposition() + error(err, 0) end - + -- Clear references self.windowList = {} self.windows = {} diff --git a/src/mudlet-lua/lua/geyser/GeyserHBox.lua b/src/mudlet-lua/lua/geyser/GeyserHBox.lua index 02a24c812..f35946258 100644 --- a/src/mudlet-lua/lua/geyser/GeyserHBox.lua +++ b/src/mudlet-lua/lua/geyser/GeyserHBox.lua @@ -10,7 +10,8 @@ Geyser.HBox = Geyser.Container:new({ -- Internal function: lays the box out, or remembers that it still has to be laid -- out when updates are being deferred, so that the reposition end_update() runs --- picks the work up again +-- picks the work up again. A box being deleted defers as well and never gets +-- that reposition, which is deliberate - it has no layout left worth doing. -- @param box the HBox to organize local function organizeOrDefer(box) if box.defer_updates then diff --git a/src/mudlet-lua/lua/geyser/GeyserVBox.lua b/src/mudlet-lua/lua/geyser/GeyserVBox.lua index 26f7c0828..0780eb47c 100644 --- a/src/mudlet-lua/lua/geyser/GeyserVBox.lua +++ b/src/mudlet-lua/lua/geyser/GeyserVBox.lua @@ -10,7 +10,8 @@ Geyser.VBox = Geyser.Container:new({ -- Internal function: lays the box out, or remembers that it still has to be laid -- out when updates are being deferred, so that the reposition end_update() runs --- picks the work up again +-- picks the work up again. A box being deleted defers as well and never gets +-- that reposition, which is deliberate - it has no layout left worth doing. -- @param box the VBox to organize local function organizeOrDefer(box) if box.defer_updates then diff --git a/src/mudlet-lua/tests/GeyserContainer_spec.lua b/src/mudlet-lua/tests/GeyserContainer_spec.lua index e3770cc98..eecd4526c 100644 --- a/src/mudlet-lua/tests/GeyserContainer_spec.lua +++ b/src/mudlet-lua/tests/GeyserContainer_spec.lua @@ -378,6 +378,25 @@ describe("Tests functionality of Geyser.Container", function() assert.is_nil(table.index_of(Geyser.windows, "gcsDeleteRoot")) end) + -- the deferral is per container rather than per cascade, so a box nested + -- inside the container being deleted has to go quiet on its own account + it("holds the layout of a box it is deleting back", function() + local container = track(Geyser.Container:new({name = "gcsDeleteCost", x = 0, y = 0, width = 400, height = 100})) + local box = track(Geyser.HBox:new({name = "gcsDeleteCostBox", width = 400, height = 100}, container)) + for i = 1, 5 do + track(Geyser.Label:new({name = "gcsDeleteCostChild" .. i}, box)) + end + local organizes = 0 + local organize = box.organize + box.organize = function(...) + organizes = organizes + 1 + return organize(...) + end + container:delete() + assert.are.equal(0, organizes) + assert.is_nil(getWindowGeometry("gcsDeleteCostChild1")) + end) + it("unregisters a child from its parent", function() local container = track(Geyser.Container:new({name = "gcsDeleteParent", x = 0, y = 0, width = 100, height = 100})) local child = track(Geyser.Label:new({name = "gcsDeleteMe"}, container)) @@ -651,6 +670,23 @@ describe("Tests functionality of Geyser.Container", function() assert.are.same({x = 0, y = 100, width = 200, height = 100}, geometry("gcsRootDeferredB")) end) + -- delete() defers the box it is emptying, and that borrowed deferral must + -- not end a deferral the caller asked for: the box has to stay held back + -- until end_update, and then still catch up on the layout it skipped + it("leaves a root deferral running when a box loses a child to delete", function() + -- leaving the flag set would stop every later spec repositioning + finally(function() Geyser.defer_updates = false end) + local box = track(Geyser.HBox:new({name = "gcsRootDelete", x = 0, y = 0, width = 400, height = 100})) + track(Geyser.Label:new({name = "gcsRootDeleteKeep"}, box)) + local doomed = track(Geyser.Container:new({name = "gcsRootDeleteGone"}, box)) + Geyser:begin_update() + doomed:delete() + assert.is_true(Geyser.defer_updates) + assert.are.equal(200, geometry("gcsRootDeleteKeep").width) + Geyser:end_update() + assert.are.equal(400, geometry("gcsRootDeleteKeep").width) + end) + it("repositions every window when Geyser:reposition is called directly", function() -- Geyser:reposition hands GeyserReposition no event, which is how -- end_update flushes what was deferred, so it applies to everything diff --git a/src/mudlet-lua/tests/GeyserHBox_spec.lua b/src/mudlet-lua/tests/GeyserHBox_spec.lua index 1529964cd..d0d2265f6 100644 --- a/src/mudlet-lua/tests/GeyserHBox_spec.lua +++ b/src/mudlet-lua/tests/GeyserHBox_spec.lua @@ -177,6 +177,80 @@ describe("Tests functionality of Geyser.HBox", function() assert.is_nil(getWindowGeometry("ghbShrinkB")) assert.is_nil(Geyser.windowList.ghbShrink) end) + + -- one layout pass per child is what makes tearing a box down quadratic. The + -- fixed child is here because contains_fixed short circuits reposition()'s + -- check of the deferral, which could let the cost back in for boxes like it + it("does not lay the row out again for each child it deletes", function() + track(Geyser.Label:new({name = "ghbShrinkCostFixed", width = 100, h_policy = Geyser.Fixed}, box)) + for i = 1, 3 do + track(Geyser.Label:new({name = "ghbShrinkCost" .. i}, box)) + end + local organizes = 0 + local organize = box.organize + box.organize = function(...) + organizes = organizes + 1 + return organize(...) + end + box:delete() + assert.are.equal(0, organizes) + assert.is_nil(getWindowGeometry("ghbShrinkA")) + assert.is_nil(getWindowGeometry("ghbShrinkCost1")) + end) + + -- the deferral belongs to the container being deleted, so a box losing a + -- whole subtree - one that defers itself on the way out - still re-splits + it("re-splits the row when a nested box of its own is deleted", function() + local nested = track(Geyser.VBox:new({name = "ghbShrinkNested"}, box)) + track(Geyser.Label:new({name = "ghbShrinkNestedA"}, nested)) + track(Geyser.Label:new({name = "ghbShrinkNestedB"}, nested)) + nested:delete() + assert.are.same({"ghbShrinkA", "ghbShrinkB"}, box.windows) + assert.are.same({x = 0, y = 0, width = 300, height = 50}, geometry("ghbShrinkA")) + assert.are.same({x = 300, y = 0, width = 300, height = 50}, geometry("ghbShrinkB")) + end) + + -- a cascade that raises leaves the box in the tree, so a box left holding + -- the cascade's deferral would silently never lay itself out again + it("stops deferring the row when a child's delete raises", function() + local doomed = box.windowList.ghbShrinkB + local ownDelete = rawget(doomed, "delete") + -- put the real delete back before after_each tries to clean the box up + finally(function() doomed.delete = ownDelete end) + doomed.delete = function() error("delete blew up") end + assert.has_error(function() box:delete() end) + assert.is_nil(rawget(box, "defer_updates")) + local organizes = 0 + local organize = box.organize + box.organize = function(...) + organizes = organizes + 1 + return organize(...) + end + track(Geyser.Label:new({name = "ghbShrinkAfterRaise"}, box)) + assert.is_true(organizes > 0) + end) + + -- the children the cascade did get through are gone, so the survivors are + -- left holding the widths worked out for the child count it started with + it("re-splits the row a half finished delete left behind", function() + local ownRemove = rawget(box, "remove") + -- restored so that after_each can still tear the box down + finally(function() box.remove = ownRemove end) + -- raising on the second unlink is what puts one child through and strands + -- the other, whichever order the cascade happens to walk them in + local removals = 0 + local remove = box.remove + box.remove = function(...) + removals = removals + 1 + if removals == 2 then + error("remove blew up") + end + return remove(...) + end + assert.has_error(function() box:delete() end) + assert.are.equal(1, #box.windows) + assert.are.same({x = 0, y = 0, width = 600, height = 50}, geometry(box.windows[1])) + end) end) describe("Geyser.HBox:reposition", function() diff --git a/src/mudlet-lua/tests/GeyserVBox_spec.lua b/src/mudlet-lua/tests/GeyserVBox_spec.lua index 6e08feb0a..9d152581a 100644 --- a/src/mudlet-lua/tests/GeyserVBox_spec.lua +++ b/src/mudlet-lua/tests/GeyserVBox_spec.lua @@ -189,6 +189,38 @@ describe("Tests functionality of Geyser.VBox", function() assert.is_nil(getWindowGeometry("gvbShrinkB")) assert.is_nil(Geyser.windowList.gvbShrink) end) + + -- one layout pass per child is what makes tearing a box down quadratic. The + -- fixed child is here because contains_fixed short circuits reposition()'s + -- check of the deferral, which could let the cost back in for boxes like it + it("does not stack the column again for each child it deletes", function() + track(Geyser.Label:new({name = "gvbShrinkCostFixed", height = 100, v_policy = Geyser.Fixed}, box)) + for i = 1, 3 do + track(Geyser.Label:new({name = "gvbShrinkCost" .. i}, box)) + end + local organizes = 0 + local organize = box.organize + box.organize = function(...) + organizes = organizes + 1 + return organize(...) + end + box:delete() + assert.are.equal(0, organizes) + assert.is_nil(getWindowGeometry("gvbShrinkA")) + assert.is_nil(getWindowGeometry("gvbShrinkCost1")) + end) + + -- the deferral belongs to the container being deleted, so a box losing a + -- whole subtree - one that defers itself on the way out - still re-stacks + it("re-stacks the column when a nested box of its own is deleted", function() + local nested = track(Geyser.HBox:new({name = "gvbShrinkNested"}, box)) + track(Geyser.Label:new({name = "gvbShrinkNestedA"}, nested)) + track(Geyser.Label:new({name = "gvbShrinkNestedB"}, nested)) + nested:delete() + assert.are.same({"gvbShrinkA", "gvbShrinkB"}, box.windows) + assert.are.same({x = 0, y = 0, width = 50, height = 300}, geometry("gvbShrinkA")) + assert.are.same({x = 0, y = 300, width = 50, height = 300}, geometry("gvbShrinkB")) + end) end) describe("Geyser.VBox:reposition", function()