feat: add production UI gallery and inspector system
CI / Format, lint, test, build (push) Waiting to run

This commit is contained in:
Rbanh committed 2026-07-18 12:05:26 -04:00
1 parent cf6eaba534
commit 53dc1e44d8
95 files changed
+11003 -1652

No files matched your search

@@ -1,10 +1,10 @@
name: penpot-material-inspector
purpose: Verify the final Penpot Materials list and material-slot panel at its 640 px and 420 px Inspector reference widths.
purpose: Verify the current Penpot Materials list and material-slot panel at its 620 px and 420 px Inspector reference widths with side-by-side design evidence.
preconditions: editor_scene contains primitive, static-mesh, and skinned-mesh material users; no editor process is running.
build_lane: dev
fixture: assets/materials/pebble_bricks.ron
steps:
- Launch the editor on the real desktop and size the Inspector to the 640 px reference width.
- Launch the editor on the real desktop and size the Inspector to the 620 px reference width.
- Select a primitive, static mesh, and skinned mesh in turn and expand each material panel.
- Compare Materials ownership, expanded slot header, PARAMETERS spine, Surface, six Inputs rows, UV, and Advanced geometry with the current Penpot reference.
- Narrow the Inspector to the 420 px floor and verify every value, channel, texture, Locate, and Clear control reflows.
@@ -14,7 +14,7 @@ steps:
- Edit a scalar and color, release the controls, switch actors, then save and relaunch the editor.
- Inspect imported-source, DefaultGrid, and broken-reference presentations through the available fixture states.
assertions:
- The 640 px Inspector matches the current Penpot palette, Source Sans Pro typography, 32 px Materials heading, 82 px expanded slot header, 592 px parameter sections, six 30 px input rows, spacing, borders, and fixed property geometry without visible drift.
- The 620 px Inspector matches the current Penpot palette, Source Sans Pro typography, 32 px Materials heading, 82 px expanded slot header, 596 px slot, 569 px parameter body, six 30 px input rows, spacing, borders, and fixed property geometry without visible drift.
- Primitive, static-mesh, and skinned-mesh slots use the same panel geometry and have no redundant second slot presentation.
- At the 420 px Inspector floor, six 56 px input rows put paired texture controls on the second line with no horizontal scrolling, clipping, compressed labels, or missing actions.
- Direct assignments have no Explicit badge; inherited, dirty, processing, failed, read-only, imported-source, and built-in states retain one header geometry.
@@ -22,6 +22,6 @@ assertions:
- Wheel, Sliders, and Presets preview live; Apply retains the dirty in-memory value and Cancel, Escape, or outside dismissal restores the exact pre-open value.
- Material controls perform no pointer-release write or scalar/color processing job and keep the existing live GPU handle visible across actor selection.
- Save and relaunch preserve the authored value, while broken explicit references retain failed identity and visible DefaultGrid fallback.
evidence: Target-window captures for 640 px primitive/static/skinned, narrow reflow, color modes, invalid drop, dirty state, and relaunch plus hashes.
evidence: Font-faithful Penpot PNGs paired beside fresh target-window captures for 620 px primitive/static/skinned, 420 px reflow, component headers, renderer composition, color modes, invalid drop, dirty state, and relaunch plus hashes and a written delta matrix.
cleanup: Close the spawned editor and atomically restore pebble_bricks.ron from the runner snapshot.
invalidates: Design tokens, fonts, material panel geometry, material picker, color picker, authored documents, or material resolver changes.
@@ -0,0 +1,22 @@
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.