Blacksite/.agents/skills/blacksite-native-qa/references/scenarios/ui-gallery-framework.yaml

24 lines
1.8 KiB
YAML

name: ui-gallery-framework
purpose: Prove the lightweight production-component gallery launches independently and exposes the Penpot comparison workflow.
preconditions: The focused ui_gallery build and workflow tests pass in the managed dev lane.
build_lane: dev
package: ui_gallery
binary: ui_gallery
fixture:
steps:
- Launch the standalone Blacksite UI Gallery without a project, scene, renderer, or gameplay runtime.
- Inspect the default Content Browser 1240 side-by-side reference and production component canvases.
- Switch through Content Browser 620, Materials 620, Materials 420, Renderer 760, and Renderer 480 presets.
- Exercise Live, Overlay, and Difference modes and inspect the reported difference statistics.
- Switch through direct, inherited, imported, dirty, processing, failed, read-only, and built-in fixtures.
assertions:
- The gallery opens as one responsive native window without launching the Blacksite editor or game runtime.
- All six exact reference presets render the direct Penpot PNG and shared production component without clipping the gallery chrome.
- Content Browser 1240 and Content Browser 620 each report fewer than 15 percent changed pixels in Difference mode.
- Side-by-side, overlay, and difference modes remain interactive and Difference reports numeric delta statistics.
- Representative material ownership and health fixtures preserve the same shared panel geometry.
- Theme and material fixture JSON changes appear without rebuilding or restarting the gallery.
evidence: Exact ui_gallery window capture plus the hashed native-QA record.
cleanup: Close the runner-owned ui_gallery process; no project fixture is mutated.
invalidates: editor_ui, material_schema, ui_gallery, Penpot references, gallery fixtures, or gallery workflow scripts change.