quizwitz-validator 0.2.0 → 0.3.0

package/dist/aggregate.d.ts

@@ -58,3 +58,10 @@ export declare function validGroupId(value: unknown): number | undefined;
  * questions becomes one new group above the highest id.
  */
 export declare function normalizedGroupIds(questions: QuestionAggregate[]): number[];
+/**
+ * A sound setting of an audio/video attachment as the game reads it
+ * (client SoundParameters.parse): `attributes.sound.{key}`, else a legacy
+ * `[key=value]` bracket in the name (key ignoring case). A volume above 1 is
+ * played at 1. Undefined when neither holds a number.
+ */
+export declare function attachmentSoundNumber(attachment: Record<string, any>, key: string): number | undefined;

package/dist/aggregate.js

@@ -145,3 +145,31 @@ export function normalizedGroupIds(questions) {
         return runId;
     });
 }
+/**
+ * A sound setting of an audio/video attachment as the game reads it
+ * (client SoundParameters.parse): `attributes.sound.{key}`, else a legacy
+ * `[key=value]` bracket in the name (key ignoring case). A volume above 1 is
+ * played at 1. Undefined when neither holds a number.
+ */
+export function attachmentSoundNumber(attachment, key) {
+    const read = (value) => {
+        const number = typeof value === 'number' ? value : parseFloat(String(value));
+        return isFinite(number) ? Math.min(1, number) : undefined;
+    };
+    const sound = attachment?.attributes?.sound;
+    if (sound && typeof sound === 'object' && sound[key] !== undefined && sound[key] !== null) {
+        const stored = read(sound[key]);
+        if (stored !== undefined) {
+            return stored;
+        }
+    }
+    let legacy;
+    const name = typeof attachment?.name === 'string' ? attachment.name : '';
+    for (const match of name.match(/\[(.*?)\]/g) ?? []) {
+        const parts = match.substring(1, match.length - 1).split('=');
+        if (parts.length === 2 && parts[0].toLowerCase() === key.toLowerCase()) {
+            legacy = read(parts[1]) ?? legacy;
+        }
+    }
+    return legacy;
+}

package/dist/evaluate.js

@@ -2,7 +2,7 @@ import { TypeCatalog } from './catalog.js';
 import { questionSetting, questionTypeToken, questionsOf, normalizedGroupIds, roundName, roundTypeToken, roundsOf } from './aggregate.js';
 import { ignoredBy } from './ignore.js';
 import { questionWarningId } from './ignore.js';
-import { COMPLETENESS_MESSAGES, evaluateConsistency, evaluateExplanationPair, evaluateGroupPosition, evaluateGroupSize, evaluateOddOneOut, evaluateOptionCountMajority, evaluateOutlier, evaluateRequire, matchesLegacyWarning, matchesOptionCountOver, matchesSettingEquals, matchesTypeSetting, passesCheck, render } from './rules.js';
+import { COMPLETENESS_MESSAGES, evaluateAttachmentVolume, evaluateConsistency, evaluateExplanationPair, evaluateGroupPosition, evaluateGroupSize, evaluateOddOneOut, evaluateOptionCountMajority, evaluateOutlier, evaluateRequire, matchesLegacyWarning, matchesOptionCountOver, matchesSettingEquals, matchesTypeSetting, passesCheck, render } from './rules.js';
 import { localizedText } from './text.js';
 import { COMPARATIVE_KINDS } from './types.js';
 export const ROUND_INCOMPLETE_MESSAGE = '{round}: scoring settings incomplete ({fields})';
@@ -223,6 +223,9 @@ function evaluateRound(catalog, scope, round, roundIndex) {
             case 'groupPosition':
                 evaluateGroupPosition(rule, ctx).forEach(add);
                 break;
+            case 'attachmentVolume':
+                evaluateAttachmentVolume(rule, ctx).forEach(add);
+                break;
             case 'consistency':
                 evaluateConsistency(rule, ctx, quiet).forEach(add);
                 break;

package/dist/rules.d.ts

@@ -1,4 +1,4 @@
-import type { CompletenessRule, ConsistencyRule, ExplanationPairRule, Finding, GroupPositionRule, GroupSizeRule, LegacyWarning, LocalizedText, OddOneOutRule, OptionCountMajorityRule, OptionCountOverRule, OutlierRule, QuestionAggregate, RequireCheck, RequireRule, SettingEqualsRule, SettingsField, TypeSettingRule } from './types.js';
+import type { AttachmentVolumeRule, CompletenessRule, ConsistencyRule, ExplanationPairRule, Finding, GroupPositionRule, GroupSizeRule, LegacyWarning, LocalizedText, OddOneOutRule, OptionCountMajorityRule, OptionCountOverRule, OutlierRule, QuestionAggregate, RequireCheck, RequireRule, SettingEqualsRule, SettingsField, TypeSettingRule } from './types.js';
 export interface QuestionContext {
     question: QuestionAggregate;
     uuid: string;
@@ -32,6 +32,21 @@ export declare function evaluateGroupSize(rule: GroupSizeRule, ctx: RoundContext
  * are left out of the count.
  */
 export declare function evaluateGroupPosition(rule: GroupPositionRule, ctx: RoundContext): Finding[];
+/**
+ * A volume gain as the editor's slider shows it: `√gain` as a whole percent
+ * (the sliders are perceptual, docs/design.md 3.4). Also the comparison key,
+ * so gains the author cannot tell apart on the slider count as the same.
+ */
+export declare function volumePercent(gain: number): number;
+/**
+ * One sound setting (`mutedBackgroundVolume`) on the audio/video attachments
+ * of a round's questions: where at least `majority` of the questions with
+ * such attachments (but not all) play every one of them at the same value,
+ * and that value is not the default, the questions with an attachment that
+ * differs or leaves it unset. A round whose majority leaves the setting at
+ * the default is left alone: the few that set it did so on purpose.
+ */
+export declare function evaluateAttachmentVolume(rule: AttachmentVolumeRule, ctx: RoundContext): Finding[];
 /** Explanation swaps; `quiet` names the `questionUuid:field` gaps the swap explains, for the consistency rules. */
 export declare function evaluateExplanationPair(rule: ExplanationPairRule, ctx: RoundContext, quiet: Set<string>): Finding[];
 export declare function evaluateConsistency(rule: ConsistencyRule, ctx: RoundContext, quiet: Set<string>): Finding[];

package/dist/rules.js

@@ -4,7 +4,7 @@
  * question-anomaly.ts and question-type-descriptor.ts so behaviour and ids
  * are identical.
  */
-import { filledOptionCount, fillsSlot, imageMapOf, optionsOf, questionSetting, resourceText, typeSettingValue } from './aggregate.js';
+import { attachmentSoundNumber, attachmentsOf, filledOptionCount, fillsSlot, imageMapOf, optionsOf, questionSetting, resourceText, typeSettingValue } from './aggregate.js';
 import { groupSizeWarningId, questionWarningId } from './ignore.js';
 import { interpolate, localizedText } from './text.js';
 export function render(text, params, language) {
@@ -207,6 +207,78 @@ export function evaluateGroupPosition(rule, ctx) {
     }
     return out;
 }
+/**
+ * A volume gain as the editor's slider shows it: `√gain` as a whole percent
+ * (the sliders are perceptual, docs/design.md 3.4). Also the comparison key,
+ * so gains the author cannot tell apart on the slider count as the same.
+ */
+export function volumePercent(gain) {
+    return gain > 0 ? Math.round(Math.sqrt(Math.min(1, gain)) * 100) : 0;
+}
+/**
+ * One sound setting (`mutedBackgroundVolume`) on the audio/video attachments
+ * of a round's questions: where at least `majority` of the questions with
+ * such attachments (but not all) play every one of them at the same value,
+ * and that value is not the default, the questions with an attachment that
+ * differs or leaves it unset. A round whose majority leaves the setting at
+ * the default is left alone: the few that set it did so on purpose.
+ */
+export function evaluateAttachmentVolume(rule, ctx) {
+    const types = rule.types ?? ['audio', 'video'];
+    const excluded = rule.excludeSlots ?? [];
+    const defaultPercent = volumePercent(rule.default);
+    const carriers = [];
+    for (const q of ctx.questions) {
+        const percents = [];
+        const slots = attachmentsOf(q.question);
+        for (const slot of Object.keys(slots)) {
+            const items = slots[slot]?.items;
+            if (excluded.includes(slot) || !Array.isArray(items)) {
+                continue;
+            }
+            for (const attachment of items) {
+                if (attachment && types.includes(attachment.type)) {
+                    const gain = attachmentSoundNumber(attachment, rule.setting);
+                    percents.push(volumePercent(gain ?? rule.default));
+                }
+            }
+        }
+        if (percents.length > 0) {
+            carriers.push({ q, percents });
+        }
+    }
+    if (carriers.length < (rule.minPopulation ?? 4)) {
+        return [];
+    }
+    const tally = new Map();
+    for (const c of carriers) {
+        if (c.percents.every(p => p === c.percents[0])) {
+            tally.set(c.percents[0], (tally.get(c.percents[0]) ?? 0) + 1);
+        }
+    }
+    let expected = defaultPercent;
+    let agreeing = 0;
+    tally.forEach((count, percent) => {
+        if (count > agreeing) {
+            expected = percent;
+            agreeing = count;
+        }
+    });
+    if (expected === defaultPercent || agreeing === carriers.length || agreeing < carriers.length * (rule.majority ?? 0.75)) {
+        return [];
+    }
+    const out = [];
+    for (const c of carriers) {
+        const odd = c.percents.find(p => p !== expected);
+        if (odd === undefined) {
+            continue;
+        }
+        out.push(odd === defaultPercent
+            ? finding(ctx, c.q, rule, rule.messageUnset, { expected: expected + '%' })
+            : finding(ctx, c.q, rule, rule.message, { value: odd + '%', expected: expected + '%' }));
+    }
+    return out;
+}
 /** Explanation swaps; `quiet` names the `questionUuid:field` gaps the swap explains, for the consistency rules. */
 export function evaluateExplanationPair(rule, ctx, quiet) {
     const fields = rule.fields;

package/dist/types.d.ts

@@ -22,7 +22,7 @@ export interface SettingsField {
     };
     [key: string]: unknown;
 }
-export type RuleKind = 'outlier' | 'oddOneOut' | 'consistency' | 'explanationPair' | 'optionCountMajority' | 'groupSize' | 'groupPosition' | 'require' | 'settingEquals' | 'optionCountOver' | 'typeSetting';
+export type RuleKind = 'outlier' | 'oddOneOut' | 'consistency' | 'explanationPair' | 'optionCountMajority' | 'groupSize' | 'groupPosition' | 'attachmentVolume' | 'require' | 'settingEquals' | 'optionCountOver' | 'typeSetting';
 export declare const COMPARATIVE_KINDS: readonly RuleKind[];
 export declare const PER_QUESTION_KINDS: readonly RuleKind[];
 export type Severity = 'error' | 'warning';
@@ -77,6 +77,19 @@ export interface GroupPositionRule extends RuleBase {
     /** a text on the primary resource (`label`), compared trimmed and ignoring case. */
     field?: string;
 }
+export interface AttachmentVolumeRule extends RuleBase {
+    rule: 'attachmentVolume';
+    /** The sound setting compared: a linear gain under `attributes.sound` (`mutedBackgroundVolume`, `volume`). */
+    setting: string;
+    /** The gain an attachment that does not set it plays at (`mutedBackgroundVolume` 0, `volume` 1). */
+    default: number;
+    /** Attachment types that carry the setting (default `["audio", "video"]`). */
+    types?: string[];
+    /** Question attachment slots left out (`background`). */
+    excludeSlots?: string[];
+    /** For an attachment that leaves the setting at its default. */
+    messageUnset: LocalizedText;
+}
 export type RequireCheck = 'correctOption' | 'allOptionsFilled' | 'answer' | 'imageMap';
 export interface RequireRule extends RuleBase {
     rule: 'require';
@@ -105,7 +118,7 @@ export interface TypeSettingRule extends RuleBase {
         min: number;
     };
 }
-export type FindingRule = OutlierRule | OddOneOutRule | ConsistencyRule | ExplanationPairRule | OptionCountMajorityRule | GroupSizeRule | GroupPositionRule | RequireRule | SettingEqualsRule | OptionCountOverRule | TypeSettingRule;
+export type FindingRule = OutlierRule | OddOneOutRule | ConsistencyRule | ExplanationPairRule | OptionCountMajorityRule | GroupSizeRule | GroupPositionRule | AttachmentVolumeRule | RequireRule | SettingEqualsRule | OptionCountOverRule | TypeSettingRule;
 /** The existing editor-facing fields the evaluator reads as well (docs/design.md, 3.2). */
 export type CompletenessRule = 'requireText' | 'requireCorrectOption' | 'requireAllOptionsFilled' | 'requireAnswer' | 'requireImageMap';
 export interface OptionCountWarning {

package/dist/types.js

@@ -2,5 +2,5 @@
  * The served manifests (the part this package reads), the rule vocabulary
  * and the evaluator's input and output (docs/design.md, 3 and 4).
  */
-export const COMPARATIVE_KINDS = ['outlier', 'oddOneOut', 'consistency', 'explanationPair', 'optionCountMajority', 'groupSize', 'groupPosition'];
+export const COMPARATIVE_KINDS = ['outlier', 'oddOneOut', 'consistency', 'explanationPair', 'optionCountMajority', 'groupSize', 'groupPosition', 'attachmentVolume'];
 export const PER_QUESTION_KINDS = ['require', 'settingEquals', 'optionCountOver', 'typeSetting'];

package/docs/design.md

@@ -80,6 +80,7 @@ Messages are **English keys**: the editor translates them with its own catalogue
 | `explanationPair` | `fields` (`["longExplanation", "explanation"]`), `labels` (`{field: label}`), `minPopulation` (4), `majority` (0.75) | Among questions that fill either field, the ones using the other half than the majority. Params `{expected, actual}` = labels. |
 | `optionCountMajority` | `types` (question type tokens), `minPopulation` (4), `majority` (0.5) | Same-type siblings (types listed) with a different number of filled options than the strict majority. Params `{count, expected}`. |
 | `groupPosition` | exactly one of `setting` (a numeric question setting: `points`) or `field` (a text on the primary resource: `label`, compared trimmed and ignoring case), `minPopulation` (3, groups), `majority` (0.5) | In a grouped round, the nth question of every group is compared with the nth question of the other groups: where a strict majority of the groups (but not all) agree, the nth questions that differ. Questions without a value (setting not > 0, empty text) are left out. Params `{value, expected, position}` (position from 1). |
+| `attachmentVolume` | `setting` (a sound setting under `attributes.sound`, a linear gain: `mutedBackgroundVolume`), `default` (the gain when unset: 0), `types` (`["audio", "video"]`), `excludeSlots` (`["background"]`), `messageUnset`, `minPopulation` (4, questions), `majority` (0.75) | The audio/video attachments of every question's slots (legacy `[key=value]` name brackets read too). Gains are compared as the editor's perceptual slider shows them (√gain as a whole percent). Where at least `majority` of the questions with such attachments (but not all) play all of them at one value that is not the default, the questions with an attachment that differs: `message` with `{value, expected}`, or `messageUnset` with `{expected}` when it leaves the setting at the default. A round whose majority leaves it at the default gets nothing. |
 | `groupSize` | `minPopulation` (3, groups), `message` (several), `messageSingle` (one question) | In a grouped round, the one group whose size differs when every other group agrees. Id `<roundUuid>:group:<groupId>:group-size`, anchored on the group's first question. Params `{count, expected}`. |
 
 **Per-question kinds** — checked on every question in scope:

package/fixtures/findings-fixtures.json

@@ -55,6 +55,7 @@
                 {
                     "token": "commonthread",
                     "name": "Common Thread",
+                    "roundExplanation": "Find the common thread that links all answers to the following questions.",
                     "guidance": "Normal questions whose answers share a hidden link. The last question asks for that link (\"What is the common thread?\") and always stays last, even with random order. All results are postponed; the last question's result is shown first, then the others.",
                     "description": "All answers should share a common thread. Feedback of the last question is shown first, before all other feedback.",
                     "category": "Regular",
@@ -950,6 +951,9 @@
                     "limiters": [
                         "all"
                     ],
+                    "unavailableSettings": [
+                        "timeBasedScoring"
+                    ],
                     "answerModel": {
                         "cardinality": "single",
                         "correctness": "all",
@@ -1062,6 +1066,7 @@
                 {
                     "token": "strike",
                     "name": "Strike",
+                    "roundExplanation": "Answer consecutive questions correctly to reach higher levels and get bonus points.",
                     "guidance": "Each correct answer in a row climbs a level and adds a bonus per level; a wrong answer drops levels (see the strike round type). The level ladder moves with every result, so a round scored this way shows each result right after its question and cannot play as a lightning round. In a question groups round the levels can start over with every group.",
                     "immediateFeedback": true,
                     "settingsFields": [
@@ -1104,6 +1109,7 @@
                 {
                     "token": "piece-of-pie",
                     "name": "Piece of pie",
+                    "roundExplanation": "All available points are distributed among all players who answered the question correctly.",
                     "guidance": "The question's points times the number of active players, shared equally among the players who answer correctly (see the pieceofpie round type).",
                     "description": "All available points are distributed among all players who answered the question correctly."
                 },
@@ -1156,6 +1162,7 @@
                 {
                     "token": "first-come-first-served",
                     "name": "First come first served",
+                    "roundExplanation": "First players to answer correctly get more points.",
                     "guidance": "Faster correct answers earn more: the fastest correct player gets the question's points, each next correct player 1/N less (N = number of players). Wrong answers earn nothing. Questions start without time-based scoring, which would count speed twice.",
                     "description": "Faster correct answers earn more points.",
                     "settingsFields": [
@@ -1472,6 +1479,25 @@
                     "questionList": "list",
                     "message": "Most questions in this round have an attachment in \"{slot}\", this one does not",
                     "description": "Missing an attachment in \"{slot}\", which most of the round has"
+                },
+                {
+                    "id": "background-volume",
+                    "rule": "attachmentVolume",
+                    "setting": "mutedBackgroundVolume",
+                    "default": 0,
+                    "types": [
+                        "audio",
+                        "video"
+                    ],
+                    "excludeSlots": [
+                        "background"
+                    ],
+                    "minPopulation": 4,
+                    "majority": 0.75,
+                    "questionList": "list",
+                    "message": "Background volume {value} while most questions in this round use {expected}",
+                    "messageUnset": "No background volume set, so other sounds are muted, while most questions in this round use {expected}",
+                    "description": "Attachment with a different background volume than the rest of the round"
                 }
             ]
         },
@@ -1550,6 +1576,29 @@
                     {
                         "token": "mod-betting",
                         "name": "Betting",
+                        "roundExplanation": {
+                            "en": "Before each question you bet points on your answer. Answer right and you win your bet, answer wrong and you lose it!",
+                            "bg": "Преди всеки въпрос залагате точки на отговора си. Отговорите ли правилно, печелите залога си, отговорите ли грешно, го губите!",
+                            "cs": "Před každou otázkou vsadíte body na svou odpověď. Odpovíte-li správně, sázku vyhrajete, odpovíte-li špatně, přijdete o ni!",
+                            "da": "Før hvert spørgsmål satser du point på dit svar. Svar rigtigt, og du vinder din indsats - svar forkert, og du mister den!",
+                            "de": "Vor jeder Frage setzt du Punkte auf deine Antwort. Antwortest du richtig, gewinnst du deinen Einsatz, antwortest du falsch, verlierst du ihn!",
+                            "el": "Πριν από κάθε ερώτηση ποντάρετε πόντους στην απάντησή σας. Αν απαντήσετε σωστά κερδίζετε όσα ποντάρατε, αν απαντήσετε λάθος τα χάνετε!",
+                            "es": "Antes de cada pregunta apuestas puntos por tu respuesta. ¡Si aciertas, ganas tu apuesta; si fallas, la pierdes!",
+                            "fi": "Ennen jokaista kysymystä panostat pisteitä vastauksesi puolesta. Jos vastaat oikein, voitat panoksesi, ja jos vastaat väärin, menetät sen!",
+                            "fr": "Avant chaque question, vous misez des points sur votre réponse. Répondez correctement et vous gagnez votre mise, trompez-vous et vous la perdez !",
+                            "hi": "हर सवाल से पहले आप अपने जवाब पर अंकों का दांव लगाते हैं। सही जवाब दें तो दांव जीतें, गलत जवाब दें तो उसे हार जाएँ!",
+                            "hu": "Minden kérdés előtt pontokat teszel fel a válaszodra. Ha jól válaszolsz, megnyered a téted, ha rosszul, elveszíted!",
+                            "it": "Prima di ogni domanda punti dei punti sulla tua risposta. Rispondi bene e vinci la tua puntata, sbaglia e la perdi!",
+                            "ko": "문제마다 시작 전에 자신의 답에 점수를 베팅합니다. 맞히면 베팅한 점수를 얻고, 틀리면 잃습니다!",
+                            "nl": "Voor elke vraag zet je punten in op je antwoord. Antwoord juist en je wint je inzet, antwoord fout en je verliest je inzet!",
+                            "no": "Før hvert spørsmål satser du poeng på svaret ditt. Svarer du riktig, vinner du innsatsen din. Svarer du feil, taper du den!",
+                            "pl": "Przed każdym pytaniem stawiasz punkty na swoją odpowiedź. Odpowiesz poprawnie - wygrywasz stawkę, odpowiesz błędnie - tracisz ją!",
+                            "pt": "Antes de cada pergunta, apostas pontos na tua resposta. Se acertares, ganhas a aposta; se errares, perdes a aposta!",
+                            "sk": "Pred každou otázkou vsadíte body na svoju odpoveď. Ak odpoviete správne, stávku vyhráte, ak nesprávne, prídete o ňu!",
+                            "sv": "Före varje fråga satsar du poäng på ditt svar. Svarar du rätt vinner du din insats, svarar du fel förlorar du den!",
+                            "tr": "Her sorudan önce cevabın üzerine puan bahsi yaparsın. Doğru cevaplarsan bahsini kazanırsın, yanlış cevaplarsan kaybedersin!",
+                            "uk": "Перед кожним запитанням ти ставиш бали на свою відповідь. Відповідаєш правильно - виграєш ставку, неправильно - втрачаєш її!"
+                        },
                         "description": "Before each question, players bet part of the question's points. A right answer wins the bet, a wrong answer loses it.",
                         "strategy": "BettingStrategy.js",
                         "supportedRoundTypes": [
@@ -1791,10 +1840,172 @@
             {
                 "id": "qw-themehacker",
                 "name": "Theme Hacker",
-                "version": "1.0.0",
+                "version": "1.1.0",
                 "contexts": {
                     "main": "themehacker.js"
-                }
+                },
+                "themeTools": [
+                    {
+                        "id": "customize",
+                        "label": {
+                            "en": "Customize theme",
+                            "nl": "Thema aanpassen"
+                        },
+                        "hint": {
+                            "en": "Change the colors of the theme in the theme tester, then apply them to this quiz.",
+                            "nl": "Pas de kleuren van het thema aan in de thematester en pas ze daarna toe op deze quiz."
+                        },
+                        "mode": "test",
+                        "premium": true
+                    }
+                ],
+                "themeSettings": [
+                    {
+                        "name": "mainColor",
+                        "label": "Main color",
+                        "type": "color",
+                        "marker": "_main_"
+                    },
+                    {
+                        "name": "accentColor",
+                        "label": "Accent color",
+                        "type": "color",
+                        "marker": "_accent_"
+                    },
+                    {
+                        "name": "backgroundColor",
+                        "label": "Background",
+                        "type": "color",
+                        "allowGradient": true,
+                        "marker": "_background_"
+                    },
+                    {
+                        "name": "containerColor",
+                        "label": "Question container",
+                        "type": "color",
+                        "allowGradient": true,
+                        "allowAlpha": true,
+                        "marker": "_container_"
+                    },
+                    {
+                        "name": "containerTextColor",
+                        "label": "Player names on the container",
+                        "type": "color"
+                    },
+                    {
+                        "name": "timerBackgroundColor",
+                        "label": "Timer background",
+                        "type": "color",
+                        "marker": "_timerBackground_"
+                    },
+                    {
+                        "name": "optionColors",
+                        "label": "Answer options",
+                        "type": "color",
+                        "amount": 4,
+                        "marker": "_optionColors_"
+                    },
+                    {
+                        "name": "optionBorderColors",
+                        "label": "Answer option borders",
+                        "type": "color",
+                        "amount": 4,
+                        "marker": "_optionColors_"
+                    },
+                    {
+                        "name": "dialogTextColor",
+                        "label": "Dialog text",
+                        "type": "color"
+                    },
+                    {
+                        "name": "headerTextColor",
+                        "label": "Header text",
+                        "type": "color"
+                    },
+                    {
+                        "name": "optionTextColor",
+                        "label": "Answer option text",
+                        "type": "color"
+                    },
+                    {
+                        "name": "pieChartLabelColor",
+                        "label": "Pie chart labels",
+                        "type": "color"
+                    },
+                    {
+                        "name": "ladderColor",
+                        "label": "Score ladder",
+                        "type": "color"
+                    },
+                    {
+                        "name": "remoteBackgroundColor",
+                        "label": "Devices: background",
+                        "type": "color"
+                    },
+                    {
+                        "name": "remoteTextColor",
+                        "label": "Devices: text",
+                        "type": "color"
+                    },
+                    {
+                        "name": "remoteQuestionColor",
+                        "label": "Devices: question",
+                        "type": "color"
+                    },
+                    {
+                        "name": "remoteQuestionTextColor",
+                        "label": "Devices: question text",
+                        "type": "color"
+                    },
+                    {
+                        "name": "remoteOptionColors",
+                        "label": "Devices: answer options",
+                        "type": "color",
+                        "amount": 4
+                    },
+                    {
+                        "name": "remoteOptionOutlineColor",
+                        "label": "Devices: answer option outline",
+                        "type": "color"
+                    },
+                    {
+                        "name": "remoteOutlineColor",
+                        "label": "Devices: outline",
+                        "type": "color"
+                    },
+                    {
+                        "name": "remoteContainerBackground",
+                        "label": "Devices: container",
+                        "type": "color"
+                    },
+                    {
+                        "name": "remoteContainerText",
+                        "label": "Devices: container text",
+                        "type": "color"
+                    },
+                    {
+                        "name": "defaultFont",
+                        "label": "Font",
+                        "type": "font",
+                        "fontSlot": "default"
+                    },
+                    {
+                        "name": "headerFont",
+                        "label": "Header font",
+                        "type": "font",
+                        "fontSlot": "header"
+                    },
+                    {
+                        "name": "textDecorators",
+                        "label": "Upper case text",
+                        "type": "decorators"
+                    },
+                    {
+                        "name": "hideLogo",
+                        "label": "Hide the QuizWitz logo",
+                        "type": "flag"
+                    }
+                ]
             },
             {
                 "id": "qw-translationoverride",
@@ -2273,6 +2484,718 @@
                 ]
             }
         },
+        {
+            "name": "background-volume-default-majority",
+            "input": {
+                "round": {
+                    "uuid": "r1",
+                    "original_language": "en",
+                    "mode": {
+                        "token": "trivia"
+                    },
+                    "scoringStrategy": {
+                        "token": "default"
+                    },
+                    "resources": [
+                        {
+                            "language": "en",
+                            "name": "Round one"
+                        }
+                    ],
+                    "questions": {
+                        "items": [
+                            {
+                                "uuid": "q1",
+                                "original_language": "en",
+                                "mode": {
+                                    "token": "openquestion"
+                                },
+                                "points": 1000,
+                                "duration": 30,
+                                "resources": [
+                                    {
+                                        "language": "en",
+                                        "name": "Question q1",
+                                        "options": {
+                                            "items": [
+                                                {
+                                                    "option": 1,
+                                                    "text": "Answer",
+                                                    "correct": true
+                                                }
+                                            ]
+                                        },
+                                        "attachments": {
+                                            "during": {
+                                                "items": [
+                                                    {
+                                                        "id": 1,
+                                                        "type": "video",
+                                                        "url": "https://example.test/clip-1.mp4"
+                                                    }
+                                                ]
+                                            }
+                                        }
+                                    }
+                                ]
+                            },
+                            {
+                                "uuid": "q2",
+                                "original_language": "en",
+                                "mode": {
+                                    "token": "openquestion"
+                                },
+                                "points": 1000,
+                                "duration": 30,
+                                "resources": [
+                                    {
+                                        "language": "en",
+                                        "name": "Question q2",
+                                        "options": {
+                                            "items": [
+                                                {
+                                                    "option": 1,
+                                                    "text": "Answer",
+                                                    "correct": true
+                                                }
+                                            ]
+                                        },
+                                        "attachments": {
+                                            "during": {
+                                                "items": [
+                                                    {
+                                                        "id": 2,
+                                                        "type": "video",
+                                                        "url": "https://example.test/clip-2.mp4"
+                                                    }
+                                                ]
+                                            }
+                                        }
+                                    }
+                                ]
+                            },
+                            {
+                                "uuid": "q3",
+                                "original_language": "en",
+                                "mode": {
+                                    "token": "openquestion"
+                                },
+                                "points": 1000,
+                                "duration": 30,
+                                "resources": [
+                                    {
+                                        "language": "en",
+                                        "name": "Question q3",
+                                        "options": {
+                                            "items": [
+                                                {
+                                                    "option": 1,
+                                                    "text": "Answer",
+                                                    "correct": true
+                                                }
+                                            ]
+                                        },
+                                        "attachments": {
+                                            "during": {
+                                                "items": [
+                                                    {
+                                                        "id": 3,
+                                                        "type": "video",
+                                                        "url": "https://example.test/clip-3.mp4"
+                                                    }
+                                                ]
+                                            }
+                                        }
+                                    }
+                                ]
+                            },
+                            {
+                                "uuid": "q4",
+                                "original_language": "en",
+                                "mode": {
+                                    "token": "openquestion"
+                                },
+                                "points": 1000,
+                                "duration": 30,
+                                "resources": [
+                                    {
+                                        "language": "en",
+                                        "name": "Question q4",
+                                        "options": {
+                                            "items": [
+                                                {
+                                                    "option": 1,
+                                                    "text": "Answer",
+                                                    "correct": true
+                                                }
+                                            ]
+                                        },
+                                        "attachments": {
+                                            "during": {
+                                                "items": [
+                                                    {
+                                                        "id": 4,
+                                                        "type": "video",
+                                                        "url": "https://example.test/clip-4.mp4"
+                                                    }
+                                                ]
+                                            }
+                                        }
+                                    }
+                                ]
+                            },
+                            {
+                                "uuid": "q5",
+                                "original_language": "en",
+                                "mode": {
+                                    "token": "openquestion"
+                                },
+                                "points": 1000,
+                                "duration": 30,
+                                "resources": [
+                                    {
+                                        "language": "en",
+                                        "name": "Question q5",
+                                        "options": {
+                                            "items": [
+                                                {
+                                                    "option": 1,
+                                                    "text": "Answer",
+                                                    "correct": true
+                                                }
+                                            ]
+                                        },
+                                        "attachments": {
+                                            "during": {
+                                                "items": [
+                                                    {
+                                                        "id": 5,
+                                                        "type": "video",
+                                                        "url": "https://example.test/clip-5.mp4"
+                                                    }
+                                                ]
+                                            }
+                                        }
+                                    }
+                                ]
+                            },
+                            {
+                                "uuid": "q6",
+                                "original_language": "en",
+                                "mode": {
+                                    "token": "openquestion"
+                                },
+                                "points": 1000,
+                                "duration": 30,
+                                "resources": [
+                                    {
+                                        "language": "en",
+                                        "name": "Question q6",
+                                        "options": {
+                                            "items": [
+                                                {
+                                                    "option": 1,
+                                                    "text": "Answer",
+                                                    "correct": true
+                                                }
+                                            ]
+                                        },
+                                        "attachments": {
+                                            "during": {
+                                                "items": [
+                                                    {
+                                                        "id": 6,
+                                                        "type": "video",
+                                                        "url": "https://example.test/clip-6.mp4",
+                                                        "attributes": {
+                                                            "sound": {
+                                                                "mutedBackgroundVolume": 0.25
+                                                            }
+                                                        }
+                                                    }
+                                                ]
+                                            }
+                                        }
+                                    }
+                                ]
+                            }
+                        ]
+                    }
+                }
+            },
+            "expected": {
+                "errors": [],
+                "warnings": []
+            }
+        },
+        {
+            "name": "background-volume",
+            "input": {
+                "round": {
+                    "uuid": "r1",
+                    "original_language": "en",
+                    "mode": {
+                        "token": "trivia"
+                    },
+                    "scoringStrategy": {
+                        "token": "default"
+                    },
+                    "resources": [
+                        {
+                            "language": "en",
+                            "name": "Round one"
+                        }
+                    ],
+                    "questions": {
+                        "items": [
+                            {
+                                "uuid": "q1",
+                                "original_language": "en",
+                                "mode": {
+                                    "token": "openquestion"
+                                },
+                                "points": 1000,
+                                "duration": 30,
+                                "resources": [
+                                    {
+                                        "language": "en",
+                                        "name": "Question q1",
+                                        "options": {
+                                            "items": [
+                                                {
+                                                    "option": 1,
+                                                    "text": "Answer",
+                                                    "correct": true
+                                                }
+                                            ]
+                                        },
+                                        "attachments": {
+                                            "during": {
+                                                "items": [
+                                                    {
+                                                        "id": 1,
+                                                        "type": "video",
+                                                        "url": "https://example.test/clip-1.mp4",
+                                                        "attributes": {
+                                                            "sound": {
+                                                                "mutedBackgroundVolume": 0.25
+                                                            }
+                                                        }
+                                                    }
+                                                ]
+                                            },
+                                            "background": {
+                                                "items": [
+                                                    {
+                                                        "id": 91,
+                                                        "type": "audio",
+                                                        "url": "https://example.test/clip-91.mp4"
+                                                    }
+                                                ]
+                                            }
+                                        }
+                                    }
+                                ]
+                            },
+                            {
+                                "uuid": "q2",
+                                "original_language": "en",
+                                "mode": {
+                                    "token": "openquestion"
+                                },
+                                "points": 1000,
+                                "duration": 30,
+                                "resources": [
+                                    {
+                                        "language": "en",
+                                        "name": "Question q2",
+                                        "options": {
+                                            "items": [
+                                                {
+                                                    "option": 1,
+                                                    "text": "Answer",
+                                                    "correct": true
+                                                }
+                                            ]
+                                        },
+                                        "attachments": {
+                                            "during": {
+                                                "items": [
+                                                    {
+                                                        "id": 2,
+                                                        "type": "video",
+                                                        "url": "https://example.test/clip-2.mp4",
+                                                        "attributes": {
+                                                            "sound": {
+                                                                "mutedBackgroundVolume": 0.25
+                                                            }
+                                                        }
+                                                    }
+                                                ]
+                                            }
+                                        }
+                                    }
+                                ]
+                            },
+                            {
+                                "uuid": "q3",
+                                "original_language": "en",
+                                "mode": {
+                                    "token": "openquestion"
+                                },
+                                "points": 1000,
+                                "duration": 30,
+                                "resources": [
+                                    {
+                                        "language": "en",
+                                        "name": "Question q3",
+                                        "options": {
+                                            "items": [
+                                                {
+                                                    "option": 1,
+                                                    "text": "Answer",
+                                                    "correct": true
+                                                }
+                                            ]
+                                        },
+                                        "attachments": {
+                                            "during": {
+                                                "items": [
+                                                    {
+                                                        "id": 3,
+                                                        "type": "video",
+                                                        "url": "https://example.test/clip-3.mp4",
+                                                        "attributes": {
+                                                            "sound": {
+                                                                "mutedBackgroundVolume": 0.2525
+                                                            }
+                                                        }
+                                                    }
+                                                ]
+                                            },
+                                            "before": {
+                                                "items": [
+                                                    {
+                                                        "id": 93,
+                                                        "type": "image",
+                                                        "url": "https://example.test/p.jpg"
+                                                    }
+                                                ]
+                                            }
+                                        }
+                                    }
+                                ]
+                            },
+                            {
+                                "uuid": "q4",
+                                "original_language": "en",
+                                "mode": {
+                                    "token": "openquestion"
+                                },
+                                "points": 1000,
+                                "duration": 30,
+                                "resources": [
+                                    {
+                                        "language": "en",
+                                        "name": "Question q4",
+                                        "options": {
+                                            "items": [
+                                                {
+                                                    "option": 1,
+                                                    "text": "Answer",
+                                                    "correct": true
+                                                }
+                                            ]
+                                        },
+                                        "attachments": {
+                                            "after": {
+                                                "items": [
+                                                    {
+                                                        "id": 4,
+                                                        "type": "audio",
+                                                        "url": "https://example.test/clip-4.mp4",
+                                                        "name": "Applause [mutedBackgroundVolume=0.25]"
+                                                    }
+                                                ]
+                                            },
+                                            "during": {
+                                                "items": [
+                                                    {
+                                                        "id": 84,
+                                                        "type": "image",
+                                                        "url": "https://example.test/d.jpg"
+                                                    }
+                                                ]
+                                            }
+                                        }
+                                    }
+                                ]
+                            },
+                            {
+                                "uuid": "q5",
+                                "original_language": "en",
+                                "mode": {
+                                    "token": "openquestion"
+                                },
+                                "points": 1000,
+                                "duration": 30,
+                                "resources": [
+                                    {
+                                        "language": "en",
+                                        "name": "Question q5",
+                                        "options": {
+                                            "items": [
+                                                {
+                                                    "option": 1,
+                                                    "text": "Answer",
+                                                    "correct": true
+                                                }
+                                            ]
+                                        },
+                                        "attachments": {
+                                            "during": {
+                                                "items": [
+                                                    {
+                                                        "id": 5,
+                                                        "type": "video",
+                                                        "url": "https://example.test/clip-5.mp4",
+                                                        "attributes": {
+                                                            "sound": {
+                                                                "mutedBackgroundVolume": 0.25
+                                                            }
+                                                        }
+                                                    }
+                                                ]
+                                            }
+                                        }
+                                    }
+                                ]
+                            },
+                            {
+                                "uuid": "q6",
+                                "original_language": "en",
+                                "mode": {
+                                    "token": "openquestion"
+                                },
+                                "points": 1000,
+                                "duration": 30,
+                                "resources": [
+                                    {
+                                        "language": "en",
+                                        "name": "Question q6",
+                                        "options": {
+                                            "items": [
+                                                {
+                                                    "option": 1,
+                                                    "text": "Answer",
+                                                    "correct": true
+                                                }
+                                            ]
+                                        },
+                                        "attachments": {
+                                            "during": {
+                                                "items": [
+                                                    {
+                                                        "id": 6,
+                                                        "type": "video",
+                                                        "url": "https://example.test/clip-6.mp4",
+                                                        "attributes": {
+                                                            "sound": {
+                                                                "mutedBackgroundVolume": 0.25
+                                                            }
+                                                        }
+                                                    }
+                                                ]
+                                            },
+                                            "feedback:after": {
+                                                "items": [
+                                                    {
+                                                        "id": 96,
+                                                        "type": "audio",
+                                                        "url": "https://example.test/clip-96.mp4",
+                                                        "attributes": {
+                                                            "sound": {
+                                                                "mutedBackgroundVolume": 0.25
+                                                            }
+                                                        }
+                                                    }
+                                                ]
+                                            }
+                                        }
+                                    }
+                                ]
+                            },
+                            {
+                                "uuid": "q7",
+                                "original_language": "en",
+                                "mode": {
+                                    "token": "openquestion"
+                                },
+                                "points": 1000,
+                                "duration": 30,
+                                "resources": [
+                                    {
+                                        "language": "en",
+                                        "name": "Question q7",
+                                        "options": {
+                                            "items": [
+                                                {
+                                                    "option": 1,
+                                                    "text": "Answer",
+                                                    "correct": true
+                                                }
+                                            ]
+                                        },
+                                        "attachments": {
+                                            "during": {
+                                                "items": [
+                                                    {
+                                                        "id": 7,
+                                                        "type": "video",
+                                                        "url": "https://example.test/clip-7.mp4",
+                                                        "attributes": {
+                                                            "sound": {
+                                                                "volume": 0.8
+                                                            }
+                                                        }
+                                                    }
+                                                ]
+                                            }
+                                        }
+                                    }
+                                ]
+                            },
+                            {
+                                "uuid": "q8",
+                                "original_language": "en",
+                                "mode": {
+                                    "token": "openquestion"
+                                },
+                                "points": 1000,
+                                "duration": 30,
+                                "resources": [
+                                    {
+                                        "language": "en",
+                                        "name": "Question q8",
+                                        "options": {
+                                            "items": [
+                                                {
+                                                    "option": 1,
+                                                    "text": "Answer",
+                                                    "correct": true
+                                                }
+                                            ]
+                                        },
+                                        "attachments": {
+                                            "during": {
+                                                "items": [
+                                                    {
+                                                        "id": 8,
+                                                        "type": "video",
+                                                        "url": "https://example.test/clip-8.mp4",
+                                                        "attributes": {
+                                                            "sound": {
+                                                                "mutedBackgroundVolume": 0.25
+                                                            }
+                                                        }
+                                                    }
+                                                ]
+                                            },
+                                            "after": {
+                                                "items": [
+                                                    {
+                                                        "id": 98,
+                                                        "type": "video",
+                                                        "url": "https://example.test/clip-98.mp4",
+                                                        "attributes": {
+                                                            "sound": {
+                                                                "mutedBackgroundVolume": 0.5
+                                                            }
+                                                        }
+                                                    }
+                                                ]
+                                            }
+                                        }
+                                    }
+                                ]
+                            },
+                            {
+                                "uuid": "q9",
+                                "original_language": "en",
+                                "mode": {
+                                    "token": "openquestion"
+                                },
+                                "points": 1000,
+                                "duration": 30,
+                                "resources": [
+                                    {
+                                        "language": "en",
+                                        "name": "Question q9",
+                                        "options": {
+                                            "items": [
+                                                {
+                                                    "option": 1,
+                                                    "text": "Answer",
+                                                    "correct": true
+                                                }
+                                            ]
+                                        },
+                                        "attachments": {
+                                            "before": {
+                                                "items": [
+                                                    {
+                                                        "id": 99,
+                                                        "type": "image",
+                                                        "url": "https://example.test/q.jpg"
+                                                    }
+                                                ]
+                                            },
+                                            "during": {
+                                                "items": [
+                                                    {
+                                                        "id": 89,
+                                                        "type": "image",
+                                                        "url": "https://example.test/d.jpg"
+                                                    }
+                                                ]
+                                            }
+                                        }
+                                    }
+                                ]
+                            }
+                        ]
+                    }
+                }
+            },
+            "expected": {
+                "errors": [],
+                "warnings": [
+                    {
+                        "id": "q7:background-volume",
+                        "ruleId": "background-volume",
+                        "roundId": "r1",
+                        "questionId": "q7",
+                        "message": "No background volume set, so other sounds are muted, while most questions in this round use 50%",
+                        "messageKey": "No background volume set, so other sounds are muted, while most questions in this round use {expected}",
+                        "messageParams": {
+                            "expected": "50%"
+                        }
+                    },
+                    {
+                        "id": "q8:background-volume",
+                        "ruleId": "background-volume",
+                        "roundId": "r1",
+                        "questionId": "q8",
+                        "message": "Background volume 71% while most questions in this round use 50%",
+                        "messageKey": "Background volume {value} while most questions in this round use {expected}",
+                        "messageParams": {
+                            "value": "71%",
+                            "expected": "50%"
+                        }
+                    }
+                ]
+            }
+        },
         {
             "name": "completeness-errors",
             "input": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quizwitz-validator",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Evaluates the findings (validation issues and surprising-settings warnings) the QuizWitz game client's type manifests declare, for the quiz editor and the MCP server.",
   "license": "UNLICENSED",
   "type": "module",