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 Materials 620 side-by-side reference and production component canvases.
  - Switch through 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 four exact reference presets render the direct Penpot PNG and shared production component without clipping the gallery chrome.
  - 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.
