Falling-Metal-Interactive/Blacksite
2
0
Fork 0
Code Issues 15 Pull Requests Actions Packages Projects Releases Wiki Activity
106d947c98
Blacksite/docs/editor/evaluations/content-workspace-m2/penpot/README.md

5.4 KiB
Raw Blame History

M2 Penpot Design Exports

Evidence record — not current product guidance. Use the documentation index for current behavior and architecture. These exports pin the visual acceptance targets used to close M2 issues #67 and #68. The source document is Blacksite Editor UI (cf1804c7-b801-80c5-8008-57ad3313e5c6).

The current Penpot README makes pages 01–30 authoritative, pages 90–91 implementation masters only, and page 99 forbidden as current guidance. The CODEGEN MAP block is handoff documentation and never renders in Blacksite.

Measured production/reference differences and intentional semantic exceptions are tracked in the UI gallery delta matrix. A raw Difference score never overrides a runtime invariant or substitutes for the paired full-editor acceptance capture.

Responsive Inspector targets

Export Penpot page and shape Required match
Materials — wide Page 01, ad983554-05bb-80cb-8008-5698dfab667e 620 px Inspector reference; 596 px material slot; 569 px parameter body; deterministic wide rows and actions.
Materials — narrow Page 01, ad983554-05bb-80cb-8008-5698e08d425a 420 px Inspector floor; 396 px material slot; 369 px parameter body; two-line input rows with no clipping or horizontal scroll.
Static Mesh Renderer — wide Page 02, 6cb78075-fbd0-8045-8008-57f5315abf0a Full 760 px renderer composition, stable slot ordering, shared component chrome, and repeated material slots.
Static Mesh Renderer — narrow Page 02, 6cb78075-fbd0-8045-8008-57f5419afad2 Full 480 px renderer composition and bounded narrow reflow.

Content Browser targets

Export Penpot page and shape Required match
Content Browser — wide Page 03, e755994a-6c1d-80bd-8008-58e2e8668f78 1240×650 standalone reference; 36 px dock/title row, 55 px single-row content toolbar, 216 px Sources, 56 px content heading, one mixed folder/asset card stream, flexible grid, 290 px Details, and 32 px status bar. Production maps the title row to its dock tab.
Content Browser — expanded Page 18, e4366b2b-77bd-8058-8008-5a57e6c9a02f 1600×650 expanded reference; the standard toolbar gains first-class Name sort and thumbnail-scale controls composed from the foundation Combo Box and Slider. Cards retain their identity footer while previews scale.
Content Browser — compact Page 03, e755994a-6c1d-80bd-8008-58e2e8dbf894 620×650 compact reference; 88 px two-row content toolbar, grid-only default body, explicit Sources/Details access, preserved search/navigation/grid-list controls, Import/New on the breadcrumb row, the same mixed card stream, and no clipped actions.

Shared component targets

Export Penpot page and shape Required match
Foundation components catalog Page 11, 6cb78075-fbd0-8045-8008-5801d6740577 Authoritative controls, field sizing, selection behavior, asset/drop states, vector layouts, buttons, disclosure, and usage rules shared by Inspector components.
Inspector component header Page 12, 83c3baf0-0e37-808a-8008-57cd2388f9b9 One reusable 50 px component header and action/status geometry.
Array header Page 12, 83c3baf0-0e37-808a-8008-57cd23947466 One reusable 40 px collection header.
Composition rule Page 12, 83c3baf0-0e37-808a-8008-57cd23a58de0 Component containment and section ownership rule.
Material components and states Page 13, 83c3baf0-0e37-808a-8008-57d8c2a3305d Shared slot anatomy and direct, inherited, dirty, processing, failed, read-only, imported-source, and built-in states.

Color-picker targets

Export Penpot page and shape Required match
Wheel Page 22, 83c3baf0-0e37-808a-8008-57cd9b7b0667 Wheel mode layout, current/previous values, alpha, recents, and footer behavior.
Adjusted wheel state Page 22, 83c3baf0-0e37-808a-8008-57cd9bbd9c3b Dirty preview state and exact value presentation.
Sliders Page 23, 83c3baf0-0e37-808a-8008-57cda8a2c70f Sliders mode layout and conversion controls.
Presets Page 23, 83c3baf0-0e37-808a-8008-57cda8c84257 Presets mode, recent/user palette presentation, and bounded footer.

Issue ownership

  • #68 owns exact Inspector/component/material/color-picker geometry and responsive behavior against these exports.
  • #68 also owns Content Browser visual-system conformance against the current Page 03 wide and compact boards.
  • #67 owns the live authored-document and save-state behavior represented by the material-state and adjusted-color exports: interaction remains memory-only until explicit save, with distinct unsaved, processing, failed, and conflict state.
  • #65 owns consolidated native comparison evidence across wide, narrow, short-height, multi-slot, overlay, save, restart, and failure scenarios.
  • #59 indexes the design authority and requires the relevant child acceptance targets to be satisfied before epic closure.