[freezy]

The engine side of the player's cabinet display setup and first-start welcome screen. The display plug-ins (DMD, B2S, PinUP, Kiki) build on these contracts and are already on their master/main, and the Player and PinMAME PRs need this one.

• Cabinet outputs (CabinetDisplays): output plans with known cabinet roles, which plug-ins may provide each role, and copy targets the player owns. Cabinet targets are desktop regions only, and assignments are keyed by plug-in and role. Physical DMD panels are no longer player destinations, and the import of the plug-ins' saved window positions is gone. The full DMD scene surface stays for the plug-in that publishes it.
• Composition: CabinetOutputTexture and its shader make transformed copies (rotation, mirroring) and inset composition. CabinetSurfaceSelector shares the provider ranking and skips scene surfaces that don't fit. The screen binder takes a provider order per role.
• System defaults (IPluginSystemDefaults): a plug-in can describe what it takes from other applications on this computer while its own settings are empty: folders, configuration files and the output placements they suggest. The player shows them on its first start without knowing the plug-in, and the user can replace each one with the player's own value. They are only read, never written back.
• Packaging: collision-only playfield meshes are kept when a table is packaged.

Tests: CabinetDisplayTests, CabinetOutputTextureTests, CabinetNativeWindowTests and more cases in PlayfieldMeshPackagingTests. The developer guide has a new page on cabinet display outputs.

[greptile-apps]

Confidence Score: 5/5

[Medium impact] The documentation update appears safe to merge.

Summary

Adds shared cabinet output contracts, plug-in system defaults, transformed texture copies, and packaging support for collision-only playfields.

• Cabinet displays use shared roles, targets, and provider choices.
• Desktop outputs compose transformed plug-in frames into a Player-owned texture.
• Plug-ins can report defaults found in other applications.
• Table packages keep hidden authored playfield meshes for collision.

_{Reviews (2) · Last reviewed commit: "doc: Full DMD isn't a cabinet output rol..." · Reviewed by Greptile}