hoi4-agent-tools 3.10.0 → 4.0.1

package/dist/hoi4_agent_tools/gui/dds.js

@@ -157,7 +157,11 @@ function decodeRgb(bytes, dataOffset, width, height, bitCount, pitch, masks) {
             const source = dataOffset + y * rowPitch + x * bytesPerPixel;
             const pixel = bitCount === 32
                 ? bytes.readUInt32LE(source)
-                : byte(bytes, source) | (byte(bytes, source + 1) << 8) | (byte(bytes, source + 2) << 16);
+                : bitCount === 16
+                    ? bytes.readUInt16LE(source)
+                    : byte(bytes, source) |
+                        (byte(bytes, source + 1) << 8) |
+                        (byte(bytes, source + 2) << 16);
             const target = (y * width + x) * 4;
             output[target] = extractChannel(pixel, masks[0], 0);
             output[target + 1] = extractChannel(pixel, masks[1], 0);
@@ -231,8 +235,8 @@ export function decodeDds(bytes, budget = new RenderBudget(), operationKey = `dd
     if ((flags & DDPF_RGB) === 0)
         return unsupported('non-rgb', 'The DDS is neither RGB nor a recognised compressed format.');
     const bitCount = bytes.readUInt32LE(88);
-    if (bitCount !== 24 && bitCount !== 32)
-        return unsupported(`rgb${bitCount}`, `RGB DDS bit depth ${bitCount} is unsupported; expected 24 or 32.`);
+    if (bitCount !== 16 && bitCount !== 24 && bitCount !== 32)
+        return unsupported(`rgb${bitCount}`, `RGB DDS bit depth ${bitCount} is unsupported; expected 16, 24 or 32.`);
     const masks = [
         bytes.readUInt32LE(92),
         bytes.readUInt32LE(96),
@@ -240,7 +244,7 @@ export function decodeDds(bytes, budget = new RenderBudget(), operationKey = `dd
         bytes.readUInt32LE(104),
     ];
     const output = decodeRgb(bytes, 128, width, height, bitCount, rowPitch, masks);
-    const format = bitCount === 24 ? 'rgb24' : 'rgba32';
+    const format = bitCount === 16 ? 'rgb16' : bitCount === 24 ? 'rgb24' : 'rgba32';
     return output === undefined
         ? unsupported(format, 'The DDS RGB pixel data is truncated.')
         : { width, height, data: output, format };

package/dist/hoi4_agent_tools/gui/layout.js

@@ -2,6 +2,7 @@ import { compareCodeUnits, hashCanonical } from '../core/canonical.js';
 import { assertRenderDimensions } from '../core/render-budget.js';
 import { sortDiagnostics } from '../core/diagnostics.js';
 import { ServiceError } from '../core/result.js';
+import { nativeWindowState } from './native-state.js';
 import { GuiAssetCatalog } from './assets.js';
 import { GUI_GRAPH_MAX_EDGES, GUI_GRAPH_MAX_ELEMENTS, GUI_GRAPH_MAX_NODES, GUI_SCENE_MAX_DEPTH, GUI_SCENE_MAX_ELEMENTS, GUI_SCENE_MAX_TEXT_CHARACTERS, GUI_SCENE_MAX_TEXT_LAYOUT_OPERATIONS, GUI_SCENE_MAX_WORK, GUI_TEXT_MAX_CHARACTERS, GUI_TEXT_MAX_MISSING_GLYPH_SAMPLES, } from './limits.js';
 import { guiElementAttributeFidelity } from './source-graph.js';
@@ -593,6 +594,24 @@ function anchoredCoordinate(start, span, offset, anchor) {
 function legacyRowSuffix(instanceSuffix) {
     return instanceSuffix.replace(/#list-[^#]+/gu, '');
 }
+/**
+ * Read a visibility value the way the game reads one: booleans, the script words yes/no and
+ * true/false, visible/hidden/shown, and the numbers 0 and 1. Anything else is not a decision.
+ */
+function visibilityValue(value) {
+    if (typeof value === 'boolean')
+        return value;
+    if (typeof value === 'number')
+        return value === 0 ? false : value === 1 ? true : undefined;
+    if (typeof value !== 'string')
+        return undefined;
+    const word = value.trim().toLowerCase();
+    if (['yes', 'true', '1', 'visible', 'shown', 'show'].includes(word))
+        return true;
+    if (['no', 'false', '0', 'hidden', 'hide'].includes(word))
+        return false;
+    return undefined;
+}
 function explicitElementVisibility(definition, scenario, rowValues) {
     const scripted = rowValues?.[`${definition.name}.visible`] ??
         scenario.values[`${definition.name}.visible`] ??
@@ -602,7 +621,14 @@ function explicitElementVisibility(definition, scenario, rowValues) {
         (definition.sourceOwnerId === undefined
             ? undefined
             : scenario.visibility[definition.sourceOwnerId]) ??
-        (typeof scripted === 'boolean' ? scripted : undefined));
+        visibilityValue(scripted));
+}
+/** Source visibility: `visible` and `show` mean shown when true, `hide` and `hidden` when false. */
+function declaredVisibility(attributes) {
+    const visible = scalarBoolean(property(attributes, 'visible', 'show'));
+    if (visible !== undefined)
+        return visible;
+    return !(scalarBoolean(property(attributes, 'hide', 'hidden')) ?? false);
 }
 function clippedByChain(chain) {
     let result;
@@ -1124,8 +1150,7 @@ async function layoutAttachedScrollbars(definition, scrollbars, owner, childOutp
                 ...(maximum === 0 ? { enabled: false } : {}),
             },
         };
-        const sourceShown = scalarBoolean(property(bar.attributes, 'visible')) ??
-            !(scalarBoolean(property(bar.attributes, 'hide', 'hidden')) ?? false);
+        const sourceShown = declaredVisibility(bar.attributes);
         barLayouts.push({
             definition: bar,
             rect: { x: coordinate(true), y: coordinate(false), width: barWidth, height: barHeight },
@@ -1253,8 +1278,7 @@ async function layoutElement(definition, parentRect, inheritedClip, parentScale,
     const parentUnresolvedVisibility = parentSceneElement?.visibilityStatus === 'unresolved'
         ? parentSceneElement.visibilityStatusReason
         : undefined;
-    const declaredHidden = scalarBoolean(property(definition.attributes, 'hide', 'hidden')) ?? false;
-    const sourceVisible = scalarBoolean(property(definition.attributes, 'visible')) ?? !declaredHidden;
+    const sourceVisible = declaredVisibility(definition.attributes);
     const resolveVisibleAppearance = inheritedVisible && (explicitlyVisible ?? sourceVisible);
     const scriptedEnabled = rowValues?.[`${definition.name}.enabled`] ??
         scenario.values[`${definition.name}.enabled`] ??
@@ -2158,13 +2182,29 @@ export async function buildGuiScene(graph, scannedFiles, windowName, scenario, c
             addFidelity(fidelity, 'unresolved', 'scripted_gui_visibility', `${scripted.name}.visible requires more scenario facts; its source visibility remains unresolved.`);
         }
     }
+    // Engine-controlled branches and icon frames come from the scenario country; scripted state,
+    // then every explicit scenario value, outranks them.
+    const native = nativeWindowState(windowName, new Set(graph.elements.map(({ name }) => name)), scenario, scannedFiles);
+    if (native !== undefined) {
+        for (const note of native.notes)
+            addFidelity(fidelity, 'modelled', 'native_window_state', note);
+        const { sources } = native.state;
+        if (native.state.tag === undefined ||
+            sources.faction === 'default' ||
+            sources.balanceOfPower === 'default')
+            addFidelity(fidelity, 'approximated', 'native_window_state', native.state.tag === undefined
+                ? 'The scenario names no country, so the window shows the state of a country in no faction and without a balance of power; set country.tag or the country faction, balanceOfPower and ideology facts.'
+                : `No history for ${native.state.tag} was available, so its faction and balance of power default to none; set country.faction, country.balanceOfPower and country.ideology to override.`);
+    }
     const layoutScenario = {
         ...scenario,
         values: {
             ...resolvedScriptedProperties,
+            ...(native?.values ?? {}),
             ...scenario.values,
         },
         visibility: {
+            ...(native?.visibility ?? {}),
             ...scriptedWindowVisibility,
             ...constantElementVisibility,
             ...scenario.visibility,

package/dist/hoi4_agent_tools/gui/native-state.js

@@ -0,0 +1,244 @@
+import { assignments, parseClausewitz } from '../core/source/index.js';
+/** Windows whose branches the engine selects, keyed by the window's root element name. */
+const NATIVE_BRANCHES = {
+    countrypoliticsview: [
+        {
+            elements: ['no_faction'],
+            shown: (state) => state.faction === 'none',
+            describe: 'the country is not in a faction',
+        },
+        {
+            elements: ['original_in_faction'],
+            shown: (state) => state.faction === 'leader',
+            describe: 'the country leads its faction',
+        },
+        {
+            elements: ['in_faction'],
+            shown: (state) => state.faction === 'member',
+            describe: 'the country is a member of a faction it does not lead',
+        },
+        {
+            elements: ['power_balance_button'],
+            shown: (state) => state.balanceOfPower,
+            describe: 'the country has an active balance of power',
+        },
+    ],
+};
+/**
+ * Icons whose frame the game picks from the ruling ideology, as the ideology group at each
+ * one-based frame. `pol_factions_strip` holds fascism, communism, democratic and neutrality.
+ */
+const IDEOLOGY_FRAME_ICONS = {
+    pol_faction_icon: ['fascism', 'communism', 'democratic', 'neutrality'],
+};
+const DEFAULT_SCENARIO_DATE = '1936.1.1';
+function scenarioDate(scenario) {
+    const parts = (scenario.date ?? DEFAULT_SCENARIO_DATE).split('.').map(Number);
+    return dateKey(parts[0] ?? 1936, parts[1] ?? 1, parts[2] ?? 1);
+}
+function dateKey(year, month, day) {
+    return year * 10_000 + month * 100 + day;
+}
+function scenarioCountryTag(scenario) {
+    const candidate = [
+        scenario.country?.tag,
+        scenario.country?.countryTag,
+        scenario.country?.GetTag,
+    ].find((value) => typeof value === 'string' && /^[A-Za-z0-9_]{2,64}$/u.test(value));
+    return candidate?.toUpperCase();
+}
+function scenarioString(scenario, ...keys) {
+    for (const key of keys) {
+        const value = scenario.country?.[key];
+        if (typeof value === 'string' && /^[A-Za-z0-9_]{2,64}$/u.test(value))
+            return value.toLowerCase();
+    }
+    return undefined;
+}
+function scenarioBoolean(scenario, ...keys) {
+    for (const key of keys) {
+        const value = scenario.country?.[key];
+        if (typeof value === 'boolean')
+            return value;
+        if (typeof value === 'string' && /^(?:yes|true)$/iu.test(value))
+            return true;
+        if (typeof value === 'string' && /^(?:no|false)$/iu.test(value))
+            return false;
+    }
+    return undefined;
+}
+function explicitFaction(scenario) {
+    const named = scenarioString(scenario, 'faction', 'factionRole');
+    if (named === 'none' || named === 'member' || named === 'leader')
+        return named;
+    const leader = scenarioBoolean(scenario, 'factionLeader', 'isFactionLeader');
+    if (leader === true)
+        return 'leader';
+    const member = scenarioBoolean(scenario, 'inFaction', 'isInFaction', 'faction');
+    if (member === false)
+        return 'none';
+    if (member === true)
+        return 'member';
+    return undefined;
+}
+const FACTION_CREATION = new Set(['create_faction', 'create_faction_from_template']);
+function visitHistory(entries, cutoff, facts, members, owner) {
+    for (const entry of entries) {
+        if (entry.type !== 'assignment')
+            continue;
+        const key = entry.key.value;
+        const dated = /^(\d{1,4})\.(\d{1,2})\.(\d{1,2})$/u.exec(key);
+        if (dated !== null) {
+            // A dated block applies from its date; later blocks have not happened yet.
+            if (entry.value.type === 'block' && dateKey(+dated[1], +dated[2], +dated[3]) <= cutoff)
+                visitHistory(entry.value.entries, cutoff, facts, members, owner);
+            continue;
+        }
+        if (key === 'set_politics' && entry.value.type === 'block') {
+            const party = assignments(entry.value, 'ruling_party')[0]?.value;
+            if (party?.type === 'scalar')
+                facts.ideology = party.value.toLowerCase();
+        }
+        else if (FACTION_CREATION.has(key)) {
+            facts.createsFaction = true;
+        }
+        else if (key === 'set_power_balance') {
+            facts.powerBalance = true;
+        }
+        else if (key === 'remove_power_balance') {
+            facts.powerBalance = false;
+        }
+        else if (key === 'add_to_faction' &&
+            entry.value.type === 'scalar' &&
+            entry.value.value.toUpperCase() !== owner) {
+            const tag = entry.value.value.toUpperCase();
+            const joined = members.get(tag) ?? new Set();
+            joined.add(owner);
+            members.set(tag, joined);
+        }
+        else if ((key === 'if' || key === 'else' || key === 'else_if') &&
+            entry.value.type === 'block') {
+            // Conditions such as DLC checks cannot be evaluated here; their content is treated as
+            // part of the start, which matches a fully owned game.
+            visitHistory(entry.value.entries, cutoff, facts, members, owner);
+        }
+    }
+}
+function historyTag(file) {
+    const match = /^history\/countries\/([A-Za-z0-9_]{2,64})(?:\s*-[^/]*)?\.txt$/u.exec(file.relativePath.replaceAll('\\', '/'));
+    return match?.[1]?.toUpperCase();
+}
+function historyState(tag, files, cutoff) {
+    const facts = {
+        createsFaction: false,
+        powerBalance: false,
+    };
+    // `add_to_faction = X` in a leader's history adds X to that leader's faction, so a country
+    // is a member when another country's history adds it.
+    const additions = new Map();
+    let found = false;
+    for (const file of files) {
+        if (file.shadowedBy !== undefined)
+            continue;
+        const fileTag = historyTag(file);
+        if (fileTag === undefined)
+            continue;
+        const owned = fileTag === tag;
+        if (owned)
+            found = true;
+        // Only the country's own history carries its other facts; every other file can matter
+        // solely through the members it adds to a faction.
+        else if (!file.bytes.includes('add_to_faction'))
+            continue;
+        const document = parseClausewitz(file.bytes, file.displayPath);
+        const own = {
+            createsFaction: false,
+            powerBalance: false,
+        };
+        visitHistory(document.root.entries, cutoff, owned ? facts : own, additions, fileTag);
+    }
+    const memberOfFaction = (additions.get(tag)?.size ?? 0) > 0;
+    return { facts, found, memberOfFaction };
+}
+/** Resolve the country facts the engine would use, explicit scenario values first. */
+export function resolveNativeCountryState(scenario, files) {
+    const tag = scenarioCountryTag(scenario);
+    const history = tag === undefined
+        ? undefined
+        : historyState(tag, files.filter(({ relativePath }) => relativePath.startsWith('history/countries/')), scenarioDate(scenario));
+    const knownHistory = history?.found === true ? history : undefined;
+    const ideologyFromScenario = scenarioString(scenario, 'ideology', 'rulingIdeology', 'countryIdeology');
+    const factionFromScenario = explicitFaction(scenario);
+    const bopFromScenario = scenarioBoolean(scenario, 'balanceOfPower', 'hasBalanceOfPower', 'powerBalance');
+    const ideology = ideologyFromScenario ?? knownHistory?.facts.ideology;
+    const faction = factionFromScenario ??
+        (knownHistory === undefined
+            ? 'none'
+            : knownHistory.facts.createsFaction
+                ? 'leader'
+                : knownHistory.memberOfFaction
+                    ? 'member'
+                    : 'none');
+    return {
+        tag,
+        ideology,
+        faction,
+        balanceOfPower: bopFromScenario ?? knownHistory?.facts.powerBalance ?? false,
+        sources: {
+            ideology: ideologyFromScenario !== undefined
+                ? 'scenario'
+                : knownHistory?.facts.ideology !== undefined
+                    ? 'history'
+                    : 'unknown',
+            faction: factionFromScenario !== undefined
+                ? 'scenario'
+                : knownHistory !== undefined
+                    ? 'history'
+                    : 'default',
+            balanceOfPower: bopFromScenario !== undefined
+                ? 'scenario'
+                : knownHistory !== undefined
+                    ? 'history'
+                    : 'default',
+        },
+    };
+}
+/** Whether any native decision can apply to this window, so the country state is worth resolving. */
+export function windowHasNativeState(windowName, elementNames) {
+    return (NATIVE_BRANCHES[windowName] !== undefined ||
+        Object.keys(IDEOLOGY_FRAME_ICONS).some((name) => elementNames.has(name)));
+}
+/** The engine-selected branches and frames for a scene, below any explicit scenario input. */
+export function nativeWindowState(windowName, elementNames, scenario, files) {
+    if (!windowHasNativeState(windowName, elementNames))
+        return undefined;
+    const state = resolveNativeCountryState(scenario, files);
+    const visibility = {};
+    const values = {};
+    const notes = [];
+    const subject = state.tag ?? 'the scenario country';
+    for (const rule of NATIVE_BRANCHES[windowName] ?? []) {
+        const shown = rule.shown(state);
+        for (const name of rule.elements)
+            visibility[name] = shown;
+        notes.push(`${rule.elements.join(', ')} ${shown ? 'is shown' : 'is hidden'} for ${subject}; the game shows it only when ${rule.describe}.`);
+    }
+    for (const [name, order] of Object.entries(IDEOLOGY_FRAME_ICONS)) {
+        if (!elementNames.has(name) || state.ideology === undefined)
+            continue;
+        const index = order.indexOf(state.ideology);
+        if (index < 0)
+            continue;
+        values[`${name}.frame`] = index + 1;
+        notes.push(`${name} shows the ${state.ideology} frame for ${subject}.`);
+    }
+    return { visibility, values, notes, state };
+}
+/** Whether the scenario needs history to resolve its native state, and so to be scanned. */
+export function scenarioNeedsCountryHistory(scenario) {
+    if (scenarioCountryTag(scenario) === undefined)
+        return false;
+    return (scenarioString(scenario, 'ideology', 'rulingIdeology', 'countryIdeology') === undefined ||
+        explicitFaction(scenario) === undefined ||
+        scenarioBoolean(scenario, 'balanceOfPower', 'hasBalanceOfPower', 'powerBalance') === undefined);
+}

package/dist/hoi4_agent_tools/gui/renderer.js

@@ -658,15 +658,20 @@ export async function renderGuiScene(scene, variants = defaultVariants, signal,
         const basePng = await sharp(Buffer.from(full.svg), { limitInputPixels: RENDER_MAX_PIXELS })
             .png({ compressionLevel: 9, adaptiveFiltering: false, palette: false })
             .toBuffer();
-        const rendered = await Promise.all(prepared.map(async (item) => {
-            if (item.variant === 'full')
-                return {
+        // Derived variants are rasterized one at a time: each decodes the full-size base raster, so
+        // running them together multiplies the peak native memory of one render.
+        const rendered = [];
+        for (const item of prepared) {
+            if (item.variant === 'full') {
+                rendered.push({
                     variant: item.variant,
                     svg: item.svg,
                     png: basePng,
                     width: item.view.width,
                     height: item.view.height,
-                };
+                });
+                continue;
+            }
             signal?.throwIfAborted();
             budget.reserveRasterOperation(`gui-derived-variant:${sha256Bytes(item.svg)}`, `GUI ${item.variant} derived rasterization`);
             const png = item.variant === 'cropped'
@@ -684,14 +689,14 @@ export async function renderGuiScene(scene, variants = defaultVariants, signal,
                     .png({ compressionLevel: 9, adaptiveFiltering: false, palette: false })
                     .toBuffer();
             signal?.throwIfAborted();
-            return {
+            rendered.push({
                 variant: item.variant,
                 svg: item.svg,
                 png,
                 width: item.view.width,
                 height: item.view.height,
-            };
-        }));
+            });
+        }
         images = rendered;
     }
     return {

package/dist/hoi4_agent_tools/gui/source-graph.js

@@ -76,6 +76,7 @@ const modelledElementAttributes = new Set([
     'hide',
     'hidden',
     'visible',
+    'show',
     'enabled',
     'context_aware_text',
 ]);
@@ -1063,9 +1064,13 @@ function linkGraph(nodes, edges, elements, sprites, fonts, scriptedGuis, scripte
     for (const font of fonts) {
         const key = font.name.toLocaleLowerCase('en-US');
         const existing = fontByName.get(key);
+        const declared = font.kind === 'bitmapfont';
+        const existingDeclared = existing?.kind === 'bitmapfont';
         if (existing === undefined ||
-            (existing.override && !font.override) ||
-            (existing.languages.length > 0 && font.languages.length === 0))
+            (!existingDeclared && declared) ||
+            (existingDeclared === declared &&
+                ((existing.override && !font.override) ||
+                    (existing.languages.length > 0 && font.languages.length === 0))))
             fontByName.set(key, font);
     }
     const elementByName = new Map();
@@ -1126,7 +1131,7 @@ function linkGraph(nodes, edges, elements, sprites, fonts, scriptedGuis, scripte
             addEdge(edges, 'uses_font', element.id, font?.id ?? `font:${fontName}`, font !== undefined, { fontName }, element.location);
         }
         for (const key of localisationAttributeNames) {
-            const value = element.attributes[key];
+            const value = localisationAttributeValue(element.attributes, key);
             if (typeof value !== 'string' ||
                 value.trim().length === 0 ||
                 !isStaticGuiLocalisationReference(value))
@@ -1206,6 +1211,14 @@ const localisationAttributeNames = [
     'pdx_tooltip_delayed',
     'hint_tag',
 ];
+/** Clausewitz keys are case-insensitive: vanilla spells the button label `buttontext`. */
+function localisationAttributeValue(attributes, name) {
+    const lowered = name.toLowerCase();
+    for (const [key, value] of Object.entries(attributes))
+        if (key.toLowerCase() === lowered)
+            return value;
+    return undefined;
+}
 function isStaticGuiLocalisationReference(value) {
     const trimmed = value.trim();
     return !(trimmed.startsWith('[') && trimmed.endsWith(']'));
@@ -1214,7 +1227,7 @@ function referencedGuiLocalisationKeys(elements, scriptedLocalisation) {
     const keys = new Set(scriptedLocalisation.flatMap(({ localisationKeys }) => localisationKeys));
     for (const element of elements) {
         for (const attribute of localisationAttributeNames) {
-            const value = element.attributes[attribute];
+            const value = localisationAttributeValue(element.attributes, attribute);
             if (typeof value === 'string' &&
                 value.trim().length > 0 &&
                 isStaticGuiLocalisationReference(value))

package/dist/hoi4_agent_tools/gui/studio.js

@@ -17,6 +17,7 @@ import { TRANSACTION_MAX_DIAGNOSTICS } from '../core/transaction-limits.js';
 import { PACKAGE_VERSION } from '../version.js';
 import { isSafeAnimationSourcePath } from './animation-manifest.js';
 import { GuiAssetCatalog, parseBmFont } from './assets.js';
+import { scenarioNeedsCountryHistory } from './native-state.js';
 import { projectGuiGraphForArtifact } from './inspection-artifact.js';
 import { buildGuiScene } from './layout.js';
 import { GUI_VALIDATION_MAX_DIAGNOSTICS } from './limits.js';
@@ -333,7 +334,13 @@ function assertTargetWindowAvailable(graph, windowName) {
         })),
     });
 }
+const lowerCaseKeySets = new WeakMap();
 function collectNamedAttributes(value, keys, output) {
+    let lowered = lowerCaseKeySets.get(keys);
+    if (lowered === undefined) {
+        lowered = new Set([...keys].map((key) => key.toLowerCase()));
+        lowerCaseKeySets.set(keys, lowered);
+    }
     if (Array.isArray(value)) {
         for (const entry of value)
             collectNamedAttributes(entry, keys, output);
@@ -342,7 +349,7 @@ function collectNamedAttributes(value, keys, output) {
     if (typeof value !== 'object' || value === null)
         return;
     for (const [key, entry] of Object.entries(value)) {
-        if (keys.has(key) && typeof entry === 'string')
+        if (lowered.has(key.toLowerCase()) && typeof entry === 'string')
             output.add(entry);
         collectNamedAttributes(entry, keys, output);
     }
@@ -559,6 +566,16 @@ export function scenarioCountryFlagPatterns(scenarios) {
         `gfx/flags/${directory}${tag}_*.{bmp,dds,png,tga}`,
     ]));
 }
+/**
+ * Engine-controlled windows read the scenario country's faction, balance of power and ruling
+ * party from country history; the faction facts also live in other countries' histories.
+ */
+function scenarioCountryHistoryPatterns(scenarios) {
+    return scenarios.some(scenarioNeedsCountryHistory) ? ['history/countries/*.txt'] : [];
+}
+function scenarioCountryAssetPatterns(scenarios) {
+    return [...scenarioCountryFlagPatterns(scenarios), ...scenarioCountryHistoryPatterns(scenarios)];
+}
 function bmFontPagePatterns(files) {
     const references = files.flatMap((file) => {
         if (!file.relativePath.toLowerCase().endsWith('.fnt') || file.shadowedBy !== undefined)
@@ -1072,7 +1089,7 @@ export class ScriptedGuiStudio {
         const generatedOptions = input.generatedScenarios === undefined
             ? undefined
             : parseGeneratedScenarioOptions(input.generatedScenarios);
-        const scanned = await this.scanWindow(input.workspaceId, input.windowName, input.principal, input.signal, [placeholderScenario.language, ...explicitRelatedScenarios.map(({ language }) => language)], scenarioSpriteNames([placeholderScenario, ...explicitRelatedScenarios], generatedOptions?.textSamples), scenarioTemplateNames([placeholderScenario, ...explicitRelatedScenarios]), scenarioCountryFlagPatterns([placeholderScenario, ...explicitRelatedScenarios]), scenarioLocalisationKeys([placeholderScenario, ...explicitRelatedScenarios]), [placeholderScenario, ...explicitRelatedScenarios].some(({ tooltip }) => tooltip !== undefined));
+        const scanned = await this.scanWindow(input.workspaceId, input.windowName, input.principal, input.signal, [placeholderScenario.language, ...explicitRelatedScenarios.map(({ language }) => language)], scenarioSpriteNames([placeholderScenario, ...explicitRelatedScenarios], generatedOptions?.textSamples), scenarioTemplateNames([placeholderScenario, ...explicitRelatedScenarios]), scenarioCountryAssetPatterns([placeholderScenario, ...explicitRelatedScenarios]), scenarioLocalisationKeys([placeholderScenario, ...explicitRelatedScenarios]), [placeholderScenario, ...explicitRelatedScenarios].some(({ tooltip }) => tooltip !== undefined));
         let builtDefinitions;
         const evaluationDefinitions = () => (builtDefinitions ??= ClausewitzEvaluationDefinitions.build(scanned));
         const resolveLocalisation = (target) => resolveScenarioScriptedLocalisation(scanned.graph, input.windowName, target, evaluationDefinitions);
@@ -1106,15 +1123,14 @@ export class ScriptedGuiStudio {
         const budget = new RenderBudget();
         const beforeScenario = parsePreviewScenario(input.before);
         const afterScenario = parsePreviewScenario(input.after);
-        const scanned = await this.scanWindow(input.workspaceId, input.windowName, input.principal, input.signal, [beforeScenario.language, afterScenario.language], scenarioSpriteNames([beforeScenario, afterScenario]), scenarioTemplateNames([beforeScenario, afterScenario]), scenarioCountryFlagPatterns([beforeScenario, afterScenario]), scenarioLocalisationKeys([beforeScenario, afterScenario]), [beforeScenario, afterScenario].some(({ tooltip }) => tooltip !== undefined));
+        const scanned = await this.scanWindow(input.workspaceId, input.windowName, input.principal, input.signal, [beforeScenario.language, afterScenario.language], scenarioSpriteNames([beforeScenario, afterScenario]), scenarioTemplateNames([beforeScenario, afterScenario]), scenarioCountryAssetPatterns([beforeScenario, afterScenario]), scenarioLocalisationKeys([beforeScenario, afterScenario]), [beforeScenario, afterScenario].some(({ tooltip }) => tooltip !== undefined));
         const beforeCatalog = new GuiAssetCatalog(scanned.graph, scanned.files, budget, beforeScenario.language);
         const afterCatalog = new GuiAssetCatalog(scanned.graph, scanned.files, budget, afterScenario.language);
         const before = await buildGuiScene(scanned.graph, scanned.files, input.windowName, beforeScenario, beforeCatalog);
         const after = await buildGuiScene(scanned.graph, scanned.files, input.windowName, afterScenario, afterCatalog);
-        const [beforeRender, afterRender] = await Promise.all([
-            renderGuiScene(before, ['full'], input.signal, budget),
-            renderGuiScene(after, ['full'], input.signal, budget),
-        ]);
+        // One full raster at a time keeps the peak native memory of a comparison to a single render.
+        const beforeRender = await renderGuiScene(before, ['full'], input.signal, budget);
+        const afterRender = await renderGuiScene(after, ['full'], input.signal, budget);
         const comparison = await compareGuiImages(fullImage(beforeRender).png, fullImage(afterRender).png, budget, input.signal);
         const evidenceJson = `${canonicalJson({
             offline: true,
@@ -1159,7 +1175,7 @@ export class ScriptedGuiStudio {
             placeholderScenario,
             ...(requestedBaselineScenario === undefined ? [] : [requestedBaselineScenario]),
             ...explicitRelatedScenarios,
-        ]), scenarioCountryFlagPatterns([
+        ]), scenarioCountryAssetPatterns([
             placeholderScenario,
             ...(requestedBaselineScenario === undefined ? [] : [requestedBaselineScenario]),
             ...explicitRelatedScenarios,
@@ -1316,17 +1332,13 @@ export class ScriptedGuiStudio {
         galleryBudget.reserveRasterOperation(`gui-gallery:${sha256Bytes(scenarioGallerySvg)}`, 'GUI scripted scenario gallery SVG rasterization');
         galleryBudget.reserveRasterOperation(`gui-gallery:${sha256Bytes(stateGallerySvg)}`, 'GUI state gallery SVG rasterization');
         galleryBudget.reserveRasterOperation(`gui-gallery:${sha256Bytes(resolutionGallerySvg)}`, 'GUI resolution gallery SVG rasterization');
-        const [scenarioGalleryPng, stateGalleryPng, resolutionGalleryPng] = await Promise.all([
-            sharp(Buffer.from(scenarioGallerySvg), { limitInputPixels: RENDER_MAX_PIXELS })
-                .png({ compressionLevel: 9, adaptiveFiltering: false, palette: false })
-                .toBuffer(),
-            sharp(Buffer.from(stateGallerySvg), { limitInputPixels: RENDER_MAX_PIXELS })
-                .png({ compressionLevel: 9, adaptiveFiltering: false, palette: false })
-                .toBuffer(),
-            sharp(Buffer.from(resolutionGallerySvg), { limitInputPixels: RENDER_MAX_PIXELS })
-                .png({ compressionLevel: 9, adaptiveFiltering: false, palette: false })
-                .toBuffer(),
-        ]);
+        const rasterizeGallery = (svg) => sharp(Buffer.from(svg), { limitInputPixels: RENDER_MAX_PIXELS })
+            .png({ compressionLevel: 9, adaptiveFiltering: false, palette: false })
+            .toBuffer();
+        // Gallery canvases are large and independent; rasterize them one at a time.
+        const scenarioGalleryPng = await rasterizeGallery(scenarioGallerySvg);
+        const stateGalleryPng = await rasterizeGallery(stateGallerySvg);
+        const resolutionGalleryPng = await rasterizeGallery(resolutionGallerySvg);
         const slug = safeSlug(input.windowName);
         const projectedArtifactGraph = projectGuiGraphForArtifact(scanned.graph, [
             ...new Set([...scenarioScenes, ...stateScenes, ...resolutionScenes, baselineScene].flatMap(({ elements }) => elements.map(({ sourceId }) => sourceId))),
@@ -1522,7 +1534,7 @@ export class ScriptedGuiStudio {
         const previewScenario = input.scenario === undefined ? undefined : parsePreviewScenario(input.scenario);
         const initiallyScanned = input.windowName === undefined
             ? await this.scan(input.workspaceId, input.principal, input.signal)
-            : await this.scanWindow(input.workspaceId, input.windowName, input.principal, input.signal, [previewScenario.language], scenarioSpriteNames([previewScenario]), scenarioTemplateNames([previewScenario]), scenarioCountryFlagPatterns([previewScenario]), scenarioLocalisationKeys([previewScenario]), previewScenario.tooltip !== undefined);
+            : await this.scanWindow(input.workspaceId, input.windowName, input.principal, input.signal, [previewScenario.language], scenarioSpriteNames([previewScenario]), scenarioTemplateNames([previewScenario]), scenarioCountryAssetPatterns([previewScenario]), scenarioLocalisationKeys([previewScenario]), previewScenario.tooltip !== undefined);
         const exactTargets = await this.scanner.scan(workspace, {
             patterns: prepared.map(({ relativePath }) => relativePath),
             ...(input.signal === undefined ? {} : { signal: input.signal }),
@@ -1544,7 +1556,7 @@ export class ScriptedGuiStudio {
             let proposedGraph = buildGuiSourceGraph(proposedFiles, this.engine.indexFiles(proposedFiles));
             const proposedAssetPatterns = [
                 ...referencedAssetPatternsForWindow(proposedGraph, input.windowName, [], [scenario.language], scenarioTemplateNames([scenario])),
-                ...scenarioCountryFlagPatterns([scenario]),
+                ...scenarioCountryAssetPatterns([scenario]),
             ];
             const exactProposedAssets = proposedAssetPatterns.length === 0
                 ? []

package/dist/hoi4_agent_tools/gui/validators.js

@@ -490,15 +490,17 @@ function validateOverlapAndGeometry(scene, diagnostics, work) {
                 if (overlap === undefined)
                     continue;
                 const ratio = area(overlap) / Math.max(1, Math.min(area(left.rect), area(right.rect)));
+                // Tab pages and alternative panels overlap by design; the game shows one at a time.
+                // When the scenario cannot decide which, the preview draws them stacked, and the pair
+                // is reported only as missing scenario facts, not as a layout or click conflict.
+                if (left.visibilityStatus === 'unresolved' || right.visibilityStatus === 'unresolved') {
+                    if (left.depth === right.depth && ratio > 0.2)
+                        diagnostics.push(issue('GUI_UNRESOLVED_VISIBILITY_OVERLAP', 'warning', 'layout', `${left.name} and ${right.name} overlap and the scenario does not decide which is visible, so the preview draws both. Declare the flags or variables their visible triggers read, with closedFlags, to render one of them.`, right, { left: left.id, right: right.id, ratio }));
+                    continue;
+                }
                 if (left.clickable && right.clickable && ratio > 0.02) {
                     diagnostics.push(issue('GUI_CONFLICTING_CLICK_REGIONS', 'error', 'design', `${left.name} and ${right.name} have overlapping click regions (${(ratio * 100).toFixed(1)}%).`, right, { left: left.id, right: right.id, ratio }));
                 }
-                // Tab pages and alternative panels overlap by design; the game shows one at a time.
-                // When the scenario cannot decide which, the preview draws them stacked.
-                if (left.depth === right.depth &&
-                    ratio > 0.2 &&
-                    (left.visibilityStatus === 'unresolved' || right.visibilityStatus === 'unresolved'))
-                    diagnostics.push(issue('GUI_UNRESOLVED_VISIBILITY_OVERLAP', 'warning', 'layout', `${left.name} and ${right.name} overlap and the scenario does not decide which is visible, so the preview draws both. Declare the flags or variables their visible triggers read, with closedFlags, to render one of them.`, right, { left: left.id, right: right.id, ratio }));
                 if (left.depth === right.depth && ratio > 0.2) {
                     diagnostics.push(issue('GUI_VISIBLE_OVERLAP', 'warning', 'layout', `${left.name} and ${right.name} overlap by ${(ratio * 100).toFixed(1)}% of the smaller element.`, right, { left: left.id, right: right.id, ratio }));
                 }

package/dist/hoi4_agent_tools/map/bmp.js

@@ -314,7 +314,7 @@ export function createBmp(options) {
     bytes.writeUInt32LE(0, 30);
     bytes.writeUInt32LE(stride * options.height, 34);
     if (options.bitsPerPixel === 8)
-        bytes.writeUInt32LE(palette.length === 256 ? 256 : palette.length, 46);
+        bytes.writeUInt32LE(options.colorsUsed ?? palette.length, 46);
     for (const [index, color] of palette.entries()) {
         const offset = 14 + dibSize + index * 4;
         bytes[offset] = color.b;