EscapistsReintroduced/docs/inventory-layout.md

Inventory storage-list compatibility

The adapter changes only the storage-list hierarchy in an active successor game mode. The 180423 ordinary Chat run demonstrates native compilation, first-open slot compatibility, completed stock initialization and a bounded real-keyboard open/close cycle with no captured native errors. This establishes the first-open path only; repeated opening, storage-list refresh, item transfer and multiplayer remain unqualified. The stock handler and error reporting remain in use. The independent stock control reproduces the target pair but remains failed because it also records seven other vanilla errors.

The installed SCR_InventoryMenuUI.ShowStoragesList creates {FC579324F5E4B3A4}UI/layouts/Menus/Inventory/InventoryCharacterGrid.layout under StoragesListSlot and attaches SCR_InventoryStoragesListUI (installed script lines 1694–1708). InventoryMain.layout gives that parent the type GridLayoutWidget; the child layout's root is OverlayWidget Frame0. The stock handler calls LayoutSlot.SetSizeMode and LayoutSlot.SetFillWeight at lines 301–302. These are the two incompatible calls identified by the ordinary inventory-opening error. No stock script or layout is copied into the addon.

ERR_InventoryLayout.c creates a native VerticalLayoutWidget between that grid and Frame0 before delegating to the complete stock HandlerAttached exactly once. It requires the current active ERR_GameMode and world, the exact native current inventory menu, the handler's matching menu owner, and Frame0 directly under that menu's GridLayoutWidget StoragesListSlot. Other modes, menus, roots, or parents retain stock behavior.

The wrapper receives the original child's grid row, column, row/column spans, horizontal/vertical alignment, and all four padding values. Its sole inner child stretches with zero padding; stock code still sets that child's linear layout fill and weight. A failed reparent restores the original grid placement where the child remains in the original grid. A reused wrapper's former placement is restored on failure. The code never adopts a foreign same-named widget or a wrapper with foreign contents, nor moves a child that a callback has moved elsewhere.

Stock source removes the old root and handler during storage-list refresh. The adapter is designed to reuse the now-empty wrapper without accumulating wrappers; this refresh path is covered by policy tests but has not yet been demonstrated natively. Weak root/grid/host identities and a separate bound flag refuse replacement or unexpected deletion. No delayed callbacks are created; native menu hierarchy deletion owns wrapper cleanup.

The implementation uses installed public APIs:

• WorkspaceWidget.CreateWidget(WidgetType.VerticalLayoutWidgetTypeID, WidgetFlags.VISIBLE, null, 0, parent); native documentation permits null color, and vanilla SCR_HUDGroupUIComponent creates this widget type.
• Widget.AddChild, with vanilla reparenting precedent in SCR_TaskListUIComponent, plus GetParent, GetChildren, FindAnyWidget, SetName, and RemoveFromHierarchy.
• GridSlot.Get/SetRow, Get/SetColumn, Get/SetRowSpan, and Get/SetColumnSpan.
• AlignableSlot.Get/SetPadding, Get/SetHorizontalAlign, and Get/SetVerticalAlign, including the native LayoutHorizontalAlign and LayoutVerticalAlign enums.
• The stock constructor assigns protected m_MenuHandler before attachment. The override retains the native argument name Widget w.

python3 tests/test_inventory_layout.py executes the actual candidate method bodies with UI boundary doubles. It covers scope refusal, placement preservation, one-wrapper refresh reuse, foreign hierarchy refusal, allocation/reparent rollback, and exactly one stock delegation on accepted and refused paths. This checks policy and control flow; the doubles alone do not prove the engine regenerates the slot after AddChild. The separate ordinary first-open run supplies native evidence: unchanged stock LayoutSlot operations execute after reparenting without the previous GUI errors, and initialization reaches DONE.

The 180423 console records native stage 6 with five hit-zone points, followed by stage 7 with seven points, initialization no longer pending and the loading overlay absent on two separated observations. Its delayed open image shows the character view, vicinity and clothing slots without the loading overlay. The image review binds the original BMP and verifies the lossless PNG’s decoded pixels. This demonstrates rendered inventory content, not readability or correctness of every control, slot or interface state. The run binds 193 authored addon files to manifest SHA-256 6ac9f2cea228b3bb6ca3801a43ec409275ecc49db098182d5da0d3e0feed2ad4 and separately records 2.62 m native movement.

The prior 175333 run was clean but its image still contained a loading spinner. The 175938 run was also clean but emitted no open capture; the cause is not established. Missing that image does not prove initialization or the overlay was stuck. Both historical results remain unchanged.

Native qualification still needs repeated open/close and storage-list refresh without wrapper growth, item-transfer behavior, geometry across other inventory configurations and multiplayer. The observed close and clean owned-process cleanup do not by themselves prove every menu/world teardown path. No error filter or changed acceptance rule is used.