hoi4-agent-tools 4.0.4 → 4.0.5

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## Unreleased
 
+## 4.0.5 - 2026-10-14
+
+- Keep child anchors independent of parent `origo`, so centered native windows place their controls inside the frame.
+- Preview division and HQ branches separately and close native selector overlays by default. Existing scenario values and visibility bindings select panels explicitly.
+- Preserve dropdown button and expanded-panel boundaries, including closed visibility, settled positions, backgrounds, clipping and attached scrollbars.
+- Render background-free scroll containers using their declared viewport bounds; retain findings for explicitly disabled clipping and invalid boundaries or references.
+- Resolve public scrollbar templates despite unrelated private namesakes. Public tool schemas and dependency versions are unchanged.
+
 ## 4.0.4 - 2026-10-14
 
 - Preview individual GUI windows without redundant full symbol indexes, workspace-wide asset fallback or unbound country-flag inventories; reuse condition definitions across render variants.

package/dist/hoi4_agent_tools/gui/layout.js

@@ -629,11 +629,12 @@ function explicitElementVisibility(definition, scenario, rowValues) {
         visibilityValue(scripted));
 }
 /** Source visibility: `visible` and `show` mean shown when true, `hide` and `hidden` when false. */
-function declaredVisibility(attributes) {
+function declaredVisibility(attributes, fallback = true) {
     const visible = scalarBoolean(property(attributes, 'visible', 'show'));
     if (visible !== undefined)
         return visible;
-    return !(scalarBoolean(property(attributes, 'hide', 'hidden')) ?? false);
+    const hidden = scalarBoolean(property(attributes, 'hide', 'hidden'));
+    return hidden === undefined ? fallback : !hidden;
 }
 function clippedByChain(chain) {
     let result;
@@ -694,7 +695,7 @@ function refreshSceneClips(context) {
     }
 }
 function attachedScrollbars(definition, context) {
-    if (!/^(?:containerwindowtype|windowtype)$/iu.test(definition.elementType))
+    if (!/^(?:containerwindowtype|windowtype|expandedwindow)$/iu.test(definition.elementType))
         return [];
     const result = [];
     const add = (candidate, horizontal, reference) => {
@@ -718,8 +719,10 @@ function attachedScrollbars(definition, context) {
     for (const horizontal of [false, true]) {
         const name = scalarString(property(definition.attributes, horizontal ? 'horizontalScrollbar' : 'verticalScrollbar'));
         if (name !== undefined) {
-            const candidate = context.elementsByName.get(name);
-            add(candidate?.parentId === undefined ? candidate : undefined, horizontal, name);
+            const candidate = context.elementsByNameCandidates
+                .get(name)
+                ?.find((element) => element.parentId === undefined);
+            add(candidate, horizontal, name);
         }
     }
     for (const id of definition.childIds) {
@@ -1218,10 +1221,13 @@ async function layoutElement(definition, parentRect, inheritedClip, parentScale,
     const clipChain = inheritedClipChain ?? (inheritedClip === undefined ? [] : [inheritedClip]);
     const localScale = scalarNumber(property(definition.attributes, 'scale'), 1) ?? 1;
     const scale = parentScale * localScale;
-    const shownPosition = depth === 0 ? objectProperty(property(definition.attributes, 'show_position')) : undefined;
+    const expandedWindow = definition.elementType.toLowerCase() === 'expandedwindow';
+    const shownPosition = depth === 0 || expandedWindow
+        ? objectProperty(property(definition.attributes, 'show_position'))
+        : undefined;
     const position = shownPosition ?? objectProperty(property(definition.attributes, 'position'));
     if (shownPosition !== undefined) {
-        addFidelity(fidelity, 'modelled', 'window_show_position', 'The requested root window uses its declared settled show position.', definition);
+        addFidelity(fidelity, 'modelled', 'window_show_position', 'The requested window uses its declared settled show position.', definition);
     }
     const size = objectProperty(property(definition.attributes, 'size'));
     const scriptedX = rowValues?.[`${definition.name}.x`] ??
@@ -1277,13 +1283,19 @@ async function layoutElement(definition, parentRect, inheritedClip, parentScale,
         width = Math.max(0, parentRect.width - localX + width);
     if (height < 0)
         height = Math.max(0, parentRect.height - localY + height);
-    const explicitlyVisible = explicitElementVisibility(definition, scenario, rowValues);
+    const explicitlyVisible = explicitElementVisibility(definition, scenario, rowValues) ??
+        context.nativeVisibility.get(definition.id);
     const unresolvedVisibilityReason = context.unresolvedElementVisibility.get(definition.name);
     const parentSceneElement = parentInstanceId === undefined ? undefined : context.instancesById.get(parentInstanceId);
     const parentUnresolvedVisibility = parentSceneElement?.visibilityStatus === 'unresolved'
         ? parentSceneElement.visibilityStatusReason
         : undefined;
-    const sourceVisible = declaredVisibility(definition.attributes);
+    const dropdown = definition.parentId === undefined ? undefined : context.elementsById.get(definition.parentId);
+    const sourceVisible = declaredVisibility(definition.attributes, !expandedWindow ||
+        depth === 0 ||
+        visibilityValue(rowValues?.[`${dropdown?.name}.expanded`] ?? scenario.values[`${dropdown?.name}.expanded`]) === true);
+    if (expandedWindow)
+        addFidelity(fidelity, 'modelled', 'native_dropdown', 'Dropdown expansion is closed by default; bind <dropdown>.expanded or explicit panel visibility to show its settled position.', definition);
     const resolveVisibleAppearance = inheritedVisible && (explicitlyVisible ?? sourceVisible);
     const scriptedEnabled = rowValues?.[`${definition.name}.enabled`] ??
         scenario.values[`${definition.name}.enabled`] ??
@@ -1619,12 +1631,13 @@ async function layoutElement(definition, parentRect, inheritedClip, parentScale,
     else if (origoAxes.vertical === 'bottom')
         y -= height;
     const unclippedRect = { x, y, width: Math.max(0, width), height: Math.max(0, height) };
-    const ownClipping = scalarBoolean(property(definition.attributes, 'clipping')) ??
-        (backgrounds.length > 0 && /(?:containerwindow|windowtype)/iu.test(definition.elementType));
     let scrollbars = attachedScrollbars(definition, context);
-    if (scrollbars.length > 0 && (!ownClipping || backgrounds.length === 0)) {
-        diagnostics.push(diagnostic('GUI_SCROLLBAR_CONTAINER_BOUNDARY_MISSING', 'warning', `Container ${definition.name} needs a background and clipping for attached scrolling.`, definition));
-        addFidelity(fidelity, 'unsupported', 'attached_scrollbar', 'The container has no active clipped background boundary.', definition);
+    const ownClipping = scalarBoolean(property(definition.attributes, 'clipping')) ??
+        ((backgrounds.length > 0 || scrollbars.length > 0) &&
+            /(?:containerwindow|windowtype|expandedwindow)/iu.test(definition.elementType));
+    if (scrollbars.length > 0 && (!ownClipping || width <= 0 || height <= 0)) {
+        diagnostics.push(diagnostic('GUI_SCROLLBAR_CONTAINER_BOUNDARY_MISSING', 'warning', `Container ${definition.name} needs a positive-sized clipping boundary for attached scrolling.`, definition));
+        addFidelity(fidelity, 'unsupported', 'attached_scrollbar', 'The container has no active clipping boundary.', definition);
         scrollbars = [];
     }
     const margin = scrollbars.length === 0 ? undefined : objectProperty(property(definition.attributes, 'margin'));
@@ -1835,10 +1848,12 @@ async function layoutElement(definition, parentRect, inheritedClip, parentScale,
     const childDefinitions = await scrollbarChildren(definition, definition.childIds
         .map((id) => context.elementsById.get(id))
         .filter((element) => element !== undefined)
-        .filter((element) => !/^(?:containerwindowtype|windowtype)$/iu.test(definition.elementType) ||
+        .filter((element) => !/^(?:containerwindowtype|windowtype|expandedwindow)$/iu.test(definition.elementType) ||
         element.elementType.toLowerCase() !== 'extendedscrollbartype')
-        .sort((left, right) => (scalarNumber(property(left.attributes, 'priority'), 0) ?? 0) -
-        (scalarNumber(property(right.attributes, 'priority'), 0) ?? 0) ||
+        .sort((left, right) => Number(context.nativeForeground.has(left.id)) -
+        Number(context.nativeForeground.has(right.id)) ||
+        (scalarNumber(property(left.attributes, 'priority'), 0) ?? 0) -
+            (scalarNumber(property(right.attributes, 'priority'), 0) ?? 0) ||
         left.definitionOrder - right.definitionOrder), unclippedRect, scale, context, rowValues);
     const rowList = rowValues?.[`${definition.name}.list`];
     let rows = (typeof rowList === 'string' ? scenario.lists[rowList] : undefined) ??
@@ -1908,7 +1923,7 @@ async function layoutElement(definition, parentRect, inheritedClip, parentScale,
                     ...(slotWidth === undefined ? {} : { width: slotWidth }),
                     ...(slotHeight === undefined ? {} : { height: slotHeight }),
                 };
-                await layoutElement(child, shiftedParent, childClip, scale, depth + 1, context, rowSuffix(index), index, row, instanceId, origo, resolveVisibleAppearance, childClipChain);
+                await layoutElement(child, shiftedParent, childClip, scale, depth + 1, context, rowSuffix(index), index, row, instanceId, 'upper_left', resolveVisibleAppearance, childClipChain);
                 const rendered = context.instancesById.get(`${child.id}${rowSuffix(index)}`);
                 rowHeight = Math.max(rowHeight, rendered?.unclippedRect.height ?? 0);
             }
@@ -1960,7 +1975,7 @@ async function layoutElement(definition, parentRect, inheritedClip, parentScale,
                 ...(slotWidth === undefined ? {} : { width: slotWidth }),
                 ...(slotHeight === undefined ? {} : { height: slotHeight }),
             };
-            await layoutElement(template, shiftedParent, childClip, scale, depth + 1, context, rowSuffix(index), index, row, instanceId, origo, resolveVisibleAppearance, childClipChain);
+            await layoutElement(template, shiftedParent, childClip, scale, depth + 1, context, rowSuffix(index), index, row, instanceId, 'upper_left', resolveVisibleAppearance, childClipChain);
             const rendered = context.instancesById.get(`${template.id}${rowSuffix(index)}`);
             rowY += Math.max(slotHeight ?? 0, rendered?.unclippedRect.height ?? 0) + spacingY;
             renderedRows += 1;
@@ -1970,7 +1985,7 @@ async function layoutElement(definition, parentRect, inheritedClip, parentScale,
     else {
         for (const child of childDefinitions) {
             context.work.spend('nested child expansion');
-            await layoutElement(child, childParentRect, childClip, scale, depth + 1, context, instanceSuffix, rowIndex, rowValues, instanceId, origo, resolveVisibleAppearance, childClipChain);
+            await layoutElement(child, childParentRect, childClip, scale, depth + 1, context, instanceSuffix, rowIndex, rowValues, instanceId, 'upper_left', resolveVisibleAppearance, childClipChain);
         }
     }
     const childOutput = context.output.slice(firstChildOutput);
@@ -2195,10 +2210,14 @@ export async function buildGuiScene(graph, scannedFiles, windowName, scenario, c
     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')
+        for (const note of native.approximations ?? [])
+            addFidelity(fidelity, 'approximated', 'native_window_state', note);
+        const sources = native.state?.sources;
+        if (native.state !== undefined &&
+            sources !== undefined &&
+            (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.`);
@@ -2211,7 +2230,6 @@ export async function buildGuiScene(graph, scannedFiles, windowName, scenario, c
             ...scenario.values,
         },
         visibility: {
-            ...(native?.visibility ?? {}),
             ...scriptedWindowVisibility,
             ...constantElementVisibility,
             ...scenario.visibility,
@@ -2229,6 +2247,24 @@ export async function buildGuiScene(graph, scannedFiles, windowName, scenario, c
         elementsByNameCandidates.set(element.name, candidates);
     }
     const context = {
+        nativeForeground: new Set(graph.elements
+            .filter((element) => element.parentId === root.id && native?.foreground?.includes(element.name))
+            .map(({ id }) => id)),
+        nativeVisibility: new Map(graph.elements.flatMap((element) => {
+            const visible = native?.visibility[element.name];
+            if (visible === undefined)
+                return [];
+            // The designer reuses names (including division_title) inside selector panels.
+            // Its branch decisions apply to root controls, not identically named descendants.
+            if (windowName === 'countrydivisiondesignerview' && element.parentId !== root.id) {
+                const parent = element.parentId === undefined ? undefined : elementsById.get(element.parentId);
+                if (element.name !== 'hq_badge' ||
+                    parent?.name !== 'template_emblem_slot' ||
+                    parent.parentId !== root.id)
+                    return [];
+            }
+            return [[element.id, visible]];
+        })),
         graph,
         scenario: layoutScenario,
         catalog,

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

@@ -205,13 +205,52 @@ export function resolveNativeCountryState(scenario, files) {
 }
 /** 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 ||
+    return (windowName === 'countrydivisiondesignerview' ||
+        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;
+    if (windowName === 'countrydivisiondesignerview') {
+        const hq = scenario.values['countrydivisiondesignerview.hq'] === true;
+        const panel = scenario.values['countrydivisiondesignerview.panel'];
+        const visibility = {};
+        for (const name of ['hq_overlay_images', 'subunits_hq', 'hq_view', 'hq_title', 'hq_badge'])
+            if (elementNames.has(name))
+                visibility[name] = hq;
+        for (const name of [
+            'subunits',
+            'non_hq_view',
+            'division_title',
+            'division_composition_label',
+            'combat_width_view',
+        ])
+            if (elementNames.has(name))
+                visibility[name] = !hq;
+        const selectors = [
+            'designerregimentswindow',
+            'division_equipment_view',
+            'div_templ_custom_icon_view',
+            'div_template_select_model',
+            'niche_icon_selector',
+        ];
+        for (const name of selectors)
+            if (elementNames.has(name))
+                visibility[name] = panel === name;
+        return {
+            visibility,
+            values: {},
+            foreground: selectors,
+            notes: [
+                `Division designer uses the ${hq ? 'HQ' : 'division'} branch and only the explicitly selected native selector panel.`,
+            ],
+            approximations: [
+                'Native division state is a preview convention: defaults to a division with selectors closed. Set values countrydivisiondesignerview.hq and countrydivisiondesignerview.panel, or explicit element visibility. Engine-populated rows and statistics require scenario bindings.',
+            ],
+        };
+    }
     const state = resolveNativeCountryState(scenario, files);
     const visibility = {};
     const values = {};

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

@@ -119,7 +119,7 @@ export function guiElementAttributeFidelity(key, elementType) {
     if (elementType?.toLowerCase() === 'extendedscrollbartype' &&
         ['horizontal', 'slider', 'track', 'decreaseButton', 'increaseButton'].some((candidate) => candidate.toLowerCase() === key.toLowerCase()))
         return 'modelled';
-    if (/^(?:containerwindowtype|windowtype)$/iu.test(elementType ?? '') &&
+    if (/^(?:containerwindowtype|windowtype|expandedwindow)$/iu.test(elementType ?? '') &&
         ['verticalScrollbar', 'horizontalScrollbar', 'autohide_scrollbars', 'margin'].some((candidate) => candidate.toLowerCase() === key.toLowerCase()))
         return 'structural';
     if (elementType?.toLowerCase() === 'scrollbartype' &&
@@ -298,9 +298,12 @@ function nestedSizeFrom(block, key) {
 function raw(document, node) {
     return document.text.slice(node.start, node.end);
 }
-function isGuiElement(assignment) {
+function isGuiElement(assignment, parentType) {
     if (assignment.value.type !== 'block')
         return false;
+    if (parentType?.toLowerCase() === 'dropdownboxtype' &&
+        /^(?:expandedwindow|expandbutton)$/iu.test(assignment.key.value))
+        return true;
     if (explicitGuiElementTypes.has(assignment.key.value.toLowerCase()))
         return true;
     return (/type$/iu.test(assignment.key.value) && firstScalar(assignment.value, 'name') !== undefined);
@@ -363,11 +366,11 @@ function indexGuiElements(document, file, fileNodeId, nodes, edges, elements) {
     const constants = constantsFor(document);
     const firstFileElement = elements.length;
     let order = 0;
-    const walk = (block, parentId) => {
+    const walk = (block, parentId, parentType) => {
         for (const assignment of assignments(block)) {
             if (assignment.value.type !== 'block')
                 continue;
-            if (isGuiElement(assignment)) {
+            if (isGuiElement(assignment, parentType)) {
                 const name = firstScalar(assignment.value, 'name')?.value;
                 if (name === undefined)
                     continue;
@@ -386,7 +389,7 @@ function indexGuiElements(document, file, fileNodeId, nodes, edges, elements) {
                     childIds: [],
                     attributes: attributes,
                     unsupportedAttributes: assignments(assignment.value)
-                        .filter((child) => !isGuiElement(child))
+                        .filter((child) => !isGuiElement(child, assignment.key.value))
                         .map(({ key }) => key.value)
                         .filter((key) => guiElementAttributeFidelity(key, assignment.key.value) === 'unsupported')
                         .sort((a, b) => compareCodeUnits(a, b)),
@@ -409,7 +412,7 @@ function indexGuiElements(document, file, fileNodeId, nodes, edges, elements) {
                 addEdge(edges, 'contains', parentId ?? fileNodeId, id, true, {}, element.location);
                 if (parentId !== undefined)
                     addEdge(edges, 'parent', id, parentId, true, {}, element.location);
-                walk(assignment.value, id);
+                walk(assignment.value, id, assignment.key.value);
             }
             else {
                 walk(assignment.value, parentId);

package/dist/hoi4_agent_tools/gui/studio.js

@@ -1048,7 +1048,10 @@ export class ScriptedGuiStudio {
         const requiredNames = new Set([windowName, ...additionalTemplateNames]);
         for (const element of selectedLayoutElements)
             collectNamedAttributes(element.attributes, new Set(['verticalScrollbar', 'horizontalScrollbar', 'scrollbarType', 'scrollbartype']), requiredNames);
-        const availableNames = new Set(layoutGraph.elements.map(({ name }) => name));
+        // Scrollbar and row references name public templates, not private controls with the same name.
+        const availableNames = new Set(layoutGraph.elements.filter(({ parentId }) => parentId === undefined).map(({ name }) => name));
+        if (layoutGraph.elements.some(({ name }) => name === windowName))
+            availableNames.add(windowName);
         if ([...requiredNames].some((name) => !availableNames.has(name))) {
             const gameLayouts = await this.scanner.scan(workspace, {
                 patterns: layoutPatterns,

package/dist/hoi4_agent_tools/version.js

@@ -1,6 +1,6 @@
 import { LATEST_PROTOCOL_VERSION } from '@modelcontextprotocol/sdk/types.js';
 export const PACKAGE_NAME = 'hoi4-agent-tools';
-export const PACKAGE_VERSION = '4.0.4';
+export const PACKAGE_VERSION = '4.0.5';
 export const MCP_PROTOCOL_VERSION = LATEST_PROTOCOL_VERSION;
 export const CONFIG_VERSION = 1;
 export const TRANSACTION_VERSION = 1;

package/docs/gui.md

@@ -75,7 +75,7 @@ Bitmap text uses the language-appropriate HOI4 font definition and its real glyp
 
 `uiScale` is the in-game UI scale, not an image zoom. Use `1` for native pixel geometry at any screen resolution. Bitmap-font glyphs come directly from the real atlas without a sharpening, threshold, opacity-gain, or reconstructed-edge pass. Native-size coverage is unchanged. Enlarged coverage uses restrained Lanczos2 interpolation to avoid blocky pixel replication without running a sharpening filter. Downscaling uses nearest-neighbour sampling. Bitmap placement is snapped to the output pixel grid, and bitmap colours use alpha masks, so native, fractional-scale, local, and VPS renders remain deterministic.
 
-Layout follows Clausewitz orientation and element-origin anchors, including `CENTER_LEFT`, `CENTER_RIGHT`, `CENTER_UP`, `CENTER_DOWN`, `origo`, `centerposition`, inherited container coordinate origins, local scale, and both `%` and `%%` relative dimensions. Text boxes use native font metrics together with `maxWidth`, `maxHeight`, alignment, wrapping, and `fixedsize` clipping. Cornered tile sprites use fixed nine-slice borders and optional center tiling; progress bars composite their filled and background textures; masked shields composite their background and mask textures.
+Layout follows Clausewitz orientation and element-origin anchors, including `CENTER_LEFT`, `CENTER_RIGHT`, `CENTER_UP`, `CENTER_DOWN`, `origo`, `centerposition`, local scale, and both `%` and `%%` relative dimensions. Children default to their parent's upper-left corner independently of the parent's `origo`. Text boxes use native font metrics together with `maxWidth`, `maxHeight`, alignment, wrapping, and `fixedsize` clipping. Cornered tile sprites use fixed nine-slice borders and optional center tiling; progress bars composite their filled and background textures; masked shields composite their background and mask textures.
 
 A single-percent dimension is a proportional extent; a double-percent dimension names the far edge in the parent and subtracts the element's resolved anchor position.
 For example, a centered root at y=423 with `height=85%%` in a 1440-pixel viewport ends at y=1224 and has height 801, rather than height 1224.
@@ -100,7 +100,11 @@ Supply `values["container.scrollX"]` and `values["container.scrollY"]` in native
 The existing `scrollOffsets` map remains a vertical-offset shorthand, including names with row-instance suffixes.
 `minimum-value` and `maximum-value` scenarios sample content endpoints.
 The scene element's `scroll` record exposes its viewport, measured content dimensions, applied offsets and maximum offsets in output pixels after UI scaling.
-Missing, wrong-axis, duplicate or privately scoped scrollbar references and unclipped/background-less containers produce explicit findings rather than invented templates.
+Missing, wrong-axis, duplicate or privately scoped scrollbar references, nonpositive viewport sizes and explicitly unclipped containers produce findings rather than invented templates. An attached scrollbar establishes a clipped viewport by default, without requiring a decorative background; explicit `clipping = no` is diagnosed. A public template remains usable when an unrelated private child has the same name.
+
+Native `dropDownBoxType` controls retain their `expandButton` and `expandedWindow` children. Expanded panels default to closed. Set `scenario.values["dropdown_name.expanded"] = true` to open one dropdown at its settled `show_position`; explicit panel visibility also works. A panel source ID can distinguish repeated `expanded_window` names. Its background, descendants, clipping and attached scrollbar share the panel's visibility. Animation between open and closed positions is not simulated.
+
+`countrydivisiondesignerview` defaults to the ordinary division branch with its native selector panels closed. Set `scenario.values["countrydivisiondesignerview.hq"] = true` for the HQ branch. Set `scenario.values["countrydivisiondesignerview.panel"]` to `designerregimentswindow`, `division_equipment_view`, `div_templ_custom_icon_view`, `div_template_select_model` or `niche_icon_selector` to open that selector in front of ordinary root controls. Explicit element visibility or `name.visible` values override these defaults. The fidelity report identifies this preview convention; engine-populated rows, statistics and conditional icons still need explicit scenario bindings. No live division state is inferred.
 
 Scripted-GUI composition follows `parent_scripted_gui` chains even when the linked child window is a top-level sibling in the `.gui` file. Literal `always = yes` and `always = no` visibility and click-enabled blocks are applied automatically. A scenario's `values` object supplies concrete runtime values in one place: variable names resolve numeric text, scripted-localisation names resolve dynamic labels, a progress-bar element name sets its fill value, and element keys ending in `.image`, `.frame`, `.x`, `.y`, `.visible`, or `.enabled` update that visual property. Scripted-GUI property expressions such as `image = "[GetMeterSprite]"` or `x = meter_fill_width` consume matching scenario values automatically. Dynamic text is parsed after scenario and scripted-localisation substitution, so a runtime string containing `£command_power` or `£[GetResourceIcon]` renders the resolved inline HOI4 text icon instead of literal marker text. Dynamic lists instantiate their declared `entry_container` or `country_scope_entry_container`; each scenario row can select the country template with `countryScope`, choose an explicit `entryContainer`, provide `countryTag` and `ideology` for `GetFlag`, and supply row-scoped text, image, frame, position, visibility, and enabled values. Masked country sprites use the actual mask and overlay dimensions, so custom flag sizes are discovered from GFX assets rather than assumed by the renderer.
 

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "hoi4-agent-tools",
-  "version": "4.0.4",
+  "version": "4.0.5",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "hoi4-agent-tools",
-      "version": "4.0.4",
+      "version": "4.0.5",
       "license": "Apache-2.0",
       "dependencies": {
         "@fontsource-variable/roboto": "5.3.0",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "hoi4-agent-tools",
   "mcpName": "io.github.klimPaskov/hoi4-agent-tools",
-  "version": "4.0.4",
+  "version": "4.0.5",
   "description": "Build HOI4 mods: focus trees, events, decisions, worlds, GUI previews, docs and AI balance.",
   "type": "module",
   "license": "Apache-2.0",

package/schemas/configuration.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/configuration.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/configuration.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/continuous-focus-palette.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/continuous-focus-palette.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/continuous-focus-palette.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/custom-weighted-pool.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/custom-weighted-pool.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/custom-weighted-pool.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/decision-inspect-input.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/decision-inspect-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/decision-inspect-input.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/error-log-input.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/error-log-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/error-log-input.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/event-feature-manifest.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/event-feature-manifest.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/event-feature-manifest.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/focus-plan.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/focus-plan.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/focus-plan.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/focus-planning-sidecar.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/focus-planning-sidecar.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/focus-planning-sidecar.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/gui-animation-source.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/gui-animation-source.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/gui-animation-source.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/gui-helper.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/gui-helper.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/gui-helper.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/gui-scenario.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/gui-scenario.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/gui-scenario.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/helper-expansion-request.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/helper-expansion-request.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/helper-expansion-request.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/helper-expansion-summary.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/helper-expansion-summary.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/helper-expansion-summary.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/impact-inspect-input.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/impact-inspect-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/impact-inspect-input.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/map-operation.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/map-operation.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/map-operation.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "oneOf": [
     {

package/schemas/mechanic-test-input.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/mechanic-test-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/mechanic-test-input.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/mod-index-input.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/mod-index-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/mod-index-input.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/operation-result.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/operation-result.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/operation-result.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/package-check-input.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/package-check-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/package-check-input.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/package-manifest.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/package-manifest.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/package-manifest.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/probability-analysis-result.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/probability-analysis-result.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/probability-analysis-result.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/probability-compare-input.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/probability-compare-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/probability-compare-input.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/probability-evaluate-input.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/probability-evaluate-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/probability-evaluate-input.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/probability-inspect-input.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/probability-inspect-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/probability-inspect-input.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/probability-render-input.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/probability-render-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/probability-render-input.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/probability-scenario-set.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/probability-scenario-set.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/probability-scenario-set.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/probability-sequence-input.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/probability-sequence-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/probability-sequence-input.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/probability-simulate-input.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/probability-simulate-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/probability-simulate-input.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/probability-sweep-input.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/probability-sweep-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/probability-sweep-input.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/reference-context-input.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/reference-context-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/reference-context-input.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/reference-read-input.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/reference-read-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/reference-read-input.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/reference-search-input.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/reference-search-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/reference-search-input.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/scenario-suite.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/scenario-suite.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/scenario-suite.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/scenario-test-input.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/scenario-test-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/scenario-test-input.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/script-validate-input.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/script-validate-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/script-validate-input.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/shared-scenario.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/shared-scenario.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/shared-scenario.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/source-lookup-input.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.4/schemas/source-lookup-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/source-lookup-input.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.klimPaskov/hoi4-agent-tools",
   "title": "HOI4 Agent Tools",
   "description": "Build HOI4 mods: focus trees, events, decisions, worlds, GUI previews, docs and AI balance.",
-  "version": "4.0.4",
+  "version": "4.0.5",
   "repository": {
     "url": "https://github.com/klimPaskov/hoi4-agent-tools",
     "source": "github"
@@ -13,7 +13,7 @@
     {
       "registryType": "npm",
       "identifier": "hoi4-agent-tools",
-      "version": "4.0.4",
+      "version": "4.0.5",
       "transport": {
         "type": "stdio"
       }