hoi4-agent-tools 2.5.2 → 2.6.0

package/CHANGELOG.md

@@ -4,6 +4,19 @@
 
 No unreleased changes.
 
+## 2.6.0 - 2026-08-22
+
+- Added a shared complete map catalog with resolved names, source locations, geometry, memberships, networks, positions, buildings, ports, adjacency, and localisation evidence.
+- Made map inspection return a full-map overview and a searchable, clickable HTML navigator with exact province hit testing and pixel/map coordinate lookup.
+- Added compact state and province creation defaults, rectangle province geometry, and one-call province, state, and strategic-region ID swapping with connected map-reference and standard localisation updates.
+
+## 2.5.3 - 2026-08-22
+
+- Resolved and embedded technology icons through the complete mod, dependency, and installed-game load order, including vanilla sprites used by mod content.
+- Recognized vanilla `SpriteType` capitalization consistently in the shared index and GUI source graph.
+- Decoded uncompressed vanilla DDS textures whose header stores total linear size instead of row pitch.
+- Added deterministic cross-root focus, scripted-GUI, and technology regressions plus an opt-in installed-game DDS render test.
+
 ## 2.5.2 - 2026-08-15
 
 - Distinguished HOI4 small and large technology layouts in graph data and source-positioned folder renders, including exact 72×72 small items selected by `force_use_small_tech_layout`.

package/README.md

@@ -6,7 +6,7 @@ HOI4 Agent Tools is an MCP server for coding agents to understand Hearts of Iron
 
 - Focus trees: inspect structure and references, render layouts, create trees, and reorganize existing branches.
 - Scripted GUIs: trace GUI, GFX, scripted-GUI, and localisation links; render value-driven variants, states, resolutions, hierarchy, and click regions; diagnose alignment, visibility, clipping, panel containment, and button-label centering; create or repair interface source.
-- Maps: inspect provinces, states, regions, adjacency, supply, and railways; render layers; create and repair exact map data.
+- Maps: navigate the complete rendered map by ID or localised name; inspect provinces, states, regions, adjacency, supply, railways, and positions; create states and provinces; change IDs; and repair connected map data.
 - Event chains: scan definitions and call sites, trace routes and state flow, lint references, render graphs, and compare revisions without editing event source.
 - Technology trees: reconstruct technology and doctrine paths, folder layouts, unlocks, bonuses, grants, metadata, assets, and structural changes.
 - AI and MTTH: evaluate weighted choices and timing across explicit scenarios, sweep uncertain inputs, simulate distributions, compare patches, and analyze declared stateful pools.
@@ -40,9 +40,9 @@ Paste the printed Codex or generic global-install entry into your MCP client, th
 | `hoi4.gui_inspect`          | Read a scripted GUI and its linked assets and logic.                                     |
 | `hoi4.gui_render`           | Render GUI scenario variants, states, resolutions, hierarchy, and layout diagnostics.    |
 | `hoi4.gui_rewrite`          | Create or update a GUI source package.                                                   |
-| `hoi4.map_inspect`          | Read map, state, province, region, supply, and railway data.                             |
-| `hoi4.map_render`           | Render map layers and overlays.                                                          |
-| `hoi4.map_rewrite`          | Create or update map data from an ordered list of exact changes.                         |
+| `hoi4.map_inspect`          | Search, click, navigate, and inspect the complete rendered map and its linked data.      |
+| `hoi4.map_render`           | Render full-map layers, overlays, names, IDs, coordinates, and source-linked catalogs.   |
+| `hoi4.map_rewrite`          | Create or update states, provinces, IDs, networks, positions, and connected map data.    |
 | `hoi4.event_inspect`        | Scan, trace, explain, lint, or assess event chains and their state flow.                 |
 | `hoi4.event_render`         | Render source-linked event routes, options, timing, state, scope, and unresolved edges.  |
 | `hoi4.event_compare`        | Compare event-chain topology and diagnostics between revisions.                          |
@@ -71,7 +71,7 @@ Ask your agent in normal task language. A typical workflow is inspect, render, r
 
 - Focus trees: "Create a complete national focus tree for this route specification," or "Compact this existing tree into a balanced, readable layout." Existing trees can use a plan-free compact reflow; new trees use a complete plan. See [Focus trees](docs/focus.md).
 - Scripted GUIs: "Create a scripted GUI for this mechanic," or "Render every value-driven version of this window and fix hidden controls, off-center button text, background alignment, clipping, and click-region conflicts." See [Scripted GUIs](docs/gui.md).
-- Maps: "Create a state from these exact provinces," or "Inspect this state and split these provinces while keeping supply and railway references valid." See [Maps](docs/map.md).
+- Maps: "Render the whole map and find this state by name," "Create a state from these provinces," "Create a province inside this exact rectangle," or "Swap these state IDs and update connected references." See [Maps](docs/map.md).
 - Event chains: "Trace every route from this event and explain where its flags and variables change," or "Compare the workspace event graph with its previous revision and render the affected routes." See [Event chains](docs/events.md).
 - Technology trees: "Explain everything this technology requires and unlocks," or "Compare this technology patch and render every affected folder and doctrine branch." See [Technology trees](docs/technology.md).
 - AI and MTTH: "Compare these focus weights across peace, defensive-war, and low-stability scenarios," or "Show when this MTTH event becomes likely and which unknown inputs control the result." See [AI and MTTH analysis](docs/probability.md).

package/dist/hoi4_agent_tools/core/index.js

@@ -2,6 +2,22 @@ import { compareCodeUnits } from './canonical.js';
 import path from 'node:path';
 import { sortDiagnostics } from './diagnostics.js';
 import { parseClausewitz, parseLocalisation, assignments, childBlocks, firstScalar, locationFor, sourcePartialLimitDiagnostics, SOURCE_MAX_BYTES, SOURCE_MAX_NESTING, nodeLocation, } from './source/index.js';
+const spriteDefinitionKeys = new Set([
+    'spritetype',
+    'textspritetype',
+    'frameanimatedspritetype',
+    'corneredtilespritetype',
+    'maskedshieldtype',
+]);
+function firstScalarInsensitiveNode(block, ...keys) {
+    const normalizedKeys = new Set(keys.map((key) => key.toLowerCase()));
+    for (const assignment of assignments(block)) {
+        if (assignment.value.type === 'scalar' &&
+            normalizedKeys.has(assignment.key.value.toLowerCase()))
+            return assignment.value;
+    }
+    return undefined;
+}
 const guiElementKeys = new Set([
     'containerWindowType',
     'windowType',
@@ -992,10 +1008,11 @@ export class SymbolIndex {
                     metadata: {},
                 });
             }
-            else if ((key === 'spriteType' || key === 'frameAnimatedSpriteType') &&
-                firstScalar(child, 'name') !== undefined) {
-                const name = firstScalar(child, 'name');
-                const texture = firstScalar(child, 'texturefile');
+            else if (sourcePath.endsWith('.gfx') &&
+                spriteDefinitionKeys.has(key.toLowerCase()) &&
+                firstScalarInsensitiveNode(child, 'name') !== undefined) {
+                const name = firstScalarInsensitiveNode(child, 'name');
+                const texture = firstScalarInsensitiveNode(child, 'texturefile', 'textureFile');
                 this.addSymbol({
                     kind: 'sprite',
                     id: name.value,
@@ -1006,8 +1023,7 @@ export class SymbolIndex {
                     metadata: {
                         spriteType: key,
                         texture: texture?.value,
-                        frames: numeric(firstScalar(child, 'noOfFrames')?.value) ??
-                            numeric(firstScalar(child, 'noofframes')?.value),
+                        frames: numeric(firstScalarInsensitiveNode(child, 'noOfFrames', 'noofframes')?.value),
                     },
                 });
                 if (texture !== undefined)

package/dist/hoi4_agent_tools/focus/compact.js

@@ -90,6 +90,51 @@ function compactStructuralAnchorX(plan, focus, parents, preferredX, laneBases) {
     }
     return laneBases.get(focusLaneId(plan, focus)) ?? 0;
 }
+function structuralRows(plan) {
+    const focusIds = new Set(plan.focuses.map(({ id }) => id));
+    const parentsByFocus = new Map(plan.focuses.map((focus) => [
+        focus.id,
+        [...new Set(prerequisiteIds(plan, focus.id).filter((parentId) => focusIds.has(parentId)))],
+    ]));
+    const childrenByFocus = new Map();
+    const unresolvedParents = new Map();
+    for (const focus of plan.focuses) {
+        const parents = parentsByFocus.get(focus.id) ?? [];
+        unresolvedParents.set(focus.id, parents.length);
+        for (const parentId of parents) {
+            const children = childrenByFocus.get(parentId) ?? [];
+            children.push(focus.id);
+            childrenByFocus.set(parentId, children);
+        }
+    }
+    for (const children of childrenByFocus.values())
+        children.sort((left, right) => compareCodeUnits(left, right));
+    const rows = new Map();
+    const pending = [...plan.focuses]
+        .map(({ id }) => id)
+        .filter((focusId) => (unresolvedParents.get(focusId) ?? 0) === 0)
+        .sort((left, right) => compareCodeUnits(right, left));
+    for (const focusId of pending)
+        rows.set(focusId, 0);
+    let visited = 0;
+    while (pending.length > 0) {
+        const focusId = pending.pop();
+        if (focusId === undefined)
+            continue;
+        visited += 1;
+        const nextRow = (rows.get(focusId) ?? 0) + 1;
+        for (const childId of childrenByFocus.get(focusId) ?? []) {
+            rows.set(childId, Math.max(rows.get(childId) ?? 0, nextRow));
+            const remaining = (unresolvedParents.get(childId) ?? 0) - 1;
+            unresolvedParents.set(childId, remaining);
+            if (remaining === 0)
+                pending.push(childId);
+        }
+    }
+    // The layout engine reports dependency cycles. Keep authored row preferences
+    // for a cyclic graph instead of inventing a partial topological reflow.
+    return visited === plan.focuses.length ? rows : undefined;
+}
 function mirrorSiblingCohorts(plan, preferredX, preferredY) {
     const cohorts = new Map();
     const laneBases = compactLaneBases(plan);
@@ -182,7 +227,7 @@ function straightenLinearChains(plan, preferredX, preferredY) {
     }
 }
 function compactCandidate(plan, layout, strategy) {
-    const { scale, compressRows, mirrorSiblings, straightenChains } = strategy;
+    const { scale, compressRows, structuralRows: useStructuralRows, mirrorSiblings, straightenChains, } = strategy;
     const minimumX = Math.min(...layout.nodes.map(({ x }) => x));
     const maximumX = Math.max(...layout.nodes.map(({ x }) => x));
     const minimumY = Math.min(...layout.nodes.map(({ y }) => y));
@@ -194,11 +239,19 @@ function compactCandidate(plan, layout, strategy) {
         node.id,
         compressRows ? (compactRows.get(node.y) ?? node.y - minimumY) : node.y - minimumY,
     ]));
+    if (useStructuralRows) {
+        const normalizedRows = structuralRows(plan);
+        if (normalizedRows !== undefined) {
+            for (const [focusId, row] of normalizedRows)
+                preferredY.set(focusId, row);
+        }
+    }
     const rows = new Map();
     for (const node of layout.nodes) {
-        const row = rows.get(node.y) ?? [];
+        const y = preferredY.get(node.id) ?? node.y;
+        const row = rows.get(y) ?? [];
         row.push(node);
-        rows.set(node.y, row);
+        rows.set(y, row);
     }
     for (const row of rows.values()) {
         row.sort((left, right) => left.x - right.x || compareCodeUnits(left.id, right.id));
@@ -249,12 +302,12 @@ function compactScore(layout) {
         metrics.symmetry.offAnchorSiblingCohortCount,
         metrics.symmetry.totalSiblingDeviation,
         metrics.symmetry.totalSiblingAnchorDeviation,
-        metrics.bounds.rowCount,
-        metrics.bounds.columnCount,
         metrics.connectors.maximumHorizontalSpan,
-        metrics.connectors.totalHorizontalSpan,
         metrics.connectors.maximumManhattanSpan,
+        metrics.connectors.totalHorizontalSpan,
         metrics.connectors.totalVerticalSpan,
+        metrics.bounds.rowCount,
+        metrics.bounds.columnCount,
         layout.layoutHash,
     ];
 }
@@ -281,14 +334,50 @@ function compactScales(focusCount) {
 }
 function compactStrategies(focusCount) {
     const preservationStrategies = [
-        { scale: 1, compressRows: false, mirrorSiblings: false, straightenChains: false },
-        { scale: 1, compressRows: true, mirrorSiblings: false, straightenChains: false },
-        { scale: 1, compressRows: false, mirrorSiblings: false, straightenChains: true },
-        { scale: 1, compressRows: false, mirrorSiblings: true, straightenChains: false },
+        {
+            scale: 1,
+            compressRows: false,
+            structuralRows: false,
+            mirrorSiblings: false,
+            straightenChains: false,
+        },
+        {
+            scale: 1,
+            compressRows: true,
+            structuralRows: false,
+            mirrorSiblings: false,
+            straightenChains: false,
+        },
+        {
+            scale: 1,
+            compressRows: false,
+            structuralRows: false,
+            mirrorSiblings: false,
+            straightenChains: true,
+        },
+        {
+            scale: 1,
+            compressRows: false,
+            structuralRows: false,
+            mirrorSiblings: true,
+            straightenChains: false,
+        },
     ];
     const compactStrategies = compactScales(focusCount).flatMap((scale) => [
-        { scale, compressRows: false, mirrorSiblings: true, straightenChains: true },
-        { scale, compressRows: true, mirrorSiblings: true, straightenChains: true },
+        {
+            scale,
+            compressRows: false,
+            structuralRows: false,
+            mirrorSiblings: true,
+            straightenChains: true,
+        },
+        {
+            scale,
+            compressRows: false,
+            structuralRows: true,
+            mirrorSiblings: true,
+            straightenChains: true,
+        },
     ]);
     return [...preservationStrategies, ...compactStrategies];
 }
@@ -307,6 +396,7 @@ export function compactFocusTreePlan(plan) {
         ? compactCandidate(plan, currentLayout, {
             scale: 1,
             compressRows: false,
+            structuralRows: false,
             mirrorSiblings: false,
             straightenChains: false,
         })
@@ -358,6 +448,7 @@ export async function compactFocusTreePlanAsync(plan, options = {}) {
         ? compactCandidate(plan, currentLayout, {
             scale: 1,
             compressRows: false,
+            structuralRows: false,
             mirrorSiblings: false,
             straightenChains: false,
         })

package/dist/hoi4_agent_tools/focus/continuous-render.js

@@ -42,7 +42,7 @@ export async function renderContinuousFocusPalette(plan, diagnostics, options =
     const rows = Math.max(1, Math.ceil(plan.focuses.length / columns));
     const usedColumns = Math.max(1, Math.min(columns, plan.focuses.length));
     const width = padding * 2 + usedColumns * cardWidth + Math.max(0, usedColumns - 1) * gap;
-    const height = padding * 2 + 84 + rows * cardHeight + Math.max(0, rows - 1) * gap;
+    const height = padding * 2 + 52 + rows * cardHeight + Math.max(0, rows - 1) * gap;
     if (options.rasterize !== false) {
         budget.reserve(width, height, 'continuous focus palette PNG');
     }
@@ -61,7 +61,7 @@ export async function renderContinuousFocusPalette(plan, diagnostics, options =
         const column = index % columns;
         const row = Math.floor(index / columns);
         const x = padding + column * (cardWidth + gap);
-        const y = padding + 84 + row * (cardHeight + gap);
+        const y = padding + 52 + row * (cardHeight + gap);
         const entry = options.presentation?.entries[focus.id];
         const iconSprite = focus.icons[0]?.sprite;
         const icon = iconSprite === undefined ? undefined : options.presentation?.icons[iconSprite];
@@ -80,13 +80,7 @@ export async function renderContinuousFocusPalette(plan, diagnostics, options =
         weight: 700,
         fill: '#f3f6f8',
     });
-    const notice = toolText.render('OFFLINE SOURCE MODEL \u00b7 NOT HOI4', {
-        x: padding,
-        y: padding + 27,
-        fontSize: 12,
-        fill: '#d7b65b',
-    });
-    const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}"><title>${escapeXml(plan.id)} continuous focus palette</title><desc>Offline source-derived continuous focus palette; not an in-game screenshot.</desc><defs>${toolText.definitions()}</defs><rect width="${width}" height="${height}" fill="#101820"/>${heading}${notice}${cards.join('')}</svg>`;
+    const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}"><title>${escapeXml(plan.id)} continuous focus palette</title><desc>${plan.focuses.length} continuous focuses.</desc><defs>${toolText.definitions()}</defs><rect width="${width}" height="${height}" fill="#101820"/>${heading}${cards.join('')}</svg>`;
     const compiled = compileContinuousFocusPaletteWithSourceMap(plan);
     const json = `${canonicalJson({
         schemaVersion: 1,
@@ -122,7 +116,7 @@ export async function renderContinuousFocusPalette(plan, diagnostics, options =
         },
         renderProfile: options.renderProfile ?? {},
     })}\n`;
-    const html = `<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width"><title>${escapeXml(plan.id)} continuous focus palette</title><style>html{background:#101820;color:#f3f6f8;font:14px system-ui}body{margin:0;padding:24px}.notice{color:#d7b65b}svg{max-width:100%;height:auto;border:1px solid #385064}pre{white-space:pre-wrap}</style></head><body><h1>${escapeXml(plan.id)}</h1><p class="notice">Offline source-derived review artifact &mdash; not an in-game screenshot or editor.</p>${svg}<details><summary>Structured source model</summary><pre>${escapeXml(json)}</pre></details></body></html>`;
+    const html = `<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width"><title>${escapeXml(plan.id)} continuous focus palette</title><style>html{background:#101820;color:#f3f6f8;font:14px system-ui}body{margin:0;padding:24px}svg{max-width:100%;height:auto;border:1px solid #385064}pre{white-space:pre-wrap}</style></head><body><h1>${escapeXml(plan.id)}</h1>${svg}<details><summary>Structured source model</summary><pre>${escapeXml(json)}</pre></details></body></html>`;
     options.signal?.throwIfAborted();
     let png = Buffer.alloc(0);
     if (options.rasterize !== false) {

package/dist/hoi4_agent_tools/focus/layout.js

@@ -1529,6 +1529,7 @@ function siblingBatchConflicts(context, cohort, override) {
 }
 function* refineSiblingCohorts(context, edges, initial) {
     let current = initial;
+    let evaluatedEdges = edges;
     for (let pass = 0; pass < 2; pass += 1) {
         let accepted = false;
         for (const [cohortIndex, cohort] of context.siblingCohorts.entries()) {
@@ -1558,7 +1559,7 @@ function* refineSiblingCohorts(context, edges, initial) {
                     continue;
                 if (siblingBatchConflicts(context, cohortIds, override))
                     continue;
-                const candidateEdges = edgesWithXOverride(edges, override);
+                const candidateEdges = edgesWithXOverride(evaluatedEdges, override);
                 const crossingSummary = yield* connectorCrossings(candidateEdges, context);
                 if (crossingSummary.count > current.crossingCount)
                     continue;
@@ -1587,6 +1588,7 @@ function* refineSiblingCohorts(context, edges, initial) {
                 movePlacedFocusX(context, node, x);
             }
             current = best.score;
+            evaluatedEdges = edgesWithXOverride(evaluatedEdges, best.override);
             accepted = true;
         }
         if (!accepted)
@@ -1644,13 +1646,19 @@ const CONNECTOR_REFINEMENT_WORK_MAX = 7_000_000;
 function* refineConnectorQualityWithinBudget(context) {
     const maximumAcceptedMoves = context.aggressiveAestheticRepair ? 32 : 24;
     const maximumCandidateNodes = context.aggressiveAestheticRepair ? 48 : 32;
-    const edges = yield* connectorEdges(context);
-    const crossingSummary = yield* connectorCrossings(edges, context);
-    const intersectionSummary = yield* connectorNodeIntersectionSummary(context, edges);
-    const symmetry = siblingQuality(context);
+    let edges = yield* connectorEdges(context);
+    let crossingSummary = yield* connectorCrossings(edges, context);
+    let intersectionSummary = yield* connectorNodeIntersectionSummary(context, edges);
+    let symmetry = siblingQuality(context);
     let current = connectorQualityScore(context, edges, crossingSummary.count, intersectionSummary.count, symmetry);
-    if (context.aggressiveAestheticRepair)
-        current = yield* refineSiblingCohorts(context, edges, current);
+    if (context.aggressiveAestheticRepair) {
+        yield* refineSiblingCohorts(context, edges, current);
+        edges = yield* connectorEdges(context);
+        crossingSummary = yield* connectorCrossings(edges, context);
+        intersectionSummary = yield* connectorNodeIntersectionSummary(context, edges);
+        symmetry = siblingQuality(context);
+        current = connectorQualityScore(context, edges, crossingSummary.count, intersectionSummary.count, symmetry);
+    }
     const candidateIds = new Set(intersectionSummary.involvedFocusIds);
     const longFocusIds = new Set();
     for (const edge of edges.filter(longConnector)) {

package/dist/hoi4_agent_tools/focus/render.js

@@ -216,7 +216,7 @@ function svgDocument(plan, layout, diagnostics, options) {
     const parts = [
         `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${logicalWidth} ${logicalHeight}" role="img" aria-labelledby="title description">`,
         `<title id="title">${escapeXml(plan.id)} focus tree</title>`,
-        `<desc id="description">Offline HOI4 Agent Tools representation. ${plan.focuses.length} focuses.</desc>`,
+        `<desc id="description">${plan.focuses.length} focuses.</desc>`,
         '<defs>',
         '__DETERMINISTIC_FONT_DEFINITIONS__',
         '<marker id="arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto-start-reverse"><path d="M 0 0 L 10 5 L 0 10 z" fill="#8da2bc"/></marker>',
@@ -224,12 +224,6 @@ function svgDocument(plan, layout, diagnostics, options) {
         '</defs>',
         '<rect width="100%" height="100%" fill="#111723"/>',
         toolText.render(plan.id, { x: padding, y: 36, fontSize: 22, weight: 700, fill: '#e8edf5' }),
-        toolText.render(`Offline agent render · layout ${layout.layoutHash.slice(0, 12)}`, {
-            x: padding,
-            y: 58,
-            fontSize: 12,
-            fill: '#95a4b8',
-        }),
         '<g id="prerequisites">',
     ];
     for (const edge of prerequisiteEdges) {
@@ -403,7 +397,7 @@ function htmlDocument(plan, svg, graphJson, diagnostics) {
 <body>
 <main class="canvas" aria-label="Focus tree artifact">${svg}</main>
 <aside class="panel">
-<div class="controls"><h1>${escapeXml(plan.id)}</h1><p class="notice">Offline HOI4 Agent Tools representation — not an in-game screenshot or editor.</p><label>Find focus<input id="search" type="search" placeholder="ID, title, branch, or lane"></label></div>
+<div class="controls"><h1>${escapeXml(plan.id)}</h1><label>Find focus<input id="search" type="search" placeholder="ID, title, branch, or lane"></label></div>
 <h2>Diagnostics</h2><ol>${diagnosticsHtml}</ol>
 <p class="muted">Source revision: <code>${escapeXml(plan.provenance.sourceHash)}</code></p>
 </aside>

package/dist/hoi4_agent_tools/gui/dds.js

@@ -1,6 +1,7 @@
 import { RenderBudget, RENDER_MAX_DECODED_PIXELS } from '../core/render-budget.js';
 import { sha256Bytes } from '../core/canonical.js';
 const DDS_MAGIC = 0x2053_4444;
+const DDSD_PITCH = 0x8;
 const DDPF_FOURCC = 0x4;
 const DDPF_RGB = 0x40;
 function fourCc(bytes, offset) {
@@ -180,7 +181,9 @@ export function decodeDds(bytes, budget = new RenderBudget(), operationKey = `dd
     budget.reserve(width, height, 'DDS texture decode', {
         maximumPixels: RENDER_MAX_DECODED_PIXELS,
     });
-    const pitch = bytes.readUInt32LE(20);
+    const headerFlags = bytes.readUInt32LE(8);
+    const pitchOrLinearSize = bytes.readUInt32LE(20);
+    const rowPitch = (headerFlags & DDSD_PITCH) === 0 ? 0 : pitchOrLinearSize;
     const flags = bytes.readUInt32LE(80);
     const code = fourCc(bytes, 84).toUpperCase();
     if ((flags & DDPF_FOURCC) !== 0) {
@@ -236,7 +239,7 @@ export function decodeDds(bytes, budget = new RenderBudget(), operationKey = `dd
         bytes.readUInt32LE(100),
         bytes.readUInt32LE(104),
     ];
-    const output = decodeRgb(bytes, 128, width, height, bitCount, pitch, masks);
+    const output = decodeRgb(bytes, 128, width, height, bitCount, rowPitch, masks);
     const format = bitCount === 24 ? 'rgb24' : 'rgba32';
     return output === undefined
         ? unsupported(format, 'The DDS RGB pixel data is truncated.')

package/dist/hoi4_agent_tools/gui/layout.js

@@ -750,7 +750,7 @@ async function layoutElement(definition, parentRect, inheritedClip, parentScale,
         }
     }
 }
-/** Build a deterministic, offline approximation of a GUI window without launching HOI4. */
+/** Build a deterministic GUI scene from the connected source graph and scenario. */
 export async function buildGuiScene(graph, scannedFiles, windowName, scenario, catalog = new GuiAssetCatalog(graph, scannedFiles)) {
     if (graph.nodes.length > GUI_GRAPH_MAX_NODES ||
         graph.edges.length > GUI_GRAPH_MAX_EDGES ||

package/dist/hoi4_agent_tools/gui/renderer.js

@@ -214,13 +214,7 @@ export function sceneToSvg(scene, variant) {
         .map((element) => renderOverlay(element, variant, toolText))
         .join('');
     const fidelity = escapeXml(canonicalJson(scene.fidelity));
-    const banner = toolText.render('OFFLINE APPROXIMATION \u00b7 NOT HOI4', {
-        x: view.viewBox.x + 15,
-        y: view.viewBox.y + 22,
-        fontSize: 11,
-        fill: '#f1c75b',
-    });
-    return `<svg xmlns="http://www.w3.org/2000/svg" width="${view.width}" height="${view.height}" viewBox="${finite(view.viewBox.x)} ${finite(view.viewBox.y)} ${finite(view.viewBox.width)} ${finite(view.viewBox.height)}"><metadata data-renderer="hoi4-agent-tools" data-mode="offline">${fidelity}</metadata><defs>${clipDefinitions.join('')}${sceneGlyphDefinitions(scene)}${toolText.definitions()}</defs><rect ${rectAttributes(view.viewBox)} fill="#17202a"/>${body}${overlays}<g><rect x="${finite(view.viewBox.x + 8)}" y="${finite(view.viewBox.y + 8)}" width="215" height="20" rx="3" fill="#05080c" fill-opacity="0.82"/>${banner}</g></svg>`;
+    return `<svg xmlns="http://www.w3.org/2000/svg" width="${view.width}" height="${view.height}" viewBox="${finite(view.viewBox.x)} ${finite(view.viewBox.y)} ${finite(view.viewBox.width)} ${finite(view.viewBox.height)}"><metadata data-renderer="hoi4-agent-tools" data-mode="offline">${fidelity}</metadata><defs>${clipDefinitions.join('')}${sceneGlyphDefinitions(scene)}${toolText.definitions()}</defs><rect ${rectAttributes(view.viewBox)} fill="#17202a"/>${body}${overlays}</svg>`;
 }
 async function cooperativeParts(values, render, signal) {
     const output = [];
@@ -244,13 +238,7 @@ async function sceneToSvgCooperative(scene, variant, signal) {
     const body = await cooperativeParts(scene.elements, (element, index) => renderBaseElement(element, element.clipRect === undefined ? undefined : `clip-${index}`, toolText), signal);
     const overlays = await cooperativeParts(scene.elements, (element) => renderOverlay(element, variant, toolText), signal);
     const fidelity = escapeXml(canonicalJson(scene.fidelity));
-    const banner = toolText.render('OFFLINE APPROXIMATION \u00b7 NOT HOI4', {
-        x: view.viewBox.x + 15,
-        y: view.viewBox.y + 22,
-        fontSize: 11,
-        fill: '#f1c75b',
-    });
-    return `<svg xmlns="http://www.w3.org/2000/svg" width="${view.width}" height="${view.height}" viewBox="${finite(view.viewBox.x)} ${finite(view.viewBox.y)} ${finite(view.viewBox.width)} ${finite(view.viewBox.height)}"><metadata data-renderer="hoi4-agent-tools" data-mode="offline">${fidelity}</metadata><defs>${clipDefinitions}${sceneGlyphDefinitions(scene)}${toolText.definitions()}</defs><rect ${rectAttributes(view.viewBox)} fill="#17202a"/>${body}${overlays}<g><rect x="${finite(view.viewBox.x + 8)}" y="${finite(view.viewBox.y + 8)}" width="215" height="20" rx="3" fill="#05080c" fill-opacity="0.82"/>${banner}</g></svg>`;
+    return `<svg xmlns="http://www.w3.org/2000/svg" width="${view.width}" height="${view.height}" viewBox="${finite(view.viewBox.x)} ${finite(view.viewBox.y)} ${finite(view.viewBox.width)} ${finite(view.viewBox.height)}"><metadata data-renderer="hoi4-agent-tools" data-mode="offline">${fidelity}</metadata><defs>${clipDefinitions}${sceneGlyphDefinitions(scene)}${toolText.definitions()}</defs><rect ${rectAttributes(view.viewBox)} fill="#17202a"/>${body}${overlays}</svg>`;
 }
 export function hierarchyToSvg(scene) {
     const rows = scene.elements.toSorted((left, right) => left.depth - right.depth || left.zIndex - right.zIndex || compareCodeUnits(left.id, right.id));
@@ -283,7 +271,7 @@ export function hierarchyToSvg(scene) {
         return `${parentLine}<circle cx="${x}" cy="${y - 8}" r="4" fill="${colour}"/>${nameText}${detailText}`;
     })
         .join('');
-    const heading = toolText.render(`OFFLINE HIERARCHY \u00b7 ${scene.windowName}`, {
+    const heading = toolText.render(`${scene.windowName} \u00b7 HIERARCHY`, {
         x: 16,
         y: 20,
         fontSize: 12,
@@ -393,7 +381,7 @@ export function renderGallerySvg(title, items) {
         return `<g>${toolText.render(item.label, { x, y: y + 14, fontSize: 12, fill: '#f1c75b' })}<image x="${x}" y="${y + 22}" width="${finite(item.width * scale)}" height="${finite(item.height * scale)}" href="data:image/png;base64,${item.png.toString('base64')}"/></g>`;
     })
         .join('');
-    const heading = toolText.render(`${title} \u00b7 OFFLINE APPROXIMATION`, {
+    const heading = toolText.render(title, {
         x: 12,
         y: 24,
         fontSize: 15,

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

@@ -31,12 +31,12 @@ const explicitGuiElementTypes = new Set([
     'mapIconType',
 ]);
 const spriteTypes = new Set([
-    'spriteType',
-    'textSpriteType',
-    'frameAnimatedSpriteType',
-    'corneredTileSpriteType',
-    'progressbarType',
-    'maskedShieldType',
+    'spritetype',
+    'textspritetype',
+    'frameanimatedspritetype',
+    'corneredtilespritetype',
+    'progressbartype',
+    'maskedshieldtype',
 ]);
 const modelledElementAttributes = new Set([
     'name',
@@ -330,7 +330,8 @@ function indexSpritesAndFonts(document, file, fileNodeId, nodes, edges, sprites,
             if (assignment.value.type !== 'block')
                 continue;
             const child = assignment.value;
-            if (spriteTypes.has(assignment.key.value)) {
+            const spriteType = assignment.key.value.toLowerCase();
+            if (spriteTypes.has(spriteType)) {
                 const name = firstScalarInsensitive(child, 'name');
                 if (name !== undefined) {
                     const id = deterministicId('gui_sprite', { path: file.displayPath, name });
@@ -352,7 +353,7 @@ function indexSpritesAndFonts(document, file, fileNodeId, nodes, edges, sprites,
                         ...(texturePath === undefined ? {} : { texturePath }),
                         ...(texturePath2 === undefined ? {} : { texturePath2 }),
                         frameCount: Math.trunc(numberScalar(child, 'noOfFrames', 'noofframes') ?? 1),
-                        frameAnimated: assignment.key.value === 'frameAnimatedSpriteType',
+                        frameAnimated: spriteType === 'frameanimatedspritetype',
                         ...(animationRateFps === undefined ? {} : { animationRateFps }),
                         ...(looping === undefined ? {} : { looping }),
                         ...(playOnShow === undefined ? {} : { playOnShow }),